@rolly-dev/witness-core 0.2.2 → 0.3.1

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
@@ -272,6 +277,34 @@ 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
+  /**
+   * Pin `user_id`'s server seed for an open off-chain blackjack round. While
+   * reserved, any OTHER user-seed `in_house_bet` (dice/limbo/keno/plinko/
+   * coinflip) is rejected with `SeedReserved`; the blackjack settle IHB (and
+   * only it) is allowed through and clears the reservation. Crash is
+   * unaffected — it draws from the house account seed, not the user's.
+   * A HARD pin with no expiry: only the settle or `release_seed` lifts it.
+   * NON-consensus.
+   */
+  reserveSeed(userId: number): void
+  /**
+   * Release a seed reservation (blackjack round settled or rolled back).
+   * No-op when the user has none.
+   */
+  releaseSeed(userId: number): void
+  /** Whether `user_id` currently holds a live (non-expired) seed reservation. */
+  isSeedReserved(userId: number): boolean
   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.2",
+  "version": "0.3.1",
   "description": "Authoritative native witness-state engine for Rolly ZK-Rollup (Node-API addon)",
   "main": "index.js",
   "types": "index.d.ts",