agentpay-mcp 1.2.0 → 4.0.0

package/dist/tools/identity.d.ts

@@ -0,0 +1,65 @@
+/**
+ * identity.ts — verify_agent_identity, get_reputation tools.
+ *
+ * Wraps agentwallet-sdk v6 ERC8004Client + ReputationClient.
+ */
+import { z } from 'zod';
+export declare const VerifyAgentIdentitySchema: z.ZodObject<{
+    agentAddress: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentAddress: string;
+}, {
+    agentAddress: string;
+}>;
+export type VerifyAgentIdentityInput = z.infer<typeof VerifyAgentIdentitySchema>;
+export declare const verifyAgentIdentityTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            agentAddress: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleVerifyAgentIdentity(input: VerifyAgentIdentityInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const GetReputationSchema: z.ZodObject<{
+    agentAddress: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentAddress: string;
+}, {
+    agentAddress: string;
+}>;
+export type GetReputationInput = z.infer<typeof GetReputationSchema>;
+export declare const getReputationTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            agentAddress: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetReputation(input: GetReputationInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/tools/identity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiCvB,eAAO,MAAM,yBAAyB;;;;;;EAIpC,CAAA;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEhF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;CAgBnC,CAAA;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,wBAAwB,GAC9B,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,CA6ChF;AAID,eAAO,MAAM,mBAAmB;;;;;;EAI9B,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAEpE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAgB7B,CAAA;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,GACxB,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,CAoDhF"}

package/dist/tools/identity.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getReputationTool = exports.GetReputationSchema = exports.verifyAgentIdentityTool = exports.VerifyAgentIdentitySchema = void 0;
+exports.handleVerifyAgentIdentity = handleVerifyAgentIdentity;
+exports.handleGetReputation = handleGetReputation;
+/**
+ * identity.ts — verify_agent_identity, get_reputation tools.
+ *
+ * Wraps agentwallet-sdk v6 ERC8004Client + ReputationClient.
+ */
+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");
+const CHAIN_ID_TO_NAME = {
+    1: 'ethereum',
+    8453: 'base',
+    84532: 'base-sepolia',
+    42161: 'arbitrum',
+    421614: 'arbitrum-sepolia',
+    137: 'polygon',
+};
+function getChainName(chainId) {
+    const name = CHAIN_ID_TO_NAME[chainId];
+    if (!name)
+        throw new Error(`Unsupported chain ID for identity: ${chainId}`);
+    return name;
+}
+// ─── verify_agent_identity ─────────────────────────────────────────────────
+exports.VerifyAgentIdentitySchema = zod_1.z.object({
+    agentAddress: zod_1.z
+        .string()
+        .describe('Agent owner address to verify identity for (0x-prefixed)'),
+});
+exports.verifyAgentIdentityTool = {
+    name: 'verify_agent_identity',
+    description: 'Verify an agent\'s on-chain identity using ERC-8004. ' +
+        'Looks up the agent by owner address and returns identity details ' +
+        'including agent ID, URI, and registration file.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentAddress: {
+                type: 'string',
+                description: 'Agent owner address (0x-prefixed)',
+            },
+        },
+        required: ['agentAddress'],
+    },
+};
+async function handleVerifyAgentIdentity(input) {
+    try {
+        const config = (0, client_js_1.getConfig)();
+        const chainName = getChainName(config.chainId);
+        const client = new agentwallet_sdk_1.ERC8004Client({ chain: chainName });
+        const identity = await client.lookupAgentByOwner(input.agentAddress);
+        if (!identity) {
+            return {
+                content: [
+                    (0, format_js_1.textContent)(JSON.stringify({
+                        found: false,
+                        agentAddress: input.agentAddress,
+                        chain: chainName,
+                    })),
+                ],
+            };
+        }
+        return {
+            content: [
+                (0, format_js_1.textContent)(JSON.stringify({
+                    found: true,
+                    agentId: identity.agentId.toString(),
+                    owner: identity.owner,
+                    agentWallet: identity.agentWallet,
+                    agentURI: identity.agentURI,
+                    registrationFile: identity.registrationFile,
+                    modelMetadata: identity.modelMetadata ?? null,
+                    chain: chainName,
+                })),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'verify_agent_identity'))],
+            isError: true,
+        };
+    }
+}
+// ─── get_reputation ────────────────────────────────────────────────────────
+exports.GetReputationSchema = zod_1.z.object({
+    agentAddress: zod_1.z
+        .string()
+        .describe('Agent owner address to look up reputation for (0x-prefixed)'),
+});
+exports.getReputationTool = {
+    name: 'get_reputation',
+    description: 'Get the on-chain reputation score for an agent. ' +
+        'Resolves agent ID from owner address via ERC-8004, ' +
+        'then queries the Reputation Registry for score and feedback.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentAddress: {
+                type: 'string',
+                description: 'Agent owner address (0x-prefixed)',
+            },
+        },
+        required: ['agentAddress'],
+    },
+};
+async function handleGetReputation(input) {
+    try {
+        const config = (0, client_js_1.getConfig)();
+        const chainName = getChainName(config.chainId);
+        // Step 1: resolve agentId from owner address
+        const identityClient = new agentwallet_sdk_1.ERC8004Client({ chain: chainName });
+        const identity = await identityClient.lookupAgentByOwner(input.agentAddress);
+        if (!identity) {
+            return {
+                content: [
+                    (0, format_js_1.textContent)(JSON.stringify({
+                        found: false,
+                        agentAddress: input.agentAddress,
+                        chain: chainName,
+                        message: 'No registered agent identity found for this address.',
+                    })),
+                ],
+            };
+        }
+        // Step 2: query reputation
+        const reputationClient = new agentwallet_sdk_1.ReputationClient({ chain: chainName });
+        const reputation = await reputationClient.getAgentReputation(identity.agentId);
+        return {
+            content: [
+                (0, format_js_1.textContent)(JSON.stringify({
+                    found: true,
+                    agentAddress: input.agentAddress,
+                    agentId: identity.agentId.toString(),
+                    chain: chainName,
+                    reputation: {
+                        count: reputation.count.toString(),
+                        totalScore: reputation.totalScore.toString(),
+                        avgCategory: reputation.avgCategory,
+                        clients: reputation.clients,
+                    },
+                })),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'get_reputation'))],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/tools/identity.js.map

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

package/dist/tools/payments.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendPaymentTool = exports.SendPaymentSchema = void 0;
+exports.handleSendPayment = handleSendPayment;
+exports.parseTokenAmount = parseTokenAmount;
+/**
+ * payments.ts — send_payment tool.
+ * Executes ETH or ERC20 token transfers via the AgentAccountV2 contract.
+ */
+const zod_1 = require("zod");
+const viem_1 = require("viem");
+const agentwallet_sdk_1 = require("agentwallet-sdk");
+const client_js_1 = require("../utils/client.js");
+const format_js_1 = require("../utils/format.js");
+const NATIVE_TOKEN = viem_1.zeroAddress;
+// ─── Schema ────────────────────────────────────────────────────────────────
+exports.SendPaymentSchema = zod_1.z.object({
+    to: zod_1.z
+        .string()
+        .describe('Recipient address (0x-prefixed, checksummed or lowercase)'),
+    amount_eth: zod_1.z
+        .string()
+        .describe('Amount to send, expressed in ETH (e.g. "0.001"). ' +
+        'For ERC20 tokens, this is the human-readable amount (e.g. "1.5" for 1.5 USDC). ' +
+        'Use the token_decimals parameter to control precision.'),
+    token: zod_1.z
+        .string()
+        .optional()
+        .describe('ERC20 token contract address. ' +
+        'Omit or use "0x0000000000000000000000000000000000000000" for native ETH.'),
+    token_decimals: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .max(18)
+        .optional()
+        .default(18)
+        .describe('Token decimal places (default: 18 for ETH; use 6 for USDC).'),
+    memo: zod_1.z
+        .string()
+        .max(200)
+        .optional()
+        .describe('Optional memo/note for this payment (logged locally, not on-chain).'),
+});
+// ─── Tool definition ───────────────────────────────────────────────────────
+exports.sendPaymentTool = {
+    name: 'send_payment',
+    description: 'Send ETH or ERC20 tokens from the Agent Wallet. ' +
+        'If the amount is within the configured spend limits, it executes immediately and returns the tx hash. ' +
+        'If it exceeds limits, the transaction is queued for owner approval (use queue_approval to manage). ' +
+        'Always check spend limits first with check_spend_limit to avoid surprises.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            to: {
+                type: 'string',
+                description: 'Recipient wallet address (0x-prefixed)',
+            },
+            amount_eth: {
+                type: 'string',
+                description: 'Amount in ETH (or token units). E.g. "0.001" for 0.001 ETH, "1.5" for 1.5 USDC',
+            },
+            token: {
+                type: 'string',
+                description: 'ERC20 token address. Omit for native ETH.',
+            },
+            token_decimals: {
+                type: 'number',
+                description: 'Token decimals (default 18 for ETH, 6 for USDC)',
+                default: 18,
+            },
+            memo: {
+                type: 'string',
+                description: 'Optional memo for this payment (not stored on-chain)',
+                maxLength: 200,
+            },
+        },
+        required: ['to', 'amount_eth'],
+    },
+};
+// ─── Handler ───────────────────────────────────────────────────────────────
+async function handleSendPayment(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const config = (0, client_js_1.getConfig)();
+        // Validate recipient address
+        if (!input.to.startsWith('0x') || input.to.length !== 42) {
+            throw new Error(`Invalid recipient address: "${input.to}". Must be a 0x-prefixed 42-character hex string.`);
+        }
+        const toAddress = input.to;
+        // Parse amount
+        const amountCheck = parseFloat(input.amount_eth);
+        if (isNaN(amountCheck) || amountCheck <= 0) {
+            throw new Error(`Invalid amount: "${input.amount_eth}". Must be a positive number.`);
+        }
+        const decimals = input.token_decimals ?? 18;
+        const amountWei = parseTokenAmount(input.amount_eth, decimals);
+        const isNativeEth = !input.token || input.token === NATIVE_TOKEN || input.token === '0x0000000000000000000000000000000000000000';
+        const tokenAddress = isNativeEth ? NATIVE_TOKEN : input.token;
+        const tokenLabel = isNativeEth ? 'ETH' : input.token ?? 'ETH';
+        let txHash;
+        if (isNativeEth) {
+            // Native ETH transfer via agentExecute
+            const result = await (0, agentwallet_sdk_1.agentExecute)(wallet, {
+                to: toAddress,
+                value: amountWei,
+            });
+            txHash = result.txHash;
+        }
+        else {
+            // ERC20 transfer via agentTransferToken
+            txHash = await (0, agentwallet_sdk_1.agentTransferToken)(wallet, {
+                token: tokenAddress,
+                to: toAddress,
+                amount: amountWei,
+            });
+        }
+        const explorerUrl = (0, format_js_1.explorerTxUrl)(txHash, config.chainId);
+        const memoLine = input.memo ? `\n📝 Memo: ${input.memo}` : '';
+        return {
+            content: [
+                (0, format_js_1.textContent)(`✅ **Payment Sent**\n\n` +
+                    `  To:      ${toAddress}\n` +
+                    `  Amount:  ${input.amount_eth} ${tokenLabel}\n` +
+                    `  Token:   ${tokenLabel}\n` +
+                    `  Network: ${(0, format_js_1.chainName)(config.chainId)}\n` +
+                    `  TX Hash: ${txHash}\n` +
+                    `  🔗 ${explorerUrl}` +
+                    memoLine + '\n\n' +
+                    `ℹ️  If the transaction was over-limit, it was queued for owner approval.\n` +
+                    `   Use queue_approval (action="list") to check pending transactions.`),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'send_payment'))],
+            isError: true,
+        };
+    }
+}
+// ─── Token amount parser ───────────────────────────────────────────────────
+/**
+ * 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
+ */
+function parseTokenAmount(amount, decimals) {
+    const trimmed = amount.trim();
+    if (!trimmed || isNaN(Number(trimmed))) {
+        throw new Error(`Invalid amount: "${amount}"`);
+    }
+    const [intPart, fracPart = ''] = trimmed.split('.');
+    const fracTrimmed = fracPart.slice(0, decimals).padEnd(decimals, '0');
+    const intStr = (intPart ?? '0') + fracTrimmed;
+    return BigInt(intStr);
+}
+//# sourceMappingURL=payments.js.map

package/dist/tools/payments.js.map

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