web3-tools-mcp 1.3.4 → 1.5.0

package/README.md

@@ -6,6 +6,7 @@ A Model Context Protocol (MCP) server for blockchain interactions using [viem](h
 
 - Multi-chain support (Ethereum, Arbitrum, Avalanche, Base, BNB Chain, Gnosis, Sonic, Optimism, Polygon, zkSync Era, Linea, Unichain)
 - **🔐 Transaction Signing via Browser Wallet** (MetaMask, Rabby, Coinbase Wallet)
+- Clear signing: transactions are decoded, named and simulated before you approve them
 - Smart contract interactions (read & write functions, ABI retrieval, source code)
 - Contract simulation & gas estimation (simulate transactions, estimate costs)
 - Real-time gas price tracking (legacy & EIP-1559)
@@ -46,6 +47,10 @@ All API keys are optional. The server uses public RPCs by default. Add keys to u
 - `--infura-api-key` or `INFURA_API_KEY` - Additional RPC provider
 - `--custom-rpc` - Custom RPC URLs as JSON
 
+**Wallet relay (all optional):**
+- `WALLET_SERVER_URL` + `WALLET_TOKEN` - Use a hosted relay instead of a local one
+- `PORT`, `HOST`, `WALLET_PUBLIC_URL` - Read by the relay itself when you host it
+
 **Get free API keys:**
 - Etherscan: [etherscan.io/apis](https://etherscan.io/apis)
 - Hypersync: [hypersync.xyz](https://hypersync.xyz)
@@ -79,7 +84,7 @@ npx web3-tools-mcp
 | zkSync Era | 324 | ✅ |
 | Linea | 59144 | ✅ |
 | Unichain | 130 | ✅ |
-| Localhost | 31337 | ❌ |
+| Localhost | 1337 | ❌ |
 
 ## 🔐 Browser Wallet Integration
 
@@ -88,12 +93,63 @@ The server includes a built-in wallet interface for secure transaction signing w
 ### How It Works
 
 1. When you use a transaction tool (e.g., `send_native_token`), the server automatically:
-   - Starts a local web server on `http://localhost:3456`
+   - Starts a local wallet relay on `http://127.0.0.1:3456` (the next free port up to 3460)
    - Opens your browser to connect your wallet (MetaMask, Rabby, Coinbase Wallet, etc.)
 2. You connect your wallet once in the browser
-3. Transaction requests appear in the browser for approval
+3. The transaction is decoded and simulated, then the request appears in the browser for approval
 4. Sign or reject transactions directly in your wallet
 
+The browser page and the MCP server are both clients of the relay, authenticated with a
+pairing token that travels in the URL fragment (`#t=…`) of the link the server prints.
+
+**One relay per machine.** Every local MCP process looks for an existing relay on ports
+3456-3460 before starting one, so all your editor sessions share a single wallet page —
+connect once, and a transaction from any session lands in that tab. They authenticate with
+a token kept in `~/.config/web3-tools-mcp/relay-token` (mode 0600); delete it to rotate.
+
+### Before You Sign
+
+Each request shows what the transaction actually does, not just calldata:
+
+- **What it means** — for contracts in the [Ledger ERC-7730 registry](https://github.com/LedgerHQ/clear-signing-erc7730-registry)
+  (651 contracts, 3253 selectors), the protocol's own intent and field labels: *Supply ·
+  Aave · Amount to supply: 250 USDC*, rather than `supply(address,uint256,address,uint16)`.
+  The index ships gzipped (~60KB) and a weekly workflow opens a PR when it changes.
+- **Decoded call** — otherwise the function name and named arguments, from the verified ABI
+  (Sourcify / Etherscan) or, for unverified contracts, from selectors recovered from bytecode
+  via [WhatsABI](https://github.com/shazow/whatsabi). Proxies resolve to their implementation.
+- **Token amounts** — formatted with on-chain decimals and symbol; unlimited approvals are
+  flagged explicitly.
+- **Simulation** — `eth_simulateV1` (falling back to `eth_call` + `estimateGas`) reports the
+  gas estimate and every ERC20 transfer the transaction would cause, marked in/out for your
+  account. A reverting transaction is shown as such before you can approve it.
+
+### Hosting the Wallet Page
+
+The relay lives in its own workspace, [`wallet/`](wallet), and depends only on express, cors
+and ws (~4MB installed, against ~180MB for the MCP server). It deploys on its own to any host
+that keeps a Node process alive and supports WebSockets — Render, Railway, Fly:
+
+```bash
+# On the host, from wallet/ — PORT is provided by the platform
+WALLET_TOKEN=<long random string> WALLET_PUBLIC_URL=https://wallet.example.com npm start
+```
+
+Then point the MCP server at it:
+
+```bash
+export WALLET_SERVER_URL=https://wallet.example.com
+export WALLET_TOKEN=<the same token>
+npx web3-tools-mcp
+```
+
+`render.yaml` deploys the relay as-is (`rootDir: wallet`, so only its dependencies are
+installed). Anyone holding `WALLET_TOKEN` can send your browser transactions to sign, so
+treat it like a password and always serve the page over HTTPS.
+
+Locally nothing changes: the MCP server embeds the same relay and `npm run start:wallet`
+runs it from the workspace.
+
 ### Supported Wallets
 
 - MetaMask
@@ -103,12 +159,12 @@ The server includes a built-in wallet interface for secure transaction signing w
 
 ### Manual Access
 
-Visit `http://localhost:3456` anytime to:
+Visit the wallet URL printed by the server (`wallet_status` also returns it) anytime to:
 - Check wallet connection status
 - See pending transactions
 - View transaction history
 
-**Note:** The wallet server runs automatically when the MCP server starts. No additional setup required!
+**Note:** The relay starts automatically with the MCP server. No additional setup required.
 
 ## Available Tools
 
@@ -116,6 +172,7 @@ Visit `http://localhost:3456` anytime to:
 - `get_function_signature` - Generate 4-byte function selectors
 - `get_event_signature` - Generate 32-byte event topic0 hashes
 - `get_error_signature` - Generate 4-byte error selectors
+- `encode_function_data` - Encode a call's calldata from its ABI and arguments
 
 ### Contract Info
 - `get_contract_abi` - Get ABI with proxy detection and verification status
@@ -155,6 +212,7 @@ Visit `http://localhost:3456` anytime to:
 - `get_storage_at` - Read storage slots with type decoding
 - `get_block_info` - Get block data (timestamp, hash, etc.)
 - `trace_transaction` - Trace execution (call tree, VM, state diff)
+- `debug_call` - Trace a call without broadcasting it, falling back to a local anvil fork
 
 ## Advanced Configuration
 

package/dist/anvil.d.ts

@@ -0,0 +1,34 @@
+import { ChildProcess } from '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>;
+export interface SimulateCallParams {
+    to: string;
+    data?: string;
+    from?: string;
+    value?: bigint;
+    gas?: bigint;
+}
+export declare function simulateCallWithTrace(forkUrl: string, params: SimulateCallParams, blockNumber?: bigint, tracer?: 'callTracer' | 'prestateTracer'): Promise<{
+    result: string;
+    trace: unknown;
+    gasUsed: bigint;
+    success: boolean;
+    revertReason?: string;
+}>;
+//# sourceMappingURL=anvil.d.ts.map

package/dist/anvil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anvil.d.ts","sourceRoot":"","sources":["../src/anvil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,YAAY,EAAE,MAAM,eAAe,CAAA;AACnD,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;AAuBD,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAsF5E;AAGD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAIvD;AAGD,wBAAsB,SAAS,CAAC,CAAC,EAC/B,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC,CAOZ;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"}

package/dist/anvil.js

@@ -0,0 +1,254 @@
+import { spawn } from '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));
+    });
+}
+// Find an available port
+async function findAvailablePort(startPort = 8545) {
+    const net = await import('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);
+        });
+    });
+}
+// 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());
+    }
+    if (config.chainId !== undefined) {
+        args.push('--chain-id', config.chainId.toString());
+    }
+    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');
+    }
+}
+// Helper to run a function with a temporary Anvil instance
+export async function withAnvil(config, fn) {
+    const instance = await startAnvil(config);
+    try {
+        return await fn(instance);
+    }
+    finally {
+        stopAnvil(instance);
+    }
+}
+// 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) {
+        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;
+    });
+}
+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
+        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
+            }
+        }
+        catch (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;
+            }
+        }
+        // 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
+        };
+    });
+}
+//# sourceMappingURL=anvil.js.map

