@antseed/cli 0.1.179 → 0.1.180

package/dist/proxy/chain-rpc.js

@@ -0,0 +1,420 @@
+/**
+ * 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 { FetchRequest, Interface, JsonRpcProvider, Network } from 'ethers';
+/** Every endpoint is backing off (or just failed); serve cached data and retry after `retryAt`. */
+export class RpcUnavailableError extends Error {
+    retryAt;
+    code = 'RPC_UNAVAILABLE';
+    constructor(message, retryAt) {
+        super(message);
+        this.retryAt = retryAt;
+        this.name = 'RpcUnavailableError';
+    }
+}
+export const MULTICALL3_ADDRESS = '0xcA11bde05977b3631167028862bE2a173976CA11';
+const REQUEST_TIMEOUT_MS = 10_000;
+const RATE_LIMIT_CODE = -32005;
+const CODE_CACHE_MS = 60 * 60_000;
+const EMPTY_CODE_CACHE_MS = 10 * 60_000;
+const COALESCED_METHODS = new Set(['eth_call', 'eth_getCode', 'eth_getBalance', 'eth_blockNumber', 'eth_getTransactionReceipt', 'eth_chainId', 'eth_getTransactionCount']);
+const MULTICALL = new Interface([
+    'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) payable returns (tuple(bool success, bytes returnData)[] returnData)',
+]);
+/**
+ * The reads folded into Multicall3 batches (as declared in the USDC,
+ * AntseedDeposits and DepositRelay ABIs the buyer and gateway use, and the
+ * registry, emissions and usage-rewards reads behind the console's buyer
+ * rewards). Inside
+ * `aggregate3` a call runs with `msg.sender` = Multicall3, so only views whose
+ * answer does not depend on the caller belong here; any other `eth_call` is
+ * sent on its own.
+ */
+const BATCHABLE_SELECTORS = (() => {
+    const reads = new Interface([
+        'function balanceOf(address owner) view returns (uint256)',
+        'function name() view returns (string)',
+        'function version() view returns (string)',
+        'function DOMAIN_SEPARATOR() view returns (bytes32)',
+        '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 getOperatorNonce(address buyer) view returns (uint256)',
+        'function FEE() view returns (uint256)',
+        // Buyer rewards (`createRewardsReader`): protocol pointers and epoch configuration...
+        'function emissions() view returns (address)',
+        'function staking() view returns (address)',
+        'function currentEpoch() view returns (uint256)',
+        'function effectiveEpoch() view returns (uint256)',
+        'function genesis() view returns (uint256)',
+        'function epochDuration() view returns (uint256)',
+        'function EPOCH_DURATION() view returns (uint256)',
+        'function currentEmissionRate() view returns (uint256)',
+        'function sellerRewardsPool() view returns (address)',
+        // ...and the buyer's own rewards, which name the buyer.
+        'function buyerEpochClaimed(address buyer, uint256 epoch) view returns (bool)',
+        'function pendingBuyerReward(address buyer, uint256 epoch) view returns (uint256)',
+        'function pendingEmissions(address account, uint256[] epochs) view returns (uint256 seller, uint256 buyer)',
+    ]);
+    const selectors = new Set();
+    reads.forEachFunction((fragment) => selectors.add(fragment.selector));
+    return selectors;
+})();
+let nextInternalId = 1_000_000_000;
+export class ChainRpcProvider extends JsonRpcProvider {
+    endpoints;
+    transport;
+    now;
+    random;
+    batchWindowMs;
+    maxBatchSize;
+    backoffBaseMs;
+    backoffMaxMs;
+    rps;
+    multicallAddress;
+    inflight = new Map();
+    constants = new Map();
+    queue = [];
+    flushTimer = null;
+    multicall = null;
+    counters = { requests: 0, calls: {}, coalesced: 0, batchedCalls: 0, cacheHits: 0, rateLimited: 0, shortCircuited: 0 };
+    constructor(urls, evmChainId, options = {}) {
+        const unique = [...new Set(urls.map((url) => url.trim()).filter(Boolean))];
+        if (unique.length === 0)
+            throw new Error('At least one RPC endpoint is required.');
+        super(unique[0], evmChainId ? Network.from(evmChainId) : undefined, { staticNetwork: !!evmChainId, batchMaxCount: 1 });
+        this.now = options.now ?? Date.now;
+        this.rps = options.requestsPerSecond ?? 8;
+        this.endpoints = unique.map((url) => ({ url, failures: 0, openUntil: 0, tokens: this.rps, refilledAt: this.now() }));
+        this.transport = options.transport ?? fetchTransport;
+        this.random = options.random ?? Math.random;
+        this.batchWindowMs = options.batchWindowMs === undefined ? 5 : options.batchWindowMs;
+        this.maxBatchSize = options.maxBatchSize ?? 50;
+        this.backoffBaseMs = options.backoffBaseMs ?? 2_000;
+        // Capped at a minute: with a single endpoint, every read waits this out,
+        // and a sweep confirmation (two minutes) must outlive it.
+        this.backoffMaxMs = options.backoffMaxMs ?? 60_000;
+        this.multicallAddress = options.multicallAddress ?? MULTICALL3_ADDRESS;
+    }
+    get urls() {
+        return this.endpoints.map((endpoint) => endpoint.url);
+    }
+    stats() {
+        return { ...this.counters, calls: { ...this.counters.calls } };
+    }
+    /** When the next request could go out; 0 while some endpoint is usable. */
+    get unavailableUntil() {
+        const now = this.now();
+        if (this.endpoints.some((endpoint) => endpoint.openUntil <= now))
+            return 0;
+        return Math.min(...this.endpoints.map((endpoint) => endpoint.openUntil));
+    }
+    async _send(payload) {
+        if (Array.isArray(payload))
+            return Promise.all(payload.map((entry) => this.one(entry)));
+        return [await this.one(payload)];
+    }
+    async one(payload) {
+        this.counters.calls[payload.method] = (this.counters.calls[payload.method] ?? 0) + 1;
+        const key = JSON.stringify([payload.method, payload.params]);
+        const constant = this.constants.get(key);
+        if (constant && constant.until > this.now()) {
+            this.counters.cacheHits++;
+            return { id: payload.id, result: constant.result };
+        }
+        const coalesce = COALESCED_METHODS.has(payload.method);
+        const pending = coalesce ? this.inflight.get(key) : undefined;
+        if (pending) {
+            this.counters.coalesced++;
+            return { ...await pending, id: payload.id };
+        }
+        const task = this.batchable(payload) ? this.enqueue(payload) : this.request(payload);
+        if (coalesce)
+            this.inflight.set(key, task);
+        try {
+            const result = await task;
+            this.remember(key, payload, result);
+            return { ...result, id: payload.id };
+        }
+        finally {
+            if (coalesce && this.inflight.get(key) === task)
+                this.inflight.delete(key);
+        }
+    }
+    /** `eth_chainId` forever; contract code for an hour (an empty account for ten minutes). */
+    remember(key, payload, result) {
+        if (!('result' in result))
+            return;
+        if (payload.method === 'eth_chainId') {
+            this.constants.set(key, { result: result.result, until: Number.POSITIVE_INFINITY });
+        }
+        else if (payload.method === 'eth_getCode' && Array.isArray(payload.params) && (payload.params[1] ?? 'latest') === 'latest') {
+            const empty = result.result === '0x';
+            this.constants.set(key, { result: result.result, until: this.now() + (empty ? EMPTY_CODE_CACHE_MS : CODE_CACHE_MS) });
+        }
+    }
+    batchable(payload) {
+        if (this.batchWindowMs === null || payload.method !== 'eth_call' || !Array.isArray(payload.params))
+            return false;
+        const [tx, block] = payload.params;
+        if (!tx || typeof tx !== 'object' || (block !== undefined && block !== 'latest'))
+            return false;
+        if (typeof tx['to'] !== 'string' || tx['to'].toLowerCase() === this.multicallAddress.toLowerCase())
+            return false;
+        const data = tx['data'] ?? tx['input'];
+        if (typeof data !== 'string' || !BATCHABLE_SELECTORS.has(data.slice(0, 10).toLowerCase()))
+            return false;
+        return Object.keys(tx).every((field) => field === 'to' || field === 'data' || field === 'input');
+    }
+    enqueue(payload) {
+        const tx = payload.params[0];
+        return new Promise((resolve, reject) => {
+            this.queue.push({ payload, tx: { to: tx['to'], data: tx['data'] ?? tx['input'] ?? '0x' }, resolve, reject });
+            if (this.queue.length >= this.maxBatchSize) {
+                this.flushSoon(0);
+            }
+            else {
+                this.flushSoon(this.batchWindowMs ?? 0);
+            }
+        });
+    }
+    flushSoon(delayMs) {
+        if (this.flushTimer && delayMs > 0)
+            return;
+        if (this.flushTimer)
+            clearTimeout(this.flushTimer);
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            while (this.queue.length > 0)
+                void this.flush(this.queue.splice(0, this.maxBatchSize));
+        }, delayMs);
+    }
+    async flush(batch) {
+        if (batch.length === 1 || !await this.multicallDeployed().catch(() => false)) {
+            await this.sendEach(batch);
+            return;
+        }
+        const data = MULTICALL.encodeFunctionData('aggregate3', [batch.map((call) => ({ target: call.tx.to, allowFailure: true, callData: call.tx.data }))]);
+        let response;
+        try {
+            response = await this.transmit({ jsonrpc: '2.0', id: nextInternalId++, method: 'eth_call', params: [{ to: this.multicallAddress, data }, 'latest'] });
+        }
+        catch (error) {
+            // Every endpoint is backing off: the individual calls would fail the same way.
+            if (error instanceof RpcUnavailableError) {
+                for (const call of batch)
+                    call.reject(error);
+                return;
+            }
+            // The endpoint refused the aggregate request itself (e.g. HTTP 400 or
+            // 413 on a large body): send one call each.
+            await this.sendEach(batch);
+            return;
+        }
+        const body = response;
+        let decoded = null;
+        if (body && typeof body.result === 'string') {
+            try {
+                decoded = MULTICALL.decodeFunctionResult('aggregate3', body.result)[0];
+            }
+            catch {
+                decoded = null;
+            }
+        }
+        if (!decoded || decoded.length !== batch.length) {
+            // The aggregate itself failed (gas cap, a node quirk): fall back to one call each.
+            await this.sendEach(batch);
+            return;
+        }
+        this.counters.batchedCalls += batch.length;
+        batch.forEach((call, index) => {
+            const entry = decoded[index];
+            call.resolve(entry.success
+                ? { id: call.payload.id, result: entry.returnData }
+                : { id: call.payload.id, error: { code: 3, message: 'execution reverted', data: entry.returnData } });
+        });
+    }
+    async sendEach(batch) {
+        await Promise.all(batch.map(async (call) => {
+            try {
+                call.resolve(await this.request(call.payload));
+            }
+            catch (error) {
+                call.reject(error);
+            }
+        }));
+    }
+    /** Multicall3 is probed once per process (its code is then cached like any other). */
+    multicallDeployed() {
+        this.multicall ??= this.one({ jsonrpc: '2.0', id: nextInternalId++, method: 'eth_getCode', params: [this.multicallAddress, 'latest'] })
+            .then((result) => 'result' in result && typeof result.result === 'string' && result.result !== '0x')
+            .catch((error) => {
+            this.multicall = null;
+            throw error;
+        });
+        return this.multicall;
+    }
+    async request(payload) {
+        const body = await this.transmit(payload);
+        const entry = Array.isArray(body) ? body[0] : body;
+        if (!entry || typeof entry !== 'object')
+            throw new Error('The RPC endpoint returned an empty response.');
+        return { ...entry, id: payload.id };
+    }
+    /** Sends one payload to the first endpoint not backing off, moving on when one throttles or fails. */
+    async transmit(payload) {
+        const body = JSON.stringify(payload);
+        let lastError = null;
+        let attempted = false;
+        for (const endpoint of this.endpoints) {
+            if (endpoint.openUntil > this.now())
+                continue;
+            attempted = true;
+            await this.pace(endpoint);
+            this.counters.requests++;
+            let response;
+            try {
+                response = await this.transport(endpoint.url, body);
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                this.trip(endpoint, null);
+                continue;
+            }
+            if (response.status === 429 || isRateLimited(response.body)) {
+                this.counters.rateLimited++;
+                this.trip(endpoint, response.retryAfterMs ?? null);
+                lastError = new RpcUnavailableError(`${redact(endpoint.url)} is rate limiting requests`, endpoint.openUntil);
+                continue;
+            }
+            if (response.status >= 500 || response.status === 401 || response.status === 403) {
+                this.trip(endpoint, response.retryAfterMs ?? null);
+                lastError = new RpcUnavailableError(`${redact(endpoint.url)} responded with HTTP ${response.status}`, endpoint.openUntil);
+                continue;
+            }
+            if (response.status < 200 || response.status >= 300) {
+                throw new Error(`${redact(endpoint.url)} responded with HTTP ${response.status}`);
+            }
+            endpoint.failures = 0;
+            return response.body;
+        }
+        if (!attempted) {
+            this.counters.shortCircuited++;
+            const retryAt = this.unavailableUntil;
+            throw new RpcUnavailableError(`Every RPC endpoint is backing off after errors or rate limits; retrying in ${Math.max(1, Math.ceil((retryAt - this.now()) / 1000))} s.`, retryAt);
+        }
+        if (lastError instanceof RpcUnavailableError)
+            throw lastError;
+        throw new RpcUnavailableError(lastError?.message ?? 'The RPC endpoints did not answer.', this.unavailableUntil || this.now());
+    }
+    /** Exponential back-off with "equal jitter": half the delay fixed, half random. */
+    trip(endpoint, retryAfterMs) {
+        endpoint.failures++;
+        const exponential = Math.min(this.backoffMaxMs, this.backoffBaseMs * 2 ** Math.min(endpoint.failures - 1, 20));
+        const delay = exponential / 2 + this.random() * exponential / 2;
+        endpoint.openUntil = this.now() + Math.max(delay, Math.min(retryAfterMs ?? 0, this.backoffMaxMs));
+    }
+    async pace(endpoint) {
+        for (;;) {
+            const now = this.now();
+            endpoint.tokens = Math.min(this.rps, endpoint.tokens + (now - endpoint.refilledAt) * this.rps / 1000);
+            endpoint.refilledAt = now;
+            if (endpoint.tokens >= 1) {
+                endpoint.tokens -= 1;
+                return;
+            }
+            await new Promise((resolve) => setTimeout(resolve, Math.ceil((1 - endpoint.tokens) * 1000 / this.rps)));
+        }
+    }
+    destroy() {
+        if (this.flushTimer)
+            clearTimeout(this.flushTimer);
+        this.flushTimer = null;
+        for (const call of this.queue.splice(0))
+            call.reject(new Error('provider destroyed'));
+        super.destroy();
+    }
+}
+function isRateLimited(body) {
+    const entries = Array.isArray(body) ? body : [body];
+    return entries.some((entry) => {
+        const error = entry?.error;
+        return !!error && (error.code === RATE_LIMIT_CODE || /rate.?limit|too many requests|exceeded .*capacity/i.test(String(error.message ?? '')));
+    });
+}
+/** An RPC URL without its path or query, which is where providers put API keys. */
+export function redact(url) {
+    try {
+        const parsed = new URL(url);
+        return `${parsed.protocol}//${parsed.host}${parsed.pathname.length > 1 || parsed.search ? '/…' : ''}`;
+    }
+    catch {
+        return 'RPC endpoint';
+    }
+}
+function retryAfter(value) {
+    if (!value)
+        return null;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds))
+        return Math.max(0, seconds * 1000);
+    const at = Date.parse(value);
+    return Number.isFinite(at) ? Math.max(0, at - Date.now()) : null;
+}
+async function fetchTransport(url, body) {
+    const request = new FetchRequest(url);
+    request.timeout = REQUEST_TIMEOUT_MS;
+    request.retryFunc = async () => false;
+    request.setThrottleParams({ maxAttempts: 1 });
+    request.setHeader('content-type', 'application/json');
+    request.body = body;
+    const response = await request.send();
+    let parsed = null;
+    try {
+        parsed = response.bodyJson;
+    }
+    catch {
+        parsed = null;
+    }
+    return { status: response.statusCode, body: parsed, retryAfterMs: retryAfter(response.getHeader('retry-after')) };
+}
+const shared = new Map();
+/**
+ * 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 function sharedChainProvider(chain, options) {
+    const urls = [chain.rpcUrl, ...(chain.fallbackRpcUrls ?? [])];
+    const key = `${chain.evmChainId}|${urls.join('|')}`;
+    let provider = shared.get(key);
+    if (!provider) {
+        provider = new ChainRpcProvider(urls, chain.evmChainId, options);
+        shared.set(key, provider);
+    }
+    return provider;
+}
+/** For tests. */
+export function resetSharedChainProviders() {
+    for (const provider of shared.values())
+        provider.destroy();
+    shared.clear();
+}
+//# sourceMappingURL=chain-rpc.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,180 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { Contract, Interface, isError } from 'ethers';
+import { startFakeChainRpc } from './chain-rpc-test-support.js';
+import { ChainRpcProvider, MULTICALL3_ADDRESS, resetSharedChainProviders, RpcUnavailableError, sharedChainProvider } from './chain-rpc.js';
+const USDC = '0x' + 'a1'.repeat(20);
+const ERC20 = ['function balanceOf(address owner) view returns (uint256)'];
+const addresses = Array.from({ length: 5 }, (_, index) => '0x' + String(index + 1).padStart(2, '0').repeat(20));
+test('identical reads in flight share one request', async (t) => {
+    const rpc = await startFakeChainRpc();
+    t.after(() => rpc.close());
+    const provider = new ChainRpcProvider([rpc.url], 8453);
+    t.after(() => provider.destroy());
+    // `send` skips ethers' own short-lived result cache, so this exercises the provider's coalescing.
+    const read = () => provider.send('eth_getCode', [addresses[0], 'latest']);
+    assert.deepEqual(await Promise.all([read(), read(), read()]), ['0x6080604052', '0x6080604052', '0x6080604052']);
+    assert.equal(rpc.requests, 1);
+    assert.equal(provider.stats().coalesced, 2);
+    await read();
+    assert.equal(rpc.requests, 1, 'deployed code is remembered');
+});
+test('concurrent eth_calls go out as one Multicall3 call', async (t) => {
+    const rpc = await startFakeChainRpc();
+    t.after(() => rpc.close());
+    addresses.forEach((address, index) => rpc.usdc.set(address.toLowerCase(), BigInt(index + 1) * 1000000n));
+    const provider = new ChainRpcProvider([rpc.url], 8453);
+    t.after(() => provider.destroy());
+    const usdc = new Contract(USDC, ERC20, provider);
+    const read = () => Promise.all(addresses.map((address) => usdc.getFunction('balanceOf').staticCall(address)));
+    assert.deepEqual(await read(), [1000000n, 2000000n, 3000000n, 4000000n, 5000000n]);
+    // One probe for Multicall3's code, then one aggregate3 call.
+    assert.deepEqual(rpc.byMethod, { eth_getCode: 1, eth_call: 1 });
+    assert.equal(rpc.batchedCalls, 5);
+    rpc.reset();
+    await read();
+    assert.deepEqual(rpc.byMethod, { eth_call: 1 }, 'the Multicall3 code is remembered');
+});
+test('without Multicall3 the calls are sent one by one', async (t) => {
+    const rpc = await startFakeChainRpc({ multicall: false });
+    t.after(() => rpc.close());
+    const provider = new ChainRpcProvider([rpc.url], 8453);
+    t.after(() => provider.destroy());
+    const usdc = new Contract(USDC, ERC20, provider);
+    await Promise.all(addresses.map((address) => usdc.getFunction('balanceOf').staticCall(address)));
+    assert.equal(rpc.byMethod['eth_call'], 5);
+});
+test('only allow-listed reads are batched: anything else keeps its own eth_call and msg.sender', async (t) => {
+    const rpc = await startFakeChainRpc();
+    t.after(() => rpc.close());
+    const provider = new ChainRpcProvider([rpc.url], 8453);
+    t.after(() => provider.destroy());
+    const token = new Contract(USDC, [...ERC20, 'function allowance(address owner, address spender) view returns (uint256)'], provider);
+    await Promise.all([
+        ...addresses.slice(0, 2).map((address) => token.getFunction('balanceOf').staticCall(address)),
+        token.getFunction('allowance').staticCall(addresses[0], addresses[1]),
+        token.getFunction('allowance').staticCall(addresses[1], addresses[2]),
+    ]);
+    // One aggregate3 for the two balanceOf reads, one eth_call per allowance.
+    assert.deepEqual(rpc.byMethod, { eth_getCode: 1, eth_call: 3 });
+    assert.equal(rpc.batchedCalls, 2);
+});
+test('buyer reward reads are batched', async (t) => {
+    const rpc = await startFakeChainRpc();
+    t.after(() => rpc.close());
+    const provider = new ChainRpcProvider([rpc.url], 8453);
+    t.after(() => provider.destroy());
+    const rewards = new Contract(USDC, ['function pendingBuyerReward(address buyer, uint256 epoch) view returns (uint256)', 'function currentEpoch() view returns (uint256)'], provider);
+    await Promise.all([
+        rewards.getFunction('pendingBuyerReward').staticCall(addresses[0], 3),
+        rewards.getFunction('pendingBuyerReward').staticCall(addresses[0], 4),
+        rewards.getFunction('currentEpoch').staticCall(),
+    ]);
+    assert.deepEqual(rpc.byMethod, { eth_getCode: 1, eth_call: 1 });
+    assert.equal(rpc.batchedCalls, 3);
+});
+test('a reverting call inside a batch fails alone, as a CALL_EXCEPTION', async (t) => {
+    const multicall = new Interface(['function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) payable returns (tuple(bool success, bytes returnData)[] returnData)']);
+    const word = (value) => '0x' + value.toString(16).padStart(64, '0');
+    const transport = async (_url, body) => {
+        const request = JSON.parse(body);
+        if (request.method === 'eth_getCode')
+            return { status: 200, body: { jsonrpc: '2.0', id: request.id, result: '0x60' } };
+        assert.equal(request.params[0].to.toLowerCase(), MULTICALL3_ADDRESS.toLowerCase());
+        const [calls] = multicall.decodeFunctionData('aggregate3', request.params[0].data);
+        const results = calls.map((_, index) => index === 1 ? { success: false, returnData: '0x' } : { success: true, returnData: word(7n) });
+        return { status: 200, body: { jsonrpc: '2.0', id: request.id, result: multicall.encodeFunctionResult('aggregate3', [results]) } };
+    };
+    const provider = new ChainRpcProvider(['https://rpc.example.test'], 8453, { transport });
+    t.after(() => provider.destroy());
+    const usdc = new Contract(USDC, ERC20, provider);
+    const settled = await Promise.allSettled(addresses.slice(0, 3).map((address) => usdc.getFunction('balanceOf').staticCall(address)));
+    assert.equal(settled[0].status, 'fulfilled');
+    assert.equal(settled[0].value, 7n);
+    assert.equal(settled[1].status, 'rejected');
+    assert.ok(isError(settled[1].reason, 'CALL_EXCEPTION'));
+    assert.equal(settled[2].status, 'fulfilled');
+});
+test('an aggregate refused with HTTP 413 falls back to one call each', async (t) => {
+    const word = (value) => '0x' + value.toString(16).padStart(64, '0');
+    let aggregates = 0;
+    let singles = 0;
+    const transport = async (_url, body) => {
+        const request = JSON.parse(body);
+        if (request.method === 'eth_getCode')
+            return { status: 200, body: { jsonrpc: '2.0', id: request.id, result: '0x60' } };
+        if (request.params[0].to.toLowerCase() === MULTICALL3_ADDRESS.toLowerCase()) {
+            aggregates += 1;
+            return { status: 413, body: null };
+        }
+        singles += 1;
+        return { status: 200, body: { jsonrpc: '2.0', id: request.id, result: word(5n) } };
+    };
+    const provider = new ChainRpcProvider(['https://rpc.example.test'], 8453, { transport });
+    t.after(() => provider.destroy());
+    const usdc = new Contract(USDC, ERC20, provider);
+    const values = await Promise.all(addresses.slice(0, 3).map((address) => usdc.getFunction('balanceOf').staticCall(address)));
+    assert.deepEqual(values, [5n, 5n, 5n]);
+    assert.equal(aggregates, 1);
+    assert.equal(singles, 3);
+});
+test('a rate-limited endpoint is skipped for a jittered, growing back-off; then the call fails fast without touching the network', async (t) => {
+    const primary = await startFakeChainRpc();
+    const fallback = await startFakeChainRpc();
+    t.after(() => primary.close());
+    t.after(() => fallback.close());
+    let now = 1_000_000;
+    const provider = new ChainRpcProvider([primary.url, fallback.url], 8453, { now: () => now, random: () => 0, backoffBaseMs: 2_000, batchWindowMs: null });
+    t.after(() => provider.destroy());
+    primary.rateLimit(Number.POSITIVE_INFINITY);
+    assert.equal(await provider.getBalance(addresses[0]), 0n, 'the fallback answers');
+    assert.equal(primary.requests, 1);
+    assert.equal(fallback.requests, 1);
+    await provider.getBalance(addresses[1]);
+    assert.equal(primary.requests, 1, 'the throttling endpoint is not retried while it backs off');
+    assert.equal(fallback.requests, 2);
+    fallback.rateLimitStyle = 'jsonrpc';
+    fallback.rateLimit(Number.POSITIVE_INFINITY);
+    now += 5_000; // past the primary's first back-off (2 s base, equal jitter at random()=0 → 1 s)
+    await assert.rejects(provider.getBalance(addresses[2]), (error) => error instanceof RpcUnavailableError || /rate limiting/.test(String(error)));
+    const sent = primary.requests + fallback.requests;
+    await assert.rejects(provider.getBalance(addresses[3]), /backing off/);
+    assert.equal(primary.requests + fallback.requests, sent, 'refused locally while every endpoint backs off');
+    assert.equal(provider.stats().shortCircuited, 1);
+    // Second consecutive failure of the primary: 4 s base → at least 2 s.
+    const until = provider.unavailableUntil;
+    assert.ok(until >= now + 1_000);
+    primary.rateLimit(0);
+    fallback.rateLimit(0);
+    now = until + 1;
+    assert.equal(await provider.getBalance(addresses[4]), 0n, 'recovers once the back-off passes');
+});
+test('Retry-After is honoured as the minimum back-off', async (t) => {
+    let now = 0;
+    let calls = 0;
+    const transport = async (_url, body) => {
+        calls++;
+        if (calls === 1)
+            return { status: 429, body: null, retryAfterMs: 30_000 };
+        return { status: 200, body: { jsonrpc: '2.0', id: JSON.parse(body).id, result: '0x0' } };
+    };
+    const provider = new ChainRpcProvider(['https://rpc.example.test'], 8453, { transport, now: () => now, random: () => 0, batchWindowMs: null });
+    t.after(() => provider.destroy());
+    const read = () => provider.send('eth_blockNumber', []);
+    await assert.rejects(read());
+    now = 29_000;
+    await assert.rejects(read(), /backing off/);
+    assert.equal(calls, 1);
+    now = 30_001;
+    assert.equal(await read(), '0x0');
+});
+test('one shared provider per chain and endpoint list', () => {
+    resetSharedChainProviders();
+    const a = sharedChainProvider({ evmChainId: 8453, rpcUrl: 'https://one.example.test', fallbackRpcUrls: ['https://two.example.test'] });
+    const b = sharedChainProvider({ evmChainId: 8453, rpcUrl: 'https://one.example.test', fallbackRpcUrls: ['https://two.example.test'] });
+    const c = sharedChainProvider({ evmChainId: 8453, rpcUrl: 'https://three.example.test' });
+    assert.equal(a, b);
+    assert.notEqual(a, c);
+    resetSharedChainProviders();
+});
+//# sourceMappingURL=chain-rpc.test.js.map