agentpay-mcp 3.1.0 → 4.0.1

package/dist/tools/escrow.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEscrowTool = exports.CreateEscrowSchema = void 0;
+exports.handleCreateEscrow = handleCreateEscrow;
+/**
+ * escrow.ts — create_escrow tool.
+ *
+ * Wraps agentwallet-sdk v6 MutualStakeEscrow for on-chain mutual-stake escrow creation.
+ */
+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.CreateEscrowSchema = zod_1.z.object({
+    counterpartyAddress: zod_1.z
+        .string()
+        .describe('Seller / counterparty address (0x-prefixed)'),
+    stakeAmount: zod_1.z
+        .string()
+        .describe('Payment amount in human-readable USDC units, e.g. "100" for 100 USDC'),
+    terms: zod_1.z
+        .string()
+        .describe('Human-readable description of the escrow terms'),
+    factoryAddress: zod_1.z
+        .string()
+        .optional()
+        .describe('StakeVaultFactory contract address. ' +
+        'Defaults to FACTORY_ADDRESS env var.'),
+    deadlineDays: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .default(7)
+        .describe('Deadline in days from now (default: 7)'),
+    challengeWindowHours: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .default(24)
+        .describe('Challenge window in hours after fulfillment (default: 24)'),
+});
+// ─── Tool definition ───────────────────────────────────────────────────────
+exports.createEscrowTool = {
+    name: 'create_escrow',
+    description: 'Create a mutual-stake escrow vault between the Agent Wallet (buyer) and a counterparty (seller). ' +
+        'Both parties lock collateral (equal to payment amount) ensuring aligned incentives. ' +
+        'Uses USDC as the payment token. Requires FACTORY_ADDRESS env var or factoryAddress param.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            counterpartyAddress: {
+                type: 'string',
+                description: 'Seller / counterparty address (0x-prefixed)',
+            },
+            stakeAmount: {
+                type: 'string',
+                description: 'Payment amount in human-readable USDC units (e.g. "100")',
+            },
+            terms: {
+                type: 'string',
+                description: 'Human-readable description of the escrow terms',
+            },
+            factoryAddress: {
+                type: 'string',
+                description: 'StakeVaultFactory address (optional if FACTORY_ADDRESS env var set)',
+            },
+            deadlineDays: {
+                type: 'number',
+                description: 'Deadline in days from now (default: 7)',
+                default: 7,
+            },
+            challengeWindowHours: {
+                type: 'number',
+                description: 'Challenge window in hours (default: 24)',
+                default: 24,
+            },
+        },
+        required: ['counterpartyAddress', 'stakeAmount', 'terms'],
+    },
+};
+// ─── Handler ───────────────────────────────────────────────────────────────
+async function handleCreateEscrow(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const config = (0, client_js_1.getConfig)();
+        const factoryAddress = input.factoryAddress ??
+            config.factoryAddress;
+        if (!factoryAddress) {
+            throw new Error('factoryAddress is required. Pass it as a parameter or set FACTORY_ADDRESS env var.');
+        }
+        // Parse USDC amount (6 decimals)
+        const USDC_DECIMALS = 6;
+        const amountFloat = parseFloat(input.stakeAmount);
+        if (isNaN(amountFloat) || amountFloat <= 0) {
+            throw new Error(`Invalid stakeAmount: "${input.stakeAmount}". Must be a positive number.`);
+        }
+        const paymentAmount = BigInt(Math.round(amountFloat * 10 ** USDC_DECIMALS));
+        // Deadline: N days from now
+        const deadlineSecs = input.deadlineDays ?? 7;
+        const deadline = Math.floor(Date.now() / 1000) + deadlineSecs * 86400;
+        // Challenge window in seconds
+        const challengeWindowHours = input.challengeWindowHours ?? 24;
+        const challengeWindow = challengeWindowHours * 3600;
+        const escrow = new agentwallet_sdk_1.MutualStakeEscrow({
+            publicClient: wallet.publicClient,
+            walletClient: wallet.walletClient,
+            factoryAddress,
+            chainId: config.chainId,
+        });
+        const result = await escrow.create({
+            seller: input.counterpartyAddress,
+            paymentAmount,
+            buyerStake: paymentAmount,
+            sellerStake: paymentAmount,
+            verifier: 'optimistic',
+            deadline,
+            challengeWindow,
+        });
+        return {
+            content: [
+                (0, format_js_1.textContent)(JSON.stringify({
+                    success: true,
+                    vaultAddress: result.address,
+                    txHash: result.txHash,
+                    buyer: wallet.walletClient.account.address,
+                    seller: input.counterpartyAddress,
+                    paymentAmount: input.stakeAmount,
+                    rawPaymentAmount: paymentAmount.toString(),
+                    terms: input.terms,
+                    deadline: new Date(deadline * 1000).toISOString(),
+                    challengeWindowHours,
+                })),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'create_escrow'))],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=escrow.js.map

package/dist/tools/escrow.js.map

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

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/swap.d.ts