package/dist/anvil.js.map

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

package/dist/chain-meta.d.ts

@@ -0,0 +1,27 @@
+/**
+ * On-chain metadata every layer of the preview needs: contract ABIs, token symbols and
+ * human labels for addresses. Kept apart from the preview and the clear-signing registry
+ * so both can use it without importing each other.
+ */
+import { type Abi } from 'viem';
+import type { ChainName } from './types.js';
+export declare function loadAbi(chain: ChainName, address: string): Promise<{
+    abi: Abi;
+    source: "verified" | "guessed";
+    proxy?: string;
+    name?: string;
+}>;
+export declare function tokenMeta(chain: ChainName, token: string): Promise<{
+    symbol?: string;
+    decimals?: number;
+}>;
+/**
+ * Human label for an address: token symbol first (more recognisable than the contract
+ * name — "USDC" beats "FiatTokenProxy"), then the verified contract name. EOAs get none,
+ * and the bytecode check keeps us from asking explorers about plain wallets.
+ */
+export declare function addressLabel(chain: ChainName, address: string): Promise<string | undefined>;
+/** uint256 max and anything near it means "infinite" in an approval. */
+export declare const MAX_UINT256: bigint;
+export declare const UNLIMITED_THRESHOLD: bigint;
+//# sourceMappingURL=chain-meta.d.ts.map

