@coinbase/agentkit 0.9.1 → 0.10.1

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_getCdpSdkNetwork;
+var _CdpSmartWalletProvider_publicClient, _CdpSmartWalletProvider_cdp, _CdpSmartWalletProvider_network, _CdpSmartWalletProvider_paymasterUrl;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CdpSmartWalletProvider = void 0;
 const cdp_sdk_1 = require("@coinbase/cdp-sdk");
@@ -28,17 +28,16 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      */
     constructor(config) {
         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);
-        __classPrivateFieldSet(this, _CdpSmartWalletProvider_smartAccount, config.smartAccount, "f");
-        __classPrivateFieldSet(this, _CdpSmartWalletProvider_ownerAccount, config.ownerAccount, "f");
+        _CdpSmartWalletProvider_paymasterUrl.set(this, void 0);
+        this.smartAccount = config.smartAccount;
+        this.ownerAccount = config.ownerAccount;
         __classPrivateFieldSet(this, _CdpSmartWalletProvider_cdp, config.cdp, "f");
         __classPrivateFieldSet(this, _CdpSmartWalletProvider_publicClient, config.publicClient, "f");
         __classPrivateFieldSet(this, _CdpSmartWalletProvider_network, config.network, "f");
+        __classPrivateFieldSet(this, _CdpSmartWalletProvider_paymasterUrl, config.paymasterUrl, "f");
     }
     /**
      * Configures a new CdpSmartWalletProvider with a smart wallet.
@@ -52,6 +51,7 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         const apiKeySecret = config.apiKeySecret || process.env.CDP_API_KEY_SECRET;
         const walletSecret = config.walletSecret || process.env.CDP_WALLET_SECRET;
         const idempotencyKey = config.idempotencyKey || process.env.IDEMPOTENCY_KEY;
+        const paymasterUrl = config.paymasterUrl || process.env.PAYMASTER_URL;
         if (!apiKeyId || !apiKeySecret || !walletSecret) {
             throw new Error("Missing required environment variables. CDP_API_KEY_ID, CDP_API_KEY_SECRET, CDP_WALLET_SECRET are required.");
         }
@@ -90,9 +90,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,
@@ -100,6 +101,7 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
             smartAccount,
             ownerAccount,
             network,
+            paymasterUrl,
         });
     }
     /**
@@ -109,9 +111,9 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      */
     async exportWallet() {
         return {
-            name: __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f").name,
-            address: __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f").address,
-            ownerAddress: __classPrivateFieldGet(this, _CdpSmartWalletProvider_ownerAccount, "f").address,
+            name: this.smartAccount.name,
+            address: this.smartAccount.address,
+            ownerAddress: this.ownerAccount.address,
         };
     }
     /**
@@ -132,12 +134,12 @@ 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,
             message,
-            network: __classPrivateFieldGet(this, _CdpSmartWalletProvider_instances, "m", _CdpSmartWalletProvider_getCdpSdkNetwork).call(this),
+            network: this.getCdpSdkNetwork(),
         });
     }
     /**
@@ -164,9 +166,10 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
             },
         ];
         const userOperation = await __classPrivateFieldGet(this, _CdpSmartWalletProvider_cdp, "f").evm.sendUserOperation({
-            smartAccount: __classPrivateFieldGet(this, _CdpSmartWalletProvider_smartAccount, "f"),
-            network: __classPrivateFieldGet(this, _CdpSmartWalletProvider_instances, "m", _CdpSmartWalletProvider_getCdpSdkNetwork).call(this),
+            smartAccount: this.smartAccount,
+            network: this.getCdpSdkNetwork(),
             calls,
+            paymasterUrl: __classPrivateFieldGet(this, _CdpSmartWalletProvider_paymasterUrl, "f"),
         });
         return userOperation.userOpHash;
     }
@@ -176,7 +179,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.
@@ -202,13 +205,29 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
     getClient() {
         return __classPrivateFieldGet(this, _CdpSmartWalletProvider_cdp, "f");
     }
+    /**
+     * Gets the paymaster URL for gasless transactions.
+     *
+     * @returns The paymaster URL if configured, undefined otherwise.
+     */
+    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.
@@ -222,7 +241,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,
         });
     }
