@ohos-ports/crypto 0.0.0-stage → 0.3.1-beta.1

package/dist/rust_vrf_reimpl/vrf03.d.ts

@@ -0,0 +1,60 @@
+import { EdwardsPoint } from "./curves.js";
+export interface IVrfProof03 {
+    gamma: EdwardsPoint;
+    challenge: Uint8Array;
+    response: Uint8Array;
+}
+export declare function extend_secret_key(secret_key: Uint8Array): [scalar: Uint8Array, extension: Uint8Array];
+export declare function adjust_scalar_bits(bytes: Uint8Array): void;
+export declare function vrf_ed25519_sha512_ell2_generate_proof(secret_key: Uint8Array, public_key: Uint8Array, alpha_string: Uint8Array): IVrfProof03;
+export declare function vrf_ed25519_sha512_ell2_verify_proof(public_key: Uint8Array, alpha_string: Uint8Array, proof: IVrfProof03): boolean;
+export declare function proof_to_hash(proof: IVrfProof03): Uint8Array & {
+    length: 64;
+};
+export declare function edwards_hash_from_bytes(bytes: Uint8Array): EdwardsPoint;
+export declare function vrf_ed25519_sha512_ell2_hash_to_curve(public_key: Uint8Array, alpha_string: Uint8Array): EdwardsPoint;
+export declare function scalar_hash_from_bytes(input: Uint8Array): Uint8Array;
+export declare function vrf_ed25519_sha512_ell2_nonce_generation(secret_extension: Uint8Array, compressed_h: Uint8Array): Uint8Array;
+export declare function vrf_ed25519_sha512_ell2_compute_challenge(compressed_h: Uint8Array, compressed_gamma: Uint8Array, compressed_announcement_1: Uint8Array, compressed_announcement_2: Uint8Array): Uint8Array;
+export declare function scalar_from_bits_inplace(bytes: Uint8Array): void;
+/**
+ * https://datatracker.ietf.org/doc/html/rfc9381#section-5.1
+ *
+ * test cases:
+ * https://datatracker.ietf.org/doc/html/rfc9381#name-ecvrf-edwards25519-sha512-e
+ * https://datatracker.ietf.org/doc/html/draft-irtf-cfrg-vrf-03#appendix-A.4
+ *
+ * /// Generate a new VRF proof following the 03 standard. It proceeds as follows:
+ * /// - Extend the secret key, into a `secret_scalar` and the `secret_extension`
+ * /// - Evaluate `hash_to_curve` over PK || alpha_string to get `H`
+ * /// - Compute `Gamma = secret_scalar *  H`
+ * /// - Generate a proof of discrete logarithm equality between `PK` and `Gamma` with
+ * ///   bases `generator` and `H` respectively.
+ *
+ * /
+export function vrf_ed25519_sha512_ell2_prove(sk: Uint8Array, alpha: Uint8Array): IVrfProof03
+{
+    /// - Extend the secret key, into a `secret_scalar` and the `secret_extension`
+    const [ scalar, extension ] = getExtendEd25519PrivateKeyComponents_sync( sk );
+    // 1. Use SK to derive the VRF secret scalar x and the VRF public key Y = x*B
+    /// - Evaluate `hash_to_curve` over PK || alpha_string to get `H`
+    const pk = new Uint8Array( deriveEd25519PublicKey_sync( sk ) );
+    const H = vrf_ed25519_sha512_ell2_hash_to_curve( pk, alpha );
+    
+    const H_point = pointFromBytes( H );
+    const gamma = scalarMul( H_point, scalar );
+    const compressed_gamma = bigpointToUint8Array( gamma );
+    const k = vrf_ed25519_sha512_ell2_nonce_generation( extension, H );
+    const announcement_1 = bigpointToUint8Array( scalarMultBase( k ) );
+    const announcement_2 = bigpointToUint8Array( scalarMul( H_point, k ) );
+    const challange = scalarFromBytes(
+        vrf_ed25519_sha512_ell2_challenge_generation( H, compressed_gamma, announcement_1, announcement_2 )
+    );
+    const response = k + challange * scalar;
+    return {
+        gamma,
+        challange,
+        response
+    };
+}
+//*/ 

