ParagonIE_Sodium_Core_Ristretto255

Compatibility

Present in every tracked release (6.7.7 to 7.1.0).

Methods · 28

• fe_cneg()
• fe_abs()
• fe_iszero()Returns 0 if this field element results in all NUL bytes.
• ristretto255_sqrt_ratio_m1()
• ristretto255_point_is_canonical()
• ristretto255_frombytes()
• ristretto255_p3_tobytes()
• ristretto255_elligator()
• ristretto255_from_hash()
• is_valid_point()
• ristretto255_add()
• ristretto255_sub()
• h2c_string_to_hash_sha256()
• h2c_string_to_hash_sha512()
• h2c_string_to_hash()
• _string_to_element()
• ristretto255_random()
• ristretto255_scalar_random()
• ristretto255_scalar_complement()
• ristretto255_scalar_invert()
• ristretto255_scalar_negate()
• ristretto255_scalar_add()
• ristretto255_scalar_sub()
• ristretto255_scalar_mul()
• ristretto255_scalar_from_string()
• ristretto255_scalar_reduce()
• scalarmult_ristretto255()
• scalarmult_ristretto255_base()

Source code

View on Trac ↗View on GitHub ↗

6class ParagonIE_Sodium_Core_Ristretto255 extends ParagonIE_Sodium_Core_Ed255197{8    const crypto_core_ristretto255_HASHBYTES = 64;9    const HASH_SC_L = 48;10    const CORE_H2C_SHA256 = 1;11    const CORE_H2C_SHA512 = 2;12 13    /**14     * @param ParagonIE_Sodium_Core_Curve25519_Fe $f15     * @param int $b16     * @return ParagonIE_Sodium_Core_Curve25519_Fe17     */18    public static function fe_cneg(ParagonIE_Sodium_Core_Curve25519_Fe $f, $b)19    {20        $negf = self::fe_neg($f);21        return self::fe_cmov($f, $negf, $b);22    }23 24    /**25     * @param ParagonIE_Sodium_Core_Curve25519_Fe $f26     * @return ParagonIE_Sodium_Core_Curve25519_Fe27     * @throws SodiumException28     */29    public static function fe_abs(ParagonIE_Sodium_Core_Curve25519_Fe $f)30    {31        return self::fe_cneg($f, self::fe_isnegative($f));32    }33 34    /**35     * Returns 0 if this field element results in all NUL bytes.36     *37     * @internal You should not use this directly from another application38     *39     * @param ParagonIE_Sodium_Core_Curve25519_Fe $f40     * @return int41     * @throws SodiumException42     */43    public static function fe_iszero(ParagonIE_Sodium_Core_Curve25519_Fe $f)44    {45        static $zero;46        if ($zero === null) {47            $zero = str_repeat("\x00", 32);48        }49        /** @var string $zero */50        $str = self::fe_tobytes($f);51 52        $d = 0;53        for ($i = 0; $i < 32; ++$i) {54            $d |= self::chrToInt($str[$i]);55        }56        return (($d - 1) >> 31) & 1;57    }58 59 60    /**61     * @param ParagonIE_Sodium_Core_Curve25519_Fe $u62     * @param ParagonIE_Sodium_Core_Curve25519_Fe $v63     * @return array{x: ParagonIE_Sodium_Core_Curve25519_Fe, nonsquare: int}64     *65     * @throws SodiumException66     */67    public static function ristretto255_sqrt_ratio_m1(68        ParagonIE_Sodium_Core_Curve25519_Fe $u,69        ParagonIE_Sodium_Core_Curve25519_Fe $v70    ) {71        $sqrtm1 = ParagonIE_Sodium_Core_Curve25519_Fe::fromArray(self::$sqrtm1);72 73        $v3 = self::fe_mul(74            self::fe_sq($v),75            $v76        ); /* v3 = v^3 */77        $x = self::fe_mul(78            self::fe_mul(79                self::fe_sq($v3),80                $u81            ),82            $v83        ); /* x = uv^7 */84 85        $x = self::fe_mul(

Changelog

Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/sodium_compat/src/Core/Ristretto255.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.