web3-tools-mcp 2.0.2 → 3.1.0

package/dist/signing-requests.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A signature that outlives the tool call that asked for it.
+ *
+ * Approving happens on a human's schedule. A browser signer is told to come — the tab opens
+ * and the badge flashes — but a phone wallet is only as loud as the wallet itself, and some
+ * send no notification at all. So the wait routinely outlives whatever timeout the MCP
+ * client applies, and the agent is left holding a tool call that never returns while the
+ * request is still perfectly alive in the wallet.
+ *
+ * Each request gets an id and outlives its call. Settling quickly still returns inline, so
+ * the common case — a browser tab that pops up and is approved in seconds — is unchanged.
+ * Past that the call hands back the id and the agent collects the result later.
+ *
+ * Held in memory on purpose: a request is only meaningful while the socket or WalletConnect
+ * session that carries it is alive, and both die with the process anyway.
+ */
+/**
+ * How long to wait on a signer that has been told to come — the browser page, whose tab
+ * opens and whose title flashes. Comfortably under any MCP client's tool timeout.
+ *
+ * A signer that cannot raise the alarm does not use this at all: it calls `waiting()` the
+ * moment the request is with the wallet, and the call returns then. Waiting on a phone that
+ * never buzzed is dead time either way.
+ */
+export declare const GRACE_MS = 25000;
+export type SigningState = 'pending' | 'done' | 'failed';
+export interface SigningRequest {
+    id: string;
+    identity: string;
+    /** What is being asked for, in a line, so a later check can say what it was. */
+    summary: string;
+    signer: 'browser' | 'phone';
+    /** Waiting on a person, or on the chain. They deserve different things said about them. */
+    stage: 'approval' | 'mining';
+    /** Known once approved, so a request can be followed on an explorer before it settles. */
+    txHash?: string;
+    startedAt: number;
+    state: SigningState;
+    settledAt?: number;
+    result?: unknown;
+    error?: string;
+}
+/** How a signing job says where it has got to. */
+export interface SigningProgress {
+    /**
+     * The request is with the wallet and only a human is left. Everything that fails quickly —
+     * no session, an unapproved chain, a reverted simulation — has already thrown.
+     */
+    waiting: () => void;
+    /** Approved and broadcast. Nothing is settled until it is mined. */
+    mining: (txHash: string) => void;
+}
+/**
+ * Run a signing request, waiting only as long as a tool call reasonably can.
+ *
+ * The work starts here either way — returning `done: false` means nobody has approved yet,
+ * never that nothing was asked.
+ */
+export declare function signingCall<T>(context: {
+    identity: string;
+    summary: string;
+    signer: 'browser' | 'phone';
+    graceMs?: number;
+}, run: (progress: SigningProgress) => Promise<T>): Promise<{
+    done: true;
+    result: T;
+} | {
+    done: false;
+    request: SigningRequest;
+}>;
+/**
+ * Collect a request handed back earlier, waiting out another grace period if it is still
+ * pending — so an agent that checks in a loop paces itself rather than spinning.
+ *
+ * Scoped to the caller: an id is unguessable, but on a server carrying several people that
+ * is not the reason one of them cannot read another's signature.
+ */
+export declare function collectSigningRequest(id: string, identity: string, graceMs?: number): Promise<SigningRequest>;
+/** Everything this identity still has in front of a wallet. */
+export declare function pendingSigningRequests(identity: string): SigningRequest[];
+//# sourceMappingURL=signing-requests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signing-requests.d.ts","sourceRoot":"","sources":["../src/signing-requests.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,QAAS,CAAA;AAK9B,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAExD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;IAC3B,2FAA2F;IAC3F,KAAK,EAAE,UAAU,GAAG,QAAQ,CAAA;IAC5B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,oEAAoE;IACpE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAuCD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7F,GAAG,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC,CA6D/E;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAYrH;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAGzE"}

package/dist/signing-requests.js

