@provable-games/dm-engine 0.1.0

package/dist/rules/tokenId.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Denshokan game id for Death Mountain. Defined here rather than imported from the
+ * client's Denshokan React context so this module stays runtime-agnostic; the client
+ * re-exports it from `@/contexts/denshokan`.
+ */
+export declare const GAME_ID = 1;
+export interface PackedTokenId {
+    game_id: number;
+    minted_by: number;
+    settings_id: number;
+    start_delay: number;
+    soulbound: boolean;
+    has_context: boolean;
+    paymaster: boolean;
+    minted_at: number;
+    end_delay: number;
+    objective_id: number;
+    tx_hash: number;
+    salt: number;
+    metadata: number;
+}
+export declare function unpackTokenId(tokenId: number | bigint | string): PackedTokenId;
+export declare function packTokenId(params?: Partial<PackedTokenId>): bigint;
+export declare function unpackGameId(tokenId: number | bigint | string): number;
+export declare function unpackSettingsId(tokenId: number | bigint | string): number;
+export declare function unpackMintedBy(tokenId: number | bigint | string): number;
+export declare function unpackMintedAt(tokenId: number | bigint | string): number;
+export declare function unpackStartDelay(tokenId: number | bigint | string): number;
+export declare function unpackEndDelay(tokenId: number | bigint | string): number;
+export declare function unpackObjectiveId(tokenId: number | bigint | string): number;
+//# sourceMappingURL=tokenId.d.ts.map

package/dist/rules/tokenId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenId.d.ts","sourceRoot":"","sources":["../../src/rules/tokenId.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,eAAO,MAAM,OAAO,IAAI,CAAC;AAWzB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CA8C9E;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,MAAM,CAmCvE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAE3E"}

package/dist/rules/tokenId.js

@@ -0,0 +1,102 @@
+// Decodes fields from a packed token ID (felt252).
+//
+// Bit layout (251 bits, u128-aligned):
+// Low u128: game_id(30) | minted_by(40) | settings_id(30) | start_delay(25) | soulbound(1) | has_context(1) | paymaster(1)
+// High u128: minted_at(35) | end_delay(25) | objective_id(30) | tx_hash(10) | salt(10) | metadata(13)
+/**
+ * Denshokan game id for Death Mountain. Defined here rather than imported from the
+ * client's Denshokan React context so this module stays runtime-agnostic; the client
+ * re-exports it from `@/contexts/denshokan`.
+ */
+export const GAME_ID = 1;
+const MASK_1 = 0x1n;
+const MASK_10 = 0x3ffn;
+const MASK_13 = 0x1fffn;
+const MASK_25 = 0x1ffffffn;
+const MASK_30 = 0x3fffffffn;
+const MASK_35 = 0x7ffffffffn;
+const MASK_40 = 0xffffffffffn;
+const MASK_128 = (1n << 128n) - 1n;
+export function unpackTokenId(tokenId) {
+    const packed = BigInt(tokenId);
+    let low = packed & MASK_128;
+    let high = packed >> 128n;
+    const game_id = Number(low & MASK_30);
+    low >>= 30n;
+    const minted_by = Number(low & MASK_40);
+    low >>= 40n;
+    const settings_id = Number(low & MASK_30);
+    low >>= 30n;
+    const start_delay = Number(low & MASK_25);
+    low >>= 25n;
+    const soulbound = (low & MASK_1) === 1n;
+    low >>= 1n;
+    const has_context = (low & MASK_1) === 1n;
+    low >>= 1n;
+    const paymaster = (low & MASK_1) === 1n;
+    const minted_at = Number(high & MASK_35);
+    high >>= 35n;
+    const end_delay = Number(high & MASK_25);
+    high >>= 25n;
+    const objective_id = Number(high & MASK_30);
+    high >>= 30n;
+    const tx_hash = Number(high & MASK_10);
+    high >>= 10n;
+    const salt = Number(high & MASK_10);
+    high >>= 10n;
+    const metadata = Number(high & MASK_13);
+    return {
+        game_id,
+        minted_by,
+        settings_id,
+        start_delay,
+        soulbound,
+        has_context,
+        paymaster,
+        minted_at,
+        end_delay,
+        objective_id,
+        tx_hash,
+        salt,
+        metadata,
+    };
+}
+export function packTokenId(params = {}) {
+    const { game_id = GAME_ID, minted_by = 0, settings_id = 0, start_delay = 0, soulbound = false, has_context = false, paymaster = false, minted_at = Math.round(Date.now() / 1000), end_delay = 0, objective_id = 0, tx_hash = Math.floor(Math.random() * 1000), salt = Math.floor(Math.random() * 1000), metadata = 0, } = params;
+    const low = (BigInt(game_id) & MASK_30) |
+        ((BigInt(minted_by) & MASK_40) << 30n) |
+        ((BigInt(settings_id) & MASK_30) << 70n) |
+        ((BigInt(start_delay) & MASK_25) << 100n) |
+        ((soulbound ? 1n : 0n) << 125n) |
+        ((has_context ? 1n : 0n) << 126n) |
+        ((paymaster ? 1n : 0n) << 127n);
+    const high = (BigInt(minted_at) & MASK_35) |
+        ((BigInt(end_delay) & MASK_25) << 35n) |
+        ((BigInt(objective_id) & MASK_30) << 60n) |
+        ((BigInt(tx_hash) & MASK_10) << 90n) |
+        ((BigInt(salt) & MASK_10) << 100n) |
+        ((BigInt(metadata) & MASK_13) << 110n);
+    return (high << 128n) | low;
+}
+export function unpackGameId(tokenId) {
+    return Number(BigInt(tokenId) & MASK_30);
+}
+export function unpackSettingsId(tokenId) {
+    return Number((BigInt(tokenId) >> 70n) & MASK_30);
+}
+export function unpackMintedBy(tokenId) {
+    return Number((BigInt(tokenId) >> 30n) & MASK_40);
+}
+export function unpackMintedAt(tokenId) {
+    return Number((BigInt(tokenId) >> 128n) & MASK_35);
+}
+export function unpackStartDelay(tokenId) {
+    return Number((BigInt(tokenId) >> 100n) & MASK_25);
+}
+export function unpackEndDelay(tokenId) {
+    return Number((BigInt(tokenId) >> 163n) & MASK_25);
+}
+export function unpackObjectiveId(tokenId) {
+    return Number((BigInt(tokenId) >> 188n) & MASK_30);
+}
+//# sourceMappingURL=tokenId.js.map

