@coinbase/agentkit 0.10.0 → 0.10.2

package/dist/action-providers/x402/x402ActionProvider.js

@@ -20,7 +20,10 @@ const schemas_1 = require("./schemas");
 const wallet_providers_1 = require("../../wallet-providers");
 const axios_1 = __importDefault(require("axios"));
 const x402_axios_1 = require("x402-axios");
-const SUPPORTED_NETWORKS = ["base-mainnet", "base-sepolia"];
+const verify_1 = require("x402/verify");
+const x402_1 = require("@coinbase/x402");
+const utils_1 = require("./utils");
+const SUPPORTED_NETWORKS = ["base-mainnet", "base-sepolia", "solana-mainnet", "solana-devnet"];
 /**
  * X402ActionProvider provides actions for making HTTP requests, with optional x402 payment handling.
  */
@@ -39,6 +42,116 @@ class X402ActionProvider extends actionProvider_1.ActionProvider {
          */
         this.supportsNetwork = (network) => network.protocolFamily === "evm" && SUPPORTED_NETWORKS.includes(network.networkId);
     }
+    /**
+     * Discovers available x402 services with optional filtering.
+     *
+     * @param walletProvider - The wallet provider to use for network filtering
+     * @param args - Optional filters: maxUsdcPrice
+     * @returns JSON string with the list of services (filtered by network and description)
+     */
+    async discoverX402Services(walletProvider, args) {
+        try {
+            const { list } = (0, verify_1.useFacilitator)(x402_1.facilitator);
+            const services = await list();
+            if (!services || !services.items) {
+                return JSON.stringify({
+                    error: true,
+                    message: "No services found",
+                });
+            }
+            // Get the current wallet network
+            const walletNetwork = (0, utils_1.getX402Network)(walletProvider.getNetwork());
+            // Filter services by network, description, and optional USDC price
+            const hasValidMaxUsdcPrice = typeof args.maxUsdcPrice === "number" &&
+                Number.isFinite(args.maxUsdcPrice) &&
+                args.maxUsdcPrice > 0;
+            const filteredServices = services.items.filter(item => {
+                // Filter by network - only include services that accept the current wallet network
+                const accepts = Array.isArray(item.accepts) ? item.accepts : [];
+                const hasMatchingNetwork = accepts.some(req => req.network === walletNetwork);
+                // Filter out services with empty or default descriptions
+                const hasDescription = accepts.some(req => req.description &&
+                    req.description.trim() !== "" &&
+                    req.description.trim() !== "Access to protected content");
+                return hasMatchingNetwork && hasDescription;
+            });
+            // Apply USDC price filtering if maxUsdcPrice is provided (only consider USDC assets)
+            let priceFilteredServices = filteredServices;
+            if (hasValidMaxUsdcPrice) {
+                priceFilteredServices = [];
+                for (const item of filteredServices) {
+                    const accepts = Array.isArray(item.accepts) ? item.accepts : [];
+                    let shouldInclude = false;
+                    for (const req of accepts) {
+                        if (req.network === walletNetwork && req.asset && req.maxAmountRequired) {
+                            // Only consider USDC assets when maxUsdcPrice filter is applied
+                            if ((0, utils_1.isUsdcAsset)(req.asset, walletProvider)) {
+                                try {
+                                    const maxUsdcPriceAtomic = await (0, utils_1.convertWholeUnitsToAtomic)(args.maxUsdcPrice, req.asset, walletProvider);
+                                    if (maxUsdcPriceAtomic) {
+                                        const requirement = BigInt(req.maxAmountRequired);
+                                        const maxUsdcPriceAtomicBigInt = BigInt(maxUsdcPriceAtomic);
+                                        if (requirement <= maxUsdcPriceAtomicBigInt) {
+                                            shouldInclude = true;
+                                            break;
+                                        }
+                                    }
+                                }
+                                catch {
+                                    // If conversion fails, skip this requirement
+                                    continue;
+                                }
+                            }
+                        }
+                    }
+                    if (shouldInclude) {
+                        priceFilteredServices.push(item);
+                    }
+                }
+            }
+            // Format the filtered services
+            const filtered = await Promise.all(priceFilteredServices.map(async (item) => {
+                const accepts = Array.isArray(item.accepts) ? item.accepts : [];
+                const matchingAccept = accepts.find(req => req.network === walletNetwork);
+                // Format amount if available
+                let formattedMaxAmount = matchingAccept?.maxAmountRequired;
+                if (matchingAccept?.maxAmountRequired && matchingAccept?.asset) {
+                    formattedMaxAmount = await (0, utils_1.formatPaymentOption)({
+                        asset: matchingAccept.asset,
+                        maxAmountRequired: matchingAccept.maxAmountRequired,
+                        network: matchingAccept.network,
+                    }, walletProvider);
+                }
+                return {
+                    resource: item.resource,
+                    description: matchingAccept?.description || "",
+                    cost: formattedMaxAmount,
+                    ...(matchingAccept?.outputSchema?.input && {
+                        input: matchingAccept.outputSchema.input,
+                    }),
+                    ...(matchingAccept?.outputSchema?.output && {
+                        output: matchingAccept.outputSchema.output,
+                    }),
+                    ...(item.metadata && item.metadata.length > 0 && { metadata: item.metadata }),
+                };
+            }));
+            return JSON.stringify({
+                success: true,
+                walletNetwork,
+                total: services.items.length,
+                returned: filtered.length,
+                items: filtered,
+            }, null, 2);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return JSON.stringify({
+                error: true,
+                message: "Failed to list x402 services",
+                details: message,
+            }, null, 2);
+        }
+    }
     /**
      * Makes a basic HTTP request to an API endpoint.
      *
@@ -64,19 +177,32 @@ class X402ActionProvider extends actionProvider_1.ActionProvider {
                     data: response.data,
                 }, null, 2);
             }
+            // Check if wallet network matches any available payment options
+            const walletNetwork = (0, utils_1.getX402Network)(walletProvider.getNetwork());
+            const availableNetworks = response.data.accepts.map(option => option.network);
+            const hasMatchingNetwork = availableNetworks.includes(walletNetwork);
+            let paymentOptionsText = `The wallet network ${walletNetwork} does not match any available payment options (${availableNetworks.join(", ")}).`;
+            // Format payment options for matching networks
+            if (hasMatchingNetwork) {
+                const matchingOptions = response.data.accepts.filter(option => option.network === walletNetwork);
+                const formattedOptions = await Promise.all(matchingOptions.map(option => (0, utils_1.formatPaymentOption)(option, walletProvider)));
+                paymentOptionsText = `The payment options are: ${formattedOptions.join(", ")}`;
+            }
             return JSON.stringify({
                 status: "error_402_payment_required",
                 acceptablePaymentOptions: response.data.accepts,
                 nextSteps: [
                     "Inform the user that the requested server replied with a 402 Payment Required response.",
-                    `The payment options are: ${response.data.accepts.map(option => `${option.asset} ${option.maxAmountRequired} ${option.network}`).join(", ")}`,
-                    "Ask the user if they want to retry the request with payment.",
-                    `Use retry_http_request_with_x402 to retry the request with payment.`,
+                    paymentOptionsText,
+                    hasMatchingNetwork ? "Ask the user if they want to retry the request with payment." : "",
+                    hasMatchingNetwork
+                        ? `Use retry_http_request_with_x402 to retry the request with payment.`
+                        : "",
                 ],
             });
         }
         catch (error) {
-            return this.handleHttpError(error, args.url);
+            return (0, utils_1.handleHttpError)(error, args.url);
         }
     }
     /**
@@ -88,6 +214,16 @@ class X402ActionProvider extends actionProvider_1.ActionProvider {
      */
     async retryWithX402(walletProvider, args) {
         try {
+            // Check network compatibility before attempting payment
+            const walletNetwork = (0, utils_1.getX402Network)(walletProvider.getNetwork());
+            const selectedNetwork = args.selectedPaymentOption.network;
+            if (walletNetwork !== selectedNetwork) {
+                return JSON.stringify({
+                    error: true,
+                    message: "Network mismatch",
+                    details: `Wallet is on ${walletNetwork} but payment requires ${selectedNetwork}`,
+                }, null, 2);
+            }
             // Make the request with payment handling
             const account = walletProvider.toSigner();
             const paymentSelector = (accepts) => {
@@ -108,7 +244,9 @@ class X402ActionProvider extends actionProvider_1.ActionProvider {
                 }
                 return accepts[0];
             };
-            const api = (0, x402_axios_1.withPaymentInterceptor)(axios_1.default.create({}), account, paymentSelector);
+            const api = (0, x402_axios_1.withPaymentInterceptor)(axios_1.default.create({}), 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            account, paymentSelector);
             const response = await api.request({
                 url: args.url,
                 method: args.method ?? "GET",
@@ -142,7 +280,7 @@ class X402ActionProvider extends actionProvider_1.ActionProvider {
             });
         }
         catch (error) {
-            return this.handleHttpError(error, args.url);
+            return (0, utils_1.handleHttpError)(error, args.url);
         }
     }
     /**
@@ -155,6 +293,7 @@ class X402ActionProvider extends actionProvider_1.ActionProvider {
     async makeHttpRequestWithX402(walletProvider, args) {
         try {
             const account = walletProvider.toSigner();
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const api = (0, x402_axios_1.withPaymentInterceptor)(axios_1.default.create({}), account);
             const response = await api.request({
                 url: args.url,
@@ -183,42 +322,21 @@ class X402ActionProvider extends actionProvider_1.ActionProvider {
             }, null, 2);
         }
         catch (error) {
-            return this.handleHttpError(error, args.url);
-        }
-    }
-    /**
-     * Helper method to handle HTTP errors consistently.
-     *
-     * @param error - The axios error to handle
-     * @param url - The URL that was being accessed when the error occurred
-     * @returns A JSON string containing formatted error details
-     */
-    handleHttpError(error, url) {
-        if (error.response) {
-            return JSON.stringify({
-                error: true,
-                message: `HTTP ${error.response.status} error when accessing ${url}`,
-                details: error.response.data?.error || error.response.statusText,
-                suggestion: "Check if the URL is correct and the API is available.",
-            }, null, 2);
-        }
-        if (error.request) {
-            return JSON.stringify({
-                error: true,
-                message: `Network error when accessing ${url}`,
-                details: error.message,
-                suggestion: "Check your internet connection and verify the API endpoint is accessible.",
-            }, null, 2);
+            return (0, utils_1.handleHttpError)(error, args.url);
         }
-        return JSON.stringify({
-            error: true,
-            message: `Error making request to ${url}`,
-            details: error.message,
-            suggestion: "Please check the request parameters and try again.",
-        }, null, 2);
     }
 }
 exports.X402ActionProvider = X402ActionProvider;
