@rolly-dev/wasm-signer 1.31.1 → 1.31.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,17 +1,24 @@
1
1
  # @rolly-dev/wasm-signer
2
2
 
3
- Client-side Poseidon2 hashing and bet authentication for the Rolly ZK-Rollup casino.
3
+ Server-side Poseidon2 hashing and bet authentication for the Rolly ZK-Rollup casino.
4
4
 
5
5
  Built with Rust → WebAssembly (via `wasm-pack`), using the same Poseidon2 hasher
6
6
  and Goldilocks field as the plonky2 proving circuit.
7
7
 
8
+ Node.js only — the backend and orchestrator run this package; the block explorer
9
+ still consumes the published `1.31.x` browser build for payout verification. The
10
+ web dApp uses the pure-TS `@rolly-dev/auth-sign` package for hashing / signing
11
+ instead (WASM does not load reliably under strict CSP / on some devices), and
12
+ `auth-sign` carries no payout math — `games-core` via this crate is the only
13
+ JS-facing source of it.
14
+
8
15
  ## Build
9
16
 
10
17
  ```bash
11
18
  # requires: cargo, wasm-pack
12
19
  npm run build
13
- # → dist/node/ (Node.js, CJS, sync init)
14
- # → dist/web/ (Browser, ESM, async init)
20
+ # → dist/node/ (Node.js, CJS, sync init, loads .wasm from disk)
21
+ # → dist/node-inline/ (Node.js, self-contained, WASM embedded as base64)
15
22
  ```
16
23
 
17
24
  ## Usage
@@ -42,44 +49,6 @@ const sessionKey = derive_session_key(metamaskSignatureBytes);
42
49
  const pkHash = session_public_key(sessionKey, BigInt(expiryTimestamp));
43
50
  ```
44
51
 
45
- ### React
46
-
47
- ```jsx
48
- import { useRollyWasm } from '@rolly-dev/wasm-signer/react';
49
-
50
- function SessionInfo({ sessionKey, expiry }) {
51
- const { ready, session_public_key } = useRollyWasm();
52
-
53
- if (!ready) return <span>Loading...</span>;
54
-
55
- const pkHash = session_public_key(sessionKey, BigInt(expiry));
56
- // register pkHash on-chain via key_register tx...
57
-
58
- return <div>Session active until {new Date(Number(expiry) * 1000).toLocaleString()}</div>;
59
- }
60
- ```
61
-
62
- ### Browser (vanilla ESM)
63
-
64
- ```html
65
- <script type="module">
66
- import { init, poseidon2_hash } from '@rolly-dev/wasm-signer';
67
-
68
- await init(); // loads .wasm, must be called once
69
- const h = poseidon2_hash(BigUint64Array.from([1n, 2n]));
70
- </script>
71
- ```
72
-
73
- ### Manual init (advanced)
74
-
75
- ```javascript
76
- import init, { poseidon2_hash } from '@rolly-dev/wasm-signer/init';
77
-
78
- // custom wasm URL or ArrayBuffer
79
- await init('/assets/rolly_wasm_signer_bg.wasm');
80
- poseidon2_hash(BigUint64Array.from([1n]));
81
- ```
82
-
83
52
  ## API
84
53
 
85
54
  | Function | Input | Output | Description |
@@ -93,20 +62,6 @@ poseidon2_hash(BigUint64Array.from([1n]));
93
62
  | `goldilocks_modulus` | — | `bigint` | Returns p = 2^64 - 2^32 + 1 |
94
63
  | `goldilocks_reduce` | `bigint` | `bigint` | Reduce mod p |
95
64
 
96
- ## Bundler notes
97
-
98
- **Vite** — add to `optimizeDeps.exclude`:
99
- ```js
100
- optimizeDeps: { exclude: ['@rolly-dev/wasm-signer'] }
101
- ```
102
-
103
- **Webpack 5** — enable WASM experiments:
104
- ```js
105
- module.exports = { experiments: { asyncWebAssembly: true } };
106
- ```
107
-
108
- **Next.js** — conditional exports auto-resolve: Node.js entry on server, browser entry on client.
109
-
110
65
  ## Dice — range constraints
111
66
 
112
67
  Roll number: `[0, 999]` (TOTAL_RANGE = 1000).
@@ -1,17 +1,24 @@
1
1
  # @rolly-dev/wasm-signer
2
2
 
3
- Client-side Poseidon2 hashing and bet authentication for the Rolly ZK-Rollup casino.
3
+ Server-side Poseidon2 hashing and bet authentication for the Rolly ZK-Rollup casino.
4
4
 
5
5
  Built with Rust → WebAssembly (via `wasm-pack`), using the same Poseidon2 hasher
6
6
  and Goldilocks field as the plonky2 proving circuit.
7
7
 
8
+ Node.js only — the backend and orchestrator run this package; the block explorer
9
+ still consumes the published `1.31.x` browser build for payout verification. The
10
+ web dApp uses the pure-TS `@rolly-dev/auth-sign` package for hashing / signing
11
+ instead (WASM does not load reliably under strict CSP / on some devices), and
12
+ `auth-sign` carries no payout math — `games-core` via this crate is the only
13
+ JS-facing source of it.
14
+
8
15
  ## Build
9
16
 
10
17
  ```bash
