@coinbase/agentkit 0.10.0 → 0.10.2

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.
@@ -46,6 +47,15 @@ export declare class LegacyCdpSmartWalletProvider extends EvmWalletProvider {
      * ```
      */
     static configureWithWallet(config: ConfigureLegacyCdpSmartWalletOptions): Promise<LegacyCdpSmartWalletProvider>;
+    /**
+     * Stub for hash signing
+     *
+     * @throws as signing hashes is not implemented for SmartWallets.
+     *
+     * @param _ - The hash to sign.
+     * @returns The signed hash.
+     */
+    sign(_: `0x${string}`): Promise<Hex>;
     /**
      * Stub for message signing
      *
@@ -146,6 +156,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 +186,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,9 +107,21 @@ class LegacyCdpSmartWalletProvider extends evmWalletProvider_1.EvmWalletProvider
             smartWallet: networkScopedSmartWallet,
             network,
             chainId: network.chainId,
+            rpcUrl: config.rpcUrl,
         });
         return legacyCdpSmartWalletProvider;
     }
+    /**
+     * Stub for hash signing
+     *
+     * @throws as signing hashes is not implemented for SmartWallets.
+     *
+     * @param _ - The hash to sign.
+     * @returns The signed hash.
+     */
+    async sign(_) {
+        throw new Error("Not implemented");
+    }
     /**
      * Stub for message signing
      *
@@ -242,6 +255,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 +299,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.
@@ -85,6 +89,13 @@ export declare class LegacyCdpWalletProvider extends EvmWalletProvider {
      * @throws Error if required environment variables are missing or wallet initialization fails
      */
     static configureWithWallet(config?: ConfigureLegacyCdpAgentkitWithWalletOptions): Promise<LegacyCdpWalletProvider>;
+    /**
+     * Signs a raw hash.
+     *
+     * @param hash - The hash to sign.
+     * @returns The signed hash.
+     */
+    sign(hash: `0x${string}`): Promise<`0x${string}`>;
     /**
      * Signs a message.
      *
@@ -148,6 +159,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 +238,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");
@@ -105,6 +106,22 @@ class LegacyCdpWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         });
         return cdpWalletProvider;
     }
+    /**
+     * Signs a raw hash.
+     *
+     * @param hash - The hash to sign.
+     * @returns The signed hash.
+     */
+    async sign(hash) {
+        if (!__classPrivateFieldGet(this, _LegacyCdpWalletProvider_cdpWallet, "f")) {
+            throw new Error("Wallet not initialized");
+        }
+        const payload = await __classPrivateFieldGet(this, _LegacyCdpWalletProvider_cdpWallet, "f").createPayloadSignature(hash);
+        if (payload.getStatus() === "pending" && payload?.wait) {
+            await payload.wait(); // needed for Server-Signers
+        }
+        return payload.getSignature();
+    }
     /**
      * Signs a message.
      *
@@ -268,6 +285,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 +388,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/legacyCdpWalletProvider.test.js

@@ -268,6 +268,12 @@ describe("LegacyCdpWalletProvider", () => {
     // signing operation tests
     // =========================================================
     describe("signing operations", () => {
+        it("should sign a hash", async () => {
+            const testHash = "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef";
+            const signature = await provider.sign(testHash);
+            expect(mockWalletObj.createPayloadSignature).toHaveBeenCalledWith(testHash);
+            expect(signature).toBe(MOCK_SIGNATURE);
+        });
         it("should sign messages", async () => {
             const signature = await provider.signMessage("Hello, world!");
             expect(mockWalletObj.createPayloadSignature).toHaveBeenCalled();

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,12 +66,25 @@ 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.
      *
      * @returns The balance of the wallet in wei
      */
     getBalance(): Promise<bigint>;
+    /**
+     * Signs a raw hash.
+     *
+     * @param hash - The hash to sign.
+     * @returns The signed hash.
+     */
+    sign(hash: `0x${string}`): Promise<Hex>;
     /**
      * Signs a message.
      *
@@ -132,7 +147,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.
      *
@@ -161,6 +170,33 @@ class PrivyEvmDelegatedEmbeddedWalletProvider extends walletProvider_1.WalletPro
             throw new Error("Error getting balance");
         }
     }
+    /**
+     * Signs a raw hash.
+     *
+     * @param hash - The hash to sign.
+     * @returns The signed hash.
+     */
+    async sign(hash) {
+        const body = {
+            address: __classPrivateFieldGet(this, _PrivyEvmDelegatedEmbeddedWalletProvider_address, "f"),
+            chain_type: "ethereum",
+            method: "personal_sign",
+            params: {
+                message: hash,
+                encoding: "hex",
+            },
+        };
+        try {
+            const response = await this.executePrivyRequest(body);
+            return response.data?.signature;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Hash signing failed: ${error.message}`);
+            }
+            throw new Error("Hash signing failed");
+        }
+    }
     /**
      * Signs a message.
      *
@@ -306,11 +342,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

@@ -14,6 +14,10 @@ const MOCK_TRANSACTION_HASH = "0xef01";
 const MOCK_SIGNATURE_HASH_1 = "0x1234";
 const MOCK_SIGNATURE_HASH_2 = "0x5678";
 const MOCK_SIGNATURE_HASH_3 = "0xabcd";
+const MOCK_HASH_SIGNATURE = "0xhash";
+jest.mock("../analytics", () => ({
+    sendAnalyticsEvent: jest.fn().mockImplementation(() => Promise.resolve()),
+}));
 jest.mock("@privy-io/server-auth", () => ({
     PrivyClient: jest.fn().mockImplementation(() => ({
         appId: "mock-app-id",
@@ -65,6 +69,7 @@ jest.mock("@privy-io/server-auth/viem", () => ({
     createViemAccount: jest.fn().mockResolvedValue({
         address: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
         type: "local",
+        sign: jest.fn().mockResolvedValue("0xhash"),
         signMessage: jest.fn().mockResolvedValue("0x1234"),
         signTypedData: jest.fn().mockResolvedValue("0x5678"),
         signTransaction: jest.fn().mockResolvedValue("0xabcd"),
@@ -120,6 +125,7 @@ jest.mock("viem", () => {
         createWalletClient: jest.fn().mockReturnValue({
             account: {
                 address: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
+                sign: jest.fn().mockResolvedValue("0xhash"),
             },
             chain: {
                 id: 1,
@@ -214,6 +220,11 @@ describe("PrivyEvmWalletProvider", () => {
         it("should get the provider name", () => {
             expect(provider.getName()).toBe("privy_evm_wallet_provider");
         });
+        it("should sign a hash", async () => {
+            const testHash = "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef";
+            const result = await provider.sign(testHash);
+            expect(result).toBe(MOCK_HASH_SIGNATURE);
+        });
         it("should sign a message", async () => {
             const result = await provider.signMessage("Hello, world!");
             expect(result).toBe(MOCK_SIGNATURE_HASH_1);
@@ -272,7 +283,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 = [

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

@@ -183,14 +183,16 @@ describe("SolanaKeypairWalletProvider", () => {
         });
         it("should transfer native tokens", async () => {
             const destination = "EQJqzeeVEnm8rKWQJ5SMTtQBD4xEgixwgzNWKkpeFRZ9";
-            const signature = await wallet.nativeTransfer(destination, "0.1");
+            const signature = await wallet.nativeTransfer(destination, "100000000"); // 0.1 SOL in lamports
             expect(signature).toBe("signature123");
         });
         it("should handle insufficient balance when transferring", async () => {
             const connection = wallet.getConnection();
             connection.getBalance.mockResolvedValueOnce(100);
             const destination = "EQJqzeeVEnm8rKWQJ5SMTtQBD4xEgixwgzNWKkpeFRZ9";
-            await expect(wallet.nativeTransfer(destination, "1.0")).rejects.toThrow("Insufficient balance");
+            await expect(wallet.nativeTransfer(destination, "1000000000")).rejects.toThrow(
+            // 1 SOL in lamports
+            "Insufficient balance");
         });
         it("should handle transaction failure when sending", async () => {
             const connection = wallet.getConnection();

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

@@ -1,4 +1,4 @@
-import { WalletClient as ViemWalletClient, TransactionRequest, ReadContractParameters, ReadContractReturnType, Abi, ContractFunctionName, ContractFunctionArgs } from "viem";
+import { WalletClient as ViemWalletClient, TransactionRequest, PublicClient as ViemPublicClient, ReadContractParameters, ReadContractReturnType, Abi, ContractFunctionName, ContractFunctionArgs } from "viem";
 import { EvmWalletProvider } from "./evmWalletProvider";
 import { Network } from "../network";
 /**
@@ -13,6 +13,10 @@ export interface ViemWalletProviderGasConfig {
      * An internal multiplier on fee per gas estimation.
      */
     feePerGasMultiplier?: number;
