@block52/poker-vm-sdk 1.3.1 → 1.3.3

package/dist/deck.d.ts

@@ -16,6 +16,36 @@ export declare class Deck implements IDeck, IJSONModel {
     private top;
     constructor(deck?: string);
     shuffle(seed: number[]): void;
+    /**
+     * Shuffle deterministically from a 32-byte client entropy seed, byte-for-byte
+     * matching the Cosmos chain so the PVM and the chain derive the SAME deck for
+     * the same seed. This is a faithful port of
+     * `pokerchain/x/poker/types/deck.go:ShuffleFromVRF` (poker-vm#2460): without
+     * it the PVM forks from the chain on a client-seed new-hand (#2418).
+     *
+     * DEPRECATED interim: the client-chosen seed is grindable. Superseded by the
+     * validator-entropy VRF re-hardening tracked in poker-vm#2459.
+     *
+     * @param seedHex 32-byte seed as 64 hex chars (the FE's `seed=` value).
+     */
+    shuffleFromSeed(seedHex: string): void;
+    private static readonly PLAYER_SEED_LEN;
+    private static readonly VRF_INFO;
+    /**
+     * Streaming HKDF-Expand (RFC 5869, SHA-256), matching Go
+     * `hkdf.New(sha256.New, ikm, salt, info).Read`:
+     *   PRK = HMAC(salt, ikm); output = T(1)||T(2)||…, T(n) = HMAC(PRK, T(n-1)||info||n).
+     * salt is HashLen zero bytes (Go's nil-salt default). Returns a reader that
+     * yields the next `n` stream bytes on each call.
+     */
+    private static hkdfExpandReader;
+    /**
+     * Uniform integer in [0, max) by rejection sampling — a port of Go
+     * `crypto/rand.Int`. The byte count, high-byte mask and reject test match
+     * the stdlib exactly so the HKDF byte stream is consumed the same way the
+     * chain consumes it. `max` here is always ≤ 52, so the result fits a number.
+     */
+    private static randInt;
     getCardMnemonic(suit: SUIT, rank: number): string;
     getNext(): Card;
     deal(amount: number): Card[];

package/dist/deck.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deck.d.ts","sourceRoot":"","sources":["../src/deck.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,WAAW,KAAK;IAClB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,OAAO,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,IAAI,OAAO,CAAC;CACrB;AAED,qBAAa,IAAK,YAAW,KAAK,EAAE,UAAU;IAC1C,gBAAuB,SAAS,MAAM;IAEtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAM9B;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAK9B;IAEF,OAAO,CAAC,KAAK,CAAc;IACpB,IAAI,EAAE,MAAM,CAAM;IAClB,QAAQ,EAAE,MAAM,CAAM;IAC7B,OAAO,CAAC,GAAG,CAAa;gBAEZ,IAAI,CAAC,EAAE,MAAM;IA0BlB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAa7B,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAOjD,OAAO,IAAI,IAAI;IAIf,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE;IAQ5B,MAAM,IAAI;QAAE,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE;IAM3B,QAAQ,IAAI,MAAM;IAsBzB,OAAO,CAAC,UAAU;WAMJ,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwChD,OAAO,CAAC,cAAc;CAazB"}
+{"version":3,"file":"deck.d.ts","sourceRoot":"","sources":["../src/deck.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,WAAW,KAAK;IAClB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,OAAO,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,IAAI,OAAO,CAAC;CACrB;AAED,qBAAa,IAAK,YAAW,KAAK,EAAE,UAAU;IAC1C,gBAAuB,SAAS,MAAM;IAEtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAM9B;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAK9B;IAEF,OAAO,CAAC,KAAK,CAAc;IACpB,IAAI,EAAE,MAAM,CAAM;IAClB,QAAQ,EAAE,MAAM,CAAM;IAC7B,OAAO,CAAC,GAAG,CAAa;gBAEZ,IAAI,CAAC,EAAE,MAAM;IA0BlB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAapC;;;;;;;;;;;OAWG;IACI,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAuB7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAM;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAEnD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAsB/B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO;IAwBf,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAOjD,OAAO,IAAI,IAAI;IAIf,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE;IAQ5B,MAAM,IAAI;QAAE,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE;IAM3B,QAAQ,IAAI,MAAM;IAsBzB,OAAO,CAAC,UAAU;WAMJ,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwChD,OAAO,CAAC,cAAc;CAazB"}

package/dist/index.d.ts

@@ -45239,6 +45239,7 @@ declare enum NonPlayerActionType {
     JOIN = "join",
     LEAVE = "leave",
     NEW_HAND = "new-hand",
+    POST = "post",
     SIT_IN = "sit-in",
     SIT_IN_AND_WAIT = "sit-in-and-wait",
     SIT_OUT = "sit-out",
@@ -45251,6 +45252,7 @@ declare const AllPlayerActions: {
     JOIN: NonPlayerActionType.JOIN;
     LEAVE: NonPlayerActionType.LEAVE;
     NEW_HAND: NonPlayerActionType.NEW_HAND;
+    POST: NonPlayerActionType.POST;
     SIT_IN: NonPlayerActionType.SIT_IN;
     SIT_IN_AND_WAIT: NonPlayerActionType.SIT_IN_AND_WAIT;
     SIT_OUT: NonPlayerActionType.SIT_OUT;
@@ -46113,6 +46115,36 @@ declare class Deck implements IDeck, IJSONModel {
     private top;
     constructor(deck?: string);
     shuffle(seed: number[]): void;
+    /**
+     * Shuffle deterministically from a 32-byte client entropy seed, byte-for-byte
+     * matching the Cosmos chain so the PVM and the chain derive the SAME deck for
+     * the same seed. This is a faithful port of
+     * `pokerchain/x/poker/types/deck.go:ShuffleFromVRF` (poker-vm#2460): without
+     * it the PVM forks from the chain on a client-seed new-hand (#2418).
+     *
+     * DEPRECATED interim: the client-chosen seed is grindable. Superseded by the
+     * validator-entropy VRF re-hardening tracked in poker-vm#2459.
+     *
+     * @param seedHex 32-byte seed as 64 hex chars (the FE's `seed=` value).
+     */
+    shuffleFromSeed(seedHex: string): void;
+    private static readonly PLAYER_SEED_LEN;
+    private static readonly VRF_INFO;
+    /**
+     * Streaming HKDF-Expand (RFC 5869, SHA-256), matching Go
+     * `hkdf.New(sha256.New, ikm, salt, info).Read`:
+     *   PRK = HMAC(salt, ikm); output = T(1)||T(2)||…, T(n) = HMAC(PRK, T(n-1)||info||n).
+     * salt is HashLen zero bytes (Go's nil-salt default). Returns a reader that
+     * yields the next `n` stream bytes on each call.
+     */
+    private static hkdfExpandReader;
+    /**
+     * Uniform integer in [0, max) by rejection sampling — a port of Go
+     * `crypto/rand.Int`. The byte count, high-byte mask and reject test match
+     * the stdlib exactly so the HKDF byte stream is consumed the same way the
+     * chain consumes it. `max` here is always ≤ 52, so the result fits a number.
+     */
+    private static randInt;
     getCardMnemonic(suit: SUIT, rank: number): string;
     getNext(): Card;
     deal(amount: number): Card[];

package/dist/index.esm.js

@@ -2,7 +2,7 @@ import { Registry, DirectSecp256k1HdWallet, encodePubkey, makeAuthInfoBytes, mak
 import { SigningStargateClient, GasPrice } from '@cosmjs/stargate';
 import { EventEmitter } from 'events';
 import { stringToPath } from '@cosmjs/crypto';
-import { createHash } from 'crypto';
+import { createHash, createHmac } from 'crypto';
 import { toBase64, fromBase64 } from '@cosmjs/encoding';
 import { encodeSecp256k1Pubkey } from '@cosmjs/amino';
 
@@ -56051,6 +56051,11 @@ var NonPlayerActionType;
     NonPlayerActionType["JOIN"] = "join";
     NonPlayerActionType["LEAVE"] = "leave";
     NonPlayerActionType["NEW_HAND"] = "new-hand";
+    // Entry big blind auto-posted when a post-now joiner activates off the blind
+    // seats (poker-vm#2553). Recorded in ANTE; counted toward the pot + the
+    // player's bet (they're matched) but excluded from the first-to-act /
+    // has-acted scans (it's a non-player action, like DEAD_SMALL_BLIND).
+    NonPlayerActionType["POST"] = "post";
     NonPlayerActionType["SIT_IN"] = "sit-in";
     // Sit in and wait for the big blind — distinct action from SIT_IN (post now)
     // so each has a single responsibility. Sets WAITING_FOR_BIG_BLIND. (#2139)
@@ -57191,6 +57196,92 @@ class Deck {
         // Explicitly update hash after shuffling
         this.createHash();
     }
+    /**
+     * Shuffle deterministically from a 32-byte client entropy seed, byte-for-byte
+     * matching the Cosmos chain so the PVM and the chain derive the SAME deck for
+     * the same seed. This is a faithful port of
+     * `pokerchain/x/poker/types/deck.go:ShuffleFromVRF` (poker-vm#2460): without
+     * it the PVM forks from the chain on a client-seed new-hand (#2418).
+     *
+     * DEPRECATED interim: the client-chosen seed is grindable. Superseded by the
+     * validator-entropy VRF re-hardening tracked in poker-vm#2459.
+     *
+     * @param seedHex 32-byte seed as 64 hex chars (the FE's `seed=` value).
+     */
+    shuffleFromSeed(seedHex) {
+        const seed = Buffer.from(seedHex, "hex");
+        if (seed.length !== Deck.PLAYER_SEED_LEN) {
+            throw new Error(`player seed must be ${Deck.PLAYER_SEED_LEN} bytes, got ${seed.length}`);
+        }
+        this.seedHash = createHash("sha256").update(seed).digest("hex");
+        // HKDF-SHA256 expand (salt = HashLen zero bytes, info = VRF_INFO),
+        // consumed as an on-demand byte stream — mirrors Go hkdf.New(...).Read.
+        const read = Deck.hkdfExpandReader(seed, Buffer.alloc(32), Buffer.from(Deck.VRF_INFO));
+        // Fisher-Yates with crypto/rand.Int rejection sampling (Go semantics),
+        // so the HKDF stream is consumed identically to the chain.
+        for (let i = this.cards.length - 1; i > 0; i--) {
+            const j = Deck.randInt(read, i + 1);
+            [this.cards[i], this.cards[j]] = [this.cards[j], this.cards[i]];
+        }
+        this.createHash();
+    }
+    /**
+     * Streaming HKDF-Expand (RFC 5869, SHA-256), matching Go
+     * `hkdf.New(sha256.New, ikm, salt, info).Read`:
+     *   PRK = HMAC(salt, ikm); output = T(1)||T(2)||…, T(n) = HMAC(PRK, T(n-1)||info||n).
+     * salt is HashLen zero bytes (Go's nil-salt default). Returns a reader that
+     * yields the next `n` stream bytes on each call.
+     */
+    static hkdfExpandReader(ikm, salt, info) {
+        const prk = createHmac("sha256", salt).update(ikm).digest();
+        let buffer = Buffer.alloc(0);
+        let t = Buffer.alloc(0);
+        let counter = 1;
+        return (n) => {
+            while (buffer.length < n) {
+                if (counter > 255) {
+                    throw new Error("HKDF stream exhausted (>255 blocks)");
+                }
+                t = createHmac("sha256", prk)
+                    .update(Buffer.concat([t, info, Buffer.from([counter])]))
+                    .digest();
+                buffer = Buffer.concat([buffer, t]);
+                counter++;
+            }
+            const out = Buffer.from(buffer.subarray(0, n)); // copy before advancing
+            buffer = buffer.subarray(n);
+            return out;
+        };
+    }
+    /**
+     * Uniform integer in [0, max) by rejection sampling — a port of Go
+     * `crypto/rand.Int`. The byte count, high-byte mask and reject test match
+     * the stdlib exactly so the HKDF byte stream is consumed the same way the
+     * chain consumes it. `max` here is always ≤ 52, so the result fits a number.
+     */
+    static randInt(read, max) {
+        const nMax = max - 1; // largest valid value; bit length is taken over max-1
+        if (nMax === 0) {
+            return 0; // max === 1: only 0 is valid, no bytes consumed
+        }
+        const bitLen = 32 - Math.clz32(nMax);
+        const k = Math.ceil(bitLen / 8);
+        let b = bitLen % 8;
+        if (b === 0) {
+            b = 8;
+        }
+        for (;;) {
+            const bytes = read(k);
+            bytes[0] &= (1 << b) - 1; // clear high bits of the top byte
+            let n = 0;
+            for (const byte of bytes) {
+                n = n * 256 + byte; // big-endian, matching big.Int.SetBytes
+            }
+            if (n < max) {
+                return n;
+            }
+        }
+    }
     getCardMnemonic(suit, rank) {
         const rankNum = Number(rank);
         const rankStr = Deck.RANK_MAP[rankNum] !== undefined ? Deck.RANK_MAP[rankNum] : rankNum.toString();
@@ -57317,6 +57408,10 @@ Deck.SUIT_MAP = {
     [SUIT.HEARTS]: "H",
     [SUIT.SPADES]: "S"
 };
+// Matches pokerchain types.PlayerSeedLen and VRFInputPrefix — the two sides
+// MUST agree on these or the derived decks diverge.
+Deck.PLAYER_SEED_LEN = 32;
+Deck.VRF_INFO = "poker/deck/v1";
 
 /**
  * The community board for a Texas Hold'em hand.