11
18
  # requires: cargo, wasm-pack
12
19
  npm run build
13
- # → dist/node/ (Node.js, CJS, sync init)
14
- # → dist/web/ (Browser, ESM, async init)
20
+ # → dist/node/ (Node.js, CJS, sync init, loads .wasm from disk)
21
+ # → dist/node-inline/ (Node.js, self-contained, WASM embedded as base64)
15
22
  ```
16
23
 
17
24
  ## Usage
@@ -42,44 +49,6 @@ const sessionKey = derive_session_key(metamaskSignatureBytes);
42
49
  const pkHash = session_public_key(sessionKey, BigInt(expiryTimestamp));
43
50
  ```
44
51
 
45
- ### React
46
-
47
- ```jsx
48
- import { useRollyWasm } from '@rolly-dev/wasm-signer/react';
49
-
50
- function SessionInfo({ sessionKey, expiry }) {
51
- const { ready, session_public_key } = useRollyWasm();
52
-
53
- if (!ready) return <span>Loading...</span>;
54
-
55
- const pkHash = session_public_key(sessionKey, BigInt(expiry));
56
- // register pkHash on-chain via key_register tx...
57
-
58
- return <div>Session active until {new Date(Number(expiry) * 1000).toLocaleString()}</div>;
59
- }
60
- ```
61
-
62
- ### Browser (vanilla ESM)
63
-
64
- ```html
65
- <script type="module">
66
- import { init, poseidon2_hash } from '@rolly-dev/wasm-signer';
67
-
68
- await init(); // loads .wasm, must be called once
69
- const h = poseidon2_hash(BigUint64Array.from([1n, 2n]));
70
- </script>
71
- ```
72
-
73
- ### Manual init (advanced)
74
-
75
- ```javascript
76
- import init, { poseidon2_hash } from '@rolly-dev/wasm-signer/init';
77
-
78
- // custom wasm URL or ArrayBuffer
79
- await init('/assets/rolly_wasm_signer_bg.wasm');
80
- poseidon2_hash(BigUint64Array.from([1n]));
81
- ```
82
-
83
52
  ## API
84
53
 
85
54
  | Function | Input | Output | Description |
@@ -93,20 +62,6 @@ poseidon2_hash(BigUint64Array.from([1n]));
93
62
  | `goldilocks_modulus` | — | `bigint` | Returns p = 2^64 - 2^32 + 1 |
94
63
  | `goldilocks_reduce` | `bigint` | `bigint` | Reduce mod p |
95
64
 
96
- ## Bundler notes
97
-
98
- **Vite** — add to `optimizeDeps.exclude`:
99
- ```js
100
- optimizeDeps: { exclude: ['@rolly-dev/wasm-signer'] }
101
- ```
102
-
103
- **Webpack 5** — enable WASM experiments:
104
- ```js
105
- module.exports = { experiments: { asyncWebAssembly: true } };
106
- ```
107
-
108
- **Next.js** — conditional exports auto-resolve: Node.js entry on server, browser entry on client.
109
-
110
65
  ## Dice — range constraints
111
66
 
112
67
  Roll number: `[0, 999]` (TOTAL_RANGE = 1000).
@@ -33,7 +33,9 @@ export function aviato_rtp_percent(): number;
33
33
  * must be 4 elements (`string_to_user_seed(user_seed_source)`).
34
34
  *
35
35
  * **Output**: `Uint8Array` of length 30 — rank codes `0..=12` (Ace=0, 2..9=1..8,
36
- * 10/J/Q/K=9..12). Suits are cosmetic and restored off-engine.
36
+ * 10/J/Q/K=9..12). Suits are cosmetic (not consensus); the true suits of the
37
+ * same drawn cards are exposed by [`compute_payout_blackjack`] (`shoe_suits`
38
+ * and the per-hand `*_suits`).
37
39
  *