@@ -0,0 +1,65 @@
+/**
+ * swap.ts — swap_tokens tool.
+ *
+ * Wraps agentwallet-sdk v6 attachSwap / SwapModule (Uniswap V3).
+ * Supported chains: base, arbitrum, optimism, polygon.
+ */
+import { z } from 'zod';
+export declare const SwapTokensSchema: z.ZodObject<{
+    fromSymbol: z.ZodString;
+    toSymbol: z.ZodString;
+    amount: z.ZodString;
+    chainId: z.ZodNumber;
+    slippageBps: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    chainId: number;
+    amount: string;
+    fromSymbol: string;
+    toSymbol: string;
+    slippageBps?: number | undefined;
+}, {
+    chainId: number;
+    amount: string;
+    fromSymbol: string;
+    toSymbol: string;
+    slippageBps?: number | undefined;
+}>;
+export type SwapTokensInput = z.infer<typeof SwapTokensSchema>;
+export declare const swapTokensTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            fromSymbol: {
+                type: string;
+                description: string;
+            };
+            toSymbol: {
+                type: string;
+                description: string;
+            };
+            amount: {
+                type: string;
+                description: string;
+            };
+            chainId: {
+                type: string;
+                description: string;
+            };
+            slippageBps: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleSwapTokens(input: SwapTokensInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=swap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../../src/tools/swap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAe3B,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAI9D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiB1B,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,CAiEhF"}

package/dist/tools/swap.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swapTokensTool = exports.SwapTokensSchema = void 0;
+exports.handleSwapTokens = handleSwapTokens;
+/**
+ * swap.ts — swap_tokens tool.
+ *
+ * Wraps agentwallet-sdk v6 attachSwap / SwapModule (Uniswap V3).
+ * Supported chains: base, arbitrum, optimism, polygon.
+ */
+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.SwapTokensSchema = zod_1.z.object({
+    fromSymbol: zod_1.z.string().describe('Symbol of the token to sell, e.g. "USDC"'),
+    toSymbol: zod_1.z.string().describe('Symbol of the token to buy, e.g. "WETH"'),
+    amount: zod_1.z.string().describe('Amount to sell in human-readable units, e.g. "100" for 100 USDC'),
+    chainId: zod_1.z
+        .number()
+        .int()
+        .describe('Chain ID where the swap will execute (e.g. 8453 for Base Mainnet)'),
+    slippageBps: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .max(10000)
+        .optional()
+        .describe('Slippage tolerance in basis points (default: 50 = 0.5%)'),
+});
+// ─── Tool definition ───────────────────────────────────────────────────────
+exports.swapTokensTool = {
+    name: 'swap_tokens',
+    description: 'Swap one ERC-20 token for another using Uniswap V3. ' +
+        'Resolves token addresses from the registry, executes the swap via SwapModule. ' +
+        'Supported chains: base (8453), arbitrum (42161), optimism (10), polygon (137).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            fromSymbol: { type: 'string', description: 'Symbol of token to sell (e.g. "USDC")' },
+            toSymbol: { type: 'string', description: 'Symbol of token to buy (e.g. "WETH")' },
+            amount: { type: 'string', description: 'Amount to sell in human-readable units' },
+            chainId: { type: 'number', description: 'Chain ID (8453=Base, 42161=Arbitrum, 10=Optimism, 137=Polygon)' },
+            slippageBps: { type: 'number', description: 'Slippage in basis points (default: 50)' },
+        },
+        required: ['fromSymbol', 'toSymbol', 'amount', 'chainId'],
+    },
+};
+// ─── Handler ───────────────────────────────────────────────────────────────
+async function handleSwapTokens(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const registry = (0, agentwallet_sdk_1.getGlobalRegistry)();
+        const fromToken = registry.getToken(input.fromSymbol.toUpperCase(), input.chainId);
+        if (!fromToken) {
+            throw new Error(`Token "${input.fromSymbol}" not found for chain ${input.chainId}. ` +
+                'Use add_custom_token to register it first.');
+        }
+        const toToken = registry.getToken(input.toSymbol.toUpperCase(), input.chainId);
+        if (!toToken) {
+            throw new Error(`Token "${input.toSymbol}" not found for chain ${input.chainId}. ` +
+                'Use add_custom_token to register it first.');
+        }
+        const rawAmountIn = (0, agentwallet_sdk_1.parseAmount)(input.amount, fromToken.decimals);
+        const swapWallet = (0, agentwallet_sdk_1.attachSwap)(wallet);
+        const result = await swapWallet.swap(fromToken.address, toToken.address, rawAmountIn, { slippageBps: input.slippageBps });
+        return {
+            content: [
+                (0, format_js_1.textContent)(JSON.stringify({
+                    success: true,
+                    txHash: result.txHash,
+                    feeTxHash: result.feeTxHash ?? null,
+                    approvalRequired: result.approvalRequired,
+                    approvalTxHash: result.approvalTxHash ?? null,
+                    fromToken: fromToken.symbol,
+                    toToken: toToken.symbol,
+                    amountIn: input.amount,
+                    rawAmountIn: rawAmountIn.toString(),
+                    quote: result.quote
+                        ? {
+                            amountInNet: result.quote.amountInNet?.toString(),
+                            amountOutMinimum: result.quote.amountOutMinimum?.toString(),
+                            poolFeeTier: result.quote.poolFeeTier,
+                            feeAmount: result.quote.feeAmount?.toString(),
+                            gasEstimate: result.quote.gasEstimate?.toString(),
+                        }
+                        : null,
+                    chainId: input.chainId,
+                })),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'swap_tokens'))],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=swap.js.map

package/dist/tools/swap.js.map

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