agentpay-mcp 1.2.0 → 4.0.0

package/dist/session/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * session/types.ts — Type definitions for x402 V2 session management.
+ *
+ * x402 V2 introduced the concept of "wallet-based access & reusable sessions":
+ * agents pay once to establish a session, then skip on-chain payment on every
+ * subsequent call within that session. This module defines the data structures
+ * that AgentPay MCP uses to implement this pattern non-custodially.
+ *
+ * Reference: https://www.x402.org/writing/x402-v2-launch
+ *   "V2 protocol now includes the logic to support wallet-controlled sessions,
+ *    allowing clients to skip the full payment flow for repeated access if the
+ *    resource was previously purchased."
+ */
+export interface SessionRecord {
+    /** Unique session identifier (UUIDv4) */
+    readonly sessionId: string;
+    /**
+     * Base URL this session covers.
+     * All requests to URLs matching this prefix (or exact URL) are included.
+     */
+    readonly endpoint: string;
+    /**
+     * Scope of the session:
+     *  - "prefix": covers all paths under the endpoint (e.g., all of api.example.com/v1/*)
+     *  - "exact":  covers only the single URL that was paid for
+     */
+    readonly scope: 'prefix' | 'exact';
+    /** Wallet address that owns this session (from AGENT_WALLET_ADDRESS) */
+    readonly walletAddress: string;
+    /** Unix timestamp (seconds) when the session was created */
+    readonly createdAt: number;
+    /** Unix timestamp (seconds) when the session expires */
+    readonly expiresAt: number;
+    /** On-chain transaction hash of the initial session payment */
+    readonly paymentTxHash: string;
+    /** Amount paid (in base units / wei) as a string-encoded bigint */
+    readonly paymentAmount: string;
+    /** Token address that was paid (zero address = native ETH) */
+    readonly paymentToken: string;
+    /** Recipient address of the initial payment */
+    readonly paymentRecipient: string;
+    /**
+     * Cryptographic session token.
+     * Base64url-encoded JSON payload signed by the agent's private key using
+     * secp256k1 ECDSA (viem signMessage). Presented to servers as the
+     * X-Session-Token header — compatible with x402 V2's SIGN-IN-WITH-X pattern.
+     */
+    readonly sessionToken: string;
+    /**
+     * ECDSA signature over the token payload.
+     * Servers can verify ownership of walletAddress without any custody.
+     */
+    readonly signature: string;
+    /**
+     * Human-readable label for this session (optional, set by caller).
+     */
+    readonly label?: string;
+    /** Number of requests made within this session */
+    callCount: number;
+    /** Last request timestamp (Unix seconds) */
+    lastUsedAt: number;
+}
+/**
+ * Canonical payload signed by the agent wallet.
+ * This is serialised to a deterministic JSON string before signing.
+ * Servers that implement x402 V2 session verification can reconstruct this
+ * and call `ecrecover` / viem's `verifyMessage` to confirm wallet identity.
+ */
+export interface SessionTokenPayload {
+    /** Protocol version marker */
+    version: 'clawpay/1.1';
+    sessionId: string;
+    walletAddress: string;
+    endpoint: string;
+    scope: 'prefix' | 'exact';
+    createdAt: number;
+    expiresAt: number;
+    paymentTxHash: string;
+    paymentAmount: string;
+}
+export interface CreateSessionOptions {
+    endpoint: string;
+    scope?: 'prefix' | 'exact';
+    ttlSeconds?: number;
+    label?: string;
+    paymentTxHash: string;
+    paymentAmount: bigint;
+    paymentToken: string;
+    paymentRecipient: string;
+    walletAddress: string;
+    /** viem signMessage function — must match walletAddress */
+    signMessage: (message: string) => Promise<string>;
+}
+export type SessionLookupResult = {
+    found: true;
+    session: SessionRecord;
+    expired: false;
+} | {
+    found: true;
+    session: SessionRecord;
+    expired: true;
+} | {
+    found: false;
+};
+export interface SessionFetchOptions {
+    sessionId: string;
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    headers?: Record<string, string>;
+    body?: string;
+    timeoutMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IAEnC,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,mEAAmE;IACnE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,+CAA+C;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,OAAO,EAAE,aAAa,CAAC;IAEvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAID,MAAM,MAAM,mBAAmB,GAC3B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GACvD;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GACtD;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAIrB,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/session/types.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * session/types.ts — Type definitions for x402 V2 session management.
+ *
+ * x402 V2 introduced the concept of "wallet-based access & reusable sessions":
+ * agents pay once to establish a session, then skip on-chain payment on every
+ * subsequent call within that session. This module defines the data structures
+ * that AgentPay MCP uses to implement this pattern non-custodially.
+ *
+ * Reference: https://www.x402.org/writing/x402-v2-launch
+ *   "V2 protocol now includes the logic to support wallet-controlled sessions,
+ *    allowing clients to skip the full payment flow for repeated access if the
+ *    resource was previously purchased."
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG"}

package/dist/tools/bridge.d.ts

@@ -0,0 +1,52 @@
+/**
+ * bridge.ts — bridge_usdc tool.
+ *
+ * Wraps agentwallet-sdk v6 BridgeModule (CCTP V2 cross-chain USDC bridge).
+ */
+import { z } from 'zod';
+export declare const BridgeUsdcSchema: z.ZodObject<{
+    fromChain: z.ZodEnum<["base", "ethereum", "optimism", "arbitrum", "polygon", "avalanche", "linea", "unichain", "sonic", "worldchain"]>;
+    toChain: z.ZodEnum<["base", "ethereum", "optimism", "arbitrum", "polygon", "avalanche", "linea", "unichain", "sonic", "worldchain"]>;
+    amount: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    fromChain: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism" | "avalanche" | "unichain" | "linea" | "sonic" | "worldchain";
+    toChain: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism" | "avalanche" | "unichain" | "linea" | "sonic" | "worldchain";
+}, {
+    amount: string;
+    fromChain: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism" | "avalanche" | "unichain" | "linea" | "sonic" | "worldchain";
+    toChain: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism" | "avalanche" | "unichain" | "linea" | "sonic" | "worldchain";
+}>;
+export type BridgeUsdcInput = z.infer<typeof BridgeUsdcSchema>;
+export declare const bridgeUsdcTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            fromChain: {
+                type: string;
+                enum: ("base" | "ethereum" | "arbitrum" | "polygon" | "optimism" | "avalanche" | "unichain" | "linea" | "sonic" | "worldchain")[];
+                description: string;
+            };
+            toChain: {
+                type: string;
+                enum: ("base" | "ethereum" | "arbitrum" | "polygon" | "optimism" | "avalanche" | "unichain" | "linea" | "sonic" | "worldchain")[];
+                description: string;
+            };
+            amount: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleBridgeUsdc(input: BridgeUsdcInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/tools/bridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiBvB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAU3B,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAI9D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;CA0B1B,CAAA;AAID,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA2ChF"}

package/dist/tools/bridge.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bridgeUsdcTool = exports.BridgeUsdcSchema = void 0;
+exports.handleBridgeUsdc = handleBridgeUsdc;
+/**
+ * bridge.ts — bridge_usdc tool.
+ *
+ * Wraps agentwallet-sdk v6 BridgeModule (CCTP V2 cross-chain USDC bridge).
+ */
+const zod_1 = require("zod");
+const agentwallet_sdk_1 = require("agentwallet-sdk");
+const client_js_1 = require("../utils/client.js");
+const format_js_1 = require("../utils/format.js");
+// Supported CCTP V2 chain names
+const SUPPORTED_CHAINS = [
+    'base', 'ethereum', 'optimism', 'arbitrum', 'polygon',
+    'avalanche', 'linea', 'unichain', 'sonic', 'worldchain',
+];
+// ─── Schema ────────────────────────────────────────────────────────────────
+exports.BridgeUsdcSchema = zod_1.z.object({
+    fromChain: zod_1.z
+        .enum(SUPPORTED_CHAINS)
+        .describe('Source chain name (e.g. "base", "ethereum", "arbitrum")'),
+    toChain: zod_1.z
+        .enum(SUPPORTED_CHAINS)
+        .describe('Destination chain name (e.g. "polygon", "optimism")'),
+    amount: zod_1.z
+        .string()
+        .describe('Amount of USDC to bridge in human-readable units, e.g. "100" for 100 USDC'),
+});
+// ─── Tool definition ───────────────────────────────────────────────────────
+exports.bridgeUsdcTool = {
+    name: 'bridge_usdc',
+    description: 'Bridge USDC across chains using Circle\'s CCTP V2 protocol. ' +
+        'Supported chains: base, ethereum, optimism, arbitrum, polygon, avalanche, linea, unichain, sonic, worldchain. ' +
+        'The bridge approves USDC, burns on source, polls Circle IRIS for attestation, then mints on destination.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            fromChain: {
+                type: 'string',
+                enum: [...SUPPORTED_CHAINS],
+                description: 'Source chain name',
+            },
+            toChain: {
+                type: 'string',
+                enum: [...SUPPORTED_CHAINS],
+                description: 'Destination chain name',
+            },
+            amount: {
+                type: 'string',
+                description: 'Amount of USDC to bridge (human-readable, e.g. "100")',
+            },
+        },
+        required: ['fromChain', 'toChain', 'amount'],
+    },
+};
+// ─── Handler ───────────────────────────────────────────────────────────────
+async function handleBridgeUsdc(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        if (input.fromChain === input.toChain) {
+            throw new Error('fromChain and toChain must be different');
+        }
+        // Parse USDC amount (6 decimals)
+        const USDC_DECIMALS = 6;
+        const amountFloat = parseFloat(input.amount);
+        if (isNaN(amountFloat) || amountFloat <= 0) {
+            throw new Error(`Invalid amount: "${input.amount}". Must be a positive number.`);
+        }
+        const rawAmount = BigInt(Math.round(amountFloat * 10 ** USDC_DECIMALS));
+        const bridge = (0, agentwallet_sdk_1.createBridge)(wallet.walletClient, input.fromChain);
+        const result = await bridge.bridge(rawAmount, input.toChain);
+        return {
+            content: [
+                (0, format_js_1.textContent)(JSON.stringify({
+                    success: true,
+                    burnTxHash: result.burnTxHash,
+                    mintTxHash: result.mintTxHash,
+                    fromChain: result.fromChain,
+                    toChain: result.toChain,
+                    recipient: result.recipient,
+                    amount: input.amount,
+                    rawAmount: rawAmount.toString(),
+                    elapsedMs: result.elapsedMs,
+                })),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'bridge_usdc'))],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/tools/bridge.js.map

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

