@provable-games/dm-engine 0.1.0

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * Death Mountain engine -- the TypeScript mirror of the Cairo game rules and the
+ * commit-reveal protocol.
+ *
+ * Shared by the client (optimistic/authoritative simulation) and the indexer
+ * (off-chain replay of committed transcripts). There is one implementation of the
+ * rules; if this and the contracts ever disagree, that is the bug.
+ */
+// Commit-reveal protocol: domains, action codec, root/fold/actionEntropy.
+export * from "./protocol.js";
+export * from "./actions.js";
+export * from "./packing.js";
+export * from "./staging.js";
+export * from "./view.js";
+// Replay.
+export * from "./replay.js";
+export * from "./transcript.js";
+export * from "./events.js";
+// Shared types and constants.
+export * from "./types.js";
+export * as GameConstants from "./constants/game.js";
+export * as BeastConstants from "./constants/beast.js";
+export * as LootConstants from "./constants/loot.js";
+export * as ObstacleConstants from "./constants/obstacle.js";
+// Rules.
+export * from "./rules/beast.js";
+export * from "./rules/game.js";
+export * from "./rules/gameSimulation.js";
+export * from "./rules/health.js";
+export * from "./rules/loot.js";
+export * from "./rules/market.js";
+export * from "./rules/processFutures.js";
+export * from "./rules/tokenId.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,UAAU;AACV,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAE5B,8BAA8B;AAC9B,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAE7D,SAAS;AACT,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC"}

package/dist/packing.d.ts

@@ -0,0 +1,6 @@
+import type { Adventurer, Item } from "./types.js";
+export declare function unpackAdventurer(packed: bigint): Adventurer;
+export declare function unpackBag(packed: bigint): Item[];
+export declare function felt252AsU256(value: bigint): [bigint, bigint];
+export declare function decodeTransferTokenId(keys: string[], owner: bigint): bigint;
+//# sourceMappingURL=packing.d.ts.map

package/dist/packing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packing.d.ts","sourceRoot":"","sources":["../src/packing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AASnD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CA4C3D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,CAShD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAG7D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAS3E"}

package/dist/packing.js

@@ -0,0 +1,76 @@
+const MASK_16 = 0xffffn;
+const MASK_128 = (1n << 128n) - 1n;
+function unpackItem(raw) {
+    return { id: Number(raw & 0x7fn), xp: Number(raw >> 7n) };
+}
+export function unpackAdventurer(packed) {
+    let equipment = packed & MASK_128;
+    const items = [];
+    for (let index = 0; index < 8; index += 1) {
+        items.push(unpackItem(equipment & MASK_16));
+        equipment >>= 16n;
+    }
+    let high = packed >> 128n;
+    const take = (bits) => {
+        const mask = (1n << bits) - 1n;
+        const value = Number(high & mask);
+        high >>= bits;
+        return value;
+    };
+    return {
+        health: take(10n),
+        xp: take(15n),
+        gold: take(9n),
+        beast_health: take(10n),
+        stat_upgrades_available: take(4n),
+        stats: {
+            strength: take(5n),
+            dexterity: take(5n),
+            vitality: take(5n),
+            intelligence: take(5n),
+            wisdom: take(5n),
+            charisma: take(5n),
+            luck: 0,
+        },
+        equipment: {
+            weapon: items[0],
+            chest: items[1],
+            head: items[2],
+            waist: items[3],
+            foot: items[4],
+            hand: items[5],
+            neck: items[6],
+            ring: items[7],
+        },
+        item_specials_salt: take(14n),
+        beast_salt: take(17n),
+        level_salt: take(14n),
+    };
+}
+export function unpackBag(packed) {
+    const items = [];
+    let value = packed;
+    for (let index = 0; index < 15; index += 1) {
+        const item = unpackItem(value & MASK_16);
+        if (item.id !== 0)
+            items.push(item);
+        value >>= 16n;
+    }
+    return items;
+}
+export function felt252AsU256(value) {
+    if (value < 0n || value >= 1n << 252n)
+        throw new Error("game ID must fit felt252");
+    return [value & MASK_128, value >> 128n];
+}
+export function decodeTransferTokenId(keys, owner) {
+    if (keys.length !== 5 || BigInt(keys[1]) !== 0n || BigInt(keys[2]) !== owner) {
+        throw new Error("mint receipt has no matching ERC-721 Transfer event");
+    }
+    const low = BigInt(keys[3]);
+    const high = BigInt(keys[4]);
+    if (low >= 1n << 128n || high >= 1n << 124n)
+        throw new Error("minted token ID does not fit felt252");
+    return low + (high << 128n);
+}
+//# sourceMappingURL=packing.js.map

