@coinbase/agentkit 0.10.0 → 0.10.2

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.
  */
@@ -56,11 +69,15 @@ class WalletActionProvider extends actionProvider_1.ActionProvider {
                 "Wallet Details:",
                 `- Provider: ${name}`,
                 `- Address: ${address}`,
+                ...(walletProvider instanceof wallet_providers_1.CdpSmartWalletProvider
+                    ? [`- Owner Address: ${walletProvider.ownerAccount.address}`]
+                    : []),
                 "- Network:",
                 `  * Protocol Family: ${network.protocolFamily}`,
                 `  * 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 +98,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 +133,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/x402/schemas.d.ts

@@ -1,4 +1,11 @@
 import { z } from "zod";
+export declare const ListX402ServicesSchema: z.ZodObject<{
+    maxUsdcPrice: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxUsdcPrice?: number | undefined;
+}, {
+    maxUsdcPrice?: number | undefined;
+}>;
 export declare const HttpRequestSchema: z.ZodObject<{
     url: z.ZodString;
     method: z.ZodDefault<z.ZodNullable<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH"]>>>;

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

@@ -1,7 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DirectX402RequestSchema = exports.RetryWithX402Schema = exports.HttpRequestSchema = void 0;
+exports.DirectX402RequestSchema = exports.RetryWithX402Schema = exports.HttpRequestSchema = exports.ListX402ServicesSchema = void 0;
 const zod_1 = require("zod");
+// Schema for listing x402 services
+exports.ListX402ServicesSchema = zod_1.z
+    .object({
+    maxUsdcPrice: zod_1.z
+        .number()
+        .optional()
+        .describe("Optional maximum price in USDC whole units (e.g., 0.1 for 0.10 USDC). Only USDC payment options will be considered when this filter is applied."),
+})
+    .strip()
+    .describe("Parameters for listing x402 services with optional filtering");
 // Schema for initial HTTP request
 exports.HttpRequestSchema = zod_1.z
     .object({

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

@@ -0,0 +1,55 @@
+import { Network } from "../../network";
+import { AxiosError } from "axios";
+import { EvmWalletProvider } from "../../wallet-providers";
+/**
+ * Supported network types for x402 protocol
+ */
+export type X402Network = "base" | "base-sepolia" | "solana" | "solana-devnet";
+/**
+ * Converts the internal network ID to the format expected by the x402 protocol.
+ *
+ * @param network - The network to convert
+ * @returns The network ID in x402 format
+ * @throws Error if the network is not supported
+ */
+export declare function getX402Network(network: Network): X402Network | string | undefined;
+/**
+ * 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
+ */
+export declare function handleHttpError(error: AxiosError, url: string): string;
+/**
+ * Formats a payment option into a human-readable string.
+ *
+ * @param option - The payment option to format
+ * @param option.asset - The asset address or identifier
+ * @param option.maxAmountRequired - The maximum amount required for the payment
+ * @param option.network - The network identifier
+ * @param walletProvider - The wallet provider for token details lookup
+ * @returns A formatted string like "0.1 USDC on base"
+ */
+export declare function formatPaymentOption(option: {
+    asset: string;
+    maxAmountRequired: string;
+    network: string;
+}, walletProvider: EvmWalletProvider): Promise<string>;
+/**
+ * Checks if an asset is USDC on any supported network.
+ *
+ * @param asset - The asset address or identifier
+ * @param walletProvider - The wallet provider for network context
+ * @returns True if the asset is USDC, false otherwise
+ */
+export declare function isUsdcAsset(asset: string, walletProvider: EvmWalletProvider): boolean;
+/**
+ * Converts whole units to atomic units for a given asset.
+ *
+ * @param wholeUnits - The amount in whole units (e.g., 0.1 for 0.1 USDC)
+ * @param asset - The asset address or identifier
+ * @param walletProvider - The wallet provider for token details lookup
+ * @returns The amount in atomic units as a string, or null if conversion fails
+ */
+export declare function convertWholeUnitsToAtomic(wholeUnits: number, asset: string, walletProvider: EvmWalletProvider): Promise<string | null>;

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

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getX402Network = getX402Network;
+exports.handleHttpError = handleHttpError;
+exports.formatPaymentOption = formatPaymentOption;
+exports.isUsdcAsset = isUsdcAsset;
+exports.convertWholeUnitsToAtomic = convertWholeUnitsToAtomic;
+const utils_1 = require("../erc20/utils");
+const constants_1 = require("../erc20/constants");
+const viem_1 = require("viem");
+/**
+ * Converts the internal network ID to the format expected by the x402 protocol.
+ *
+ * @param network - The network to convert
+ * @returns The network ID in x402 format
+ * @throws Error if the network is not supported
+ */
+function getX402Network(network) {
+    switch (network.networkId) {
+        case "base-mainnet":
+            return "base";
+        case "base-sepolia":
+            return "base-sepolia";
+        case "solana-mainnet":
+            return "solana";
+        case "solana-devnet":
+            return "solana-devnet";
+        default:
+            return network.networkId;
+    }
+}
+/**
+ * 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
+ */
+function 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 JSON.stringify({
+        error: true,
+        message: `Error making request to ${url}`,
+        details: error.message,
+        suggestion: "Please check the request parameters and try again.",
+    }, null, 2);
+}
+/**
+ * Formats a payment option into a human-readable string.
+ *
+ * @param option - The payment option to format
+ * @param option.asset - The asset address or identifier
+ * @param option.maxAmountRequired - The maximum amount required for the payment
+ * @param option.network - The network identifier
+ * @param walletProvider - The wallet provider for token details lookup
+ * @returns A formatted string like "0.1 USDC on base"
+ */
+async function formatPaymentOption(option, walletProvider) {
+    const { asset, maxAmountRequired, network } = option;
+    // Check if this is an EVM network and we can use ERC20 helpers
+    const walletNetwork = walletProvider.getNetwork();
+    const isEvmNetwork = walletNetwork.protocolFamily === "evm";
+    if (isEvmNetwork) {
+        const networkId = walletNetwork.networkId;
+        const tokenSymbols = constants_1.TOKEN_ADDRESSES_BY_SYMBOLS[networkId];
+        if (tokenSymbols) {
+            for (const [symbol, address] of Object.entries(tokenSymbols)) {
+                if (asset.toLowerCase() === address.toLowerCase()) {
+                    const decimals = symbol === "USDC" || symbol === "EURC" ? 6 : 18;
+                    const formattedAmount = (0, viem_1.formatUnits)(BigInt(maxAmountRequired), decimals);
+                    return `${formattedAmount} ${symbol} on ${network} network`;
+                }
+            }
+        }
+        // Fall back to getTokenDetails for unknown tokens
+        try {
+            const tokenDetails = await (0, utils_1.getTokenDetails)(walletProvider, asset);
+            if (tokenDetails) {
+                const formattedAmount = (0, viem_1.formatUnits)(BigInt(maxAmountRequired), tokenDetails.decimals);
+                return `${formattedAmount} ${tokenDetails.name} on ${network} network`;
+            }
+        }
+        catch {
+            // If we can't get token details, fall back to raw format
+        }
+    }
+    // Fallback to original format for non-EVM networks or when token details can't be fetched
+    return `${asset} ${maxAmountRequired} on ${network} network`;
+}
+/**
+ * Checks if an asset is USDC on any supported network.
+ *
+ * @param asset - The asset address or identifier
+ * @param walletProvider - The wallet provider for network context
+ * @returns True if the asset is USDC, false otherwise
+ */
+function isUsdcAsset(asset, walletProvider) {
+    const walletNetwork = walletProvider.getNetwork();
+    const isEvmNetwork = walletNetwork.protocolFamily === "evm";
+    if (isEvmNetwork) {
+        const networkId = walletNetwork.networkId;
+        const tokenSymbols = constants_1.TOKEN_ADDRESSES_BY_SYMBOLS[networkId];
+        if (tokenSymbols && tokenSymbols.USDC) {
+            return asset.toLowerCase() === tokenSymbols.USDC.toLowerCase();
+        }
+    }
+    return false;
+}
+/**
+ * Converts whole units to atomic units for a given asset.
+ *
+ * @param wholeUnits - The amount in whole units (e.g., 0.1 for 0.1 USDC)
+ * @param asset - The asset address or identifier
+ * @param walletProvider - The wallet provider for token details lookup
+ * @returns The amount in atomic units as a string, or null if conversion fails
+ */
+async function convertWholeUnitsToAtomic(wholeUnits, asset, walletProvider) {
+    // Check if this is an EVM network and we can use ERC20 helpers
+    const walletNetwork = walletProvider.getNetwork();
+    const isEvmNetwork = walletNetwork.protocolFamily === "evm";
+    if (isEvmNetwork) {
+        const networkId = walletNetwork.networkId;
+        const tokenSymbols = constants_1.TOKEN_ADDRESSES_BY_SYMBOLS[networkId];
+        if (tokenSymbols) {
+            for (const [symbol, address] of Object.entries(tokenSymbols)) {
+                if (asset.toLowerCase() === address.toLowerCase()) {
+                    const decimals = symbol === "USDC" || symbol === "EURC" ? 6 : 18;
+                    return (0, viem_1.parseUnits)(wholeUnits.toString(), decimals).toString();
+                }
+            }
+        }
+        // Fall back to getTokenDetails for unknown tokens
+        try {
+            const tokenDetails = await (0, utils_1.getTokenDetails)(walletProvider, asset);
+            if (tokenDetails) {
+                return (0, viem_1.parseUnits)(wholeUnits.toString(), tokenDetails.decimals).toString();
+            }
+        }
+        catch {
+            // If we can't get token details, fall back to assuming 18 decimals
+        }
+    }
+    // Fallback to 18 decimals for unknown tokens or non-EVM networks
+    return (0, viem_1.parseUnits)(wholeUnits.toString(), 18).toString();
+}

package/dist/action-providers/x402/x402ActionProvider.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { ActionProvider } from "../actionProvider";
 import { Network } from "../../network";
-import { HttpRequestSchema, RetryWithX402Schema, DirectX402RequestSchema } from "./schemas";
+import { HttpRequestSchema, RetryWithX402Schema, DirectX402RequestSchema, ListX402ServicesSchema } from "./schemas";
 import { EvmWalletProvider } from "../../wallet-providers";
 /**
  * X402ActionProvider provides actions for making HTTP requests, with optional x402 payment handling.
@@ -12,6 +12,14 @@ export declare class X402ActionProvider extends ActionProvider<EvmWalletProvider
      * Initializes the provider with x402 capabilities.
      */
     constructor();
+    /**
+     * 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)
+     */
+    discoverX402Services(walletProvider: EvmWalletProvider, args: z.infer<typeof ListX402ServicesSchema>): Promise<string>;
     /**
      * Makes a basic HTTP request to an API endpoint.
      *
@@ -43,13 +51,5 @@ export declare class X402ActionProvider extends ActionProvider<EvmWalletProvider
      * @returns True if the network is supported, false otherwise
      */
     supportsNetwork: (network: Network) => boolean;
-    /**
-     * 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
-     */
-    private handleHttpError;
 }
 export declare const x402ActionProvider: () => X402ActionProvider;