@@ -239,7 +258,7 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * Transfer the native asset of the network using smart wallet.
      *
      * @param to - The destination address.
-     * @param value - The amount to transfer in Wei.
+     * @param value - The amount to transfer in atomic units (Wei).
      * @returns The user operation hash.
      */
     async nativeTransfer(to, value) {
@@ -249,15 +268,32 @@ class CdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
             data: "0x",
         });
     }
+    /**
+     * Converts the internal network ID to the format expected by the CDP SDK.
+     *
+     * @returns The network ID in CDP SDK format
+     * @throws Error if the network is not supported
+     */
+    getCdpSdkNetwork() {
+        switch (__classPrivateFieldGet(this, _CdpSmartWalletProvider_network, "f").networkId) {
+            case "base-sepolia":
+                return "base-sepolia";
+            case "base-mainnet":
+                return "base";
+            case "ethereum-mainnet":
+                return "ethereum";
+            case "ethereum-sepolia":
+                return "ethereum-sepolia";
+            case "polygon-mainnet":
+                return "polygon";
+            case "arbitrum-mainnet":
+                return "arbitrum";
+            case "optimism-mainnet":
+                return "optimism";
+            default:
+                throw new Error(`Unsupported network for smart wallets: ${__classPrivateFieldGet(this, _CdpSmartWalletProvider_network, "f").networkId}`);
+        }
+    }
 }
 exports.CdpSmartWalletProvider = CdpSmartWalletProvider;
-_CdpSmartWalletProvider_publicClient = new WeakMap(), _CdpSmartWalletProvider_smartAccount = new WeakMap(), _CdpSmartWalletProvider_ownerAccount = new WeakMap(), _CdpSmartWalletProvider_cdp = new WeakMap(), _CdpSmartWalletProvider_network = new WeakMap(), _CdpSmartWalletProvider_instances = new WeakSet(), _CdpSmartWalletProvider_getCdpSdkNetwork = function _CdpSmartWalletProvider_getCdpSdkNetwork() {
-    switch (__classPrivateFieldGet(this, _CdpSmartWalletProvider_network, "f").networkId) {
-        case "base-sepolia":
-            return "base-sepolia";
-        case "base-mainnet":
-            return "base";
-        default:
-            throw new Error(`Unsupported network for smart wallets: ${__classPrivateFieldGet(this, _CdpSmartWalletProvider_network, "f").networkId}`);
-    }
-};
+_CdpSmartWalletProvider_publicClient = new WeakMap(), _CdpSmartWalletProvider_cdp = new WeakMap(), _CdpSmartWalletProvider_network = new WeakMap(), _CdpSmartWalletProvider_paymasterUrl = new WeakMap();

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

@@ -113,7 +113,7 @@ export declare class CdpSolanaWalletProvider extends SvmWalletProvider implement
      * Transfer SOL from the wallet to another address
      *
      * @param to - The base58 encoded address to transfer the SOL to
-     * @param value - The amount of SOL to transfer (as a decimal string, e.g. "0.0001")
+     * @param value - The amount to transfer in atomic units (Lamports)
      * @returns The signature
      */
     nativeTransfer(to: string, value: string): Promise<string>;

package/dist/wallet-providers/cdpSolanaWalletProvider.js