package/dist/packing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packing.js","sourceRoot":"","sources":["../src/packing.ts"],"names":[],"mappings":"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"}

package/dist/protocol.d.ts

@@ -0,0 +1,55 @@
+export declare const PROTOCOL_VERSION = 1;
+export declare const ACTION_ENCODING_VERSION = 1;
+export declare const ROOT_DOMAIN_V1 = 121694572726488482774558358552433875120163030783537n;
+export declare const ACTION_DOMAIN_V1 = 7975375518203149207113456586092306125417059215317358129n;
+export declare const ENTROPY_DOMAIN_V1 = 2041696132660006197021044886039630387199149808693909870129n;
+export declare const Opcode: {
+    readonly START: 1;
+    readonly EXPLORE: 2;
+    readonly ATTACK: 3;
+    readonly FLEE: 4;
+    readonly SELECT_STATS: 5;
+    readonly BUY: 6;
+    readonly EQUIP: 7;
+    readonly DROP: 8;
+    readonly SURRENDER: 9;
+};
+export type OpcodeValue = (typeof Opcode)[keyof typeof Opcode];
+export interface ProtocolStats {
+    strength: number;
+    dexterity: number;
+    vitality: number;
+    intelligence: number;
+    wisdom: number;
+    charisma: number;
+    luck?: number;
+}
+export interface ProtocolPurchase {
+    itemId: number;
+    equip: boolean;
+}
+export interface DecodedAction {
+    opcode: OpcodeValue;
+    first: number;
+    second: number;
+    flag: boolean;
+    stats: Required<ProtocolStats>;
+    potions: number;
+    purchases: ProtocolPurchase[];
+    items: number[];
+}
+export declare function root(gameId: bigint): bigint;
+export declare function fold(previous: bigint, encodedAction: bigint, commitBlock: bigint): bigint;
+export declare function actionEntropy(rolling: bigint, nextBlockHash: bigint): bigint;
+export declare function encodeStart(weapon: number): bigint;
+export declare function encodeExplore(tillDamage: number, tillGold: boolean): bigint;
+export declare function encodeAttack(tillHealth: number, tillBeastHealth: number): bigint;
+export declare function encodeFlee(tillHealth: number): bigint;
+export declare function encodeSelectStats(stats: ProtocolStats): bigint;
+export declare function encodeBuy(potions: number, purchases: ProtocolPurchase[]): bigint;
+export declare function encodeEquip(items: number[]): bigint;
+export declare function encodeDrop(items: number[]): bigint;
+export declare function encodeSurrender(): bigint;
+export declare function decodeAction(raw: bigint): DecodedAction;
+export declare function actionOpcode(encoded: bigint): OpcodeValue;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,cAAc,uDAAuD,CAAC;AACnF,eAAO,MAAM,gBAAgB,2DAA2D,CAAC;AACzF,eAAO,MAAM,iBAAiB,8DAA8D,CAAC;AAE7F,eAAO,MAAM,MAAM;;;;;;;;;;CAUT,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAwDD,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAKzF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAG3E;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAIhF;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAkB9D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAYhF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAUnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAUlD;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAsEvD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAEzD"}

package/dist/protocol.js