package/dist/rules/tokenId.js.map

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

package/dist/staging.d.ts

@@ -0,0 +1,18 @@
+import type { Adventurer } from "./types.js";
+/**
+ * Whether an action can be held back and committed alongside the next real one.
+ *
+ * Two conditions, both from `replay.cairo`, and both necessary:
+ *
+ * 1. The action must consume NO entropy, because staging means simulating it before its block hash
+ *    exists. SELECT_STATS, BUY and DROP never do; EQUIP does, but only in battle, where it
+ *    triggers a counterattack.
+ * 2. It must be legal out of battle -- which is where the `beast_health` test really comes from.
+ *    The live actions behind all four of these assert `!in_battle`, so staging one mid-fight would
+ *    build a commitment that settlement rejects.
+ *
+ * Both collapse to the same test, so it is written once.
+ */
+export declare function isStageableDeterministicAction(actionType: string, beastHealth: number): boolean;
+export declare function encodePendingIdleEquip(adventurer: Adventurer | null, committedView: Adventurer | null): bigint | null;
+//# sourceMappingURL=staging.d.ts.map

package/dist/staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.d.ts","sourceRoot":"","sources":["../src/staging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO7C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAE/F;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,GAAG,IAAI,EAC7B,aAAa,EAAE,UAAU,GAAG,IAAI,GAC/B,MAAM,GAAG,IAAI,CAMf"}

package/dist/staging.js

@@ -0,0 +1,27 @@
+import { getNewItemsEquipped } from "./rules/game.js";
+import { encodeEquip } from "./protocol.js";
+const STAGEABLE_ACTIONS = new Set(["select_stat_upgrades", "buy_items", "equip", "drop"]);
+/**
+ * Whether an action can be held back and committed alongside the next real one.
+ *
+ * Two conditions, both from `replay.cairo`, and both necessary:
+ *
+ * 1. The action must consume NO entropy, because staging means simulating it before its block hash
+ *    exists. SELECT_STATS, BUY and DROP never do; EQUIP does, but only in battle, where it
+ *    triggers a counterattack.
+ * 2. It must be legal out of battle -- which is where the `beast_health` test really comes from.
+ *    The live actions behind all four of these assert `!in_battle`, so staging one mid-fight would
+ *    build a commitment that settlement rejects.
+ *
+ * Both collapse to the same test, so it is written once.
+ */
+export function isStageableDeterministicAction(actionType, beastHealth) {
+    return STAGEABLE_ACTIONS.has(actionType) && beastHealth === 0;
+}
+export function encodePendingIdleEquip(adventurer, committedView) {
+    if (!adventurer || !committedView || adventurer.beast_health !== 0)
+        return null;
+    const items = getNewItemsEquipped(adventurer.equipment, committedView.equipment).map((item) => item.id);
+    return items.length === 0 ? null : encodeEquip(items);
+}
+//# sourceMappingURL=staging.js.map