package/dist/chain-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-meta.d.ts","sourceRoot":"","sources":["../src/chain-meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,GAAG,EAA8B,MAAM,MAAM,CAAA;AAG3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAW3C,wBAAsB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM;SAJvB,GAAG;YAAU,UAAU,GAAG,SAAS;YAAU,MAAM;WAAS,MAAM;GAmCzG;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;aAnClB,MAAM;eAAa,MAAM;GAuDrE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiBjG;AAGD,wEAAwE;AACxE,eAAO,MAAM,WAAW,QAAoB,CAAA;AAC5C,eAAO,MAAM,mBAAmB,QAAmB,CAAA"}

package/dist/chain-meta.js

@@ -0,0 +1,92 @@
+/**
+ * On-chain metadata every layer of the preview needs: contract ABIs, token symbols and
+ * human labels for addresses. Kept apart from the preview and the clear-signing registry
+ * so both can use it without importing each other.
+ */
+import { parseAbiItem } from 'viem';
+import { whatsabi } from '@shazow/whatsabi';
+import { getClientManager } from './client.js';
+const ERC20_META_ABI = [
+    parseAbiItem('function decimals() view returns (uint8)'),
+    parseAbiItem('function symbol() view returns (string)')
+];
+const abiCache = new Map();
+const labelCache = new Map();
+const metaCache = new Map();
+export async function loadAbi(chain, address) {
+    const key = `${chain}:${address.toLowerCase()}`;
+    const cached = abiCache.get(key);
+    if (cached)
+        return cached;
+    const clientManager = getClientManager();
+    const client = clientManager.getClient(chain);
+    const etherscanApiKey = clientManager.getConfig().etherscanApiKey;
+    const loaders = [new whatsabi.loaders.SourcifyABILoader({ chainId: clientManager.getChainId(chain) })];
+    if (etherscanApiKey) {
+        loaders.push(new whatsabi.loaders.EtherscanV2ABILoader({ apiKey: etherscanApiKey, chainId: clientManager.getChainId(chain) }));
+    }
+    const result = await whatsabi.autoload(address, {
+        provider: client,
+        abiLoader: new whatsabi.loaders.MultiABILoader(loaders),
+        signatureLookup: new whatsabi.loaders.OpenChainSignatureLookup(),
+        followProxies: true
+    });
+    // Bytecode-guessed ABIs carry no argument names; verified ones do.
+    const source = result.abi.some((item) => item.type === 'function' && item.inputs?.some((i) => i.name)) ? 'verified' : 'guessed';
+    const loaded = {
+        abi: result.abi,
+        source: source,
+        proxy: result.address !== address ? result.address : undefined,
+        name: result.contractResult?.name ?? undefined
+    };
+    abiCache.set(key, loaded);
+    return loaded;
+}
+export async function tokenMeta(chain, token) {
+    const key = `${chain}:${token.toLowerCase()}`;
+    const cached = metaCache.get(key);
+    if (cached)
+        return cached;
+    const client = getClientManager().getClient(chain);
+    const [decimals, symbol] = await client.multicall({
+        contracts: [
+            { address: token, abi: ERC20_META_ABI, functionName: 'decimals' },
+            { address: token, abi: ERC20_META_ABI, functionName: 'symbol' }
+        ],
+        ...(chain === 'localhost' && { deployless: true })
+    });
+    const meta = {
+        decimals: decimals.status === 'success' ? Number(decimals.result) : undefined,
+        symbol: symbol.status === 'success' ? symbol.result : undefined
+    };
+    metaCache.set(key, meta);
+    return meta;
+}
+/**
+ * Human label for an address: token symbol first (more recognisable than the contract
+ * name — "USDC" beats "FiatTokenProxy"), then the verified contract name. EOAs get none,
+ * and the bytecode check keeps us from asking explorers about plain wallets.
+ */
+export async function addressLabel(chain, address) {
+    const key = `${chain}:${address.toLowerCase()}`;
+    if (labelCache.has(key))
+        return labelCache.get(key);
+    let label;
+    try {
+        const code = await getClientManager().getClient(chain).getBytecode({ address: address });
+        if (code && code !== '0x') {
+            label = (await tokenMeta(chain, address).catch(() => ({ symbol: undefined }))).symbol;
+            if (!label)
+                label = (await loadAbi(chain, address)).name;
+        }
+    }
+    catch {
+        // Unknown address — show it bare rather than failing the preview.
+    }
+    labelCache.set(key, label);
+    return label;
+}
+/** uint256 max and anything near it means "infinite" in an approval. */
+export const MAX_UINT256 = (1n << 256n) - 1n;
+export const UNLIMITED_THRESHOLD = MAX_UINT256 / 2n;
+//# sourceMappingURL=chain-meta.js.map

