web3-tools-mcp 2.0.2 → 3.0.0

package/CHANGELOG.md

@@ -2,6 +2,103 @@
 
 Notable changes per release. Dates are release dates; unreleased work sits at the top.
 
+## [3.0.0] — 2026-09-23
+
+The theme is multi-tenancy: one server can now carry several people without their wallets
+meeting. Nothing turns that on by itself — a server still authenticates its deployment
+rather than a person, so everyone on it remains the same user until something issues
+distinct identities.
+
+`web3-wallet-relay` goes to 2.0.0 alongside, and `web3-tools-mcp` pins it exactly: the
+handshake changed, so a mismatched pair cannot pair at all.
+
+### Changed
+
+- **Tracing uses a node that is already running, instead of starting one.** Each trace used
+  to spawn an Anvil fork and kill it afterwards, which on a shared server is unbounded child
+  processes. It now talks to `ANVIL_RPC_URL`, defaulting to `127.0.0.1:8545` — any node
+  exposing `debug_traceCall` will do, and a provider whose RPC can trace is still preferred.
+
+  Anvil serves no block below its own fork height, so replaying an older transaction means
+  re-forking the node there, which clears whatever state it held. That only happens with
+  `ANVIL_ALLOW_RESET=1`; without it the trace fails and says so. The node is returned to
+  head afterwards rather than left pinned to an old block.
+
+  Re-forking reads state from the chain's configured RPC, so tracing an old transaction
+  needs one with archive access — a provider key or a `CUSTOM_RPC`. The hard-coded archive
+  endpoint for Arbitrum is gone.
+
+### Added
+
+- **Several phone wallets can be paired at once** — a hot wallet and a hardware one, say.
+  `pair_phone_wallet` used to report that one was already paired and stop; it now pairs, and
+  says which wallets the new one joins. `wallet_status` lists them all, and the signing
+  tools take `account` to choose between them, as does `disconnect_phone_wallet` — which
+  still clears everything when no account is named. With one wallet paired nothing changes,
+  and omitting `account` uses the most recently paired.
+
+### Security
+
+- **Signing is scoped to whoever asked for it.** Every tool call now carries the identity it
+  is acting for, and both signers are keyed by it: a wallet page reaches only the person it
+  belongs to, and a phone session is matched by a binding recorded when it was approved.
+  Sessions were previously picked as "the most recently paired", so on a server with more
+  than one user a signing request could be sent to somebody else's phone — and
+  `disconnect_phone_wallet` ended everybody's sessions. Phones paired before this keep
+  working on a single-user server.
+
+- **Relay tokens name the room they admit you to**, signed by the relay's secret, so the
+  server can mint a pair per person and the relay needs no record of who exists. Naming a
+  room without the signature is refused.
+
+- **The relay bounds what one room can take.** A frame over 512KB is refused, rather than
+  the 100MB the WebSocket library would otherwise accept, and a room holds at most 16
+  connections. Neither is reachable in normal use — contract creation calldata tops out
+  near 98KB of hex, and a person needs a wallet tab or two plus a requester per editor
+  session — but without them one connection could exhaust the process for everybody else.
+
+- **`localhost` is not a chain a hosted server will accept.** It resolves to the machine
+  running the server, so on a shared deployment it was a way to aim requests at whatever
+  that host had listening on its own loopback. Self-hosted runs are unaffected.
+
+  The same switch keeps a hosted server from probing its own loopback for a tracing node
+  and from opening a browser on itself. The CLI flips it with `MCP_HTTP_PORT`; a host that
+  assembles its own server from the library sets `MCP_HOSTED=1` before importing it, and
+  `startHttpServer` refuses to run without one of the two.
+
+- **The relay drops a frame it cannot use instead of dying on it.** A peer that had
+  authenticated could send `null` — valid JSON, not an object — and take the relay down,
+  along with the MCP server it is embedded in when hosted. Tokens are also compared in
+  constant time.
+
+- **A request signs from the account it named.** With a session exposing several
+  addresses, `account` chose the session but the transaction was still sent from its first
+  address. Concurrent pairings on one server no longer overwrite each other's ownership
+  record, and a hosted server closes a person's idle relay socket after ten minutes
+  instead of holding one open per person forever.
+
+- **The signing page and the MCP server now hold different tokens.** One token granted both
+  roles, and a relay client may either answer transaction proposals (the page) or make them
+  (the server). The page's token is the exposed one — it rides in a URL you open, keep in
+  history and show on screen — so anyone who saw it could push proposals at your wallet.
+  The page's token is derived from the server's and grants the signing role only; the
+  server's never reaches a browser.
+
+  **Re-open the signing page from the link the server prints.** Pairing URLs issued before
+  this carry a token the relay no longer accepts for signing.
+
+- **The signing page no longer takes the transaction's value from the preview.** The preview
+  travels with the request and is forwarded untouched, so a hostile requester could state
+  one amount while the calldata did another. The value is now read from the transaction
+  itself, and the calldata is shown even when a decoded view is available, so a claim that
+  disagrees with the bytes is visible on the same screen.
+
+- **A relay can serve several people without their wallets meeting.** Connections resolve to
+  a room, and a transaction only ever reaches a page in the same one. Previously the relay
+  offered each transaction to whichever page was first in its pool, broadcast the first
+  signer's address to every requester, and let any page answer a request by its id. A
+  self-hosted relay keeps one room and behaves exactly as before.
+
 ## [2.0.2] — 2026-09-22
 
 ### Fixed

