@slvr-labs/sdk 0.1.0

package/dist/price.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlvrPrice = void 0;
+const viem_1 = require("viem");
+/**
+ * Reads the SLVR price from the SLVR/ETH UniswapV2 pair.
+ *
+ * Mirrors the web app's price logic: it reads the pair's `getReserves()` and
+ * `token0()`, figures out which reserve is SLVR (never assumes ordering), and
+ * prices SLVR as `ethReserve / slvrReserve`. Both tokens are 18-decimal, so the
+ * raw reserve ratio is already ETH-per-SLVR.
+ *
+ * This is a **spot** price straight from reserves — no TWAP, no slippage model.
+ * Fine for sizing bets and EV estimates; do not use it as an oracle for anything
+ * that must resist manipulation.
+ *
+ * @example
+ * ```typescript
+ * import { SlvrPrice } from '@slvr-labs/sdk';
+ * const price = new SlvrPrice(publicClient, pairAddress, slvrTokenAddress);
+ * const ethPerSlvr = await price.getPriceInEth();
+ * ```
+ */
+class SlvrPrice {
+    constructor(publicClient, pairAddress, slvrTokenAddress) {
+        this.publicClient = publicClient;
+        this.pairAddress = pairAddress;
+        this.slvrTokenAddress = slvrTokenAddress;
+    }
+    /** Read the pair reserves and resolve which side is SLVR. */
+    async getReserves() {
+        const [reserves, token0] = await Promise.all([
+            this.publicClient.readContract({
+                address: this.pairAddress,
+                abi: SlvrPrice.PAIR_ABI,
+                functionName: 'getReserves',
+            }),
+            this.publicClient.readContract({
+                address: this.pairAddress,
+                abi: SlvrPrice.PAIR_ABI,
+                functionName: 'token0',
+            }),
+        ]);
+        const token0IsSlvr = token0.toLowerCase() === this.slvrTokenAddress.toLowerCase();
+        const slvrReserve = token0IsSlvr ? reserves[0] : reserves[1];
+        const ethReserve = token0IsSlvr ? reserves[1] : reserves[0];
+        return { slvrReserve, ethReserve, token0IsSlvr };
+    }
+    /**
+     * SLVR price in ETH (ETH per SLVR), as a floating-point number.
+     * @throws {Error} if the pair has no SLVR liquidity (zero reserve).
+     */
+    async getPriceInEth() {
+        const { slvrReserve, ethReserve } = await this.getReserves();
+        if (slvrReserve === 0n) {
+            throw new Error('SLVR/ETH pair has zero SLVR reserve; cannot price');
+        }
+        return Number(ethReserve) / Number(slvrReserve);
+    }
+    /**
+     * SLVR price in ETH as a WAD (1e18-scaled `bigint`), for callers that want to
+     * stay in integer math: `priceWad = ethReserve * 1e18 / slvrReserve`.
+     * @throws {Error} if the pair has no SLVR liquidity (zero reserve).
+     */
+    async getPriceInEthWad() {
+        const { slvrReserve, ethReserve } = await this.getReserves();
+        if (slvrReserve === 0n) {
+            throw new Error('SLVR/ETH pair has zero SLVR reserve; cannot price');
+        }
+        return (ethReserve * 10n ** 18n) / slvrReserve;
+    }
+}
+exports.SlvrPrice = SlvrPrice;
+SlvrPrice.PAIR_ABI = (0, viem_1.parseAbi)([
+    'function getReserves() view returns (uint112 reserve0, uint112 reserve1, uint32 blockTimestampLast)',
+    'function token0() view returns (address)',
+]);
+//# sourceMappingURL=price.js.map

