@rolly-dev/witness-core 1.0.0 → 1.0.2

package/index.d.ts

@@ -47,6 +47,19 @@ export interface FlushResult {
   deltasJson: string
   addressRecordsJson: string
   pkHashRecordsJson: string
+  /**
+   * Per-block signed transactions (`SchnorrProveEntry[]` JSON) in slot order,
+   * decoded from each authenticated slot's opaque `signature` blob. `"[]"`
+   * when the block has no signed txs. Node stores it on the pipeline block
+   * doc as `signed_entries`; the auth-orchestrator batches it into the
+   * Schnorr side-circuit.
+   */
+  signedEntriesJson: string
+  /**
+   * Per-block `key_register` transactions (`RegistrationProveEntry[]` JSON) in
+   * slot order. `"[]"` when none. Stored as `registration_entries`.
+   */
+  registrationEntriesJson: string
 }
 /**
  * Result of [`MerkleEngine::verify_root`], surfaced to Node for the post-load
@@ -317,6 +330,44 @@ export declare class MerkleEngine {
   releaseSeed(userId: number): void
   /** Whether `user_id` currently holds a live (non-expired) seed reservation. */
   isSeedReserved(userId: number): boolean
+  /**
+   * Key-registration handshake: reserve the account's initial server seed for
+   * a first-time `key_register` and return its truncated 3-limb hash
+   * (`init_seed_hash`, 24 little-endian bytes). The client folds this hash
+   * into the EIP-712 KeyRegistration payload it signs; `process_key_register`
+   * then installs THIS reserved seed so the leaf's `new_seed` hash matches
+   * the signed value the RegistrationBatch side-circuit's `reg_elem` verifies
+   * (drawing a fresh seed here would desync the two). Idempotent: repeated
+   * calls before the registration lands return the SAME reserved seed hash,
+   * so a client re-fetching the handshake keeps signing a consistent value.
+   * Draws a fresh seed only on the first call for the account. NON-consensus.
+   */
+  reserveInitSeed(userId: number): Buffer
+  /**
+   * Drop a first-registration seed reservation without registering (the
+   * handshake was abandoned). No-op when the user has none. NON-consensus.
+   */
+  releaseInitSeed(userId: number): void
+  /**
+   * Whether `user_id` currently holds a reserved (not-yet-installed) initial
+   * registration seed.
+   */
+  hasInitSeedReservation(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": "1.0.0",
+  "version": "1.0.2",
   "description": "Authoritative native witness-state engine for Rolly ZK-Rollup (Node-API addon)",
   "main": "index.js",
   "types": "index.d.ts",