@antseed/cli 0.1.179 → 0.1.180

package/dist/proxy/chain-read-cache.d.ts

@@ -0,0 +1,47 @@
+/**
+ * TTL cache for chain reads. Concurrent reads of one key share a load; an
+ * expired value is served while it refreshes in the background (when asked
+ * to); a failed refresh serves the last good value marked `stale` and does
+ * not retry the load until `errorRetryMs` passes, so an RPC outage or rate
+ * limit never turns into a retry loop.
+ */
+export interface CachedRead<T> {
+    value: T;
+    /** True when the value could not be refreshed (the chain is unreachable or rate limited). */
+    stale: boolean;
+    fetchedAt: number;
+}
+export interface ReadOptions {
+    ttlMs: number;
+    /** Serve a value up to this much past its TTL immediately, refreshing it in the background. */
+    staleWhileRevalidateMs?: number;
+    /** Ignore a cached value younger than the TTL (still shares an in-flight load). */
+    force?: boolean;
+    /** False: a failed refresh is an error, never the last value (for reads that must not be stale). */
+    serveStaleOnError?: boolean;
+    /** Overrides the cache's `errorRetryMs` for this read. */
+    errorRetryMs?: number;
+}
+export declare class ChainReadCache {
+    private readonly entries;
+    private readonly now;
+    private readonly errorRetryMs;
+    private readonly maxEntries;
+    constructor(options?: {
+        now?: () => number;
+        errorRetryMs?: number;
+        maxEntries?: number;
+    });
+    read<T>(key: string, options: ReadOptions, load: () => Promise<T>): Promise<CachedRead<T>>;
+    /** The cached value regardless of age, when there is one. */
+    peek<T>(key: string): CachedRead<T> | null;
+    /** Milliseconds since the cached value was read, by the cache's clock; null when none. */
+    age(key: string): number | null;
+    /** Records a value read elsewhere (e.g. one tick of the deposit watcher). */
+    set<T>(key: string, value: T): void;
+    /** Drops keys equal to `key` or starting with `key` followed by `:`. */
+    invalidate(key: string): void;
+    private entry;
+    private start;
+}
+//# sourceMappingURL=chain-read-cache.d.ts.map

package/dist/proxy/chain-read-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-read-cache.d.ts","sourceRoot":"","sources":["../../src/proxy/chain-read-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAA;IACR,6FAA6F;IAC7F,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,+FAA+F;IAC/F,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,oGAAoG;IACpG,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAWD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAMtF,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAyBhG,6DAA6D;IAC7D,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1C,0FAA0F;IAC1F,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK/B,6EAA6E;IAC7E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IASnC,wEAAwE;IACxE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM7B,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,KAAK;CAoBd"}

package/dist/proxy/chain-read-cache.js

