@rolly-dev/wasm-signer 0.3.1 → 0.5.1

package/dist/node/rolly_wasm_signer.d.ts

@@ -59,6 +59,19 @@ export function create_bet_auth(session_key: BigUint64Array, bet_amount: bigint,
  */
 export function derive_session_key(sig_bytes: Uint8Array): BigUint64Array;
 
+/**
+ * Generate a random user seed — 10 alphanumeric characters.
+ *
+ * Uses `getrandom` (backed by `crypto.getRandomValues` in the browser
+ * and OS entropy on Node.js) for cryptographically secure randomness.
+ *
+ * ```js
+ * const seed = generate_user_seed();
+ * // e.g. "k7Qm2xW9aB"
+ * ```
+ */
+export function generate_user_seed(): string;
+
 /**
  * Convert any Goldilocks field elements to a hex string.
  *

package/dist/node/rolly_wasm_signer.js

@@ -15,13 +15,13 @@
 function compute_server_seed_hash(server_seed) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(server_seed, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(server_seed, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.compute_server_seed_hash(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -62,13 +62,13 @@ exports.compute_server_seed_hash = compute_server_seed_hash;
 function create_bet_auth(session_key, bet_amount, nonce) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(session_key, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(session_key, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.create_bet_auth(retptr, ptr0, len0, bet_amount, nonce);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -97,13 +97,13 @@ exports.create_bet_auth = create_bet_auth;
 function derive_session_key(sig_bytes) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray8ToWasm0(sig_bytes, wasm.__wbindgen_export);
+        const ptr0 = passArray8ToWasm0(sig_bytes, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.derive_session_key(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -111,6 +111,36 @@ function derive_session_key(sig_bytes) {
 }
 exports.derive_session_key = derive_session_key;
 
+/**
+ * Generate a random user seed — 10 alphanumeric characters.
+ *
+ * Uses `getrandom` (backed by `crypto.getRandomValues` in the browser
+ * and OS entropy on Node.js) for cryptographically secure randomness.
+ *
+ * ```js
+ * const seed = generate_user_seed();
+ * // e.g. "k7Qm2xW9aB"
+ * ```
+ * @returns {string}
+ */
+function generate_user_seed() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.generate_user_seed(retptr);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred1_0 = r0;
+        deferred1_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export3(deferred1_0, deferred1_1, 1);
+    }
+}
+exports.generate_user_seed = generate_user_seed;
+
 /**
  * Convert any Goldilocks field elements to a hex string.
  *
@@ -128,7 +158,7 @@ function goldilocks_fields_to_hex(fields) {
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(fields, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(fields, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.goldilocks_fields_to_hex(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
@@ -138,7 +168,7 @@ function goldilocks_fields_to_hex(fields) {
         return getStringFromWasm0(r0, r1);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export2(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_export3(deferred2_0, deferred2_1, 1);
     }
 }
 exports.goldilocks_fields_to_hex = goldilocks_fields_to_hex;
@@ -186,13 +216,13 @@ exports.goldilocks_reduce = goldilocks_reduce;
 function poseidon2_hash(input) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(input, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(input, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.poseidon2_hash(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -214,15 +244,15 @@ exports.poseidon2_hash = poseidon2_hash;
 function poseidon2_two_to_one(left, right) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(left, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(left, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
-        const ptr1 = passArray64ToWasm0(right, wasm.__wbindgen_export);
+        const ptr1 = passArray64ToWasm0(right, wasm.__wbindgen_export2);
         const len1 = WASM_VECTOR_LEN;
         wasm.poseidon2_two_to_one(retptr, ptr0, len0, ptr1, len1);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v3 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v3;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -244,13 +274,13 @@ exports.poseidon2_two_to_one = poseidon2_two_to_one;
 function seed_hash_truncated(server_seed) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(server_seed, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(server_seed, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.seed_hash_truncated(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -271,13 +301,13 @@ exports.seed_hash_truncated = seed_hash_truncated;
 function session_public_key(session_key) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(session_key, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(session_key, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.session_public_key(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -304,13 +334,13 @@ exports.session_public_key = session_public_key;
 function string_to_user_seed(input) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export, wasm.__wbindgen_export3);
+        const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export2, wasm.__wbindgen_export4);
         const len0 = WASM_VECTOR_LEN;
         wasm.string_to_user_seed(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -336,7 +366,7 @@ function string_to_user_seed_hex(input) {
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export, wasm.__wbindgen_export3);
+        const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export2, wasm.__wbindgen_export4);
         const len0 = WASM_VECTOR_LEN;
         wasm.string_to_user_seed_hex(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
@@ -346,7 +376,7 @@ function string_to_user_seed_hex(input) {
         return getStringFromWasm0(r0, r1);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export2(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_export3(deferred2_0, deferred2_1, 1);
     }
 }
 exports.string_to_user_seed_hex = string_to_user_seed_hex;
@@ -354,9 +384,116 @@ exports.string_to_user_seed_hex = string_to_user_seed_hex;
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg___wbindgen_is_function_0095a73b8b156f76: function(arg0) {
+            const ret = typeof(getObject(arg0)) === 'function';
+            return ret;
+        },
+        __wbg___wbindgen_is_object_5ae8e5880f2c1fbd: function(arg0) {
+            const val = getObject(arg0);
+            const ret = typeof(val) === 'object' && val !== null;
+            return ret;
+        },
+        __wbg___wbindgen_is_string_cd444516edc5b180: function(arg0) {
+            const ret = typeof(getObject(arg0)) === 'string';
+            return ret;
+        },
+        __wbg___wbindgen_is_undefined_9e4d92534c42d778: function(arg0) {
+            const ret = getObject(arg0) === undefined;
+            return ret;
+        },
         __wbg___wbindgen_throw_be289d5034ed271b: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
+        __wbg_call_389efe28435a9388: function() { return handleError(function (arg0, arg1) {
+            const ret = getObject(arg0).call(getObject(arg1));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_call_4708e0c13bdc8e95: function() { return handleError(function (arg0, arg1, arg2) {
+            const ret = getObject(arg0).call(getObject(arg1), getObject(arg2));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_crypto_86f2631e91b51511: function(arg0) {
+            const ret = getObject(arg0).crypto;
+            return addHeapObject(ret);
+        },
+        __wbg_getRandomValues_b3f15fcbfabb0f8b: function() { return handleError(function (arg0, arg1) {
+            getObject(arg0).getRandomValues(getObject(arg1));
+        }, arguments); },
+        __wbg_length_32ed9a279acd054c: function(arg0) {
+            const ret = getObject(arg0).length;
+            return ret;
+        },
+        __wbg_msCrypto_d562bbe83e0d4b91: function(arg0) {
+            const ret = getObject(arg0).msCrypto;
+            return addHeapObject(ret);
+        },
+        __wbg_new_no_args_1c7c842f08d00ebb: function(arg0, arg1) {
+            const ret = new Function(getStringFromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
+        __wbg_new_with_length_a2c39cbe88fd8ff1: function(arg0) {
+            const ret = new Uint8Array(arg0 >>> 0);
+            return addHeapObject(ret);
+        },
+        __wbg_node_e1f24f89a7336c2e: function(arg0) {
+            const ret = getObject(arg0).node;
+            return addHeapObject(ret);
+        },
+        __wbg_process_3975fd6c72f520aa: function(arg0) {
+            const ret = getObject(arg0).process;
+            return addHeapObject(ret);
+        },
+        __wbg_prototypesetcall_bdcdcc5842e4d77d: function(arg0, arg1, arg2) {
+            Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), getObject(arg2));
+        },
+        __wbg_randomFillSync_f8c153b79f285817: function() { return handleError(function (arg0, arg1) {
+            getObject(arg0).randomFillSync(takeObject(arg1));
+        }, arguments); },
+        __wbg_require_b74f47fc2d022fd6: function() { return handleError(function () {
+            const ret = module.require;
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_static_accessor_GLOBAL_12837167ad935116: function() {
+            const ret = typeof global === 'undefined' ? null : global;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_static_accessor_GLOBAL_THIS_e628e89ab3b1c95f: function() {
+            const ret = typeof globalThis === 'undefined' ? null : globalThis;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_static_accessor_SELF_a621d3dfbb60d0ce: function() {
+            const ret = typeof self === 'undefined' ? null : self;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_static_accessor_WINDOW_f8727f0cf888e0bd: function() {
+            const ret = typeof window === 'undefined' ? null : window;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_subarray_a96e1fef17ed23cb: function(arg0, arg1, arg2) {
+            const ret = getObject(arg0).subarray(arg1 >>> 0, arg2 >>> 0);
+            return addHeapObject(ret);
+        },
+        __wbg_versions_4e31226f5e8dc909: function(arg0) {
+            const ret = getObject(arg0).versions;
+            return addHeapObject(ret);
+        },
+        __wbindgen_cast_0000000000000001: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(Slice(U8)) -> NamedExternref("Uint8Array")`.
+            const ret = getArrayU8FromWasm0(arg0, arg1);
+            return addHeapObject(ret);
+        },
+        __wbindgen_cast_0000000000000002: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(String) -> Externref`.
+            const ret = getStringFromWasm0(arg0, arg1);
+            return addHeapObject(ret);
+        },
+        __wbindgen_object_clone_ref: function(arg0) {
+            const ret = getObject(arg0);
+            return addHeapObject(ret);
+        },
+        __wbindgen_object_drop_ref: function(arg0) {
+            takeObject(arg0);
+        },
     };
     return {
         __proto__: null,
@@ -364,11 +501,31 @@ function __wbg_get_imports() {
     };
 }
 
+function addHeapObject(obj) {
+    if (heap_next === heap.length) heap.push(heap.length + 1);
+    const idx = heap_next;
+    heap_next = heap[idx];
+
+    heap[idx] = obj;
+    return idx;
+}
+
+function dropObject(idx) {
+    if (idx < 132) return;
+    heap[idx] = heap_next;
+    heap_next = idx;
+}
+
 function getArrayU64FromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return getBigUint64ArrayMemory0().subarray(ptr / 8, ptr / 8 + len);
 }
 
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
 let cachedBigUint64ArrayMemory0 = null;
 function getBigUint64ArrayMemory0() {
     if (cachedBigUint64ArrayMemory0 === null || cachedBigUint64ArrayMemory0.byteLength === 0) {
@@ -398,6 +555,25 @@ function getUint8ArrayMemory0() {
     return cachedUint8ArrayMemory0;
 }
 
+function getObject(idx) { return heap[idx]; }
+
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        wasm.__wbindgen_export(addHeapObject(e));
+    }
+}
+
+let heap = new Array(128).fill(undefined);
+heap.push(undefined, null, true, false);
+
+let heap_next = heap.length;
+
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
 function passArray64ToWasm0(arg, malloc) {
     const ptr = malloc(arg.length * 8, 8) >>> 0;
     getBigUint64ArrayMemory0().set(arg, ptr / 8);
@@ -449,6 +625,12 @@ function passStringToWasm0(arg, malloc, realloc) {
     return ptr;
 }
 
+function takeObject(idx) {
+    const ret = getObject(idx);
+    dropObject(idx);
+    return ret;
+}
+
 let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
 cachedTextDecoder.decode();
 function decodeText(ptr, len) {

package/dist/node/rolly_wasm_signer_bg.wasm.d.ts

@@ -4,6 +4,7 @@ export const memory: WebAssembly.Memory;
 export const compute_server_seed_hash: (a: number, b: number, c: number) => void;
 export const create_bet_auth: (a: number, b: number, c: number, d: bigint, e: bigint) => void;
 export const derive_session_key: (a: number, b: number, c: number) => void;
+export const generate_user_seed: (a: number) => void;
 export const goldilocks_fields_to_hex: (a: number, b: number, c: number) => void;
 export const goldilocks_reduce: (a: bigint) => bigint;
 export const poseidon2_hash: (a: number, b: number, c: number) => void;
@@ -13,7 +14,8 @@ export const session_public_key: (a: number, b: number, c: number) => void;
 export const string_to_user_seed: (a: number, b: number, c: number) => void;
 export const string_to_user_seed_hex: (a: number, b: number, c: number) => void;
 export const goldilocks_modulus: () => bigint;
+export const __wbindgen_export: (a: number) => void;
 export const __wbindgen_add_to_stack_pointer: (a: number) => number;
-export const __wbindgen_export: (a: number, b: number) => number;
-export const __wbindgen_export2: (a: number, b: number, c: number) => void;
-export const __wbindgen_export3: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export2: (a: number, b: number) => number;
+export const __wbindgen_export3: (a: number, b: number, c: number) => void;
+export const __wbindgen_export4: (a: number, b: number, c: number, d: number) => number;

package/dist/web/rolly_wasm_signer.d.ts

@@ -59,6 +59,19 @@ export function create_bet_auth(session_key: BigUint64Array, bet_amount: bigint,
  */
 export function derive_session_key(sig_bytes: Uint8Array): BigUint64Array;
 