package/dist/staging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.js","sourceRoot":"","sources":["../src/staging.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,sBAAsB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1F;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,8BAA8B,CAAC,UAAkB,EAAE,WAAmB;IACpF,OAAO,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,WAAW,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAA6B,EAC7B,aAAgC;IAEhC,IAAI,CAAC,UAAU,IAAI,CAAC,aAAa,IAAI,UAAU,CAAC,YAAY,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,MAAM,KAAK,GAAG,mBAAmB,CAAC,UAAU,CAAC,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,GAAG,CAClF,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAClB,CAAC;IACF,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/transcript.d.ts

@@ -0,0 +1,64 @@
+export interface ActionCommittedEvent {
+    adventurerId: bigint;
+    /** One call may carry many actions. They fold individually but share a commit block. */
+    encodedActions: bigint[];
+    blockNumber: bigint;
+    transactionHash: string;
+    transactionIndex: number;
+    eventIndex: number;
+}
+/**
+ * Decode one `ActionCommitted { #[key] adventurer_id, encoded_actions: Span<felt252> }`.
+ *
+ * Serde writes a `Span` as a length followed by its elements, so `data[0]` is the count.
+ */
+export declare function decodeActionCommitted(keys: string[], data: string[], position: {
+    blockNumber: bigint;
+    transactionHash: string;
+    transactionIndex: number;
+    eventIndex: number;
+}): ActionCommittedEvent;
+export interface GameSettledEvent {
+    adventurerId: bigint;
+    settler: bigint;
+    protocolVersion: number;
+    finalCommitment: bigint;
+    committedActionCount: number;
+    terminalActionIndex: number;
+    terminalReason: number;
+    packedAdventurer: bigint;
+    packedBag: bigint;
+    settledAtBlock: bigint;
+}
+/** Decode one `GameSettled { #[key] adventurer_id, #[key] settler, ...8 felts }`. */
+export declare function decodeGameSettled(keys: string[], data: string[]): GameSettledEvent;
+/**
+ * Chain order for commit events.
+ *
+ * `(block_number, transaction_index, event_index)`. Block number alone is NOT enough: two
+ * commits for one adventurer can land in the same block, and folding them the wrong way round
+ * yields a different commitment and different entropy for every action after.
+ */
+export declare function compareCommitOrder(a: ActionCommittedEvent, b: ActionCommittedEvent): number;
+export interface Transcript {
+    adventurerId: bigint;
+    /** Flat, one entry per action -- not per commit call. Parallel with `blocks`. */
+    actions: bigint[];
+    /** The commit block of each action; repeats are the normal signature of a bundle. */
+    blocks: bigint[];
+    /** The rolling commitment after each action; action `i`'s entropy is derived from `rolling[i]`. */
+    rollings: bigint[];
+    /** The value that must equal `get_commitment(adventurer_id)` on chain. */
+    finalCommitment: bigint;
+    /** Index of the first SURRENDER, or null. A death is invisible here -- only replay finds it. */
+    surrenderIndex: number | null;
+}
+/**
+ * Re-fold a game's commit events into the transcript settlement expects.
+ *
+ * The output `actions`/`blocks` pair is exactly what `settle_game(id, actions, blocks)` takes,
+ * and `finalCommitment` is what it will check against the stored felt -- so a caller can verify
+ * its own reconstruction before spending gas on a settlement that would revert.
+ */
+export declare function reconstructTranscript(adventurerId: bigint, events: ActionCommittedEvent[]): Transcript;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvG,oBAAoB,CAgBtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAclF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAI3F;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qFAAqF;IACrF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mGAAmG;IACnG,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,oBAAoB,EAAE,GAC7B,UAAU,CAsBZ"}

package/dist/transcript.js

