@sly-rentals/core 0.1.0

package/dist/esm/audit/events.js

@@ -0,0 +1,267 @@
+/**
+ * Anchor event log parser for SRSLY audit events.
+ *
+ * Discriminators are read from the IDL (precomputed by Anchor's build).
+ * Borsh decoding is manual — no external borsh dependency needed.
+ */
+import { getAddressDecoder } from '@solana/kit';
+import idl from '../idl/srsly.json';
+/** Convert byte array to hex string */
+function toHex(bytes) {
+    return Array.from(bytes)
+        .map(b => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+// Build discriminator → event name map from IDL
+const DISC_MAP = new Map();
+for (const evt of idl.events ?? []) {
+    const hex = toHex(evt.discriminator);
+    DISC_MAP.set(hex, evt.name);
+}
+const addressDecoder = getAddressDecoder();
+/** Decode base64 string to Uint8Array (browser + Node compatible via atob) */
+function decodeBase64(str) {
+    const binary = atob(str);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+// ── Borsh deserialization helpers ──
+function readAddress(buf, offset) {
+    const bytes = buf.slice(offset, offset + 32);
+    const address = addressDecoder.decode(bytes);
+    return [address, offset + 32];
+}
+function readU64(buf, offset) {
+    const lo = buf.getUint32(offset, true);
+    const hi = buf.getUint32(offset + 4, true);
+    return [BigInt(lo) + (BigInt(hi) << 32n), offset + 8];
+}
+function readI64(buf, offset) {
+    const value = buf.getBigInt64(offset, true);
+    return [value, offset + 8];
+}
+function readU16(buf, offset) {
+    return [buf.getUint16(offset, true), offset + 2];
+}
+function readBool(buf, offset) {
+    return [buf.getUint8(offset) !== 0, offset + 1];
+}
+// ── Event decoders ──
+function decodeRentalAccepted(raw, dv, offset, slot, signature) {
+    let rentalState, contract, borrower;
+    let escrow, rate, serviceFee;
+    let feeBps;
+    let startTime, endTime;
+    [rentalState, offset] = readAddress(raw, offset);
+    [contract, offset] = readAddress(raw, offset);
+    [borrower, offset] = readAddress(raw, offset);
+    [escrow, offset] = readU64(dv, offset);
+    [rate, offset] = readU64(dv, offset);
+    [serviceFee, offset] = readU64(dv, offset);
+    [feeBps, offset] = readU16(dv, offset);
+    [startTime, offset] = readI64(dv, offset);
+    [endTime, offset] = readI64(dv, offset);
+    return {
+        type: 'RentalAccepted',
+        rentalState,
+        contract,
+        borrower,
+        escrow,
+        rate,
+        serviceFee,
+        feeBps,
+        startTime,
+        endTime,
+        slot,
+        signature,
+    };
+}
+function decodeRentalSettled(raw, dv, offset, slot, signature) {
+    let rentalState, contract;
+    let ownerEarned, escrowRemaining;
+    let isFinal;
+    [rentalState, offset] = readAddress(raw, offset);
+    [contract, offset] = readAddress(raw, offset);
+    [ownerEarned, offset] = readU64(dv, offset);
+    [escrowRemaining, offset] = readU64(dv, offset);
+    [isFinal, offset] = readBool(dv, offset);
+    return {
+        type: 'RentalSettled',
+        rentalState,
+        contract,
+        ownerEarned,
+        escrowRemaining,
+        isFinal,
+        slot,
+        signature,
+    };
+}
+function decodeRentalCancelled(raw, dv, offset, slot, signature) {
+    let rentalState, contract, borrower;
+    let ownerEarned, feeCollected, refund;
+    let newEndTime;
+    [rentalState, offset] = readAddress(raw, offset);
+    [contract, offset] = readAddress(raw, offset);
+    [borrower, offset] = readAddress(raw, offset);
+    [ownerEarned, offset] = readU64(dv, offset);
+    [feeCollected, offset] = readU64(dv, offset);
+    [refund, offset] = readU64(dv, offset);
+    [newEndTime, offset] = readI64(dv, offset);
+    return {
+        type: 'RentalCancelled',
+        rentalState,
+        contract,
+        borrower,
+        ownerEarned,
+        feeCollected,
+        refund,
+        newEndTime,
+        slot,
+        signature,
+    };
+}
+function decodeRentalClosed(raw, dv, offset, slot, signature) {
+    let rentalState, contract, borrower;
+    let ownerEarned, feeCollected, pointsAwarded;
+    [rentalState, offset] = readAddress(raw, offset);
+    [contract, offset] = readAddress(raw, offset);
+    [borrower, offset] = readAddress(raw, offset);
+    [ownerEarned, offset] = readU64(dv, offset);
+    [feeCollected, offset] = readU64(dv, offset);
+    [pointsAwarded, offset] = readU64(dv, offset);
+    return {
+        type: 'RentalClosed',
+        rentalState,
+        contract,
+        borrower,
+        ownerEarned,
+        feeCollected,
+        pointsAwarded,
+        slot,
+        signature,
+    };
+}
+function decodeOwnerPaid(raw, dv, offset, slot, signature) {
+    let contract, owner;
+    let amount;
+    [contract, offset] = readAddress(raw, offset);
+    [owner, offset] = readAddress(raw, offset);
+    [amount, offset] = readU64(dv, offset);
+    return {
+        type: 'OwnerPaid',
+        contract,
+        owner,
+        amount,
+        slot,
+        signature,
+    };
+}
+function decodeFeesPaid(raw, dv, offset, slot, signature) {
+    let contract;
+    let feeCollected, discount;
+    let discountBps;
+    [contract, offset] = readAddress(raw, offset);
+    [feeCollected, offset] = readU64(dv, offset);
+    [discount, offset] = readU64(dv, offset);
+    [discountBps, offset] = readU16(dv, offset);
+    return {
+        type: 'FeesPaid',
+        contract,
+        feeCollected,
+        discount,
+        discountBps,
+        slot,
+        signature,
+    };
+}
+// Sanity check: timestamps should be between 2024 and 2030
+const MIN_TS = 1704067200n; // 2024-01-01
+const MAX_TS = 1893456000n; // 2030-01-01
+function isPlausibleEvent(event) {
+    if (event.type === 'RentalAccepted') {
+        return (event.startTime >= MIN_TS &&
+            event.startTime <= MAX_TS &&
+            event.endTime >= MIN_TS &&
+            event.endTime <= MAX_TS &&
+            event.endTime > event.startTime);
+    }
+    if (event.type === 'RentalCancelled') {
+        return event.newEndTime >= MIN_TS && event.newEndTime <= MAX_TS;
+    }
+    // For other events, check amounts aren't astronomically large (> 1 trillion stardust = 10k ATLAS)
+    if (event.type === 'RentalSettled') {
+        return event.ownerEarned < 1000000000000000n;
+    }
+    return true;
+}
+const DECODERS = {
+    RentalAccepted: decodeRentalAccepted,
+    RentalSettled: decodeRentalSettled,
+    RentalCancelled: decodeRentalCancelled,
+    RentalClosed: decodeRentalClosed,
+    OwnerPaid: decodeOwnerPaid,
+    FeesPaid: decodeFeesPaid,
+};
+/**
+ * Parse Anchor events from transaction log messages.
+ *
+ * Anchor emits events as `Program data: <base64>` log lines where the data
+ * starts with an 8-byte discriminator followed by borsh-serialized fields.
+ *
+ * Discriminators are matched against the IDL — no runtime hashing needed.
+ */
+export function parseAnchorEvents(logs, programId, slot, signature) {
+    const events = [];
+    // Track execution context as a stack of program IDs.
+    // `Program data:` lines belong to the program on top of the stack.
+    // This correctly handles CPI chains (thread → SRSLY → token → ...).
+    const execStack = [];
+    const invokeRe = /^Program (\w+) invoke \[(\d+)\]$/;
+    for (const log of logs) {
+        const invokeMatch = log.match(invokeRe);
+        if (invokeMatch) {
+            execStack.push(invokeMatch[1]);
+            continue;
+        }
+        if (log.startsWith('Program ') && (log.endsWith(' success') || log.endsWith(' failed'))) {
+            execStack.pop();
+            continue;
+        }
+        // Only parse `Program data:` when our program is on top of the stack
+        const currentProgram = execStack[execStack.length - 1];
+        if (currentProgram !== programId || !log.startsWith('Program data: '))
+            continue;
+        const base64Data = log.slice('Program data: '.length);
+        let raw;
+        try {
+            raw = decodeBase64(base64Data);
+        }
+        catch {
+            continue;
+        }
+        if (raw.length < 8)
+            continue;
+        const discHex = toHex(raw.slice(0, 8));
+        const eventName = DISC_MAP.get(discHex);
+        if (!eventName)
+            continue;
+        const decoder = DECODERS[eventName];
+        if (!decoder)
+            continue;
+        try {
+            const dv = new DataView(raw.buffer, raw.byteOffset, raw.byteLength);
+            const event = decoder(raw, dv, 8, slot, signature);
+            // Validate: reject events from old program versions with mismatched layouts
+            if (!isPlausibleEvent(event))
+                continue;
+            events.push(event);
+        }
+        catch {
+            // Skip malformed events
+        }
+    }
+    return events;
+}
+//# sourceMappingURL=events.js.map

package/dist/esm/audit/events.js.map

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

package/dist/esm/audit/index.js

@@ -0,0 +1,3 @@
+export { fetchContractAudit } from './audit';
+export { parseAnchorEvents } from './events';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/audit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/audit/types.js

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

package/dist/esm/audit/types.js.map

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

package/dist/esm/cost/constants.js

@@ -0,0 +1,31 @@
+/**
+ * @purpose Cost-related constants shared across SDK modules.
+ *
+ * Single source of truth for thread funding, execution budgets, and per-tx fees.
+ * Mirrors on-chain constants in `rust/programs/srsly/src/instructions/contract_thread.rs`.
+ */
+/**
+ * Infrastructure base auto-added by the SDK when creating a contract thread.
+ * Covers thread rent + 3 fiber rents (~0.034 SOL) plus a ~0.006 SOL buffer.
+ *
+ * On-chain minimum: `rust/programs/srsly/src/instructions/contract_thread.rs:119`.
+ */
+export const MINIMUM_THREAD_FUNDING = 40000000n;
+/**
+ * Default execution budget for contract thread ticks when caller does not
+ * specify one. 0.00219 SOL funds ~365 ticks at 0.000006 SOL each
+ * (≈1 year of daily cron executions).
+ */
+export const DEFAULT_EXECUTION_BUDGET = 2190000n;
+/** Solana base transaction fee in lamports (5_000 per signature). */
+export const TX_BASE_FEE_LAMPORTS = 5000n;
+/**
+ * Cost per thread tick in lamports.
+ * 5_000 (Solana base) + 1_000 (Antegen commission) = 6_000.
+ */
+export const PER_TICK_LAMPORTS = 6000n;
+/** Seconds in a day — used for pro-rata rental amount math. */
+export const SECONDS_PER_DAY = 86400n;
+/** Fixed size of an SPL associated token account. */
+export const SPL_ATA_SIZE = 165;
+//# sourceMappingURL=constants.js.map

package/dist/esm/cost/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/cost/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAW,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAU,CAAC;AAEnD,qEAAqE;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAM,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAM,CAAC;AAExC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAO,CAAC;AAEvC,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC"}

package/dist/esm/cost/estimate.js

@@ -0,0 +1,117 @@
+/**
+ * @purpose SOL + ATLAS cost estimators for SRSLY protocol usage.
+ *
+ * Three quotes:
+ * - Owner setup (contract_create + contract_thread) — recoverable rents + infra + exec budget.
+ * - Borrower setup (borrower_create) — BorrowerState + managed ATA.
+ * - Per-rental (rental_accept) — SOL tx fee + ATLAS escrow + service fee.
+ *
+ * All functions use `rpc.getMinimumBalanceForRentExemption` so quotes reflect the
+ * target cluster's rent rate rather than hardcoded lamports.
+ */
+import { fetchContract } from '../accounts/contract';
+import { fetchConfig } from '../accounts/config';
+import { getRpcUrl } from '../utils/config';
+import { createRpc } from '../utils/rpc';
+import { convertSol } from '../params/sol';
+import { CONTRACT_STATE_SIZE, RENTAL_STATE_SIZE, BORROWER_STATE_SIZE } from './sizes';
+import { MINIMUM_THREAD_FUNDING, DEFAULT_EXECUTION_BUDGET, TX_BASE_FEE_LAMPORTS, PER_TICK_LAMPORTS, SECONDS_PER_DAY, SPL_ATA_SIZE, } from './constants';
+async function minBalance(rpcUrl, size) {
+    const rpc = createRpc(rpcUrl ?? getRpcUrl());
+    const response = await rpc.getMinimumBalanceForRentExemption(BigInt(size)).send();
+    return BigInt(response);
+}
+export async function estimateOwnerSetupCost(opts = {}) {
+    const executionBudget = opts.executionBudget === undefined
+        ? DEFAULT_EXECUTION_BUDGET
+        : convertSol(opts.executionBudget);
+    const [contractState, rentalState, ataRent] = await Promise.all([
+        minBalance(opts.rpcUrl, CONTRACT_STATE_SIZE),
+        minBalance(opts.rpcUrl, RENTAL_STATE_SIZE),
+        minBalance(opts.rpcUrl, SPL_ATA_SIZE),
+    ]);
+    const ownerAta = opts.ownerAtaExists ? 0n : ataRent;
+    const rentLamports = contractState + rentalState + rentalState + ataRent + ownerAta;
+    const threadLamports = MINIMUM_THREAD_FUNDING + executionBudget;
+    const txFees = TX_BASE_FEE_LAMPORTS * 2n; // contract_create + contract_thread
+    return {
+        rentLamports,
+        threadLamports,
+        txFees,
+        total: rentLamports + threadLamports + txFees,
+        breakdown: {
+            contractState,
+            rentalStateActive: rentalState,
+            rentalStateQueued: rentalState,
+            contractAta: ataRent,
+            ownerAta,
+            threadInfraBase: MINIMUM_THREAD_FUNDING,
+            executionBudget,
+        },
+    };
+}
+export async function estimateBorrowerSetupCost(rpcUrl) {
+    const [borrowerState, managedAta] = await Promise.all([
+        minBalance(rpcUrl, BORROWER_STATE_SIZE),
+        minBalance(rpcUrl, SPL_ATA_SIZE),
+    ]);
+    const rentLamports = borrowerState + managedAta;
+    const txFees = TX_BASE_FEE_LAMPORTS;
+    return {
+        rentLamports,
+        txFees,
+        total: rentLamports + txFees,
+        breakdown: { borrowerState, managedAta },
+    };
+}
+/**
+ * Quote the ATLAS cost a borrower will pay for a given rate + duration.
+ * Pure helper — does not build a transaction.
+ */
+export async function estimateRentalCost(params) {
+    const [{ data: contract }, { data: config }] = await Promise.all([
+        fetchContract(params.contract, params.rpcUrl),
+        fetchConfig(params.rpcUrl),
+    ]);
+    const duration = BigInt(params.durationSeconds);
+    const stardustToAtlas = BigInt(config.stardustToAtlas);
+    const rate = BigInt(contract.rate);
+    // Mirror on-chain scaling: rate <1 ATLAS is treated as ATLAS-denominated.
+    const rateStardust = rate < stardustToAtlas ? saturatingMul(rate, stardustToAtlas) : rate;
+    const atlasEscrow = saturatingDiv(saturatingMul(rateStardust, duration), SECONDS_PER_DAY);
+    const feeBps = BigInt(config.serviceFeeBps);
+    const baseBps = BigInt(config.baseBps);
+    const atlasServiceFee = baseBps === 0n ? 0n : saturatingDiv(saturatingMul(atlasEscrow, feeBps), baseBps);
+    const atlasBid = params.bidStardust ?? 0n;
+    return {
+        solTxFees: TX_BASE_FEE_LAMPORTS,
+        atlasEscrow,
+        atlasServiceFee,
+        atlasBid,
+        atlasTotal: atlasEscrow + atlasBid,
+        serviceFeeBps: Number(feeBps),
+    };
+}
+/* -------------------------------------------------------------------------- */
+/*                                Thread burn                                 */
+/* -------------------------------------------------------------------------- */
+/**
+ * Lamports burned by a given number of cron ticks at `PER_TICK_LAMPORTS` each.
+ * Useful for sizing a custom `executionBudget` before calling
+ * `estimateOwnerSetupCost`.
+ */
+export function tickBudget(ticks) {
+    return BigInt(ticks) * PER_TICK_LAMPORTS;
+}
+/* -------------------------------------------------------------------------- */
+/*                               u64 helpers                                  */
+/* -------------------------------------------------------------------------- */
+const MAX_U64 = 18446744073709551615n;
+function saturatingMul(a, b) {
+    const product = a * b;
+    return product > MAX_U64 ? MAX_U64 : product;
+}
+function saturatingDiv(a, b) {
+    return b === 0n ? 0n : a / b;
+}
+//# sourceMappingURL=estimate.js.map

package/dist/esm/cost/estimate.js.map

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

package/dist/esm/cost/estimate.test.js

@@ -0,0 +1,143 @@
+import { describe, expect, it, vi } from 'vitest';
+vi.mock('../accounts/contract', () => ({
+    fetchContract: vi.fn(),
+}));
+vi.mock('../accounts/config', () => ({
+    fetchConfig: vi.fn(),
+}));
+vi.mock('../utils/rpc', () => ({
+    createRpc: vi.fn(() => ({
+        getMinimumBalanceForRentExemption: (size) => ({
+            // Solana rent formula constants: ACCOUNT_STORAGE_OVERHEAD=128,
+            // lamports_per_byte_year=3_480, exemption_threshold=2 years.
+            send: async () => {
+                const bytes = Number(size) + 128;
+                return BigInt(bytes * 3_480 * 2);
+            },
+        }),
+    })),
+}));
+vi.mock('../utils/config', () => ({
+    getRpcUrl: () => 'http://localhost:8899',
+}));
+import { fetchContract } from '../accounts/contract';
+import { fetchConfig } from '../accounts/config';
+import { estimateOwnerSetupCost, estimateBorrowerSetupCost, estimateRentalCost, tickBudget, } from './estimate';
+import { MINIMUM_THREAD_FUNDING, DEFAULT_EXECUTION_BUDGET, TX_BASE_FEE_LAMPORTS, PER_TICK_LAMPORTS, } from './constants';
+import { CONTRACT_STATE_SIZE, RENTAL_STATE_SIZE, BORROWER_STATE_SIZE } from './sizes';
+import { SPL_ATA_SIZE } from './constants';
+// Rent formula used by our mock — matches Solana mainnet rent-exemption math.
+const rentFor = (size) => BigInt((size + 128) * 3_480 * 2);
+describe('estimateOwnerSetupCost', () => {
+    it('baseline matches COSTS.md breakdown', async () => {
+        const quote = await estimateOwnerSetupCost();
+        const contractStateRent = rentFor(CONTRACT_STATE_SIZE);
+        const rentalStateRent = rentFor(RENTAL_STATE_SIZE);
+        const ataRent = rentFor(SPL_ATA_SIZE);
+        expect(quote.breakdown.contractState).toBe(contractStateRent);
+        expect(quote.breakdown.rentalStateActive).toBe(rentalStateRent);
+        expect(quote.breakdown.rentalStateQueued).toBe(rentalStateRent);
+        expect(quote.breakdown.contractAta).toBe(ataRent);
+        expect(quote.breakdown.ownerAta).toBe(ataRent);
+        expect(quote.breakdown.threadInfraBase).toBe(MINIMUM_THREAD_FUNDING);
+        expect(quote.breakdown.executionBudget).toBe(DEFAULT_EXECUTION_BUDGET);
+        expect(quote.rentLamports).toBe(contractStateRent + rentalStateRent * 2n + ataRent + ataRent);
+        expect(quote.threadLamports).toBe(MINIMUM_THREAD_FUNDING + DEFAULT_EXECUTION_BUDGET);
+        expect(quote.txFees).toBe(TX_BASE_FEE_LAMPORTS * 2n);
+        expect(quote.total).toBe(quote.rentLamports + quote.threadLamports + quote.txFees);
+    });
+    it('ownerAtaExists skips owner ATA rent', async () => {
+        const with_ = await estimateOwnerSetupCost();
+        const without = await estimateOwnerSetupCost({ ownerAtaExists: true });
+        const ataRent = rentFor(SPL_ATA_SIZE);
+        expect(with_.total - without.total).toBe(ataRent);
+        expect(without.breakdown.ownerAta).toBe(0n);
+    });
+    it('custom executionBudget flows through to thread funding', async () => {
+        const quote = await estimateOwnerSetupCost({ executionBudget: { sol: 0.01 } });
+        expect(quote.breakdown.executionBudget).toBe(10000000n);
+        expect(quote.threadLamports).toBe(MINIMUM_THREAD_FUNDING + 10000000n);
+    });
+});
+describe('estimateBorrowerSetupCost', () => {
+    it('sums BorrowerState + managed ATA rent + tx fee', async () => {
+        const quote = await estimateBorrowerSetupCost();
+        const borrowerStateRent = rentFor(BORROWER_STATE_SIZE);
+        const ataRent = rentFor(SPL_ATA_SIZE);
+        expect(quote.breakdown.borrowerState).toBe(borrowerStateRent);
+        expect(quote.breakdown.managedAta).toBe(ataRent);
+        expect(quote.rentLamports).toBe(borrowerStateRent + ataRent);
+        expect(quote.txFees).toBe(TX_BASE_FEE_LAMPORTS);
+        expect(quote.total).toBe(borrowerStateRent + ataRent + TX_BASE_FEE_LAMPORTS);
+    });
+});
+describe('estimateRentalCost', () => {
+    const mockContract = (rate) => ({
+        data: { rate },
+        address: 'Contract11111111111111111111111111111111111',
+    });
+    const mockConfig = (overrides = {}) => ({
+        data: {
+            stardustToAtlas: 100000000n,
+            serviceFeeBps: 1000n,
+            baseBps: 10_000,
+            ...overrides,
+        },
+        address: 'Config1111111111111111111111111111111111111',
+    });
+    it('1 ATLAS/day × 86400s yields 100M Stardust escrow, 10M service fee', async () => {
+        vi.mocked(fetchContract).mockResolvedValue(mockContract(1n));
+        vi.mocked(fetchConfig).mockResolvedValue(mockConfig());
+        const quote = await estimateRentalCost({
+            contract: 'AnyContract',
+            durationSeconds: 86400n,
+        });
+        expect(quote.atlasEscrow).toBe(100000000n);
+        expect(quote.atlasServiceFee).toBe(10000000n);
+        expect(quote.atlasBid).toBe(0n);
+        expect(quote.atlasTotal).toBe(100000000n);
+        expect(quote.serviceFeeBps).toBe(1_000);
+        expect(quote.solTxFees).toBe(TX_BASE_FEE_LAMPORTS);
+    });
+    it('rate in Stardust units (rate >= stardustToAtlas) is not rescaled', async () => {
+        // 5 ATLAS/day already in Stardust = 500M.
+        vi.mocked(fetchContract).mockResolvedValue(mockContract(500000000n));
+        vi.mocked(fetchConfig).mockResolvedValue(mockConfig());
+        const quote = await estimateRentalCost({
+            contract: 'AnyContract',
+            durationSeconds: 86400n * 3n, // 3 days
+        });
+        expect(quote.atlasEscrow).toBe(1500000000n);
+    });
+    it('pro-rates sub-day durations via integer division', async () => {
+        vi.mocked(fetchContract).mockResolvedValue(mockContract(1n));
+        vi.mocked(fetchConfig).mockResolvedValue(mockConfig());
+        // Half a day -> 50M Stardust.
+        const quote = await estimateRentalCost({
+            contract: 'AnyContract',
+            durationSeconds: 43200n,
+        });
+        expect(quote.atlasEscrow).toBe(50000000n);
+        expect(quote.atlasServiceFee).toBe(5000000n);
+    });
+    it('bidStardust flows into atlasTotal but not into atlasEscrow', async () => {
+        vi.mocked(fetchContract).mockResolvedValue(mockContract(1n));
+        vi.mocked(fetchConfig).mockResolvedValue(mockConfig());
+        const quote = await estimateRentalCost({
+            contract: 'AnyContract',
+            durationSeconds: 86400n,
+            bidStardust: 25000000n,
+        });
+        expect(quote.atlasEscrow).toBe(100000000n);
+        expect(quote.atlasBid).toBe(25000000n);
+        expect(quote.atlasTotal).toBe(125000000n);
+    });
+});
+describe('tickBudget', () => {
+    it('scales by PER_TICK_LAMPORTS', () => {
+        expect(tickBudget(365)).toBe(365n * PER_TICK_LAMPORTS);
+        expect(tickBudget(0)).toBe(0n);
+        expect(tickBudget(1000000n)).toBe(1000000n * PER_TICK_LAMPORTS);
+    });
+});
+//# sourceMappingURL=estimate.test.js.map

package/dist/esm/cost/estimate.test.js.map

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

package/dist/esm/cost/index.js

@@ -0,0 +1,4 @@
+export * from './constants';
+export * from './sizes';
+export * from './estimate';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cost/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/dist/esm/cost/sizes.js

@@ -0,0 +1,18 @@
+/**
+ * @purpose Account data sizes (including 8-byte Anchor discriminator).
+ *
+ * These match `8 + InitSpace` on the Rust side and determine rent-exemption
+ * lamports via `rpc.getMinimumBalanceForRentExemption(size)`.
+ *
+ * Source of truth: `rust/programs/srsly/src/state/*.rs` — structs with
+ * `#[derive(InitSpace)]`. Keep in sync when account layouts change.
+ */
+/** ContractState — `state/contract.rs` */
+export const CONTRACT_STATE_SIZE = 638;
+/** RentalState — `state/rental.rs` (two instances per contract: active + queued) */
+export const RENTAL_STATE_SIZE = 426;
+/** BorrowerState — `state/borrower.rs` (Vec<Pubkey> max_len 10) */
+export const BORROWER_STATE_SIZE = 423;
+/** ConfigState — `state/config.rs` */
+export const CONFIG_STATE_SIZE = 468;
+//# sourceMappingURL=sizes.js.map

package/dist/esm/cost/sizes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sizes.js","sourceRoot":"","sources":["../../../src/cost/sizes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,oFAAoF;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,mEAAmE;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,sCAAsC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC"}