@sly-rentals/core 1.1.2 → 2.0.0

package/dist/cjs/utils/contractSnapshot.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * @purpose Aggregated point-in-time view of a contract and its rentals
+ *
+ * One-shot fetch that pulls every on-chain account relevant to a single
+ * contract — `ConfigState`, `ContractState`, and the active / queued
+ * `RentalState`s (when they exist) — and also computes the contest
+ * minimum-bid floor evaluated at "now". The raw account states are
+ * exposed verbatim so callers decide what matters; `minimumBid` is the
+ * one piece of derived data that nearly every consumer of this snapshot
+ * needs.
+ *
+ * Granular `fetchConfig` / `fetchContract` / `fetchRental` remain
+ * available for narrow lookups that don't need the whole picture.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContractSnapshot = getContractSnapshot;
+exports.resolveContractSnapshot = resolveContractSnapshot;
+exports.computeMinimumBidFromSnapshot = computeMinimumBidFromSnapshot;
+exports.getMinimumBid = getMinimumBid;
+const kit_1 = require("@solana/kit");
+const config_1 = require("../accounts/config");
+const contract_1 = require("../accounts/contract");
+const rental_1 = require("../accounts/rental");
+const srsly_1 = require("../pda/srsly");
+const config_2 = require("./config");
+const bidMath_1 = require("./bidMath");
+const SYSTEM_PROGRAM_ID = '11111111111111111111111111111111';
+/**
+ * Fetch a contract and every account directly attached to it in one shot,
+ * then derive the contest minimum-bid floor at "now".
+ *
+ * Strategy: fetch `ConfigState` and `ContractState` in parallel, then read
+ * the contract's `activeRental` / `queuedRental` pointers and fetch
+ * whichever ones exist (in parallel). Pointers that equal SystemProgram
+ * are skipped without an RPC call. The bid floor is computed locally
+ * once all states are in.
+ *
+ * @example
+ * ```ts
+ * const snap = await getContractSnapshot({ contractAddress: 'Abc...' });
+ * const rate = snap.contract.data.rate;
+ * const defenderBid = snap.queuedRental?.data.bidAtlas ?? 0n;
+ * const floorNow = snap.minimumBid.minBidStardust;
+ *
+ * // Project the floor 4 hours forward without re-fetching:
+ * const floorLater = computeMinimumBidFromSnapshot(snap, {
+ *   delaySeconds: 4 * 60 * 60,
+ * });
+ * ```
+ */
+async function getContractSnapshot(args) {
+    const rpcUrl = args.rpcUrl ?? (0, config_2.getRpcUrl)();
+    const [config, contract] = await Promise.all([
+        (0, config_1.fetchConfig)(rpcUrl),
+        (0, contract_1.fetchContract)(args.contractAddress, rpcUrl),
+    ]);
+    const contractData = contract.data;
+    const activePromise = contractData.activeRental && contractData.activeRental.toString() !== SYSTEM_PROGRAM_ID
+        ? (0, srsly_1.deriveActiveRental)(contract.address)
+            .then(addr => (0, rental_1.fetchRental)(addr, rpcUrl))
+            .catch(() => null)
+        : Promise.resolve(null);
+    const queuedPromise = contractData.queuedRental && contractData.queuedRental.toString() !== SYSTEM_PROGRAM_ID
+        ? (0, srsly_1.deriveQueuedRental)(contract.address)
+            .then(addr => (0, rental_1.fetchRental)(addr, rpcUrl))
+            .catch(() => null)
+        : Promise.resolve(null);
+    const [activeRental, queuedRental] = await Promise.all([activePromise, queuedPromise]);
+    const partialSnap = { config, contract, activeRental, queuedRental };
+    const minimumBid = computeMinimumBidFromSnapshot(partialSnap);
+    return { ...partialSnap, minimumBid };
+}
+/**
+ * Resolve a `ContractSnapshot` from caller-supplied data or fetch fresh.
+ *
+ * Designed for callers (e.g. UIs) that already have a snapshot in hand and
+ * want to skip the RPC roundtrip when building an instruction. Behavior:
+ *
+ *   1. If no snapshot is supplied → fetch a fresh one.
+ *   2. If snapshot's contract address doesn't match `contractAddress` →
+ *      throw immediately (programmer error).
+ *   3. If snapshot's rental fields are stale relative to the contract's
+ *      pointers (contract says a rental exists but snapshot has `null` —
+ *      typical when the snapshot was fetched mid-state-change) → lazy
+ *      refetch the snapshot once.
+ *   4. If still stale after the refetch → throw. The on-chain reality
+ *      conflicts with itself; let the caller decide how to recover.
+ */
+async function resolveContractSnapshot(args) {
+    if (!args.snapshot) {
+        return getContractSnapshot({
+            contractAddress: args.contractAddress,
+            rpcUrl: args.rpcUrl,
+        });
+    }
+    const requested = (0, kit_1.address)(args.contractAddress);
+    if (args.snapshot.contract.address !== requested) {
+        throw new Error(`Provided snapshot is for contract ${args.snapshot.contract.address}, expected ${requested}`);
+    }
+    if (!isSnapshotStale(args.snapshot)) {
+        return args.snapshot;
+    }
+    const fresh = await getContractSnapshot({
+        contractAddress: args.contractAddress,
+        rpcUrl: args.rpcUrl,
+    });
+    if (isSnapshotStale(fresh)) {
+        throw new Error(`Contract ${requested} has a rental pointer set but the rental account could not be loaded after lazy refetch`);
+    }
+    return fresh;
+}
+function isSnapshotStale(snap) {
+    const activeStale = snap.contract.data.activeRental.toString() !== SYSTEM_PROGRAM_ID && !snap.activeRental;
+    const queuedStale = snap.contract.data.queuedRental.toString() !== SYSTEM_PROGRAM_ID && !snap.queuedRental;
+    return activeStale || queuedStale;
+}
+/**
+ * Pure derivation of `MinimumBid` from an already-fetched snapshot. No RPC.
+ *
+ * Use when the caller has a snapshot and wants the floor at a custom time
+ * projection (`delaySeconds` / `nowSeconds`) or with an overridden
+ * `atlasPerPoint` ratio. For the at-fetch-time floor, read
+ * `snap.minimumBid` directly.
+ */
+function computeMinimumBidFromSnapshot(snap, opts = {}) {
+    const cfgData = snap.config.data;
+    const contractData = snap.contract.data;
+    const rateStardust = BigInt(contractData.rate);
+    const atlasPerPoint = opts.atlasPerPoint ?? BigInt(cfgData.atlasPerPoint);
+    const stardustPerAtlas = BigInt(cfgData.stardustToAtlas);
+    const activeStart = snap.activeRental ? Number(snap.activeRental.data.startTime) : null;
+    const activeEnd = snap.activeRental ? Number(snap.activeRental.data.endTime) : null;
+    let defenderBidStardust = 0n;
+    if (snap.queuedRental) {
+        const q = snap.queuedRental.data;
+        const bidAtlas = BigInt(q.bidAtlas);
+        const bidPoints = BigInt(q.bidPoints);
+        // Points are 8-decimal dust; converting to stardust requires the same
+        // 8-decimal precision: stardust = points_dust * atlasPerPoint *
+        // stardustPerAtlas / 1e8. With both at 1e8 precision this collapses
+        // to points_dust * atlasPerPoint.
+        const pointsAsStardust = bidPoints > 0n ? (bidPoints * atlasPerPoint * stardustPerAtlas) / 100000000n : 0n;
+        defenderBidStardust = bidAtlas + pointsAsStardust;
+    }
+    const evaluatedAtSeconds = opts.nowSeconds !== undefined
+        ? Math.floor(opts.nowSeconds)
+        : Math.floor(Date.now() / 1000) + Math.max(0, opts.delaySeconds ?? 0);
+    let closeness = 0;
+    if (activeStart !== null && activeEnd !== null && activeEnd > activeStart) {
+        const span = activeEnd - activeStart;
+        const elapsed = evaluatedAtSeconds - activeStart;
+        closeness = Math.max(0, Math.min(1, elapsed / span));
+    }
+    const minBidStardust = (0, bidMath_1.computeMinimumBid)({
+        rateStardust,
+        defenderBidStardust,
+        contestedMultiplierMaxBps: cfgData.contestedMultiplierMaxBps,
+        captureRateBps: BigInt(cfgData.captureRateBps),
+        closenessFraction: closeness,
+    });
+    const baseStardust = rateStardust > defenderBidStardust ? rateStardust : defenderBidStardust;
+    const rampMultiplier = baseStardust > 0n ? Number(minBidStardust) / Number(baseStardust) : 1;
+    return {
+        minBidStardust,
+        defenderBidStardust,
+        rateStardust,
+        closenessFraction: closeness,
+        rampMultiplier,
+        evaluatedAtSeconds,
+        activeEndSeconds: activeEnd,
+        activeStartSeconds: activeStart,
+    };
+}
+/**
+ * Convenience wrapper: fetch a snapshot and return only its `minimumBid`.
+ *
+ * Same fetches as `getContractSnapshot` — if you need the contract / rental
+ * states too, call `getContractSnapshot` directly so you don't fetch twice.
+ *
+ * For time-projected floors, pass `delaySeconds` or `nowSeconds`; the
+ * underlying fetch is identical.
+ */
+async function getMinimumBid(args) {
+    if (args.snapshot) {
+        return computeMinimumBidFromSnapshot(args.snapshot, {
+            delaySeconds: args.delaySeconds,
+            nowSeconds: args.nowSeconds,
+            atlasPerPoint: args.atlasPerPoint,
+        });
+    }
+    const snap = await getContractSnapshot({
+        contractAddress: args.contractAddress,
+        rpcUrl: args.rpcUrl,
+    });
+    if (args.delaySeconds === undefined &&
+        args.nowSeconds === undefined &&
+        args.atlasPerPoint === undefined) {
+        return snap.minimumBid;
+    }
+    return computeMinimumBidFromSnapshot(snap, {
+        delaySeconds: args.delaySeconds,
+        nowSeconds: args.nowSeconds,
+        atlasPerPoint: args.atlasPerPoint,
+    });
+}
+//# sourceMappingURL=contractSnapshot.js.map

