@rolly-dev/witness-core 0.2.1 → 0.3.0

package/index.d.ts

@@ -124,6 +124,11 @@ export interface ProcessTxRequest {
   gameMode?: number
   predictionLo?: number
   predictionHi?: number
+  /**
+   * Blackjack only: base stake (decimal string). The engine replays the round
+   * from this to derive the TOTAL staked (recorded as `amount`) and the win.
+   */
+  baseBet?: string
   userSecretRandom?: Buffer
   useGameLock?: boolean
   maxBlockTimestamp?: string
@@ -233,6 +238,21 @@ export declare class MerkleEngine {
    * marked dirty — the loaded value already matches the store.
    */
   loadServerSeed(userId: number, seed: Buffer): void
+  /**
+   * Recovery-only: enqueue the next server seeds `next_server_seed` returns
+   * (FIFO) instead of drawing from the CSPRNG. Lets the offline block
+   * reconstruction tool deterministically replay already-committed blocks
+   * from their recorded next-seed chain. No effect on normal operation — the
+   * queue is empty unless this is called. Each buffer is 64 LE bytes (8 limbs).
+   */
+  forceNextSeeds(seeds: Array<Buffer>): void
+  /**
+   * Recovery-only: recompute one user's leaf hash from its loaded raw balance
+   * leaf + pk / address hashes. Call after overwriting those via the `load_*`
+   * setters to an earlier state, then `rebuild_nodes_from_leaves`, to roll a
+   * touched leaf back without re-running its txs.
+   */
+  recomputeLeaf(userId: number): void
   /**
    * Adopt the persisted block-meta root after the full tree is loaded. The
    * loaded leaves/nodes must reproduce it — verify with [`Self::verify_root`].
@@ -257,6 +277,17 @@ export declare class MerkleEngine {
   /** Spendable balance minus all frozen buckets (withdrawal + game locks). */
   getAvailable(userId: number): bigint
   getSeedHash(userId: number): Buffer
+  /**
+   * Read-only reveal of the user's current committed full server seed (64 LE
+   * bytes = 8 limbs). The blackjack backend needs it at DEAL time to unfold
+   * the fair shoe and run the round off-chain before the single settle
+   * `in_house_bet`. This does NOT advance the seed chain: it returns the seed
+   * already committed by the previous slot's `next_seed_hash`, and the
+   * eventual blackjack settle IHB is the next tx to consume / rotate it (so
+   * the backend MUST keep the round the next IHB for this user). Returns an
+   * all-zero 64-byte buffer when the user has no initialized seed yet.
+   */
+  getServerSeed(userId: number): Buffer
   getPkHash(userId: number): Buffer
   getAddressHash(userId: number): Buffer
   getLockedTotal(userId: number): bigint

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rolly-dev/witness-core",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Authoritative native witness-state engine for Rolly ZK-Rollup (Node-API addon)",
   "main": "index.js",
   "types": "index.d.ts",