@@ -0,0 +1,110 @@
+/**
+ * TTL cache for chain reads. Concurrent reads of one key share a load; an
+ * expired value is served while it refreshes in the background (when asked
+ * to); a failed refresh serves the last good value marked `stale` and does
+ * not retry the load until `errorRetryMs` passes, so an RPC outage or rate
+ * limit never turns into a retry loop.
+ */
+export class ChainReadCache {
+    entries = new Map();
+    now;
+    errorRetryMs;
+    maxEntries;
+    constructor(options = {}) {
+        this.now = options.now ?? Date.now;
+        this.errorRetryMs = options.errorRetryMs ?? 10_000;
+        this.maxEntries = options.maxEntries ?? 5_000;
+    }
+    async read(key, options, load) {
+        const entry = this.entry(key);
+        const now = this.now();
+        const fresh = entry.hasValue && now - entry.fetchedAt < options.ttlMs;
+        if (fresh && !options.force)
+            return { value: entry.value, stale: false, fetchedAt: entry.fetchedAt };
+        const staleOnError = options.serveStaleOnError !== false;
+        const recentlyFailed = entry.failedAt !== null && now - entry.failedAt < (options.errorRetryMs ?? this.errorRetryMs);
+        if (recentlyFailed && !entry.loading) {
+            if (entry.hasValue && staleOnError)
+                return { value: entry.value, stale: true, fetchedAt: entry.fetchedAt };
+            throw entry.error;
+        }
+        const loading = this.start(key, entry, load);
+        if (entry.hasValue && !options.force && now - entry.fetchedAt < options.ttlMs + (options.staleWhileRevalidateMs ?? 0)) {
+            loading.catch(() => { });
+            return { value: entry.value, stale: false, fetchedAt: entry.fetchedAt };
+        }
+        try {
+            const value = await loading;
+            return { value, stale: false, fetchedAt: entry.fetchedAt };
+        }
+        catch (error) {
+            if (entry.hasValue && staleOnError)
+                return { value: entry.value, stale: true, fetchedAt: entry.fetchedAt };
+            throw error;
+        }
+    }
+    /** The cached value regardless of age, when there is one. */
+    peek(key) {
+        const entry = this.entries.get(key);
+        return entry?.hasValue ? { value: entry.value, stale: false, fetchedAt: entry.fetchedAt } : null;
+    }
+    /** Milliseconds since the cached value was read, by the cache's clock; null when none. */
+    age(key) {
+        const entry = this.entries.get(key);
+        return entry?.hasValue ? this.now() - entry.fetchedAt : null;
+    }
+    /** Records a value read elsewhere (e.g. one tick of the deposit watcher). */
+    set(key, value) {
+        const entry = this.entry(key);
+        entry.value = value;
+        entry.hasValue = true;
+        entry.fetchedAt = this.now();
+        entry.failedAt = null;
+        entry.error = undefined;
+    }
+    /** Drops keys equal to `key` or starting with `key` followed by `:`. */
+    invalidate(key) {
+        for (const existing of this.entries.keys()) {
+            if (existing === key || existing.startsWith(`${key}:`))
+                this.entries.delete(existing);
+        }
+    }
+    entry(key) {
+        let entry = this.entries.get(key);
+        if (!entry) {
+            if (this.entries.size >= this.maxEntries) {
+                const oldest = this.entries.keys().next().value;
+                if (oldest !== undefined)
+                    this.entries.delete(oldest);
+            }
+            entry = { fetchedAt: 0, hasValue: false, loading: null, failedAt: null, error: undefined };
+            this.entries.set(key, entry);
+        }
+        return entry;
+    }
+    start(key, entry, load) {
+        if (entry.loading)
+            return entry.loading;
+        const loading = (async () => load())();
+        entry.loading = loading;
+        loading.then((value) => {
+            if (this.entries.get(key) !== entry)
+                return;
+            entry.value = value;
+            entry.hasValue = true;
+            entry.fetchedAt = this.now();
+            entry.failedAt = null;
+            entry.error = undefined;
+        }, (error) => {
+            if (this.entries.get(key) !== entry)
+                return;
+            entry.failedAt = this.now();
+            entry.error = error;
+        }).finally(() => {
+            if (entry.loading === loading)
+                entry.loading = null;
+        });
+        return loading;
+    }
+}
+//# sourceMappingURL=chain-read-cache.js.map

package/dist/proxy/chain-read-cache.js.map

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

package/dist/proxy/chain-read-cache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chain-read-cache.test.d.ts.map

package/dist/proxy/chain-read-cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-read-cache.test.d.ts","sourceRoot":"","sources":["../../src/proxy/chain-read-cache.test.ts"],"names":[],"mappings":""}

package/dist/proxy/chain-read-cache.test.js