package/dist/price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../src/price.ts"],"names":[],"mappings":";;;AAAA,+BAAuD;AAcvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,SAAS;IAUpB,YAAY,YAA0B,EAAE,WAAoB,EAAE,gBAAyB;QACrF,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,WAAW;QACf,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;gBAC7B,OAAO,EAAE,IAAI,CAAC,WAAW;gBACzB,GAAG,EAAE,SAAS,CAAC,QAAQ;gBACvB,YAAY,EAAE,aAAa;aAC5B,CAA+C;YAChD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;gBAC7B,OAAO,EAAE,IAAI,CAAC,WAAW;gBACzB,GAAG,EAAE,SAAS,CAAC,QAAQ;gBACvB,YAAY,EAAE,QAAQ;aACvB,CAAqB;SACvB,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC;QAClF,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7D,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB;QACpB,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7D,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,CAAC,UAAU,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,WAAW,CAAC;IACjD,CAAC;;AA5DH,8BA6DC;AAxDyB,kBAAQ,GAAG,IAAA,eAAQ,EAAC;IAC1C,qGAAqG;IACrG,0CAA0C;CAC3C,CAAC,CAAC"}

package/dist/transaction.d.ts

@@ -0,0 +1,54 @@
+import { PublicClient, WalletClient, Address } from 'viem';
+/**
+ * Options for transaction execution
+ */
+export interface TransactionOptions {
+    /** Maximum gas to use */
+    gas?: bigint;
+    /** Gas price (legacy) */
+    gasPrice?: bigint;
+    /** Max fee per gas (EIP-1559) */
+    maxFeePerGas?: bigint;
+    /** Max priority fee per gas (EIP-1559) */
+    maxPriorityFeePerGas?: bigint;
+    /** Whether to wait for transaction receipt */
+    waitForReceipt?: boolean;
+    /** Timeout for waiting for receipt (milliseconds) */
+    receiptTimeout?: number;
+}
+/**
+ * Estimate gas for a contract write operation
+ * @param publicClient Public client
+ * @param address Contract address
+ * @param abi Contract ABI
+ * @param functionName Function name
+ * @param args Function arguments
+ * @param value Optional value to send
+ * @param account Optional account address
+ * @returns Estimated gas
+ */
+export declare function estimateGas(publicClient: PublicClient, address: Address, abi: readonly unknown[], functionName: string, args: unknown[], value?: bigint, account?: Address): Promise<bigint>;
+/**
+ * Wait for transaction receipt with error handling
+ * @param publicClient Public client
+ * @param hash Transaction hash
+ * @param timeout Timeout in milliseconds
+ * @returns Transaction receipt
+ * @throws TransactionError if transaction fails or times out
+ */
+export declare function waitForReceipt(publicClient: PublicClient, hash: `0x${string}`, timeout?: number): Promise<unknown>;
+/**
+ * Execute a contract write with options
+ * @param walletClient Wallet client
+ * @param publicClient Public client
+ * @param address Contract address
+ * @param abi Contract ABI
+ * @param functionName Function name
+ * @param args Function arguments
+ * @param options Transaction options
+ * @returns Transaction hash or receipt
+ */
+export declare function executeTransaction(walletClient: WalletClient, publicClient: PublicClient, address: Address, abi: readonly unknown[], functionName: string, args: unknown[], options?: TransactionOptions & {
+    value?: bigint;
+}): Promise<`0x${string}` | unknown>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG3D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,SAAS,OAAO,EAAE,EACvB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,EAAE,EACf,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,KAAK,MAAM,EAAE,EACnB,OAAO,GAAE,MAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,SAAS,OAAO,EAAE,EACvB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,GAAE,kBAAkB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,CAwClC"}