@@ -0,0 +1,138 @@
+import { randomBytes } from 'node:crypto';
+import { log } from './log.js';
+/**
+ * A signature that outlives the tool call that asked for it.
+ *
+ * Approving happens on a human's schedule. A browser signer is told to come — the tab opens
+ * and the badge flashes — but a phone wallet is only as loud as the wallet itself, and some
+ * send no notification at all. So the wait routinely outlives whatever timeout the MCP
+ * client applies, and the agent is left holding a tool call that never returns while the
+ * request is still perfectly alive in the wallet.
+ *
+ * Each request gets an id and outlives its call. Settling quickly still returns inline, so
+ * the common case — a browser tab that pops up and is approved in seconds — is unchanged.
+ * Past that the call hands back the id and the agent collects the result later.
+ *
+ * Held in memory on purpose: a request is only meaningful while the socket or WalletConnect
+ * session that carries it is alive, and both die with the process anyway.
+ */
+/**
+ * How long to wait on a signer that has been told to come — the browser page, whose tab
+ * opens and whose title flashes. Comfortably under any MCP client's tool timeout.
+ *
+ * A signer that cannot raise the alarm does not use this at all: it calls `waiting()` the
+ * moment the request is with the wallet, and the call returns then. Waiting on a phone that
+ * never buzzed is dead time either way.
+ */
+export const GRACE_MS = 25_000;
+/** How long a finished result stays collectable. */
+const RESULT_TTL = 15 * 60_000;
+const requests = new Map();
+function sweep() {
+    const now = Date.now();
+    for (const [id, request] of requests) {
+        if (request.settledAt && now - request.settledAt > RESULT_TTL)
+            requests.delete(id);
+    }
+}
+function view(request) {
+    const { settled: _settled, ...rest } = request;
+    return rest;
+}
+/** Resolves when the request settles, or when the grace runs out — whichever comes first. */
+function race(request, graceMs, handoff) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, graceMs);
+        // A request nobody is waiting for must not keep a stdio server alive after its client
+        // has gone; shutdown is what ends it.
+        timer.unref?.();
+        const done = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        request.settled.then(done);
+        handoff?.then(done);
+    });
+}
+/**
+ * Run a signing request, waiting only as long as a tool call reasonably can.
+ *
+ * The work starts here either way — returning `done: false` means nobody has approved yet,
+ * never that nothing was asked.
+ */
+export async function signingCall(context, run) {
+    sweep();
+    const id = randomBytes(16).toString('hex');
+    // Ends the wait: until it is called, a failure is a real error the caller should see
+    // rather than something to be collected later.
+    let handedOff;
+    const handoff = new Promise((resolve) => {
+        handedOff = resolve;
+    });
+    // Built before `run` starts, because a signer is free to report progress synchronously.
+    const request = {
+        id,
+        identity: context.identity,
+        summary: context.summary,
+        signer: context.signer,
+        stage: 'approval',
+        startedAt: Date.now(),
+        state: 'pending',
+        settled: Promise.resolve()
+    };
+    // Broadcasting does not end the wait. On a fast chain the receipt is seconds away, and a
+    // caller still inside its grace would rather have the mined result than a request id.
+    const started = run({
+        waiting: () => handedOff(),
+        mining: (txHash) => {
+            request.stage = 'mining';
+            request.txHash = txHash;
+        }
+    });
+    request.settled = started.then((result) => {
+        request.state = 'done';
+        request.result = result;
+        request.settledAt = Date.now();
+    }, (error) => {
+        request.state = 'failed';
+        request.error = error instanceof Error ? error.message : String(error);
+        request.settledAt = Date.now();
+    });
+    requests.set(id, request);
+    await race(request, context.graceMs ?? GRACE_MS, handoff);
+    if (request.state === 'done') {
+        requests.delete(id);
+        return { done: true, result: request.result };
+    }
+    if (request.state === 'failed') {
+        requests.delete(id);
+        throw new Error(request.error);
+    }
+    log('info', 'Signing', `${context.summary} is still waiting for approval — handed back as ${id.slice(0, 8)}`);
+    return { done: false, request: view(request) };
+}
+/**
+ * Collect a request handed back earlier, waiting out another grace period if it is still
+ * pending — so an agent that checks in a loop paces itself rather than spinning.
+ *
+ * Scoped to the caller: an id is unguessable, but on a server carrying several people that
+ * is not the reason one of them cannot read another's signature.
+ */
+export async function collectSigningRequest(id, identity, graceMs = GRACE_MS) {
+    sweep();
+    const request = requests.get(id);
+    if (!request || request.identity !== identity) {
+        throw new Error(`No signing request ${id} is waiting. It may have been collected already, or it expired.`);
+    }
+    if (request.state === 'pending')
+        await race(request, graceMs);
+    if (request.state !== 'pending')
+        requests.delete(id);
+    return view(request);
+}
+/** Everything this identity still has in front of a wallet. */
+export function pendingSigningRequests(identity) {
+    sweep();
+    return [...requests.values()].filter((request) => request.identity === identity && request.state === 'pending').map(view);
+}
+//# sourceMappingURL=signing-requests.js.map