package/dist/chain-meta.js.map

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

package/dist/clear-signing.d.ts

@@ -0,0 +1,62 @@
+import type { ChainName } from './types.js';
+/**
+ * Clear signing from the Ledger ERC-7730 registry: for a known contract and selector it
+ * says what the transaction *means* ("Swap", "Approve spending") and labels each field the
+ * way the protocol intends, instead of showing raw ABI argument names.
+ *
+ * The index is built from the registry by scripts/build-erc7730-index.mjs.
+ */
+interface IndexField {
+    label?: string;
+    path?: string;
+    format?: string;
+    /** tokenAmount: `tokenPath` points at the field holding the token address. */
+    params?: {
+        tokenPath?: string;
+        tokenAddress?: string;
+        [k: string]: unknown;
+    };
+}
+interface IndexSelector {
+    name: string;
+    intent: string;
+    /** Full signature, needed to ABI-decode the calldata these paths address. */
+    signature?: string;
+    fields: IndexField[];
+}
+interface IndexEntry {
+    protocol: string;
+    chainIds: number[];
+    selectors: Record<string, IndexSelector>;
+}
+export interface ClearSigningField {
+    label: string;
+    format: string;
+    value: string;
+    address?: string;
+    name?: string;
+}
+export interface ClearSigningInfo {
+    protocol: string;
+    intent: string;
+    functionName: string;
+    fields: ClearSigningField[];
+}
+export declare function protocolLabel(slug: string): string;
+interface TxContext {
+    to: string;
+    value?: string;
+    from?: string;
+}
+/** Registry entry for a contract, if it is listed for this chain. */
+export declare function lookupContract(chain: ChainName, address: string): IndexEntry | undefined;
+/**
+ * Clear-signing info for a transaction, or null when the contract/selector is unlisted.
+ * `decodedArgs` is supplied by the caller, which has already decoded the calldata against
+ * the contract's real ABI — the registry's own signature is only a fallback for naming.
+ */
+export declare function resolveClearSigning(chain: ChainName, tx: TxContext & {
+    data?: string;
+}, decodedArgs: Record<string, unknown>): Promise<ClearSigningInfo | null>;
+export {};
+//# sourceMappingURL=clear-signing.d.ts.map

package/dist/clear-signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-signing.d.ts","sourceRoot":"","sources":["../src/clear-signing.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;;;GAMG;AAEH,UAAU,UAAU;IAElB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CAC7E;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB;AAED,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAC5B;AAkCD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAiBD,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA+DD,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAKxF;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,SAAS,EAChB,EAAE,EAAE,SAAS,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAiBlC"}