@sly-rentals/core 1.1.1 → 1.2.0

package/dist/esm/utils/bidMath.js

@@ -1,19 +1,12 @@
 /**
- * @purpose Reservation bid math helpers
+ * @purpose Reservation bid math (pure formula + type)
  *
- * Pure-math + on-chain-fetch helpers for computing the contest minimum-bid
- * floor that a challenger must clear to take an existing reservation.
- * Mirrors the on-chain `ConfigState::bid_min_stardust` formula so client UIs
- * (and on-chain-aware tooling) can preview the floor without hitting an RPC
- * for every keystroke.
+ * Mirror of the on-chain `ConfigState::bid_min_stardust` formula so UIs
+ * can preview the contest minimum-bid floor without hitting an RPC for
+ * every keystroke. Fetch-aware helpers (`getMinimumBid`,
+ * `computeMinimumBidFromSnapshot`) live in `./contractSnapshot` — they
+ * call into the pure formula here.
  */
-import { fetchConfig } from '../accounts/config';
-import { fetchContract } from '../accounts/contract';
-import { fetchRental } from '../accounts/rental';
-import { deriveActiveRental, deriveQueuedRental } from '../pda/srsly';
-import { getRpcUrl } from './config';
-import { createRpc } from './rpc';
-const SYSTEM_PROGRAM_ID = '11111111111111111111111111111111';
 /**
  * Pure math: contest minimum-bid floor in stardust.
  *
@@ -42,105 +35,4 @@ export function computeMinimumBid(args) {
     const base = args.rateStardust > defenderBid ? args.rateStardust : defenderBid;
     return (base * effBps) / 10000n;
 }
-/**
- * High-level helper: compute the contest minimum bid for a contract right
- * now (or at `now + delaySeconds`).
- *
- * Fetches `ConfigState`, `ContractState`, and the active/queued `RentalState`
- * accounts, derives `closeness` from the active rental window, and returns
- * the floor a challenger must clear plus enough context to render a UI.
- *
- * @example
- * ```ts
- * const floor = await getMinimumBid({ contractAddress: 'Abc...' });
- * console.log('Bid at least', floor.minBidStardust, 'stardust');
- *
- * // Preview the floor 4 hours from now (snipe-window pricing):
- * const later = await getMinimumBid({
- *   contractAddress: 'Abc...',
- *   delaySeconds: 4 * 60 * 60,
- * });
- * ```
- *
- * If the contract has no active rental yet, closeness = 0 and the floor
- * collapses to the rate-bump floor (`rate × captureRate`).
- */
-export async function getMinimumBid(args) {
-    const rpcUrl = args.rpcUrl ?? getRpcUrl();
-    const rpc = createRpc(rpcUrl);
-    const cfgPromise = fetchConfig(rpcUrl);
-    const contractPromise = fetchContract(args.contractAddress, rpcUrl);
-    const [cfg, contract] = await Promise.all([cfgPromise, contractPromise]);
-    const cfgData = cfg.data;
-    const contractData = contract.data;
-    const rateStardust = BigInt(contractData.rate);
-    const atlasPerPoint = args.atlasPerPoint ?? BigInt(cfgData.atlasPerPoint);
-    const stardustPerAtlas = BigInt(cfgData.stardustToAtlas);
-    const activeAddr = await deriveActiveRental(contract.address);
-    const queuedAddr = await deriveQueuedRental(contract.address);
-    // Active rental — only meaningful if the contract field points at it.
-    let activeStart = null;
-    let activeEnd = null;
-    if (contractData.activeRental && contractData.activeRental.toString() !== SYSTEM_PROGRAM_ID) {
-        try {
-            const active = await fetchRental(activeAddr, rpcUrl);
-            const a = active.data;
-            activeStart = Number(a.startTime);
-            activeEnd = Number(a.endTime);
-        }
-        catch {
-            // Account missing despite contract pointer — treat as no active rental.
-        }
-    }
-    // Queued rental — defender bid lives here if a reservation exists.
-    let defenderBidStardust = 0n;
-    if (contractData.queuedRental && contractData.queuedRental.toString() !== SYSTEM_PROGRAM_ID) {
-        try {
-            const queued = await fetchRental(queuedAddr, rpcUrl);
-            const q = queued.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;
-        }
-        catch {
-            // Missing queued account — leave defenderBidStardust = 0.
-        }
-    }
-    const evaluatedAtSeconds = args.nowSeconds !== undefined
-        ? Math.floor(args.nowSeconds)
-        : Math.floor(Date.now() / 1000) + Math.max(0, args.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 = 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;
-    // RPC reference kept to match the codebase pattern even when unused;
-    // future refinements (e.g. fetching chain time) can plug in here.
-    void rpc;
-    return {
-        minBidStardust,
-        defenderBidStardust,
-        rateStardust,
-        closenessFraction: closeness,
-        rampMultiplier,
-        evaluatedAtSeconds,
-        activeEndSeconds: activeEnd,
-        activeStartSeconds: activeStart,
-    };
-}
 //# sourceMappingURL=bidMath.js.map

package/dist/esm/utils/bidMath.js.map

@@ -1 +1 @@
-{"version":3,"file":"bidMath.js","sourceRoot":"","sources":["../../../src/utils/bidMath.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bidMath.js","sourceRoot":"","sources":["../../../src/utils/bidMath.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAMjC;IACC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,MAAM,SAAS,GAAG,MAAO,GAAG,CAAC,QAAQ,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,GAAG,MAAO,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,MAAO,CAAC;IAC7E,MAAM,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACvD,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,IAAI,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;IAC/E,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,MAAO,CAAC;AACnC,CAAC"}

package/dist/esm/utils/contractSnapshot.js

@@ -0,0 +1,201 @@
+/**
+ * @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.
+ */
+import { address } from '@solana/kit';
+import { fetchConfig } from '../accounts/config';
+import { fetchContract } from '../accounts/contract';
+import { fetchRental } from '../accounts/rental';
+import { deriveActiveRental, deriveQueuedRental } from '../pda/srsly';
+import { getRpcUrl } from './config';
+import { computeMinimumBid } from './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,
+ * });
+ * ```
+ */
+export async function getContractSnapshot(args) {
+    const rpcUrl = args.rpcUrl ?? getRpcUrl();
+    const [config, contract] = await Promise.all([
+        fetchConfig(rpcUrl),
+        fetchContract(args.contractAddress, rpcUrl),
+    ]);
+    const contractData = contract.data;
+    const activePromise = contractData.activeRental && contractData.activeRental.toString() !== SYSTEM_PROGRAM_ID
+        ? deriveActiveRental(contract.address)
+            .then(addr => fetchRental(addr, rpcUrl))
+            .catch(() => null)
+        : Promise.resolve(null);
+    const queuedPromise = contractData.queuedRental && contractData.queuedRental.toString() !== SYSTEM_PROGRAM_ID
+        ? deriveQueuedRental(contract.address)
+            .then(addr => 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.
+ */
+export async function resolveContractSnapshot(args) {
+    if (!args.snapshot) {
+        return getContractSnapshot({
+            contractAddress: args.contractAddress,
+            rpcUrl: args.rpcUrl,
+        });
+    }
+    const requested = 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.
+ */
+export 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 = 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.
+ */
+export 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/esm/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/esm/utils/contractSnapshot.test.js

@@ -0,0 +1,245 @@
+import { describe, expect, it, vi, beforeEach } from 'vitest';
+vi.mock('../accounts/config', () => ({
+    fetchConfig: vi.fn(),
+}));
+vi.mock('../accounts/contract', () => ({
+    fetchContract: vi.fn(),
+}));
+vi.mock('../accounts/rental', () => ({
+    fetchRental: vi.fn(),
+}));
+vi.mock('../pda/srsly', () => ({
+    deriveActiveRental: vi.fn(),
+    deriveQueuedRental: vi.fn(),
+}));
+vi.mock('./config', () => ({
+    getRpcUrl: () => 'http://localhost:8899',
+}));
+import { fetchConfig } from '../accounts/config';
+import { fetchContract } from '../accounts/contract';
+import { fetchRental } from '../accounts/rental';
+import { deriveActiveRental, deriveQueuedRental } from '../pda/srsly';
+import { getContractSnapshot, resolveContractSnapshot, computeMinimumBidFromSnapshot, } from './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,
+});
+beforeEach(() => {
+    vi.clearAllMocks();
+    vi.mocked(deriveActiveRental).mockResolvedValue(ACTIVE_ADDR);
+    vi.mocked(deriveQueuedRental).mockResolvedValue(QUEUED_ADDR);
+});
+describe('getContractSnapshot', () => {
+    it('returns null rentals when contract pointers are SystemProgram', async () => {
+        vi.mocked(fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vi.mocked(fetchContract).mockResolvedValue({
+            data: makeContract(),
+            address: CONTRACT_ADDR,
+        });
+        const snap = await getContractSnapshot({ contractAddress: CONTRACT_ADDR });
+        expect(snap.activeRental).toBeNull();
+        expect(snap.queuedRental).toBeNull();
+        expect(fetchRental).not.toHaveBeenCalled();
+        expect(snap.minimumBid).toBeDefined();
+    });
+    it('fetches active + queued when contract pointers are set', async () => {
+        vi.mocked(fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vi.mocked(fetchContract).mockResolvedValue({
+            data: makeContract({ activeRental: ACTIVE_ADDR, queuedRental: QUEUED_ADDR }),
+            address: CONTRACT_ADDR,
+        });
+        vi.mocked(fetchRental).mockImplementation(async (addr) => ({
+            data: makeRental(),
+            address: addr,
+        }));
+        const snap = await getContractSnapshot({ contractAddress: CONTRACT_ADDR });
+        expect(snap.activeRental?.address).toBe(ACTIVE_ADDR);
+        expect(snap.queuedRental?.address).toBe(QUEUED_ADDR);
+        expect(fetchRental).toHaveBeenCalledTimes(2);
+    });
+    it('returns null when pointer is set but fetchRental throws (stale pointer)', async () => {
+        vi.mocked(fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vi.mocked(fetchContract).mockResolvedValue({
+            data: makeContract({ activeRental: ACTIVE_ADDR }),
+            address: CONTRACT_ADDR,
+        });
+        vi.mocked(fetchRental).mockRejectedValue(new Error('not found'));
+        const snap = await getContractSnapshot({ contractAddress: CONTRACT_ADDR });
+        expect(snap.activeRental).toBeNull();
+        expect(snap.queuedRental).toBeNull();
+    });
+});
+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,
+    });
+    it('no defender → floor = rate × captureRate cap', async () => {
+        const snap = buildSnap({ rate: 100000000n });
+        const bid = computeMinimumBidFromSnapshot(snap);
+        expect(bid.defenderBidStardust).toBe(0n);
+        // rate * captureRateBps / baseBps = 100M * 10500 / 10000 = 105M
+        expect(bid.minBidStardust).toBe(105000000n);
+        expect(bid.closenessFraction).toBe(0);
+    });
+    it('defender ATLAS bid raises floor above rate when bid > rate', async () => {
+        const snap = buildSnap({ rate: 100000000n, queuedBidAtlas: 200000000n });
+        const bid = computeMinimumBidFromSnapshot(snap);
+        expect(bid.defenderBidStardust).toBe(200000000n);
+        // base = max(rate, defender) = 200M, ramp at closeness=0 capped to 10500/10000 = 1.05x
+        expect(bid.minBidStardust).toBe(210000000n);
+    });
+    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 = computeMinimumBidFromSnapshot(snap, { nowSeconds: now });
+        // closeness = 50/100 = 0.5
+        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
+        expect(bid.minBidStardust).toBe(282500000n);
+    });
+    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 = computeMinimumBidFromSnapshot(snap, { nowSeconds: 1_000_000 });
+        const later = computeMinimumBidFromSnapshot(snap, { nowSeconds: 1_000_050 });
+        expect(now.closenessFraction).toBe(0);
+        expect(later.closenessFraction).toBeCloseTo(0.5, 5);
+        expect(later.minBidStardust).toBeGreaterThan(now.minBidStardust);
+    });
+});
+describe('resolveContractSnapshot', () => {
+    it('fetches fresh when no snapshot provided', async () => {
+        vi.mocked(fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vi.mocked(fetchContract).mockResolvedValue({
+            data: makeContract(),
+            address: CONTRACT_ADDR,
+        });
+        await resolveContractSnapshot({ contractAddress: CONTRACT_ADDR });
+        expect(fetchContract).toHaveBeenCalledTimes(1);
+    });
+    it('returns provided snapshot as-is when address matches and no staleness', async () => {
+        vi.mocked(fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vi.mocked(fetchContract).mockResolvedValue({
+            data: makeContract(),
+            address: CONTRACT_ADDR,
+        });
+        const snap = await getContractSnapshot({ contractAddress: CONTRACT_ADDR });
+        vi.clearAllMocks();
+        const resolved = await resolveContractSnapshot({
+            contractAddress: CONTRACT_ADDR,
+            snapshot: snap,
+        });
+        expect(resolved).toBe(snap);
+        expect(fetchContract).not.toHaveBeenCalled();
+    });
+    it('throws when snapshot contract address does not match', async () => {
+        vi.mocked(fetchConfig).mockResolvedValue({ data: makeConfig(), address: VAULT_ADDR });
+        vi.mocked(fetchContract).mockResolvedValue({ data: makeContract(), address: OTHER_ADDR });
+        const snap = await getContractSnapshot({ contractAddress: OTHER_ADDR });
+        await expect(resolveContractSnapshot({ contractAddress: CONTRACT_ADDR, snapshot: snap })).rejects.toThrow(/snapshot is for contract/);
+    });
+    it('lazy-refetches when snapshot is stale (pointer set, rental null)', async () => {
+        // First fetch: pointer set but rental fetch fails → snap.activeRental = null (stale)
+        vi.mocked(fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vi.mocked(fetchContract).mockResolvedValue({
+            data: makeContract({ activeRental: ACTIVE_ADDR }),
+            address: CONTRACT_ADDR,
+        });
+        vi.mocked(fetchRental).mockRejectedValueOnce(new Error('not found'));
+        const staleSnap = await getContractSnapshot({ contractAddress: CONTRACT_ADDR });
+        expect(staleSnap.activeRental).toBeNull();
+        // Refetch succeeds — rental now loads
+        vi.mocked(fetchRental).mockResolvedValueOnce({
+            data: makeRental(),
+            address: ACTIVE_ADDR,
+        });
+        const resolved = await resolveContractSnapshot({
+            contractAddress: CONTRACT_ADDR,
+            snapshot: staleSnap,
+        });
+        expect(resolved.activeRental).not.toBeNull();
+        // resolve called fetchContract once more for refetch
+        expect(fetchContract).toHaveBeenCalledTimes(2);
+    });
+    it('throws when still stale after lazy refetch', async () => {
+        vi.mocked(fetchConfig).mockResolvedValue({ data: makeConfig(), address: 'CFG' });
+        vi.mocked(fetchContract).mockResolvedValue({
+            data: makeContract({ activeRental: ACTIVE_ADDR }),
+            address: CONTRACT_ADDR,
+        });
+        vi.mocked(fetchRental).mockRejectedValue(new Error('not found'));
+        const staleSnap = await getContractSnapshot({ contractAddress: CONTRACT_ADDR });
+        await expect(resolveContractSnapshot({ contractAddress: CONTRACT_ADDR, snapshot: staleSnap })).rejects.toThrow(/could not be loaded after lazy refetch/);
+    });
+});
+//# sourceMappingURL=contractSnapshot.test.js.map

package/dist/esm/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/esm/utils/index.js

@@ -20,8 +20,10 @@ export { createRpc, setRpcDebug, isRpcDebugEnabled } from './rpc';
 export { fetchLookupTable, getLookupTableAddress, } from './lookupTable';
 // Rental Utilities
 export { hasActiveRental, hasQueuedRental } from './rental';
-// Bid Math
-export { computeMinimumBid, getMinimumBid } from './bidMath';
+// Bid Math (pure formula + type)
+export { computeMinimumBid } from './bidMath';
+// Contract Snapshot (aggregated one-shot fetch + derived bid)
+export { getContractSnapshot, resolveContractSnapshot, computeMinimumBidFromSnapshot, getMinimumBid, } from './contractSnapshot';
 // Discount Authorization
 export { createDiscount, deserializeDiscountAuth, } from './discountAuth';
 // Referrer (Affiliate MemberState) validation

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,gBAAgB,GAIjB,MAAM,UAAU,CAAC;AAElB,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GAKnB,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,wBAAwB;AACxB,OAAO,EACL,iBAAiB,EACjB,SAAS,GAIV,MAAM,UAAU,CAAC;AAElB,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAmC,MAAM,gBAAgB,CAAC;AAEtF,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAA0B,MAAM,qBAAqB,CAAC;AAEhF,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAElE,iCAAiC;AACjC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GAEtB,MAAM,eAAe,CAAC;AAEvB,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE5D,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAmB,MAAM,WAAW,CAAC;AAE9E,yBAAyB;AACzB,OAAO,EACL,cAAc,EACd,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,8CAA8C;AAC9C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,gBAAgB,GAIjB,MAAM,UAAU,CAAC;AAElB,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GAKnB,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,wBAAwB;AACxB,OAAO,EACL,iBAAiB,EACjB,SAAS,GAIV,MAAM,UAAU,CAAC;AAElB,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAmC,MAAM,gBAAgB,CAAC;AAEtF,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAA0B,MAAM,qBAAqB,CAAC;AAEhF,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAElE,iCAAiC;AACjC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GAEtB,MAAM,eAAe,CAAC;AAEvB,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE5D,iCAAiC;AACjC,OAAO,EAAE,iBAAiB,EAAmB,MAAM,WAAW,CAAC;AAE/D,8DAA8D;AAC9D,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,GAGd,MAAM,oBAAoB,CAAC;AAE5B,yBAAyB;AACzB,OAAO,EACL,cAAc,EACd,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,8CAA8C;AAC9C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/version.js

@@ -1,4 +1,4 @@
 // Auto-generated from package.json - DO NOT EDIT
 // Run "pnpm run generate:version" to update
-export const VERSION = '1.1.1';
+export const VERSION = '1.2.0';
 //# sourceMappingURL=version.js.map