package/dist/rust_vrf_reimpl/vrf03.js

@@ -0,0 +1,373 @@
+"use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scalar_from_bits_inplace = exports.vrf_ed25519_sha512_ell2_compute_challenge = exports.vrf_ed25519_sha512_ell2_nonce_generation = exports.scalar_hash_from_bytes = exports.vrf_ed25519_sha512_ell2_hash_to_curve = exports.edwards_hash_from_bytes = exports.proof_to_hash = exports.vrf_ed25519_sha512_ell2_verify_proof = exports.vrf_ed25519_sha512_ell2_generate_proof = exports.adjust_scalar_bits = exports.extend_secret_key = void 0;
+var uint8array_utils_1 = require("@harmoniclabs/uint8array-utils");
+var sha2_512_1 = require("../sha2_512.js");
+var curves_1 = require("./curves.js");
+/**
+4.4. RSA-FDH-VRF Ciphersuites
+
+This document defines RSA-FDH-VRF-SHA256 as follows:
+
+suite_string = 0x01.
+The hash function Hash is SHA-256 as specified in [RFC6234], with hLen = 32.
+MGF_salt = I2OSP(k, 4) || I2OSP(n, k).
+
+This document defines RSA-FDH-VRF-SHA384 as follows:
+
+suite_string = 0x02.
+The hash function Hash is SHA-384 as specified in [RFC6234], with hLen = 48.
+MGF_salt = I2OSP(k, 4) || I2OSP(n, k).
+
+This document defines RSA-FDH-VRF-SHA512 as follows:
+
+suite_string = 0x03.
+The hash function Hash is SHA-512 as specified in [RFC6234], with hLen = 64.
+MGF_salt = I2OSP(k, 4) || I2OSP(n, k).
+
+ */
+var SUITE = 0x04;
+var ONE = 0x01;
+var TWO = 0x02;
+/*
+pub fn extend(&self) -> (Scalar, [u8; 32]) {
+    let mut h: Sha512 = Sha512::new();
+    let mut extended = [0u8; 64];
+    let mut secret_key_bytes = [0u8; 32];
+    let mut extension = [0u8; 32];
+
+    h.update(self.as_bytes());
+    extended.copy_from_slice(&h.finalize().as_slice()[..64]);
+
+    secret_key_bytes.copy_from_slice(&extended[..32]);
+    extension.copy_from_slice(&extended[32..]);
+
+    secret_key_bytes[0] &= 248;
+    secret_key_bytes[31] &= 127;
+    secret_key_bytes[31] |= 64;
+
+    (Scalar::from_bits(secret_key_bytes), extension)
+}
+*/
+function extend_secret_key(secret_key) {
+    var extended = (0, sha2_512_1.sha2_512_sync)(secret_key);
+    var secret_key_bytes = extended.slice(0, 32);
+    var extension = extended.slice(32, 64);
+    secret_key_bytes[0] &= 248;
+    secret_key_bytes[31] &= 127;
+    secret_key_bytes[31] |= 64;
+    adjust_scalar_bits(secret_key_bytes);
+    return [secret_key_bytes, extension];
+}
+exports.extend_secret_key = extend_secret_key;
+function adjust_scalar_bits(bytes) {
+    bytes[31] &= 127;
+}
+exports.adjust_scalar_bits = adjust_scalar_bits;
+function vrf_ed25519_sha512_ell2_generate_proof(secret_key, public_key, alpha_string) {
+    var _a = __read(extend_secret_key(secret_key), 2), secret_scalar = _a[0], secret_extension = _a[1];
+    var h = vrf_ed25519_sha512_ell2_hash_to_curve(public_key, alpha_string);
+    var compressed_h = h.compress();
+    var gamma = h.scalarMul(secret_scalar);
+    var compressed_gamma = gamma.compress();
+    var k = vrf_ed25519_sha512_ell2_nonce_generation(secret_extension, compressed_h);
+    var compressed_announcement_base = curves_1.ED25519_BASEPOINT_POINT.scalarMul(k).compress();
+    var compressed_announcement_h = h.scalarMul(k).compress();
+    // Self::compute_challenge(&compressed_h, &gamma, &announcement_base, &announcement_h);
+    var challenge = vrf_ed25519_sha512_ell2_compute_challenge(compressed_h, compressed_gamma, compressed_announcement_base, compressed_announcement_h);
+    var response = (0, curves_1.add_scalars)(k, (0, curves_1.mul_scalars)(challenge, secret_scalar));
+    return {
+        gamma: gamma,
+        challenge: challenge,
+        response: response
+    };
+}
+exports.vrf_ed25519_sha512_ell2_generate_proof = vrf_ed25519_sha512_ell2_generate_proof;
+/*
+/// Verify VRF function, following the 03 specification.
+    pub fn verify(
+        &self,
+        public_key: &PublicKey03,
+        alpha_string: &[u8],
+    ) -> Result<[u8; OUTPUT_SIZE], VrfError> {
+        let h = Self::hash_to_curve(public_key, alpha_string);
+        let compressed_h = h.compress();
+
+        let decompressed_pk = public_key
+            .0
+            .decompress()
+            .ok_or(VrfError::DecompressionFailed)?;
+
+        if decompressed_pk.is_small_order() {
+            return Err(VrfError::PkSmallOrder);
+        }
+
+        let U = EdwardsPoint::vartime_double_scalar_mul_basepoint(
+            &self.challenge.neg(),
+            &decompressed_pk,
+            &self.response,
+        );
+        let V = EdwardsPoint::vartime_multiscalar_mul(
+            iter::once(self.response).chain(iter::once(self.challenge.neg())),
+            iter::once(h).chain(iter::once(self.gamma)),
+        );
+
+        // Now we compute the challenge
+        let challenge = Self::compute_challenge(&compressed_h, &self.gamma, &U, &V);
+
+        if challenge.to_bytes()[..16] == self.challenge.to_bytes()[..16] {
+            Ok(self.proof_to_hash())
+        } else {
+            Err(VrfError::VerificationFailed)
+        }
+    }
+*/
+function vrf_ed25519_sha512_ell2_verify_proof(public_key, alpha_string, proof) {
+    var h = vrf_ed25519_sha512_ell2_hash_to_curve(public_key, alpha_string);
+    var compressed_h = h.compress();
+    var decompressed_pk = (0, curves_1.decompressCompressedEdwardsY)(public_key); // pointFromBytes( public_key );
+    if (!decompressed_pk || decompressed_pk.is_small_order())
+        return false;
+    // Scalar
+    var proof_challenge = proof.challenge;
+    var U = curves_1.EdwardsPoint.vartime_double_scalar_mul_basepoint((0, curves_1.negate_scalar)(proof_challenge), decompressed_pk, proof.response);
+    var gamma = proof.gamma;
+    /*
+    let V = EdwardsPoint::vartime_multiscalar_mul(
+            iter::once(self.response).chain(iter::once(self.challenge.neg())),
+            iter::once(h).chain(iter::once(self.gamma)),
+        );
+    */
+    var V = curves_1.EdwardsPoint.vartime_multiscalar_mul([proof.response, (0, curves_1.negate_scalar)(proof_challenge)], [h, gamma]);
+    var computed_challenge = vrf_ed25519_sha512_ell2_compute_challenge(compressed_h, proof.gamma.compress(), U.compress(), V.compress());
+    return (0, uint8array_utils_1.uint8ArrayEq)(computed_challenge.slice(0, 16), proof_challenge.slice(0, 16));
+}
+exports.vrf_ed25519_sha512_ell2_verify_proof = vrf_ed25519_sha512_ell2_verify_proof;
+/*
+/// `proof_to_hash` function, following the 03 specification. This computes the output of the VRF
+    /// function. In particular, this function computes
+    /// SHA512(SUITE || THREE || Gamma)
+    pub fn proof_to_hash(&self) -> [u8; OUTPUT_SIZE] {
+        let mut output = [0u8; OUTPUT_SIZE];
+        let gamma_cofac = self.gamma.mul_by_cofactor();
+        let mut hash = Sha512::new();
+        hash.update(SUITE);
+        hash.update(THREE);
+        hash.update(gamma_cofac.compress().as_bytes());
+
+        output.copy_from_slice(hash.finalize().as_slice());
+        output
+    }
+
+*/
+function proof_to_hash(proof) {
+    var gamma_cofac = proof.gamma.mul_by_cofactor();
+    var hashInput = new Uint8Array(2 + gamma_cofac.compress().length);
+    hashInput[0] = SUITE;
+    hashInput[1] = 0x03;
+    hashInput.set(gamma_cofac.compress(), 2);
+    return (0, sha2_512_1.sha2_512_sync)(hashInput);
+}
+exports.proof_to_hash = proof_to_hash;
+/*
+export function vrfProofToBytesProof( proof: IVrfProof03 )
+{
+    return {
+        gamma: bigpointToUint8Array( proof.gamma ),
+        challange: encodeInt( proof.challange ),
+        response: encodeInt( proof.response ),
+    }
+}
+//*/
+function edwards_hash_from_bytes(bytes) {
+    var hash = (0, sha2_512_1.sha2_512_sync)(bytes);
+    var res = hash.slice(0, 32);
+    /*
+        //////////////////////////////////////////////////////////////////////////////////////
+        //// We need to be compatible with the third version of the VRF standard, which   ////
+        //// always unsets the sign bit. Given the visibility of the functions used to    ////
+        //// compute the ristretto mapping, we need to fork the original repo, to unset   ////
+        //// bit in this function. This fork should never be used, unless one needs to be ////
+        //// compatible with the version 3 of the VRF standard.                           ////
+        //// https://datatracker.ietf.org/doc/html/draft-irtf-cfrg-vrf-03#section-5.4.1.2 ////
+        //// The goal is to be always a single commit ahead of version 3.2.0, and this    ////
+        //// single commit only changes the following line, and a disclaimer in the       ////
+        //// README.                                                                      ////
+        //////////////////////////////////////////////////////////////////////////////////////
+        let sign_bit = 0;
+
+        let fe = FieldElement::from_bytes(&res);
+
+        let M1 = crate::montgomery::elligator_encode(&fe);
+        let E1_opt = M1.to_edwards(sign_bit);
+
+        E1_opt
+            .expect("Montgomery conversion to Edwards point in Elligator failed")
+            .mul_by_cofactor()
+    */
+    var sign_bit = 0;
+    var fe = curves_1.FieldElem51.fromBytes(res);
+    var M1 = curves_1.FieldElem51.elligator_encode(fe);
+    var E1_opt = M1.to_edwards(sign_bit);
+    if (!E1_opt) {
+        throw new Error("Montgomery conversion to Edwards point in Elligator failed");
+    }
+    return E1_opt.mul_by_cofactor();
+}
+exports.edwards_hash_from_bytes = edwards_hash_from_bytes;
+function vrf_ed25519_sha512_ell2_hash_to_curve(public_key, alpha_string) {
+    var input = new Uint8Array(2 + public_key.length + alpha_string.length);
+    input[0] = SUITE;
+    input[1] = ONE;
+    input.set(public_key, 2);
+    input.set(alpha_string, 2 + public_key.length);
+    return edwards_hash_from_bytes(input); // sha2_512_sync(input);
+}
+exports.vrf_ed25519_sha512_ell2_hash_to_curve = vrf_ed25519_sha512_ell2_hash_to_curve;
+function scalar_hash_from_bytes(input) {
+    return (0, curves_1.scalar_from_bytes_mod_order_wide)((0, sha2_512_1.sha2_512_sync)(input));
+}
+exports.scalar_hash_from_bytes = scalar_hash_from_bytes;
+function vrf_ed25519_sha512_ell2_nonce_generation(secret_extension, compressed_h) {
+    var input = new Uint8Array(64);
+    input.set(secret_extension, 0);
+    input.set(compressed_h, 32);
+    //return pointFromBytes(sha2_512_sync(input))
+    return scalar_hash_from_bytes(input);
+}
+exports.vrf_ed25519_sha512_ell2_nonce_generation = vrf_ed25519_sha512_ell2_nonce_generation;
+/*
+/// Hash points function, following the 03 specification.
+    fn compute_challenge(
+        compressed_h: &CompressedEdwardsY,
+        gamma: &EdwardsPoint,
+        announcement_1: &EdwardsPoint,
+        announcement_2: &EdwardsPoint,
+    ) -> Scalar {
+        // we use a scalar of 16 bytes (instead of 32), but store it in 32 bits, as that is what
+        // `Scalar::from_bits()` expects.
+        let mut scalar_bytes = [0u8; 32];
+        let mut challenge_hash = Sha512::new();
+        challenge_hash.update(SUITE);
+        challenge_hash.update(TWO);
+        challenge_hash.update(compressed_h.to_bytes());
+        challenge_hash.update(gamma.compress().as_bytes());
+        challenge_hash.update(announcement_1.compress().as_bytes());
+        challenge_hash.update(announcement_2.compress().as_bytes());
+
+        scalar_bytes[..16].copy_from_slice(&challenge_hash.finalize().as_slice()[..16]);
+
+        Scalar::from_bits(scalar_bytes)
+    }
+* /
+export function vrf_ed25519_sha512_ell2_challenge_generation(
+    H: Uint8Array,
+    gamma: Uint8Array,
+    announcement_1: Uint8Array,
+    announcement_2: Uint8Array,
+): Uint8Array
+{
+    // const input = new Uint8Array( 2 + H.length + gamma.length + announcement_1.length + announcement_2.length );
+    // input[0] = SUITE;
+    // input[1] = TWO;
+    // input.set( H, 2 );
+    // input.set( gamma, 2 + H.length );
+    // input.set( announcement_1, 2 + H.length + gamma.length );
+    // input.set( announcement_2, 2 + H.length + gamma.length + announcement_1.length );
+    // return sha2_512_sync(input).slice(0,16);
+}
+//*/
+function vrf_ed25519_sha512_ell2_compute_challenge(compressed_h, compressed_gamma, compressed_announcement_1, compressed_announcement_2) {
+    var scalar_bytes = new Uint8Array(32);
+    var hash_input = new Uint8Array(2 +
+        compressed_h.length +
+        compressed_gamma.length +
+        compressed_announcement_1.length +
+        compressed_announcement_2.length);
+    hash_input[0] = SUITE;
+    hash_input[1] = TWO;
+    hash_input.set(compressed_h, 2);
+    hash_input.set(compressed_gamma, 2 + compressed_h.length);
+    hash_input.set(compressed_announcement_1, 2 + compressed_h.length + compressed_gamma.length);
+    hash_input.set(compressed_announcement_2, 2 + compressed_h.length + compressed_gamma.length + compressed_announcement_1.length);
+    var hash = (0, sha2_512_1.sha2_512_sync)(hash_input);
+    scalar_bytes.set(hash.slice(0, 16), 0);
+    scalar_from_bits_inplace(scalar_bytes);
+    return scalar_bytes;
+}
+exports.vrf_ed25519_sha512_ell2_compute_challenge = vrf_ed25519_sha512_ell2_compute_challenge;
+/*
+// Construct a `Scalar` from the low 255 bits of a 256-bit integer.
+    ///
+    /// This function is intended for applications like X25519 which
+    /// require specific bit-patterns when performing scalar
+    /// multiplication.
+    pub const fn from_bits(bytes: [u8; 32]) -> Scalar {
+        let mut s = Scalar{bytes};
+        // Ensure that s < 2^255 by masking the high bit
+        s.bytes[31] &= 0b0111_1111;
+
+        s
+    }
+*/
+function scalar_from_bits_inplace(bytes) {
+    bytes[31] &= 127;
+}
+exports.scalar_from_bits_inplace = scalar_from_bits_inplace;
+/**
+ * https://datatracker.ietf.org/doc/html/rfc9381#section-5.1
+ *
+ * test cases:
+ * https://datatracker.ietf.org/doc/html/rfc9381#name-ecvrf-edwards25519-sha512-e
+ * https://datatracker.ietf.org/doc/html/draft-irtf-cfrg-vrf-03#appendix-A.4
+ *
+ * /// Generate a new VRF proof following the 03 standard. It proceeds as follows:
+ * /// - Extend the secret key, into a `secret_scalar` and the `secret_extension`
+ * /// - Evaluate `hash_to_curve` over PK || alpha_string to get `H`
+ * /// - Compute `Gamma = secret_scalar *  H`
+ * /// - Generate a proof of discrete logarithm equality between `PK` and `Gamma` with
+ * ///   bases `generator` and `H` respectively.
+ *
+ * /
+export function vrf_ed25519_sha512_ell2_prove(sk: Uint8Array, alpha: Uint8Array): IVrfProof03
+{
+    /// - Extend the secret key, into a `secret_scalar` and the `secret_extension`
+    const [ scalar, extension ] = getExtendEd25519PrivateKeyComponents_sync( sk );
+    // 1. Use SK to derive the VRF secret scalar x and the VRF public key Y = x*B
+    /// - Evaluate `hash_to_curve` over PK || alpha_string to get `H`
+    const pk = new Uint8Array( deriveEd25519PublicKey_sync( sk ) );
+    const H = vrf_ed25519_sha512_ell2_hash_to_curve( pk, alpha );
+    
+    const H_point = pointFromBytes( H );
+    const gamma = scalarMul( H_point, scalar );
+    const compressed_gamma = bigpointToUint8Array( gamma );
+    const k = vrf_ed25519_sha512_ell2_nonce_generation( extension, H );
+    const announcement_1 = bigpointToUint8Array( scalarMultBase( k ) );
+    const announcement_2 = bigpointToUint8Array( scalarMul( H_point, k ) );
+    const challange = scalarFromBytes(
+        vrf_ed25519_sha512_ell2_challenge_generation( H, compressed_gamma, announcement_1, announcement_2 )
+    );
+    const response = k + challange * scalar;
+    return {
+        gamma,
+        challange,
+        response
+    };
+}
+//*/ 

