@rolly-dev/witness-core 0.3.2 → 1.0.1

package/index.d.ts

@@ -68,7 +68,7 @@ export interface DirtyNode {
   index: number
   hash: Buffer
 }
-/** One dirty raw balance leaf (56-byte little-endian, 7 limbs). */
+/** One dirty raw balance leaf (64-byte little-endian, 8 limbs). */
 export interface DirtyRaw {
   userId: number
   raw: Buffer
@@ -105,8 +105,8 @@ export interface DirtyData {
 }
 /**
  * Per-tx request from Node. Opaque field groups arrive as little-endian
- * `Buffer`s (`session_key` / `new_pk_hash` / `user_secret_random` = 32 bytes =
- * 4 limbs; `user_address` = 20 bytes); monetary values arrive as decimal
+ * `Buffer`s (`new_pk_hash` / `user_secret_random` = 32 bytes = 4 limbs;
+ * `user_address` = 20 bytes); monetary values arrive as decimal
  * strings to dodge JS `Number` precision and `BigInt`-in-object quirks. Node
  * keeps all hex/string parsing (incl. deriving `user_secret_random` from the
  * raw user-seed source via wasm-signer); the engine takes only parsed bytes.
@@ -117,9 +117,20 @@ export interface ProcessTxRequest {
   amount: string
   winAmount?: string
   userAddress?: Buffer
-  sessionKey?: Buffer
-  sessionExpiry?: string
+  /**
+   * `Poseidon2(recipient_address)[0..2]` as 16 little-endian bytes (2 limbs)
+   * — the payout counterparty (hot wallet) the client Schnorr-signs. Absent
+   * for operator / non-authenticated tx.
+   */
+  recipientAddrHash?: Buffer
   newPkHash?: Buffer
+  /**
+   * Client authorization signature bytes, forwarded verbatim (opaque here).
+   * EcGFp5 Schnorr `(s, e)` over the tx_hash for a user-authenticated tx, or
+   * an EIP-712 secp256k1 signature for `key_register`. Absent for operator /
+   * L1-event tx. See [`process::TxRequest::signature`].
+   */
+  signature?: Buffer
   gameId?: number
   gameMode?: number
   predictionLo?: number
@@ -131,7 +142,6 @@ export interface ProcessTxRequest {
   baseBet?: string
   userSecretRandom?: Buffer
   useGameLock?: boolean
-  maxBlockTimestamp?: string
 }
 /**
  * Authoritative post-tx result returned to Node. Monetary values are decimal
@@ -143,6 +153,7 @@ export interface ProcessTxResult {
   newBalance: string
   available: string
   newCredit: string
+  newNonce: string
   winAmount: string
   random?: string
   nextSeedHash?: string
@@ -274,6 +285,7 @@ export declare class MerkleEngine {
   getTl(): bigint
   getBalance(userId: number): bigint
   getCredit(userId: number): bigint
+  getNonce(userId: number): bigint
   /** Spendable balance minus all frozen buckets (withdrawal + game locks). */
   getAvailable(userId: number): bigint
   getSeedHash(userId: number): Buffer
@@ -305,6 +317,21 @@ export declare class MerkleEngine {
   releaseSeed(userId: number): void
   /** Whether `user_id` currently holds a live (non-expired) seed reservation. */
   isSeedReserved(userId: number): boolean
+  /**
+   * Open a crash-round auth lock for `user_id`: while set, `process_tx`
+   * rejects any nonce-bumping tx (`in_house_bet` / `withdrawal` / `transfer`
+   * / `key_register`) with `CrashRoundOpen`, so the account's pre-signed
+   * `crash_settle` auto-cashout keeps its bound nonce. Called by the crash
+   * game when a bet is placed. NON-consensus; idempotent.
+   */
+  lockCrashRound(userId: number): void
+  /**
+   * Release a crash-round auth lock (the round settled or was abandoned).
+   * No-op when the user has none.
+   */
+  unlockCrashRound(userId: number): void
+  /** Whether `user_id` currently has an open crash-round auth lock. */
+  isCrashRoundLocked(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.3.2",
+  "version": "1.0.1",
   "description": "Authoritative native witness-state engine for Rolly ZK-Rollup (Node-API addon)",
   "main": "index.js",
   "types": "index.d.ts",