+    /**
+     * Optional RPC URL override for Viem public client.
+     */
+    rpcUrl?: string;
 }
 /**
  * A wallet provider that uses the Viem library.
@@ -26,13 +30,20 @@ export declare class ViemWalletProvider extends EvmWalletProvider {
      * @param gasConfig - Configuration for gas multipliers.
      */
     constructor(walletClient: ViemWalletClient, gasConfig?: ViemWalletProviderGasConfig);
+    /**
+     * Signs a raw hash.
+     *
+     * @param hash - The hash to sign.
+     * @returns The signed hash.
+     */
+    sign(hash: `0x${string}`): Promise<`0x${string}`>;
     /**
      * Signs a message.
      *
      * @param message - The message to sign.
      * @returns The signed message.
      */
-    signMessage(message: string): Promise<`0x${string}`>;
+    signMessage(message: string | Uint8Array): Promise<`0x${string}`>;
     /**
      * Signs a typed data object.
      *
@@ -72,6 +83,12 @@ export declare class ViemWalletProvider 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.
      *
@@ -96,7 +113,7 @@ export declare class ViemWalletProvider extends EvmWalletProvider {
      * Transfer the native asset of the network.
      *
      * @param to - The destination address.
-     * @param value - The amount to transfer in whole units (e.g. ETH)
+     * @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/viemWalletProvider.js

@@ -36,13 +36,30 @@ class ViemWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         _ViemWalletProvider_gasLimitMultiplier.set(this, void 0);
         _ViemWalletProvider_feePerGasMultiplier.set(this, void 0);
         __classPrivateFieldSet(this, _ViemWalletProvider_walletClient, walletClient, "f");
+        const rpcUrl = gasConfig?.rpcUrl || process.env.RPC_URL;
         __classPrivateFieldSet(this, _ViemWalletProvider_publicClient, (0, viem_1.createPublicClient)({
             chain: walletClient.chain,
-            transport: (0, viem_1.http)(),
+            transport: rpcUrl ? (0, viem_1.http)(rpcUrl) : (0, viem_1.http)(),
         }), "f");
         __classPrivateFieldSet(this, _ViemWalletProvider_gasLimitMultiplier, Math.max(gasConfig?.gasLimitMultiplier ?? 1.2, 1), "f");
         __classPrivateFieldSet(this, _ViemWalletProvider_feePerGasMultiplier, Math.max(gasConfig?.feePerGasMultiplier ?? 1, 1), "f");
     }
+    /**
+     * Signs a raw hash.
+     *
+     * @param hash - The hash to sign.
+     * @returns The signed hash.
+     */
+    async sign(hash) {
+        const account = __classPrivateFieldGet(this, _ViemWalletProvider_walletClient, "f").account;
+        if (!account) {
+            throw new Error("Account not found");
+        }
+        if (!account.sign) {
+            throw new Error("Account does not support raw hash signing");
+        }
+        return account.sign({ hash });
+    }
     /**
      * Signs a message.
      *
@@ -54,7 +71,11 @@ class ViemWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
         if (!account) {
             throw new Error("Account not found");
         }
-        return __classPrivateFieldGet(this, _ViemWalletProvider_walletClient, "f").signMessage({ account, message });
+        const _message = typeof message === "string" ? ((0, viem_1.isHex)(message) ? message : (0, viem_1.toHex)(message)) : message;
+        return __classPrivateFieldGet(this, _ViemWalletProvider_walletClient, "f").signMessage({
+            account,
+            message: { raw: _message },
+        });
     }
     /**
      * Signs a typed data object.
@@ -152,6 +173,14 @@ class ViemWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
     getName() {
         return "viem_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, _ViemWalletProvider_publicClient, "f");
+    }
     /**
      * Gets the balance of the wallet.
      *
@@ -186,11 +215,11 @@ class ViemWalletProvider extends evmWalletProvider_1.EvmWalletProvider {
      * Transfer the native asset of the network.
      *
      * @param to - The destination address.
-     * @param value - The amount to transfer in whole units (e.g. ETH)
+     * @param value - The amount to transfer in atomic units (Wei)
      * @returns The transaction hash.
      */
     async nativeTransfer(to, value) {
-        const atomicAmount = (0, viem_1.parseEther)(value);
+        const atomicAmount = BigInt(value);
         const tx = await this.sendTransaction({
             to: to,
             value: atomicAmount,