package/dist/signing-requests.js.map

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

package/dist/tools/index.d.ts

@@ -1,3 +1,29 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerAllTools(server: McpServer): void;
+import type { ToolResult } from '../types.js';
+/**
+ * What a tool does with a wallet, which is the line everything else divides along.
+ *
+ * `read` answers questions about a chain and costs an RPC call. `sign` puts a transaction
+ * in front of somebody's wallet, and is the reason identity and rooms exist. A host pricing
+ * or rate-limiting tool calls almost always wants this distinction, and taking it from the
+ * folder a tool lives in means it cannot drift from a hand-kept list.
+ */
+export type ToolGroup = 'read' | 'sign';
+/** The group a tool belongs to, for a host deciding what it costs or who may call it. */
+export declare function toolGroup(name: string): ToolGroup | undefined;
+/**
+ * Wraps every tool call, for a host that needs to say who may run what.
+ *
+ * Deliberately only the tool's name, its group and who is calling: enough to count calls,
+ * refuse them past a limit and record what was used, without this package taking a view on
+ * any of it. Throwing refuses the call, and the message reaches the agent — so it should
+ * say what to do about it. Whatever the returned promise settles as is what the caller
+ * sees, so a host can also time a call or meter it once it has succeeded.
+ */
+export type ToolMiddleware = (call: {
+    tool: string;
+    group: ToolGroup;
+    identity: string;
+}, run: () => Promise<ToolResult>) => Promise<ToolResult>;
+export declare function registerAllTools(server: McpServer, middleware?: ToolMiddleware): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AA0BxE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAcjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAKxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAc7C;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAA;AA2BvC,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE7D;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC1D,GAAG,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,KAC3B,OAAO,CAAC,UAAU,CAAC,CAAA;AAExB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,cAAc,QA6B9E"}

package/dist/tools/index.js