@@ -0,0 +1,92 @@
+import { actionOpcode, fold, Opcode, root } from "./protocol.js";
+/**
+ * Reading a commit-reveal GameCore's event log.
+ *
+ * The contract emits only `ActionCommitted`, and it carries the bare minimum: the game id and
+ * the felts committed. Everything else an indexer or a resuming client wants -- the rolling
+ * commitment, each action's index, whether the run has closed -- is *derived* here by re-folding
+ * the transcript, exactly as `commit_action` did when it wrote it.
+ *
+ * Shared by the indexer's off-chain replay and the client's resume path so both reconstruct a
+ * run the same way. If they disagreed, the client would act on a board the indexer never shows
+ * spectators, and one of the two would be wrong about what the chain holds.
+ */
+const felt = (value) => (value ? BigInt(value) : 0n);
+/**
+ * Decode one `ActionCommitted { #[key] adventurer_id, encoded_actions: Span<felt252> }`.
+ *
+ * Serde writes a `Span` as a length followed by its elements, so `data[0]` is the count.
+ */
+export function decodeActionCommitted(keys, data, position) {
+    if (keys.length < 2)
+        throw new Error("ActionCommitted: missing adventurer_id key");
+    const length = Number(felt(data[0]));
+    // Validate before reading. A truncated payload would otherwise decode into a bundle of zeros,
+    // which fold happily and produce a commitment that can never reconcile with the chain.
+    if (data.length - 1 < length) {
+        throw new Error(`ActionCommitted: declared ${length} actions but only ${data.length - 1} felts follow`);
+    }
+    const encodedActions = [];
+    for (let i = 0; i < length; i++)
+        encodedActions.push(felt(data[1 + i]));
+    return { adventurerId: felt(keys[1]), encodedActions, ...position };
+}
+/** Decode one `GameSettled { #[key] adventurer_id, #[key] settler, ...8 felts }`. */
+export function decodeGameSettled(keys, data) {
+    if (keys.length < 3)
+        throw new Error("GameSettled: missing keys");
+    return {
+        adventurerId: felt(keys[1]),
+        settler: felt(keys[2]),
+        protocolVersion: Number(felt(data[0])),
+        finalCommitment: felt(data[1]),
+        committedActionCount: Number(felt(data[2])),
+        terminalActionIndex: Number(felt(data[3])),
+        terminalReason: Number(felt(data[4])),
+        packedAdventurer: felt(data[5]),
+        packedBag: felt(data[6]),
+        settledAtBlock: felt(data[7]),
+    };
+}
+/**
+ * Chain order for commit events.
+ *
+ * `(block_number, transaction_index, event_index)`. Block number alone is NOT enough: two
+ * commits for one adventurer can land in the same block, and folding them the wrong way round
+ * yields a different commitment and different entropy for every action after.
+ */
+export function compareCommitOrder(a, b) {
+    if (a.blockNumber !== b.blockNumber)
+        return a.blockNumber < b.blockNumber ? -1 : 1;
+    if (a.transactionIndex !== b.transactionIndex)
+        return a.transactionIndex - b.transactionIndex;
+    return a.eventIndex - b.eventIndex;
+}
+/**
+ * Re-fold a game's commit events into the transcript settlement expects.
+ *
+ * The output `actions`/`blocks` pair is exactly what `settle_game(id, actions, blocks)` takes,
+ * and `finalCommitment` is what it will check against the stored felt -- so a caller can verify
+ * its own reconstruction before spending gas on a settlement that would revert.
+ */
+export function reconstructTranscript(adventurerId, events) {
+    const ordered = [...events].sort(compareCommitOrder);
+    let rolling = root(adventurerId);
+    const actions = [];
+    const blocks = [];
+    const rollings = [];
+    let surrenderIndex = null;
+    for (const event of ordered) {
+        for (const encoded of event.encodedActions) {
+            rolling = fold(rolling, encoded, event.blockNumber);
+            actions.push(encoded);
+            blocks.push(event.blockNumber);
+            rollings.push(rolling);
+            if (surrenderIndex === null && actionOpcode(encoded) === Opcode.SURRENDER) {
+                surrenderIndex = actions.length - 1;
+            }
+        }
+    }
+    return { adventurerId, actions, blocks, rollings, finalCommitment: rolling, surrenderIndex };
+}
+//# sourceMappingURL=transcript.js.map