package/dist/transaction.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateGas = estimateGas;
+exports.waitForReceipt = waitForReceipt;
+exports.executeTransaction = executeTransaction;
+const errors_1 = require("./errors");
+/**
+ * Estimate gas for a contract write operation
+ * @param publicClient Public client
+ * @param address Contract address
+ * @param abi Contract ABI
+ * @param functionName Function name
+ * @param args Function arguments
+ * @param value Optional value to send
+ * @param account Optional account address
+ * @returns Estimated gas
+ */
+async function estimateGas(publicClient, address, abi, functionName, args, value, account) {
+    try {
+        const estimateParams = {
+            address,
+            abi,
+            functionName,
+            args,
+        };
+        if (value !== undefined) {
+            estimateParams.value = value;
+        }
+        if (account !== undefined) {
+            estimateParams.account = account;
+        }
+        const gas = await publicClient.estimateContractGas(estimateParams);
+        return gas;
+    }
+    catch (error) {
+        throw new errors_1.TransactionError(`Failed to estimate gas for ${functionName}: ${error instanceof Error ? error.message : String(error)}`, undefined, error);
+    }
+}
+/**
+ * Wait for transaction receipt with error handling
+ * @param publicClient Public client
+ * @param hash Transaction hash
+ * @param timeout Timeout in milliseconds
+ * @returns Transaction receipt
+ * @throws TransactionError if transaction fails or times out
+ */
+async function waitForReceipt(publicClient, hash, timeout = 120000) {
+    try {
+        const receipt = await publicClient.waitForTransactionReceipt({
+            hash,
+            timeout,
+        });
+        // Check if transaction failed
+        if (receipt && typeof receipt === 'object' && 'status' in receipt) {
+            if (receipt.status === 'reverted') {
+                throw new errors_1.TransactionError(`Transaction reverted: ${hash}`, hash);
+            }
+        }
+        return receipt;
+    }
+    catch (error) {
+        if (error instanceof errors_1.TransactionError) {
+            throw error;
+        }
+        throw new errors_1.TransactionError(`Failed to wait for transaction receipt: ${error instanceof Error ? error.message : String(error)}`, hash, error);
+    }
+}
+/**
+ * Execute a contract write with options
+ * @param walletClient Wallet client
+ * @param publicClient Public client
+ * @param address Contract address
+ * @param abi Contract ABI
+ * @param functionName Function name
+ * @param args Function arguments
+ * @param options Transaction options
+ * @returns Transaction hash or receipt
+ */
+async function executeTransaction(walletClient, publicClient, address, abi, functionName, args, options = {}) {
+    const { gas, gasPrice, maxFeePerGas, maxPriorityFeePerGas, waitForReceipt: waitForReceipt_, receiptTimeout, value, } = options;
+    const writeParams = {
+        address,
+        abi,
+        functionName,
+        args,
+        account: walletClient.account,
+        chain: null,
+        ...(value !== undefined && { value }),
+        ...(gas !== undefined && { gas }),
+        ...(gasPrice !== undefined && { gasPrice }),
+        ...(maxFeePerGas !== undefined && { maxFeePerGas }),
+        ...(maxPriorityFeePerGas !== undefined && { maxPriorityFeePerGas }),
+    };
+    try {
+        const hash = await walletClient.writeContract(writeParams);
+        if (waitForReceipt_) {
+            return await waitForReceipt(publicClient, hash, receiptTimeout);
+        }
+        return hash;
+    }
+    catch (error) {
+        throw new errors_1.TransactionError(`Failed to execute transaction: ${error instanceof Error ? error.message : String(error)}`, undefined, error);
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":";;AAgCA,kCA+BC;AAUD,wCAgCC;AAaD,gDAgDC;AArKD,qCAA4C;AAoB5C;;;;;;;;;;GAUG;AACI,KAAK,UAAU,WAAW,CAC/B,YAA0B,EAC1B,OAAgB,EAChB,GAAuB,EACvB,YAAoB,EACpB,IAAe,EACf,KAAc,EACd,OAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,cAAc,GAAQ;YAC1B,OAAO;YACP,GAAG;YACH,YAAY;YACZ,IAAI;SACL,CAAC;QACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,cAAc,CAAC,KAAK,GAAG,KAAK,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,cAAc,CAAC,OAAO,GAAG,OAAO,CAAC;QACnC,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,yBAAgB,CACxB,8BAA8B,YAAY,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACvG,SAAS,EACT,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,cAAc,CAClC,YAA0B,EAC1B,IAAmB,EACnB,UAAkB,MAAM;IAExB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC;YAC3D,IAAI;YACJ,OAAO;SACR,CAAC,CAAC;QAEH,8BAA8B;QAC9B,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;YAClE,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,IAAI,yBAAgB,CACxB,yBAAyB,IAAI,EAAE,EAC/B,IAAI,CACL,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,yBAAgB,EAAE,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,yBAAgB,CACxB,2CAA2C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACnG,IAAI,EACJ,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,kBAAkB,CACtC,YAA0B,EAC1B,YAA0B,EAC1B,OAAgB,EAChB,GAAuB,EACvB,YAAoB,EACpB,IAAe,EACf,UAAmD,EAAE;IAErD,MAAM,EACJ,GAAG,EACH,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,cAAc,EAAE,eAAe,EAC/B,cAAc,EACd,KAAK,GACN,GAAG,OAAO,CAAC;IAEZ,MAAM,WAAW,GAAG;QAClB,OAAO;QACP,GAAG;QACH,YAAY;QACZ,IAAI;QACJ,OAAO,EAAE,YAAY,CAAC,OAAQ;QAC9B,KAAK,EAAE,IAAI;QACX,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;QACrC,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC;QACjC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3C,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;QACnD,GAAG,CAAC,oBAAoB,KAAK,SAAS,IAAI,EAAE,oBAAoB,EAAE,CAAC;KAChB,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAE3D,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,MAAM,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,yBAAgB,CACxB,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC1F,SAAS,EACT,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,162 @@
+import { Address, PublicClient, WalletClient } from 'viem';
+/**
+ * Configuration for the Slvr SDK
+ */
+export interface SlvrConfig {
+    /** Public client for read operations */
+    publicClient: PublicClient;
+    /** Wallet client for write operations (optional, required for transactions) */
+    walletClient?: WalletClient;
+    /** Contract addresses */
+    addresses: {
+        lottery: Address;
+        staking: Address;
+        token: Address;
+        autoCommit?: Address;
+        /** SlvrHub address (optional, for emission/staker/jackpot stats and keeper/admin ops) */
+        hub?: Address;
+        /** SlvrGameRegistry address (optional, for game weight/status stats) */
+        registry?: Address;
+        /** SlvrJackpot address (optional, for jackpot pool reads) */
+        jackpot?: Address;
+        /** SLVR/ETH UniswapV2 pair address (optional, enables `sdk.price` SLVR price reads) */
+        slvrEthPair?: Address;
+        /**
+         * Chainlink-style ETH/USD price feed address (optional, enables `sdk.ethUsd`
+         * and USD-denominated prices). Only set on chains that actually have a feed.
+         */
+        chainlinkEthUsd?: Address;
+    };
+}
+/**
+ * A SLVR price quote in both ETH and USD.
+ */
+export interface PriceQuote {
+    /** Price in ETH (ETH per SLVR). */
+    eth: number;
+    /** Price in USD, or `null` if no ETH/USD source was available. */
+    usd: number | null;
+}
+/**
+ * Round information
+ */
+export interface RoundInfo {
+    roundId: bigint;
+    requestedAt: bigint;
+    resolved: boolean;
+    randomnessId: `0x${string}`;
+    randomnessValue: bigint;
+    winningSquare: number;
+    jackpotHit: boolean;
+    singleMinerRound: boolean;
+    singleMinerWinner: Address;
+    totalWager: bigint;
+    fee: bigint;
+    winnerTotal: bigint;
+    potForWinners: bigint;
+    slvrForWinners: bigint;
+    payoutMulWad: bigint;
+    slvrMulWad: bigint;
+    totalUnclaimedSlvr: bigint;
+}
+/**
+ * Miner state information
+ */
+export interface MinerState {
+    rewardsSlvr: bigint;
+    refinedAccrued: bigint;
+    indexSnapshot: bigint;
+    hasAccount: boolean;
+}
+/**
+ * Treasury state information
+ */
+export interface TreasuryState {
+    minerIndex: bigint;
+    totalUnclaimed: bigint;
+    totalRefined: bigint;
+    jackpotPool: bigint;
+}
+/**
+ * Staking information for a staked veNFT tokenId
+ */
+export interface StakingInfo {
+    /** Total tracked weight across all staked tokens */
+    totalWeight: bigint;
+    /** Tracked weight (balance) of this tokenId */
+    balance: bigint;
+    /** Claimable rewards for this tokenId */
+    rewards: bigint;
+    /** Accumulated reward per unit of weight (1e18 precision) */
+    rewardPerWeightStored: bigint;
+}
+/**
+ * AutoCommit plan information
+ */
+export interface AutoCommitPlan {
+    enabled: boolean;
+    nextRoundId: bigint;
+    playsRemaining: number;
+    amountPerPlay: bigint;
+    balance: bigint;
+    autoClaim: boolean;
+    squares: number[];
+    bpsAlloc: number[];
+    planStartRoundId: bigint;
+}
+/**
+ * Game status in the registry (mirrors ISlvrGameRegistry.Status)
+ */
+export declare enum GameStatus {
+    Pending = 0,
+    Active = 1,
+    Paused = 2,
+    Retired = 3
+}
+/**
+ * Game tier in the registry (mirrors ISlvrGameRegistry.Tier)
+ */
+export declare enum GameTier {
+    Core = 0,
+    Community = 1,
+    Experimental = 2
+}
+/**
+ * Full registry record for a game (mirrors ISlvrGameRegistry.GameInfo)
+ */
+export interface GameInfo {
+    game: Address;
+    gameType: `0x${string}`;
+    status: GameStatus;
+    tier: GameTier;
+    emissionWeight: number;
+    maxWeightBps: number;
+    exists: boolean;
+}
+/**
+ * Bet parameters
+ */
+export interface BetParams {
+    roundId: bigint;
+    squares: number[];
+    amounts: bigint[];
+    beneficiary?: Address;
+}
+/**
+ * Claim parameters
+ */
+export interface ClaimParams {
+    roundId: bigint;
+}
+/**
+ * Advanced claim parameters (unified claim function)
+ */
+export interface ClaimParamsAdvanced {
+    user: Address;
+    roundId: bigint;
+    recipientNative?: Address;
+    recipientSlvr?: Address;
+    bypassFee?: boolean;
+    ethOnly?: boolean;
+}
+//# 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,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameTier = exports.GameStatus = void 0;
+/**
+ * Game status in the registry (mirrors ISlvrGameRegistry.Status)
+ */
+var GameStatus;
+(function (GameStatus) {
+    GameStatus[GameStatus["Pending"] = 0] = "Pending";
+    GameStatus[GameStatus["Active"] = 1] = "Active";
+    GameStatus[GameStatus["Paused"] = 2] = "Paused";
+    GameStatus[GameStatus["Retired"] = 3] = "Retired";
+})(GameStatus || (exports.GameStatus = GameStatus = {}));
+/**
+ * Game tier in the registry (mirrors ISlvrGameRegistry.Tier)
+ */
+var GameTier;
+(function (GameTier) {
+    GameTier[GameTier["Core"] = 0] = "Core";
+    GameTier[GameTier["Community"] = 1] = "Community";
+    GameTier[GameTier["Experimental"] = 2] = "Experimental";
+})(GameTier || (exports.GameTier = GameTier = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAkHA;;GAEG;AACH,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,iDAAW,CAAA;IACX,+CAAU,CAAA;IACV,+CAAU,CAAA;IACV,iDAAW,CAAA;AACb,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB;AAED;;GAEG;AACH,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,uCAAQ,CAAA;IACR,iDAAa,CAAA;IACb,uDAAgB,CAAA;AAClB,CAAC,EAJW,QAAQ,wBAAR,QAAQ,QAInB"}

package/dist/utils.d.ts

@@ -0,0 +1,58 @@
+import { Address } from 'viem';
+/**
+ * Validate and normalize an Ethereum address
+ * @param address Address to validate
+ * @param fieldName Field name for error message
+ * @returns Checksummed address
+ * @throws ValidationError if address is invalid
+ */
+export declare function validateAddress(address: string, fieldName?: string): Address;
+/**
+ * Validate that an amount is positive
+ * @param amount Amount to validate
+ * @param fieldName Field name for error message
+ * @throws ValidationError if amount is invalid
+ */
+export declare function validateAmount(amount: bigint, fieldName?: string): void;
+/**
+ * Validate square indices are within valid range
+ * @param squares Array of square indices
+ * @param gridSize Grid size (default 25)
+ * @throws ValidationError if squares are invalid
+ */
+export declare function validateSquares(squares: number[], gridSize?: number): void;
+/**
+ * Validate that arrays have matching lengths
+ * @param arrays Arrays to validate
+ * @param fieldNames Field names for error message
+ * @throws ValidationError if arrays don't match
+ */
+export declare function validateArrayLengths(arrays: unknown[][], fieldNames: string[]): void;
+/**
+ * Validate basis points (0-10000)
+ * @param bps Basis points value
+ * @param fieldName Field name for error message
+ * @throws ValidationError if bps is invalid
+ */
+export declare function validateBps(bps: number, fieldName?: string): void;
+/**
+ * Validate that basis points array sums to 10000
+ * @param bpsArray Array of basis points
+ * @param fieldName Field name for error message
+ * @throws ValidationError if bps don't sum to 10000
+ */
+export declare function validateBpsSum(bpsArray: number[], fieldName?: string): void;
+/**
+ * Wait for transaction receipt with timeout
+ * @param publicClient Public client
+ * @param hash Transaction hash
+ * @param timeout Timeout in milliseconds (default 120000 = 2 minutes)
+ * @returns Transaction receipt
+ */
+export declare function waitForTransactionReceipt(publicClient: {
+    waitForTransactionReceipt?: (args: {
+        hash: `0x${string}`;
+        timeout?: number;
+    }) => Promise<unknown>;
+}, hash: `0x${string}`, timeout?: number): Promise<unknown>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAyB,MAAM,MAAM,CAAC;AAGtD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,OAAO,CAKvF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAiB,GAAG,IAAI,CAOjF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,MAAW,GAAG,IAAI,CAa9E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAgBpF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,IAAI,CAOxE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAmB,GAAG,IAAI,CAQvF;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE;IAAE,yBAAyB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EACnH,IAAI,EAAE,KAAK,MAAM,EAAE,EACnB,OAAO,GAAE,MAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CAKlB"}

package/dist/utils.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAddress = validateAddress;
+exports.validateAmount = validateAmount;
+exports.validateSquares = validateSquares;
+exports.validateArrayLengths = validateArrayLengths;
+exports.validateBps = validateBps;
+exports.validateBpsSum = validateBpsSum;
+exports.waitForTransactionReceipt = waitForTransactionReceipt;
+const viem_1 = require("viem");
+const errors_1 = require("./errors");
+/**
+ * Validate and normalize an Ethereum address
+ * @param address Address to validate
+ * @param fieldName Field name for error message
+ * @returns Checksummed address
+ * @throws ValidationError if address is invalid
+ */
+function validateAddress(address, fieldName = 'address') {
+    if (!(0, viem_1.isAddress)(address)) {
+        throw new errors_1.ValidationError(`Invalid ${fieldName}: ${address}`, fieldName);
+    }
+    return (0, viem_1.getAddress)(address);
+}
+/**
+ * Validate that an amount is positive
+ * @param amount Amount to validate
+ * @param fieldName Field name for error message
+ * @throws ValidationError if amount is invalid
+ */
+function validateAmount(amount, fieldName = 'amount') {
+    if (amount < 0n) {
+        throw new errors_1.ValidationError(`${fieldName} must be non-negative`, fieldName);
+    }
+    if (amount === 0n) {
+        throw new errors_1.ValidationError(`${fieldName} must be greater than zero`, fieldName);
+    }
+}
+/**
+ * Validate square indices are within valid range
+ * @param squares Array of square indices
+ * @param gridSize Grid size (default 25)
+ * @throws ValidationError if squares are invalid
+ */
+function validateSquares(squares, gridSize = 25) {
+    if (squares.length === 0) {
+        throw new errors_1.ValidationError('At least one square must be provided', 'squares');
+    }
+    for (const square of squares) {
+        if (!Number.isInteger(square) || square < 0 || square >= gridSize) {
+            throw new errors_1.ValidationError(`Invalid square index: ${square}. Must be between 0 and ${gridSize - 1}`, 'squares');
+        }
+    }
+}
+/**
+ * Validate that arrays have matching lengths
+ * @param arrays Arrays to validate
+ * @param fieldNames Field names for error message
+ * @throws ValidationError if arrays don't match
+ */
+function validateArrayLengths(arrays, fieldNames) {
+    if (arrays.length < 2) {
+        return;
+    }
+    const firstLength = arrays[0]?.length ?? 0;
+    for (let i = 1; i < arrays.length; i++) {
+        const currentArray = arrays[i];
+        const currentFieldName = fieldNames[i];
+        if (!currentArray || currentArray.length !== firstLength) {
+            throw new errors_1.ValidationError(`Array length mismatch: ${fieldNames[0]} has ${firstLength} items, but ${currentFieldName ?? `array ${i}`} has ${currentArray?.length ?? 0} items`, currentFieldName);
+        }
+    }
+}
+/**
+ * Validate basis points (0-10000)
+ * @param bps Basis points value
+ * @param fieldName Field name for error message
+ * @throws ValidationError if bps is invalid
+ */
+function validateBps(bps, fieldName = 'bps') {
+    if (!Number.isInteger(bps) || bps < 0 || bps > 10000) {
+        throw new errors_1.ValidationError(`${fieldName} must be an integer between 0 and 10000 (got ${bps})`, fieldName);
+    }
+}
+/**
+ * Validate that basis points array sums to 10000
+ * @param bpsArray Array of basis points
+ * @param fieldName Field name for error message
+ * @throws ValidationError if bps don't sum to 10000
+ */
+function validateBpsSum(bpsArray, fieldName = 'bpsAlloc') {
+    const sum = bpsArray.reduce((acc, bps) => acc + bps, 0);
+    if (sum !== 10000) {
+        throw new errors_1.ValidationError(`${fieldName} must sum to 10000 (got ${sum})`, fieldName);
+    }
+}
+/**
+ * Wait for transaction receipt with timeout
+ * @param publicClient Public client
+ * @param hash Transaction hash
+ * @param timeout Timeout in milliseconds (default 120000 = 2 minutes)
+ * @returns Transaction receipt
+ */
+async function waitForTransactionReceipt(publicClient, hash, timeout = 120000) {
+    if (!publicClient.waitForTransactionReceipt) {
+        throw new Error('Public client does not support waitForTransactionReceipt');
+    }
+    return await publicClient.waitForTransactionReceipt({ hash, timeout });
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/examples/.env.example

@@ -0,0 +1,22 @@
+# Copy this file to `.env` and fill in your values.
+#
+#   cp .env.example .env
+#
+# The examples read these from the environment. The simplest way to run with them
+# set is inline (no .env needed at all):
+#
+#   PRIVATE_KEY=0x... npx ts-node examples/quickstart-bet.ts
+#
+# If you prefer a .env file, load it into your shell before running, e.g.:
+#
+#   set -a; source .env; set +a
+#   npx ts-node examples/quickstart-bet.ts
+
+# Your wallet private key, hex with 0x prefix. REQUIRED for examples that bet.
+# Use a fresh / burner key funded with a small amount of ETH — never a key that
+# holds real value, and never commit the filled-in .env.
+PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+
+# Optional: ETH/USD price override for USD display. Leave unset to use the
+# on-chain Chainlink feed (wired for Robinhood Chain).
+# ETH_USD=1815.98