@@ -1,13 +1,18 @@
-import advancedTools from './advanced.js';
-import balanceTools from './balance.js';
-import contractTools from './contract.js';
-import contractInfoTools from './contract-info.js';
-import ensTools from './ens.js';
-import gasTools from './gas.js';
-import logTools from './logs.js';
-import signatureTools from './signatures.js';
-import transactionTools from './transactions.js';
-const allToolDefinitions = {
+import { getClientManager } from '../client.js';
+import { identityFrom } from '../context.js';
+import { redactSecrets } from '../utils.js';
+import advancedTools from './read/advanced.js';
+import balanceTools from './read/balance.js';
+import contractTools from './read/contract.js';
+import contractInfoTools from './read/contract-info.js';
+import ensTools from './read/ens.js';
+import gasTools from './read/gas.js';
+import logTools from './read/logs.js';
+import signatureTools from './read/signatures.js';
+import signingRequestTools from './read/signing.js';
+import transactionTools from './sign/transactions.js';
+import walletTools from './sign/wallet.js';
+const readTools = {
     ...signatureTools,
     ...contractTools,
     ...contractInfoTools,
@@ -16,17 +21,47 @@ const allToolDefinitions = {
     ...advancedTools,
     ...ensTools,
     ...gasTools,
-    ...transactionTools
+    // A signature already asked for and paid for; collecting it is not a second request.
+    ...signingRequestTools
 };
-// Register all tools with the MCP server
-export function registerAllTools(server) {
+const signTools = {
+    ...transactionTools,
+    ...walletTools
+};
+const allToolDefinitions = { ...readTools, ...signTools };
+const groups = new Map([
+    ...Object.keys(readTools).map((name) => [name, 'read']),
+    ...Object.keys(signTools).map((name) => [name, 'sign'])
+]);
+/** The group a tool belongs to, for a host deciding what it costs or who may call it. */
+export function toolGroup(name) {
+    return groups.get(name);
+}
+export function registerAllTools(server, middleware) {
     Object.entries(allToolDefinitions).forEach(([name, tool]) => {
+        if (tool.available && !tool.available())
+            return;
         server.registerTool(name, {
             title: tool.title,
             description: tool.description,
             inputSchema: tool.schema.shape
-        }, async (args, _extra) => {
-            return await tool.handler(args);
+        }, async (args, extra) => {
+            // Passed to every handler; the ones that reach a signer must say whose it is.
+            const identity = identityFrom(extra.authInfo);
+            const run = () => tool.handler(args, identity);
+            const group = toolGroup(name);
+            // Anything a tool returns or throws may quote an RPC URL, and those carry provider keys.
+            const config = getClientManager().getConfig();
+            try {
+                const result = await (middleware ? middleware({ tool: name, group, identity }, run) : run());
+                return { ...result, content: result.content.map((item) => ({ ...item, text: redactSecrets(item.text, config) })) };
+            }
+            catch (error) {
+                if (!(error instanceof Error))
+                    throw new Error(redactSecrets(String(error), config));
+                error.message = redactSecrets(error.message, config);
+                throw error;
+            }
         });
     });
 }

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,aAAa,MAAM,eAAe,CAAA;AACzC,OAAO,YAAY,MAAM,cAAc,CAAA;AACvC,OAAO,aAAa,MAAM,eAAe,CAAA;AACzC,OAAO,iBAAiB,MAAM,oBAAoB,CAAA;AAClD,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,cAAc,MAAM,iBAAiB,CAAA;AAC5C,OAAO,gBAAgB,MAAM,mBAAmB,CAAA;AAEhD,MAAM,kBAAkB,GAAG;IACzB,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,iBAAiB;IACpB,GAAG,YAAY;IACf,GAAG,QAAQ;IACX,GAAG,aAAa;IAChB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,gBAAgB;CACX,CAAA;AAEV,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QAC1D,MAAM,CAAC,YAAY,CACjB,IAAI,EACJ;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SAC/B,EACD,KAAK,EAAE,IAAS,EAAE,MAA8D,EAAE,EAAE;YAClF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACjC,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/{advanced.d.ts → read/advanced.d.ts}

@@ -1,88 +1,96 @@
 import { z } from 'zod';
+/** The trace itself if it fits, otherwise its JSON cut short. */
+export declare function boundTrace(trace: unknown): {
+    trace: unknown;
+    truncated?: true;
+};
 declare const _default: {
     get_storage_at: {
         title: string;
         description: string;
         schema: z.ZodObject<{
-            chain: z.ZodEnum<["arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
             address: z.ZodString;
             slot: z.ZodString;
             abiType: z.ZodString;
             blockNumber: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             address: string;
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             slot: string;
             abiType: string;
             blockNumber?: string | undefined;
         }, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             address: string;
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             slot: string;
             abiType: string;
             blockNumber?: string | undefined;
         }>;
         handler: (args: {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             address: string;
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             slot: string;
             abiType: string;
             blockNumber?: string | undefined;
-        }) => Promise<import("../types.js").ToolResult>;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
     };
     get_block_info: {
         title: string;
         description: string;
         schema: z.ZodObject<{
-            chain: z.ZodEnum<["arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
             blockNumber: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             blockNumber?: string | undefined;
         }, {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             blockNumber?: string | undefined;
         }>;
         handler: (args: {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             blockNumber?: string | undefined;
-        }) => Promise<import("../types.js").ToolResult>;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
     };
     trace_transaction: {
         title: string;
         description: string;
         schema: z.ZodObject<{
-            chain: z.ZodEnum<["arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
             transactionHash: z.ZodString;
-            traceType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["trace", "vmTrace", "stateDiff"]>>>;
+            traceType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["trace", "prestate", "stateDiff"]>>>;
             useAnvil: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             summarize: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         }, "strip", z.ZodTypeAny, {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             transactionHash: string;
-            traceType: "trace" | "vmTrace" | "stateDiff";
+            traceType: "trace" | "prestate" | "stateDiff";
             useAnvil: boolean;
             summarize: boolean;
         }, {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             transactionHash: string;
-            traceType?: "trace" | "vmTrace" | "stateDiff" | undefined;
+            traceType?: "trace" | "prestate" | "stateDiff" | undefined;
             useAnvil?: boolean | undefined;
             summarize?: boolean | undefined;
         }>;
         handler: (args: {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             transactionHash: string;
-            traceType: "trace" | "vmTrace" | "stateDiff";
+            traceType: "trace" | "prestate" | "stateDiff";
             useAnvil: boolean;
             summarize: boolean;
-        }) => Promise<import("../types.js").ToolResult>;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
     };
     debug_call: {
         title: string;
         description: string;
         schema: z.ZodObject<{
-            chain: z.ZodEnum<["arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
+            chain: z.ZodEnum<["mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost", ...("mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost")[]]>;
             to: z.ZodString;
             data: z.ZodOptional<z.ZodString>;
             functionAbi: z.ZodOptional<z.ZodString>;
@@ -93,40 +101,41 @@ declare const _default: {
             traceType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["callTracer", "prestateTracer"]>>>;
             summarize: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         }, "strip", z.ZodTypeAny, {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             to: string;
             traceType: "callTracer" | "prestateTracer";
             summarize: boolean;
-            data?: string | undefined;
+            blockNumber?: string | undefined;
             from?: string | undefined;
             value?: string | undefined;
-            blockNumber?: string | undefined;
+            data?: string | undefined;
             args?: (string | number | boolean)[] | undefined;
             functionAbi?: string | undefined;
         }, {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             to: string;
-            data?: string | undefined;
+            blockNumber?: string | undefined;
             from?: string | undefined;
             value?: string | undefined;
-            blockNumber?: string | undefined;
+            data?: string | undefined;
             args?: (string | number | boolean)[] | undefined;
             traceType?: "callTracer" | "prestateTracer" | undefined;
             summarize?: boolean | undefined;
             functionAbi?: string | undefined;
         }>;
         handler: (args: {
-            chain: "arbitrum" | "mainnet" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
             to: string;
             traceType: "callTracer" | "prestateTracer";
             summarize: boolean;
-            data?: string | undefined;
+            blockNumber?: string | undefined;
             from?: string | undefined;
             value?: string | undefined;
-            blockNumber?: string | undefined;
+            data?: string | undefined;
             args?: (string | number | boolean)[] | undefined;
             functionAbi?: string | undefined;
-        }) => Promise<import("../types.js").ToolResult>;
+        }, identity: string) => Promise<import("../../types.js").ToolResult>;
+        available: (() => boolean) | undefined;
     };
 };
 export default _default;

package/dist/tools/read/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../../src/tools/read/advanced.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAcvB,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAAE,CAG/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQD,wBAwZC"}