+/**
+ * Generate a random user seed — 10 alphanumeric characters.
+ *
+ * Uses `getrandom` (backed by `crypto.getRandomValues` in the browser
+ * and OS entropy on Node.js) for cryptographically secure randomness.
+ *
+ * ```js
+ * const seed = generate_user_seed();
+ * // e.g. "k7Qm2xW9aB"
+ * ```
+ */
+export function generate_user_seed(): string;
+
 /**
  * Convert any Goldilocks field elements to a hex string.
  *
@@ -167,6 +180,7 @@ export interface InitOutput {
     readonly compute_server_seed_hash: (a: number, b: number, c: number) => void;
     readonly create_bet_auth: (a: number, b: number, c: number, d: bigint, e: bigint) => void;
     readonly derive_session_key: (a: number, b: number, c: number) => void;
+    readonly generate_user_seed: (a: number) => void;
     readonly goldilocks_fields_to_hex: (a: number, b: number, c: number) => void;
     readonly goldilocks_reduce: (a: bigint) => bigint;
     readonly poseidon2_hash: (a: number, b: number, c: number) => void;
@@ -176,10 +190,11 @@ export interface InitOutput {
     readonly string_to_user_seed: (a: number, b: number, c: number) => void;
     readonly string_to_user_seed_hex: (a: number, b: number, c: number) => void;
     readonly goldilocks_modulus: () => bigint;
+    readonly __wbindgen_export: (a: number) => void;
     readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
-    readonly __wbindgen_export: (a: number, b: number) => number;
-    readonly __wbindgen_export2: (a: number, b: number, c: number) => void;
-    readonly __wbindgen_export3: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number) => number;
+    readonly __wbindgen_export3: (a: number, b: number, c: number) => void;
+    readonly __wbindgen_export4: (a: number, b: number, c: number, d: number) => number;
 }
 
 export type SyncInitInput = BufferSource | WebAssembly.Module;

package/dist/web/rolly_wasm_signer.js

@@ -15,13 +15,13 @@
 export function compute_server_seed_hash(server_seed) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(server_seed, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(server_seed, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.compute_server_seed_hash(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -61,13 +61,13 @@ export function compute_server_seed_hash(server_seed) {
 export function create_bet_auth(session_key, bet_amount, nonce) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(session_key, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(session_key, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.create_bet_auth(retptr, ptr0, len0, bet_amount, nonce);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -95,19 +95,48 @@ export function create_bet_auth(session_key, bet_amount, nonce) {
 export function derive_session_key(sig_bytes) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray8ToWasm0(sig_bytes, wasm.__wbindgen_export);
+        const ptr0 = passArray8ToWasm0(sig_bytes, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.derive_session_key(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
     }
 }
 
+/**
+ * Generate a random user seed — 10 alphanumeric characters.
+ *
+ * Uses `getrandom` (backed by `crypto.getRandomValues` in the browser
+ * and OS entropy on Node.js) for cryptographically secure randomness.
+ *
+ * ```js
+ * const seed = generate_user_seed();
+ * // e.g. "k7Qm2xW9aB"
+ * ```
+ * @returns {string}
+ */
+export function generate_user_seed() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.generate_user_seed(retptr);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred1_0 = r0;
+        deferred1_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export3(deferred1_0, deferred1_1, 1);
+    }
+}
+
 /**
  * Convert any Goldilocks field elements to a hex string.
  *
@@ -125,7 +154,7 @@ export function goldilocks_fields_to_hex(fields) {
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(fields, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(fields, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.goldilocks_fields_to_hex(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
@@ -135,7 +164,7 @@ export function goldilocks_fields_to_hex(fields) {
         return getStringFromWasm0(r0, r1);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export2(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_export3(deferred2_0, deferred2_1, 1);
     }
 }
 
@@ -180,13 +209,13 @@ export function goldilocks_reduce(value) {
 export function poseidon2_hash(input) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(input, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(input, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.poseidon2_hash(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -207,15 +236,15 @@ export function poseidon2_hash(input) {
 export function poseidon2_two_to_one(left, right) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(left, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(left, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
-        const ptr1 = passArray64ToWasm0(right, wasm.__wbindgen_export);
+        const ptr1 = passArray64ToWasm0(right, wasm.__wbindgen_export2);
         const len1 = WASM_VECTOR_LEN;
         wasm.poseidon2_two_to_one(retptr, ptr0, len0, ptr1, len1);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v3 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v3;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -236,13 +265,13 @@ export function poseidon2_two_to_one(left, right) {
 export function seed_hash_truncated(server_seed) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(server_seed, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(server_seed, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.seed_hash_truncated(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -262,13 +291,13 @@ export function seed_hash_truncated(server_seed) {
 export function session_public_key(session_key) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray64ToWasm0(session_key, wasm.__wbindgen_export);
+        const ptr0 = passArray64ToWasm0(session_key, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         wasm.session_public_key(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -294,13 +323,13 @@ export function session_public_key(session_key) {
 export function string_to_user_seed(input) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export, wasm.__wbindgen_export3);
+        const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export2, wasm.__wbindgen_export4);
         const len0 = WASM_VECTOR_LEN;
         wasm.string_to_user_seed(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v2 = getArrayU64FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export2(r0, r1 * 8, 8);
+        wasm.__wbindgen_export3(r0, r1 * 8, 8);
         return v2;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -325,7 +354,7 @@ export function string_to_user_seed_hex(input) {
     let deferred2_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export, wasm.__wbindgen_export3);
+        const ptr0 = passStringToWasm0(input, wasm.__wbindgen_export2, wasm.__wbindgen_export4);
         const len0 = WASM_VECTOR_LEN;
         wasm.string_to_user_seed_hex(retptr, ptr0, len0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
@@ -335,16 +364,123 @@ export function string_to_user_seed_hex(input) {
         return getStringFromWasm0(r0, r1);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export2(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_export3(deferred2_0, deferred2_1, 1);
     }
 }
 
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg___wbindgen_is_function_0095a73b8b156f76: function(arg0) {
+            const ret = typeof(getObject(arg0)) === 'function';
+            return ret;
+        },
+        __wbg___wbindgen_is_object_5ae8e5880f2c1fbd: function(arg0) {
+            const val = getObject(arg0);
+            const ret = typeof(val) === 'object' && val !== null;
+            return ret;
+        },
+        __wbg___wbindgen_is_string_cd444516edc5b180: function(arg0) {
+            const ret = typeof(getObject(arg0)) === 'string';
+            return ret;
+        },
+        __wbg___wbindgen_is_undefined_9e4d92534c42d778: function(arg0) {
+            const ret = getObject(arg0) === undefined;
+            return ret;
+        },
         __wbg___wbindgen_throw_be289d5034ed271b: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
+        __wbg_call_389efe28435a9388: function() { return handleError(function (arg0, arg1) {
+            const ret = getObject(arg0).call(getObject(arg1));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_call_4708e0c13bdc8e95: function() { return handleError(function (arg0, arg1, arg2) {
+            const ret = getObject(arg0).call(getObject(arg1), getObject(arg2));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_crypto_86f2631e91b51511: function(arg0) {
+            const ret = getObject(arg0).crypto;
+            return addHeapObject(ret);
+        },
+        __wbg_getRandomValues_b3f15fcbfabb0f8b: function() { return handleError(function (arg0, arg1) {
+            getObject(arg0).getRandomValues(getObject(arg1));
+        }, arguments); },
+        __wbg_length_32ed9a279acd054c: function(arg0) {
+            const ret = getObject(arg0).length;
+            return ret;
+        },
+        __wbg_msCrypto_d562bbe83e0d4b91: function(arg0) {
+            const ret = getObject(arg0).msCrypto;
+            return addHeapObject(ret);
+        },
+        __wbg_new_no_args_1c7c842f08d00ebb: function(arg0, arg1) {
+            const ret = new Function(getStringFromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
+        __wbg_new_with_length_a2c39cbe88fd8ff1: function(arg0) {
+            const ret = new Uint8Array(arg0 >>> 0);
+            return addHeapObject(ret);
+        },
+        __wbg_node_e1f24f89a7336c2e: function(arg0) {
+            const ret = getObject(arg0).node;
+            return addHeapObject(ret);
+        },
+        __wbg_process_3975fd6c72f520aa: function(arg0) {
+            const ret = getObject(arg0).process;
+            return addHeapObject(ret);
+        },
+        __wbg_prototypesetcall_bdcdcc5842e4d77d: function(arg0, arg1, arg2) {
+            Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), getObject(arg2));
+        },
+        __wbg_randomFillSync_f8c153b79f285817: function() { return handleError(function (arg0, arg1) {
+            getObject(arg0).randomFillSync(takeObject(arg1));
+        }, arguments); },
+        __wbg_require_b74f47fc2d022fd6: function() { return handleError(function () {
+            const ret = module.require;
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_static_accessor_GLOBAL_12837167ad935116: function() {
+            const ret = typeof global === 'undefined' ? null : global;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_static_accessor_GLOBAL_THIS_e628e89ab3b1c95f: function() {
+            const ret = typeof globalThis === 'undefined' ? null : globalThis;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_static_accessor_SELF_a621d3dfbb60d0ce: function() {
+            const ret = typeof self === 'undefined' ? null : self;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_static_accessor_WINDOW_f8727f0cf888e0bd: function() {
+            const ret = typeof window === 'undefined' ? null : window;
+            return isLikeNone(ret) ? 0 : addHeapObject(ret);
+        },
+        __wbg_subarray_a96e1fef17ed23cb: function(arg0, arg1, arg2) {
+            const ret = getObject(arg0).subarray(arg1 >>> 0, arg2 >>> 0);
+            return addHeapObject(ret);
+        },
+        __wbg_versions_4e31226f5e8dc909: function(arg0) {
+            const ret = getObject(arg0).versions;
+            return addHeapObject(ret);
+        },
+        __wbindgen_cast_0000000000000001: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(Slice(U8)) -> NamedExternref("Uint8Array")`.
+            const ret = getArrayU8FromWasm0(arg0, arg1);
+            return addHeapObject(ret);
+        },
+        __wbindgen_cast_0000000000000002: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(String) -> Externref`.
+            const ret = getStringFromWasm0(arg0, arg1);
+            return addHeapObject(ret);
+        },
+        __wbindgen_object_clone_ref: function(arg0) {
+            const ret = getObject(arg0);
+            return addHeapObject(ret);
+        },
+        __wbindgen_object_drop_ref: function(arg0) {
+            takeObject(arg0);
+        },
     };
     return {
         __proto__: null,
@@ -352,11 +488,31 @@ function __wbg_get_imports() {
     };
 }
 
+function addHeapObject(obj) {
+    if (heap_next === heap.length) heap.push(heap.length + 1);
+    const idx = heap_next;
+    heap_next = heap[idx];
+
+    heap[idx] = obj;
+    return idx;
+}
+
+function dropObject(idx) {
+    if (idx < 132) return;
+    heap[idx] = heap_next;
+    heap_next = idx;
+}
+
 function getArrayU64FromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return getBigUint64ArrayMemory0().subarray(ptr / 8, ptr / 8 + len);
 }
 
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
 let cachedBigUint64ArrayMemory0 = null;
 function getBigUint64ArrayMemory0() {
     if (cachedBigUint64ArrayMemory0 === null || cachedBigUint64ArrayMemory0.byteLength === 0) {
@@ -386,6 +542,25 @@ function getUint8ArrayMemory0() {
     return cachedUint8ArrayMemory0;
 }
 
+function getObject(idx) { return heap[idx]; }
+
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        wasm.__wbindgen_export(addHeapObject(e));
+    }
+}
+
+let heap = new Array(128).fill(undefined);
+heap.push(undefined, null, true, false);
+
+let heap_next = heap.length;
+
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
 function passArray64ToWasm0(arg, malloc) {
     const ptr = malloc(arg.length * 8, 8) >>> 0;
     getBigUint64ArrayMemory0().set(arg, ptr / 8);
@@ -437,6 +612,12 @@ function passStringToWasm0(arg, malloc, realloc) {
     return ptr;
 }
 
+function takeObject(idx) {
+    const ret = getObject(idx);
+    dropObject(idx);
+    return ret;
+}
+
 let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
 cachedTextDecoder.decode();
 const MAX_SAFARI_DECODE_BYTES = 2146435072;

package/dist/web/rolly_wasm_signer_bg.wasm.d.ts

@@ -4,6 +4,7 @@ export const memory: WebAssembly.Memory;
 export const compute_server_seed_hash: (a: number, b: number, c: number) => void;
 export const create_bet_auth: (a: number, b: number, c: number, d: bigint, e: bigint) => void;
 export const derive_session_key: (a: number, b: number, c: number) => void;
+export const generate_user_seed: (a: number) => void;
 export const goldilocks_fields_to_hex: (a: number, b: number, c: number) => void;
 export const goldilocks_reduce: (a: bigint) => bigint;
 export const poseidon2_hash: (a: number, b: number, c: number) => void;
@@ -13,7 +14,8 @@ export const session_public_key: (a: number, b: number, c: number) => void;
 export const string_to_user_seed: (a: number, b: number, c: number) => void;
 export const string_to_user_seed_hex: (a: number, b: number, c: number) => void;
 export const goldilocks_modulus: () => bigint;
+export const __wbindgen_export: (a: number) => void;
 export const __wbindgen_add_to_stack_pointer: (a: number) => number;
-export const __wbindgen_export: (a: number, b: number) => number;
-export const __wbindgen_export2: (a: number, b: number, c: number) => void;
-export const __wbindgen_export3: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export2: (a: number, b: number) => number;
+export const __wbindgen_export3: (a: number, b: number, c: number) => void;
+export const __wbindgen_export4: (a: number, b: number, c: number, d: number) => number;

package/js/browser.d.mts

@@ -8,6 +8,7 @@ export {
   seed_hash_truncated,
   string_to_user_seed,
   string_to_user_seed_hex,
+  generate_user_seed,
   goldilocks_fields_to_hex,
   goldilocks_modulus,
   goldilocks_reduce,

package/js/browser.mjs

@@ -10,6 +10,7 @@ export {
   seed_hash_truncated,
   string_to_user_seed,
   string_to_user_seed_hex,
+  generate_user_seed,
   goldilocks_fields_to_hex,
   goldilocks_modulus,
   goldilocks_reduce,

package/js/index.d.ts

@@ -8,6 +8,7 @@ export {
   seed_hash_truncated,
   string_to_user_seed,
   string_to_user_seed_hex,
+  generate_user_seed,
   goldilocks_fields_to_hex,
   goldilocks_modulus,
   goldilocks_reduce,

package/js/node.cjs

@@ -12,6 +12,7 @@ module.exports = {
   seed_hash_truncated:      wasm.seed_hash_truncated,
   string_to_user_seed:      wasm.string_to_user_seed,
   string_to_user_seed_hex:  wasm.string_to_user_seed_hex,
+  generate_user_seed:       wasm.generate_user_seed,
   goldilocks_fields_to_hex: wasm.goldilocks_fields_to_hex,
   goldilocks_modulus:       wasm.goldilocks_modulus,
   goldilocks_reduce:        wasm.goldilocks_reduce,

package/js/node.mjs

@@ -13,6 +13,7 @@ export const {
   seed_hash_truncated,
   string_to_user_seed,
   string_to_user_seed_hex,
+  generate_user_seed,
   goldilocks_fields_to_hex,
   goldilocks_modulus,
   goldilocks_reduce,

package/js/react.d.mts

@@ -1,18 +1,19 @@
 export interface RollyWasmResult {
   ready: boolean;
   error: Error | null;
-  poseidon2_hash:           ((input: BigUint64Array) => BigUint64Array) | null;
-  poseidon2_two_to_one:     ((left: BigUint64Array, right: BigUint64Array) => BigUint64Array) | null;
-  derive_session_key:       ((sig_bytes: Uint8Array) => BigUint64Array) | null;
-  session_public_key:       ((session_key: BigUint64Array) => BigUint64Array) | null;
-  create_bet_auth:          ((session_key: BigUint64Array, bet_amount: bigint, nonce: bigint) => BigUint64Array) | null;
-  compute_server_seed_hash: ((server_seed: BigUint64Array) => BigUint64Array) | null;
-  seed_hash_truncated:      ((server_seed: BigUint64Array) => BigUint64Array) | null;
-  string_to_user_seed:      ((input: string) => BigUint64Array) | null;
-  string_to_user_seed_hex:  ((input: string) => string) | null;
-  goldilocks_fields_to_hex: ((fields: BigUint64Array) => string) | null;
-  goldilocks_modulus:       (() => bigint) | null;
-  goldilocks_reduce:        ((value: bigint) => bigint) | null;
+  poseidon2_hash:           (input: BigUint64Array) => BigUint64Array;
+  poseidon2_two_to_one:     (left: BigUint64Array, right: BigUint64Array) => BigUint64Array;
+  derive_session_key:       (sig_bytes: Uint8Array) => BigUint64Array;
+  session_public_key:       (session_key: BigUint64Array) => BigUint64Array;
+  create_bet_auth:          (session_key: BigUint64Array, bet_amount: bigint, nonce: bigint) => BigUint64Array;
+  compute_server_seed_hash: (server_seed: BigUint64Array) => BigUint64Array;
+  seed_hash_truncated:      (server_seed: BigUint64Array) => BigUint64Array;
+  string_to_user_seed:      (input: string) => BigUint64Array;
+  string_to_user_seed_hex:  (input: string) => string;
+  generate_user_seed:       () => string;
+  goldilocks_fields_to_hex: (fields: BigUint64Array) => string;
+  goldilocks_modulus:       () => bigint;
+  goldilocks_reduce:        (value: bigint) => bigint;
 }
 
 export function useRollyWasm(): RollyWasmResult;

package/js/react.mjs

@@ -9,6 +9,7 @@ import init, {
   seed_hash_truncated,
   string_to_user_seed,
   string_to_user_seed_hex,
+  generate_user_seed,
   goldilocks_fields_to_hex,
   goldilocks_modulus,
   goldilocks_reduce,
@@ -17,11 +18,34 @@ import init, {
 let _ready = false;
 let _promise = null;
 
+function guard(fn) {
+  return (...args) => {
+    if (!_ready) throw new Error('@rolly-dev/wasm-signer: WASM not initialized yet. Check ready === true before calling.');
+    return fn(...args);
+  };
+}
+
+const fns = {
+  poseidon2_hash:           guard(poseidon2_hash),
+  poseidon2_two_to_one:     guard(poseidon2_two_to_one),
+  derive_session_key:       guard(derive_session_key),
+  session_public_key:       guard(session_public_key),
+  create_bet_auth:          guard(create_bet_auth),
+  compute_server_seed_hash: guard(compute_server_seed_hash),
+  seed_hash_truncated:      guard(seed_hash_truncated),
+  string_to_user_seed:      guard(string_to_user_seed),
+  string_to_user_seed_hex:  guard(string_to_user_seed_hex),
+  generate_user_seed:       guard(generate_user_seed),
+  goldilocks_fields_to_hex: guard(goldilocks_fields_to_hex),
+  goldilocks_modulus:       guard(goldilocks_modulus),
+  goldilocks_reduce:        guard(goldilocks_reduce),
+};
+
 /**
  * React hook that initialises the WASM module once (singleton) and
  * returns `{ ready, error, ...wasmFunctions }`.
  *
- * Functions are `null` until `ready === true`.
+ * Functions are always available but will throw if called before `ready === true`.
  *
  * ```jsx
  * const { ready, poseidon2_hash } = useRollyWasm();
@@ -44,20 +68,5 @@ export function useRollyWasm() {
     _promise.then(() => setReady(true)).catch(setError);
   }, []);
 
-  return {
-    ready,
-    error,
-    poseidon2_hash:           ready ? poseidon2_hash : null,
-    poseidon2_two_to_one:     ready ? poseidon2_two_to_one : null,
-    derive_session_key:       ready ? derive_session_key : null,
-    session_public_key:       ready ? session_public_key : null,
-    create_bet_auth:          ready ? create_bet_auth : null,
-    compute_server_seed_hash: ready ? compute_server_seed_hash : null,
-    seed_hash_truncated:      ready ? seed_hash_truncated : null,
-    string_to_user_seed:      ready ? string_to_user_seed : null,
-    string_to_user_seed_hex:  ready ? string_to_user_seed_hex : null,
-    goldilocks_fields_to_hex: ready ? goldilocks_fields_to_hex : null,
-    goldilocks_modulus:       ready ? goldilocks_modulus : null,
-    goldilocks_reduce:        ready ? goldilocks_reduce : null,
-  };
+  return { ready, error, ...fns };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rolly-dev/wasm-signer",
-  "version": "0.3.1",
+  "version": "0.5.1",
   "description": "Poseidon2 hashing & bet signing for Rolly ZK-Rollup (WASM, Goldilocks field)",
   "type": "module",
   "exports": {