package/dist/tools/budget.d.ts

@@ -0,0 +1,84 @@
+/**
+ * budget.ts — set_spend_policy, check_budget tools.
+ *
+ * set_spend_policy: configure a SpendingPolicy (in-process, persists for server lifetime).
+ * check_budget: query on-chain remaining budget via checkBudget().
+ */
+import { z } from 'zod';
+export declare function _resetPolicyStore(): void;
+export declare const SetSpendPolicySchema: z.ZodObject<{
+    dailyLimitEth: z.ZodOptional<z.ZodString>;
+    perTxCapEth: z.ZodOptional<z.ZodString>;
+    allowedRecipients: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    dailyLimitEth?: string | undefined;
+    perTxCapEth?: string | undefined;
+    allowedRecipients?: string[] | undefined;
+}, {
+    dailyLimitEth?: string | undefined;
+    perTxCapEth?: string | undefined;
+    allowedRecipients?: string[] | undefined;
+}>;
+export type SetSpendPolicyInput = z.infer<typeof SetSpendPolicySchema>;
+export declare const setSpendPolicyTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            dailyLimitEth: {
+                type: string;
+                description: string;
+            };
+            perTxCapEth: {
+                type: string;
+                description: string;
+            };
+            allowedRecipients: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleSetSpendPolicy(input: SetSpendPolicyInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const CheckBudgetSchema: z.ZodObject<{
+    token: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    token?: string | undefined;
+}, {
+    token?: string | undefined;
+}>;
+export type CheckBudgetInput = z.infer<typeof CheckBudgetSchema>;
+export declare const checkBudgetTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleCheckBudget(input: CheckBudgetInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/tools/budget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiBvB,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAID,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAa/B,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEtE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;CAyB9B,CAAA;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAwDhF;AAID,eAAO,MAAM,iBAAiB;;;;;;EAS5B,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEhE,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAgB3B,CAAA;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBhF"}

package/dist/tools/budget.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkBudgetTool = exports.CheckBudgetSchema = exports.setSpendPolicyTool = exports.SetSpendPolicySchema = void 0;
+exports._resetPolicyStore = _resetPolicyStore;
+exports.handleSetSpendPolicy = handleSetSpendPolicy;
+exports.handleCheckBudget = handleCheckBudget;
+/**
+ * budget.ts — set_spend_policy, check_budget tools.
+ *
+ * set_spend_policy: configure a SpendingPolicy (in-process, persists for server lifetime).
+ * check_budget: query on-chain remaining budget via checkBudget().
+ */
+const zod_1 = require("zod");
+const agentwallet_sdk_1 = require("agentwallet-sdk");
+const viem_1 = require("viem");
+const client_js_1 = require("../utils/client.js");
+const format_js_1 = require("../utils/format.js");
+let _policyConfig = null;
+let _spendingPolicy = null;
+function _resetPolicyStore() {
+    _policyConfig = null;
+    _spendingPolicy = null;
+}
+// ─── set_spend_policy ──────────────────────────────────────────────────────
+exports.SetSpendPolicySchema = zod_1.z.object({
+    dailyLimitEth: zod_1.z
+        .string()
+        .optional()
+        .describe('Daily spend limit in ETH-equivalent, e.g. "0.1"'),
+    perTxCapEth: zod_1.z
+        .string()
+        .optional()
+        .describe('Per-transaction cap in ETH-equivalent, e.g. "0.01"'),
+    allowedRecipients: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('Allowlist of recipient addresses (0x-prefixed). Empty = all allowed.'),
+});
+exports.setSpendPolicyTool = {
+    name: 'set_spend_policy',
+    description: 'Configure the Agent Wallet spend policy. ' +
+        'Sets a daily limit, per-transaction cap, and optional recipient allowlist. ' +
+        'The policy is enforced in-process for the lifetime of the MCP server.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            dailyLimitEth: {
+                type: 'string',
+                description: 'Daily spend limit in ETH-equivalent (e.g. "0.1")',
+            },
+            perTxCapEth: {
+                type: 'string',
+                description: 'Per-tx cap in ETH-equivalent (e.g. "0.01")',
+            },
+            allowedRecipients: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Allowlisted recipient addresses',
+            },
+        },
+        required: [],
+    },
+};
+async function handleSetSpendPolicy(input) {
+    try {
+        const ethToWei = (eth) => {
+            const val = parseFloat(eth);
+            if (isNaN(val) || val < 0)
+                throw new Error(`Invalid ETH amount: "${eth}"`);
+            return BigInt(Math.round(val * 1e18));
+        };
+        const merchantAllowlist = input.allowedRecipients ?? [];
+        // Build SpendingPolicyConfig from inputs
+        // rollingCap uses a 24-hour window for dailyLimitEth
+        const rollingCap = input.dailyLimitEth
+            ? {
+                maxAmount: Number(ethToWei(input.dailyLimitEth)),
+                windowMs: 86_400_000, // 24 hours
+            }
+            : undefined;
+        // draftThreshold maps to perTxCap — payments above this go to draft
+        const draftThreshold = input.perTxCapEth
+            ? Number(ethToWei(input.perTxCapEth))
+            : undefined;
+        _spendingPolicy = new agentwallet_sdk_1.SpendingPolicy({
+            merchantAllowlist,
+            rollingCap,
+            draftThreshold,
+        });
+        _policyConfig = {
+            dailyLimitEth: input.dailyLimitEth,
+            perTxCapEth: input.perTxCapEth,
+            allowedRecipients: merchantAllowlist,
+        };
+        return {
+            content: [
+                (0, format_js_1.textContent)(JSON.stringify({
+                    success: true,
+                    policy: {
+                        dailyLimitEth: input.dailyLimitEth ?? null,
+                        perTxCapEth: input.perTxCapEth ?? null,
+                        allowedRecipients: merchantAllowlist,
+                    },
+                })),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'set_spend_policy'))],
+            isError: true,
+        };
+    }
+}
+// ─── check_budget ──────────────────────────────────────────────────────────
+exports.CheckBudgetSchema = zod_1.z.object({
+    token: zod_1.z
+        .string()
+        .optional()
+        .describe('Token address to check budget for. ' +
+        'Use "0x0000000000000000000000000000000000000000" for ETH (default). ' +
+        'Or a USDC/ERC20 contract address.'),
+});
+exports.checkBudgetTool = {
+    name: 'check_budget',
+    description: 'Check the remaining on-chain budget for the Agent Wallet. ' +
+        'Returns per-transaction limit and period remaining. ' +
+        'Optionally include any configured spend policy details.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token: {
+                type: 'string',
+                description: 'Token address (default: ETH / zero address)',
+            },
+        },
+        required: [],
+    },
+};
+async function handleCheckBudget(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const token = input.token ?? viem_1.zeroAddress;
+        const budget = await (0, agentwallet_sdk_1.checkBudget)(wallet, token);
+        return {
+            content: [
+                (0, format_js_1.textContent)(JSON.stringify({
+                    token,
+                    perTxLimit: budget.perTxLimit.toString(),
+                    remainingInPeriod: budget.remainingInPeriod.toString(),
+                    policy: _policyConfig ?? null,
+                })),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'check_budget'))],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=budget.js.map

package/dist/tools/budget.js.map

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

package/dist/tools/deploy.d.ts

@@ -0,0 +1,49 @@
+/**
+ * deploy_wallet tool — Deploy a new AgentAccountV2 wallet via the factory.
+ * Requires FACTORY_ADDRESS and NFT_CONTRACT_ADDRESS env vars.
+ */
+import { z } from 'zod';
+export declare const DeployWalletSchema: z.ZodObject<{
+    token_id: z.ZodString;
+    nft_contract_address: z.ZodOptional<z.ZodString>;
+    factory_address: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    token_id: string;
+    nft_contract_address?: string | undefined;
+    factory_address?: string | undefined;
+}, {
+    token_id: string;
+    nft_contract_address?: string | undefined;
+    factory_address?: string | undefined;
+}>;
+export type DeployWalletInput = z.infer<typeof DeployWalletSchema>;
+export declare const deployWalletTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            token_id: {
+                type: string;
+                description: string;
+            };
+            nft_contract_address: {
+                type: string;
+                description: string;
+            };
+            factory_address: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleDeployWallet(input: DeployWalletInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=deploy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/tools/deploy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAkB7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAInE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;CAyB5B,CAAC;AAIF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA6EhF"}