@coinbase/agentkit 0.0.0-nightly-20250807210405 → 0.0.0-nightly-20250815210416

package/dist/action-providers/zerion/zerionActionProvider.js

@@ -0,0 +1,159 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zerionActionProvider = exports.ZerionActionProvider = void 0;
+const viem_1 = require("viem");
+const zod_1 = require("zod");
+const actionDecorator_1 = require("../actionDecorator");
+const actionProvider_1 = require("../actionProvider");
+const constants_1 = require("./constants");
+const schemas_1 = require("./schemas");
+const utils_1 = require("./utils");
+/**
+ * ZerionActionProvider provides actions for zerion operations.
+ *
+ * @description
+ * This provider is designed to provide EVM-based operations.
+ * It supports all EVM-based networks.
+ */
+class ZerionActionProvider extends actionProvider_1.ActionProvider {
+    /**
+     * Constructor for the ZerionActionProvider.
+     *
+     * @param config - The configuration options for the ZerionActionProvider.
+     */
+    constructor(config = {}) {
+        super("zerion", []);
+        const apiKey = config.apiKey || process.env.ZERION_API_KEY;
+        if (!apiKey) {
+            throw new Error("ZERION_API_KEY is not configured.");
+        }
+        const encodedKey = Buffer.from(`${apiKey}:`).toString("base64");
+        this.apiKey = encodedKey;
+    }
+    /**
+     * Fetches and summarizes a crypto wallet's portfolio in USD.
+     *
+     * @param args - Arguments defined by GetWalletPortfolioSchema
+     * @returns A promise that resolves to a string describing the action result
+     */
+    async getPortfolioOverview(args) {
+        try {
+            const address = args.walletAddress || "";
+            if (!(0, viem_1.isAddress)(address)) {
+                return `Invalid wallet address: ${address}`;
+            }
+            const options = {
+                method: "GET",
+                headers: {
+                    accept: "application/json",
+                    authorization: `Basic ${this.apiKey}`,
+                },
+            };
+            const url = `${constants_1.ZERION_V1_BASE_URL}/wallets/${args.walletAddress}/portfolio?filter[positions]=no_filter&currency=usd`;
+            const response = await fetch(url, options);
+            const { data } = await response.json();
+            return (0, utils_1.formatPortfolioData)(data);
+        }
+        catch (error) {
+            return `Error fetching portfolio overview for wallet ${args.walletAddress}: ${error}`;
+        }
+    }
+    /**
+     * Retrieves and summarizes a wallet's fungible token holdings.
+     *
+     * @param args - Arguments defined by GetWalletPortfolioSchema
+     * @returns A promise that resolves to a string describing the action result
+     */
+    async getFungiblePositions(args) {
+        try {
+            const address = args.walletAddress || "";
+            if (!(0, viem_1.isAddress)(address)) {
+                return `Invalid wallet address: ${address}`;
+            }
+            const options = {
+                method: "GET",
+                headers: {
+                    accept: "application/json",
+                    authorization: `Basic ${this.apiKey}`,
+                },
+            };
+            const url = `${constants_1.ZERION_V1_BASE_URL}/wallets/${args.walletAddress}/positions?filter[positions]=no_filter&currency=usd&filter[trash]=only_non_trash&sort=value`;
+            const response = await fetch(url, options);
+            const { data } = await response.json();
+            return (0, utils_1.formatPositionsData)(data);
+        }
+        catch (error) {
+            return `Error fetching fungible positions for wallet ${args.walletAddress}: ${error}`;
+        }
+    }
+    /**
+     * Checks if this provider supports the given network.
+     *
+     * @param network - The network to check support for
+     * @returns True if the network is supported
+     */
+    supportsNetwork(network) {
+        // all protocol networks
+        return network.protocolFamily === "evm";
+    }
+}
+exports.ZerionActionProvider = ZerionActionProvider;
+__decorate([
+    (0, actionDecorator_1.CreateAction)({
+        name: "get_portfolio_overview",
+        description: `
+    Fetches and summarizes a crypto wallet's portfolio in USD. 
+    The tool returns a human-readable overview of the wallet's total value, value distribution across blockchains, position types (e.g., staked, deposited), and 24-hour performance change. 
+    Useful for providing quick insights into a wallet's DeFi and cross-chain holdings.
+    Input:
+    - walletAddress: The wallet address to fetch portfolio overview for.
+    Output a structured text summary with:
+    - Total portfolio value in USD
+    - 24h percentage change in value
+    - Breakdown of value by position types (e.g., wallet, deposited, staked, locked, borrowed)
+    - Top 5 chains by value distribution
+  `,
+        schema: schemas_1.GetWalletPortfolioSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [void 0]),
+    __metadata("design:returntype", Promise)
+], ZerionActionProvider.prototype, "getPortfolioOverview", null);
+__decorate([
+    (0, actionDecorator_1.CreateAction)({
+        name: "get_fungible_positions",
+        description: `
+    Retrieves and summarizes a wallet's fungible token holdings. 
+    For each token, it includes metadata such as symbol, name, holding value, associated protocol (if applicable), and the type of position (e.g., deposit, wallet, reward). 
+    The summary also reports the total USD value of all qualifying token positions.
+    Input:
+    - walletAddress: The wallet address to fetch fungible positions for.
+    Output a readable text summary including:
+    - All token positions
+    - For each: token name, symbol, USD value, chain, position type
+    - If applicable: protocol used and type of action (e.g. staked, deposited via protocol)
+    - A final total value in USD across all included positions
+  `,
+        schema: schemas_1.GetWalletPortfolioSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [void 0]),
+    __metadata("design:returntype", Promise)
+], ZerionActionProvider.prototype, "getFungiblePositions", null);
+/**
+ * Factory function to create a new ZerionActionProvider instance.
+ *
+ * @param config - The configuration options for the ZerionActionProvider.
+ * @returns A new ZerionActionProvider instance
+ */
+const zerionActionProvider = (config) => new ZerionActionProvider(config);
+exports.zerionActionProvider = zerionActionProvider;

package/dist/action-providers/zerion/zerionActionProvider.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/action-providers/zerion/zerionActionProvider.test.js

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zerionActionProvider_1 = require("./zerionActionProvider");
+const utils_1 = require("./utils");
+// Mocks for fetch and utils
+global.fetch = jest.fn();
+jest.mock("./utils", () => ({
+    formatPortfolioData: jest.fn(() => "formatted portfolio"),
+    formatPositionsData: jest.fn(() => "formatted positions"),
+}));
+describe("ZerionActionProvider", () => {
+    const mockApiKey = "test-api-key";
+    const originalEnv = process.env.ZERION_API_KEY;
+    const mockFungiblePositionResponse = {
+        links: {
+            self: "https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/positions/",
+        },
+        data: [
+            {
+                type: "positions",
+                id: "0x111c47865ade3b172a928df8f990bc7f2a3b9aaa-polygon-asset-none-",
+                attributes: {
+                    parent: "0x111c47865ade3b172a928df8f990bc7f2a3b9aaa-polygon-asset-none-",
+                    protocol: null,
+                    pool_address: "0x109830a1aaad605bbf02a9dfa7b0b92ec2fb7daa",
+                    name: "Asset",
+                    group_id: "0a771a0064dad468045899032c7fb01a971f973f7dff0a5cdc3ce199f45e94d7",
+                    position_type: "deposit",
+                    quantity: {
+                        int: "12345678",
+                        decimals: 5,
+                        float: 123.45678,
+                        numeric: "123.45678",
+                    },
+                    value: 5.384656557642683,
+                    price: 0.043615722,
+                    changes: {
+                        absolute_1d: 0.272309794,
+                        percent_1d: 5.326512552079021,
+                    },
+                    fungible_info: {
+                        name: "Bankless BED Index",
+                        symbol: "BED",
+                        description: "The BED index is meant to track crypto’s top 3 investab...",
+                        icon: {
+                            url: "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png",
+                        },
+                        flags: {
+                            verified: true,
+                        },
+                        implementations: [
+                            {
+                                chain_id: "ethereum",
+                                address: "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6",
+                                decimals: 18,
+                            },
+                        ],
+                    },
+                    flags: {
+                        displayable: true,
+                        is_trash: true,
+                    },
+                    updated_at: "2023-11-10T23:00:00Z",
+                    updated_at_block: 0,
+                    application_metadata: {
+                        name: "AAVE",
+                        icon: {
+                            url: "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png",
+                        },
+                        url: "https://app.aave.com/",
+                    },
+                },
+                relationships: {
+                    chain: {
+                        links: {
+                            related: "https://api.zerion.io/v1/chains/polygon",
+                        },
+                        data: {
+                            type: "chains",
+                            id: "polygon",
+                        },
+                    },
+                    fungible: {
+                        links: {
+                            related: "https://api.zerion.io/v1/fungibles/0x111c47865ade3b172a928df8f990bc7f2a3b9aaa",
+                        },
+                        data: {
+                            type: "fungibles",
+                            id: "0x111c47865ade3b172a928df8f990bc7f2a3b9aaa",
+                        },
+                    },
+                    dapp: {
+                        data: {
+                            type: "dapps",
+                            id: "aave-v3",
+                        },
+                    },
+                },
+            },
+        ],
+    };
+    const mockPortfolioResponse = {
+        links: {
+            self: "https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/portfolio",
+        },
+        data: {
+            type: "portfolio",
+            id: "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
+            attributes: {
+                positions_distribution_by_type: {
+                    wallet: 1864.774102420957,
+                    deposited: 78.04192492782934,
+                    borrowed: 0.9751475798305564,
+                    locked: 5.780032725068765,
+                    staked: 66.13183205505294,
+                },
+                positions_distribution_by_chain: {
+                    arbitrum: 458.3555051522226,
+                    aurora: 72.01031337463428,
+                    avalanche: 17.128850607339444,
+                    base: 55.01550749900544,
+                    "binance-smart-chain": 5.561075880033699,
+                    celo: 31.293849330045006,
+                    ethereum: 1214.009900354964,
+                    fantom: 84.58514074264951,
+                    linea: 8.258227109505139,
+                    optimism: 573.032664994399,
+                    polygon: 64.31407562634853,
+                    xdai: 113.1679493137936,
+                    "zksync-era": 9.451002156306377,
+                },
+                total: {
+                    positions: 2017.4858230069574,
+                },
+                changes: {
+                    absolute_1d: 102.0271468171374,
+                    percent_1d: 5.326512552079021,
+                },
+            },
+        },
+    };
+    beforeEach(() => {
+        jest.clearAllMocks();
+        process.env.ZERION_API_KEY = mockApiKey;
+    });
+    afterAll(() => {
+        process.env.ZERION_API_KEY = originalEnv;
+    });
+    it("should throw if no API key is provided", () => {
+        delete process.env.ZERION_API_KEY;
+        expect(() => new zerionActionProvider_1.ZerionActionProvider()).toThrow("ZERION_API_KEY is not configured.");
+    });
+    it("should use provided API key from config", () => {
+        const provider = new zerionActionProvider_1.ZerionActionProvider({ apiKey: "foo" });
+        expect(provider).toBeDefined();
+    });
+    // supportsNetwork tests
+    const provider = new zerionActionProvider_1.ZerionActionProvider({ apiKey: mockApiKey });
+    it("should support the protocol family", () => {
+        expect(provider.supportsNetwork({ protocolFamily: "evm" })).toBe(true);
+    });
+    it("should not support other protocol families", () => {
+        expect(provider.supportsNetwork({ protocolFamily: "other-protocol-family" })).toBe(false);
+    });
+    it("should handle invalid network objects", () => {
+        expect(provider.supportsNetwork({ protocolFamily: "invalid-protocol" })).toBe(false);
+        expect(provider.supportsNetwork({})).toBe(false);
+    });
+    describe("getPortfolioOverview", () => {
+        const validAddress = "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990";
+        const invalidAddress = "invalid-address";
+        const provider = new zerionActionProvider_1.ZerionActionProvider({ apiKey: mockApiKey });
+        it("returns error for invalid address", async () => {
+            const result = await provider.getPortfolioOverview({ walletAddress: invalidAddress });
+            expect(result).toMatch(/Invalid wallet address/);
+        });
+        it("returns formatted data for valid address", async () => {
+            global.fetch.mockResolvedValueOnce({
+                json: jest.fn().mockResolvedValue(mockPortfolioResponse),
+            });
+            const result = await provider.getPortfolioOverview({ walletAddress: validAddress });
+            expect(utils_1.formatPortfolioData).toHaveBeenCalledWith(mockPortfolioResponse.data);
+            expect(result).toBe("formatted portfolio");
+        });
+        it("returns error on fetch failure", async () => {
+            global.fetch.mockRejectedValueOnce(new Error("fail"));
+            const result = await provider.getPortfolioOverview({ walletAddress: validAddress });
+            expect(result).toMatch(/Error fetching portfolio overview/);
+        });
+    });
+    describe("getFungiblePositions", () => {
+        const validAddress = "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990";
+        const invalidAddress = "invalid-address";
+        const provider = new zerionActionProvider_1.ZerionActionProvider({ apiKey: mockApiKey });
+        it("returns error for invalid address", async () => {
+            const result = await provider.getFungiblePositions({ walletAddress: invalidAddress });
+            expect(result).toMatch(/Invalid wallet address/);
+        });
+        it("returns formatted data for valid address", async () => {
+            global.fetch.mockResolvedValueOnce({
+                json: jest.fn().mockResolvedValue(mockFungiblePositionResponse),
+            });
+            const result = await provider.getFungiblePositions({ walletAddress: validAddress });
+            expect(utils_1.formatPositionsData).toHaveBeenCalledWith(mockFungiblePositionResponse.data);
+            expect(result).toBe("formatted positions");
+        });
+        it("returns error on fetch failure", async () => {
+            global.fetch.mockRejectedValueOnce(new Error("fail"));
+            const result = await provider.getFungiblePositions({ walletAddress: validAddress });
+            expect(result).toMatch(/Error fetching fungible positions/);
+        });
+    });
+});

package/dist/wallet-providers/cdpEvmWalletProvider.d.ts

@@ -1,5 +1,5 @@
 import { CdpClient } from "@coinbase/cdp-sdk";
-import { Abi, Address, ContractFunctionArgs, ContractFunctionName, Hex, ReadContractParameters, ReadContractReturnType, TransactionRequest } from "viem";
+import { Abi, Address, ContractFunctionArgs, ContractFunctionName, Hex, PublicClient, ReadContractParameters, ReadContractReturnType, TransactionRequest } from "viem";
 import { Network } from "../network";
 import { EvmWalletProvider } from "./evmWalletProvider";
 import { WalletProviderWithClient, CdpWalletProviderConfig } from "./cdpShared";
@@ -83,6 +83,12 @@ export declare class CdpEvmWalletProvider extends EvmWalletProvider implements W
      * @returns The CDP client.
      */
     getClient(): CdpClient;
+    /**
+     * Gets the Viem PublicClient used for read-only operations.
+     *
+     * @returns The Viem PublicClient instance used for read-only operations.
+     */
+    getPublicClient(): PublicClient;
     /**
      * Gets the balance of the wallet.
      *

package/dist/wallet-providers/cdpEvmWalletProvider.js

@@ -67,9 +67,10 @@ class CdpEvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         const serverAccount = await (config.address
             ? cdpClient.evm.getAccount({ address: config.address })
             : cdpClient.evm.createAccount({ idempotencyKey }));
+        const rpcUrl = config.rpcUrl || process.env.RPC_URL;
         const publicClient = (0, viem_1.createPublicClient)({
             chain: network_1.NETWORK_ID_TO_VIEM_CHAIN[networkId],
-            transport: (0, viem_1.http)(),
+            transport: rpcUrl ? (0, viem_1.http)(rpcUrl) : (0, viem_1.http)(),
         });
         return new CdpEvmWalletProvider({
             publicClient,
@@ -188,6 +189,14 @@ class CdpEvmWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
     getClient() {
         return __classPrivateFieldGet(this, _CdpEvmWalletProvider_cdp, "f");
     }
+    /**
+     * Gets the Viem PublicClient used for read-only operations.
+     *
+     * @returns The Viem PublicClient instance used for read-only operations.
+     */
+    getPublicClient() {
+        return __classPrivateFieldGet(this, _CdpEvmWalletProvider_publicClient, "f");
+    }
     /**
      * Gets the balance of the wallet.
      *

package/dist/wallet-providers/cdpShared.d.ts

@@ -30,6 +30,11 @@ export interface CdpWalletProviderConfig extends CdpProviderConfig {
      * The idempotency key of the wallet. Only used when creating a new account.
      */
     idempotencyKey?: string;
+    /**
+     * Optional RPC URL for Viem public client HTTP transport.
+     * Falls back to process.env.RPC_URL when not provided.
+     */
+    rpcUrl?: string;
 }
 export interface CdpSmartWalletProviderConfig extends CdpWalletProviderConfig {
     /**

package/dist/wallet-providers/cdpSmartWalletProvider.d.ts

@@ -1,5 +1,5 @@
-import { CdpClient } from "@coinbase/cdp-sdk";
-import { Abi, Address, ContractFunctionArgs, ContractFunctionName, Hex, ReadContractParameters, ReadContractReturnType, TransactionRequest } from "viem";
+import { CdpClient, EvmSmartAccount } from "@coinbase/cdp-sdk";
+import { Abi, Address, ContractFunctionArgs, ContractFunctionName, Hex, PublicClient, ReadContractParameters, ReadContractReturnType, TransactionRequest } from "viem";
 import { Network } from "../network";
 import { EvmWalletProvider } from "./evmWalletProvider";
 import { WalletProviderWithClient, CdpSmartWalletProviderConfig } from "./cdpShared";
@@ -8,6 +8,7 @@ import { WalletProviderWithClient, CdpSmartWalletProviderConfig } from "./cdpSha
  */
 export declare class CdpSmartWalletProvider extends EvmWalletProvider implements WalletProviderWithClient {
     #private;
+    smartAccount: EvmSmartAccount;
     /**
      * Constructs a new CdpSmartWalletProvider.
      *
@@ -90,6 +91,12 @@ export declare class CdpSmartWalletProvider extends EvmWalletProvider implements
      * @returns The paymaster URL if configured, undefined otherwise.
      */
     getPaymasterUrl(): string | undefined;
+    /**
+     * Gets the Viem PublicClient used for read-only operations.
+     *
+     * @returns The Viem PublicClient instance used for read-only operations.
+     */
+    getPublicClient(): PublicClient;
     /**
      * Gets the balance of the smart wallet.
      *

package/dist/wallet-providers/cdpSmartWalletProvider.js

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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 _CdpSmartWalletProvider_instances, _CdpSmartWalletProvider_publicClient, _CdpSmartWalletProvider_smartAccount, _CdpSmartWalletProvider_ownerAccount, _CdpSmartWalletProvider_cdp, _CdpSmartWalletProvider_network, _CdpSmartWalletProvider_paymasterUrl, _CdpSmartWalletProvider_getCdpSdkNetwork;
+var _CdpSmartWalletProvider_instances, _CdpSmartWalletProvider_publicClient, _CdpSmartWalletProvider_ownerAccount, _CdpSmartWalletProvider_cdp, _CdpSmartWalletProvider_network, _CdpSmartWalletProvider_paymasterUrl, _CdpSmartWalletProvider_getCdpSdkNetwork;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CdpSmartWalletProvider = void 0;
 const cdp_sdk_1 = require("@coinbase/cdp-sdk");
@@ -30,12 +30,11 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         super();
         _CdpSmartWalletProvider_instances.add(this);
         _CdpSmartWalletProvider_publicClient.set(this, void 0);
-        _CdpSmartWalletProvider_smartAccount.set(this, void 0);
         _CdpSmartWalletProvider_ownerAccount.set(this, void 0);
         _CdpSmartWalletProvider_cdp.set(this, void 0);
         _CdpSmartWalletProvider_network.set(this, void 0);
         _CdpSmartWalletProvider_paymasterUrl.set(this, void 0);
-        __classPrivateFieldSet(this, _CdpSmartWalletProvider_smartAccount, config.smartAccount, "f");
+        this.smartAccount = config.smartAccount;
         __classPrivateFieldSet(this, _CdpSmartWalletProvider_ownerAccount, config.ownerAccount, "f");
         __classPrivateFieldSet(this, _CdpSmartWalletProvider_cdp, config.cdp, "f");
         __classPrivateFieldSet(this, _CdpSmartWalletProvider_publicClient, config.publicClient, "f");
@@ -93,9 +92,10 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
             : cdpClient.evm.createSmartAccount({
                 owner: ownerAccount,
             }));
+        const rpcUrl = config.rpcUrl || process.env.RPC_URL;
         const publicClient = (0, viem_1.createPublicClient)({
             chain: network_1.NETWORK_ID_TO_VIEM_CHAIN[networkId],
-            transport: (0, viem_1.http)(),
+            transport: rpcUrl ? (0, viem_1.http)(rpcUrl) : (0, viem_1.http)(),
         });
         return new CdpSmartWalletProvider({
             publicClient,
@@ -113,8 +113,8 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      */
     async exportWallet() {
         return {
-            name: __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f").name,
-            address: __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f").address,
+            name: this.smartAccount.name,
+            address: this.smartAccount.address,
             ownerAddress: __classPrivateFieldGet(this, _CdpSmartWalletProvider_ownerAccount, "f").address,
         };
     }
@@ -136,7 +136,7 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async signTypedData(typedData) {
         const { domain, types, primaryType, message } = typedData;
-        return await __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f").signTypedData({
+        return await this.smartAccount.signTypedData({
             domain,
             types,
             primaryType,
@@ -168,7 +168,7 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
             },
         ];
         const userOperation = await __classPrivateFieldGet(this, _CdpSmartWalletProvider_cdp, "f").evm.sendUserOperation({
-            smartAccount: __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f"),
+            smartAccount: this.smartAccount,
             network: __classPrivateFieldGet(this, _CdpSmartWalletProvider_instances, "m", _CdpSmartWalletProvider_getCdpSdkNetwork).call(this),
             calls,
             paymasterUrl: __classPrivateFieldGet(this, _CdpSmartWalletProvider_paymasterUrl, "f"),
@@ -181,7 +181,7 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * @returns The address of the smart wallet.
      */
     getAddress() {
-        return __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f").address;
+        return this.smartAccount.address;
     }
     /**
      * Gets the network of the wallet.
@@ -215,13 +215,21 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
     getPaymasterUrl() {
         return __classPrivateFieldGet(this, _CdpSmartWalletProvider_paymasterUrl, "f");
     }
+    /**
+     * Gets the Viem PublicClient used for read-only operations.
+     *
+     * @returns The Viem PublicClient instance used for read-only operations.
+     */
+    getPublicClient() {
+        return __classPrivateFieldGet(this, _CdpSmartWalletProvider_publicClient, "f");
+    }
     /**
      * Gets the balance of the smart wallet.
      *
      * @returns The balance of the wallet in wei
      */
     async getBalance() {
-        return await __classPrivateFieldGet(this, _CdpSmartWalletProvider_publicClient, "f").getBalance({ address: __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f").address });
+        return await __classPrivateFieldGet(this, _CdpSmartWalletProvider_publicClient, "f").getBalance({ address: this.smartAccount.address });
     }
     /**
      * Waits for a user operation receipt.
@@ -235,7 +243,7 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         // This is a simplified implementation - in practice you might want to poll
         // the CDP API for user operation status
         return __classPrivateFieldGet(this, _CdpSmartWalletProvider_cdp, "f").evm.waitForUserOperation({
-            smartAccountAddress: __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f").address,
+            smartAccountAddress: this.smartAccount.address,
             userOpHash,
         });
     }
@@ -264,7 +272,7 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
     }
 }
 exports.CdpSmartWalletProvider = CdpSmartWalletProvider;
-_CdpSmartWalletProvider_publicClient = new WeakMap(), _CdpSmartWalletProvider_smartAccount = new WeakMap(), _CdpSmartWalletProvider_ownerAccount = new WeakMap(), _CdpSmartWalletProvider_cdp = new WeakMap(), _CdpSmartWalletProvider_network = new WeakMap(), _CdpSmartWalletProvider_paymasterUrl = new WeakMap(), _CdpSmartWalletProvider_instances = new WeakSet(), _CdpSmartWalletProvider_getCdpSdkNetwork = function _CdpSmartWalletProvider_getCdpSdkNetwork() {
+_CdpSmartWalletProvider_publicClient = new WeakMap(), _CdpSmartWalletProvider_ownerAccount = new WeakMap(), _CdpSmartWalletProvider_cdp = new WeakMap(), _CdpSmartWalletProvider_network = new WeakMap(), _CdpSmartWalletProvider_paymasterUrl = new WeakMap(), _CdpSmartWalletProvider_instances = new WeakSet(), _CdpSmartWalletProvider_getCdpSdkNetwork = function _CdpSmartWalletProvider_getCdpSdkNetwork() {
     switch (__classPrivateFieldGet(this, _CdpSmartWalletProvider_network, "f").networkId) {
         case "base-sepolia":
             return "base-sepolia";

package/dist/wallet-providers/evmWalletProvider.d.ts

@@ -1,5 +1,5 @@
 import { WalletProvider } from "./walletProvider";
-import { TransactionRequest, ReadContractParameters, ReadContractReturnType, ContractFunctionName, Abi, ContractFunctionArgs, Account } from "viem";
+import { TransactionRequest, ReadContractParameters, ReadContractReturnType, ContractFunctionName, Abi, ContractFunctionArgs, Account, PublicClient } from "viem";
 /**
  * EvmWalletProvider is the abstract base class for all EVM wallet providers.
  *
@@ -54,4 +54,8 @@ export declare abstract class EvmWalletProvider extends WalletProvider {
      * @returns The response from the contract.
      */
     abstract readContract<const abi extends Abi | readonly unknown[], functionName extends ContractFunctionName<abi, "pure" | "view">, const args extends ContractFunctionArgs<abi, "pure" | "view", functionName>>(params: ReadContractParameters<abi, functionName, args>): Promise<ReadContractReturnType<abi, functionName, args>>;
+    /**
+     * Get the underlying Viem PublicClient for read-only blockchain operations.
+     */
+    abstract getPublicClient(): PublicClient;
 }

package/dist/wallet-providers/legacyCdpSmartWalletProvider.d.ts

@@ -1,5 +1,5 @@
 import { SendUserOperationOptions, Signer } from "@coinbase/coinbase-sdk";
-import { Abi, Address, ContractFunctionArgs, ContractFunctionName, Hex, ReadContractParameters, ReadContractReturnType, TransactionRequest } from "viem";
+import { Abi, Address, ContractFunctionArgs, ContractFunctionName, Hex, ReadContractParameters, ReadContractReturnType, TransactionRequest, PublicClient as ViemPublicClient } from "viem";
 import { Network } from "../network";
 import { EvmWalletProvider } from "./evmWalletProvider";
 export interface ConfigureLegacyCdpSmartWalletOptions {
@@ -9,6 +9,7 @@ export interface ConfigureLegacyCdpSmartWalletOptions {
     smartWalletAddress?: Hex;
     paymasterUrl?: string;
     signer: Signer;
+    rpcUrl?: string;
 }
 /**
  * A wallet provider that uses Smart Wallets from the Coinbase SDK.
@@ -146,6 +147,12 @@ export declare class LegacyCdpSmartWalletProvider extends EvmWalletProvider {
      * @returns The name of the wallet provider.
      */
     getName(): string;
+    /**
+     * Gets the Viem PublicClient used for read-only operations.
+     *
+     * @returns The Viem PublicClient instance used for read-only operations.
+     */
+    getPublicClient(): ViemPublicClient;
     /**
      * Gets the balance of the wallet.
      *

package/dist/wallet-providers/legacyCdpSmartWalletProvider.js

@@ -34,9 +34,10 @@ class LegacyCdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider
         _LegacyCdpSmartWalletProvider_publicClient.set(this, void 0);
         __classPrivateFieldSet(this, _LegacyCdpSmartWalletProvider_network, config.network, "f");
         __classPrivateFieldSet(this, _LegacyCdpSmartWalletProvider_smartWallet, config.smartWallet, "f");
+        const rpcUrl = config.rpcUrl || process.env.RPC_URL;
         __classPrivateFieldSet(this, _LegacyCdpSmartWalletProvider_publicClient, (0, viem_1.createPublicClient)({
             chain: network_1.NETWORK_ID_TO_VIEM_CHAIN[config.network.networkId],
-            transport: (0, viem_1.http)(),
+            transport: rpcUrl ? (0, viem_1.http)(rpcUrl) : (0, viem_1.http)(),
         }), "f");
     }
     /**
@@ -106,6 +107,7 @@ class LegacyCdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider
             smartWallet: networkScopedSmartWallet,
             network,
             chainId: network.chainId,
+            rpcUrl: config.rpcUrl,
         });
         return legacyCdpSmartWalletProvider;
     }
@@ -242,6 +244,14 @@ class LegacyCdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider
     getName() {
         return "legacy_cdp_smart_wallet_provider";
     }
+    /**
+     * Gets the Viem PublicClient used for read-only operations.
+     *
+     * @returns The Viem PublicClient instance used for read-only operations.
+     */
+    getPublicClient() {
+        return __classPrivateFieldGet(this, _LegacyCdpSmartWalletProvider_publicClient, "f");
+    }
     /**
      * Gets the balance of the wallet.
      *