@@ -0,0 +1,250 @@
+import { hash } from "starknet";
+export const PROTOCOL_VERSION = 1;
+export const ACTION_ENCODING_VERSION = 1;
+export const ROOT_DOMAIN_V1 = 121694572726488482774558358552433875120163030783537n;
+export const ACTION_DOMAIN_V1 = 7975375518203149207113456586092306125417059215317358129n;
+export const ENTROPY_DOMAIN_V1 = 2041696132660006197021044886039630387199149808693909870129n;
+export const Opcode = {
+    START: 1,
+    EXPLORE: 2,
+    ATTACK: 3,
+    FLEE: 4,
+    SELECT_STATS: 5,
+    BUY: 6,
+    EQUIP: 7,
+    DROP: 8,
+    SURRENDER: 9,
+};
+const HEADER_VERSION = 0x10n;
+const SHIFT_8 = 0x100n;
+const SHIFT_12 = 0x1000n;
+const SHIFT_13 = 0x2000n;
+const SHIFT_16 = 0x10000n;
+const SHIFT_21 = 0x200000n;
+const SHIFT_24 = 0x1000000n;
+const STARTING_WEAPONS = new Set([12, 16, 46, 76]);
+function poseidon(values) {
+    return BigInt(hash.computePoseidonHashOnElements(values));
+}
+function header(opcode) {
+    return HEADER_VERSION + BigInt(opcode);
+}
+function assertUnsigned(value, bits, name) {
+    if (!Number.isInteger(value) || value < 0 || value >= 2 ** bits) {
+        throw new Error(`${name} must be an unsigned ${bits}-bit integer`);
+    }
+}
+function assertItem(itemId) {
+    if (!Number.isInteger(itemId) || itemId < 1 || itemId > 101) {
+        throw new Error("item id must be in [1, 101]");
+    }
+}
+function bits(value, shift, mask) {
+    return (value / shift) & mask;
+}
+function empty(opcode) {
+    return {
+        opcode,
+        first: 0,
+        second: 0,
+        flag: false,
+        stats: {
+            strength: 0,
+            dexterity: 0,
+            vitality: 0,
+            intelligence: 0,
+            wisdom: 0,
+            charisma: 0,
+            luck: 0,
+        },
+        potions: 0,
+        purchases: [],
+        items: [],
+    };
+}
+export function root(gameId) {
+    return poseidon([ROOT_DOMAIN_V1, gameId]);
+}
+export function fold(previous, encodedAction, commitBlock) {
+    if (commitBlock < 0n || commitBlock > 0xffffffffffffffffn) {
+        throw new Error("commit block must fit u64");
+    }
+    return poseidon([ACTION_DOMAIN_V1, previous, encodedAction, commitBlock]);
+}
+export function actionEntropy(rolling, nextBlockHash) {
+    return poseidon([ENTROPY_DOMAIN_V1, rolling, nextBlockHash]);
+}
+export function encodeStart(weapon) {
+    if (!STARTING_WEAPONS.has(weapon))
+        throw new Error("invalid starting weapon");
+    return header(Opcode.START) + SHIFT_8 * BigInt(weapon);
+}
+export function encodeExplore(tillDamage, tillGold) {
+    assertUnsigned(tillDamage, 16, "tillDamage");
+    return header(Opcode.EXPLORE) + SHIFT_8 * BigInt(tillDamage) + (tillGold ? SHIFT_24 : 0n);
+}
+export function encodeAttack(tillHealth, tillBeastHealth) {
+    assertUnsigned(tillHealth, 16, "tillHealth");
+    assertUnsigned(tillBeastHealth, 16, "tillBeastHealth");
+    return header(Opcode.ATTACK) + SHIFT_8 * BigInt(tillHealth) + SHIFT_24 * BigInt(tillBeastHealth);
+}
+export function encodeFlee(tillHealth) {
+    assertUnsigned(tillHealth, 16, "tillHealth");
+    return header(Opcode.FLEE) + SHIFT_8 * BigInt(tillHealth);
+}
+export function encodeSelectStats(stats) {
+    const ordered = [
+        stats.strength,
+        stats.dexterity,
+        stats.vitality,
+        stats.intelligence,
+        stats.wisdom,
+        stats.charisma,
+    ];
+    for (const [index, value] of ordered.entries())
+        assertUnsigned(value, 5, `stat[${index}]`);
+    if ((stats.luck ?? 0) !== 0)
+        throw new Error("luck allocation is unsupported");
+    let encoded = header(Opcode.SELECT_STATS);
+    let cursor = SHIFT_8;
+    for (const value of ordered) {
+        encoded += cursor * BigInt(value);
+        cursor *= 0x20n;
+    }
+    return encoded;
+}
+export function encodeBuy(potions, purchases) {
+    assertUnsigned(potions, 8, "potions");
+    if (purchases.length > 23)
+        throw new Error("at most 23 purchases are supported");
+    let encoded = header(Opcode.BUY) + SHIFT_8 * BigInt(potions) + SHIFT_16 * BigInt(purchases.length);
+    let cursor = SHIFT_21;
+    for (const purchase of purchases) {
+        assertItem(purchase.itemId);
+        encoded += cursor * (BigInt(purchase.itemId) + (purchase.equip ? 0x100n : 0n));
+        cursor *= 0x200n;
+    }
+    return encoded;
+}
+export function encodeEquip(items) {
+    if (items.length < 1 || items.length > 8)
+        throw new Error("equip count must be in [1, 8]");
+    let encoded = header(Opcode.EQUIP) + SHIFT_8 * BigInt(items.length);
+    let cursor = SHIFT_12;
+    for (const item of items) {
+        assertItem(item);
+        encoded += cursor * BigInt(item);
+        cursor *= 0x100n;
+    }
+    return encoded;
+}
+export function encodeDrop(items) {
+    if (items.length < 1 || items.length > 23)
+        throw new Error("drop count must be in [1, 23]");
+    let encoded = header(Opcode.DROP) + SHIFT_8 * BigInt(items.length);
+    let cursor = SHIFT_13;
+    for (const item of items) {
+        assertItem(item);
+        encoded += cursor * BigInt(item);
+        cursor *= 0x100n;
+    }
+    return encoded;
+}
+export function encodeSurrender() {
+    return header(Opcode.SURRENDER);
+}
+export function decodeAction(raw) {
+    if (raw < 0n)
+        throw new Error("encoded action cannot be negative");
+    if (Number(bits(raw, 0x10n, 0xfn)) !== ACTION_ENCODING_VERSION) {
+        throw new Error("bad action version");
+    }
+    const opcode = Number(raw & 0xfn);
+    const action = empty(opcode);
+    if (opcode === Opcode.START) {
+        if (raw >= 0x10000n)
+            throw new Error("noncanonical START");
+        action.first = Number(bits(raw, SHIFT_8, 0xffn));
+        if (!STARTING_WEAPONS.has(action.first))
+            throw new Error("invalid starting weapon");
+    }
+    else if (opcode === Opcode.EXPLORE) {
+        if (raw >= 0x2000000n)
+            throw new Error("noncanonical EXPLORE");
+        action.first = Number(bits(raw, SHIFT_8, 0xffffn));
+        action.flag = bits(raw, SHIFT_24, 1n) === 1n;
+    }
+    else if (opcode === Opcode.ATTACK) {
+        if (raw >= 0x10000000000n)
+            throw new Error("noncanonical ATTACK");
+        action.first = Number(bits(raw, SHIFT_8, 0xffffn));
+        action.second = Number(bits(raw, SHIFT_24, 0xffffn));
+    }
+    else if (opcode === Opcode.FLEE) {
+        if (raw >= 0x1000000n)
+            throw new Error("noncanonical FLEE");
+        action.first = Number(bits(raw, SHIFT_8, 0xffffn));
+    }
+    else if (opcode === Opcode.SELECT_STATS) {
+        if (raw >= 0x4000000000n)
+            throw new Error("noncanonical SELECT_STATS");
+        let cursor = SHIFT_8;
+        const values = [];
+        for (let index = 0; index < 6; index += 1) {
+            values.push(Number(bits(raw, cursor, 0x1fn)));
+            cursor *= 0x20n;
+        }
+        [
+            action.stats.strength,
+            action.stats.dexterity,
+            action.stats.vitality,
+            action.stats.intelligence,
+            action.stats.wisdom,
+            action.stats.charisma,
+        ] = values;
+    }
+    else if (opcode === Opcode.BUY) {
+        action.potions = Number(bits(raw, SHIFT_8, 0xffn));
+        const count = Number(bits(raw, SHIFT_16, 0x1fn));
+        if (count > 23)
+            throw new Error("invalid BUY count");
+        let cursor = SHIFT_21;
+        for (let index = 0; index < count; index += 1) {
+            const entry = bits(raw, cursor, 0x1ffn);
+            const itemId = Number(entry & 0xffn);
+            assertItem(itemId);
+            action.purchases.push({ itemId, equip: (entry & 0x100n) !== 0n });
+            cursor *= 0x200n;
+        }
+        if (raw >= cursor)
+            throw new Error("noncanonical BUY");
+    }
+    else if (opcode === Opcode.EQUIP || opcode === Opcode.DROP) {
+        const shift = opcode === Opcode.EQUIP ? SHIFT_12 : SHIFT_13;
+        const count = Number(bits(raw, SHIFT_8, opcode === Opcode.EQUIP ? 0xfn : 0x1fn));
+        const max = opcode === Opcode.EQUIP ? 8 : 23;
+        if (count < 1 || count > max)
+            throw new Error("invalid item count");
+        let cursor = shift;
+        for (let index = 0; index < count; index += 1) {
+            const itemId = Number(bits(raw, cursor, 0xffn));
+            assertItem(itemId);
+            action.items.push(itemId);
+            cursor *= 0x100n;
+        }
+        if (raw >= cursor)
+            throw new Error("noncanonical item action");
+    }
+    else if (opcode === Opcode.SURRENDER) {
+        if (raw >= 0x100n)
+            throw new Error("noncanonical SURRENDER");
+    }
+    else {
+        throw new Error("unknown opcode");
+    }
+    return action;
+}
+export function actionOpcode(encoded) {
+    return decodeAction(encoded).opcode;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/replay.d.ts

@@ -0,0 +1,35 @@
+import { Adventurer, GameAction, GameSettingsData, Item } from "./types.js";
+import { Beast } from "./types.js";
+import { GameEvent } from "./events.js";
+/** Everything the handlers read that used to live in the client's zustand store. */
+export interface ReplayState {
+    adventurer: Adventurer | null;
+    bag: Item[];
+    beast: Beast | null;
+    gameSettings: GameSettingsData | null;
+    /** Last chain-confirmed adventurer; `equip` diffs against it to find what changed. */
+    adventurerState: Adventurer | null;
+    gameId: string | null;
+    /**
+     * Whether `adventurer.equipment` and `bag` already reflect a pending `equip`.
+     *
+     * True for the client, whose zustand store equips optimistically the moment the player taps
+     * an item, so by the time the action runs the move has happened. False for the off-chain
+     * replayer, which holds the state as of the last completed action and must perform the move
+     * itself. Defaults to true so the client's behaviour is the one you get by omission.
+     */
+    equipmentApplied?: boolean;
+}
+/**
+ * Apply one action to `state` and return the events it produced.
+ *
+ * This is `useGameCore`'s body verbatim, with the store reads replaced by `state` and the
+ * `actionEntropy` reads replaced by `entropy`. It is pure: no store, no RPC, no `Date`, and
+ * -- when `entropy` is non-null -- no `Math.random()`. That last property is what lets the
+ * client and the off-chain replayer agree, and it is asserted by the entropy test suite.
+ *
+ * `entropy` is `action_entropy(rolling_i, blockhash)` for a commit-reveal game, or `null` for
+ * a legacy dungeon, where the handlers fall back to a settings `game_seed` or `Math.random()`.
+ */
+export declare function applyAction(state: ReplayState, action: GameAction, entropy: bigint | null): GameEvent[];
+//# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA2JxC,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,GAAG,EAAE,IAAI,EAAE,CAAC;IACZ,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtC,sFAAsF;IACtF,eAAe,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,SAAS,EAAE,CAo5Bb"}