agentpay-mcp 1.2.0 → 3.1.0

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/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"}

package/dist/tools/deploy.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deployWalletTool = exports.DeployWalletSchema = void 0;
+exports.handleDeployWallet = handleDeployWallet;
+/**
+ * deploy_wallet tool — Deploy a new AgentAccountV2 wallet via the factory.
+ * Requires FACTORY_ADDRESS and NFT_CONTRACT_ADDRESS env vars.
+ */
+const zod_1 = require("zod");
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const chains_1 = require("viem/chains");
+const agentwallet_sdk_1 = require("agentwallet-sdk");
+const client_js_1 = require("../utils/client.js");
+const format_js_1 = require("../utils/format.js");
+// ─── Schema ────────────────────────────────────────────────────────────────
+exports.DeployWalletSchema = zod_1.z.object({
+    token_id: zod_1.z
+        .string()
+        .describe('NFT token ID that will own the deployed wallet (e.g. "1")'),
+    nft_contract_address: zod_1.z
+        .string()
+        .optional()
+        .describe('NFT contract address that owns this wallet. ' +
+        'Defaults to NFT_CONTRACT_ADDRESS env var.'),
+    factory_address: zod_1.z
+        .string()
+        .optional()
+        .describe('AgentAccountFactoryV2 address. ' +
+        'Defaults to FACTORY_ADDRESS env var.'),
+});
+// ─── Tool definition ───────────────────────────────────────────────────────
+exports.deployWalletTool = {
+    name: 'deploy_wallet',
+    description: 'Deploy a new AgentAccountV2 wallet via the factory contract. ' +
+        'The wallet is deterministically addressed (CREATE2) and owned by an NFT. ' +
+        'Returns the wallet address and deployment transaction hash. ' +
+        'Requires FACTORY_ADDRESS and NFT_CONTRACT_ADDRESS env vars (or pass them as arguments).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token_id: {
+                type: 'string',
+                description: 'NFT token ID that will own this wallet (e.g. "1")',
+            },
+            nft_contract_address: {
+                type: 'string',
+                description: 'NFT contract address. Defaults to NFT_CONTRACT_ADDRESS env var.',
+            },
+            factory_address: {
+                type: 'string',
+                description: 'Factory contract address. Defaults to FACTORY_ADDRESS env var.',
+            },
+        },
+        required: ['token_id'],
+    },
+};
+// ─── Handler ───────────────────────────────────────────────────────────────
+async function handleDeployWallet(input) {
+    try {
+        const config = (0, client_js_1.getConfig)();
+        const factoryAddress = (input.factory_address ?? config.factoryAddress);
+        if (!factoryAddress) {
+            throw new Error('Factory address required. Pass factory_address argument or set FACTORY_ADDRESS env var.');
+        }
+        const nftContractAddress = (input.nft_contract_address ?? config.nftContractAddress);
+        if (!nftContractAddress) {
+            throw new Error('NFT contract address required. Pass nft_contract_address argument or set NFT_CONTRACT_ADDRESS env var.');
+        }
+        const tokenId = BigInt(input.token_id);
+        const chainMap = {
+            8453: chains_1.base,
+            84532: chains_1.baseSepolia,
+        };
+        const chainNameMap = {
+            8453: 'base',
+            84532: 'base-sepolia',
+        };
+        const chain = chainMap[config.chainId];
+        if (!chain) {
+            throw new Error(`Unsupported chain for deployment: ${config.chainId}`);
+        }
+        const account = (0, accounts_1.privateKeyToAccount)(config.agentPrivateKey);
+        const walletClient = (0, viem_1.createWalletClient)({
+            account,
+            chain,
+            transport: (0, viem_1.http)(config.rpcUrl, { timeout: 30_000 }),
+        });
+        const result = await (0, agentwallet_sdk_1.deployWallet)({
+            factoryAddress,
+            tokenContract: nftContractAddress,
+            tokenId,
+            chain: chainNameMap[config.chainId] ?? 'base',
+            rpcUrl: config.rpcUrl,
+            walletClient,
+        });
+        const explorerAddr = (0, format_js_1.explorerAddressUrl)(result.walletAddress, config.chainId);
+        const explorerTx = (0, format_js_1.explorerTxUrl)(result.txHash, config.chainId);
+        const cname = (0, format_js_1.chainName)(config.chainId);
+        return {
+            content: [
+                (0, format_js_1.textContent)(`✅ Agent Wallet deployed successfully!\n\n` +
+                    `📍 Wallet Address: ${result.walletAddress}\n` +
+                    `🔗 Explorer: ${explorerAddr}\n\n` +
+                    `📋 Transaction: ${result.txHash}\n` +
+                    `🔗 Explorer: ${explorerTx}\n\n` +
+                    `🔑 Owner NFT: ${nftContractAddress} #${input.token_id}\n` +
+                    `🌐 Chain: ${cname}\n\n` +
+                    `ℹ️  Next steps:\n` +
+                    `  1. Set AGENT_WALLET_ADDRESS=${result.walletAddress} in your .env\n` +
+                    `  2. Use set_spend_policy (via SDK) to configure autonomous spending limits\n` +
+                    `  3. Fund the wallet with ETH or USDC for agent payments`),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'deploy_wallet'))],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=deploy.js.map

package/dist/tools/deploy.js.map

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

package/dist/tools/history.d.ts

@@ -0,0 +1,59 @@
+/**
+ * history.ts — get_transaction_history tool.
+ * Queries on-chain event logs for the wallet's transaction history.
+ */
+import { z } from 'zod';
+export declare const GetTransactionHistorySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    from_block: z.ZodOptional<z.ZodString>;
+    to_block: z.ZodOptional<z.ZodString>;
+    event_type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["all", "execution", "queued", "approved", "cancelled", "policy_update", "operator_update"]>>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    event_type: "all" | "execution" | "queued" | "approved" | "cancelled" | "policy_update" | "operator_update";
+    from_block?: string | undefined;
+    to_block?: string | undefined;
+}, {
+    limit?: number | undefined;
+    from_block?: string | undefined;
+    to_block?: string | undefined;
+    event_type?: "all" | "execution" | "queued" | "approved" | "cancelled" | "policy_update" | "operator_update" | undefined;
+}>;
+export type GetTransactionHistoryInput = z.infer<typeof GetTransactionHistorySchema>;
+export declare const getTransactionHistoryTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            from_block: {
+                type: string;
+                description: string;
+            };
+            to_block: {
+                type: string;
+                description: string;
+            };
+            event_type: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleGetTransactionHistory(input: GetTransactionHistoryInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/tools/history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAsBtC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAIrF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCrC,CAAC;AAIF,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,0BAA0B,GAChC,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,CAmEhF"}

package/dist/tools/history.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTransactionHistoryTool = exports.GetTransactionHistorySchema = void 0;
+exports.handleGetTransactionHistory = handleGetTransactionHistory;
+/**
+ * history.ts — get_transaction_history tool.
+ * Queries on-chain event logs for the wallet's transaction history.
+ */
+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");
+// ─── Schema ────────────────────────────────────────────────────────────────
+exports.GetTransactionHistorySchema = zod_1.z.object({
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(20)
+        .describe('Maximum number of entries to return (default: 20, max: 100)'),
+    from_block: zod_1.z
+        .string()
+        .optional()
+        .describe('Start block number (hex or decimal string). Defaults to recent history.'),
+    to_block: zod_1.z
+        .string()
+        .optional()
+        .describe('End block number. Defaults to latest.'),
+    event_type: zod_1.z
+        .enum(['all', 'execution', 'queued', 'approved', 'cancelled', 'policy_update', 'operator_update'])
+        .optional()
+        .default('all')
+        .describe('Filter by event type (default: all)'),
+});
+// ─── Tool definition ───────────────────────────────────────────────────────
+exports.getTransactionHistoryTool = {
+    name: 'get_transaction_history',
+    description: 'Retrieve the wallet\'s recent on-chain transaction history from event logs. ' +
+        'Shows executions, queued transactions, approvals, cancellations, ' +
+        'spend policy updates, and operator changes. ' +
+        'Filter by event type or block range for targeted queries.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            limit: {
+                type: 'number',
+                description: 'Max entries to return (default: 20, max: 100)',
+                default: 20,
+            },
+            from_block: {
+                type: 'string',
+                description: 'Start block (decimal string). Defaults to 1000 blocks ago.',
+            },
+            to_block: {
+                type: 'string',
+                description: 'End block (decimal string). Defaults to latest.',
+            },
+            event_type: {
+                type: 'string',
+                enum: ['all', 'execution', 'queued', 'approved', 'cancelled', 'policy_update', 'operator_update'],
+                description: 'Filter by event type (default: all)',
+                default: 'all',
+            },
+        },
+        required: [],
+    },
+};
+// ─── Handler ───────────────────────────────────────────────────────────────
+async function handleGetTransactionHistory(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const config = (0, client_js_1.getConfig)();
+        // Default: look back ~1000 blocks if no range specified
+        let fromBlock;
+        let toBlock;
+        if (input.from_block) {
+            fromBlock = BigInt(input.from_block);
+        }
+        else {
+            // Get current block and look back ~1000 blocks
+            const latest = await wallet.publicClient.getBlockNumber();
+            fromBlock = latest > 1000n ? latest - 1000n : 0n;
+        }
+        if (input.to_block) {
+            toBlock = BigInt(input.to_block);
+        }
+        const allEntries = await (0, agentwallet_sdk_1.getActivityHistory)(wallet, {
+            fromBlock,
+            toBlock,
+        });
+        // Filter by event type
+        const eventType = input.event_type ?? 'all';
+        const filtered = eventType === 'all'
+            ? allEntries
+            : allEntries.filter((e) => e.type === eventType);
+        // Apply limit (most recent first after sort)
+        const limit = input.limit ?? 20;
+        const recent = filtered.slice(-limit).reverse();
+        if (recent.length === 0) {
+            return {
+                content: [
+                    (0, format_js_1.textContent)(`📜 **Transaction History**\n\n` +
+                        `No transactions found in the queried range.\n\n` +
+                        `  Block range: ${fromBlock?.toString() ?? '0'} → ${toBlock?.toString() ?? 'latest'}\n` +
+                        `  Event type:  ${eventType}\n\n` +
+                        `Try expanding the from_block range for older history.`),
+                ],
+            };
+        }
+        let out = `📜 **Transaction History** (${recent.length} entries)\n`;
+        out += `  Chain:       ${(0, format_js_1.chainName)(config.chainId)}\n`;
+        out += `  Block range: ${fromBlock?.toString() ?? '0'} → ${toBlock?.toString() ?? 'latest'}\n`;
+        out += `  Filter:      ${eventType}\n\n`;
+        for (const entry of recent) {
+            out += formatActivityEntry(entry, config.chainId);
+            out += '\n';
+        }
+        return { content: [(0, format_js_1.textContent)(out)] };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'get_transaction_history'))],
+            isError: true,
+        };
+    }
+}
+// ─── Entry formatter ───────────────────────────────────────────────────────
+function formatActivityEntry(entry, chainId) {
+    const emoji = typeEmoji(entry.type);
+    const label = typeLabel(entry.type);
+    const txUrl = (0, format_js_1.explorerTxUrl)(entry.transactionHash, chainId);
+    let out = `${emoji} **${label}**\n`;
+    out += `   Block:  ${entry.blockNumber.toString()}\n`;
+    out += `   TX:     ${entry.transactionHash}\n`;
+    out += `   🔗 ${txUrl}\n`;
+    // Format args based on type
+    const args = entry.args;
+    if (entry.type === 'execution' && args) {
+        if (args['target'])
+            out += `   To:     ${args['target']}\n`;
+        if (args['value'] !== undefined)
+            out += `   Value:  ${(0, format_js_1.formatEth)(BigInt(String(args['value'])))}\n`;
+        if (args['executor'])
+            out += `   By:     ${args['executor']}\n`;
+    }
+    if (entry.type === 'queued' && args) {
+        if (args['txId'] !== undefined)
+            out += `   Queue ID: ${args['txId']}\n`;
+        if (args['to'])
+            out += `   To:       ${args['to']}\n`;
+        if (args['value'] !== undefined)
+            out += `   Value:    ${(0, format_js_1.formatEth)(BigInt(String(args['value'])))}\n`;
+    }
+    if (entry.type === 'approved' && args) {
+        if (args['txId'] !== undefined)
+            out += `   Queue ID: ${args['txId']}\n`;
+    }
+    if (entry.type === 'cancelled' && args) {
+        if (args['txId'] !== undefined)
+            out += `   Queue ID: ${args['txId']}\n`;
+    }
+    if (entry.type === 'policy_update' && args) {
+        if (args['token'])
+            out += `   Token:   ${args['token']}\n`;
+        if (args['perTxLimit'] !== undefined)
+            out += `   Per-tx:  ${(0, format_js_1.formatEth)(BigInt(String(args['perTxLimit'])))}\n`;
+        if (args['periodLimit'] !== undefined)
+            out += `   Period:  ${(0, format_js_1.formatEth)(BigInt(String(args['periodLimit'])))}\n`;
+    }
+    if (entry.type === 'operator_update' && args) {
+        if (args['operator'])
+            out += `   Operator:  ${args['operator']}\n`;
+        if (args['authorized'] !== undefined)
+            out += `   Status:    ${args['authorized'] ? '✅ Added' : '❌ Removed'}\n`;
+    }
+    return out;
+}
+function typeEmoji(type) {
+    const map = {
+        execution: '⚡',
+        queued: '⏳',
+        approved: '✅',
+        cancelled: '🚫',
+        policy_update: '📋',
+        operator_update: '🔑',
+    };
+    return map[type] ?? '📄';
+}
+function typeLabel(type) {
+    const map = {
+        execution: 'Transaction Executed',
+        queued: 'Transaction Queued',
+        approved: 'Transaction Approved',
+        cancelled: 'Transaction Cancelled',
+        policy_update: 'Spend Policy Updated',
+        operator_update: 'Operator Updated',
+    };
+    return map[type] ?? type;
+}
+//# sourceMappingURL=history.js.map