@@ -0,0 +1,75 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { ChainReadCache } from './chain-read-cache.js';
+test('a value is reused for its TTL and concurrent loads share one call', async () => {
+    let now = 0;
+    let loads = 0;
+    const cache = new ChainReadCache({ now: () => now });
+    const load = async () => { loads++; return loads; };
+    const [a, b] = await Promise.all([cache.read('k', { ttlMs: 1_000 }, load), cache.read('k', { ttlMs: 1_000 }, load)]);
+    assert.equal(a.value, 1);
+    assert.equal(b.value, 1);
+    now = 999;
+    assert.equal((await cache.read('k', { ttlMs: 1_000 }, load)).value, 1);
+    now = 1_000;
+    assert.equal((await cache.read('k', { ttlMs: 1_000 }, load)).value, 2);
+    assert.equal(loads, 2);
+});
+test('stale-while-revalidate answers at once and refreshes in the background, within its window only', async () => {
+    let now = 0;
+    let loads = 0;
+    const cache = new ChainReadCache({ now: () => now });
+    const load = async () => ++loads;
+    await cache.read('k', { ttlMs: 100, staleWhileRevalidateMs: 1_000 }, load);
+    now = 500;
+    const served = await cache.read('k', { ttlMs: 100, staleWhileRevalidateMs: 1_000 }, load);
+    assert.deepEqual([served.value, served.stale], [1, false]);
+    await new Promise((resolve) => setImmediate(resolve));
+    assert.equal(loads, 2);
+    assert.equal(cache.peek('k')?.value, 2);
+    now = 5_000; // past TTL + window: wait for the read
+    assert.equal((await cache.read('k', { ttlMs: 100, staleWhileRevalidateMs: 1_000 }, load)).value, 3);
+});
+test('a failed refresh serves the last value as stale and does not retry until errorRetryMs passes', async () => {
+    let now = 0;
+    let loads = 0;
+    let fail = false;
+    const cache = new ChainReadCache({ now: () => now, errorRetryMs: 10_000 });
+    const load = async () => {
+        loads++;
+        if (fail)
+            throw new Error('429');
+        return 'v';
+    };
+    await cache.read('k', { ttlMs: 100 }, load);
+    fail = true;
+    now = 200;
+    assert.deepEqual(await cache.read('k', { ttlMs: 100 }, load), { value: 'v', stale: true, fetchedAt: 0 });
+    assert.equal(loads, 2);
+    now = 5_000;
+    assert.equal((await cache.read('k', { ttlMs: 100 }, load)).stale, true);
+    assert.equal(loads, 2, 'no retry inside the error window');
+    now = 10_201;
+    fail = false;
+    assert.deepEqual(await cache.read('k', { ttlMs: 100 }, load), { value: 'v', stale: false, fetchedAt: 10_201 });
+    assert.equal(loads, 3);
+});
+test('a failure without a cached value is rethrown (and not retried at once)', async () => {
+    let loads = 0;
+    const cache = new ChainReadCache({ now: () => 0, errorRetryMs: 10_000 });
+    const load = async () => { loads++; throw new Error('down'); };
+    await assert.rejects(cache.read('k', { ttlMs: 100 }, load), /down/);
+    await assert.rejects(cache.read('k', { ttlMs: 100 }, load), /down/);
+    assert.equal(loads, 1);
+});
+test('set, force and invalidate', async () => {
+    let loads = 0;
+    const cache = new ChainReadCache({ now: () => 0 });
+    cache.set('usdc:0xabc', 5n);
+    assert.equal((await cache.read('usdc:0xabc', { ttlMs: 100 }, async () => { loads++; return 6n; })).value, 5n);
+    assert.equal((await cache.read('usdc:0xabc', { ttlMs: 100, force: true }, async () => { loads++; return 6n; })).value, 6n);
+    cache.invalidate('usdc');
+    assert.equal(cache.peek('usdc:0xabc'), null);
+    assert.equal(loads, 1);
+});
+//# sourceMappingURL=chain-read-cache.test.js.map

package/dist/proxy/chain-read-cache.test.js.map

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

package/dist/proxy/chain-rpc-test-support.d.ts

@@ -0,0 +1,31 @@
+export interface FakeChainRpc {
+    url: string;
+    /** HTTP requests received, in total and by JSON-RPC method (an `aggregate3` counts once as `eth_call`). */
+    requests: number;
+    byMethod: Record<string, number>;
+    /** Calls answered inside `aggregate3` batches. */
+    batchedCalls: number;
+    usdc: Map<string, bigint>;
+    deposits: Map<string, {
+        available: bigint;
+        reserved: bigint;
+    }>;
+    creditLimit: bigint;
+    operators: Map<string, string>;
+    /** Answer the next N requests (Infinity: all) with HTTP 429. */
+    rateLimit(count: number): void;
+    /** Answer with JSON-RPC error -32005 instead of HTTP 429. */
+    rateLimitStyle: 'http' | 'jsonrpc';
+    /** Forget the counters. */
+    reset(): void;
+    close(): Promise<void>;
+}
+export declare function startFakeChainRpc(options?: {
+    evmChainId?: number;
+    multicall?: boolean;
+    port?: number;
+    host?: string;
+}): Promise<FakeChainRpc>;
+/** ABI-encode a uint256 (for tests that hand-craft responses). */
+export declare function encodeUint(value: bigint): string;
+//# sourceMappingURL=chain-rpc-test-support.d.ts.map

