@rolly-dev/wasm-signer 0.5.1 → 0.6.2

package/dist/node/rolly_wasm_signer.d.ts

@@ -1,6 +1,17 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * Split a u64 amount into (lo, hi) u32 pair matching the circuit representation.
+ *
+ * Returns `[amount_lo, amount_hi]` as a `Uint32Array` of length 2.
+ *
+ * ```js
+ * const [lo, hi] = amount_split(123456789n);
+ * ```
+ */
+export function amount_split(amount: bigint): Uint32Array;
+
 /**
  * Full Poseidon2 hash of an 8-element server seed.
  *
@@ -13,6 +24,17 @@
  */
 export function compute_server_seed_hash(server_seed: BigUint64Array): BigUint64Array;
 
+/**
+ * Compute the transaction message hash (for debugging / verification).
+ *
+ * Returns `BigUint64Array` of length 4 — the same hash the circuit computes.
+ *
+ * ```js
+ * const hash = compute_tx_msg_hash(5, userId, 0, amountLo, amountHi);
+ * ```
+ */
+export function compute_tx_msg_hash(tx_type: number, user_id: number, currency_id: number, amount_lo: number, amount_hi: number): BigUint64Array;
+
 /**
  * Create a `bet_auth` MAC that proves the user authorized this specific bet.
  *
@@ -123,6 +145,106 @@ export function poseidon2_hash(input: BigUint64Array): BigUint64Array;
  */
 export function poseidon2_two_to_one(left: BigUint64Array, right: BigUint64Array): BigUint64Array;
 
+/**
+ * Derive a Schnorr secret key from entropy bytes (e.g. MetaMask signature).
+ *
+ * Takes at least 32 bytes, uses `Scalar::decode_reduce` to map them into
+ * the ECgFp5 scalar field. Returns hex-encoded secret key (80 chars = 40 bytes).
+ *
+ * ```js
+ * const skHex = schnorr_keygen(sigBytes.slice(0, 32));
+ * ```
+ */
+export function schnorr_keygen(entropy: Uint8Array): string;
+
+/**
+ * Get the w-encoding of a public key as 5 Goldilocks field elements (for circuit witness).
+ *
+ * Returns `BigUint64Array` of length 5.
+ *
+ * ```js
+ * const encode = schnorr_pk_encode(pkHex);
+ * // encode.length === 5
+ * ```
+ */
+export function schnorr_pk_encode(pk_hex: string): BigUint64Array;
+
+/**
+ * Compute pk_hash = Poseidon2(w_encoding[5]) from a hex-encoded public key.
+ *
+ * The w-encoding is the 40-byte (80 hex) representation returned by `schnorr_pubkey`.
+ * pk_hash is stored in the Merkle tree to bind the Schnorr key to an account.
+ *
+ * Returns `BigUint64Array` of length 4.
+ *
+ * ```js
+ * const pkHash = schnorr_pk_hash(pkHex);
+ * ```
+ */
+export function schnorr_pk_hash(pk_hex: string): BigUint64Array;
+
+/**
+ * Compute pk_hash as a hex string (for convenience).
+ *
+ * ```js
+ * const pkHashHex = schnorr_pk_hash_hex(pkHex);
+ * ```
+ */
+export function schnorr_pk_hash_hex(pk_hex: string): string;
+
+/**
+ * Compute the Schnorr public key from a hex-encoded secret key.
+ *
+ * Returns hex-encoded w-encoding of the ECgFp5 point (80 chars = 40 bytes).
+ *
+ * ```js
+ * const pkHex = schnorr_pubkey(skHex);
+ * ```
+ */
+export function schnorr_pubkey(sk_hex: string): string;
+
+/**
+ * Sign a ChangePubKey (tx_type=9) transaction.
+ *
+ * msg_hash = Poseidon2(9, user_id, new_pk_hash[0..4])
+ *
+ * The old key signs this message to authorize key rotation.
+ *
+ * Returns a JS object: `{ pubkey: "hex", sig_r: "hex", sig_s: "hex" }`
+ *
+ * ```js
+ * const sig = schnorr_sign_cpk(oldSkHex, userId, newPkHashArray);
+ * ```
+ */
+export function schnorr_sign_cpk(old_sk_hex: string, user_id: number, new_pk_hash: BigUint64Array): any;
+
+/**
+ * Sign a transaction with Schnorr (ECgFp5).
+ *
+ * msg_hash = Poseidon2(tx_type, user_id, currency_id, amount_lo, amount_hi)
+ *
+ * Returns a JS object: `{ pubkey: "hex", sig_r: "hex", sig_s: "hex" }`
+ *
+ * ```js
+ * const sig = schnorr_sign_tx(skHex, 5, userId, 0, amountBigInt);
+ * // sig.pubkey, sig.sig_r, sig.sig_s — all hex strings (80 chars each)
+ * ```
+ */
+export function schnorr_sign_tx(sk_hex: string, tx_type: number, user_id: number, currency_id: number, amount_lo: number, amount_hi: number): any;
+
+/**
+ * Verify a Schnorr signature for a transaction on the backend.
+ *
+ * Checks: s·G == R + H(R‖pk‖msg)·pk
+ *
+ * Returns `true` if signature is valid, `false` otherwise.
+ *
+ * ```js
+ * const ok = schnorr_verify_tx(pubkeyHex, sigRHex, sigSHex, 5, userId, 0, amountLo, amountHi);
+ * ```
+ */
+export function schnorr_verify_tx(pk_hex: string, sig_r_hex: string, sig_s_hex: string, tx_type: number, user_id: number, currency_id: number, amount_lo: number, amount_hi: number): boolean;
+
 /**
  * Truncated seed hash — first 2 elements of `Poseidon2(server_seed)`.
  *