@coinbase/agentkit 0.10.0 → 0.10.1

package/dist/action-providers/truemarkets/truemarketsActionProvider.js

@@ -8,18 +8,6 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _TrueMarketsActionProvider_publicClient;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.truemarketsActionProvider = exports.TrueMarketsActionProvider = void 0;
 const zod_1 = require("zod");
@@ -27,22 +15,18 @@ const actionProvider_1 = require("../actionProvider");
 const actionDecorator_1 = require("../actionDecorator");
 const schemas_1 = require("./schemas");
 const constants_1 = require("./constants");
-const constants_2 = require("../erc20/constants");
-const wallet_providers_1 = require("../../wallet-providers");
 const viem_1 = require("viem");
-const chains_1 = require("viem/chains");
+const wallet_providers_1 = require("../../wallet-providers");
+const viem_2 = require("viem");
 /**
- * TrueMarketsActionProvider provides actions to interact with TrueMarkets contracts.
+ * Action provider for TrueMarkets interactions.
  */
 class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
     /**
-     * Constructor for the TrueMarketsActionProvider.
-     *
-     * @param config - The configuration options for the TrueMarketsActionProvider.
+     * Creates a new TrueMarkets action provider.
      */
-    constructor(config) {
+    constructor() {
         super("truemarkets", []);
-        _TrueMarketsActionProvider_publicClient.set(this, void 0);
         /**
          * Checks if the TrueMarkets action provider supports the given network.
          * Currently only supports Base mainnet.
@@ -51,10 +35,6 @@ class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
          * @returns True if the TrueMarkets action provider supports the network, false otherwise.
          */
         this.supportsNetwork = (network) => network.networkId === "base-mainnet";
-        __classPrivateFieldSet(this, _TrueMarketsActionProvider_publicClient, (0, viem_1.createPublicClient)({
-            chain: chains_1.base,
-            transport: config?.RPC_URL ? (0, viem_1.http)(config.RPC_URL) : (0, viem_1.http)(),
-        }), "f");
     }
     /**
      * Gets active markets from the TruthMarketManager contract.
@@ -105,7 +85,7 @@ class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
                 functionName: "getActiveMarketAddress",
                 args: [BigInt(index)],
             }));
-            const marketAddresses = await __classPrivateFieldGet(this, _TrueMarketsActionProvider_publicClient, "f").multicall({
+            const marketAddresses = await walletProvider.getPublicClient().multicall({
                 contracts: addressCalls,
             });
             // Filter out errors and extract results
@@ -124,7 +104,7 @@ class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
                 abi: constants_1.TruthMarketABI,
                 functionName: "marketQuestion",
             }));
-            const marketQuestionsResult = await __classPrivateFieldGet(this, _TrueMarketsActionProvider_publicClient, "f").multicall({
+            const marketQuestionsResult = await walletProvider.getPublicClient().multicall({
                 contracts: questionCalls,
             });
             // Create market objects mapping indices to addresses and questions
@@ -175,7 +155,7 @@ class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
                     });
                 }
                 try {
-                    marketAddress = (await __classPrivateFieldGet(this, _TrueMarketsActionProvider_publicClient, "f").readContract({
+                    marketAddress = (await walletProvider.getPublicClient().readContract({
                         address: constants_1.TruthMarketManager_ADDRESS,
                         abi: constants_1.TruthMarketManagerABI,
                         functionName: "getActiveMarketAddress",
@@ -227,7 +207,7 @@ class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
                     functionName: "winningPosition",
                 },
             ];
-            const basicInfoResults = await __classPrivateFieldGet(this, _TrueMarketsActionProvider_publicClient, "f").multicall({
+            const basicInfoResults = await walletProvider.getPublicClient().multicall({
                 contracts: basicInfoCalls,
             });
             // Extract results, handling potential errors
@@ -279,7 +259,7 @@ class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
                     functionName: "slot0",
                 },
             ];
-            const poolInfoResults = await __classPrivateFieldGet(this, _TrueMarketsActionProvider_publicClient, "f").multicall({
+            const poolInfoResults = await walletProvider.getPublicClient().multicall({
                 contracts: poolInfoCalls,
             });
             if (poolInfoResults.some(result => result.status === "failure")) {
@@ -308,30 +288,30 @@ class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
             const balanceCalls = [
                 {
                     address: payToken,
-                    abi: constants_2.abi,
+                    abi: viem_1.erc20Abi,
                     functionName: "balanceOf",
                     args: [yesPool],
                 },
                 {
                     address: yesToken,
-                    abi: constants_2.abi,
+                    abi: viem_1.erc20Abi,
                     functionName: "balanceOf",
                     args: [yesPool],
                 },
                 {
                     address: payToken,
-                    abi: constants_2.abi,
+                    abi: viem_1.erc20Abi,
                     functionName: "balanceOf",
                     args: [noPool],
                 },
                 {
                     address: noToken,
-                    abi: constants_2.abi,
+                    abi: viem_1.erc20Abi,
                     functionName: "balanceOf",
                     args: [noPool],
                 },
             ];
-            const balanceResults = await __classPrivateFieldGet(this, _TrueMarketsActionProvider_publicClient, "f").multicall({
+            const balanceResults = await walletProvider.getPublicClient().multicall({
                 contracts: balanceCalls,
             });
             if (balanceResults.some(result => result.status === "failure")) {
@@ -366,10 +346,10 @@ class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
             const yesPrice = calculatePrice(yesSqrtPriceX96, isYesToken0, payDecimals, yesNoTokenDecimals_);
             const noPrice = calculatePrice(noSqrtPriceX96, isNoToken0, payDecimals, yesNoTokenDecimals_);
             // Calculate TVL using token balances
-            const yesPoolStableValue = Number((0, viem_1.formatUnits)(yesPoolStableBalance || 0n, payDecimals));
-            const yesPoolTokenValue = Number((0, viem_1.formatUnits)(yesPoolTokenBalance || 0n, yesNoTokenDecimals_)) * yesPrice;
-            const noPoolStableValue = Number((0, viem_1.formatUnits)(noPoolStableBalance || 0n, payDecimals));
-            const noPoolTokenValue = Number((0, viem_1.formatUnits)(noPoolTokenBalance || 0n, yesNoTokenDecimals_)) * noPrice;
+            const yesPoolStableValue = Number((0, viem_2.formatUnits)(yesPoolStableBalance || 0n, payDecimals));
+            const yesPoolTokenValue = Number((0, viem_2.formatUnits)(yesPoolTokenBalance || 0n, yesNoTokenDecimals_)) * yesPrice;
+            const noPoolStableValue = Number((0, viem_2.formatUnits)(noPoolStableBalance || 0n, payDecimals));
+            const noPoolTokenValue = Number((0, viem_2.formatUnits)(noPoolTokenBalance || 0n, yesNoTokenDecimals_)) * noPrice;
             const yesTVL = yesPoolStableValue + yesPoolTokenValue;
             const noTVL = noPoolStableValue + noPoolTokenValue;
             const totalTVL = yesTVL + noTVL;
@@ -430,7 +410,6 @@ class TrueMarketsActionProvider extends actionProvider_1.ActionProvider {
     }
 }
 exports.TrueMarketsActionProvider = TrueMarketsActionProvider;
-_TrueMarketsActionProvider_publicClient = new WeakMap();
 __decorate([
     (0, actionDecorator_1.CreateAction)({
         name: "get_prediction_markets",
@@ -465,5 +444,5 @@ __decorate([
     __metadata("design:paramtypes", [wallet_providers_1.EvmWalletProvider, void 0]),
     __metadata("design:returntype", Promise)
 ], TrueMarketsActionProvider.prototype, "getPredictionMarketDetails", null);
-const truemarketsActionProvider = (config) => new TrueMarketsActionProvider(config);
+const truemarketsActionProvider = () => new TrueMarketsActionProvider();
 exports.truemarketsActionProvider = truemarketsActionProvider;

package/dist/action-providers/truemarkets/truemarketsActionProvider.test.js

@@ -2,29 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const truemarketsActionProvider_1 = require("./truemarketsActionProvider");
 const constants_1 = require("./constants");
-const viem_1 = require("viem");
-// Mock viem's createPublicClient
-jest.mock("viem", () => {
-    const originalModule = jest.requireActual("viem");
-    return {
-        ...originalModule,
-        createPublicClient: jest.fn().mockImplementation(() => ({
-            // Mock public client methods as needed
-            multicall: jest.fn().mockImplementation(({ contracts }) => {
-                // Create mock responses with success status
-                return contracts.map(() => ({
-                    status: "success",
-                    result: "mock result",
-                }));
-            }),
-            readContract: jest.fn(),
-        })),
-        http: jest.fn().mockImplementation(url => ({ url })),
-    };
-});
 describe("TrueMarketsActionProvider", () => {
     let provider;
     let mockWallet;
+    let publicClientMock;
     // Mock addresses and data for tests
     const MOCK_MARKET_ADDRESS = "0x1234567890123456789012345678901234567890";
     const MOCK_YES_POOL_ADDRESS = "0x2345678901234567890123456789012345678901";
@@ -36,26 +17,22 @@ describe("TrueMarketsActionProvider", () => {
     const MOCK_MARKET_SOURCE = "Test source";
     const MOCK_STATUS_NUM = 0n; // Created status
     const MOCK_END_OF_TRADING = 1717171717n; // Unix timestamp
-    describe("constructor", () => {
-        it("should use the provided RPC_URL for the public client", () => {
-            const customRpcUrl = "https://custom-rpc.example.com";
-            (0, truemarketsActionProvider_1.truemarketsActionProvider)({ RPC_URL: customRpcUrl });
-            // Verify createPublicClient was called with the correct URL
-            expect(viem_1.createPublicClient).toHaveBeenCalledWith(expect.objectContaining({
-                chain: expect.anything(),
-                transport: expect.objectContaining({ url: customRpcUrl }),
-            }));
-        });
-    });
     beforeEach(() => {
         jest.clearAllMocks();
         provider = (0, truemarketsActionProvider_1.truemarketsActionProvider)();
+        publicClientMock = {
+            multicall: jest
+                .fn()
+                .mockImplementation(({ contracts }) => contracts.map(() => ({ status: "success", result: "mock result" }))),
+            readContract: jest.fn(),
+        };
         mockWallet = {
             readContract: jest.fn(),
             getName: jest.fn().mockReturnValue("evm_wallet_provider"),
             getNetwork: jest.fn().mockReturnValue({
                 networkId: "base-mainnet",
             }),
+            getPublicClient: jest.fn().mockReturnValue(publicClientMock),
         };
     });
     afterEach(() => {
@@ -134,8 +111,9 @@ describe("TrueMarketsActionProvider", () => {
     describe("getPredictionMarketDetails", () => {
         let mockPublicClient;
         beforeEach(() => {
-            // Access the mocked public client
-            mockPublicClient = viem_1.createPublicClient.mock.results[0].value;
+            // Use the shared mocked public client
+            mockPublicClient = publicClientMock;
+            mockPublicClient.multicall.mockReset();
             // Setup multicall mock responses
             mockPublicClient.multicall
                 // Basic info calls

package/dist/action-providers/wallet/walletActionProvider.js

@@ -14,12 +14,25 @@ const zod_1 = require("zod");
 const actionDecorator_1 = require("../actionDecorator");
 const actionProvider_1 = require("../actionProvider");
 const wallet_providers_1 = require("../../wallet-providers");
+const viem_1 = require("viem");
 const schemas_1 = require("./schemas");
 const PROTOCOL_FAMILY_TO_TERMINOLOGY = {
-    evm: { unit: "WEI", displayUnit: "ETH", type: "Transaction hash", verb: "transaction" },
-    svm: { unit: "LAMPORTS", displayUnit: "SOL", type: "Signature", verb: "transfer" },
+    evm: {
+        unit: "WEI",
+        displayUnit: "ETH",
+        decimals: 18,
+        type: "Transaction hash",
+        verb: "transaction",
+    },
+    svm: { unit: "LAMPORTS", displayUnit: "SOL", decimals: 9, type: "Signature", verb: "transfer" },
+};
+const DEFAULT_TERMINOLOGY = {
+    unit: "",
+    displayUnit: "",
+    decimals: 0,
+    type: "Hash",
+    verb: "transfer",
 };
-const DEFAULT_TERMINOLOGY = { unit: "", displayUnit: "", type: "Hash", verb: "transfer" };
 /**
  * WalletActionProvider provides actions for getting basic wallet information.
  */
@@ -61,6 +74,7 @@ class WalletActionProvider extends actionProvider_1.ActionProvider {
                 `  * Network ID: ${network.networkId || "N/A"}`,
                 `  * Chain ID: ${network.chainId || "N/A"}`,
                 `- Native Balance: ${balance.toString()} ${terminology.unit}`,
+                `- Native Balance: ${(0, viem_1.formatUnits)(balance, terminology.decimals)} ${terminology.displayUnit}`,
             ].join("\n");
         }
         catch (error) {
@@ -81,7 +95,8 @@ class WalletActionProvider extends actionProvider_1.ActionProvider {
             if (protocolFamily === "evm" && !args.to.startsWith("0x")) {
                 args.to = `0x${args.to}`;
             }
-            const result = await walletProvider.nativeTransfer(args.to, args.value);
+            const amountInAtomicUnits = (0, viem_1.parseUnits)(args.value, terminology.decimals);
+            const result = await walletProvider.nativeTransfer(args.to, amountInAtomicUnits.toString());
             return [
                 `Transferred ${args.value} ${terminology.displayUnit} to ${args.to}`,
                 `${terminology.type}: ${result}`,
@@ -115,15 +130,11 @@ __decorate([
     (0, actionDecorator_1.CreateAction)({
         name: "native_transfer",
         description: `
-This tool will transfer native tokens from the wallet to another onchain address.
+This tool will transfer (send) native tokens from the wallet to another onchain address.
 
 It takes the following inputs:
-- amount: The amount to transfer in whole units (e.g. 1 ETH, 0.1 SOL)
+- amount: The amount to transfer in whole units (e.g. 4.2 ETH, 0.1 SOL)
 - destination: The address to receive the funds
-
-Important notes:
-- Ensure sufficient balance of the input asset before transferring
-- Ensure there is sufficient native token balance for gas fees
 `,
         schema: schemas_1.NativeTransferSchema,
     }),

package/dist/action-providers/wallet/walletActionProvider.test.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const walletActionProvider_1 = require("./walletActionProvider");
 const schemas_1 = require("./schemas");
+const viem_1 = require("viem");
 describe("Wallet Action Provider", () => {
     const MOCK_ADDRESS = "0xe6b2af36b3bb8d47206a129ff11d5a2de2a63c83";
     const MOCK_ETH_BALANCE = 1000000000000000000n;
@@ -47,6 +48,7 @@ describe("Wallet Action Provider", () => {
                 `  * Network ID: ${MOCK_EVM_NETWORK.networkId}`,
                 `  * Chain ID: ${MOCK_EVM_NETWORK.chainId}`,
                 `- Native Balance: ${MOCK_ETH_BALANCE.toString()} WEI`,
+                `- Native Balance: ${(0, viem_1.formatUnits)(MOCK_ETH_BALANCE, 18)} ETH`,
             ].join("\n");
             expect(response).toBe(expectedResponse);
         });
@@ -63,6 +65,7 @@ describe("Wallet Action Provider", () => {
                 `  * Network ID: ${MOCK_SOLANA_NETWORK.networkId}`,
                 `  * Chain ID: N/A`,
                 `- Native Balance: ${MOCK_SOL_BALANCE.toString()} LAMPORTS`,
+                `- Native Balance: ${(0, viem_1.formatUnits)(MOCK_SOL_BALANCE, 9)} SOL`,
             ].join("\n");
             expect(response).toBe(expectedResponse);
         });
@@ -79,6 +82,7 @@ describe("Wallet Action Provider", () => {
                 `  * Network ID: ${MOCK_UNKNOWN_NETWORK.networkId}`,
                 `  * Chain ID: N/A`,
                 `- Native Balance: ${MOCK_ETH_BALANCE.toString()} `,
+                `- Native Balance: ${MOCK_ETH_BALANCE.toString()} `,
             ].join("\n");
             expect(response).toBe(expectedResponse);
         });
@@ -125,7 +129,7 @@ describe("Wallet Action Provider", () => {
                 value: MOCK_AMOUNT,
             };
             const response = await actionProvider.nativeTransfer(mockWallet, args);
-            expect(mockWallet.nativeTransfer).toHaveBeenCalledWith(MOCK_DESTINATION, MOCK_AMOUNT);
+            expect(mockWallet.nativeTransfer).toHaveBeenCalledWith(MOCK_DESTINATION, (0, viem_1.parseUnits)(MOCK_AMOUNT, 18).toString());
             expect(response).toBe(`Transferred ${MOCK_AMOUNT} ETH to ${MOCK_DESTINATION}\nTransaction hash: ${MOCK_TRANSACTION_HASH}`);
         });
         it("should successfully transfer SOL", async () => {
@@ -136,7 +140,7 @@ describe("Wallet Action Provider", () => {
                 value: MOCK_AMOUNT,
             };
             const response = await actionProvider.nativeTransfer(mockWallet, args);
-            expect(mockWallet.nativeTransfer).toHaveBeenCalledWith(MOCK_DESTINATION, MOCK_AMOUNT);
+            expect(mockWallet.nativeTransfer).toHaveBeenCalledWith(MOCK_DESTINATION, (0, viem_1.parseUnits)(MOCK_AMOUNT, 9).toString());
             expect(response).toBe(`Transferred ${MOCK_AMOUNT} SOL to ${MOCK_DESTINATION}\nSignature: ${MOCK_SIGNATURE}`);
         });
         it("should handle ETH transfer errors", async () => {

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;
+}>;

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

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERMIT2_ADDRESS = void 0;
+exports.isNativeEth = isNativeEth;
+exports.getTokenDetails = getTokenDetails;
+const viem_1 = require("viem");
+// Permit2 contract address is the same across all networks
+exports.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.
+ */
+function isNativeEth(token) {
+    return token.toLowerCase() === "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
+}
+/**
+ * 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}>
+ */
+async function getTokenDetails(walletProvider, fromToken, toToken) {
+    // Initialize default values for native ETH
+    let fromTokenDecimals = 18;
+    let fromTokenName = "ETH";
+    let toTokenDecimals = 18;
+    let toTokenName = "ETH";
+    // Prepare multicall contracts array
+    const contracts = [];
+    const contractIndexMap = {
+        fromDecimals: -1,
+        fromName: -1,
+        toDecimals: -1,
+        toName: -1,
+    };
+    // Add from token contracts if not native ETH
+    if (!isNativeEth(fromToken)) {
+        contractIndexMap.fromDecimals = contracts.length;
+        contracts.push({
+            address: fromToken,
+            abi: viem_1.erc20Abi,
+            functionName: "decimals",
+        });
+        contractIndexMap.fromName = contracts.length;
+        contracts.push({
+            address: fromToken,
+            abi: viem_1.erc20Abi,
+            functionName: "name",
+        });
+    }
+    // Add to token contracts if not native ETH
+    if (!isNativeEth(toToken)) {
+        contractIndexMap.toDecimals = contracts.length;
+        contracts.push({
+            address: toToken,
+            abi: viem_1.erc20Abi,
+            functionName: "decimals",
+        });
+        contractIndexMap.toName = contracts.length;
+        contracts.push({
+            address: toToken,
+            abi: viem_1.erc20Abi,
+            functionName: "name",
+        });
+    }
+    // Execute multicall if there are contracts to call
+    if (contracts.length > 0) {
+        try {
+            const results = await walletProvider.getPublicClient().multicall({
+                contracts,
+            });
+            // Extract from token details
+            if (contractIndexMap.fromDecimals !== -1) {
+                const decimalsResult = results[contractIndexMap.fromDecimals];
+                const nameResult = results[contractIndexMap.fromName];
+                if (decimalsResult.status === "success" && nameResult.status === "success") {
+                    fromTokenDecimals = decimalsResult.result;
+                    fromTokenName = nameResult.result;
+                }
+                else {
+                    throw new Error(`Failed to read details for fromToken ${fromToken}. This address may not be a valid ERC20 contract.`);
+                }
+            }
+            // Extract to token details
+            if (contractIndexMap.toDecimals !== -1) {
+                const decimalsResult = results[contractIndexMap.toDecimals];
+                const nameResult = results[contractIndexMap.toName];
+                if (decimalsResult.status === "success" && nameResult.status === "success") {
+                    toTokenDecimals = decimalsResult.result;
+                    toTokenName = nameResult.result;
+                }
+                else {
+                    throw new Error(`Failed to read details for toToken ${toToken}. This address may not be a valid ERC20 contract.`);
+                }
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to read token details via multicall. Error: ${error}`);
+        }
+    }
+    return { fromTokenDecimals, toTokenDecimals, fromTokenName, toTokenName };
+}