package/dist/cjs/utils/contractSnapshot.js.map

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

package/dist/cjs/utils/contractSnapshot.test.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+vitest_1.vi.mock('../accounts/config', () => ({
+    fetchConfig: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock('../accounts/contract', () => ({
+    fetchContract: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock('../accounts/rental', () => ({
+    fetchRental: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock('../pda/srsly', () => ({
+    deriveActiveRental: vitest_1.vi.fn(),
+    deriveQueuedRental: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock('./config', () => ({
+    getRpcUrl: () => 'http://localhost:8899',
+}));
+const config_1 = require("../accounts/config");
+const contract_1 = require("../accounts/contract");
+const rental_1 = require("../accounts/rental");
+const srsly_1 = require("../pda/srsly");
+const contractSnapshot_1 = require("./contractSnapshot");
+const SYSTEM = '11111111111111111111111111111111';
+// Real validated 32-byte base58 addresses for test fixtures.
+const CONTRACT_ADDR = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
+const ACTIVE_ADDR = 'So11111111111111111111111111111111111111112';
+const QUEUED_ADDR = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
+const OTHER_ADDR = 'BPFLoader2111111111111111111111111111111111';
+const VAULT_ADDR = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
+const makeConfig = (overrides = {}) => ({
+    stardustToAtlas: 100000000n,
+    atlasPerPoint: 100n,
+    captureRateBps: 10500n,
+    contestedMultiplierMaxBps: 465,
+    slyvault: VAULT_ADDR,
+    atlasMint: VAULT_ADDR,
+    ...overrides,
+});
+const makeContract = (overrides = {}) => ({
+    rate: 100000000n,
+    activeRental: SYSTEM,
+    queuedRental: SYSTEM,
+    fleet: VAULT_ADDR,
+    gameId: VAULT_ADDR,
+    thread: SYSTEM,
+    ...overrides,
+});
+const makeRental = (overrides = {}) => ({
+    bidAtlas: 0n,
+    bidPoints: 0n,
+    startTime: 0n,
+    endTime: 0n,
+    ...overrides,
+});
+(0, vitest_1.beforeEach)(() => {
+    vitest_1.vi.clearAllMocks();
+    vitest_1.vi.mocked(srsly_1.deriveActiveRental).mockResolvedValue(ACTIVE_ADDR);
+    vitest_1.vi.mocked(srsly_1.deriveQueuedRental).mockResolvedValue(QUEUED_ADDR);
+});
+(0, vitest_1.describe)('getContractSnapshot', () => {
+    (0, vitest_1.it)('returns null rentals when contract pointers are SystemProgram', async () => {
+        vitest_1.vi.mocked(config_1.fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vitest_1.vi.mocked(contract_1.fetchContract).mockResolvedValue({
+            data: makeContract(),
+            address: CONTRACT_ADDR,
+        });
+        const snap = await (0, contractSnapshot_1.getContractSnapshot)({ contractAddress: CONTRACT_ADDR });
+        (0, vitest_1.expect)(snap.activeRental).toBeNull();
+        (0, vitest_1.expect)(snap.queuedRental).toBeNull();
+        (0, vitest_1.expect)(rental_1.fetchRental).not.toHaveBeenCalled();
+        (0, vitest_1.expect)(snap.minimumBid).toBeDefined();
+    });
+    (0, vitest_1.it)('fetches active + queued when contract pointers are set', async () => {
+        vitest_1.vi.mocked(config_1.fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vitest_1.vi.mocked(contract_1.fetchContract).mockResolvedValue({
+            data: makeContract({ activeRental: ACTIVE_ADDR, queuedRental: QUEUED_ADDR }),
+            address: CONTRACT_ADDR,
+        });
+        vitest_1.vi.mocked(rental_1.fetchRental).mockImplementation(async (addr) => ({
+            data: makeRental(),
+            address: addr,
+        }));
+        const snap = await (0, contractSnapshot_1.getContractSnapshot)({ contractAddress: CONTRACT_ADDR });
+        (0, vitest_1.expect)(snap.activeRental?.address).toBe(ACTIVE_ADDR);
+        (0, vitest_1.expect)(snap.queuedRental?.address).toBe(QUEUED_ADDR);
+        (0, vitest_1.expect)(rental_1.fetchRental).toHaveBeenCalledTimes(2);
+    });
+    (0, vitest_1.it)('returns null when pointer is set but fetchRental throws (stale pointer)', async () => {
+        vitest_1.vi.mocked(config_1.fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vitest_1.vi.mocked(contract_1.fetchContract).mockResolvedValue({
+            data: makeContract({ activeRental: ACTIVE_ADDR }),
+            address: CONTRACT_ADDR,
+        });
+        vitest_1.vi.mocked(rental_1.fetchRental).mockRejectedValue(new Error('not found'));
+        const snap = await (0, contractSnapshot_1.getContractSnapshot)({ contractAddress: CONTRACT_ADDR });
+        (0, vitest_1.expect)(snap.activeRental).toBeNull();
+        (0, vitest_1.expect)(snap.queuedRental).toBeNull();
+    });
+});
+(0, vitest_1.describe)('computeMinimumBidFromSnapshot', () => {
+    const buildSnap = (parts) => ({
+        config: { data: makeConfig(), address: 'CFG' },
+        contract: {
+            data: makeContract({
+                rate: parts.rate ?? 100000000n,
+                activeRental: parts.activeStart !== undefined ? ACTIVE_ADDR : SYSTEM,
+                queuedRental: parts.queuedBidAtlas !== undefined || parts.queuedBidPoints !== undefined
+                    ? QUEUED_ADDR
+                    : SYSTEM,
+            }),
+            address: CONTRACT_ADDR,
+        },
+        activeRental: parts.activeStart !== undefined
+            ? {
+                data: makeRental({
+                    startTime: parts.activeStart,
+                    endTime: parts.activeEnd ?? parts.activeStart + 86400n,
+                }),
+                address: ACTIVE_ADDR,
+            }
+            : null,
+        queuedRental: parts.queuedBidAtlas !== undefined || parts.queuedBidPoints !== undefined
+            ? {
+                data: makeRental({
+                    bidAtlas: parts.queuedBidAtlas ?? 0n,
+                    bidPoints: parts.queuedBidPoints ?? 0n,
+                }),
+                address: QUEUED_ADDR,
+            }
+            : null,
+    });
+    (0, vitest_1.it)('no defender → floor = rate × captureRate cap', async () => {
+        const snap = buildSnap({ rate: 100000000n });
+        const bid = (0, contractSnapshot_1.computeMinimumBidFromSnapshot)(snap);
+        (0, vitest_1.expect)(bid.defenderBidStardust).toBe(0n);
+        // rate * captureRateBps / baseBps = 100M * 10500 / 10000 = 105M
+        (0, vitest_1.expect)(bid.minBidStardust).toBe(105000000n);
+        (0, vitest_1.expect)(bid.closenessFraction).toBe(0);
+    });
+    (0, vitest_1.it)('defender ATLAS bid raises floor above rate when bid > rate', async () => {
+        const snap = buildSnap({ rate: 100000000n, queuedBidAtlas: 200000000n });
+        const bid = (0, contractSnapshot_1.computeMinimumBidFromSnapshot)(snap);
+        (0, vitest_1.expect)(bid.defenderBidStardust).toBe(200000000n);
+        // base = max(rate, defender) = 200M, ramp at closeness=0 capped to 10500/10000 = 1.05x
+        (0, vitest_1.expect)(bid.minBidStardust).toBe(210000000n);
+    });
+    (0, vitest_1.it)('closeness ramps from 1× to maxMult as active rental nears end', async () => {
+        const now = 1_000_000;
+        const start = BigInt(now - 50);
+        const end = BigInt(now + 50);
+        const snap = buildSnap({
+            rate: 100000000n,
+            queuedBidAtlas: 100000000n,
+            activeStart: start,
+            activeEnd: end,
+        });
+        const bid = (0, contractSnapshot_1.computeMinimumBidFromSnapshot)(snap, { nowSeconds: now });
+        // closeness = 50/100 = 0.5
+        (0, vitest_1.expect)(bid.closenessFraction).toBeCloseTo(0.5, 5);
+        // ramp_bps = 10000 + (465 - 100) * 5000 / 100 = 10000 + 18250 = 28250 → 2.825×
+        // floor = 100M * 28250 / 10000 = 282_500_000
+        (0, vitest_1.expect)(bid.minBidStardust).toBe(282500000n);
+    });
+    (0, vitest_1.it)('delaySeconds projects closeness forward without RPC', async () => {
+        const start = 1000000n;
+        const end = 1000100n;
+        const snap = buildSnap({
+            rate: 100000000n,
+            queuedBidAtlas: 100000000n,
+            activeStart: start,
+            activeEnd: end,
+        });
+        const now = (0, contractSnapshot_1.computeMinimumBidFromSnapshot)(snap, { nowSeconds: 1_000_000 });
+        const later = (0, contractSnapshot_1.computeMinimumBidFromSnapshot)(snap, { nowSeconds: 1_000_050 });
+        (0, vitest_1.expect)(now.closenessFraction).toBe(0);
+        (0, vitest_1.expect)(later.closenessFraction).toBeCloseTo(0.5, 5);
+        (0, vitest_1.expect)(later.minBidStardust).toBeGreaterThan(now.minBidStardust);
+    });
+});
+(0, vitest_1.describe)('resolveContractSnapshot', () => {
+    (0, vitest_1.it)('fetches fresh when no snapshot provided', async () => {
+        vitest_1.vi.mocked(config_1.fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vitest_1.vi.mocked(contract_1.fetchContract).mockResolvedValue({
+            data: makeContract(),
+            address: CONTRACT_ADDR,
+        });
+        await (0, contractSnapshot_1.resolveContractSnapshot)({ contractAddress: CONTRACT_ADDR });
+        (0, vitest_1.expect)(contract_1.fetchContract).toHaveBeenCalledTimes(1);
+    });
+    (0, vitest_1.it)('returns provided snapshot as-is when address matches and no staleness', async () => {
+        vitest_1.vi.mocked(config_1.fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vitest_1.vi.mocked(contract_1.fetchContract).mockResolvedValue({
+            data: makeContract(),
+            address: CONTRACT_ADDR,
+        });
+        const snap = await (0, contractSnapshot_1.getContractSnapshot)({ contractAddress: CONTRACT_ADDR });
+        vitest_1.vi.clearAllMocks();
+        const resolved = await (0, contractSnapshot_1.resolveContractSnapshot)({
+            contractAddress: CONTRACT_ADDR,
+            snapshot: snap,
+        });
+        (0, vitest_1.expect)(resolved).toBe(snap);
+        (0, vitest_1.expect)(contract_1.fetchContract).not.toHaveBeenCalled();
+    });
+    (0, vitest_1.it)('throws when snapshot contract address does not match', async () => {
+        vitest_1.vi.mocked(config_1.fetchConfig).mockResolvedValue({ data: makeConfig(), address: VAULT_ADDR });
+        vitest_1.vi.mocked(contract_1.fetchContract).mockResolvedValue({ data: makeContract(), address: OTHER_ADDR });
+        const snap = await (0, contractSnapshot_1.getContractSnapshot)({ contractAddress: OTHER_ADDR });
+        await (0, vitest_1.expect)((0, contractSnapshot_1.resolveContractSnapshot)({ contractAddress: CONTRACT_ADDR, snapshot: snap })).rejects.toThrow(/snapshot is for contract/);
+    });
+    (0, vitest_1.it)('lazy-refetches when snapshot is stale (pointer set, rental null)', async () => {
+        // First fetch: pointer set but rental fetch fails → snap.activeRental = null (stale)
+        vitest_1.vi.mocked(config_1.fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vitest_1.vi.mocked(contract_1.fetchContract).mockResolvedValue({
+            data: makeContract({ activeRental: ACTIVE_ADDR }),
+            address: CONTRACT_ADDR,
+        });
+        vitest_1.vi.mocked(rental_1.fetchRental).mockRejectedValueOnce(new Error('not found'));
+        const staleSnap = await (0, contractSnapshot_1.getContractSnapshot)({ contractAddress: CONTRACT_ADDR });
+        (0, vitest_1.expect)(staleSnap.activeRental).toBeNull();
+        // Refetch succeeds — rental now loads
+        vitest_1.vi.mocked(rental_1.fetchRental).mockResolvedValueOnce({
+            data: makeRental(),
+            address: ACTIVE_ADDR,
+        });
+        const resolved = await (0, contractSnapshot_1.resolveContractSnapshot)({
+            contractAddress: CONTRACT_ADDR,
+            snapshot: staleSnap,
+        });
+        (0, vitest_1.expect)(resolved.activeRental).not.toBeNull();
+        // resolve called fetchContract once more for refetch
+        (0, vitest_1.expect)(contract_1.fetchContract).toHaveBeenCalledTimes(2);
+    });
+    (0, vitest_1.it)('throws when still stale after lazy refetch', async () => {
+        vitest_1.vi.mocked(config_1.fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vitest_1.vi.mocked(contract_1.fetchContract).mockResolvedValue({
+            data: makeContract({ activeRental: ACTIVE_ADDR }),
+            address: CONTRACT_ADDR,
+        });
+        vitest_1.vi.mocked(rental_1.fetchRental).mockRejectedValue(new Error('not found'));
+        const staleSnap = await (0, contractSnapshot_1.getContractSnapshot)({ contractAddress: CONTRACT_ADDR });
+        await (0, vitest_1.expect)((0, contractSnapshot_1.resolveContractSnapshot)({ contractAddress: CONTRACT_ADDR, snapshot: staleSnap })).rejects.toThrow(/could not be loaded after lazy refetch/);
+    });
+});
+//# sourceMappingURL=contractSnapshot.test.js.map

package/dist/cjs/utils/contractSnapshot.test.js.map

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

package/dist/cjs/utils/index.js

@@ -4,7 +4,7 @@
  * @module utils
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requireValidReferrer = exports.resolveReferrer = exports.deserializeDiscountAuth = exports.createDiscount = exports.getMinimumBid = exports.computeMinimumBid = exports.hasQueuedRental = exports.hasActiveRental = exports.getLookupTableAddress = exports.fetchLookupTable = exports.isRpcDebugEnabled = exports.setRpcDebug = exports.createRpc = exports.InstructionResult = exports.prepareInstructions = exports.toAddress = exports.toWeb3Instruction = exports.isAddressString = exports.isKitSigner = exports.isWeb3jsSigner = exports.validateAddress = exports.toTransactionSigner = exports.ATLASNET_ADDRESSES = exports.MAINNET_ADDRESSES = exports.ATLASNET_GENESIS = exports.DEVNET_GENESIS = exports.MAINNET_GENESIS = exports.resolveGenesisHash = exports.isValidNetwork = exports.isValidProgramSet = exports.getNetworkAddresses = exports.getProgramAddresses = exports.detectProgramSet = exports.getRpcUrl = exports.getAffiliateConfig = exports.getAddresses = exports.mergeConfig = exports.clearSdkConfig = exports.getSdkConfig = exports.setSdkConfig = void 0;
+exports.requireValidReferrer = exports.resolveReferrer = exports.deserializeDiscountAuth = exports.createDiscount = exports.getMinimumBid = exports.computeMinimumBidFromSnapshot = exports.resolveContractSnapshot = exports.getContractSnapshot = exports.computeMinimumBid = exports.hasQueuedRental = exports.hasActiveRental = exports.getLookupTableAddress = exports.fetchLookupTable = exports.isRpcDebugEnabled = exports.setRpcDebug = exports.createRpc = exports.InstructionResult = exports.prepareInstructions = exports.toAddress = exports.toWeb3Instruction = exports.isAddressString = exports.isKitSigner = exports.isWeb3jsSigner = exports.validateAddress = exports.toTransactionSigner = exports.ATLASNET_ADDRESSES = exports.MAINNET_ADDRESSES = exports.ATLASNET_GENESIS = exports.DEVNET_GENESIS = exports.MAINNET_GENESIS = exports.resolveGenesisHash = exports.isValidNetwork = exports.isValidProgramSet = exports.getNetworkAddresses = exports.getProgramAddresses = exports.detectProgramSet = exports.getRpcUrl = exports.getAffiliateConfig = exports.getAddresses = exports.mergeConfig = exports.clearSdkConfig = exports.getSdkConfig = exports.setSdkConfig = void 0;
 // Configuration
 var config_1 = require("./config");
 Object.defineProperty(exports, "setSdkConfig", { enumerable: true, get: function () { return config_1.setSdkConfig; } });
@@ -57,10 +57,15 @@ Object.defineProperty(exports, "getLookupTableAddress", { enumerable: true, get:
 var rental_1 = require("./rental");
 Object.defineProperty(exports, "hasActiveRental", { enumerable: true, get: function () { return rental_1.hasActiveRental; } });
 Object.defineProperty(exports, "hasQueuedRental", { enumerable: true, get: function () { return rental_1.hasQueuedRental; } });
-// Bid Math
+// Bid Math (pure formula + type)
 var bidMath_1 = require("./bidMath");
 Object.defineProperty(exports, "computeMinimumBid", { enumerable: true, get: function () { return bidMath_1.computeMinimumBid; } });
-Object.defineProperty(exports, "getMinimumBid", { enumerable: true, get: function () { return bidMath_1.getMinimumBid; } });
+// Contract Snapshot (aggregated one-shot fetch + derived bid)
+var contractSnapshot_1 = require("./contractSnapshot");
+Object.defineProperty(exports, "getContractSnapshot", { enumerable: true, get: function () { return contractSnapshot_1.getContractSnapshot; } });
+Object.defineProperty(exports, "resolveContractSnapshot", { enumerable: true, get: function () { return contractSnapshot_1.resolveContractSnapshot; } });
+Object.defineProperty(exports, "computeMinimumBidFromSnapshot", { enumerable: true, get: function () { return contractSnapshot_1.computeMinimumBidFromSnapshot; } });
+Object.defineProperty(exports, "getMinimumBid", { enumerable: true, get: function () { return contractSnapshot_1.getMinimumBid; } });
 // Discount Authorization
 var discountAuth_1 = require("./discountAuth");
 Object.defineProperty(exports, "createDiscount", { enumerable: true, get: function () { return discountAuth_1.createDiscount; } });

package/dist/cjs/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,gBAAgB;AAChB,mCAYkB;AAXhB,sGAAA,YAAY,OAAA;AACZ,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA;AACd,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA;AACZ,4GAAA,kBAAkB,OAAA;AAClB,mGAAA,SAAS,OAAA;AACT,0GAAA,gBAAgB,OAAA;AAMlB,oBAAoB;AACpB,yCAeqB;AAdnB,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,8GAAA,iBAAiB,OAAA;AACjB,2GAAA,cAAc,OAAA;AACd,+GAAA,kBAAkB,OAAA;AAClB,4GAAA,eAAe,OAAA;AACf,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAOpB,mBAAmB;AACnB,mCAOkB;AANhB,6GAAA,mBAAmB,OAAA;AACnB,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,qGAAA,WAAW,OAAA;AACX,yGAAA,eAAe,OAAA;AAIjB,wBAAwB;AACxB,mCAMkB;AALhB,2GAAA,iBAAiB,OAAA;AACjB,mGAAA,SAAS,OAAA;AAMX,wBAAwB;AACxB,+CAAsF;AAA7E,mHAAA,mBAAmB,OAAA;AAE5B,qBAAqB;AACrB,yDAAgF;AAAvE,sHAAA,iBAAiB,OAAA;AAE1B,gBAAgB;AAChB,6BAAkE;AAAzD,gGAAA,SAAS,OAAA;AAAE,kGAAA,WAAW,OAAA;AAAE,wGAAA,iBAAiB,OAAA;AAElD,iCAAiC;AACjC,6CAIuB;AAHrB,+GAAA,gBAAgB,OAAA;AAChB,oHAAA,qBAAqB,OAAA;AAIvB,mBAAmB;AACnB,mCAA4D;AAAnD,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AAEzC,WAAW;AACX,qCAA8E;AAArE,4GAAA,iBAAiB,OAAA;AAAE,wGAAA,aAAa,OAAA;AAEzC,yBAAyB;AACzB,+CAMwB;AALtB,8GAAA,cAAc,OAAA;AACd,uHAAA,uBAAuB,OAAA;AAMzB,8CAA8C;AAC9C,uCAAmE;AAA1D,2GAAA,eAAe,OAAA;AAAE,gHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,gBAAgB;AAChB,mCAYkB;AAXhB,sGAAA,YAAY,OAAA;AACZ,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA;AACd,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA;AACZ,4GAAA,kBAAkB,OAAA;AAClB,mGAAA,SAAS,OAAA;AACT,0GAAA,gBAAgB,OAAA;AAMlB,oBAAoB;AACpB,yCAeqB;AAdnB,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,8GAAA,iBAAiB,OAAA;AACjB,2GAAA,cAAc,OAAA;AACd,+GAAA,kBAAkB,OAAA;AAClB,4GAAA,eAAe,OAAA;AACf,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAOpB,mBAAmB;AACnB,mCAOkB;AANhB,6GAAA,mBAAmB,OAAA;AACnB,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,qGAAA,WAAW,OAAA;AACX,yGAAA,eAAe,OAAA;AAIjB,wBAAwB;AACxB,mCAMkB;AALhB,2GAAA,iBAAiB,OAAA;AACjB,mGAAA,SAAS,OAAA;AAMX,wBAAwB;AACxB,+CAAsF;AAA7E,mHAAA,mBAAmB,OAAA;AAE5B,qBAAqB;AACrB,yDAAgF;AAAvE,sHAAA,iBAAiB,OAAA;AAE1B,gBAAgB;AAChB,6BAAkE;AAAzD,gGAAA,SAAS,OAAA;AAAE,kGAAA,WAAW,OAAA;AAAE,wGAAA,iBAAiB,OAAA;AAElD,iCAAiC;AACjC,6CAIuB;AAHrB,+GAAA,gBAAgB,OAAA;AAChB,oHAAA,qBAAqB,OAAA;AAIvB,mBAAmB;AACnB,mCAA4D;AAAnD,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AAEzC,iCAAiC;AACjC,qCAA+D;AAAtD,4GAAA,iBAAiB,OAAA;AAE1B,8DAA8D;AAC9D,uDAO4B;AAN1B,uHAAA,mBAAmB,OAAA;AACnB,2HAAA,uBAAuB,OAAA;AACvB,iIAAA,6BAA6B,OAAA;AAC7B,iHAAA,aAAa,OAAA;AAKf,yBAAyB;AACzB,+CAMwB;AALtB,8GAAA,cAAc,OAAA;AACd,uHAAA,uBAAuB,OAAA;AAMzB,8CAA8C;AAC9C,uCAAmE;AAA1D,2GAAA,eAAe,OAAA;AAAE,gHAAA,oBAAoB,OAAA"}

package/dist/cjs/version.js

@@ -3,5 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 // Auto-generated from package.json - DO NOT EDIT
 // Run "pnpm run generate:version" to update
-exports.VERSION = '1.1.2';
+exports.VERSION = '2.0.0';
 //# sourceMappingURL=version.js.map