package/dist/tools/history.js.map

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

package/dist/tools/payments.d.ts

@@ -0,0 +1,71 @@
+/**
+ * payments.ts — send_payment tool.
+ * Executes ETH or ERC20 token transfers via the AgentAccountV2 contract.
+ */
+import { z } from 'zod';
+export declare const SendPaymentSchema: z.ZodObject<{
+    to: z.ZodString;
+    amount_eth: z.ZodString;
+    token: z.ZodOptional<z.ZodString>;
+    token_decimals: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    memo: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    to: string;
+    amount_eth: string;
+    token_decimals: number;
+    token?: string | undefined;
+    memo?: string | undefined;
+}, {
+    to: string;
+    amount_eth: string;
+    token?: string | undefined;
+    token_decimals?: number | undefined;
+    memo?: string | undefined;
+}>;
+export type SendPaymentInput = z.infer<typeof SendPaymentSchema>;
+export declare const sendPaymentTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            to: {
+                type: string;
+                description: string;
+            };
+            amount_eth: {
+                type: string;
+                description: string;
+            };
+            token: {
+                type: string;
+                description: string;
+            };
+            token_decimals: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            memo: {
+                type: string;
+                description: string;
+                maxLength: number;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleSendPayment(input: SendPaymentInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+/**
+ * Parse a human-readable token amount string into base units (bigint).
+ * Handles floating-point precision correctly without using JavaScript floats.
+ * e.g., "1.5" with decimals=6 → 1500000n
+ */
+export declare function parseTokenAmount(amount: string, decimals: number): bigint;
+//# sourceMappingURL=payments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../src/tools/payments.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EA+B5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAIjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmC3B,CAAC;AAIF,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,CAqEhF;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWzE"}