package/dist/transcript.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,141 @@
+export interface Item {
+    id: number;
+    xp: number;
+}
+export interface Equipment {
+    weapon: Item;
+    chest: Item;
+    head: Item;
+    waist: Item;
+    foot: Item;
+    hand: Item;
+    neck: Item;
+    ring: Item;
+}
+export interface Adventurer {
+    health: number;
+    xp: number;
+    gold: number;
+    beast_health: number;
+    stat_upgrades_available: number;
+    stats: Stats;
+    equipment: Equipment;
+    item_specials_salt: number;
+    beast_salt: number;
+    level_salt: number;
+}
+export interface Bag {
+    item_1: Item;
+    item_2: Item;
+    item_3: Item;
+    item_4: Item;
+    item_5: Item;
+    item_6: Item;
+    item_7: Item;
+    item_8: Item;
+    item_9: Item;
+    item_10: Item;
+    item_11: Item;
+    item_12: Item;
+    item_13: Item;
+    item_14: Item;
+    item_15: Item;
+}
+export interface Beast {
+    id: number;
+    baseName: string;
+    name: string;
+    health: number;
+    level: number;
+    type: string;
+    tier: number;
+    specialPrefix: string | null;
+    specialSuffix: string | null;
+    isCollectable: boolean;
+    traitSeed: bigint;
+}
+export interface Stats {
+    strength: number;
+    dexterity: number;
+    vitality: number;
+    intelligence: number;
+    wisdom: number;
+    charisma: number;
+    luck: number;
+}
+export interface CombatStats {
+    baseDamage: number;
+    protection: number;
+    bestDamage: number;
+    bestProtection: number;
+    bestItems: Item[];
+    critChance: number;
+    criticalDamage: number;
+    gearScore: number;
+    maxBeastBaseDamage: number;
+    maxBeastCriticalDamage: number;
+}
+export interface ItemPurchase {
+    item_id: number;
+    equip: boolean;
+}
+export interface Obstacle {
+    id: number;
+    dodged: boolean;
+    damage: number;
+    location: string;
+    critical_hit: boolean;
+}
+export interface Attack {
+    damage: number;
+    location: string;
+    critical_hit: boolean;
+}
+export interface GameAction {
+    type: string;
+    statUpgrades?: Stats;
+    items?: number[];
+    itemPurchases?: ItemPurchase[];
+    potions?: number;
+    remainingGold?: number;
+    tillDamage?: number;
+    tillGold?: boolean;
+    tillHealth?: number;
+    tillBeastHealth?: number;
+    gameId?: string;
+    settings?: any;
+    weapon?: number;
+}
+export interface Payment {
+    paymentType: "Ticket" | "Golden Pass" | "DirectFee";
+    goldenPass?: {
+        address: string;
+        tokenId: number;
+    };
+    directFee?: {
+        tokenAddress: string;
+        amount: string;
+    };
+}
+export interface Collectable {
+    beast: Beast;
+    showPopup: boolean;
+    tokenURI: string | null;
+}
+export interface Quest {
+    id: number;
+    chapterId: number;
+    targetScore: number;
+}
+export interface GameSettingsData {
+    vrf_address: string;
+    name: string;
+    in_battle: boolean;
+    game_seed: number;
+    game_seed_until_xp: number;
+    base_damage_reduction: number;
+    market_size: number;
+    adventurer: Adventurer;
+    bag: Item[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/view.d.ts

@@ -0,0 +1,4 @@
+import type { Adventurer, Item } from "./types.js";
+/** Apply the same temporary equipment/bag boosts used by the live load path. */
+export declare function toPlayableAdventurer(adventurer: Adventurer, bag: Item[]): Adventurer;
+//# sourceMappingURL=view.d.ts.map

package/dist/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGnD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,UAAU,CAcpF"}

package/dist/view.js

@@ -0,0 +1,18 @@
+import { ItemUtils } from "./rules/loot.js";
+/** Apply the same temporary equipment/bag boosts used by the live load path. */
+export function toPlayableAdventurer(adventurer, bag) {
+    const boosts = ItemUtils.getEquippedItemStats(adventurer, bag);
+    return {
+        ...adventurer,
+        stats: {
+            strength: adventurer.stats.strength + boosts.strength,
+            dexterity: adventurer.stats.dexterity + boosts.dexterity,
+            vitality: adventurer.stats.vitality + boosts.vitality,
+            intelligence: adventurer.stats.intelligence + boosts.intelligence,
+            wisdom: adventurer.stats.wisdom + boosts.wisdom,
+            charisma: adventurer.stats.charisma + boosts.charisma,
+            luck: adventurer.stats.luck + boosts.luck,
+        },
+    };
+}
+//# sourceMappingURL=view.js.map

package/dist/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,UAAsB,EAAE,GAAW;IACtE,MAAM,MAAM,GAAG,SAAS,CAAC,oBAAoB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC/D,OAAO;QACL,GAAG,UAAU;QACb,KAAK,EAAE;YACL,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ;YACrD,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS;YACxD,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ;YACrD,YAAY,EAAE,UAAU,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY;YACjE,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;YAC/C,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ;YACrD,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI;SAC1C;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@provable-games/dm-engine",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Death Mountain game rules and commit-reveal protocol, ported from the Cairo contracts. Shared by the client, the indexer and the API.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Provable-Games/super-death-mountain.git",
+    "directory": "packages/engine"
+  },
+  "homepage": "https://github.com/Provable-Games/super-death-mountain/tree/main/packages/engine",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prepare": "pnpm run build",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@scure/starknet": "^1.1.0",
+    "starknet": "^7.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.1"
+  }
+}