@tuwaio/orbit-evm 0.2.21 → 0.3.0

package/README.md

@@ -3,15 +3,17 @@
 [![NPM Version](https://img.shields.io/npm/v/@tuwaio/orbit-evm.svg)](https://www.npmjs.com/package/@tuwaio/orbit-evm)
 [![License](https://img.shields.io/npm/l/@tuwaio/orbit-evm.svg)](./LICENSE)
 
-`@tuwaio/orbit-evm` provides concrete implementations of low-level EVM-specific communication primitives for Layer 2 (L2) of the TUWA Orbit stack. Engineered strictly on top of **`@wagmi/core`** and **`viem`**, this package provides deterministic chain switching, custom Viem client generation, and cached ENS metadata resolution, while enforcing a complete exclusion of legacy libraries like `ethers.js` or `web3.js`.
+`@tuwaio/orbit-evm` provides concrete implementations of low-level EVM-specific communication primitives for Layer 2 (L2) of the TUWA Orbit stack. Engineered strictly on top of **`@wagmi/core`** and **`viem`**, this package provides deterministic chain switching, custom Viem client generation, cached ENS metadata resolution, and full ERC-4337 Account Abstraction orchestration via Pimlico and Solady smart accounts. It enforces a complete exclusion of legacy libraries like `ethers.js` or `web3.js`.
 
 ---
 
 ## 🏛️ Core Capabilities
 
 - **Viem Client Optimization:** Creates and caches high-performance `viem` public clients (`createViemClient`) to minimize request latency and avoid duplicate RPC instantiation.
-- **ENS Metadata Engine:** Direct lookup utilities (`getName`, `getAvatar`, `getAddress`) on the Ethereum Mainnet context with local caching.
-- **Deterministic Chain Switching:** Low-level utility (`checkAndSwitchChain`) to enforce network alignment with the target blockchain, requesting wallet configurations dynamically.
+- **ERC-4337 Account Abstraction (Pimlico & Solady):** High-level client factory (`createPimlicoSmartAccountClient`) and Solady smart account instantiation (`createSoladySmartAccount`) with automatic gas sponsorship (`createPimlicoPaymasterClient`).
+- **Deterministic Solady Salt Generation:** Generates right-padded 32-byte salts (`pad(ownerAddress, { dir: 'right', size: 32 })`) compliant with the Solady ERC-4337 factory prefix requirements, preventing `SaltDoesNotStartWith()` exceptions and multi-user address collisions.
+- **ENS Metadata Engine:** Direct lookup utilities (`getName`, `getAvatar`, `getAddress`) on Ethereum Mainnet with local in-memory caching.
+- **Deterministic Chain Switching:** Low-level utility (`checkAndSwitchChain`) to enforce network alignment with the target blockchain.
 - **Strict Compile-Time Types:** Fully integrated with TypeScript standards v5.9+ and native Viem/Wagmi typings.
 
 ---
@@ -22,8 +24,14 @@
 pnpm add @tuwaio/orbit-evm @wagmi/core viem
 ```
 
+If using `@tuwaio/orbit-core` adapters and type definitions alongside EVM primitives:
+
+```bash
+pnpm add @tuwaio/orbit-evm @tuwaio/orbit-core @wagmi/core viem
+```
+
 > [!IMPORTANT]
-> `@wagmi/core` and `viem` are peer dependencies and must be installed alongside `@tuwaio/orbit-evm`.
+> `@wagmi/core` (v3.x) and `viem` (v2.x) are peer dependencies and must be installed alongside `@tuwaio/orbit-evm`.
 
 ---
 
@@ -61,14 +69,70 @@ async function switchNetwork(targetChainId: number) {
 }
 ```
 
+### ERC-4337 Smart Account Client (Pimlico & Solady)
+
+Instantiate a fully configured Solady smart account client with automated Pimlico bundler and paymaster sponsorship:
+
+```typescript
+import { createPimlicoSmartAccountClient } from '@tuwaio/orbit-evm';
+import { sepolia } from 'viem/chains';
+import { type Config } from '@wagmi/core';
+
+declare const wagmiConfig: Config;
+
+async function initializeSmartAccount() {
+  const { account, bundlerClient, publicClient, paymasterClient } = await createPimlicoSmartAccountClient({
+    chain: sepolia,
+    wagmiConfig,
+    apiKey: process.env.NEXT_PUBLIC_PIMLICO_API_KEY, // or custom bundlerUrl
+    sponsor: true, // Enables Pimlico paymaster gas sponsorship
+  });
+
+  console.log('Solady Smart Account counterfactual address:', account.address);
+  return { account, bundlerClient, publicClient };
+}
+```
+
+#### Solady Salt Padding Rule
+
+When deploying Solady smart accounts, the factory requires the salt to be prefixed with the EOA owner's 20-byte address. To guarantee a deterministic 32-byte representation without failing Solady's `SaltDoesNotStartWith()` check, `createSoladySmartAccount` defaults to right-padding:
+
+```typescript
+import { pad } from 'viem';
+
+// Deterministic salt ensuring owner prefix alignment
+const accountSalt = pad(ownerAccount.address, { dir: 'right', size: 32 });
+```
+
+### Low-Level Pimlico Bundler Client & RPC URL
+
+Instantiate and cache Viem Bundler clients with automated Pimlico URL resolution:
+
+```typescript
+import { createBundlerRpcClient, createPimlicoRpcUrl } from '@tuwaio/orbit-evm';
+
+// Generate or retrieve cached Pimlico RPC endpoint
+const rpcUrl = createPimlicoRpcUrl({
+  chainId: 11155111,
+  apiKey: 'pim_test_key_123',
+});
+
+// Retrieve cached or new Viem Bundler Client (with in-memory cache)
+const bundlerClient = createBundlerRpcClient({
+  chainId: 11155111,
+  apiKey: 'pim_test_key_123',
+});
+```
+
 ---
 
 ## 🔧 API & Module Architecture
 
 `@tuwaio/orbit-evm` exposes the following modules:
 
-- **Chain Alignment:** `checkAndSwitchChain`.
-- **Client Factory:** `createViemClient`.
+- **ERC-4337 Account Abstraction:** `createPimlicoSmartAccountClient`, `createSoladySmartAccount`, `createPimlicoPaymasterClient`, `createPimlicoRpcUrl`, `createBundlerRpcClient`, `clearBundlerCache`.
+- **Chain Alignment:** `checkAndSwitchChain`, `normalizeChainId`.
+- **Client Factory:** `createViemClient`, `clearViemClientCache`.
 - **ENS Resolvers:** `getAddress`, `getAvatar`, `getName`, `isEnsName`.
 
 ---

package/dist/index.d.mts

@@ -1,11 +1,139 @@
-import { Chain } from 'viem/chains';
 import { Config } from '@wagmi/core';
-import { PublicClient, Address, Hex } from 'viem';
+import { HttpTransport, Client, PublicClient, WalletClient, Hex, Chain, Address } from 'viem';
+import { BundlerClientConfig, toSoladySmartAccount, ToSoladySmartAccountReturnType, BundlerClient, PaymasterClient } from 'viem/account-abstraction';
+import { Chain as Chain$1 } from 'viem/chains';
+
+/**
+ * @file Utilities for Pimlico and ERC-4337 Bundler client instantiation with local in-memory caching.
+ */
+
+/**
+ * Exported alias for Solady Smart Account type.
+ */
+type SoladySmartAccount = ToSoladySmartAccountReturnType;
+/**
+ * Configuration options for generating Pimlico Bundler RPC URLs.
+ */
+interface PimlicoUrlConfig {
+    /** Target EVM chain ID (e.g. 1 for Ethereum Mainnet, 11155111 for Sepolia). */
+    chainId: number;
+    /** Optional Pimlico API key. If omitted, falls back to public RPC or bundlerUrl. */
+    apiKey?: string;
+    /** Optional explicit custom bundler RPC URL that takes precedence. */
+    bundlerUrl?: string;
+}
+/**
+ * Optional additional configuration forwarded to Viem's createBundlerClient.
+ */
+type BundlerRpcClientConfig = PimlicoUrlConfig & Partial<Omit<BundlerClientConfig<HttpTransport>, 'transport' | 'client'>> & {
+    /** Optional execution client or public client used for fee estimation. */
+    client?: Client | PublicClient;
+};
+/**
+ * Parameters for creating a Solady ERC-4337 Smart Account.
+ */
+interface CreateSoladySmartAccountParams {
+    /** The client used to interact with the blockchain. */
+    client: Parameters<typeof toSoladySmartAccount>[0]['client'];
+    /** The connected WalletClient (e.g. from Wagmi or browser provider) representing the EOA owner. */
+    walletClient: WalletClient;
+    /**
+     * Optional 32-byte salt for deterministic counterfactual deployment.
+     * Defaults to right-padded EOA address to satisfy Solady factory owner-prefix verification.
+     */
+    salt?: Hex;
+}
+/**
+ * Configuration options for instantiating a Pimlico-powered ERC-4337 Smart Account client.
+ */
+interface PimlicoSmartAccountClientConfig {
+    /** Target EVM chain. */
+    chain: Chain;
+    /** The connected WalletClient representing the EOA signer. */
+    walletClient?: WalletClient;
+    /** Wagmi Config used to resolve the walletClient if not explicitly provided. */
+    wagmiConfig?: Config;
+    /** Optional public client for reading chain state. If omitted, one is created automatically. */
+    client?: PublicClient | Client;
+    /** Optional Pimlico API key. */
+    apiKey?: string;
+    /** Optional explicit custom bundler RPC URL. */
+    bundlerUrl?: string;
+    /** Optional RPC URL for public client execution transport (e.g., Alchemy / Infura). */
+    rpcUrl?: string;
+    /**
+     * Whether to configure and attach Pimlico paymaster for gas sponsorship.
+     * Defaults to true if apiKey or bundlerUrl is provided.
+     */
+    sponsor?: boolean;
+    /** Optional 32-byte salt for Solady smart account. */
+    salt?: Hex;
+}
+/**
+ * Result object returned by `createPimlicoSmartAccountClient`.
+ */
+interface PimlicoSmartAccountClientResult {
+    /** The instantiated Solady smart account instance. */
+    account: SoladySmartAccount;
+    /** The configured Viem Bundler client. */
+    bundlerClient: BundlerClient<HttpTransport>;
+    /** The public client used for chain state reads and fee estimation. */
+    publicClient: PublicClient;
+    /** The Pimlico paymaster client if gas sponsorship is enabled. */
+    paymasterClient?: PaymasterClient;
+}
+/**
+ * Creates and caches a Pimlico RPC URL based on provided configuration.
+ *
+ * Priority order:
+ * 1. Explicit `bundlerUrl` (if provided, returned directly).
+ * 2. Dedicated Pimlico endpoint `https://api.pimlico.io/v2/${chainId}/rpc?apikey=${apiKey}` (if apiKey provided).
+ * 3. Public community endpoint `https://public.pimlico.io/v2/${chainId}/rpc` (fallback).
+ *
+ * @param config - The Pimlico URL configuration.
+ * @returns The resolved Bundler RPC URL string.
+ */
+declare function createPimlicoRpcUrl(config: PimlicoUrlConfig): string;
+/**
+ * Creates or retrieves a cached Viem Bundler Client configured for the resolved Pimlico endpoint.
+ *
+ * @param config - Bundler URL and optional client configuration parameters.
+ * @returns Cached or newly instantiated BundlerClient.
+ */
+declare function createBundlerRpcClient(config: BundlerRpcClientConfig): BundlerClient<HttpTransport>;
+/**
+ * Creates a Viem Paymaster Client configured with the resolved Pimlico RPC endpoint.
+ *
+ * @param config - Pimlico URL configuration.
+ * @returns PaymasterClient instance configured for Pimlico gas sponsorship.
+ */
+declare function createPimlicoPaymasterClient(config: PimlicoUrlConfig): PaymasterClient;
+/**
+ * Instantiates a Solady ERC-4337 smart account with automatic wallet signing delegation
+ * and Solady factory-compliant deterministic salt.
+ *
+ * @param params - Configuration parameters including client and walletClient.
+ * @returns Promise resolving to the initialized SoladySmartAccount.
+ */
+declare function createSoladySmartAccount({ client, walletClient, salt, }: CreateSoladySmartAccountParams): Promise<SoladySmartAccount>;
+/**
+ * High-level orchestration utility that instantiates a Solady smart account,
+ * configures a Pimlico paymaster (sponsorship), and binds them to a Pimlico Bundler client.
+ *
+ * @param config - Configuration options including chain, wallet/wagmi, and Pimlico credentials.
+ * @returns Promise resolving to { account, bundlerClient, publicClient, paymasterClient }.
+ */
+declare function createPimlicoSmartAccountClient(config: PimlicoSmartAccountClientConfig): Promise<PimlicoSmartAccountClientResult>;
+/**
+ * Clears the in-memory cache of Pimlico URLs and Bundler clients.
+ * Useful for testing and resetting runtime state.
+ */
+declare function clearBundlerCache(): void;
 
 /**
  * Get EVM chain IDs from app chains configuration
  */
-declare function getEvmChains(appChains?: readonly [Chain, ...Chain[]]): number[];
+declare function getEvmChains(appChains?: readonly [Chain$1, ...Chain$1[]]): number[];
 /**
  * Type guard to check if a chain list contains EVM chain IDs
  */
@@ -46,7 +174,7 @@ declare function checkAndSwitchChain(chainId: number, config: Config): Promise<v
  * @returns {import('viem').PublicClient | undefined} A viem PublicClient instance if a matching chain is found, otherwise undefined.
  * It will also log a warning to the console if the chain is not configured.
  */
-declare function createViemClient(chainId: number, chains: readonly [Chain, ...Chain[]]): PublicClient | undefined;
+declare function createViemClient(chainId: number, chains: readonly [Chain$1, ...Chain$1[]]): PublicClient | undefined;
 
 /**
  * @file This file contains utility functions for interacting with the Ethereum Name Service (ENS).
@@ -62,7 +190,7 @@ declare function createViemClient(chainId: number, chains: readonly [Chain, ...C
  * @param {readonly [Chain, ...Chain[]]} chains - The list of chains to use for client creation.
  * @returns {Promise<string | null>} The ENS name if found, otherwise null.
  */
-declare const getName: (address: Hex, chains: readonly [Chain, ...Chain[]]) => Promise<string | null>;
+declare const getName: (address: Hex, chains: readonly [Chain$1, ...Chain$1[]]) => Promise<string | null>;
 /**
  * Fetches the avatar URL for a given ENS name from the Ethereum Mainnet.
  * Includes caching for performance.
@@ -71,7 +199,7 @@ declare const getName: (address: Hex, chains: readonly [Chain, ...Chain[]]) => P
  * @param {readonly [Chain, ...Chain[]]} chains - The list of chains to use for client creation.
  * @returns {Promise<string | null>} The URL of the avatar image if found, otherwise null.
  */
-declare const getAvatar: (name: string, chains: readonly [Chain, ...Chain[]]) => Promise<string | null>;
+declare const getAvatar: (name: string, chains: readonly [Chain$1, ...Chain$1[]]) => Promise<string | null>;
 /**
  * Fetches the Ethereum address associated with a given ENS name from the Ethereum Mainnet.
  * Includes caching for performance.
@@ -80,7 +208,7 @@ declare const getAvatar: (name: string, chains: readonly [Chain, ...Chain[]]) =>
  * @param {readonly [Chain, ...Chain[]]} chains - The list of chains to use for client creation.
  * @returns {Promise<Address | null>} The associated Ethereum address (lowercase) or null if not found.
  */
-declare const getAddress: (name: string, chains: readonly [Chain, ...Chain[]]) => Promise<Address | null>;
+declare const getAddress: (name: string, chains: readonly [Chain$1, ...Chain$1[]]) => Promise<Address | null>;
 /**
  * A heuristic to check if a string is likely an ENS name.
  *
@@ -97,4 +225,4 @@ declare const getAddress: (name: string, chains: readonly [Chain, ...Chain[]]) =
  */
 declare const isEnsName: (nameOrAddress: string) => boolean;
 
-export { checkAndSwitchChain, createViemClient, getAddress, getAvatar, getEvmChains, getName, isEnsName, isEvmChainList };
+export { type BundlerRpcClientConfig, type CreateSoladySmartAccountParams, type PimlicoSmartAccountClientConfig, type PimlicoSmartAccountClientResult, type PimlicoUrlConfig, type SoladySmartAccount, checkAndSwitchChain, clearBundlerCache, createBundlerRpcClient, createPimlicoPaymasterClient, createPimlicoRpcUrl, createPimlicoSmartAccountClient, createSoladySmartAccount, createViemClient, getAddress, getAvatar, getEvmChains, getName, isEnsName, isEvmChainList };

package/dist/index.d.ts

@@ -1,11 +1,139 @@
-import { Chain } from 'viem/chains';
 import { Config } from '@wagmi/core';
-import { PublicClient, Address, Hex } from 'viem';
+import { HttpTransport, Client, PublicClient, WalletClient, Hex, Chain, Address } from 'viem';
+import { BundlerClientConfig, toSoladySmartAccount, ToSoladySmartAccountReturnType, BundlerClient, PaymasterClient } from 'viem/account-abstraction';
+import { Chain as Chain$1 } from 'viem/chains';
+
+/**
+ * @file Utilities for Pimlico and ERC-4337 Bundler client instantiation with local in-memory caching.
+ */
+
+/**
+ * Exported alias for Solady Smart Account type.
+ */
+type SoladySmartAccount = ToSoladySmartAccountReturnType;
+/**
+ * Configuration options for generating Pimlico Bundler RPC URLs.
+ */
+interface PimlicoUrlConfig {
+    /** Target EVM chain ID (e.g. 1 for Ethereum Mainnet, 11155111 for Sepolia). */
+    chainId: number;
+    /** Optional Pimlico API key. If omitted, falls back to public RPC or bundlerUrl. */
+    apiKey?: string;
+    /** Optional explicit custom bundler RPC URL that takes precedence. */
+    bundlerUrl?: string;
+}
+/**
+ * Optional additional configuration forwarded to Viem's createBundlerClient.
+ */
+type BundlerRpcClientConfig = PimlicoUrlConfig & Partial<Omit<BundlerClientConfig<HttpTransport>, 'transport' | 'client'>> & {
+    /** Optional execution client or public client used for fee estimation. */
+    client?: Client | PublicClient;
+};
+/**
+ * Parameters for creating a Solady ERC-4337 Smart Account.
+ */
+interface CreateSoladySmartAccountParams {
+    /** The client used to interact with the blockchain. */
+    client: Parameters<typeof toSoladySmartAccount>[0]['client'];
+    /** The connected WalletClient (e.g. from Wagmi or browser provider) representing the EOA owner. */
+    walletClient: WalletClient;
+    /**
+     * Optional 32-byte salt for deterministic counterfactual deployment.
+     * Defaults to right-padded EOA address to satisfy Solady factory owner-prefix verification.
+     */
+    salt?: Hex;
+}
+/**
+ * Configuration options for instantiating a Pimlico-powered ERC-4337 Smart Account client.
+ */
+interface PimlicoSmartAccountClientConfig {
+    /** Target EVM chain. */
+    chain: Chain;
+    /** The connected WalletClient representing the EOA signer. */
+    walletClient?: WalletClient;
+    /** Wagmi Config used to resolve the walletClient if not explicitly provided. */
+    wagmiConfig?: Config;
+    /** Optional public client for reading chain state. If omitted, one is created automatically. */
+    client?: PublicClient | Client;
+    /** Optional Pimlico API key. */
+    apiKey?: string;
+    /** Optional explicit custom bundler RPC URL. */
+    bundlerUrl?: string;
+    /** Optional RPC URL for public client execution transport (e.g., Alchemy / Infura). */
+    rpcUrl?: string;
+    /**
+     * Whether to configure and attach Pimlico paymaster for gas sponsorship.
+     * Defaults to true if apiKey or bundlerUrl is provided.
+     */
+    sponsor?: boolean;
+    /** Optional 32-byte salt for Solady smart account. */
+    salt?: Hex;
+}
+/**
+ * Result object returned by `createPimlicoSmartAccountClient`.
+ */
+interface PimlicoSmartAccountClientResult {
+    /** The instantiated Solady smart account instance. */
+    account: SoladySmartAccount;
+    /** The configured Viem Bundler client. */
+    bundlerClient: BundlerClient<HttpTransport>;
+    /** The public client used for chain state reads and fee estimation. */
+    publicClient: PublicClient;
+    /** The Pimlico paymaster client if gas sponsorship is enabled. */
+    paymasterClient?: PaymasterClient;
+}
+/**
+ * Creates and caches a Pimlico RPC URL based on provided configuration.
+ *
+ * Priority order:
+ * 1. Explicit `bundlerUrl` (if provided, returned directly).
+ * 2. Dedicated Pimlico endpoint `https://api.pimlico.io/v2/${chainId}/rpc?apikey=${apiKey}` (if apiKey provided).
+ * 3. Public community endpoint `https://public.pimlico.io/v2/${chainId}/rpc` (fallback).
+ *
+ * @param config - The Pimlico URL configuration.
+ * @returns The resolved Bundler RPC URL string.
+ */
+declare function createPimlicoRpcUrl(config: PimlicoUrlConfig): string;
+/**
+ * Creates or retrieves a cached Viem Bundler Client configured for the resolved Pimlico endpoint.
+ *
+ * @param config - Bundler URL and optional client configuration parameters.
+ * @returns Cached or newly instantiated BundlerClient.
+ */
+declare function createBundlerRpcClient(config: BundlerRpcClientConfig): BundlerClient<HttpTransport>;
+/**
+ * Creates a Viem Paymaster Client configured with the resolved Pimlico RPC endpoint.
+ *
+ * @param config - Pimlico URL configuration.
+ * @returns PaymasterClient instance configured for Pimlico gas sponsorship.
+ */
+declare function createPimlicoPaymasterClient(config: PimlicoUrlConfig): PaymasterClient;
+/**
+ * Instantiates a Solady ERC-4337 smart account with automatic wallet signing delegation
+ * and Solady factory-compliant deterministic salt.
+ *
+ * @param params - Configuration parameters including client and walletClient.
+ * @returns Promise resolving to the initialized SoladySmartAccount.
+ */
+declare function createSoladySmartAccount({ client, walletClient, salt, }: CreateSoladySmartAccountParams): Promise<SoladySmartAccount>;
+/**
+ * High-level orchestration utility that instantiates a Solady smart account,
+ * configures a Pimlico paymaster (sponsorship), and binds them to a Pimlico Bundler client.
+ *
+ * @param config - Configuration options including chain, wallet/wagmi, and Pimlico credentials.
+ * @returns Promise resolving to { account, bundlerClient, publicClient, paymasterClient }.
+ */
+declare function createPimlicoSmartAccountClient(config: PimlicoSmartAccountClientConfig): Promise<PimlicoSmartAccountClientResult>;
+/**
+ * Clears the in-memory cache of Pimlico URLs and Bundler clients.
+ * Useful for testing and resetting runtime state.
+ */
+declare function clearBundlerCache(): void;
 
 /**
  * Get EVM chain IDs from app chains configuration
  */
-declare function getEvmChains(appChains?: readonly [Chain, ...Chain[]]): number[];
+declare function getEvmChains(appChains?: readonly [Chain$1, ...Chain$1[]]): number[];
 /**
  * Type guard to check if a chain list contains EVM chain IDs
  */
@@ -46,7 +174,7 @@ declare function checkAndSwitchChain(chainId: number, config: Config): Promise<v
  * @returns {import('viem').PublicClient | undefined} A viem PublicClient instance if a matching chain is found, otherwise undefined.
  * It will also log a warning to the console if the chain is not configured.
  */
-declare function createViemClient(chainId: number, chains: readonly [Chain, ...Chain[]]): PublicClient | undefined;
+declare function createViemClient(chainId: number, chains: readonly [Chain$1, ...Chain$1[]]): PublicClient | undefined;
 
 /**
  * @file This file contains utility functions for interacting with the Ethereum Name Service (ENS).
@@ -62,7 +190,7 @@ declare function createViemClient(chainId: number, chains: readonly [Chain, ...C
  * @param {readonly [Chain, ...Chain[]]} chains - The list of chains to use for client creation.
  * @returns {Promise<string | null>} The ENS name if found, otherwise null.
  */
-declare const getName: (address: Hex, chains: readonly [Chain, ...Chain[]]) => Promise<string | null>;
+declare const getName: (address: Hex, chains: readonly [Chain$1, ...Chain$1[]]) => Promise<string | null>;
 /**
  * Fetches the avatar URL for a given ENS name from the Ethereum Mainnet.
  * Includes caching for performance.
@@ -71,7 +199,7 @@ declare const getName: (address: Hex, chains: readonly [Chain, ...Chain[]]) => P
  * @param {readonly [Chain, ...Chain[]]} chains - The list of chains to use for client creation.
  * @returns {Promise<string | null>} The URL of the avatar image if found, otherwise null.
  */
-declare const getAvatar: (name: string, chains: readonly [Chain, ...Chain[]]) => Promise<string | null>;
+declare const getAvatar: (name: string, chains: readonly [Chain$1, ...Chain$1[]]) => Promise<string | null>;
 /**
  * Fetches the Ethereum address associated with a given ENS name from the Ethereum Mainnet.
  * Includes caching for performance.
@@ -80,7 +208,7 @@ declare const getAvatar: (name: string, chains: readonly [Chain, ...Chain[]]) =>
  * @param {readonly [Chain, ...Chain[]]} chains - The list of chains to use for client creation.
  * @returns {Promise<Address | null>} The associated Ethereum address (lowercase) or null if not found.
  */
-declare const getAddress: (name: string, chains: readonly [Chain, ...Chain[]]) => Promise<Address | null>;
+declare const getAddress: (name: string, chains: readonly [Chain$1, ...Chain$1[]]) => Promise<Address | null>;
 /**
  * A heuristic to check if a string is likely an ENS name.
  *
@@ -97,4 +225,4 @@ declare const getAddress: (name: string, chains: readonly [Chain, ...Chain[]]) =
  */
 declare const isEnsName: (nameOrAddress: string) => boolean;
 
-export { checkAndSwitchChain, createViemClient, getAddress, getAvatar, getEvmChains, getName, isEnsName, isEvmChainList };
+export { type BundlerRpcClientConfig, type CreateSoladySmartAccountParams, type PimlicoSmartAccountClientConfig, type PimlicoSmartAccountClientResult, type PimlicoUrlConfig, type SoladySmartAccount, checkAndSwitchChain, clearBundlerCache, createBundlerRpcClient, createPimlicoPaymasterClient, createPimlicoRpcUrl, createPimlicoSmartAccountClient, createSoladySmartAccount, createViemClient, getAddress, getAvatar, getEvmChains, getName, isEnsName, isEvmChainList };

package/dist/index.js

@@ -1 +1,2 @@
-'use strict';var core=require('@wagmi/core'),viem=require('viem'),chains=require('viem/chains'),ens=require('viem/ens');function C(e){return e!=null&&typeof e=="number"&&e>0}function E(e){return !e||e.length===0?[]:e.map(r=>r.id).filter(C)}function N(e){return e.length>0&&e.every(r=>typeof r=="number")}async function U(e,r){let{connector:t,chainId:o}=core.getConnection(r);if(t&&o!==e)try{await core.switchChain(r,{chainId:e});}catch(n){throw n.cause?.name==="UserRejectedRequestError"?new Error("User rejected the request to switch network.",{cause:n}):(console.error("Failed to switch network:",n),new Error("An error occurred while switching the network.",{cause:n}))}}var u=new Map;function s(e,r){let t=r.find(n=>n.id===e),o=u.get(e);if(o&&o.chain?.rpcUrls.default.http[0]===t?.rpcUrls.default.http[0])return o;if(t){let n=viem.createPublicClient({chain:t,transport:viem.http()});return u.set(e,n),n}console.warn(`createViemClient: No chain configuration found for chainId ${e}. A client could not be created.`);}var d=new Map,m=new Map,f=new Map,c=e=>{let r=e.find(t=>t.id===chains.mainnet.id);return r?s(chains.mainnet.id,[r]):s(chains.mainnet.id,[chains.mainnet])},D=async(e,r)=>{let t=c(r);if(!t)return null;let o=d.get(e);if(o!==void 0)return o;try{let n=await ens.getEnsName(t,{address:e});return d.set(e,n),n}catch(n){return console.error(`ENS name lookup failed for address ${e}:`,n),null}},G=async(e,r)=>{let t=c(r);if(!t)return null;let o=ens.normalize(e),n=m.get(o);if(n!==void 0)return n;try{let i=await ens.getEnsAvatar(t,{name:o});return m.set(o,i),i}catch(i){return console.error(`ENS avatar lookup failed for name ${e}:`,i),null}},I=async(e,r)=>{let t=c(r);if(!t)return null;let o=ens.normalize(e),n=f.get(o);if(n!==void 0)return n;try{let i=await ens.getEnsAddress(t,{name:o}),l=i?i.toLowerCase():null;return f.set(o,l),l}catch(i){return console.error(`ENS address lookup failed for name ${e}:`,i),null}},J=e=>e.includes(".")&&!viem.isAddress(e);exports.checkAndSwitchChain=U;exports.createViemClient=s;exports.getAddress=I;exports.getAvatar=G;exports.getEvmChains=E;exports.getName=D;exports.isEnsName=J;exports.isEvmChainList=N;
+'use strict';var core=require('@wagmi/core'),viem=require('viem'),accountAbstraction=require('viem/account-abstraction'),accounts=require('viem/accounts'),chains=require('viem/chains'),ens=require('viem/ens');var m=new Map,p=new Map;function H(e){return e.bundlerUrl?`custom:${e.bundlerUrl.trim()}`:`${e.chainId}:${e.apiKey?.trim()??"public"}`}function K(e){let t=C(e),r=!!e.paymaster,n=!!e.client;return `${t}:pm=${r}:client=${n}`}function C(e){let t=H(e),r=m.get(t);if(r)return r;let n;return e.bundlerUrl?n=e.bundlerUrl.trim():e.apiKey?n=`https://api.pimlico.io/v2/${e.chainId}/rpc?apikey=${e.apiKey.trim()}`:n=`https://public.pimlico.io/v2/${e.chainId}/rpc`,m.set(t,n),n}function N(e){let t=K(e),r=p.get(t);if(r)return r;let n=C(e),i={...e};delete i.bundlerUrl,delete i.apiKey;let a=accountAbstraction.createBundlerClient({...i,transport:viem.http(n)});return p.set(t,a),a}function R(e){let t=C(e);return accountAbstraction.createPaymasterClient({transport:viem.http(t)})}async function k({client:e,walletClient:t,salt:r}){if(!t.account)throw new Error("WalletClient must have an active account.");let n=t.account,i=accounts.toAccount({address:n.address,async signMessage({message:o}){return t.signMessage({account:n,message:o})},async signTransaction(o){return t.signTransaction({account:n,...o})},async signTypedData(o){return t.signTypedData({account:n,...o})}}),a=r??viem.pad(n.address,{dir:"right",size:32});return accountAbstraction.toSoladySmartAccount({client:e,owner:i,salt:a})}async function Q(e){let{chain:t,apiKey:r,bundlerUrl:n,rpcUrl:i,salt:a,sponsor:o=!!(r||n)}=e,l=e.walletClient;if(!l&&e.wagmiConfig&&(l=await core.getWalletClient(e.wagmiConfig,{chainId:t.id})),!l||!l.account)throw new Error("Active wallet connection with account is required (provide walletClient or wagmiConfig).");let u=e.client??viem.createPublicClient({chain:t,transport:i?viem.http(i):viem.http()}),A=await k({client:u,walletClient:l,salt:a}),d=o&&(r||n)?R({chainId:t.id,apiKey:r,bundlerUrl:n}):void 0,x=N({chainId:t.id,apiKey:r,bundlerUrl:n,client:u,...d?{paymaster:d}:{}});return {account:A,bundlerClient:x,publicClient:u,paymasterClient:d}}function X(){m.clear(),p.clear();}function M(e){return e!=null&&typeof e=="number"&&e>0}function Z(e){return !e||e.length===0?[]:e.map(t=>t.id).filter(M)}function _(e){return e.length>0&&e.every(t=>typeof t=="number")}async function re(e,t){let{connector:r,chainId:n}=core.getConnection(t);if(r&&n!==e)try{await core.switchChain(t,{chainId:e});}catch(i){throw i?.cause?.name==="UserRejectedRequestError"?new Error("User rejected the request to switch network.",{cause:i}):(console.error("Failed to switch network:",i),new Error("An error occurred while switching the network.",{cause:i}))}}var y=new Map;function f(e,t){let r=t.find(i=>i.id===e),n=y.get(e);if(n&&n.chain?.rpcUrls.default.http[0]===r?.rpcUrls.default.http[0])return n;if(r){let i=viem.createPublicClient({chain:r,transport:viem.http()});return y.set(e,i),i}console.warn(`createViemClient: No chain configuration found for chainId ${e}. A client could not be created.`);}var g=new Map,w=new Map,P=new Map,h=e=>{let t=e.find(r=>r.id===chains.mainnet.id);return t?f(chains.mainnet.id,[t]):f(chains.mainnet.id,[chains.mainnet])},fe=async(e,t)=>{let r=h(t);if(!r)return null;let n=g.get(e);if(n!==void 0)return n;try{let i=await ens.getEnsName(r,{address:e});return g.set(e,i),i}catch(i){return console.error(`ENS name lookup failed for address ${e}:`,i),null}},he=async(e,t)=>{let r=h(t);if(!r)return null;let n=ens.normalize(e),i=w.get(n);if(i!==void 0)return i;try{let a=await ens.getEnsAvatar(r,{name:n});return w.set(n,a),a}catch(a){return console.error(`ENS avatar lookup failed for name ${e}:`,a),null}},ye=async(e,t)=>{let r=h(t);if(!r)return null;let n=ens.normalize(e),i=P.get(n);if(i!==void 0)return i;try{let a=await ens.getEnsAddress(r,{name:n}),o=a?a.toLowerCase():null;return P.set(n,o),o}catch(a){return console.error(`ENS address lookup failed for name ${e}:`,a),null}},ge=e=>e.includes(".")&&!viem.isAddress(e);
+exports.checkAndSwitchChain=re;exports.clearBundlerCache=X;exports.createBundlerRpcClient=N;exports.createPimlicoPaymasterClient=R;exports.createPimlicoRpcUrl=C;exports.createPimlicoSmartAccountClient=Q;exports.createSoladySmartAccount=k;exports.createViemClient=f;exports.getAddress=ye;exports.getAvatar=he;exports.getEvmChains=Z;exports.getName=fe;exports.isEnsName=ge;exports.isEvmChainList=_;

package/dist/index.mjs

@@ -1 +1,2 @@
-import {getConnection,switchChain}from'@wagmi/core';import {createPublicClient,http,isAddress}from'viem';import {mainnet}from'viem/chains';import {getEnsName,normalize,getEnsAvatar,getEnsAddress}from'viem/ens';function C(e){return e!=null&&typeof e=="number"&&e>0}function E(e){return !e||e.length===0?[]:e.map(r=>r.id).filter(C)}function N(e){return e.length>0&&e.every(r=>typeof r=="number")}async function U(e,r){let{connector:t,chainId:o}=getConnection(r);if(t&&o!==e)try{await switchChain(r,{chainId:e});}catch(n){throw n.cause?.name==="UserRejectedRequestError"?new Error("User rejected the request to switch network.",{cause:n}):(console.error("Failed to switch network:",n),new Error("An error occurred while switching the network.",{cause:n}))}}var u=new Map;function s(e,r){let t=r.find(n=>n.id===e),o=u.get(e);if(o&&o.chain?.rpcUrls.default.http[0]===t?.rpcUrls.default.http[0])return o;if(t){let n=createPublicClient({chain:t,transport:http()});return u.set(e,n),n}console.warn(`createViemClient: No chain configuration found for chainId ${e}. A client could not be created.`);}var d=new Map,m=new Map,f=new Map,c=e=>{let r=e.find(t=>t.id===mainnet.id);return r?s(mainnet.id,[r]):s(mainnet.id,[mainnet])},D=async(e,r)=>{let t=c(r);if(!t)return null;let o=d.get(e);if(o!==void 0)return o;try{let n=await getEnsName(t,{address:e});return d.set(e,n),n}catch(n){return console.error(`ENS name lookup failed for address ${e}:`,n),null}},G=async(e,r)=>{let t=c(r);if(!t)return null;let o=normalize(e),n=m.get(o);if(n!==void 0)return n;try{let i=await getEnsAvatar(t,{name:o});return m.set(o,i),i}catch(i){return console.error(`ENS avatar lookup failed for name ${e}:`,i),null}},I=async(e,r)=>{let t=c(r);if(!t)return null;let o=normalize(e),n=f.get(o);if(n!==void 0)return n;try{let i=await getEnsAddress(t,{name:o}),l=i?i.toLowerCase():null;return f.set(o,l),l}catch(i){return console.error(`ENS address lookup failed for name ${e}:`,i),null}},J=e=>e.includes(".")&&!isAddress(e);export{U as checkAndSwitchChain,s as createViemClient,I as getAddress,G as getAvatar,E as getEvmChains,D as getName,J as isEnsName,N as isEvmChainList};
+import {getWalletClient,getConnection,switchChain}from'@wagmi/core';import {http,pad,createPublicClient,isAddress}from'viem';import {createBundlerClient,createPaymasterClient,toSoladySmartAccount}from'viem/account-abstraction';import {toAccount}from'viem/accounts';import {mainnet}from'viem/chains';import {getEnsName,normalize,getEnsAvatar,getEnsAddress}from'viem/ens';var m=new Map,p=new Map;function H(e){return e.bundlerUrl?`custom:${e.bundlerUrl.trim()}`:`${e.chainId}:${e.apiKey?.trim()??"public"}`}function K(e){let t=C(e),r=!!e.paymaster,n=!!e.client;return `${t}:pm=${r}:client=${n}`}function C(e){let t=H(e),r=m.get(t);if(r)return r;let n;return e.bundlerUrl?n=e.bundlerUrl.trim():e.apiKey?n=`https://api.pimlico.io/v2/${e.chainId}/rpc?apikey=${e.apiKey.trim()}`:n=`https://public.pimlico.io/v2/${e.chainId}/rpc`,m.set(t,n),n}function N(e){let t=K(e),r=p.get(t);if(r)return r;let n=C(e),i={...e};delete i.bundlerUrl,delete i.apiKey;let a=createBundlerClient({...i,transport:http(n)});return p.set(t,a),a}function R(e){let t=C(e);return createPaymasterClient({transport:http(t)})}async function k({client:e,walletClient:t,salt:r}){if(!t.account)throw new Error("WalletClient must have an active account.");let n=t.account,i=toAccount({address:n.address,async signMessage({message:o}){return t.signMessage({account:n,message:o})},async signTransaction(o){return t.signTransaction({account:n,...o})},async signTypedData(o){return t.signTypedData({account:n,...o})}}),a=r??pad(n.address,{dir:"right",size:32});return toSoladySmartAccount({client:e,owner:i,salt:a})}async function Q(e){let{chain:t,apiKey:r,bundlerUrl:n,rpcUrl:i,salt:a,sponsor:o=!!(r||n)}=e,l=e.walletClient;if(!l&&e.wagmiConfig&&(l=await getWalletClient(e.wagmiConfig,{chainId:t.id})),!l||!l.account)throw new Error("Active wallet connection with account is required (provide walletClient or wagmiConfig).");let u=e.client??createPublicClient({chain:t,transport:i?http(i):http()}),A=await k({client:u,walletClient:l,salt:a}),d=o&&(r||n)?R({chainId:t.id,apiKey:r,bundlerUrl:n}):void 0,x=N({chainId:t.id,apiKey:r,bundlerUrl:n,client:u,...d?{paymaster:d}:{}});return {account:A,bundlerClient:x,publicClient:u,paymasterClient:d}}function X(){m.clear(),p.clear();}function M(e){return e!=null&&typeof e=="number"&&e>0}function Z(e){return !e||e.length===0?[]:e.map(t=>t.id).filter(M)}function _(e){return e.length>0&&e.every(t=>typeof t=="number")}async function re(e,t){let{connector:r,chainId:n}=getConnection(t);if(r&&n!==e)try{await switchChain(t,{chainId:e});}catch(i){throw i?.cause?.name==="UserRejectedRequestError"?new Error("User rejected the request to switch network.",{cause:i}):(console.error("Failed to switch network:",i),new Error("An error occurred while switching the network.",{cause:i}))}}var y=new Map;function f(e,t){let r=t.find(i=>i.id===e),n=y.get(e);if(n&&n.chain?.rpcUrls.default.http[0]===r?.rpcUrls.default.http[0])return n;if(r){let i=createPublicClient({chain:r,transport:http()});return y.set(e,i),i}console.warn(`createViemClient: No chain configuration found for chainId ${e}. A client could not be created.`);}var g=new Map,w=new Map,P=new Map,h=e=>{let t=e.find(r=>r.id===mainnet.id);return t?f(mainnet.id,[t]):f(mainnet.id,[mainnet])},fe=async(e,t)=>{let r=h(t);if(!r)return null;let n=g.get(e);if(n!==void 0)return n;try{let i=await getEnsName(r,{address:e});return g.set(e,i),i}catch(i){return console.error(`ENS name lookup failed for address ${e}:`,i),null}},he=async(e,t)=>{let r=h(t);if(!r)return null;let n=normalize(e),i=w.get(n);if(i!==void 0)return i;try{let a=await getEnsAvatar(r,{name:n});return w.set(n,a),a}catch(a){return console.error(`ENS avatar lookup failed for name ${e}:`,a),null}},ye=async(e,t)=>{let r=h(t);if(!r)return null;let n=normalize(e),i=P.get(n);if(i!==void 0)return i;try{let a=await getEnsAddress(r,{name:n}),o=a?a.toLowerCase():null;return P.set(n,o),o}catch(a){return console.error(`ENS address lookup failed for name ${e}:`,a),null}},ge=e=>e.includes(".")&&!isAddress(e);
+export{re as checkAndSwitchChain,X as clearBundlerCache,N as createBundlerRpcClient,R as createPimlicoPaymasterClient,C as createPimlicoRpcUrl,Q as createPimlicoSmartAccountClient,k as createSoladySmartAccount,f as createViemClient,ye as getAddress,he as getAvatar,Z as getEvmChains,fe as getName,ge as isEnsName,_ as isEvmChainList};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/orbit-evm",
-  "version": "0.2.21",
+  "version": "0.3.0",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -41,13 +41,14 @@
     "viem": "2.x.x"
   },
   "devDependencies": {
-    "@wagmi/core": "^3.6.4",
+    "@wagmi/core": "^3.6.5",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "viem": "^2.55.10"
+    "viem": "^2.56.3"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",
-    "build": "tsup"
+    "build": "tsup",
+    "test": "vitest run"
   }
 }