@sly-rentals/core 5.5.2 → 6.1.0

package/dist/esm/legacy/closeContract.test.js

@@ -0,0 +1,105 @@
+/**
+ * The legacy subpath only converts: one instruction in, one out, in order. A
+ * duplicate here would be invisible at the call site and land two identical
+ * `rental_close` instructions in one transaction.
+ */
+import { describe, expect, it, vi, beforeEach } from 'vitest';
+vi.mock('../utils/contractSnapshot', () => ({
+    resolveContractSnapshot: vi.fn(),
+}));
+vi.mock('../instructions/closeRental', () => ({
+    closeRental: vi.fn(),
+}));
+import { resolveContractSnapshot } from '../utils/contractSnapshot';
+import { closeRental } from '../instructions/closeRental';
+import { closeContract, setSdkConfig } from './index';
+import { CLOSE_CONTRACT_DISCRIMINATOR } from '../generated/codama/instructions/closeContract';
+const SYSTEM = '11111111111111111111111111111111';
+const CONTRACT_ADDR = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
+const ACTIVE_ADDR = 'So11111111111111111111111111111111111111112';
+const OWNER_ADDR = 'BPFLoader2111111111111111111111111111111111';
+const MINT_ADDR = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
+/** Minimal stand-in for web3.js PublicKey — `toLegacy` only stringifies. */
+class StubPublicKey {
+    value;
+    constructor(value) {
+        this.value = String(value);
+    }
+    toString() {
+        return this.value;
+    }
+}
+const OWNER_SIGNER = {
+    address: OWNER_ADDR,
+    signTransactionMessage: vi.fn(),
+};
+/** Marker for the instruction `closeContract` folds in from `closeRental`. */
+const RENTAL_MARKER = new Uint8Array([0xaa, 0xbb, 0xcc, 0xdd]);
+/** Expired active rental, no queued reservation, thread already gone. */
+function mockExpiredActiveNoThread() {
+    vi.mocked(resolveContractSnapshot).mockResolvedValue({
+        config: {
+            data: { atlasMint: MINT_ADDR, slyvault: MINT_ADDR },
+            address: 'CFG',
+        },
+        contract: {
+            data: {
+                owner: OWNER_ADDR,
+                fleet: MINT_ADDR,
+                gameId: MINT_ADDR,
+                activeRental: ACTIVE_ADDR,
+                queuedRental: SYSTEM,
+                thread: SYSTEM,
+                managedTokenAccount: MINT_ADDR,
+            },
+            address: CONTRACT_ADDR,
+        },
+        activeRental: {
+            data: {
+                borrower: OWNER_ADDR,
+                borrowerProfile: MINT_ADDR,
+                endTime: 1n,
+            },
+            address: ACTIVE_ADDR,
+        },
+        queuedRental: null,
+        nowSeconds: 1_700_000_000,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    });
+    vi.mocked(closeRental).mockResolvedValue({
+        instructions: [{ programAddress: CONTRACT_ADDR, accounts: [], data: RENTAL_MARKER }],
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    });
+}
+beforeEach(() => {
+    vi.clearAllMocks();
+    setSdkConfig({ PublicKey: StubPublicKey });
+});
+describe('legacy closeContract — conversion does not duplicate', () => {
+    it('builds the underlying rental close exactly once', async () => {
+        mockExpiredActiveNoThread();
+        await closeContract({ owner: OWNER_SIGNER, contract: CONTRACT_ADDR });
+        expect(closeRental).toHaveBeenCalledTimes(1);
+    });
+    it('returns one legacy instruction per kit instruction, in order', async () => {
+        mockExpiredActiveNoThread();
+        const ixs = await closeContract({ owner: OWNER_SIGNER, contract: CONTRACT_ADDR });
+        const startsWith = (data, prefix) => prefix.every((b, i) => data[i] === b);
+        expect(ixs).toHaveLength(2);
+        expect(startsWith(ixs[0].data, RENTAL_MARKER)).toBe(true);
+        expect(startsWith(ixs[1].data, CLOSE_CONTRACT_DISCRIMINATOR)).toBe(true);
+    });
+    it('converts to web3.js shape without cloning entries', async () => {
+        mockExpiredActiveNoThread();
+        const ixs = await closeContract({ owner: OWNER_SIGNER, contract: CONTRACT_ADDR });
+        // Every entry carries a PublicKey-shaped programId and a keys array —
+        // the legacy contract — and there are no repeats of the same data buffer.
+        const seen = ixs.map(ix => String(ix.programId) + ':' + Array.from(ix.data).join());
+        expect(new Set(seen).size).toBe(ixs.length);
+        for (const ix of ixs) {
+            expect(ix.programId).toBeInstanceOf(StubPublicKey);
+            expect(Array.isArray(ix.keys)).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=closeContract.test.js.map

package/dist/esm/legacy/closeContract.test.js.map

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

package/dist/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sly-rentals/core",
-  "version": "5.5.2",
+  "version": "6.1.0",
   "description": "TypeScript SDK for SRSLY",
   "sideEffects": false,
   "publishConfig": {

package/dist/esm/utils/fibers.js

@@ -3,33 +3,29 @@
  */
 import { AccountRole } from '@solana/kit';
 import { deriveFiber } from '../pda/thread';
-import { createRpc } from './rpc';
 /**
  * The fiber accounts a close instruction should carry, given what a thread
- * tracks.
+ * tracks: one per entry in `fiber_ids`, whether or not the account it names
+ * still exists.
  *
  * `fiber_ids` records the indices a thread *tracks*, and nothing on chain
  * keeps that list in agreement with the accounts it names — a fiber account
  * can be closed out from under a thread that still lists it, which is what
  * the 2026-08-26 rent sweep did to 623 of them.
  *
- * Passing an index whose account is gone makes the fiber program deserialize
- * an empty buffer and fail with `InvalidFiberData`, from the `buf.len() < 8`
- * branch rather than the discriminator one. It reads like a schema problem
- * and is not one, and no caller can work around it, so a contract tracking a
- * destroyed fiber becomes impossible to close by anyone.
+ * Reconciling the two is the thread program's job, not ours. It is the only
+ * participant that can see the list and the accounts *and* edit the list;
+ * dropping an index here asserts it needs no accounting for, which is not
+ * ours to assert and which `thread_close` rejects — it requires every tracked
+ * id to be accounted for and fails with `MissingFiberAccounts` otherwise.
+ * Passing the account is how an id whose account is gone gets accounted for.
  *
- * A tracked-but-absent fiber has nothing to close, so dropping it is the
- * whole remedy. One `getMultipleAccounts` for the batch.
+ * Deriving an address is pure computation, so this needs no RPC.
  */
-export async function existingFiberAccounts(thread, fiberIds, rpcUrl) {
+export async function trackedFiberAccounts(thread, fiberIds) {
     if (!fiberIds.length)
         return [];
     const addresses = await Promise.all(fiberIds.map(id => deriveFiber(thread, id)));
-    const rpc = createRpc(rpcUrl);
-    const { value } = await rpc.getMultipleAccounts(addresses, { encoding: 'base64' }).send();
-    return addresses
-        .filter((_, i) => value[i] !== null)
-        .map(address => ({ address, role: AccountRole.WRITABLE }));
+    return addresses.map(address => ({ address, role: AccountRole.WRITABLE }));
 }
 //# sourceMappingURL=fibers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"fibers.js","sourceRoot":"","sources":["../../../src/utils/fibers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAe,EACf,QAAkB,EAClB,MAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1F,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;SACnC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,QAAiB,EAAE,CAAC,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"fibers.js","sourceRoot":"","sources":["../../../src/utils/fibers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAe,EACf,QAAkB;IAElB,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAEjF,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,QAAiB,EAAE,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/esm/utils/fibers.test.js

@@ -1,49 +1,42 @@
 import { describe, expect, it, vi, beforeEach } from 'vitest';
 import { AccountRole } from '@solana/kit';
-vi.mock('./rpc', () => ({ createRpc: vi.fn() }));
 vi.mock('../pda/thread', () => ({ deriveFiber: vi.fn() }));
-import { createRpc } from './rpc';
 import { deriveFiber } from '../pda/thread';
-import { existingFiberAccounts } from './fibers';
+import { trackedFiberAccounts } from './fibers';
 const THREAD = 'Sysvar1nstructions1111111111111111111111111';
 const FIBER_0 = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
 const FIBER_1 = 'So11111111111111111111111111111111111111112';
-/** `getMultipleAccounts` returns `null` in the slot of an account that does not exist. */
-function mockAccounts(value) {
-    const send = vi.fn().mockResolvedValue({ value });
-    vi.mocked(createRpc).mockReturnValue({
-        getMultipleAccounts: vi.fn().mockReturnValue({ send }),
-    });
-    return send;
-}
 beforeEach(() => {
     vi.clearAllMocks();
     vi.mocked(deriveFiber).mockImplementation(async (_thread, index) => index === 0 ? FIBER_0 : FIBER_1);
 });
-describe('existingFiberAccounts', () => {
-    it('drops a tracked fiber whose account is gone', async () => {
+describe('trackedFiberAccounts', () => {
+    it('carries a tracked fiber whose account is gone', async () => {
         // The state the 2026-08-26 rent sweep left behind: the thread still tracks
-        // both indices, but fiber 1's account was closed. Passing it makes the
-        // fiber program deserialize an empty buffer and fail with
-        // `InvalidFiberData`, which no caller can work around.
-        mockAccounts([{ lamports: 9416880n }, null]);
-        const accounts = await existingFiberAccounts(THREAD, [0, 1], 'https://rpc.example');
-        expect(accounts).toEqual([{ address: FIBER_0, role: AccountRole.WRITABLE }]);
+        // both indices, but fiber 1's account was closed. The id has to be
+        // accounted for or `thread_close` fails with `MissingFiberAccounts`, and
+        // passing the account is the only way to account for it — dropping the id
+        // is the thread program's call, and only it can edit `fiber_ids`.
+        const accounts = await trackedFiberAccounts(THREAD, [0, 1]);
+        expect(accounts).toEqual([
+            { address: FIBER_0, role: AccountRole.WRITABLE },
+            { address: FIBER_1, role: AccountRole.WRITABLE },
+        ]);
     });
-    it('keeps every fiber when all of them exist', async () => {
-        mockAccounts([{ lamports: 1n }, { lamports: 1n }]);
-        const accounts = await existingFiberAccounts(THREAD, [0, 1], 'https://rpc.example');
+    it('carries every fiber when all of them exist', async () => {
+        const accounts = await trackedFiberAccounts(THREAD, [0, 1]);
         expect(accounts.map(a => a.address)).toEqual([FIBER_0, FIBER_1]);
     });
-    it('returns nothing when the thread tracks nothing, without an RPC call', async () => {
-        const send = mockAccounts([]);
-        const accounts = await existingFiberAccounts(THREAD, [], 'https://rpc.example');
+    it('returns nothing when the thread tracks nothing', async () => {
+        const accounts = await trackedFiberAccounts(THREAD, []);
         expect(accounts).toEqual([]);
-        expect(send).not.toHaveBeenCalled();
+        expect(deriveFiber).not.toHaveBeenCalled();
     });
-    it('drops every fiber when none survive', async () => {
-        mockAccounts([null, null]);
-        expect(await existingFiberAccounts(THREAD, [0, 1], 'https://rpc.example')).toEqual([]);
+    it('reads no account state, so it needs no RPC', async () => {
+        // Existence is not consulted at all — the addresses are pure computation
+        // from the thread and the ids.
+        await trackedFiberAccounts(THREAD, [0, 1]);
+        expect(deriveFiber).toHaveBeenCalledTimes(2);
     });
 });
 //# sourceMappingURL=fibers.test.js.map

package/dist/esm/utils/fibers.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"fibers.test.js","sourceRoot":"","sources":["../../../src/utils/fibers.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fibers.test.js","sourceRoot":"","sources":["../../../src/utils/fibers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AAExD,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,GAAG,6CAAwD,CAAC;AACxE,MAAM,OAAO,GAAG,8CAAyD,CAAC;AAC1E,MAAM,OAAO,GAAG,6CAAwD,CAAC;AAEzE,UAAU,CAAC,GAAG,EAAE;IACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACnB,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CACjE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAChC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,2EAA2E;QAC3E,mEAAmE;QACnE,yEAAyE;QACzE,0EAA0E;QAC1E,kEAAkE;QAClE,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE5D,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAChD,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;SACjD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE5D,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAExD,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,yEAAyE;QACzE,+BAA+B;QAC/B,MAAM,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE3C,MAAM,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/esm/utils/rpc.js

@@ -49,4 +49,45 @@ export function createRpc(rpcUrl) {
     }
     return createSolanaRpc(rpcUrl);
 }
+/** Largest account list `getMultipleAccounts` accepts in one request. */
+export const MAX_MULTIPLE_ACCOUNTS = 100;
+/** Providers signal "slow down" as 429, and the wording varies by host. */
+function isRateLimited(error) {
+    const e = error;
+    if (e?.statusCode === 429 || e?.status === 429)
+        return true;
+    const message = String(e?.message ?? error);
+    return message.includes('429') || /too many requests/i.test(message);
+}
+const delay = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+/**
+ * Run an RPC call, backing off and retrying when the provider rate-limits it.
+ *
+ * A 429 is not a result — it means the question was never asked, so a caller
+ * that treats it as one reports on state it never read. Backoff is exponential
+ * with jitter so workers that trip the limit together do not retry together.
+ *
+ * @param send - Performs the call. Invoked again on each retry.
+ * @param options.retries - Extra attempts after the first. Defaults to 5.
+ * @param options.baseDelayMs - Delay before the first retry. Defaults to 250.
+ * @throws The last error, once retries are exhausted or it is not a 429.
+ */
+export async function sendWithRetry(send, options = {}) {
+    const retries = options.retries ?? 5;
+    const baseDelayMs = options.baseDelayMs ?? 250;
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            return await send();
+        }
+        catch (error) {
+            lastError = error;
+            if (!isRateLimited(error) || attempt === retries)
+                throw error;
+            const backoff = baseDelayMs * 2 ** attempt;
+            await delay(backoff + Math.floor(Math.random() * backoff));
+        }
+    }
+    throw lastError;
+}
 //# sourceMappingURL=rpc.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../src/utils/rpc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAC;AAE3E,0DAA0D;AAC1D,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,SAAS,GAAG,OAAO,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,wCAAwC,EAAE;YACpD,GAAG,EAAE,MAAM;YACX,WAAW,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YAC/D,SAAS,EAAE,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;SAC1E,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../src/utils/rpc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAC;AAE3E,0DAA0D;AAC1D,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,SAAS,GAAG,OAAO,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,wCAAwC,EAAE;YACpD,GAAG,EAAE,MAAM;YACX,WAAW,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YAC/D,SAAS,EAAE,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;SAC1E,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,2EAA2E;AAC3E,SAAS,aAAa,CAAC,KAAc;IACnC,MAAM,CAAC,GAAG,KAAoE,CAAC;IAC/E,IAAI,CAAC,EAAE,UAAU,KAAK,GAAG,IAAI,CAAC,EAAE,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAsB,EACtB,UAAsD,EAAE;IAExD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;IAE/C,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO;gBAAE,MAAM,KAAK,CAAC;YAC9D,MAAM,OAAO,GAAG,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC;YAC3C,MAAM,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/esm/utils/rpc.test.js

@@ -0,0 +1,58 @@
+/** A 429 means the question never reached the provider, not that it answered. */
+import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest';
+import { sendWithRetry, MAX_MULTIPLE_ACCOUNTS } from './rpc';
+beforeEach(() => {
+    vi.useFakeTimers();
+});
+afterEach(() => {
+    vi.useRealTimers();
+});
+/** Drives the fake clock until `promise` settles, so backoff sleeps resolve. */
+async function runToCompletion(promise) {
+    const settled = promise.then(value => ({ ok: true, value }), error => ({ ok: false, error }));
+    await vi.runAllTimersAsync();
+    const outcome = await settled;
+    if (!outcome.ok)
+        throw outcome.error;
+    return outcome.value;
+}
+describe('sendWithRetry', () => {
+    it('returns the first result when nothing is rate limited', async () => {
+        const send = vi.fn().mockResolvedValue('ok');
+        await expect(runToCompletion(sendWithRetry(send))).resolves.toBe('ok');
+        expect(send).toHaveBeenCalledTimes(1);
+    });
+    it('retries a 429 and returns the eventual success', async () => {
+        const send = vi
+            .fn()
+            .mockRejectedValueOnce(new Error('HTTP error (429): Too Many Requests'))
+            .mockRejectedValueOnce(new Error('HTTP error (429): Too Many Requests'))
+            .mockResolvedValue('ok');
+        await expect(runToCompletion(sendWithRetry(send))).resolves.toBe('ok');
+        expect(send).toHaveBeenCalledTimes(3);
+    });
+    it('recognises a rate limit from a status code alone', async () => {
+        const err = Object.assign(new Error('rejected'), { statusCode: 429 });
+        const send = vi.fn().mockRejectedValueOnce(err).mockResolvedValue('ok');
+        await expect(runToCompletion(sendWithRetry(send))).resolves.toBe('ok');
+        expect(send).toHaveBeenCalledTimes(2);
+    });
+    it('does not retry an error that is not a rate limit', async () => {
+        // Retrying a decode failure or a bad request just multiplies the damage.
+        const send = vi.fn().mockRejectedValue(new Error('Invalid param: bad address'));
+        await expect(runToCompletion(sendWithRetry(send))).rejects.toThrow('Invalid param');
+        expect(send).toHaveBeenCalledTimes(1);
+    });
+    it('gives up after the retry budget and surfaces the rate limit', async () => {
+        // The caller has to be able to tell "still limited" from "answered", so the
+        // final failure propagates rather than resolving to something empty.
+        const send = vi.fn().mockRejectedValue(new Error('HTTP error (429): Too Many Requests'));
+        await expect(runToCompletion(sendWithRetry(send, { retries: 2 }))).rejects.toThrow('429');
+        expect(send).toHaveBeenCalledTimes(3);
+    });
+    it('batches at the getMultipleAccounts ceiling', () => {
+        // Asking for more than this in one call is rejected outright by the RPC.
+        expect(MAX_MULTIPLE_ACCOUNTS).toBe(100);
+    });
+});
+//# sourceMappingURL=rpc.test.js.map

package/dist/esm/utils/rpc.test.js.map

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

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 = '5.5.2';
+export const VERSION = '6.1.0';
 //# sourceMappingURL=version.js.map

package/dist/idl/srsly.json

@@ -2,7 +2,7 @@
   "address": "SRSLYxcFnjd5jG2DpJw4as6UEyjwJQK1U4J1TD1hvZH",
   "metadata": {
     "name": "srsly",
-    "version": "0.7.0",
+    "version": "0.7.1",
     "spec": "0.1.0",
     "description": "Space Rental from SLY",
     "repository": "https://github.com/wuwei-labs/srsly"
@@ -1779,10 +1779,61 @@
         },
         {
           "name": "rental_state",
-          "writable": true
+          "docs": [
+            "Seeds, not `address = contract.active_rental`: `address` is checked",
+            "before the handler runs, so a close arriving after the slot was cleared",
+            "aborted the whole transaction with 2012 rather than no-opping. The",
+            "pointer only ever holds this PDA or the system program, so the seeds",
+            "prove the same ownership without that failure. Paths C and D already",
+            "handle an empty slot."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  114,
+                  101,
+                  110,
+                  116,
+                  97,
+                  108,
+                  95,
+                  115,
+                  116,
+                  97,
+                  116,
+                  101
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "contract"
+              },
+              {
+                "kind": "const",
+                "value": [
+                  97,
+                  99,
+                  116,
+                  105,
+                  118,
+                  101
+                ]
+              }
+            ]
+          }
         },
         {
           "name": "borrower_state",
+          "docs": [
+            "Bound to the rental being closed, but only while there is one. `reset()`",
+            "clears `borrower_state` along with the rest of the slot, so an `address`",
+            "constraint here would reject the empty case the same way the pointer on",
+            "`rental_state` did. Only `process_rental_close` reads this account, and",
+            "that runs solely when the slot is occupied."
+          ],
           "writable": true
         },
         {

package/dist/types/doctor/contract.d.ts

@@ -7,6 +7,7 @@
  */
 import { type Address } from '@solana/kit';
 import { type Thread } from '../generated/codama/types/thread';
+import { type ConfigState, type ContractState } from '../generated/codama/accounts';
 /** What is wrong with a contract. */
 export type ContractFindingCode = 
 /** `contract.thread` is unset — the contract has no automation at all. */
@@ -32,7 +33,19 @@ export type ContractFindingCode =
  * Settlement still accrues to `owner_claimable`, but nothing can be paid
  * out, and a contract flagged `to_close` cannot finish closing.
  */
- | 'ownerTokenAccountMissing';
+ | 'ownerTokenAccountMissing'
+/**
+ * The contract could not be read, so nothing is known about it. Not a
+ * statement about its health — it is the absence of one. Usually a rate
+ * limit or a transport error during a bulk scan.
+ */
+ | 'diagnosisFailed'
+/**
+ * `to_close` is latched but no live thread remains to honour it. Only
+ * `contract_process` turns the flag into a closed contract, so the contract
+ * waits on an owner who has already been told the close was accepted.
+ */
+ | 'closeStranded';
 export interface ContractFinding {
     code: ContractFindingCode;
     /** `critical` means the contract cannot make progress on its own. */
@@ -80,6 +93,15 @@ export interface DiagnoseOptions {
     rpcUrl?: string;
     /** Wall clock to judge staleness against. Defaults to now. */
     nowSeconds?: bigint;
+    /**
+     * Accounts the caller has already read, to skip this diagnosis's own lookup
+     * of them. `diagnoseAllContracts` fills this in from its batched prefetch;
+     * a single diagnosis has no reason to.
+     */
+    prefetched?: {
+        contract: ContractState | null;
+        config: ConfigState | null;
+    };
 }
 /**
  * The contract a thread belongs to.

package/dist/types/doctor/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/doctor/contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAuC,MAAM,aAAa,CAAC;AAChF,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAoCjF,qCAAqC;AACrC,MAAM,MAAM,mBAAmB;AAC7B,0EAA0E;AACxE,qBAAqB;AACvB,8DAA8D;GAC5D,eAAe;AACjB;;;;GAIG;GACD,cAAc;AAChB,2EAA2E;GACzE,cAAc;AAChB,iDAAiD;GAC/C,mBAAmB;AACrB,sEAAsE;GACpE,eAAe;AACjB,6DAA6D;GAC3D,mBAAmB;AACrB;;;;GAIG;GACD,0BAA0B,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B;;;OAGG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,OAAO,CAEtE;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,OAAO,GAAG,MAAM,EACjC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CA0L5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,eAAe,GAAG;IACzB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuC9B"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/doctor/contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAuC,MAAM,aAAa,CAAC;AAChF,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AA+BtC,qCAAqC;AACrC,MAAM,MAAM,mBAAmB;AAC7B,0EAA0E;AACxE,qBAAqB;AACvB,8DAA8D;GAC5D,eAAe;AACjB;;;;GAIG;GACD,cAAc;AAChB,2EAA2E;GACzE,cAAc;AAChB,iDAAiD;GAC/C,mBAAmB;AACrB,sEAAsE;GACpE,eAAe;AACjB,6DAA6D;GAC3D,mBAAmB;AACrB;;;;GAIG;GACD,0BAA0B;AAC5B;;;;GAIG;GACD,iBAAiB;AACnB;;;;GAIG;GACD,eAAe,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B;;;OAGG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;QAC/B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;KAC5B,CAAC;CACH;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,OAAO,CAEtE;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,OAAO,GAAG,MAAM,EACjC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAgN5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,eAAe,GAAG;IACzB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAwE9B"}

package/dist/types/generated/codama/instructions/closeRental.d.ts

@@ -49,7 +49,22 @@ export type CloseRentalAsyncInput<TAccountPayer extends string = string, TAccoun
     payer: TransactionSigner<TAccountPayer>;
     config?: Address<TAccountConfig>;
     contract: Address<TAccountContract>;
-    rentalState: Address<TAccountRentalState>;
+    /**
+     * Seeds, not `address = contract.active_rental`: `address` is checked
+     * before the handler runs, so a close arriving after the slot was cleared
+     * aborted the whole transaction with 2012 rather than no-opping. The
+     * pointer only ever holds this PDA or the system program, so the seeds
+     * prove the same ownership without that failure. Paths C and D already
+     * handle an empty slot.
+     */
+    rentalState?: Address<TAccountRentalState>;
+    /**
+     * Bound to the rental being closed, but only while there is one. `reset()`
+     * clears `borrower_state` along with the rest of the slot, so an `address`
+     * constraint here would reject the empty case the same way the pointer on
+     * `rental_state` did. Only `process_rental_close` reads this account, and
+     * that runs solely when the slot is occupied.
+     */
     borrowerState: Address<TAccountBorrowerState>;
     /** Fleet validated by contract */
     fleet: Address<TAccountFleet>;
@@ -82,7 +97,22 @@ export type CloseRentalInput<TAccountPayer extends string = string, TAccountConf
     payer: TransactionSigner<TAccountPayer>;
     config: Address<TAccountConfig>;
     contract: Address<TAccountContract>;
+    /**
+     * Seeds, not `address = contract.active_rental`: `address` is checked
+     * before the handler runs, so a close arriving after the slot was cleared
+     * aborted the whole transaction with 2012 rather than no-opping. The
+     * pointer only ever holds this PDA or the system program, so the seeds
+     * prove the same ownership without that failure. Paths C and D already
+     * handle an empty slot.
+     */
     rentalState: Address<TAccountRentalState>;
+    /**
+     * Bound to the rental being closed, but only while there is one. `reset()`
+     * clears `borrower_state` along with the rest of the slot, so an `address`
+     * constraint here would reject the empty case the same way the pointer on
+     * `rental_state` did. Only `process_rental_close` reads this account, and
+     * that runs solely when the slot is occupied.
+     */
     borrowerState: Address<TAccountBorrowerState>;
     /** Fleet validated by contract */
     fleet: Address<TAccountFleet>;
@@ -117,7 +147,22 @@ export type ParsedCloseRentalInstruction<TProgram extends string = typeof SRSLY_
         payer: TAccountMetas[0];
         config: TAccountMetas[1];
         contract: TAccountMetas[2];
+        /**
+         * Seeds, not `address = contract.active_rental`: `address` is checked
+         * before the handler runs, so a close arriving after the slot was cleared
+         * aborted the whole transaction with 2012 rather than no-opping. The
+         * pointer only ever holds this PDA or the system program, so the seeds
+         * prove the same ownership without that failure. Paths C and D already
+         * handle an empty slot.
+         */
         rentalState: TAccountMetas[3];
+        /**
+         * Bound to the rental being closed, but only while there is one. `reset()`
+         * clears `borrower_state` along with the rest of the slot, so an `address`
+         * constraint here would reject the empty case the same way the pointer on
+         * `rental_state` did. Only `process_rental_close` reads this account, and
+         * that runs solely when the slot is occupied.
+         */
         borrowerState: TAccountMetas[4];
         /** Fleet validated by contract */
         fleet: TAccountMetas[5];