package/dist/proxy/chain-rpc-test-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-rpc-test-support.d.ts","sourceRoot":"","sources":["../../src/proxy/chain-rpc-test-support.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,2GAA2G;IAC3G,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9D,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,gEAAgE;IAChE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,6DAA6D;IAC7D,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,2BAA2B;IAC3B,KAAK,IAAI,IAAI,CAAA;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CA+GvJ;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/proxy/chain-rpc-test-support.js

@@ -0,0 +1,136 @@
+/**
+ * A fake Base JSON-RPC endpoint for tests and `scripts/rpc-budget.mjs`:
+ * answers the reads the buyer and gateway make (USDC balances, deposits
+ * balances, credit limit, operator, Multicall3 `aggregate3`), counts every
+ * HTTP request by method, and can be told to rate-limit. Anything it does
+ * not know returns a zero word, which decodes as 0 / false / the zero address.
+ */
+import { createServer } from 'node:http';
+import { AbiCoder, Interface } from 'ethers';
+import { MULTICALL3_ADDRESS } from './chain-rpc.js';
+const READS = new Interface([
+    'function balanceOf(address owner) view returns (uint256)',
+    'function getBuyerBalance(address buyer) view returns (uint256 available, uint256 reserved, uint256 lastActivityAt)',
+    'function getBuyerCreditLimit(address buyer) view returns (uint256)',
+    'function getOperator(address buyer) view returns (address)',
+    'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) payable returns (tuple(bool success, bytes returnData)[] returnData)',
+]);
+const ZERO_WORD = '0x' + '0'.repeat(64);
+export async function startFakeChainRpc(options = {}) {
+    const evmChainId = options.evmChainId ?? 8453;
+    const multicall = options.multicall !== false;
+    let limited = 0;
+    const fake = {
+        url: '',
+        requests: 0,
+        byMethod: {},
+        batchedCalls: 0,
+        usdc: new Map(),
+        deposits: new Map(),
+        creditLimit: 100000000n,
+        operators: new Map(),
+        rateLimit: (count) => { limited = count; },
+        rateLimitStyle: 'http',
+        reset: () => {
+            fake.requests = 0;
+            fake.byMethod = {};
+            fake.batchedCalls = 0;
+        },
+        close: async () => {
+            await new Promise((resolve) => server.close(() => resolve()));
+        },
+    };
+    const call = (to, data) => {
+        if (multicall && to.toLowerCase() === MULTICALL3_ADDRESS.toLowerCase()) {
+            const [calls] = READS.decodeFunctionData('aggregate3', data);
+            fake.batchedCalls += calls.length;
+            const results = calls.map((entry) => call(entry.target, entry.callData));
+            return { success: true, returnData: READS.encodeFunctionResult('aggregate3', [results]) };
+        }
+        let parsed;
+        try {
+            parsed = READS.parseTransaction({ data });
+        }
+        catch {
+            parsed = null;
+        }
+        const owner = parsed?.args[0] && typeof parsed.args[0] === 'string' ? parsed.args[0].toLowerCase() : '';
+        switch (parsed?.name) {
+            case 'balanceOf': return { success: true, returnData: READS.encodeFunctionResult('balanceOf', [fake.usdc.get(owner) ?? 0n]) };
+            case 'getBuyerBalance': {
+                const balance = fake.deposits.get(owner) ?? { available: 0n, reserved: 0n };
+                return { success: true, returnData: READS.encodeFunctionResult('getBuyerBalance', [balance.available, balance.reserved, 0n]) };
+            }
+            case 'getBuyerCreditLimit': return { success: true, returnData: READS.encodeFunctionResult('getBuyerCreditLimit', [fake.creditLimit]) };
+            case 'getOperator': return { success: true, returnData: READS.encodeFunctionResult('getOperator', [fake.operators.get(owner) ?? '0x' + '0'.repeat(40)]) };
+            default: return { success: true, returnData: ZERO_WORD };
+        }
+    };
+    const answer = (request) => {
+        const id = request.id ?? null;
+        const method = request.method ?? '';
+        const params = request.params ?? [];
+        switch (method) {
+            case 'eth_chainId': return { jsonrpc: '2.0', id, result: '0x' + evmChainId.toString(16) };
+            case 'net_version': return { jsonrpc: '2.0', id, result: String(evmChainId) };
+            case 'eth_blockNumber': return { jsonrpc: '2.0', id, result: '0x100' };
+            case 'eth_getBalance':
+            case 'eth_getTransactionCount': return { jsonrpc: '2.0', id, result: '0x0' };
+            case 'eth_gasPrice': return { jsonrpc: '2.0', id, result: '0x1' };
+            case 'eth_getCode': {
+                const address = String(params[0] ?? '').toLowerCase();
+                const deployed = address !== MULTICALL3_ADDRESS.toLowerCase() || multicall;
+                return { jsonrpc: '2.0', id, result: deployed ? '0x6080604052' : '0x' };
+            }
+            case 'eth_getLogs': return { jsonrpc: '2.0', id, result: [] };
+            case 'eth_getTransactionReceipt': return { jsonrpc: '2.0', id, result: null };
+            case 'eth_call': {
+                const tx = (params[0] ?? {});
+                const result = call(tx.to ?? '', tx.data ?? tx.input ?? '0x');
+                return result.success
+                    ? { jsonrpc: '2.0', id, result: result.returnData }
+                    : { jsonrpc: '2.0', id, error: { code: 3, message: 'execution reverted', data: result.returnData } };
+            }
+            default: return { jsonrpc: '2.0', id, error: { code: -32601, message: `method ${method} not supported by the fake RPC` } };
+        }
+    };
+    const server = createServer((req, res) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => {
+            fake.requests++;
+            let body;
+            try {
+                body = JSON.parse(Buffer.concat(chunks).toString('utf8') || 'null');
+            }
+            catch {
+                res.writeHead(400).end();
+                return;
+            }
+            const entries = (Array.isArray(body) ? body : [body]);
+            for (const entry of entries)
+                fake.byMethod[entry.method ?? '?'] = (fake.byMethod[entry.method ?? '?'] ?? 0) + 1;
+            if (limited > 0) {
+                limited--;
+                if (fake.rateLimitStyle === 'http') {
+                    res.writeHead(429, { 'content-type': 'application/json', 'retry-after': '1' }).end(JSON.stringify({ error: 'rate limited' }));
+                }
+                else {
+                    const errors = entries.map((entry) => ({ jsonrpc: '2.0', id: entry.id ?? null, error: { code: -32005, message: 'rate limit exceeded' } }));
+                    res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(Array.isArray(body) ? errors : errors[0]));
+                }
+                return;
+            }
+            const results = entries.map(answer);
+            res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(Array.isArray(body) ? results : results[0]));
+        });
+    });
+    await new Promise((resolve) => server.listen(options.port ?? 0, options.host ?? '127.0.0.1', () => resolve()));
+    fake.url = `http://127.0.0.1:${server.address().port}`;
+    return fake;
+}
+/** ABI-encode a uint256 (for tests that hand-craft responses). */
+export function encodeUint(value) {
+    return AbiCoder.defaultAbiCoder().encode(['uint256'], [value]);
+}
+//# sourceMappingURL=chain-rpc-test-support.js.map