+__decorate([
+    (0, actionDecorator_1.CreateAction)({
+        name: "discover_x402_services",
+        description: "Discover available x402 services. Optionally filter by a maximum price in whole units of USDC (only USDC payment options will be considered when filter is applied).",
+        schema: schemas_1.ListX402ServicesSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [wallet_providers_1.EvmWalletProvider, void 0]),
+    __metadata("design:returntype", Promise)
+], X402ActionProvider.prototype, "discoverX402Services", null);
 __decorate([
     (0, actionDecorator_1.CreateAction)({
         name: "make_http_request",
@@ -272,6 +390,7 @@ This action combines both steps into one, which means:
 - No chance to review payment details before paying
 - No confirmation step
 - Automatic payment processing
+- Assumes payment option is compatible with wallet network
 
 EXAMPLES:
 - Production: make_http_request_with_x402("https://api.example.com/data")

package/dist/action-providers/x402/x402ActionProvider.test.js

@@ -39,9 +39,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const x402ActionProvider_1 = require("./x402ActionProvider");
 const axios_1 = __importDefault(require("axios"));
 const x402axios = __importStar(require("x402-axios"));
+const x402Verify = __importStar(require("x402/verify"));
+// Mock external facilitator dependency
+jest.mock("@coinbase/x402", () => ({
+    facilitator: {},
+}));
 // Mock modules
 jest.mock("axios");
 jest.mock("x402-axios");
+jest.mock("x402/verify");
 // Create mock functions
 const mockRequest = jest.fn();
 // Create a complete mock axios instance
@@ -83,6 +89,7 @@ const mockAxios = {
 };
 const mockWithPaymentInterceptor = jest.fn().mockReturnValue(mockAxiosInstance);
 const mockDecodeXPaymentResponse = jest.fn();
+const mockUseFacilitator = jest.fn();
 // Override the mocked modules
 axios_1.default.create = mockAxios.create;
 axios_1.default.request = mockRequest;
@@ -90,10 +97,12 @@ axios_1.default.isAxiosError = mockAxios.isAxiosError;
 // Mock x402-axios functions
 jest.mocked(x402axios.withPaymentInterceptor).mockImplementation(mockWithPaymentInterceptor);
 jest.mocked(x402axios.decodeXPaymentResponse).mockImplementation(mockDecodeXPaymentResponse);
+jest.mocked(x402Verify.useFacilitator).mockImplementation(mockUseFacilitator);
 // Mock wallet provider
-const mockWalletProvider = {
+const makeMockWalletProvider = (networkId) => ({
     toSigner: jest.fn().mockReturnValue("mock-signer"),
-};
+    getNetwork: jest.fn().mockReturnValue({ protocolFamily: "evm", networkId }),
+});
 // Sample responses based on real examples
 const MOCK_PAYMENT_INFO_RESPONSE = {
     paymentRequired: true,
@@ -171,7 +180,7 @@ describe("X402ActionProvider", () => {
                 headers: {},
                 config: {},
             });
-            const result = await provider.makeHttpRequest(mockWalletProvider, {
+            const result = await provider.makeHttpRequest(makeMockWalletProvider("base-sepolia"), {
                 url: "https://api.example.com/free",
                 method: "GET",
             });
@@ -187,7 +196,7 @@ describe("X402ActionProvider", () => {
                 headers: {},
                 config: {},
             });
-            const result = await provider.makeHttpRequest(mockWalletProvider, {
+            const result = await provider.makeHttpRequest(makeMockWalletProvider("base-sepolia"), {
                 url: "https://www.x402.org/protected",
                 method: "GET",
             });
@@ -201,7 +210,7 @@ describe("X402ActionProvider", () => {
             error.isAxiosError = true;
             error.request = {};
             mockRequest.mockRejectedValue(error);
-            const result = await provider.makeHttpRequest(mockWalletProvider, {
+            const result = await provider.makeHttpRequest(makeMockWalletProvider("base-sepolia"), {
                 url: "https://api.example.com/endpoint",
                 method: "GET",
             });
@@ -210,6 +219,103 @@ describe("X402ActionProvider", () => {
             expect(parsedResult.message).toContain("Network error");
         });
     });
+    describe("listX402Services", () => {
+        it("should list services without filters", async () => {
+            const mockList = jest.fn().mockResolvedValue({
+                items: [
+                    {
+                        resource: "https://example.com/service1",
+                        metadata: { category: "test" },
+                        accepts: [
+                            {
+                                asset: "0xUSDC",
+                                maxAmountRequired: "90000",
+                                network: "base-sepolia",
+                                scheme: "exact",
+                                description: "Test service 1",
+                                outputSchema: { type: "object" },
+                                extra: { name: "USDC" },
+                            },
+                        ],
+                    },
+                ],
+            });
+            mockUseFacilitator.mockReturnValue({ list: mockList });
+            const result = await provider.discoverX402Services(makeMockWalletProvider("base-sepolia"), {});
+            const parsed = JSON.parse(result);
+            expect(parsed.success).toBe(true);
+            expect(parsed.total).toBe(1);
+            expect(parsed.returned).toBe(1);
+            expect(parsed.items.length).toBe(1);
+        });
+        it("should filter services by asset and maxPrice", async () => {
+            const mockList = jest.fn().mockResolvedValue({
+                items: [
+                    {
+                        resource: "https://example.com/service1",
+                        metadata: { category: "test" },
+                        accepts: [
+                            {
+                                asset: "0x036CbD53842c5426634e7929541eC2318f3dCF7e", // Real USDC address for base-sepolia
+                                maxAmountRequired: "90000", // 0.09 USDC (should pass 0.1 filter)
+                                network: "base-sepolia",
+                                scheme: "exact",
+                                description: "Test service 1",
+                                outputSchema: { type: "object" },
+                                extra: { name: "USDC" },
+                            },
+                        ],
+                    },
+                    {
+                        resource: "https://example.com/service2",
+                        metadata: { category: "test" },
+                        accepts: [
+                            {
+                                asset: "0x036CbD53842c5426634e7929541eC2318f3dCF7e", // Real USDC address for base-sepolia
+                                maxAmountRequired: "150000", // 0.15 USDC (should fail 0.1 filter)
+                                network: "base-sepolia",
+                                scheme: "exact",
+                                description: "Test service 2",
+                                outputSchema: { type: "object" },
+                                extra: { name: "USDC" },
+                            },
+                        ],
+                    },
+                    {
+                        resource: "https://example.com/service3",
+                        metadata: { category: "test" },
+                        accepts: [
+                            {
+                                asset: "0x036CbD53842c5426634e7929541eC2318f3dCF7e", // Real USDC address for base-sepolia
+                                maxAmountRequired: "50000", // 0.05 USDC (should pass 0.1 filter)
+                                network: "base-sepolia",
+                                scheme: "exact",
+                                description: "Test service 3",
+                                outputSchema: { type: "object" },
+                                extra: { name: "USDC" },
+                            },
+                        ],
+                    },
+                ],
+            });
+            mockUseFacilitator.mockReturnValue({ list: mockList });
+            const result = await provider.discoverX402Services(makeMockWalletProvider("base-sepolia"), {
+                maxUsdcPrice: 0.1,
+            });
+            const parsed = JSON.parse(result);
+            expect(parsed.success).toBe(true);
+            expect(parsed.returned).toBe(2);
+            expect(parsed.items.map(item => item.resource)).toEqual(expect.arrayContaining(["https://example.com/service1", "https://example.com/service3"]));
+        });
+        it("should handle errors from facilitator", async () => {
+            const mockList = jest.fn().mockRejectedValue(new Error("boom"));
+            mockUseFacilitator.mockReturnValue({ list: mockList });
+            const result = await provider.discoverX402Services(makeMockWalletProvider("base-sepolia"), {});
+            const parsed = JSON.parse(result);
+            expect(parsed.error).toBe(true);
+            expect(parsed.message).toContain("Failed to list x402 services");
+        });
+    });
     describe("retryHttpRequestWithX402", () => {
         it("should successfully retry with payment", async () => {
             mockDecodeXPaymentResponse.mockReturnValue(MOCK_PAYMENT_RESPONSE);
@@ -222,7 +328,7 @@ describe("X402ActionProvider", () => {
                 },
                 config: {},
             });
-            const result = await provider.retryWithX402(mockWalletProvider, {
+            const result = await provider.retryWithX402(makeMockWalletProvider("base-sepolia"), {
                 url: "https://www.x402.org/protected",
                 method: "GET",
                 selectedPaymentOption: {
@@ -247,7 +353,7 @@ describe("X402ActionProvider", () => {
             error.isAxiosError = true;
             error.request = {};
             mockRequest.mockRejectedValue(error);
-            const result = await provider.retryWithX402(mockWalletProvider, {
+            const result = await provider.retryWithX402(makeMockWalletProvider("base-sepolia"), {
                 url: "https://www.x402.org/protected",
                 method: "GET",
                 selectedPaymentOption: {
@@ -274,7 +380,7 @@ describe("X402ActionProvider", () => {
                 },
                 config: {},
             });
-            const result = await provider.makeHttpRequestWithX402(mockWalletProvider, {
+            const result = await provider.makeHttpRequestWithX402(makeMockWalletProvider("base-sepolia"), {
                 url: "https://www.x402.org/protected",
                 method: "GET",
             });
@@ -296,7 +402,7 @@ describe("X402ActionProvider", () => {
                 headers: {},
                 config: {},
             });
-            const result = await provider.makeHttpRequestWithX402(mockWalletProvider, {
+            const result = await provider.makeHttpRequestWithX402(makeMockWalletProvider("base-sepolia"), {
                 url: "https://api.example.com/free",
                 method: "GET",
             });
@@ -310,7 +416,7 @@ describe("X402ActionProvider", () => {
             error.isAxiosError = true;
             error.request = {};
             mockRequest.mockRejectedValue(error);
-            const result = await provider.makeHttpRequestWithX402(mockWalletProvider, {
+            const result = await provider.makeHttpRequestWithX402(makeMockWalletProvider("base-sepolia"), {
                 url: "https://api.example.com/endpoint",
                 method: "GET",
             });

package/dist/action-providers/zeroX/index.d.ts

@@ -0,0 +1 @@
+export * from "./zeroXActionProvider";

package/dist/action-providers/zeroX/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./zeroXActionProvider"), exports);

package/dist/action-providers/zeroX/schemas.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+/**
+ * Input schema for getting a swap price.
+ */
+export declare const GetSwapPriceSchema: z.ZodObject<{
+    sellToken: z.ZodString;
+    buyToken: z.ZodString;
+    sellAmount: z.ZodString;
+    slippageBps: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    swapFeeRecipient: z.ZodOptional<z.ZodString>;
+    swapFeeBps: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    slippageBps: number;
+    buyToken: string;
+    sellToken: string;
+    sellAmount: string;
+    swapFeeBps: number;
+    swapFeeRecipient?: string | undefined;
+}, {
+    buyToken: string;
+    sellToken: string;
+    sellAmount: string;
+    slippageBps?: number | undefined;
+    swapFeeRecipient?: string | undefined;
+    swapFeeBps?: number | undefined;
+}>;
+/**
+ * Input schema for executing a swap.
+ */
+export declare const ExecuteSwapSchema: z.ZodObject<{
+    sellToken: z.ZodString;
+    buyToken: z.ZodString;
+    sellAmount: z.ZodString;
+    slippageBps: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    swapFeeRecipient: z.ZodOptional<z.ZodString>;
+    swapFeeBps: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    slippageBps: number;
+    buyToken: string;
+    sellToken: string;
+    sellAmount: string;
+    swapFeeBps: number;
+    swapFeeRecipient?: string | undefined;
+}, {
+    buyToken: string;
+    sellToken: string;
+    sellAmount: string;
+    slippageBps?: number | undefined;
+    swapFeeRecipient?: string | undefined;
+    swapFeeBps?: number | undefined;
+}>;

package/dist/action-providers/zeroX/schemas.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecuteSwapSchema = exports.GetSwapPriceSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Input schema for getting a swap price.
+ */
+exports.GetSwapPriceSchema = zod_1.z
+    .object({
+    sellToken: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .describe("The token contract address to sell"),
+    buyToken: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .describe("The token contract address to buy"),
+    sellAmount: zod_1.z
+        .string()
+        .describe("The amount of sellToken to sell in whole units (e.g., 1.5 WETH, 10 USDC)"),
+    slippageBps: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .max(10000)
+        .optional()
+        .default(100)
+        .describe("The maximum acceptable slippage in basis points (0-10000, default: 100)"),
+    swapFeeRecipient: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .optional()
+        .describe("The wallet address to receive an affiliate fee on the trade"),
+    swapFeeBps: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .max(1000)
+        .default(100)
+        .describe("The amount in basis points (0-1000) of the sellToken to charge as trading fee (defaults to 100 = 1%), only used if swapFeeRecipient is provided"),
+})
+    .strip()
+    .describe("Get a price quote for swapping one token for another");
+/**
+ * Input schema for executing a swap.
+ */
+exports.ExecuteSwapSchema = zod_1.z
+    .object({
+    sellToken: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .describe("The token contract address to sell"),
+    buyToken: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .describe("The token contract address to buy"),
+    sellAmount: zod_1.z
+        .string()
+        .describe("The amount of sellToken to sell in whole units (e.g., 1.5 WETH, 10 USDC)"),
+    slippageBps: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .max(10000)
+        .optional()
+        .default(100)
+        .describe("The maximum acceptable slippage in basis points (0-10000, default: 100)"),
+    swapFeeRecipient: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .optional()
+        .describe("The wallet address to receive an affiliate fee on the trade"),
+    swapFeeBps: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .max(1000)
+        .default(100)
+        .describe("The amount in basis points (0-1000) of the sellToken to charge as trading fee (defaults to 100 = 1%), only used if swapFeeRecipient is provided"),
+})
+    .strip()
+    .describe("Execute a swap between two tokens");

package/dist/action-providers/zeroX/utils.d.ts

@@ -0,0 +1,23 @@
+import { EvmWalletProvider } from "../../wallet-providers";
+export declare const PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+/**
+ * Checks if a token is native ETH.
+ *
+ * @param token - The token address to check.
+ * @returns True if the token is native ETH, false otherwise.
+ */
+export declare function isNativeEth(token: string): boolean;
+/**
+ * Gets the details (decimals and name) for both fromToken and toToken
+ *
+ * @param walletProvider - The EVM wallet provider to read contracts
+ * @param fromToken - The contract address of the from token
+ * @param toToken - The contract address of the to token
+ * @returns Promise<{fromTokenDecimals: number, toTokenDecimals: number, fromTokenName: string, toTokenName: string}>
+ */
+export declare function getTokenDetails(walletProvider: EvmWalletProvider, fromToken: string, toToken: string): Promise<{
+    fromTokenDecimals: number;
+    toTokenDecimals: number;
+    fromTokenName: string;
+    toTokenName: string;
+}>;