package/README.md

@@ -396,6 +396,11 @@ Then point the server at it with `WALLET_SERVER_URL` and the same `WALLET_TOKEN`
 `render.yaml` deploys it as-is. Anyone holding `WALLET_TOKEN` can send your browser a
 transaction to sign — treat it like a password, and always serve over HTTPS.
 
+The pairing link the server prints carries a different token, derived from that one, which
+can only answer signing requests and not make them. Sharing a pairing link is therefore not
+the same as sharing `WALLET_TOKEN` — but it still lets whoever has it act as your wallet
+page, so a signing request can reach them instead of you.
+
 Locally nothing changes: the server embeds the same relay.
 
 </details>

package/dist/anvil.d.ts

@@ -1,22 +1,12 @@
-import { type ChildProcess } from 'node:child_process';
-import { createPublicClient } from 'viem';
-export interface AnvilInstance {
-    process: ChildProcess;
-    port: number;
-    rpcUrl: string;
-    client: ReturnType<typeof createPublicClient>;
-}
-export interface AnvilConfig {
-    forkUrl: string;
-    forkBlockNumber?: bigint;
-    port?: number;
-    chainId?: number;
-}
-export declare function isAnvilInstalled(): Promise<boolean>;
-export declare function startAnvil(config: AnvilConfig): Promise<AnvilInstance>;
-export declare function stopAnvil(instance: AnvilInstance): void;
-export declare function withAnvil<T>(config: AnvilConfig, fn: (instance: AnvilInstance) => Promise<T>): Promise<T>;
-export declare function traceTransactionWithAnvil(forkUrl: string, transactionHash: string, blockNumber: bigint, tracer?: 'callTracer' | 'prestateTracer' | 'stateDiffTracer', chainName?: string): Promise<unknown>;
+/**
+ * The node to ask for traces, or undefined when there is none.
+ *
+ * Hosted, only an explicit setting counts: defaulting to loopback would turn every trace
+ * into a request against the server's own private network.
+ */
+export declare function debugRpcUrl(): string | undefined;
+/** Whether a tracing node is reachable and actually offers the debug namespace. */
+export declare function isDebugNodeAvailable(): Promise<boolean>;
 export interface SimulateCallParams {
     to: string;
     data?: string;
@@ -24,6 +14,14 @@ export interface SimulateCallParams {
     value?: bigint;
     gas?: bigint;
 }
+/**
+ * Replay a transaction through the tracing node.
+ *
+ * Run against the block before it, so the state is what the transaction actually saw. The
+ * node needs archive access to that block; without it this fails rather than quietly
+ * tracing against the wrong state.
+ */
+export declare function traceTransactionWithAnvil(forkUrl: string, transactionHash: string, blockNumber: bigint, tracer?: 'callTracer' | 'prestateTracer' | 'stateDiffTracer'): Promise<unknown>;
 export declare function simulateCallWithTrace(forkUrl: string, params: SimulateCallParams, blockNumber?: bigint, tracer?: 'callTracer' | 'prestateTracer'): Promise<{
     result: string;
     trace: unknown;

package/dist/anvil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anvil.d.ts","sourceRoot":"","sources":["../src/anvil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAQ,MAAM,MAAM,CAAA;AAG/C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAGD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAMzD;AAyBD,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAoF5E;AAGD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAIvD;AAGD,wBAAsB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAO/G;AAQD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,YAAY,GAAG,gBAAgB,GAAG,iBAAgC,EAC1E,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAiDlB;AAGD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,EAC1B,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,GAAE,YAAY,GAAG,gBAA+B,GACrD,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAC,CAmFD"}
+{"version":3,"file":"anvil.d.ts","sourceRoot":"","sources":["../src/anvil.ts"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAGhD;AAMD,mFAAmF;AACnF,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAe7D;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AA0ED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,YAAY,GAAG,gBAAgB,GAAG,iBAAgC,GACzE,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,EAC1B,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,GAAE,YAAY,GAAG,gBAA+B,GACrD,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAC,CAiCD"}

package/dist/anvil.js

@@ -1,256 +1,152 @@
-import { spawn } from 'node:child_process';
 import { createPublicClient, http } from 'viem';
 import { mainnet } from 'viem/chains';
-// Check if anvil is installed
-export async function isAnvilInstalled() {
-    return new Promise((resolve) => {
-        const proc = spawn('anvil', ['--version'], { shell: true });
-        proc.on('close', (code) => resolve(code === 0));
-        proc.on('error', () => resolve(false));
-    });
+import { HOSTED } from './hosted.js';
+/**
+ * Tracing through a node that already supports `debug_*`, usually a local Anvil. Nothing
+ * is started here.
+ *
+ * Anvil serves no block below its own fork height — `debug_traceCall` at an earlier one
+ * fails with BlockOutOfRangeError — so replaying an old transaction means re-forking the
+ * node there with `anvil_reset`. That discards whatever state it held, which is why it
+ * happens only when ANVIL_ALLOW_RESET says so. A provider whose endpoint exposes
+ * `debug_traceTransaction` needs none of this and is tried first.
+ */
+const DEFAULT_DEBUG_RPC = 'http://127.0.0.1:8545';
+/** Re-forking clears the node, so it is never done to someone's dev chain uninvited. */
+const ALLOW_RESET = ['1', 'true', 'yes'].includes((process.env.ANVIL_ALLOW_RESET ?? '').toLowerCase());
+/**
+ * The node to ask for traces, or undefined when there is none.
+ *
+ * Hosted, only an explicit setting counts: defaulting to loopback would turn every trace
+ * into a request against the server's own private network.
+ */
+export function debugRpcUrl() {
+    if (process.env.ANVIL_RPC_URL)
+        return process.env.ANVIL_RPC_URL;
+    return HOSTED ? undefined : DEFAULT_DEBUG_RPC;
 }
-// Find an available port
-async function findAvailablePort(startPort = 8545) {
-    const net = await import('node:net');
-    return new Promise((resolve, reject) => {
-        const server = net.createServer();
-        server.listen(startPort, () => {
-            const address = server.address();
-            if (address && typeof address === 'object') {
-                server.close(() => resolve(address.port));
-            }
-            else {
-                server.close(() => reject(new Error('Could not get port')));
-            }
-        });
-        server.on('error', () => {
-            // Port in use, try next one
-            findAvailablePort(startPort + 1)
-                .then(resolve)
-                .catch(reject);
-        });
-    });
+function debugClient(url) {
+    return createPublicClient({ chain: mainnet, transport: http(url) });
 }
-// Start an Anvil instance
-export async function startAnvil(config) {
-    const installed = await isAnvilInstalled();
-    if (!installed) {
-        throw new Error('Anvil is not installed. Please install Foundry: https://book.getfoundry.sh/getting-started/installation');
-    }
-    const port = config.port ?? (await findAvailablePort());
-    const rpcUrl = `http://127.0.0.1:${port}`;
-    const args = ['--fork-url', config.forkUrl, '--port', port.toString(), '--silent'];
-    if (config.forkBlockNumber !== undefined) {
-        args.push('--fork-block-number', config.forkBlockNumber.toString());
+/** Whether a tracing node is reachable and actually offers the debug namespace. */
+export async function isDebugNodeAvailable() {
+    const url = debugRpcUrl();
+    if (!url)
+        return false;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ jsonrpc: '2.0', method: 'web3_clientVersion', params: [], id: 1 }),
+            signal: AbortSignal.timeout(2000)
+        });
+        return response.ok;
     }
-    if (config.chainId !== undefined) {
-        args.push('--chain-id', config.chainId.toString());
+    catch {
+        return false;
     }
-    return new Promise((resolve, reject) => {
-        const proc = spawn('anvil', args, {
-            shell: true,
-            stdio: ['ignore', 'pipe', 'pipe']
-        });
-        let stderr = '';
-        proc.stderr?.on('data', (data) => {
-            stderr += data.toString();
-        });
-        proc.on('error', (err) => {
-            reject(new Error(`Failed to start Anvil: ${err.message}`));
-        });
-        proc.on('close', (code) => {
-            if (code !== 0 && code !== null) {
-                reject(new Error(`Anvil exited with code ${code}: ${stderr}`));
-            }
-        });
-        // Wait for Anvil to be ready by polling the RPC
-        const maxAttempts = 50; // 5 seconds
-        let attempts = 0;
-        const checkReady = async () => {
-            attempts++;
-            try {
-                const response = await fetch(rpcUrl, {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({
-                        jsonrpc: '2.0',
-                        method: 'eth_blockNumber',
-                        params: [],
-                        id: 1
-                    })
-                });
-                if (response.ok) {
-                    // Add small delay to ensure all RPC methods are ready (including debug_*)
-                    await new Promise((r) => setTimeout(r, 100));
-                    const client = createPublicClient({
-                        chain: mainnet, // Chain is overridden by fork anyway
-                        transport: http(rpcUrl)
-                    });
-                    resolve({ process: proc, port, rpcUrl, client });
-                }
-                else if (attempts < maxAttempts) {
-                    setTimeout(checkReady, 100);
-                }
-                else {
-                    proc.kill();
-                    reject(new Error('Anvil failed to start within timeout'));
-                }
-            }
-            catch {
-                if (attempts < maxAttempts) {
-                    setTimeout(checkReady, 100);
-                }
-                else {
-                    proc.kill();
-                    reject(new Error('Anvil failed to start within timeout'));
-                }
-            }
-        };
-        // Start checking after a small delay
-        setTimeout(checkReady, 200);
-    });
 }
-// Stop an Anvil instance
-export function stopAnvil(instance) {
-    if (instance.process && !instance.process.killed) {
-        instance.process.kill('SIGTERM');
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+function callObject(params) {
+    return {
+        to: params.to,
+        data: params.data,
+        from: params.from ?? ZERO_ADDRESS,
+        value: params.value ? `0x${params.value.toString(16)}` : undefined,
+        gas: params.gas ? `0x${params.gas.toString(16)}` : undefined
+    };
+}
+function blockTag(blockNumber) {
+    return blockNumber === undefined ? 'latest' : `0x${blockNumber.toString(16)}`;
+}
+function requireDebugNode() {
+    const url = debugRpcUrl();
+    if (!url) {
+        throw new Error('No tracing node configured. Set ANVIL_RPC_URL to a node exposing debug_traceCall, such as a local Anvil.');
     }
+    return url;
+}
+function isBlockOutOfRange(error) {
+    return /BlockOutOfRangeError|block height is/i.test(error?.message ?? '');
 }
-// Helper to run a function with a temporary Anvil instance
-export async function withAnvil(config, fn) {
-    const instance = await startAnvil(config);
+/**
+ * Run something against a block, re-forking the node when it cannot reach that far back.
+ *
+ * Returns to head afterwards rather than leaving the node pinned to an old block, which
+ * would silently break whatever the owner does with it next. Its state is gone either way.
+ */
+async function atBlock(client, forkUrl, blockNumber, run) {
     try {
-        return await fn(instance);
+        return await run(blockTag(blockNumber));
     }
-    finally {
-        stopAnvil(instance);
+    catch (error) {
+        if (blockNumber === undefined || !isBlockOutOfRange(error))
+            throw error;
+        if (!ALLOW_RESET) {
+            throw new Error(`The tracing node is forked past block ${blockNumber}, and Anvil serves nothing earlier. Re-forking it there would clear its state, so set ANVIL_ALLOW_RESET=1 to allow that — or use an RPC whose endpoint supports debug_traceTransaction.`);
+        }
+        const refork = (block) => client.request({
+            method: 'anvil_reset',
+            params: [{ forking: { jsonRpcUrl: forkUrl, ...(block === undefined ? {} : { blockNumber: Number(block) }) } }]
+        });
+        await refork(blockNumber);
+        try {
+            return await run('latest');
+        }
+        finally {
+            await refork().catch(() => { });
+        }
     }
 }
-// Archive RPC URLs for chains that need historical state access
-const ARCHIVE_RPCS = {
-    arbitrum: 'https://arbitrum-one.arpc.x.superfluid.dev'
-};
-// Trace a transaction using Anvil fork
-export async function traceTransactionWithAnvil(forkUrl, transactionHash, blockNumber, tracer = 'callTracer', chainName) {
-    // Use archive RPC if available for better historical state access
-    const archiveUrl = chainName && ARCHIVE_RPCS[chainName] ? ARCHIVE_RPCS[chainName] : forkUrl;
-    // First, fetch the original transaction from the RPC
-    const fetchClient = createPublicClient({
-        chain: mainnet,
-        transport: http(forkUrl)
-    });
-    const tx = await fetchClient.getTransaction({
-        hash: transactionHash
-    });
-    if (!tx) {
+function traceCall(client, call, block, tracer) {
+    return client.request({ method: 'debug_traceCall', params: [call, block, { tracer }] });
+}
+/**
+ * Replay a transaction through the tracing node.
+ *
+ * Run against the block before it, so the state is what the transaction actually saw. The
+ * node needs archive access to that block; without it this fails rather than quietly
+ * tracing against the wrong state.
+ */
+export async function traceTransactionWithAnvil(forkUrl, transactionHash, blockNumber, tracer = 'callTracer') {
+    const tx = await debugClient(forkUrl).getTransaction({ hash: transactionHash });
+    if (!tx)
         throw new Error(`Transaction ${transactionHash} not found`);
-    }
-    // Fork at the block BEFORE the transaction to replay it accurately
-    // Note: This requires an archival RPC that has historical state
-    const forkBlock = blockNumber > 0n ? blockNumber - 1n : 0n;
-    return withAnvil({
-        forkUrl: archiveUrl,
-        forkBlockNumber: forkBlock
-    }, async (instance) => {
-        // Use debug_traceCall to simulate and trace the transaction
-        // Note: This replays the tx against the post-block state, which may differ slightly
-        // from the original execution if state changed within the block
-        const trace = await instance.client.request({
-            method: 'debug_traceCall',
-            params: [
-                {
-                    from: tx.from,
-                    to: tx.to,
-                    data: tx.input,
-                    value: tx.value ? `0x${tx.value.toString(16)}` : '0x0',
-                    gas: tx.gas ? `0x${tx.gas.toString(16)}` : undefined
-                },
-                'latest',
-                { tracer }
-            ]
-        });
-        return trace;
-    });
+    const client = debugClient(requireDebugNode());
+    const call = callObject({ to: tx.to ?? ZERO_ADDRESS, data: tx.input, from: tx.from, value: tx.value, gas: tx.gas });
+    return atBlock(client, forkUrl, blockNumber > 0n ? blockNumber - 1n : 0n, (block) => traceCall(client, call, block, tracer));
 }
 export async function simulateCallWithTrace(forkUrl, params, blockNumber, tracer = 'callTracer') {
-    return withAnvil({
-        forkUrl,
-        forkBlockNumber: blockNumber
-    }, async (instance) => {
-        // First, try a regular call to get the result
+    const client = debugClient(requireDebugNode());
+    const call = callObject(params);
+    // Call, gas and trace all inside one atBlock, so they describe the same state: a block
+    // the node cannot serve re-forks it once, instead of being reported as a revert.
+    return atBlock(client, forkUrl, blockNumber, async (block) => {
         let result = '0x';
         let success = true;
         let revertReason;
         let gasUsed = 0n;
         try {
-            // Use eth_call to get the result
-            result = (await instance.client.request({
-                method: 'eth_call',
-                params: [
-                    {
-                        to: params.to,
-                        data: params.data,
-                        from: params.from ?? '0x0000000000000000000000000000000000000000',
-                        value: params.value ? `0x${params.value.toString(16)}` : undefined,
-                        gas: params.gas ? `0x${params.gas.toString(16)}` : undefined
-                    },
-                    'latest'
-                ]
-            }));
-            // Estimate gas
-            try {
-                gasUsed = await instance.client.estimateGas({
-                    to: params.to,
-                    data: params.data,
-                    account: params.from,
-                    value: params.value
-                });
-            }
-            catch {
-                // Ignore gas estimation errors
-            }
+            result = (await client.request({ method: 'eth_call', params: [call, block] }));
+            gasUsed = await client
+                .request({ method: 'eth_estimateGas', params: [call, block] })
+                .then((gas) => BigInt(gas))
+                // Gas estimation is a nicety; a failure here says nothing about the call itself.
+                .catch(() => 0n);
         }
         catch (error) {
+            if (isBlockOutOfRange(error))
+                throw error;
             success = false;
-            const errorMessage = error.message;
-            // Try to extract revert reason
-            const revertMatch = errorMessage.match(/revert(?:ed)?[:\s]*(.+?)(?:\n|$)/i);
-            if (revertMatch) {
-                revertReason = revertMatch[1].trim();
-            }
-            else {
-                revertReason = errorMessage;
-            }
+            const message = error.message;
+            revertReason = message.match(/revert(?:ed)?[:\s]*(.+?)(?:\n|$)/i)?.[1]?.trim() ?? message;
         }
-        // Get the trace using debug_traceCall
-        let trace = null;
-        try {
-            trace = await instance.client.request({
-                method: 'debug_traceCall',
-                params: [
-                    {
-                        to: params.to,
-                        data: params.data,
-                        from: params.from ?? '0x0000000000000000000000000000000000000000',
-                        value: params.value ? `0x${params.value.toString(16)}` : undefined,
-                        gas: params.gas ? `0x${params.gas.toString(16)}` : undefined
-                    },
-                    'latest',
-                    { tracer }
-                ]
-            });
-        }
-        catch (traceError) {
-            // If tracing fails, include the error
-            trace = { error: traceError.message };
-        }
-        return {
-            result,
-            trace,
-            gasUsed,
-            success,
-            revertReason
-        };
+        const trace = await traceCall(client, call, block, tracer).catch((error) => {
+            if (isBlockOutOfRange(error))
+                throw error;
+            return { error: error.message };
+        });
+        return { result, trace, gasUsed, success, revertReason };
     });
 }
 //# sourceMappingURL=anvil.js.map

package/dist/anvil.js.map

@@ -1 +1 @@
-{"version":3,"file":"anvil.js","sourceRoot":"","sources":["../src/anvil.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"anvil.js","sourceRoot":"","sources":["../src/anvil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC;;;;;;;;;GASG;AAEH,MAAM,iBAAiB,GAAG,uBAAuB,CAAA;AAEjD,wFAAwF;AACxF,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;AAEtG;;;;;GAKG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IAC/D,OAAO,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAA;AAC/C,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,kBAAkB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACrE,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,GAAG,GAAG,WAAW,EAAE,CAAA;IACzB,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAA;IAEtB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;YACzF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAA;QACF,OAAO,QAAQ,CAAC,EAAE,CAAA;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAUD,MAAM,YAAY,GAAG,4CAA4C,CAAA;AAEjE,SAAS,UAAU,CAAC,MAA0B;IAC5C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,YAAY;QACjC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QAClE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,WAAoB;IACpC,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAA;AAC/E,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,GAAG,GAAG,WAAW,EAAE,CAAA;IACzB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0GAA0G,CAAC,CAAA;IAC7H,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,uCAAuC,CAAC,IAAI,CAAE,KAAe,EAAE,OAAO,IAAI,EAAE,CAAC,CAAA;AACtF,CAAC;AAID;;;;;GAKG;AACH,KAAK,UAAU,OAAO,CACpB,MAAmB,EACnB,OAAe,EACf,WAA+B,EAC/B,GAAkC;IAElC,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;QAEvE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,WAAW,yLAAyL,CAC9O,CAAA;QACH,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE,CAChC,MAAM,CAAC,OAAO,CAAC;YACb,MAAM,EAAE,aAAsB;YAC9B,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAU;SACxH,CAAC,CAAA;QAEJ,MAAM,MAAM,CAAC,WAAW,CAAC,CAAA;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAAmB,EAAE,IAAmC,EAAE,KAAa,EAAE,MAAc;IACxG,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,iBAA0B,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,CAAU,EAAE,CAAC,CAAA;AAC3G,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAe,EACf,eAAuB,EACvB,WAAmB,EACnB,SAA8D,YAAY;IAE1E,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,eAAgC,EAAE,CAAC,CAAA;IAChG,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,eAAe,YAAY,CAAC,CAAA;IAEpE,MAAM,MAAM,GAAG,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAA;IACnH,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;AAC9H,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,MAA0B,EAC1B,WAAoB,EACpB,SAA0C,YAAY;IAQtD,MAAM,MAAM,GAAG,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAE/B,uFAAuF;IACvF,iFAAiF;IACjF,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC3D,IAAI,MAAM,GAAG,IAAI,CAAA;QACjB,IAAI,OAAO,GAAG,IAAI,CAAA;QAClB,IAAI,YAAgC,CAAA;QACpC,IAAI,OAAO,GAAG,EAAE,CAAA;QAEhB,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAmB,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,CAAU,EAAE,CAAC,CAAW,CAAA;YAC1G,OAAO,GAAG,MAAM,MAAM;iBACnB,OAAO,CAAC,EAAE,MAAM,EAAE,iBAA0B,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,CAAU,EAAE,CAAC;iBAC/E,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAa,CAAC,CAAC;gBACrC,iFAAiF;iBAChF,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,iBAAiB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAA;YACzC,OAAO,GAAG,KAAK,CAAA;YACf,MAAM,OAAO,GAAI,KAAe,CAAC,OAAO,CAAA;YACxC,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,OAAO,CAAA;QAC3F,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACzE,IAAI,iBAAiB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAA;YACzC,OAAO,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;IAC1D,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/chains.d.ts

@@ -954,7 +954,15 @@ declare const TABLE: {
 };
 export type ChainName = keyof typeof TABLE;
 export declare const CHAINS: Record<ChainName, ChainInfo>;
-/** Tuple rather than array, because `z.enum` needs a non-empty literal list. */
+/**
+ * Chains the tools will accept.
+ *
+ * `localhost` is dropped when hosted. It resolves to the machine running the server, so on
+ * a shared host it is not the caller's dev node — it is a way to aim requests at whatever
+ * that host has listening on its own loopback.
+ *
+ * Tuple rather than array, because `z.enum` needs a non-empty literal list.
+ */
 export declare const SUPPORTED_CHAINS: [ChainName, ...ChainName[]];
 export {};
 //# sourceMappingURL=chains.d.ts.map

package/dist/chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAiBjC;;;;GAIG;AACH,UAAU,SAAS;IACjB,KAAK,EAAE,KAAK,CAAA;IACZ,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gFAoEa,CAAC;;;;;sFAQa,CAAC;;;;;6FAUxB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gFAnBkC,CAAC;;;;;sFAQpC,CAAC;;;;;6FASoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+EArDI,CAAC;;;;;qFAWzB,CAAC;;;;;4FAUT,CAAC;;;;;yFAamB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gFALI,CAAC;;;;;sFAQvB,CAAC;;;;;6FASR,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BApGJ,CAAC;;;;;0BAMiE,CAAC;;;;;;;;2BAQjD,CAAC;oCAET,CAAC;0BAEG,CAAC;+BACR,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGoC,CAAA;AAE9C,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,KAAK,CAAA;AAI1C,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAS,CAAA;AAEzD,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,EAA0B,CAAC,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC,CAAA"}
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAkBjC;;;;GAIG;AACH,UAAU,SAAS;IACjB,KAAK,EAAE,KAAK,CAAA;IACZ,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gFAmEuD,CAAC;;;;;sFAS/D,CAAF;;;;;6FASS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gFAlBC,CAAC;;;;;sFAOL,CAAC;;;;;6FAUN,CAAJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+EArDI,CAAC;;;;;qFAQmC,CAAC;;;;;4FAY1B,CAAC;;;;;yFAaJ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gFAL6B,CAAC;;;;;sFAQW,CAAC;;;;;6FASxC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BApGd,CAAC;;;;;0BAO4B,CAAC;;;;;;;;2BAO9B,CAAC;oCAC+D,CAAC;0BAEnB,CAAC;+BAEQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyGZ,CAAA;AAE9C,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,KAAK,CAAA;AAI1C,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAS,CAAA;AAEzD;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAkG,CAC7H,SAAS,EACT,GAAG,SAAS,EAAE,CACf,CAAA"}