38
40
  * ```js
39
41
  * const shoe = blackjack_deal_shoe(serverSeed8, userSecret4); // length 30
@@ -126,7 +128,9 @@ export function compute_payout_aviato(random: BigUint64Array, bet_atomic: bigint
126
128
  * ```js
127
129
  * const res = compute_payout_blackjack(serverSeed8, userSecret4, lo, hi, betAtomic);
128
130
  * // res.win_amount, res.total_staked, res.shoe (length 30),
131
+ * // res.shoe_suits (length 30, cosmetic suit codes 0..3 of the same cards),
129
132
  * // res.first_cards / res.second_cards / res.dealer_cards (rank codes),
133
+ * // res.first_suits / res.second_suits / res.dealer_suits (parallel suits),
130
134
  * // res.first_kind / res.second_kind (per-hand type: 0=bet,1=hit,2=stand,
131
135
  * // 3=double,4=split,5=insurance; a closed hand reports 2),
132
136
  * // res.first_amount / res.second_amount (per-hand staked, atomic),
@@ -52,7 +52,9 @@ exports.aviato_rtp_percent = aviato_rtp_percent;
52
52
  * must be 4 elements (`string_to_user_seed(user_seed_source)`).
53
53
  *
54
54
  * **Output**: `Uint8Array` of length 30 — rank codes `0..=12` (Ace=0, 2..9=1..8,
55
- * 10/J/Q/K=9..12). Suits are cosmetic and restored off-engine.
55
+ * 10/J/Q/K=9..12). Suits are cosmetic (not consensus); the true suits of the
56
+ * same drawn cards are exposed by [`compute_payout_blackjack`] (`shoe_suits`
57
+ * and the per-hand `*_suits`).
56
58
  *
57
59
  * ```js
58
60
  * const shoe = blackjack_deal_shoe(serverSeed8, userSecret4); // length 30
@@ -267,7 +269,9 @@ exports.compute_payout_aviato = compute_payout_aviato;
267
269
  * ```js
268
270
  * const res = compute_payout_blackjack(serverSeed8, userSecret4, lo, hi, betAtomic);
269
271
  * // res.win_amount, res.total_staked, res.shoe (length 30),
272
+ * // res.shoe_suits (length 30, cosmetic suit codes 0..3 of the same cards),
270
273
  * // res.first_cards / res.second_cards / res.dealer_cards (rank codes),
274
+ * // res.first_suits / res.second_suits / res.dealer_suits (parallel suits),
271
275
  * // res.first_kind / res.second_kind (per-hand type: 0=bet,1=hit,2=stand,
272
276
  * // 3=double,4=split,5=insurance; a closed hand reports 2),
273
277
  * // res.first_amount / res.second_amount (per-hand staked, atomic),
Binary file
@@ -1,17 +1,24 @@
1
1
  # @rolly-dev/wasm-signer
2
2
 
3
- Client-side Poseidon2 hashing and bet authentication for the Rolly ZK-Rollup casino.
3
+ Server-side Poseidon2 hashing and bet authentication for the Rolly ZK-Rollup casino.
4
4
 
5
5
  Built with Rust → WebAssembly (via `wasm-pack`), using the same Poseidon2 hasher
6
6
  and Goldilocks field as the plonky2 proving circuit.
7
7
 
8
+ Node.js only — the backend and orchestrator run this package; the block explorer
9
+ still consumes the published `1.31.x` browser build for payout verification. The
10
+ web dApp uses the pure-TS `@rolly-dev/auth-sign` package for hashing / signing
11
+ instead (WASM does not load reliably under strict CSP / on some devices), and
12
+ `auth-sign` carries no payout math — `games-core` via this crate is the only
13
+ JS-facing source of it.
14
+
8
15
  ## Build
9
16
 
10
17
  ```bash
11
18
  # requires: cargo, wasm-pack
12
19
  npm run build
13
- # → dist/node/ (Node.js, CJS, sync init)
14
- # → dist/web/ (Browser, ESM, async init)
20
+ # → dist/node/ (Node.js, CJS, sync init, loads .wasm from disk)
21
+ # → dist/node-inline/ (Node.js, self-contained, WASM embedded as base64)
15
22
  ```
16
23
 