@@ -147,12 +147,13 @@ class CdpSolanaWalletProvider extends svmWalletProvider_1.SvmWalletProvider {
     async signTransaction(transaction) {
         const serializedTransaction = transaction.serialize();
         const encodedSerializedTransaction = Buffer.from(serializedTransaction).toString("base64");
-        const signedTransaction = await __classPrivateFieldGet(this, _CdpSolanaWalletProvider_cdp, "f").solana.signTransaction({
+        const signedTransactionResponse = await __classPrivateFieldGet(this, _CdpSolanaWalletProvider_cdp, "f").solana.signTransaction({
             transaction: encodedSerializedTransaction,
             address: __classPrivateFieldGet(this, _CdpSolanaWalletProvider_serverAccount, "f").address,
         });
-        transaction.addSignature(this.getPublicKey(), Buffer.from(signedTransaction.signature, "base64"));
-        return transaction;
+        const signedTransactionBytes = Buffer.from(signedTransactionResponse.signedTransaction, "base64");
+        const signedTransaction = web3_js_1.VersionedTransaction.deserialize(signedTransactionBytes);
+        return signedTransaction;
     }
     /**
      * Send a transaction
@@ -219,16 +220,15 @@ class CdpSolanaWalletProvider extends svmWalletProvider_1.SvmWalletProvider {
      * Transfer SOL from the wallet to another address
      *
      * @param to - The base58 encoded address to transfer the SOL to
-     * @param value - The amount of SOL to transfer (as a decimal string, e.g. "0.0001")
+     * @param value - The amount to transfer in atomic units (Lamports)
      * @returns The signature
      */
     async nativeTransfer(to, value) {
         const initialBalance = await this.getBalance();
-        const solAmount = parseFloat(value);
-        const lamports = BigInt(Math.floor(solAmount * web3_js_1.LAMPORTS_PER_SOL));
+        const lamports = BigInt(value);
         // Check if we have enough balance (including estimated fees)
         if (initialBalance < lamports + BigInt(5000)) {
-            throw new Error(`Insufficient balance. Have ${Number(initialBalance) / web3_js_1.LAMPORTS_PER_SOL} SOL, need ${solAmount + 0.000005} SOL (including fees)`);
+            throw new Error(`Insufficient balance. Have ${Number(initialBalance)} lamports, need ${Number(lamports) + 5000} lamports (including fees)`);
         }
         const toPubkey = new web3_js_1.PublicKey(to);
         const instructions = [

package/dist/wallet-providers/cdpSolanaWalletProvider.test.js

@@ -29,13 +29,16 @@ jest.mock("@solana/web3.js", () => {
     };
     const MockPublicKey = jest.fn(() => mockPublicKey);
     MockPublicKey.prototype = mockPublicKey;
+    const mockVersionedTransaction = {
+        serialize: jest.fn(() => Buffer.from("mock-serialized-tx")),
+        addSignature: jest.fn(),
+    };
+    const MockVersionedTransaction = jest.fn(() => mockVersionedTransaction);
+    MockVersionedTransaction.deserialize = jest.fn(() => mockVersionedTransaction);
     return {
         Connection: jest.fn(() => mockConnection),
         PublicKey: MockPublicKey,
-        VersionedTransaction: jest.fn().mockImplementation(() => ({
-            serialize: jest.fn(() => Buffer.from("mock-serialized-tx")),
-            addSignature: jest.fn(),
-        })),
+        VersionedTransaction: MockVersionedTransaction,
         MessageV0: {
             compile: jest.fn(),
         },
@@ -69,9 +72,9 @@ jest.mock("@coinbase/cdp-sdk", () => {
         address: MOCK_ADDRESS,
         signTransaction: jest.fn().mockResolvedValue({ signature: MOCK_SIGNATURE }),
     }));
-    const mockSignTransaction = jest
-        .fn()
-        .mockImplementation(async () => ({ signature: MOCK_SIGNATURE }));
+    const mockSignTransaction = jest.fn().mockImplementation(async () => ({
+        signedTransaction: Buffer.from("mock-signed-transaction").toString("base64"),
+    }));
     const mockSolanaClient = {
         createAccount: mockCreateAccount,
         getAccount: jest.fn(),
@@ -122,9 +125,9 @@ describe("CdpSolanaWalletProvider", () => {
         };
         // Set up the mock server account for the provider
         mockCdpClient.solana.createAccount.mockResolvedValue(mockServerAccount);
-        mockCdpClient.solana.signTransaction = jest
-            .fn()
-            .mockResolvedValue({ signature: MOCK_SIGNATURE });
+        mockCdpClient.solana.signTransaction = jest.fn().mockResolvedValue({
+            signedTransaction: Buffer.from("mock-signed-transaction").toString("base64"),
+        });
         mockConnection.getBalance.mockResolvedValue(Number(MOCK_BALANCE));
         mockConnection.getLatestBlockhash.mockResolvedValue({
             blockhash: "test-blockhash",
@@ -285,7 +288,7 @@ describe("CdpSolanaWalletProvider", () => {
     describe("native transfer", () => {
         it("should transfer SOL", async () => {
             const toAddress = "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin";
-            const amount = "1.0";
+            const amount = "1000000000"; // 1 SOL in lamports
             // Set a balance that's high enough to cover the transfer + fees
             mockConnection.getBalance.mockResolvedValueOnce(Number(2000000000n)); // 2 SOL
             const signature = await provider.nativeTransfer(toAddress, amount);
@@ -295,7 +298,7 @@ describe("CdpSolanaWalletProvider", () => {
         it("should handle insufficient balance", async () => {
             mockConnection.getBalance.mockResolvedValueOnce(Number(1000000n)); // 0.001 SOL
             const toAddress = "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin";
-            const amount = "1.0";
+            const amount = "1000000000"; // 1 SOL in lamports
             await expect(provider.nativeTransfer(toAddress, amount)).rejects.toThrow("Insufficient balance");
         });
         it("should handle invalid address", async () => {

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.
      *
@@ -170,7 +177,7 @@ export declare class LegacyCdpSmartWalletProvider extends EvmWalletProvider {
      * Transfer the native asset of the network.
      *
      * @param to - The destination address.
-     * @param value - The amount to transfer in Wei.
+     * @param value - The amount to transfer in atomic units (Wei).
      * @returns The transaction hash.
      */
     nativeTransfer(to: Address, value: string): Promise<Hex>;

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.
      *
@@ -278,7 +288,7 @@ class LegacyCdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider
      * Transfer the native asset of the network.
      *
      * @param to - The destination address.
-     * @param value - The amount to transfer in Wei.
+     * @param value - The amount to transfer in atomic units (Wei).
      * @returns The transaction hash.
      */
     async nativeTransfer(to, value) {

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

@@ -1,4 +1,4 @@
-import { ReadContractParameters, ReadContractReturnType, TransactionRequest, TransactionSerializable, Abi, ContractFunctionName, ContractFunctionArgs, Address, Hex } from "viem";
+import { ReadContractParameters, ReadContractReturnType, TransactionRequest, TransactionSerializable, PublicClient, Abi, ContractFunctionName, ContractFunctionArgs, Address, Hex } from "viem";
 import { EvmWalletProvider } from "./evmWalletProvider";
 import { Network } from "../network";
 import { Coinbase, CreateERC20Options, CreateTradeOptions, SmartContract, Trade, Wallet, WalletData } from "@coinbase/coinbase-sdk";
@@ -50,6 +50,10 @@ export interface LegacyCdpWalletProviderConfig extends LegacyCdpProviderConfig {
          */
         feePerGasMultiplier?: number;
     };
+    /**
+     * Optional RPC URL for Viem public client.
+     */
+    rpcUrl?: string;
 }
 /**
  * Configuration options for the CDP Agentkit with a Wallet.
@@ -148,6 +152,12 @@ export declare class LegacyCdpWalletProvider 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(): PublicClient;
     /**
      * Gets the balance of the wallet.
      *
@@ -221,7 +231,7 @@ export declare class LegacyCdpWalletProvider extends EvmWalletProvider {
      * Transfer the native asset of the network.
      *
      * @param to - The destination address.
-     * @param value - The amount to transfer in Wei.
+     * @param value - The amount to transfer in atomic units (Wei).
      * @returns The transaction hash.
      */
     nativeTransfer(to: `0x${string}`, value: string): Promise<`0x${string}`>;

package/dist/wallet-providers/legacyCdpWalletProvider.js

@@ -43,9 +43,10 @@ class LegacyCdpWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         __classPrivateFieldSet(this, _LegacyCdpWalletProvider_cdpWallet, config.wallet, "f");
         __classPrivateFieldSet(this, _LegacyCdpWalletProvider_address, config.address, "f");
         __classPrivateFieldSet(this, _LegacyCdpWalletProvider_network, config.network, "f");
+        const rpcUrl = config.rpcUrl || process.env.RPC_URL;
         __classPrivateFieldSet(this, _LegacyCdpWalletProvider_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");
         __classPrivateFieldSet(this, _LegacyCdpWalletProvider_gasLimitMultiplier, Math.max(config.gas?.gasLimitMultiplier ?? 1.2, 1), "f");
         __classPrivateFieldSet(this, _LegacyCdpWalletProvider_feePerGasMultiplier, Math.max(config.gas?.feePerGasMultiplier ?? 1, 1), "f");
@@ -268,6 +269,14 @@ class LegacyCdpWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
     getName() {
         return "legacy_cdp_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, _LegacyCdpWalletProvider_publicClient, "f");
+    }
     /**
      * Gets the balance of the wallet.
      *
@@ -363,7 +372,7 @@ class LegacyCdpWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * Transfer the native asset of the network.
      *
      * @param to - The destination address.
-     * @param value - The amount to transfer in Wei.
+     * @param value - The amount to transfer in atomic units (Wei).
      * @returns The transaction hash.
      */
     async nativeTransfer(to, value) {

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

@@ -1,4 +1,4 @@
-import { Abi, ContractFunctionArgs, ContractFunctionName, Hex, ReadContractParameters, ReadContractReturnType, TransactionReceipt, TransactionRequest } from "viem";
+import { Abi, ContractFunctionArgs, ContractFunctionName, Hex, PublicClient, ReadContractParameters, ReadContractReturnType, TransactionReceipt, TransactionRequest } from "viem";
 import { Network } from "../network";
 import { PrivyWalletConfig, PrivyWalletExport } from "./privyShared";
 import { WalletProvider } from "./walletProvider";
@@ -14,6 +14,8 @@ export interface PrivyEvmDelegatedEmbeddedWalletConfig extends PrivyWalletConfig
     chainId?: string;
     /** The wallet type to use */
     walletType: "embedded";
+    /** Optional RPC URL for Viem public client */
+    rpcUrl?: string;
 }
 /**
  * A wallet provider that uses Privy's embedded wallets with delegation.
@@ -64,6 +66,12 @@ export declare class PrivyEvmDelegatedEmbeddedWalletProvider extends WalletProvi
      * @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(): PublicClient;
     /**
      * Gets the balance of the wallet.
      *
@@ -132,7 +140,7 @@ export declare class PrivyEvmDelegatedEmbeddedWalletProvider extends WalletProvi
      * Transfer the native asset of the network.
      *
      * @param to - The destination address.
-     * @param value - The amount to transfer in Wei.
+     * @param value - The amount to transfer in atomic units (Wei).
      * @returns The transaction hash.
      */
     nativeTransfer(to: string, value: string): Promise<Hex>;

package/dist/wallet-providers/privyEvmDelegatedEmbeddedWalletProvider.js

@@ -59,9 +59,10 @@ class PrivyEvmDelegatedEmbeddedWalletProvider extends walletProvider_1.WalletPro
         if (!chain) {
             throw new Error(`Chain with ID ${chainId} not found`);
         }
+        const rpcUrl = config.rpcUrl || process.env.RPC_URL;
         __classPrivateFieldSet(this, _PrivyEvmDelegatedEmbeddedWalletProvider_publicClient, (0, viem_1.createPublicClient)({
             chain,
-            transport: (0, viem_1.http)(),
+            transport: rpcUrl ? (0, viem_1.http)(rpcUrl) : (0, viem_1.http)(),
         }), "f");
     }
     /**
@@ -142,6 +143,14 @@ class PrivyEvmDelegatedEmbeddedWalletProvider extends walletProvider_1.WalletPro
     getName() {
         return "privy_evm_embedded_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, _PrivyEvmDelegatedEmbeddedWalletProvider_publicClient, "f");
+    }
     /**
      * Gets the balance of the wallet.
      *
@@ -306,11 +315,11 @@ class PrivyEvmDelegatedEmbeddedWalletProvider extends walletProvider_1.WalletPro
      * Transfer the native asset of the network.
      *
      * @param to - The destination address.
-     * @param value - The amount to transfer in Wei.
+     * @param value - The amount to transfer in atomic units (Wei).
      * @returns The transaction hash.
      */
     async nativeTransfer(to, value) {
-        const valueInWei = (0, viem_1.parseEther)(value);
+        const valueInWei = BigInt(value);
         const valueHex = `0x${valueInWei.toString(16)}`;
         const body = {
             address: __classPrivateFieldGet(this, _PrivyEvmDelegatedEmbeddedWalletProvider_address, "f"),

package/dist/wallet-providers/privyEvmDelegatedEmbeddedWalletProvider.test.js

@@ -211,7 +211,7 @@ describe("PrivyEvmDelegatedEmbeddedWalletProvider", () => {
             });
         });
         it("should transfer native tokens", async () => {
-            const result = await provider.nativeTransfer("0x1234567890123456789012345678901234567890", "1.0");
+            const result = await provider.nativeTransfer("0x1234567890123456789012345678901234567890", "1000000000000000000");
             expect(result).toBe(MOCK_TRANSACTION_HASH);
         });
         it("should export wallet data", () => {

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

@@ -8,6 +8,8 @@ import { PrivyWalletConfig, PrivyWalletExport } from "./privyShared";
 export interface PrivyEvmWalletConfig extends PrivyWalletConfig {
     /** Optional chain ID to connect to */
     chainId?: string;
+    /** Optional RPC URL override for Viem wallet/public clients */
+    rpcUrl?: string;
 }
 /**
  * A wallet provider that uses Privy's server wallet API.

package/dist/wallet-providers/privyEvmWalletProvider.js

@@ -107,10 +107,11 @@ class PrivyEvmWalletProvider extends viemWalletProvider_1.ViemWalletProvider {
         if (!chain) {
             throw new Error(`Chain with ID ${chainId} not found`);
         }
+        const rpcUrl = config.rpcUrl || process.env.RPC_URL;
         const walletClient = (0, viem_2.createWalletClient)({
             account,
             chain,
-            transport: (0, viem_2.http)(),
+            transport: rpcUrl ? (0, viem_2.http)(rpcUrl) : (0, viem_2.http)(),
         });
         return new PrivyEvmWalletProvider(walletClient, { ...config, walletId });
     }

package/dist/wallet-providers/privyEvmWalletProvider.test.js

@@ -272,7 +272,7 @@ describe("PrivyEvmWalletProvider", () => {
             expect(result).toBe("mock_result");
         });
         it("should transfer native tokens", async () => {
-            const result = await provider.nativeTransfer("0x1234567890123456789012345678901234567890", "1.0");
+            const result = await provider.nativeTransfer("0x1234567890123456789012345678901234567890", "1000000000000000000");
             expect(result).toBe(MOCK_TRANSACTION_HASH);
         });
         it("should export wallet data", () => {

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

@@ -129,7 +129,7 @@ export declare class SolanaKeypairWalletProvider extends SvmWalletProvider {
      * Transfer SOL from the wallet to another address
      *
      * @param to - The base58 encoded address to transfer the SOL to
-     * @param value - The amount of SOL to transfer (as a decimal string, e.g. "0.0001")
+     * @param value - The amount to transfer in atomic units (Lamports)
      * @returns The signature
      */
     nativeTransfer(to: string, value: string): Promise<string>;

package/dist/wallet-providers/solanaKeypairWalletProvider.js

@@ -231,16 +231,15 @@ class SolanaKeypairWalletProvider extends svmWalletProvider_1.SvmWalletProvider
      * Transfer SOL from the wallet to another address
      *
      * @param to - The base58 encoded address to transfer the SOL to
-     * @param value - The amount of SOL to transfer (as a decimal string, e.g. "0.0001")
+     * @param value - The amount to transfer in atomic units (Lamports)
      * @returns The signature
      */
     async nativeTransfer(to, value) {
         const initialBalance = await this.getBalance();
-        const solAmount = parseFloat(value);
-        const lamports = BigInt(Math.floor(solAmount * web3_js_1.LAMPORTS_PER_SOL));
+        const lamports = BigInt(value);
         // Check if we have enough balance (including estimated fees)
         if (initialBalance < lamports + BigInt(5000)) {
-            throw new Error(`Insufficient balance. Have ${Number(initialBalance) / web3_js_1.LAMPORTS_PER_SOL} SOL, need ${solAmount + 0.000005} SOL (including fees)`);
+            throw new Error(`Insufficient balance. Have ${Number(initialBalance)} lamports, need ${Number(lamports) + 5000} lamports (including fees)`);
         }
         const toPubkey = new web3_js_1.PublicKey(to);
         const instructions = [