web3-tools-mcp 1.4.0 → 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,7 +93,7 @@ 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 wallet relay 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. The transaction is decoded and simulated, then the request appears in the browser for approval
@@ -106,9 +111,13 @@ a token kept in `~/.config/web3-tools-mcp/relay-token` (mode 0600); delete it to
 
 Each request shows what the transaction actually does, not just calldata:
 
-- **Decoded call** — 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 are resolved to their implementation.
+- **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
@@ -163,6 +172,7 @@ Visit the wallet URL printed by the server (`wallet_status` also returns it) any
 - `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
@@ -202,6 +212,7 @@ Visit the wallet URL printed by the server (`wallet_status` also returns it) any
 - `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/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"}

package/dist/clear-signing.js

@@ -0,0 +1,139 @@
+import { createRequire } from 'node:module';
+import { gunzipSync } from 'node:zlib';
+import { formatUnits, getAddress, isAddress } from 'viem';
+import { addressLabel, tokenMeta, UNLIMITED_THRESHOLD } from './chain-meta.js';
+import { getClientManager } from './client.js';
+// Prettier names for registry directory slugs; unknown ones read fine as-is.
+const PROTOCOL_LABELS = {
+    lifi: 'LI.FI',
+    '1inch': '1inch',
+    uniswap: 'Uniswap',
+    paraswap: 'ParaSwap',
+    cowswap: 'CoW Swap',
+    '0x': '0x Protocol',
+    aave: 'Aave',
+    morpho: 'Morpho',
+    safe: 'Safe',
+    lido: 'Lido',
+    eigenlayer: 'EigenLayer',
+    ens: 'ENS'
+};
+const require = createRequire(import.meta.url);
+let index;
+/** Loaded on first use: ~1.5MB of JSON, shipped gzipped at ~60KB. */
+function registry() {
+    if (!index) {
+        try {
+            const path = require.resolve('./erc7730-index.json.gz');
+            index = JSON.parse(gunzipSync(require('node:fs').readFileSync(path)).toString());
+        }
+        catch {
+            index = {};
+        }
+    }
+    return index;
+}
+export function protocolLabel(slug) {
+    return PROTOCOL_LABELS[slug] ?? slug;
+}
+/** Resolve a registry path ("params.amountIn", "#.to", "[0].value") against decoded args. */
+function getByPath(root, path) {
+    let current = root;
+    for (const part of path.replace(/^[#@]\./, '').split('.')) {
+        if (current == null)
+            return undefined;
+        const arrayIndex = part.match(/^\[(\d*)\]$/);
+        if (arrayIndex) {
+            current = Array.isArray(current) ? current[arrayIndex[1] === '' ? 0 : Number(arrayIndex[1])] : undefined;
+        }
+        else {
+            current = current[part];
+        }
+    }
+    return current;
+}
+function resolvePath(root, tx, path) {
+    if (path.startsWith('@.')) {
+        if (path.slice(2) === 'to')
+            return tx.to;
+        if (path.slice(2) === 'value')
+            return tx.value;
+        if (path.slice(2) === 'from')
+            return tx.from;
+        return undefined;
+    }
+    return getByPath(root, path);
+}
+async function formatField(chain, field, root, tx) {
+    // A missing format with a token reference still means an amount.
+    const format = field.format ?? (field.params?.tokenPath || field.params?.tokenAddress ? 'tokenAmount' : 'raw');
+    const label = field.label ?? field.path ?? format;
+    const raw = field.path ? resolvePath(root, tx, field.path) : undefined;
+    const out = { label, format, value: '' };
+    // Unresolved: show the descriptor's path rather than an empty row.
+    if (raw == null) {
+        out.value = field.path ?? '';
+        return out;
+    }
+    switch (format) {
+        case 'tokenAmount':
+        case 'amount': {
+            const amount = typeof raw === 'bigint' ? raw : BigInt(raw);
+            const token = field.params?.tokenAddress ?? (field.params?.tokenPath ? resolvePath(root, tx, field.params.tokenPath) : undefined);
+            const meta = typeof token === 'string' && isAddress(token)
+                ? await tokenMeta(chain, token).catch(() => ({ symbol: undefined, decimals: undefined }))
+                : { symbol: undefined, decimals: undefined };
+            const symbol = meta.symbol ? ` ${meta.symbol}` : '';
+            out.value = amount > UNLIMITED_THRESHOLD ? `Unlimited${symbol}` : `${formatUnits(amount, meta.decimals ?? 18)}${symbol}`;
+            return out;
+        }
+        case 'addressName':
+        case 'address':
+        case 'tokenName': {
+            if (!isAddress(raw)) {
+                out.value = String(raw);
+                return out;
+            }
+            const address = getAddress(raw);
+            const name = registry()[address.toLowerCase()]?.protocol;
+            out.address = address;
+            out.name = name ? protocolLabel(name) : await addressLabel(chain, address).catch(() => undefined);
+            out.value = out.name ?? address;
+            return out;
+        }
+        default:
+            out.value = typeof raw === 'bigint' ? raw.toString() : String(raw);
+            return out;
+    }
+}
+/** Registry entry for a contract, if it is listed for this chain. */
+export function lookupContract(chain, address) {
+    const entry = registry()[address.toLowerCase()];
+    if (!entry)
+        return undefined;
+    const chainId = getClientManager().getChainId(chain);
+    return entry.chainIds.includes(chainId) ? entry : 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 async function resolveClearSigning(chain, tx, decodedArgs) {
+    if (!tx.data || tx.data.length < 10)
+        return null;
+    const entry = lookupContract(chain, tx.to);
+    const format = entry?.selectors[tx.data.slice(0, 10).toLowerCase()];
+    if (!entry || !format)
+        return null;
+    // Fields with neither a path nor a label carry nothing a signer could read.
+    const usable = format.fields.filter((field) => field.path || field.label);
+    const fields = await Promise.all(usable.map((field) => formatField(chain, field, decodedArgs, tx)));
+    return {
+        protocol: protocolLabel(entry.protocol),
+        intent: format.intent,
+        functionName: format.name,
+        fields
+    };
+}
+//# sourceMappingURL=clear-signing.js.map

package/dist/clear-signing.js.map

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

package/dist/preview.d.ts

@@ -30,6 +30,9 @@ export interface TxPreview {
         functionName: string;
         signature: string;
         fields: PreviewField[];
+        /** From the ERC-7730 registry: what this call means, and whose contract it is. */
+        intent?: string;
+        protocol?: string;
         /** 'verified' = ABI from Sourcify/Etherscan, 'guessed' = selector lookup on bytecode */
         source: 'verified' | 'guessed';
         proxy?: string;

package/dist/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE;QACR,YAAY,EAAE,MAAM,CAAA;QACpB,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,YAAY,EAAE,CAAA;QACtB,wFAAwF;QACxF,MAAM,EAAE,UAAU,GAAG,SAAS,CAAA;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,WAAW,EAAE,CAAA;KAC5B,CAAA;CACF;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAuOD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmBnG"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE;QACR,YAAY,EAAE,MAAM,CAAA;QACpB,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,YAAY,EAAE,CAAA;QACtB,kFAAkF;QAClF,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,wFAAwF;QACxF,MAAM,EAAE,UAAU,GAAG,SAAS,CAAA;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,WAAW,EAAE,CAAA;KAC5B,CAAA;CACF;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAyKD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAsBnG"}

package/dist/preview.js

@@ -1,96 +1,15 @@
-import { decodeFunctionData, formatEther, formatUnits, parseAbiItem, toFunctionSelector } from 'viem';
+import { decodeFunctionData, formatEther, formatUnits, toFunctionSelector } from 'viem';
 import { simulateBlocks } from 'viem/actions';
-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)')
-];
+import { addressLabel, loadAbi, tokenMeta, UNLIMITED_THRESHOLD } from './chain-meta.js';
+import { lookupContract, protocolLabel, resolveClearSigning } from './clear-signing.js';
 const TRANSFER_TOPIC = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';
-const MAX_UINT256 = (1n << 256n) - 1n;
-const UNLIMITED_THRESHOLD = MAX_UINT256 / 2n;
 // Selectors whose amount argument is denominated in the token at tx.to.
 const ERC20_AMOUNT_ARGS = {
     [toFunctionSelector('function approve(address,uint256)')]: { arg: 'amount', approval: true },
     [toFunctionSelector('function transfer(address,uint256)')]: { arg: 'amount' },
     [toFunctionSelector('function transferFrom(address,address,uint256)')]: { arg: 'amount' }
 };
-const abiCache = new Map();
-const labelCache = new Map();
-const metaCache = new Map();
-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;
-}
-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.
- */
-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;
-}
 function stringify(value) {
     if (typeof value === 'bigint')
         return value.toString();
@@ -143,6 +62,33 @@ async function decodeCalldata(chain, tx) {
     const signature = abiItem
         ? `${functionName}(${inputs.map((i) => `${i.type}${i.name ? ` ${i.name}` : ''}`).join(', ')})`
         : functionName;
+    // Map positional args to their parameter names so registry field paths resolve.
+    const named = {};
+    inputs.forEach((input, i) => {
+        if (input.name)
+            named[input.name] = (args ?? [])[i];
+    });
+    // A registry descriptor says what the call means and how the protocol wants each field
+    // labelled, which beats raw ABI argument names. Fall back to those when it has none.
+    const clearSigning = await resolveClearSigning(chain, tx, named).catch(() => null);
+    if (clearSigning) {
+        return {
+            functionName,
+            signature,
+            source,
+            proxy,
+            intent: clearSigning.intent,
+            protocol: clearSigning.protocol,
+            fields: clearSigning.fields.map((field) => ({
+                name: field.label,
+                type: field.format,
+                value: field.value,
+                ...(field.address && { address: field.address }),
+                ...(field.name && { label: field.name }),
+                ...(field.value.startsWith('Unlimited') && { warning: 'Unlimited spending approval' })
+            }))
+        };
+    }
     return { functionName, signature, fields, source, proxy };
 }
 function topicToAddress(topic) {
@@ -217,7 +163,10 @@ export async function buildTxPreview(chain, tx, from) {
     const [decoded, simulation, toLabel] = await Promise.all([
         decodeCalldata(chain, tx).catch(() => undefined),
         from ? simulate(chain, tx, from).catch(() => undefined) : Promise.resolve(undefined),
-        addressLabel(chain, tx.to).catch(() => undefined)
+        // The registry's protocol name beats anything on-chain: "Aave", not a proxy's class name.
+        Promise.resolve(lookupContract(chain, tx.to))
+            .then((entry) => (entry ? protocolLabel(entry.protocol) : addressLabel(chain, tx.to)))
+            .catch(() => undefined)
     ]);
     return {
         chain,

package/dist/preview.js.map

@@ -1 +1 @@
-{"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,EACnB,MAAM,MAAM,CAAA;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAsD9C,MAAM,cAAc,GAAG;IACrB,YAAY,CAAC,0CAA0C,CAAC;IACxD,YAAY,CAAC,yCAAyC,CAAC;CACxD,CAAA;AAED,MAAM,cAAc,GAAG,oEAAoE,CAAA;AAC3F,MAAM,WAAW,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;AACrC,MAAM,mBAAmB,GAAG,WAAW,GAAG,EAAE,CAAA;AAE5C,wEAAwE;AACxE,MAAM,iBAAiB,GAAwD;IAC7E,CAAC,kBAAkB,CAAC,mCAAmC,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC5F,CAAC,kBAAkB,CAAC,oCAAoC,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE;IAC7E,CAAC,kBAAkB,CAAC,gDAAgD,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE;CAC1F,CAAA;AAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuF,CAAA;AAC/G,MAAM,UAAU,GAAG,IAAI,GAAG,EAA8B,CAAA;AACxD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkD,CAAA;AAE3E,KAAK,UAAU,OAAO,CAAC,KAAgB,EAAE,OAAe;IACtD,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAA;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAA;IACxC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,eAAe,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC,eAAe,CAAA;IAEjE,MAAM,OAAO,GAAiC,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IACpI,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IAChI,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAkB,EAAE;QACzD,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,IAAI,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC;QACvD,eAAe,EAAE,IAAI,QAAQ,CAAC,OAAO,CAAC,wBAAwB,EAAE;QAChE,aAAa,EAAE,IAAI;KACpB,CAAC,CAAA;IAEF,mEAAmE;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAA;IAC/H,MAAM,MAAM,GAAG;QACb,GAAG,EAAE,MAAM,CAAC,GAAU;QACtB,MAAM,EAAE,MAAgC;QACxC,KAAK,EAAE,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAC9D,IAAI,EAAE,MAAM,CAAC,cAAc,EAAE,IAAI,IAAI,SAAS;KAC/C,CAAA;IACD,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACzB,OAAO,MAAM,CAAA;AACf,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,KAAgB,EAAE,KAAa;IACtD,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAA;IAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAClD,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;QAChD,SAAS,EAAE;YACT,EAAE,OAAO,EAAE,KAAgB,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE;YAC5E,EAAE,OAAO,EAAE,KAAgB,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE;SAC3E;QACD,GAAG,CAAC,KAAK,KAAK,WAAW,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;KACnD,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG;QACX,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7E,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAE,MAAM,CAAC,MAAiB,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAA;IACD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACxB,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,YAAY,CAAC,KAAgB,EAAE,OAAe;IAC3D,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAA;IAC/C,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAEnD,IAAI,KAAyB,CAAA;IAC7B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,gBAAgB,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,OAAkB,EAAE,CAAC,CAAA;QACnG,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YACrF,IAAI,CAAC,KAAK;gBAAE,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;QAC1D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;IAED,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC1B,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAA;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA;IACvE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAC7B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;aACxC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA;IAClB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,cAAc,CAAC,KAAgB,EAAE,EAAS;IACvD,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IAElD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1D,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAqB,EAAE,CAAC,CAAA;IAE1F,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,EAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAA;IAC/G,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,EAAE,CAAA;IACpC,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAExH,MAAM,MAAM,GAAmB,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACvB,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,MAAM,CAAC,EAAE,CAAA;QACrC,MAAM,KAAK,GAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAA;QAE7F,IAAI,KAAK,EAAE,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAA;QAEjF,qEAAqE;QACrE,IAAI,KAAK,IAAI,CAAC,KAAM,IAA2B,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxF,IAAI,IAAI,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACjC,KAAK,CAAC,KAAK,GAAG,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;YAC7F,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,GAAG,mBAAmB,EAAE,CAAC;gBAClD,KAAK,CAAC,KAAK,GAAG,YAAY,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;gBACjE,KAAK,CAAC,OAAO,GAAG,6BAA6B,CAAA;YAC/C,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;IAEF,uEAAuE;IACvE,MAAM,OAAO,CAAC,GAAG,CACf,MAAM;SACH,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;SAChC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACnB,KAAK,CAAC,KAAK,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,OAAiB,CAAC,CAAA;IAClE,CAAC,CAAC,CACL,CAAA;IAED,MAAM,SAAS,GAAG,OAAO;QACvB,CAAC,CAAC,GAAG,YAAY,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC9F,CAAC,CAAC,YAAY,CAAA;IAEhB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC3D,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;AAChC,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,KAAgB,EAAE,IAA6E;IAC5H,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,cAAc,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAA;IAEjH,OAAO,OAAO,CAAC,GAAG,CAChB,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAwB,EAAE;QAChD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;QAChF,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;QAC1G,OAAO;YACL,KAAK,EAAE,GAAG,CAAC,OAAO;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;YACpC,EAAE,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;YAClC,MAAM;YACN,WAAW,EAAE,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;SAClG,CAAA;IACH,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,QAAQ,CAAC,KAAgB,EAAE,EAAS,EAAE,IAAa;IAChE,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAClD,MAAM,IAAI,GAAG;QACX,OAAO,EAAE,IAAI;QACb,EAAE,EAAE,EAAE,CAAC,EAAa;QACpB,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAqB,EAAE,CAAC;QAClD,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;KACtE,CAAA;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;QACrH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;QACtC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,CAAC,KAAgE,CAAA;YACrF,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS;gBACpC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE;gBACvC,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,YAAY,IAAI,KAAK,EAAE,OAAO,IAAI,oBAAoB,CAAC;gBAChH,YAAY,EAAE,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAU,CAAC;aACzE,CAAA;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAA;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3E,YAAY,EAAE,EAAE;SACjB,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAgB,EAAE,EAAS,EAAE,IAAa;IAC7E,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAEhE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;QAChD,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,IAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;QAC/F,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;KAClD,CAAC,CAAA;IAEF,OAAO;QACL,KAAK;QACL,EAAE,EAAE,EAAE,CAAC,EAAE;QACT,OAAO;QACP,QAAQ,EAAE,WAAW,gBAAgB,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;QACnE,KAAK;QACL,cAAc,EAAE,KAAK,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QAC/E,OAAO;QACP,UAAU;KACX,CAAA;AACH,CAAC"}
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"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"}

package/dist/tools/transactions.d.ts

@@ -38,8 +38,8 @@ declare const _default: {
         }, "strip", z.ZodTypeAny, {
             chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             to: string;
-            tokenAddress: string;
             decimals: number;
+            tokenAddress: string;
             amount: string;
         }, {
             chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
@@ -51,8 +51,8 @@ declare const _default: {
         handler: (args: {
             chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             to: string;
-            tokenAddress: string;
             decimals: number;
+            tokenAddress: string;
             amount: string;
         }) => Promise<import("../types.js").ToolResult>;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web3-tools-mcp",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Model Context Protocol server for blockchain interactions using viem, Etherscan, and Hypersync",
   "type": "module",
   "main": "dist/index.js",
@@ -19,13 +19,14 @@
   },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "npm run clean && npm run build -w web3-wallet-relay && tsc",
+    "build": "npm run clean && npm run build -w web3-wallet-relay && tsc && cp src/erc7730-index.json.gz dist/",
     "watch": "tsc --watch",
     "start:wallet": "npm start -w web3-wallet-relay",
     "prepare": "npm run build",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:ui": "vitest --ui"
+    "test:ui": "vitest --ui",
+    "sync:registry": "node scripts/build-erc7730-index.mjs /tmp/erc7730/registry src/erc7730-index.json.gz"
   },
   "keywords": [
     "mcp",

package/src/chain-meta.ts

@@ -0,0 +1,102 @@
+/**
+ * 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, type Address, parseAbiItem } from 'viem'
+import { whatsabi } from '@shazow/whatsabi'
+import { getClientManager } from './client.js'
+import type { ChainName } from './types.js'
+
+const ERC20_META_ABI = [
+  parseAbiItem('function decimals() view returns (uint8)'),
+  parseAbiItem('function symbol() view returns (string)')
+]
+
+const abiCache = new Map<string, { abi: Abi; source: 'verified' | 'guessed'; proxy?: string; name?: string }>()
+const labelCache = new Map<string, string | undefined>()
+const metaCache = new Map<string, { symbol?: string; decimals?: number }>()
+
+export async function loadAbi(chain: ChainName, address: string) {
+  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: whatsabi.loaders.ABILoader[] = [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 as 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 as Abi,
+    source: source as 'verified' | 'guessed',
+    proxy: result.address !== address ? result.address : undefined,
+    name: result.contractResult?.name ?? undefined
+  }
+  abiCache.set(key, loaded)
+  return loaded
+}
+
+export async function tokenMeta(chain: ChainName, token: string) {
+  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 as Address, abi: ERC20_META_ABI, functionName: 'decimals' },
+      { address: token as Address, 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 as string) : 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: ChainName, address: string): Promise<string | undefined> {
+  const key = `${chain}:${address.toLowerCase()}`
+  if (labelCache.has(key)) return labelCache.get(key)
+
+  let label: string | undefined
+  try {
+    const code = await getClientManager().getClient(chain).getBytecode({ address: address as 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

package/src/clear-signing.ts

@@ -0,0 +1,206 @@
+import { createRequire } from 'node:module'
+import { gunzipSync } from 'node:zlib'
+import { formatUnits, getAddress, isAddress } from 'viem'
+import { addressLabel, tokenMeta, UNLIMITED_THRESHOLD } from './chain-meta.js'
+import { getClientManager } from './client.js'
+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 {
+  // A handful of registry descriptors omit these, so nothing here is guaranteed.
+  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[]
+}
+
+// Prettier names for registry directory slugs; unknown ones read fine as-is.
+const PROTOCOL_LABELS: Record<string, string> = {
+  lifi: 'LI.FI',
+  '1inch': '1inch',
+  uniswap: 'Uniswap',
+  paraswap: 'ParaSwap',
+  cowswap: 'CoW Swap',
+  '0x': '0x Protocol',
+  aave: 'Aave',
+  morpho: 'Morpho',
+  safe: 'Safe',
+  lido: 'Lido',
+  eigenlayer: 'EigenLayer',
+  ens: 'ENS'
+}
+
+const require = createRequire(import.meta.url)
+let index: Record<string, IndexEntry> | undefined
+
+/** Loaded on first use: ~1.5MB of JSON, shipped gzipped at ~60KB. */
+function registry(): Record<string, IndexEntry> {
+  if (!index) {
+    try {
+      const path = require.resolve('./erc7730-index.json.gz')
+      index = JSON.parse(gunzipSync(require('node:fs').readFileSync(path)).toString())
+    } catch {
+      index = {}
+    }
+  }
+  return index as Record<string, IndexEntry>
+}
+
+export function protocolLabel(slug: string): string {
+  return PROTOCOL_LABELS[slug] ?? slug
+}
+
+/** Resolve a registry path ("params.amountIn", "#.to", "[0].value") against decoded args. */
+function getByPath(root: unknown, path: string): unknown {
+  let current: unknown = root
+  for (const part of path.replace(/^[#@]\./, '').split('.')) {
+    if (current == null) return undefined
+    const arrayIndex = part.match(/^\[(\d*)\]$/)
+    if (arrayIndex) {
+      current = Array.isArray(current) ? current[arrayIndex[1] === '' ? 0 : Number(arrayIndex[1])] : undefined
+    } else {
+      current = (current as Record<string, unknown>)[part]
+    }
+  }
+  return current
+}
+
+interface TxContext {
+  to: string
+  value?: string
+  from?: string
+}
+
+function resolvePath(root: unknown, tx: TxContext, path: string): unknown {
+  if (path.startsWith('@.')) {
+    if (path.slice(2) === 'to') return tx.to
+    if (path.slice(2) === 'value') return tx.value
+    if (path.slice(2) === 'from') return tx.from
+    return undefined
+  }
+  return getByPath(root, path)
+}
+
+async function formatField(chain: ChainName, field: IndexField, root: unknown, tx: TxContext): Promise<ClearSigningField> {
+  // A missing format with a token reference still means an amount.
+  const format = field.format ?? (field.params?.tokenPath || field.params?.tokenAddress ? 'tokenAmount' : 'raw')
+  const label = field.label ?? field.path ?? format
+  const raw = field.path ? resolvePath(root, tx, field.path) : undefined
+  const out: ClearSigningField = { label, format, value: '' }
+
+  // Unresolved: show the descriptor's path rather than an empty row.
+  if (raw == null) {
+    out.value = field.path ?? ''
+    return out
+  }
+
+  switch (format) {
+    case 'tokenAmount':
+    case 'amount': {
+      const amount = typeof raw === 'bigint' ? raw : BigInt(raw as string | number)
+      const token =
+        field.params?.tokenAddress ?? (field.params?.tokenPath ? resolvePath(root, tx, field.params.tokenPath) : undefined)
+
+      const meta =
+        typeof token === 'string' && isAddress(token)
+          ? await tokenMeta(chain, token).catch(() => ({ symbol: undefined, decimals: undefined }))
+          : { symbol: undefined, decimals: undefined }
+
+      const symbol = meta.symbol ? ` ${meta.symbol}` : ''
+      out.value = amount > UNLIMITED_THRESHOLD ? `Unlimited${symbol}` : `${formatUnits(amount, meta.decimals ?? 18)}${symbol}`
+      return out
+    }
+
+    case 'addressName':
+    case 'address':
+    case 'tokenName': {
+      if (!isAddress(raw as string)) {
+        out.value = String(raw)
+        return out
+      }
+      const address = getAddress(raw as string)
+      const name = registry()[address.toLowerCase()]?.protocol
+      out.address = address
+      out.name = name ? protocolLabel(name) : await addressLabel(chain, address).catch(() => undefined)
+      out.value = out.name ?? address
+      return out
+    }
+
+    default:
+      out.value = typeof raw === 'bigint' ? raw.toString() : String(raw)
+      return out
+  }
+}
+
+/** Registry entry for a contract, if it is listed for this chain. */
+export function lookupContract(chain: ChainName, address: string): IndexEntry | undefined {
+  const entry = registry()[address.toLowerCase()]
+  if (!entry) return undefined
+  const chainId = getClientManager().getChainId(chain)
+  return entry.chainIds.includes(chainId) ? entry : 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 async function resolveClearSigning(
+  chain: ChainName,
+  tx: TxContext & { data?: string },
+  decodedArgs: Record<string, unknown>
+): Promise<ClearSigningInfo | null> {
+  if (!tx.data || tx.data.length < 10) return null
+
+  const entry = lookupContract(chain, tx.to)
+  const format = entry?.selectors[tx.data.slice(0, 10).toLowerCase()]
+  if (!entry || !format) return null
+
+  // Fields with neither a path nor a label carry nothing a signer could read.
+  const usable = format.fields.filter((field) => field.path || field.label)
+  const fields = await Promise.all(usable.map((field) => formatField(chain, field, decodedArgs, tx)))
+
+  return {
+    protocol: protocolLabel(entry.protocol),
+    intent: format.intent,
+    functionName: format.name,
+    fields
+  }
+}

package/src/preview.ts

@@ -9,8 +9,9 @@ import {
   toFunctionSelector
 } from 'viem'
 import { simulateBlocks } from 'viem/actions'
-import { whatsabi } from '@shazow/whatsabi'
 import { getClientManager } from './client.js'
+import { addressLabel, loadAbi, tokenMeta, UNLIMITED_THRESHOLD } from './chain-meta.js'
+import { lookupContract, protocolLabel, resolveClearSigning } from './clear-signing.js'
 import type { ChainName } from './types.js'
 
 export interface PreviewField {
@@ -46,6 +47,9 @@ export interface TxPreview {
     functionName: string
     signature: string
     fields: PreviewField[]
+    /** From the ERC-7730 registry: what this call means, and whose contract it is. */
+    intent?: string
+    protocol?: string
     /** 'verified' = ABI from Sourcify/Etherscan, 'guessed' = selector lookup on bytecode */
     source: 'verified' | 'guessed'
     proxy?: string
@@ -64,14 +68,7 @@ export interface RawTx {
   value?: string
 }
 
-const ERC20_META_ABI = [
-  parseAbiItem('function decimals() view returns (uint8)'),
-  parseAbiItem('function symbol() view returns (string)')
-]
-
 const TRANSFER_TOPIC = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'
-const MAX_UINT256 = (1n << 256n) - 1n
-const UNLIMITED_THRESHOLD = MAX_UINT256 / 2n
 
 // Selectors whose amount argument is denominated in the token at tx.to.
 const ERC20_AMOUNT_ARGS: Record<string, { arg: string; approval?: boolean }> = {
@@ -80,89 +77,6 @@ const ERC20_AMOUNT_ARGS: Record<string, { arg: string; approval?: boolean }> = {
   [toFunctionSelector('function transferFrom(address,address,uint256)')]: { arg: 'amount' }
 }
 
-const abiCache = new Map<string, { abi: Abi; source: 'verified' | 'guessed'; proxy?: string; name?: string }>()
-const labelCache = new Map<string, string | undefined>()
-const metaCache = new Map<string, { symbol?: string; decimals?: number }>()
-
-async function loadAbi(chain: ChainName, address: string) {
-  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: whatsabi.loaders.ABILoader[] = [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 as 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 as Abi,
-    source: source as 'verified' | 'guessed',
-    proxy: result.address !== address ? result.address : undefined,
-    name: result.contractResult?.name ?? undefined
-  }
-  abiCache.set(key, loaded)
-  return loaded
-}
-
-async function tokenMeta(chain: ChainName, token: string) {
-  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 as Address, abi: ERC20_META_ABI, functionName: 'decimals' },
-      { address: token as Address, 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 as string) : 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.
- */
-async function addressLabel(chain: ChainName, address: string): Promise<string | undefined> {
-  const key = `${chain}:${address.toLowerCase()}`
-  if (labelCache.has(key)) return labelCache.get(key)
-
-  let label: string | undefined
-  try {
-    const code = await getClientManager().getClient(chain).getBytecode({ address: address as 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
-}
-
 function stringify(value: unknown): string {
   if (typeof value === 'bigint') return value.toString()
   if (Array.isArray(value)) return `[${value.map(stringify).join(', ')}]`
@@ -222,6 +136,34 @@ async function decodeCalldata(chain: ChainName, tx: RawTx): Promise<TxPreview['d
     ? `${functionName}(${inputs.map((i) => `${i.type}${i.name ? ` ${i.name}` : ''}`).join(', ')})`
     : functionName
 
+  // Map positional args to their parameter names so registry field paths resolve.
+  const named: Record<string, unknown> = {}
+  inputs.forEach((input, i) => {
+    if (input.name) named[input.name] = (args ?? [])[i]
+  })
+
+  // A registry descriptor says what the call means and how the protocol wants each field
+  // labelled, which beats raw ABI argument names. Fall back to those when it has none.
+  const clearSigning = await resolveClearSigning(chain, tx, named).catch(() => null)
+  if (clearSigning) {
+    return {
+      functionName,
+      signature,
+      source,
+      proxy,
+      intent: clearSigning.intent,
+      protocol: clearSigning.protocol,
+      fields: clearSigning.fields.map((field) => ({
+        name: field.label,
+        type: field.format,
+        value: field.value,
+        ...(field.address && { address: field.address }),
+        ...(field.name && { label: field.name }),
+        ...(field.value.startsWith('Unlimited') && { warning: 'Unlimited spending approval' })
+      }))
+    }
+  }
+
   return { functionName, signature, fields, source, proxy }
 }
 
@@ -304,7 +246,10 @@ export async function buildTxPreview(chain: ChainName, tx: RawTx, from?: string)
   const [decoded, simulation, toLabel] = await Promise.all([
     decodeCalldata(chain, tx).catch(() => undefined),
     from ? simulate(chain, tx, from as Address).catch(() => undefined) : Promise.resolve(undefined),
-    addressLabel(chain, tx.to).catch(() => undefined)
+    // The registry's protocol name beats anything on-chain: "Aave", not a proxy's class name.
+    Promise.resolve(lookupContract(chain, tx.to))
+      .then((entry) => (entry ? protocolLabel(entry.protocol) : addressLabel(chain, tx.to)))
+      .catch(() => undefined)
   ])
 
   return {