17
24
  ## Usage
@@ -42,44 +49,6 @@ const sessionKey = derive_session_key(metamaskSignatureBytes);
42
49
  const pkHash = session_public_key(sessionKey, BigInt(expiryTimestamp));
43
50
  ```
44
51
 
45
- ### React
46
-
47
- ```jsx
48
- import { useRollyWasm } from '@rolly-dev/wasm-signer/react';
49
-
50
- function SessionInfo({ sessionKey, expiry }) {
51
- const { ready, session_public_key } = useRollyWasm();
52
-
53
- if (!ready) return <span>Loading...</span>;
54
-
55
- const pkHash = session_public_key(sessionKey, BigInt(expiry));
56
- // register pkHash on-chain via key_register tx...
57
-
58
- return <div>Session active until {new Date(Number(expiry) * 1000).toLocaleString()}</div>;
59
- }
60
- ```
61
-
62
- ### Browser (vanilla ESM)
63
-
64
- ```html
65
- <script type="module">
66
- import { init, poseidon2_hash } from '@rolly-dev/wasm-signer';
67
-
68
- await init(); // loads .wasm, must be called once
69
- const h = poseidon2_hash(BigUint64Array.from([1n, 2n]));
70
- </script>
71
- ```
72
-
73
- ### Manual init (advanced)
74
-
75
- ```javascript
76
- import init, { poseidon2_hash } from '@rolly-dev/wasm-signer/init';
77
-
78
- // custom wasm URL or ArrayBuffer
79
- await init('/assets/rolly_wasm_signer_bg.wasm');
80
- poseidon2_hash(BigUint64Array.from([1n]));
81
- ```
82
-
83
52
  ## API
84
53
 
85
54
  | Function | Input | Output | Description |
@@ -93,20 +62,6 @@ poseidon2_hash(BigUint64Array.from([1n]));
93
62
  | `goldilocks_modulus` | — | `bigint` | Returns p = 2^64 - 2^32 + 1 |
94
63
  | `goldilocks_reduce` | `bigint` | `bigint` | Reduce mod p |
95
64
 
96
- ## Bundler notes
97
-
98
- **Vite** — add to `optimizeDeps.exclude`:
99
- ```js
100
- optimizeDeps: { exclude: ['@rolly-dev/wasm-signer'] }
101
- ```
102
-
103
- **Webpack 5** — enable WASM experiments:
104
- ```js
105
- module.exports = { experiments: { asyncWebAssembly: true } };
106
- ```
107
-
108
- **Next.js** — conditional exports auto-resolve: Node.js entry on server, browser entry on client.
109
-
110
65
  ## Dice — range constraints
111
66
 
112
67
  Roll number: `[0, 999]` (TOTAL_RANGE = 1000).
@@ -33,7 +33,9 @@ export function aviato_rtp_percent(): number;
33
33
  * must be 4 elements (`string_to_user_seed(user_seed_source)`).
34
34
  *
35
35
  * **Output**: `Uint8Array` of length 30 — rank codes `0..=12` (Ace=0, 2..9=1..8,
36
- * 10/J/Q/K=9..12). Suits are cosmetic and restored off-engine.
36
+ * 10/J/Q/K=9..12). Suits are cosmetic (not consensus); the true suits of the
37
+ * same drawn cards are exposed by [`compute_payout_blackjack`] (`shoe_suits`
38
+ * and the per-hand `*_suits`).
37
39
  *
38
40
  * ```js
39
41
  * const shoe = blackjack_deal_shoe(serverSeed8, userSecret4); // length 30
@@ -126,7 +128,9 @@ export function compute_payout_aviato(random: BigUint64Array, bet_atomic: bigint
126
128
  * ```js
127
129
  * const res = compute_payout_blackjack(serverSeed8, userSecret4, lo, hi, betAtomic);
128
130
  * // res.win_amount, res.total_staked, res.shoe (length 30),
131
+ * // res.shoe_suits (length 30, cosmetic suit codes 0..3 of the same cards),
129
132
  * // res.first_cards / res.second_cards / res.dealer_cards (rank codes),
133
+ * // res.first_suits / res.second_suits / res.dealer_suits (parallel suits),
130
134
  * // res.first_kind / res.second_kind (per-hand type: 0=bet,1=hit,2=stand,
131
135
  * // 3=double,4=split,5=insurance; a closed hand reports 2),
132
136
  * // res.first_amount / res.second_amount (per-hand staked, atomic),