package/dist/rust_vrf_reimpl/vrf10.d.ts

@@ -0,0 +1,73 @@
+import { EdwardsPoint } from "./curves.js";
+export interface IVrfProof10 {
+    gamma: EdwardsPoint;
+    challenge: Uint8Array;
+    response: Uint8Array;
+}
+export declare function extend_secret_key(secret_key: Uint8Array): [scalar: Uint8Array, extension: Uint8Array];
+export declare function adjust_scalar_bits(bytes: Uint8Array): void;
+export declare function vrf10_ed25519_sha512_ell2_generate_proof(secret_key: Uint8Array, public_key: Uint8Array, alpha_string: Uint8Array): IVrfProof10;
+export declare function vrf10_ed25519_sha512_ell2_verify_proof(public_key: Uint8Array, alpha_string: Uint8Array, proof: IVrfProof10): boolean;
+export declare function vrf10_proof_to_hash(proof: IVrfProof10): Uint8Array & {
+    length: 64;
+};
+export declare function edwards_hash_from_bytes(bytes: Uint8Array): EdwardsPoint;
+/**
+ * Computing the `hash_to_curve` using try and increment. In order to make the
+ * function always terminate, we bound  the number of tries to 64. If the try
+ * 64 fails, which happens with probability around 1/2^64, we compute the
+ * Elligator mapping. This diverges from the standard: the latter describes
+ * the function with an infinite loop. To avoid infinite loops or possibly
+ * non-terminating functions, we adopt this modification.
+ * This function is temporary, until `curve25519` provides a `hash_to_curve` as
+ * presented in the standard. Depends on
+ * [this pr](https://github.com/dalek-cryptography/curve25519-dalek/pull/377). The
+ * goal of providing this temporary function, is to ensure that the rest of the
+ * implementation is valid with respect to the standard, by using their test-vectors.
+**/
+export declare function vrf10_ed25519_sha512_ell2_hash_to_curve(public_key: Uint8Array, alpha_string: Uint8Array): EdwardsPoint;
+export declare function scalar_hash_from_bytes(input: Uint8Array): Uint8Array;
+export declare function vrf10_ed25519_sha512_ell2_nonce_generation(secret_extension: Uint8Array, compressed_h: Uint8Array): Uint8Array;
+export declare function vrf10_ed25519_sha512_ell2_compute_challenge(compressed_h: Uint8Array, compressed_gamma: Uint8Array, compressed_announcement_1: Uint8Array, compressed_announcement_2: Uint8Array): Uint8Array;
+export declare function scalar_from_bits_inplace(bytes: Uint8Array): void;
+/**
+ * https://datatracker.ietf.org/doc/html/rfc9381#section-5.1
+ *
+ * test cases:
+ * https://datatracker.ietf.org/doc/html/rfc9381#name-ecvrf-edwards25519-sha512-e
+ * https://datatracker.ietf.org/doc/html/draft-irtf-cfrg-vrf-10#appendix-A.4
+ *
+ * /// Generate a new VRF proof following the 10 standard. It proceeds as follows:
+ * /// - Extend the secret key, into a `secret_scalar` and the `secret_extension`
+ * /// - Evaluate `hash_to_curve` over PK || alpha_string to get `H`
+ * /// - Compute `Gamma = secret_scalar *  H`
+ * /// - Generate a proof of discrete logarithm equality between `PK` and `Gamma` with
+ * ///   bases `generator` and `H` respectively.
+ *
+ * /
+export function vrf_ed25519_sha512_ell2_prove(sk: Uint8Array, alpha: Uint8Array): IVrfProof10
+{
+    /// - Extend the secret key, into a `secret_scalar` and the `secret_extension`
+    const [ scalar, extension ] = getExtendEd25519PrivateKeyComponents_sync( sk );
+    // 1. Use SK to derive the VRF secret scalar x and the VRF public key Y = x*B
+    /// - Evaluate `hash_to_curve` over PK || alpha_string to get `H`
+    const pk = new Uint8Array( deriveEd25519PublicKey_sync( sk ) );
+    const H = vrf_ed25519_sha512_ell2_hash_to_curve( pk, alpha );
+    
+    const H_point = pointFromBytes( H );
+    const gamma = scalarMul( H_point, scalar );
+    const compressed_gamma = bigpointToUint8Array( gamma );
+    const k = vrf_ed25519_sha512_ell2_nonce_generation( extension, H );
+    const announcement_1 = bigpointToUint8Array( scalarMultBase( k ) );
+    const announcement_2 = bigpointToUint8Array( scalarMul( H_point, k ) );
+    const challange = scalarFromBytes(
+        vrf_ed25519_sha512_ell2_challenge_generation( H, compressed_gamma, announcement_1, announcement_2 )
+    );
+    const response = k + challange * scalar;
+    return {
+        gamma,
+        challange,
+        response
+    };
+}
+//*/