@slvr-labs/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,436 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlvrJackpot = exports.SlvrGameRegistry = exports.SlvrHub = exports.SlvrAutoCommit = exports.SlvrToken = exports.SlvrStaking = exports.SlvrGridLottery = exports.chainFromDeployment = exports.createSlvrClients = exports.ChainlinkPriceFeed = exports.SlvrPrice = exports.SlvrSDK = void 0;
+const viem_1 = require("viem");
+const lottery_1 = require("./contracts/lottery");
+const staking_1 = require("./contracts/staking");
+const token_1 = require("./contracts/token");
+const autoCommit_1 = require("./contracts/autoCommit");
+const hub_1 = require("./contracts/hub");
+const registry_1 = require("./contracts/registry");
+const jackpot_1 = require("./contracts/jackpot");
+const price_1 = require("./price");
+const oracle_1 = require("./oracle");
+const ev_1 = require("./ev");
+const connect_1 = require("./connect");
+const deployments_1 = require("./deployments");
+const errors_1 = require("./errors");
+/**
+ * Main Slvr SDK class
+ *
+ * @example
+ * ```typescript
+ * import { createPublicClient, createWalletClient, http } from 'viem';
+ * import { SlvrSDK } from '@slvr-labs/sdk';
+ *
+ * const publicClient = createPublicClient({
+ *   chain: robinhoodChain,
+ *   transport: http(),
+ * });
+ *
+ * const walletClient = createWalletClient({
+ *   chain: robinhoodChain,
+ *   transport: http(),
+ *   account: yourAccount,
+ * });
+ *
+ * const sdk = new SlvrSDK({
+ *   publicClient,
+ *   walletClient,
+ *   addresses: {
+ *     lottery: '0x...',
+ *     staking: '0x...',
+ *     token: '0x...',
+ *   },
+ * });
+ *
+ * // Get current round
+ * const roundId = await sdk.lottery.currentRoundId();
+ *
+ * // Place a bet
+ * await sdk.lottery.bet({
+ *   roundId,
+ *   squares: [0, 1, 2],
+ *   amounts: [1000000000000000000n, 2000000000000000000n, 3000000000000000000n],
+ * });
+ * ```
+ */
+class SlvrSDK {
+    constructor(config) {
+        this.config = config;
+        // Initialize core contracts
+        this.lottery = new lottery_1.SlvrGridLottery(config.publicClient, config.walletClient, config.addresses.lottery);
+        this.staking = new staking_1.SlvrStaking(config.publicClient, config.walletClient, config.addresses.staking);
+        this.token = new token_1.SlvrToken(config.publicClient, config.walletClient, config.addresses.token);
+        // Initialize optional contracts
+        if (config.addresses.autoCommit) {
+            this.autoCommit = new autoCommit_1.SlvrAutoCommit(config.publicClient, config.walletClient, config.addresses.autoCommit);
+        }
+        if (config.addresses.hub) {
+            this.hub = new hub_1.SlvrHub(config.publicClient, config.walletClient, config.addresses.hub);
+        }
+        if (config.addresses.registry) {
+            this.registry = new registry_1.SlvrGameRegistry(config.publicClient, config.walletClient, config.addresses.registry);
+        }
+        if (config.addresses.jackpot) {
+            this.jackpot = new jackpot_1.SlvrJackpot(config.publicClient, config.walletClient, config.addresses.jackpot);
+        }
+        // Price reader needs the pair address; SLVR side is resolved from the token address.
+        if (config.addresses.slvrEthPair) {
+            this.price = new price_1.SlvrPrice(config.publicClient, config.addresses.slvrEthPair, config.addresses.token);
+        }
+        // ETH/USD feed (optional; only on chains that have a Chainlink aggregator).
+        if (config.addresses.chainlinkEthUsd) {
+            this.ethUsd = new oracle_1.ChainlinkPriceFeed(config.publicClient, config.addresses.chainlinkEthUsd);
+        }
+    }
+    /**
+     * One-line setup: build clients (with Multicall3 batching + resilient transport
+     * defaults) and an SDK for a deployment. Pass a `privateKey`/`account` to enable
+     * writes; omit it for a read-only SDK.
+     *
+     * @example
+     * ```typescript
+     * import { SlvrSDK } from '@slvr-labs/sdk';
+     * const sdk = SlvrSDK.connect();                                   // read-only, Robinhood Chain
+     * const bot = SlvrSDK.connect({ privateKey: process.env.PK });     // wallet-backed
+     * ```
+     */
+    static connect(opts = {}) {
+        const deployment = opts.deployment ?? deployments_1.robinhood;
+        const { publicClient, walletClient } = (0, connect_1.createSlvrClients)(opts);
+        return new SlvrSDK({ publicClient, walletClient, addresses: deployment.addresses });
+    }
+    /**
+     * Get the public client
+     */
+    getPublicClient() {
+        return this.config.publicClient;
+    }
+    /**
+     * Get the wallet client (if available)
+     */
+    getWalletClient() {
+        return this.config.walletClient;
+    }
+    /**
+     * Update the wallet client and reinitialize contracts
+     * @param walletClient New wallet client (or undefined to remove)
+     */
+    setWalletClient(walletClient) {
+        this.config.walletClient = walletClient;
+        // Reinitialize contracts with new wallet client
+        this.lottery.setWalletClient(walletClient);
+        this.staking.setWalletClient(walletClient);
+        this.token.setWalletClient(walletClient);
+        if (this.autoCommit) {
+            this.autoCommit.setWalletClient(walletClient);
+        }
+        if (this.hub) {
+            this.hub.setWalletClient(walletClient);
+        }
+        if (this.registry) {
+            this.registry.setWalletClient(walletClient);
+        }
+        if (this.jackpot) {
+            this.jackpot.setWalletClient(walletClient);
+        }
+    }
+    /**
+     * Helper: Calculate bet amounts from percentages
+     * @param totalAmount Total amount to bet
+     * @param percentages Array of percentages (0-100) for each square
+     * @returns Array of amounts in wei
+     * @throws ValidationError if percentages don't sum to 100 or if totalAmount is invalid
+     */
+    static calculateBetAmounts(totalAmount, percentages) {
+        if (percentages.length === 0) {
+            throw new errors_1.ValidationError('Percentages array cannot be empty', 'percentages');
+        }
+        const totalPercent = percentages.reduce((sum, p) => sum + p, 0);
+        if (Math.abs(totalPercent - 100) > 0.01) {
+            throw new errors_1.ValidationError(`Percentages must sum to 100 (got ${totalPercent})`, 'percentages');
+        }
+        const amounts = [];
+        let allocated = 0n;
+        for (let i = 0; i < percentages.length; i++) {
+            const percentage = percentages[i];
+            if (percentage === undefined)
+                continue;
+            const amount = (totalAmount * BigInt(Math.round(percentage * 100))) / 10000n;
+            amounts.push(amount);
+            allocated += amount;
+        }
+        // Adjust first amount to account for rounding
+        if (allocated !== totalAmount && amounts.length > 0 && amounts[0] !== undefined) {
+            amounts[0] += totalAmount - allocated;
+        }
+        return amounts;
+    }
+    /**
+     * Helper: Format bigint to human-readable string.
+     *
+     * `precision` caps the number of decimal places shown; trailing zeros are
+     * stripped (like viem's `formatEther`), so `formatToken(1.5e18)` is `"1.5"`,
+     * not `"1.5000"`.
+     * @param value Value in wei
+     * @param decimals Number of decimals (default 18)
+     * @param precision Max decimal places to show (default 4)
+     */
+    static formatToken(value, decimals = 18, precision = 4) {
+        const divisor = BigInt(10 ** decimals);
+        const whole = value / divisor;
+        const remainder = value % divisor;
+        const fractional = (remainder * BigInt(10 ** precision)) / divisor;
+        if (fractional === 0n) {
+            return whole.toString();
+        }
+        const fractionalStr = fractional.toString().padStart(precision, '0').replace(/0+$/, '');
+        return fractionalStr ? `${whole}.${fractionalStr}` : whole.toString();
+    }
+    /**
+     * Helper: Parse human-readable string to bigint
+     * @param value Human-readable value (e.g., "1.5")
+     * @param decimals Number of decimals (default 18)
+     */
+    static parseToken(value, decimals = 18) {
+        const parts = value.split('.');
+        const whole = BigInt(parts[0] || '0');
+        const fractional = parts[1] ? BigInt(parts[1].padEnd(decimals, '0').slice(0, decimals)) : 0n;
+        return whole * BigInt(10 ** decimals) + fractional;
+    }
+    /**
+     * Helper: Calculate time remaining until round ends
+     * @param roundId Round ID
+     * @returns Time remaining in seconds, or 0 if round has ended
+     */
+    async getTimeRemaining(roundId) {
+        const roundEnd = await this.lottery.roundEnd(roundId);
+        const now = BigInt(Math.floor(Date.now() / 1000));
+        const remaining = roundEnd - now;
+        return remaining > 0n ? Number(remaining) : 0;
+    }
+    /**
+     * Helper: Check if user can claim rewards for a round
+     * @param roundId Round ID
+     * @param user User address
+     * @returns True if user can claim
+     */
+    async canClaim(roundId, user) {
+        const [round, hasClaimed_] = await Promise.all([
+            this.lottery.getRound(roundId),
+            this.lottery.getHasClaimed(roundId, user),
+        ]);
+        if (!round.resolved || hasClaimed_) {
+            return false;
+        }
+        // Check if user has a bet on the winning square
+        const userBet = await this.lottery.getUserBet(roundId, round.winningSquare, user);
+        return userBet > 0n;
+    }
+    /**
+     * Helper: Get user's claimable rounds
+     * @param user User address
+     * @param startRoundId Start round ID to check from
+     * @param endRoundId End round ID to check to
+     * @returns Array of round IDs that can be claimed
+     */
+    async getClaimableRounds(user, startRoundId, endRoundId) {
+        const claimable = [];
+        for (let roundId = startRoundId; roundId <= endRoundId; roundId++) {
+            if (await this.canClaim(roundId, user)) {
+                claimable.push(roundId);
+            }
+        }
+        return claimable;
+    }
+    /**
+     * Helper: Compute a game's effective SLVR/sec emission rate.
+     *
+     * Mirrors SlvrHub._effectiveRatePerSec: the game's weighted share of the global emission stream,
+     * i.e. emissionRatePerSec * weightOf(gameId) / totalActiveWeight. NOTE: this does not apply the
+     * per-game maxWeightBps ceiling that the contract also enforces; it is the pre-cap weighted rate.
+     *
+     * Requires both `hub` and `registry` addresses to be configured.
+     * @param gameId Registry game id
+     * @returns Effective emission rate in SLVR/sec (0 if there is no active weight)
+     */
+    async effectiveEmissionRate(gameId) {
+        if (!this.hub) {
+            throw new errors_1.ValidationError('hub address is required for effectiveEmissionRate', 'hub');
+        }
+        if (!this.registry) {
+            throw new errors_1.ValidationError('registry address is required for effectiveEmissionRate', 'registry');
+        }
+        const [rate, weight, totalWeight] = await Promise.all([
+            this.hub.emissionRatePerSec(),
+            this.registry.weightOf(gameId),
+            this.registry.totalActiveWeight(),
+        ]);
+        if (totalWeight === 0n) {
+            return 0n;
+        }
+        return (rate * weight) / totalWeight;
+    }
+    /**
+     * Helper: Get the accrued-but-unminted SLVR emission currently available to a game.
+     *
+     * Thin pass-through to SlvrHub.pendingEmission. Requires `hub` to be configured.
+     * @param gameId Registry game id
+     */
+    async pendingEmission(gameId) {
+        if (!this.hub) {
+            throw new errors_1.ValidationError('hub address is required for pendingEmission', 'hub');
+        }
+        return await this.hub.pendingEmission(gameId);
+    }
+    /**
+     * Helper: current SLVR spot price in ETH (ETH per SLVR).
+     *
+     * Requires a `slvrEthPair` address to be configured (so `sdk.price` exists).
+     * @throws ValidationError if no pair address was configured.
+     */
+    async getSlvrPriceInEth() {
+        if (!this.price) {
+            throw new errors_1.ValidationError('slvrEthPair address is required for getSlvrPriceInEth', 'slvrEthPair');
+        }
+        return await this.price.getPriceInEth();
+    }
+    /**
+     * Helper: current ETH price in USD from the configured Chainlink feed.
+     *
+     * Requires a `chainlinkEthUsd` address (so `sdk.ethUsd` exists). This is wired
+     * for Robinhood Chain in `deployments.robinhood`; on chains without a feed,
+     * supply one or pass `ethUsd` to {@link getSlvrPrice}.
+     * @throws ValidationError if no ETH/USD feed was configured.
+     */
+    async getEthPriceUsd() {
+        if (!this.ethUsd) {
+            throw new errors_1.ValidationError('chainlinkEthUsd address is required for getEthPriceUsd', 'chainlinkEthUsd');
+        }
+        return await this.ethUsd.getPrice();
+    }
+    /**
+     * Helper: current SLVR price in **both ETH and USD**.
+     *
+     * SLVR/ETH comes from the UniswapV2 pair (`sdk.price`). The USD value uses, in
+     * order: an explicit `opts.ethUsd`, else the configured Chainlink ETH/USD feed
+     * (`sdk.ethUsd`), else `usd` is `null`.
+     *
+     * @param opts.ethUsd override the ETH/USD price (e.g. from your own off-chain source)
+     * @throws ValidationError if no `slvrEthPair` was configured.
+     *
+     * @example
+     * ```typescript
+     * const { eth, usd } = await sdk.getSlvrPrice();              // uses Chainlink feed if configured
+     * const q = await sdk.getSlvrPrice({ ethUsd: 1797.35 });      // or supply ETH/USD yourself
+     * ```
+     */
+    async getSlvrPrice(opts) {
+        if (!this.price) {
+            throw new errors_1.ValidationError('slvrEthPair address is required for getSlvrPrice', 'slvrEthPair');
+        }
+        const eth = await this.price.getPriceInEth();
+        let ethUsd = opts?.ethUsd;
+        if (ethUsd === undefined && this.ethUsd) {
+            ethUsd = await this.ethUsd.getPrice();
+        }
+        return { eth, usd: ethUsd !== undefined ? eth * ethUsd : null };
+    }
+    /**
+     * Helper: estimate the per-round expected value of grid mining for the given
+     * stake, pulling live pot, emission and SLVR price on-chain.
+     *
+     * This is the SDK-level convenience around {@link computeGridMiningEv}: it reads
+     * the round's pot (sum of all squares), the emission target (`slvrPerRound`), the
+     * protocol fee (`protocolFeeBps`), and the SLVR price (via `sdk.price`), then
+     * returns the full EV breakdown. Any of those can be overridden via `params`.
+     *
+     * The jackpot pool is **not** auto-read (it isn't exposed as a single call on the
+     * live lottery) — pass `jackpotPool` if you want the jackpot term included.
+     *
+     * @remarks `slvrPerRound` is the emission *target*; actual emission is hub-gated
+     * and may be lower, so treat the result as an upper-ish estimate. Requires a
+     * configured `slvrEthPair` unless you pass `slvrPriceEth`.
+     */
+    async estimateRoundEv(params) {
+        const roundId = params.roundId ?? (await this.lottery.currentRoundId());
+        const [potEth, emissionPerRound, slvrPriceEth, feeBps] = await Promise.all([
+            params.pot !== undefined
+                ? Promise.resolve(params.pot)
+                : this.lottery
+                    .getRoundSquares(roundId)
+                    .then((sqs) => Number((0, viem_1.formatEther)(sqs.reduce((sum, s) => sum + s.total, 0n)))),
+            params.emissionPerRound !== undefined
+                ? Promise.resolve(params.emissionPerRound)
+                : this.lottery.slvrPerRound().then((v) => Number((0, viem_1.formatEther)(v))),
+            params.slvrPriceEth !== undefined
+                ? Promise.resolve(params.slvrPriceEth)
+                : this.getSlvrPriceInEth(),
+            this.lottery.protocolFeeBps(),
+        ]);
+        return (0, ev_1.computeGridMiningEv)({
+            stake: params.stake,
+            pot: potEth,
+            emissionPerRound,
+            slvrPriceEth,
+            feeBps,
+            cashOut: params.cashOut,
+            jackpotPool: params.jackpotPool,
+            jackpotOdds: params.jackpotOdds,
+        });
+    }
+}
+exports.SlvrSDK = SlvrSDK;
+// Export all types
+__exportStar(require("./types"), exports);
+// Export known deployments + ready-made viem chain
+__exportStar(require("./deployments"), exports);
+// Export expected-value math + SLVR price reader
+__exportStar(require("./ev"), exports);
+var price_2 = require("./price");
+Object.defineProperty(exports, "SlvrPrice", { enumerable: true, get: function () { return price_2.SlvrPrice; } });
+var oracle_2 = require("./oracle");
+Object.defineProperty(exports, "ChainlinkPriceFeed", { enumerable: true, get: function () { return oracle_2.ChainlinkPriceFeed; } });
+// Export client factory
+var connect_2 = require("./connect");
+Object.defineProperty(exports, "createSlvrClients", { enumerable: true, get: function () { return connect_2.createSlvrClients; } });
+Object.defineProperty(exports, "chainFromDeployment", { enumerable: true, get: function () { return connect_2.chainFromDeployment; } });
+// Export contract classes
+var lottery_2 = require("./contracts/lottery");
+Object.defineProperty(exports, "SlvrGridLottery", { enumerable: true, get: function () { return lottery_2.SlvrGridLottery; } });
+var staking_2 = require("./contracts/staking");
+Object.defineProperty(exports, "SlvrStaking", { enumerable: true, get: function () { return staking_2.SlvrStaking; } });
+var token_2 = require("./contracts/token");
+Object.defineProperty(exports, "SlvrToken", { enumerable: true, get: function () { return token_2.SlvrToken; } });
+var autoCommit_2 = require("./contracts/autoCommit");
+Object.defineProperty(exports, "SlvrAutoCommit", { enumerable: true, get: function () { return autoCommit_2.SlvrAutoCommit; } });
+var hub_2 = require("./contracts/hub");
+Object.defineProperty(exports, "SlvrHub", { enumerable: true, get: function () { return hub_2.SlvrHub; } });
+var registry_2 = require("./contracts/registry");
+Object.defineProperty(exports, "SlvrGameRegistry", { enumerable: true, get: function () { return registry_2.SlvrGameRegistry; } });
+var jackpot_2 = require("./contracts/jackpot");
+Object.defineProperty(exports, "SlvrJackpot", { enumerable: true, get: function () { return jackpot_2.SlvrJackpot; } });
+// Export errors
+__exportStar(require("./errors"), exports);
+// Export utilities
+__exportStar(require("./utils"), exports);
+// Export transaction helpers
+__exportStar(require("./transaction"), exports);
+// Export event utilities
+__exportStar(require("./events"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/oracle.d.ts

@@ -0,0 +1,48 @@
+import { Address, PublicClient } from 'viem';
+/**
+ * Reads a Chainlink-style price feed (`AggregatorV3Interface`).
+ *
+ * Works with any standard aggregator — the canonical use here is an **ETH/USD**
+ * feed, which lets the SDK convert the pair-derived SLVR/ETH price into USD.
+ *
+ * Robinhood Chain has a Chainlink ETH/USD feed (`ETH / USD`, 8 decimals), wired
+ * into `deployments.robinhood.addresses.chainlinkEthUsd`, so `sdk.ethUsd` and USD
+ * prices work out of the box there. On chains without a feed, pass a USD price
+ * into {@link SlvrSDK.getSlvrPrice} instead, or wire your own off-chain source.
+ *
+ * @example
+ * ```typescript
+ * import { ChainlinkPriceFeed } from '@slvr-labs/sdk';
+ * const ethUsd = new ChainlinkPriceFeed(publicClient, ethUsdFeedAddress);
+ * const price = await ethUsd.getPrice(); // e.g. 1797.35
+ * ```
+ */
+export declare class ChainlinkPriceFeed {
+    private publicClient;
+    private feedAddress;
+    private maxStalenessSec?;
+    private static readonly ABI;
+    /**
+     * @param publicClient viem public client
+     * @param feedAddress the aggregator address
+     * @param opts.maxStalenessSec if set, {@link getPrice} throws when the feed's
+     *   `updatedAt` is older than this many seconds (checked against the local
+     *   clock). Off by default — enable it only where the local clock is trusted.
+     */
+    constructor(publicClient: PublicClient, feedAddress: Address, opts?: {
+        maxStalenessSec?: number;
+    });
+    /** Raw `latestRoundData` answer plus the feed's decimals. */
+    getRoundData(): Promise<{
+        answer: bigint;
+        decimals: number;
+        updatedAt: bigint;
+    }>;
+    /**
+     * The feed price as a floating-point number (`answer / 10 ** decimals`).
+     * @throws {Error} if the answer is non-positive, or (when `maxStalenessSec` is
+     *   set) if the feed is stale.
+     */
+    getPrice(): Promise<number>;
+}
+//# sourceMappingURL=oracle.d.ts.map

package/dist/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../src/oracle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAY,MAAM,MAAM,CAAC;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,eAAe,CAAC,CAAS;IAEjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAGxB;IAEH;;;;;;OAMG;gBAED,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,OAAO,EACpB,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE;IAOrC,6DAA6D;IACvD,YAAY,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBtF;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAgBlC"}

package/dist/oracle.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainlinkPriceFeed = void 0;
+const viem_1 = require("viem");
+/**
+ * Reads a Chainlink-style price feed (`AggregatorV3Interface`).
+ *
+ * Works with any standard aggregator — the canonical use here is an **ETH/USD**
+ * feed, which lets the SDK convert the pair-derived SLVR/ETH price into USD.
+ *
+ * Robinhood Chain has a Chainlink ETH/USD feed (`ETH / USD`, 8 decimals), wired
+ * into `deployments.robinhood.addresses.chainlinkEthUsd`, so `sdk.ethUsd` and USD
+ * prices work out of the box there. On chains without a feed, pass a USD price
+ * into {@link SlvrSDK.getSlvrPrice} instead, or wire your own off-chain source.
+ *
+ * @example
+ * ```typescript
+ * import { ChainlinkPriceFeed } from '@slvr-labs/sdk';
+ * const ethUsd = new ChainlinkPriceFeed(publicClient, ethUsdFeedAddress);
+ * const price = await ethUsd.getPrice(); // e.g. 1797.35
+ * ```
+ */
+class ChainlinkPriceFeed {
+    /**
+     * @param publicClient viem public client
+     * @param feedAddress the aggregator address
+     * @param opts.maxStalenessSec if set, {@link getPrice} throws when the feed's
+     *   `updatedAt` is older than this many seconds (checked against the local
+     *   clock). Off by default — enable it only where the local clock is trusted.
+     */
+    constructor(publicClient, feedAddress, opts) {
+        this.publicClient = publicClient;
+        this.feedAddress = feedAddress;
+        this.maxStalenessSec = opts?.maxStalenessSec;
+    }
+    /** Raw `latestRoundData` answer plus the feed's decimals. */
+    async getRoundData() {
+        const [decimals, roundData] = await Promise.all([
+            this.publicClient.readContract({
+                address: this.feedAddress,
+                abi: ChainlinkPriceFeed.ABI,
+                functionName: 'decimals',
+            }),
+            this.publicClient.readContract({
+                address: this.feedAddress,
+                abi: ChainlinkPriceFeed.ABI,
+                functionName: 'latestRoundData',
+            }),
+        ]);
+        return { answer: roundData[1], decimals, updatedAt: roundData[3] };
+    }
+    /**
+     * The feed price as a floating-point number (`answer / 10 ** decimals`).
+     * @throws {Error} if the answer is non-positive, or (when `maxStalenessSec` is
+     *   set) if the feed is stale.
+     */
+    async getPrice() {
+        const { answer, decimals, updatedAt } = await this.getRoundData();
+        if (answer <= 0n) {
+            throw new Error(`Chainlink feed ${this.feedAddress} returned a non-positive answer`);
+        }
+        if (this.maxStalenessSec !== undefined) {
+            const nowSec = Math.floor(Date.now() / 1000);
+            const age = nowSec - Number(updatedAt);
+            if (age > this.maxStalenessSec) {
+                throw new Error(`Chainlink feed ${this.feedAddress} is stale: ${age}s old (max ${this.maxStalenessSec}s)`);
+            }
+        }
+        return Number(answer) / 10 ** decimals;
+    }
+}
+exports.ChainlinkPriceFeed = ChainlinkPriceFeed;
+ChainlinkPriceFeed.ABI = (0, viem_1.parseAbi)([
+    'function decimals() view returns (uint8)',
+    'function latestRoundData() view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)',
+]);
+//# sourceMappingURL=oracle.js.map

package/dist/oracle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.js","sourceRoot":"","sources":["../src/oracle.ts"],"names":[],"mappings":";;;AAAA,+BAAuD;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,kBAAkB;IAU7B;;;;;;OAMG;IACH,YACE,YAA0B,EAC1B,WAAoB,EACpB,IAAmC;QAEnC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,IAAI,EAAE,eAAe,CAAC;IAC/C,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,YAAY;QAChB,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9C,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;gBAC7B,OAAO,EAAE,IAAI,CAAC,WAAW;gBACzB,GAAG,EAAE,kBAAkB,CAAC,GAAG;gBAC3B,YAAY,EAAE,UAAU;aACzB,CAAoB;YACrB,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;gBAC7B,OAAO,EAAE,IAAI,CAAC,WAAW;gBACzB,GAAG,EAAE,kBAAkB,CAAC,GAAG;gBAC3B,YAAY,EAAE,iBAAiB;aAChC,CAA+D;SACjE,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAClE,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,WAAW,iCAAiC,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC7C,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,CAAC,WAAW,cAAc,GAAG,cAAc,IAAI,CAAC,eAAe,IAAI,CAC1F,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;IACzC,CAAC;;AAhEH,gDAiEC;AA5DyB,sBAAG,GAAG,IAAA,eAAQ,EAAC;IACrC,0CAA0C;IAC1C,uIAAuI;CACxI,CAAC,CAAC"}

package/dist/price.d.ts

@@ -0,0 +1,52 @@
+import { Address, PublicClient } from 'viem';
+/**
+ * Reserves of the SLVR/ETH UniswapV2 pair, with the token ordering resolved.
+ */
+export interface SlvrReserves {
+    /** SLVR reserve, in wei (18 decimals). */
+    slvrReserve: bigint;
+    /** ETH (WETH) reserve, in wei (18 decimals). */
+    ethReserve: bigint;
+    /** Whether SLVR is `token0` in the pair (ordering is resolved for you). */
+    token0IsSlvr: boolean;
+}
+/**
+ * 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();
+ * ```
+ */
+export declare class SlvrPrice {
+    private publicClient;
+    private pairAddress;
+    private slvrTokenAddress;
+    private static readonly PAIR_ABI;
+    constructor(publicClient: PublicClient, pairAddress: Address, slvrTokenAddress: Address);
+    /** Read the pair reserves and resolve which side is SLVR. */
+    getReserves(): Promise<SlvrReserves>;
+    /**
+     * SLVR price in ETH (ETH per SLVR), as a floating-point number.
+     * @throws {Error} if the pair has no SLVR liquidity (zero reserve).
+     */
+    getPriceInEth(): Promise<number>;
+    /**
+     * 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).
+     */
+    getPriceInEthWad(): Promise<bigint>;
+}
+//# sourceMappingURL=price.d.ts.map

package/dist/price.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.d.ts","sourceRoot":"","sources":["../src/price.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAY,MAAM,MAAM,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,gBAAgB,CAAU;IAElC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAG7B;gBAES,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO;IAMvF,6DAA6D;IACvD,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAoB1C;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAQtC;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAO1C"}