package/dist/proxy/chain-rpc-test-support.js.map

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

package/dist/proxy/chain-rpc.d.ts

@@ -0,0 +1,121 @@
+/**
+ * The JSON-RPC client every chain read in the buyer and gateway processes
+ * goes through: one provider per chain per process (`sharedChainProvider`),
+ * so public endpoints (mainnet.base.org and friends) that throttle per IP
+ * see as few requests as possible.
+ *
+ * - Identical reads in flight at once share one request.
+ * - `eth_call`s issued together (a `Promise.all` of contract reads, one
+ *   tick of the deposit watcher for N wallets) are folded into a single
+ *   Multicall3 `aggregate3` call, for an allow-list of caller-independent
+ *   views (`BATCHABLE_SELECTORS`).
+ * - Chain constants (`eth_chainId`, deployed contract code) are remembered.
+ * - An endpoint that answers 429 / JSON-RPC -32005 / 5xx / a network error
+ *   is skipped for an exponentially growing, jittered period and the call
+ *   moves to the next endpoint. When every endpoint is backing off the call
+ *   fails at once with `RpcUnavailableError` without touching the network,
+ *   so callers serve cached data instead of hammering.
+ * - Requests are paced per endpoint so a burst never exceeds a few per second.
+ */
+import { JsonRpcProvider, type JsonRpcPayload, type JsonRpcResult } from 'ethers';
+export interface RpcTransportResponse {
+    status: number;
+    /** Parsed JSON body, or null when the body is not JSON. */
+    body: unknown;
+    /** From a `Retry-After` header, when the endpoint sent one. */
+    retryAfterMs?: number | null;
+}
+export type RpcTransport = (url: string, body: string) => Promise<RpcTransportResponse>;
+export interface ChainRpcOptions {
+    transport?: RpcTransport;
+    now?: () => number;
+    random?: () => number;
+    /** How long concurrent `eth_call`s are collected into one Multicall3 call; null disables batching. */
+    batchWindowMs?: number | null;
+    /** Calls per Multicall3 batch. */
+    maxBatchSize?: number;
+    /** First back-off after an endpoint throttles or fails; doubles per consecutive failure. */
+    backoffBaseMs?: number;
+    backoffMaxMs?: number;
+    /** Sustained requests per second per endpoint (bursts of the same size are allowed). */
+    requestsPerSecond?: number;
+    multicallAddress?: string;
+}
+export interface ChainRpcStats {
+    /** HTTP requests sent to RPC endpoints. */
+    requests: number;
+    /** JSON-RPC calls asked of the provider, by method (before coalescing, batching and caching). */
+    calls: Record<string, number>;
+    coalesced: number;
+    /** `eth_call`s that went out inside a Multicall3 batch. */
+    batchedCalls: number;
+    cacheHits: number;
+    rateLimited: number;
+    /** Calls refused locally because every endpoint was backing off. */
+    shortCircuited: number;
+}
+/** Every endpoint is backing off (or just failed); serve cached data and retry after `retryAt`. */
+export declare class RpcUnavailableError extends Error {
+    readonly retryAt: number;
+    readonly code = "RPC_UNAVAILABLE";
+    constructor(message: string, retryAt: number);
+}
+export declare const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+export declare class ChainRpcProvider extends JsonRpcProvider {
+    private readonly endpoints;
+    private readonly transport;
+    private readonly now;
+    private readonly random;
+    private readonly batchWindowMs;
+    private readonly maxBatchSize;
+    private readonly backoffBaseMs;
+    private readonly backoffMaxMs;
+    private readonly rps;
+    private readonly multicallAddress;
+    private readonly inflight;
+    private readonly constants;
+    private queue;
+    private flushTimer;
+    private multicall;
+    private readonly counters;
+    constructor(urls: string[], evmChainId?: number, options?: ChainRpcOptions);
+    get urls(): string[];
+    stats(): ChainRpcStats;
+    /** When the next request could go out; 0 while some endpoint is usable. */
+    get unavailableUntil(): number;
+    _send(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<JsonRpcResult[]>;
+    private one;
+    /** `eth_chainId` forever; contract code for an hour (an empty account for ten minutes). */
+    private remember;
+    private batchable;
+    private enqueue;
+    private flushSoon;
+    private flush;
+    private sendEach;
+    /** Multicall3 is probed once per process (its code is then cached like any other). */
+    private multicallDeployed;
+    private request;
+    /** Sends one payload to the first endpoint not backing off, moving on when one throttles or fails. */
+    private transmit;
+    /** Exponential back-off with "equal jitter": half the delay fixed, half random. */
+    private trip;
+    private pace;
+    destroy(): void;
+}
+/** An RPC URL without its path or query, which is where providers put API keys. */
+export declare function redact(url: string): string;
+export interface ChainRpcTarget {
+    evmChainId: number;
+    rpcUrl: string;
+    fallbackRpcUrls?: string[];
+}
+/**
+ * The process's provider for a chain and endpoint list; built once, reused by every reader.
+ * Batched reads run inside Multicall3, with `msg.sender` = Multicall3 rather
+ * than the zero address or a `from`: a read whose answer depends on the caller
+ * must not be added to `BATCHABLE_SELECTORS`.
+ */
+export declare function sharedChainProvider(chain: ChainRpcTarget, options?: ChainRpcOptions): ChainRpcProvider;
+/** For tests. */
+export declare function resetSharedChainProviders(): void;
+//# sourceMappingURL=chain-rpc.d.ts.map

package/dist/proxy/chain-rpc.d.ts.map

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