@eth-optimism/actions-sdk 0.4.0 → 0.6.0

package/dist/index.js

@@ -1,9 +1,13 @@
+export { LendProvider, MorphoLendProvider } from './actions/lend/index.js';
+export { SwapProvider, UniswapSwapProvider, VelodromeSwapProvider, } from './actions/swap/index.js';
 export { AAVE, ARB, BAL, CBBTC, CBETH, COMP, CRV, DAI, EETH, ENA, ENS, ETH, ETHFI, FRAX, GRT, LDO, LINK, MKR, MORPHO, NATIVELY_SUPPORTED_ASSETS, ONDO, ONEINCH, OP, OP_DEMO, PENDLE, PEPE, POL, PYUSD, RENDER, RETH, RPL, SHIB, SKY, SNX, STETH, SUSHI, UNI, USDC, USDC_DEMO, USDE, USDT, WBTC, WEETH, WETH, WLD, WSTETH, } from './constants/assets.js';
 export { ACTIONS_SUPPORTED_CHAIN_IDS, } from './constants/supportedChains.js';
 export * from './core/error/errors.js';
-export { LendProvider, MorphoLendProvider } from './lend/index.js';
-export { SwapProvider, UniswapSwapProvider, VelodromeSwapProvider, } from './swap/index.js';
+export { EnsNamespace, EnsNotConfiguredError, EnsResolutionError, EnsRpcError, } from './services/nameservices/ens/index.js';
+export { isEnsName, resolveAddress, } from './services/nameservices/ens/utils.js';
 export { getAssetAddress, isAssetSupportedOnChain } from './utils/assets.js';
+export { serializeBigInt } from './utils/serializers.js';
+export * from './wallet/core/error/errors.js';
 export { Wallet } from './wallet/core/wallets/abstract/Wallet.js';
 export { SmartWallet } from './wallet/core/wallets/smart/abstract/SmartWallet.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,IAAI,EACJ,GAAG,EACH,GAAG,EACH,KAAK,EACL,KAAK,EACL,IAAI,EACJ,GAAG,EACH,GAAG,EACH,IAAI,EACJ,GAAG,EACH,GAAG,EACH,GAAG,EACH,KAAK,EACL,IAAI,EACJ,GAAG,EACH,GAAG,EACH,IAAI,EACJ,GAAG,EACH,MAAM,EACN,yBAAyB,EACzB,IAAI,EACJ,OAAO,EACP,EAAE,EACF,OAAO,EACP,MAAM,EACN,IAAI,EACJ,GAAG,EACH,KAAK,EACL,MAAM,EACN,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,GAAG,EACH,GAAG,EACH,KAAK,EACL,KAAK,EACL,GAAG,EACH,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,GAAG,EACH,MAAM,GACP,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,2BAA2B,GAE5B,MAAM,gCAAgC,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EACL,YAAY,EAEZ,mBAAmB,EAGnB,qBAAqB,GAEtB,MAAM,iBAAiB,CAAA;AAsCxB,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,EACL,YAAY,EAEZ,mBAAmB,EAGnB,qBAAqB,GAEtB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,IAAI,EACJ,GAAG,EACH,GAAG,EACH,KAAK,EACL,KAAK,EACL,IAAI,EACJ,GAAG,EACH,GAAG,EACH,IAAI,EACJ,GAAG,EACH,GAAG,EACH,GAAG,EACH,KAAK,EACL,IAAI,EACJ,GAAG,EACH,GAAG,EACH,IAAI,EACJ,GAAG,EACH,MAAM,EACN,yBAAyB,EACzB,IAAI,EACJ,OAAO,EACP,EAAE,EACF,OAAO,EACP,MAAM,EACN,IAAI,EACJ,GAAG,EACH,KAAK,EACL,MAAM,EACN,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,GAAG,EACH,GAAG,EACH,KAAK,EACL,KAAK,EACL,GAAG,EACH,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,GAAG,EACH,MAAM,GACP,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,2BAA2B,GAE5B,MAAM,gCAAgC,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAEL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,GAEZ,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAEL,SAAS,EACT,cAAc,GACf,MAAM,sCAAsC,CAAA;AAsC7C,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,cAAc,+BAA+B,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAA"}

package/dist/services/ChainManager.d.ts

@@ -25,6 +25,13 @@ export declare class ChainManager {
      * @throws Error if no client is configured for the chain ID
      */
     getPublicClient(chainId: SupportedChainId): PublicClient;
+    /**
+     * Get public client for a specific chain, or undefined if not configured.
+     * Use this when the chain is optional (e.g. mainnet for ENS resolution).
+     * @param chainId - The chain ID to retrieve the public client for
+     * @returns PublicClient instance, or undefined if not configured
+     */
+    tryGetPublicClient(chainId: SupportedChainId): PublicClient | undefined;
     /**
      * Get bundler client for a specific chain
      * @param chainId - The chain ID to retrieve the bundler client for

package/dist/services/ChainManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChainManager.d.ts","sourceRoot":"","sources":["../../src/services/ChainManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAGhE,OAAO,EACL,KAAK,KAAK,EAIV,KAAK,YAAY,EAClB,MAAM,MAAM,CAAA;AACb,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,6DAA6D;IAC7D,OAAO,CAAC,aAAa,CAAqC;IAC1D,6CAA6C;IAC7C,OAAO,CAAC,YAAY,CAAe;IAEnC;;;OAGG;gBACS,MAAM,EAAE,WAAW,EAAE;IAKjC;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY;IAQxD;;;;;;OAMG;IACH,gBAAgB,CACd,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,YAAY,GACpB,aAAa,GAAG,kBAAkB;IA6BrC;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE,GAAG,SAAS;IAK3D;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS;IAQ5D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK;IAI1C;;;OAGG;IACH,kBAAkB;IAIlB;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,gBAAgB;IAO9C;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;CA8BhC"}
+{"version":3,"file":"ChainManager.d.ts","sourceRoot":"","sources":["../../src/services/ChainManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAGhE,OAAO,EACL,KAAK,KAAK,EAIV,KAAK,YAAY,EAClB,MAAM,MAAM,CAAA;AACb,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,6DAA6D;IAC7D,OAAO,CAAC,aAAa,CAAqC;IAC1D,6CAA6C;IAC7C,OAAO,CAAC,YAAY,CAAe;IAEnC;;;OAGG;gBACS,MAAM,EAAE,WAAW,EAAE;IAKjC;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY;IAWxD;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,GAAG,SAAS;IAIvE;;;;;;OAMG;IACH,gBAAgB,CACd,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,YAAY,GACpB,aAAa,GAAG,kBAAkB;IAmCrC;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE,GAAG,SAAS;IAK3D;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS;IAW5D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK;IAI1C;;;OAGG;IACH,kBAAkB;IAIlB;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,gBAAgB;IAO9C;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;CA8BhC"}

package/dist/services/ChainManager.js

@@ -3,6 +3,7 @@ import { createSmartAccountClient } from 'permissionless/clients';
 import { createPimlicoClient } from 'permissionless/clients/pimlico';
 import { createPublicClient, fallback, http, } from 'viem';
 import { createBundlerClient } from 'viem/account-abstraction';
+import { ChainNotSupportedError } from '../core/error/errors.js';
 /**
  * Chain Manager Service
  * @description Manages public clients and chain infrastructure for the Verbs SDK.
@@ -26,10 +27,22 @@ export class ChainManager {
     getPublicClient(chainId) {
         const client = this.publicClients.get(chainId);
         if (!client) {
-            throw new Error(`No public client configured for chain ID: ${chainId}`);
+            throw new ChainNotSupportedError({
+                chainId,
+                supportedChainIds: this.getSupportedChains(),
+            });
         }
         return client;
     }
+    /**
+     * Get public client for a specific chain, or undefined if not configured.
+     * Use this when the chain is optional (e.g. mainnet for ENS resolution).
+     * @param chainId - The chain ID to retrieve the public client for
+     * @returns PublicClient instance, or undefined if not configured
+     */
+    tryGetPublicClient(chainId) {
+        return this.publicClients.get(chainId);
+    }
     /**
      * Get bundler client for a specific chain
      * @param chainId - The chain ID to retrieve the bundler client for
@@ -41,14 +54,20 @@ export class ChainManager {
         const chainConfig = this.getChainConfig(chainId);
         const bundlerConfig = chainConfig.bundler;
         if (!bundlerConfig) {
-            throw new Error(`No bundler configured for chain ID: ${chainId}`);
+            throw new ChainNotSupportedError({
+                chainId,
+                supportedChainIds: this.getSupportedChains(),
+            });
         }
         if (bundlerConfig.type === 'pimlico') {
             return this.getPimlicoBundlerClient(chainId, account, bundlerConfig.sponsorshipPolicyId);
         }
         const bundlerUrl = this.getBundlerUrl(chainId);
         if (!bundlerUrl) {
-            throw new Error(`No bundler URL configured for chain ID: ${chainId}`);
+            throw new ChainNotSupportedError({
+                chainId,
+                supportedChainIds: this.getSupportedChains(),
+            });
         }
         const client = createPublicClient({
             chain: this.getChain(chainId),
@@ -80,7 +99,10 @@ export class ChainManager {
     getBundlerUrl(chainId) {
         const chainConfig = this.getChainConfig(chainId);
         if (!chainConfig.bundler) {
-            throw new Error(`No bundler configured for chain ID: ${chainId}`);
+            throw new ChainNotSupportedError({
+                chainId,
+                supportedChainIds: this.getSupportedChains(),
+            });
         }
         return chainConfig.bundler.url;
     }
@@ -122,10 +144,13 @@ export class ChainManager {
         for (const chainConfig of chains) {
             const chain = chainById[chainConfig.chainId];
             if (!chain) {
-                throw new Error(`Chain not found for ID: ${chainConfig.chainId}`);
+                throw new ChainNotSupportedError({ chainId: chainConfig.chainId });
             }
             if (clients.has(chainConfig.chainId)) {
-                throw new Error(`Public client already configured for chain ID: ${chainConfig.chainId}`);
+                throw new ChainNotSupportedError({
+                    chainId: chainConfig.chainId,
+                    supportedChainIds: Array.from(clients.keys()),
+                });
             }
             const client = createPublicClient({
                 chain,
@@ -143,7 +168,10 @@ export class ChainManager {
     getChainConfig(chainId) {
         const chainConfig = this.chainConfigs.find((c) => c.chainId === chainId);
         if (!chainConfig) {
-            throw new Error(`No chain config found for chain ID: ${chainId}`);
+            throw new ChainNotSupportedError({
+                chainId,
+                supportedChainIds: this.getSupportedChains(),
+            });
         }
         return chainConfig;
     }

package/dist/services/ChainManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChainManager.js","sourceRoot":"","sources":["../../src/services/ChainManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChainManager.js","sourceRoot":"","sources":["../../src/services/ChainManager.ts"],"names":[],"mappings":"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"}

package/dist/services/__mocks__/MockChainManager.d.ts

@@ -14,6 +14,7 @@ export interface MockChainManagerConfig {
 export declare class MockChainManager {
     getSupportedChains: MockedFunction<() => number[]>;
     getPublicClient: MockedFunction<(chainId: SupportedChainId) => PublicClient>;
+    tryGetPublicClient: MockedFunction<(chainId: SupportedChainId) => PublicClient | undefined>;
     getBundlerClient: MockedFunction<(chainId: SupportedChainId, account: SmartAccount) => BundlerClient>;
     private config;
     private publicClients;

package/dist/services/__mocks__/MockChainManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockChainManager.d.ts","sourceRoot":"","sources":["../../../src/services/__mocks__/MockChainManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE3E,OAAO,EAAE,KAAK,cAAc,EAAM,MAAM,QAAQ,CAAA;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,gBAAgB,EAAE,CAAA;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IACpB,kBAAkB,EAAE,cAAc,CAAC,MAAM,MAAM,EAAE,CAAC,CAAA;IAClD,eAAe,EAAE,cAAc,CACpC,CAAC,OAAO,EAAE,gBAAgB,KAAK,YAAY,CAC5C,CAAA;IACM,gBAAgB,EAAE,cAAc,CACrC,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,KAAK,aAAa,CACpE,CAAA;IAED,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,cAAc,CAAsC;gBAEhD,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAsCpD,KAAK,IAAI,IAAI;IASb,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK;IAI1C,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAI/C,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAGhC,OAAO;IAGtB,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,mBAAmB;CAO5B"}
+{"version":3,"file":"MockChainManager.d.ts","sourceRoot":"","sources":["../../../src/services/__mocks__/MockChainManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE3E,OAAO,EAAE,KAAK,cAAc,EAAM,MAAM,QAAQ,CAAA;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,gBAAgB,EAAE,CAAA;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IACpB,kBAAkB,EAAE,cAAc,CAAC,MAAM,MAAM,EAAE,CAAC,CAAA;IAClD,eAAe,EAAE,cAAc,CACpC,CAAC,OAAO,EAAE,gBAAgB,KAAK,YAAY,CAC5C,CAAA;IACM,kBAAkB,EAAE,cAAc,CACvC,CAAC,OAAO,EAAE,gBAAgB,KAAK,YAAY,GAAG,SAAS,CACxD,CAAA;IACM,gBAAgB,EAAE,cAAc,CACrC,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,KAAK,aAAa,CACpE,CAAA;IAED,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,cAAc,CAAsC;gBAEhD,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IA2CpD,KAAK,IAAI,IAAI;IASb,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK;IAI1C,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAI/C,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAGhC,OAAO;IAGtB,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/services/__mocks__/MockChainManager.js

@@ -27,6 +27,11 @@ export class MockChainManager {
             }
             return client;
         });
+        this.tryGetPublicClient = vi
+            .fn()
+            .mockImplementation((chainId) => {
+            return this.publicClients.get(chainId);
+        });
         this.getBundlerClient = vi
             .fn()
             .mockImplementation((chainId) => {

package/dist/services/__mocks__/MockChainManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockChainManager.js","sourceRoot":"","sources":["../../../src/services/__mocks__/MockChainManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MockChainManager.js","sourceRoot":"","sources":["../../../src/services/__mocks__/MockChainManager.ts"],"names":[],"mappings":"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"}

package/dist/services/__tests__/ChainManager.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChainManager.spec.d.ts","sourceRoot":"","sources":["../../../src/services/__tests__/ChainManager.spec.ts"],"names":[],"mappings":""}

package/dist/services/{ChainManager.spec.js → __tests__/ChainManager.spec.js}

@@ -5,7 +5,7 @@ import { createPublicClient, fallback, http } from 'viem';
 import { createBundlerClient } from 'viem/account-abstraction';
 import { unichain } from 'viem/chains';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { ChainManager } from './ChainManager.js';
+import { ChainManager } from '../ChainManager.js';
 vi.mock('viem', async () => ({
     // @ts-ignore - importActual returns unknown
     ...(await vi.importActual('viem')),
@@ -68,14 +68,14 @@ describe('ChainManager', () => {
                     rpcUrl: 'https://invalid.rpc',
                 },
             ];
-            expect(() => new ChainManager(invalidChainConfigs)).toThrow('Chain not found for ID: 99999');
+            expect(() => new ChainManager(invalidChainConfigs)).toThrow('Chain 99999 is not supported');
         });
         it('should throw error if multiple chains configured with the same chain ID', () => {
             const multiChainConfigs = [
                 { chainId: unichain.id, rpcUrls: ['https://sepolia.unichain.org'] },
                 { chainId: unichain.id, rpcUrls: ['https://another.rpc'] },
             ];
-            expect(() => new ChainManager(multiChainConfigs)).toThrow(`Public client already configured for chain ID: ${unichain.id}`);
+            expect(() => new ChainManager(multiChainConfigs)).toThrow(`Chain ${unichain.id} is not supported`);
         });
     });
     describe('getPublicClient', () => {
@@ -86,7 +86,7 @@ describe('ChainManager', () => {
         });
         it('should throw error for unsupported chain', () => {
             const unsupportedChainId = 999;
-            expect(() => chainManager.getPublicClient(unsupportedChainId)).toThrow('No public client configured for chain ID: 999');
+            expect(() => chainManager.getPublicClient(unsupportedChainId)).toThrow('Chain 999 is not supported');
         });
     });
     describe('getSupportedChains', () => {
@@ -138,7 +138,7 @@ describe('ChainManager', () => {
         });
         it('should throw error for unsupported chain', () => {
             const unsupportedChainId = 999;
-            expect(() => chainManager.getTransportForChain(unsupportedChainId)).toThrow('No chain config found for chain ID: 999');
+            expect(() => chainManager.getTransportForChain(unsupportedChainId)).toThrow('Chain 999 is not supported');
         });
     });
     describe('getBundlerClient', () => {
@@ -239,7 +239,7 @@ describe('ChainManager', () => {
                 },
             ];
             const mgr = new ChainManager(configs);
-            expect(() => mgr.getBundlerClient(unichain.id, mockAccount)).toThrow(`No bundler configured for chain ID: ${unichain.id}`);
+            expect(() => mgr.getBundlerClient(unichain.id, mockAccount)).toThrow(`Chain ${unichain.id} is not supported`);
         });
         it('throws when bundler URL is empty for simple bundler', () => {
             const configs = [
@@ -253,7 +253,7 @@ describe('ChainManager', () => {
                 },
             ];
             const mgr = new ChainManager(configs);
-            expect(() => mgr.getBundlerClient(unichain.id, mockAccount)).toThrow(`No bundler URL configured for chain ID: ${unichain.id}`);
+            expect(() => mgr.getBundlerClient(unichain.id, mockAccount)).toThrow(`Chain ${unichain.id} is not supported`);
         });
     });
 });

package/dist/services/__tests__/ChainManager.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChainManager.spec.js","sourceRoot":"","sources":["../../../src/services/__tests__/ChainManager.spec.ts"],"names":[],"mappings":"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"}

package/dist/services/__tests__/tokenBalance.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenBalance.spec.d.ts","sourceRoot":"","sources":["../../../src/services/__tests__/tokenBalance.spec.ts"],"names":[],"mappings":""}

package/dist/services/{tokenBalance.spec.js → __tests__/tokenBalance.spec.js}

@@ -1,9 +1,9 @@
-import { unichain } from 'viem/chains';
+import { base, optimism, unichain } from 'viem/chains';
 import { beforeEach, describe, expect, it } from 'vitest';
-import { MockUSDCAsset } from '../__mocks__/MockAssets.js';
-import { ETH } from '../constants/assets.js';
-import { MockChainManager } from './__mocks__/MockChainManager.js';
-import { fetchERC20Balance, fetchETHBalance } from './tokenBalance.js';
+import { MockUSDCAsset } from '../../__mocks__/MockAssets.js';
+import { ETH } from '../../constants/assets.js';
+import { MockChainManager } from '../__mocks__/MockChainManager.js';
+import { fetchERC20Balance, fetchETHBalance } from '../tokenBalance.js';
 describe('TokenBalance', () => {
     let chainManager;
     const walletAddress = '0x1234567890123456789012345678901234567890';
@@ -13,6 +13,10 @@ describe('TokenBalance', () => {
             defaultBalance: 1000000n,
         });
     });
+    const multiChainManager = () => new MockChainManager({
+        supportedChains: [optimism.id, base.id, unichain.id],
+        defaultBalance: 1000000n,
+    });
     describe('fetchBalance', () => {
         it('should fetch token balance across supported chains', async () => {
             const balance = await fetchERC20Balance(chainManager, walletAddress, MockUSDCAsset);
@@ -64,6 +68,39 @@ describe('TokenBalance', () => {
                 },
             });
         });
+        it('queries only the requested chains when chainIds is provided', async () => {
+            const cm = multiChainManager();
+            const balance = await fetchETHBalance(cm, walletAddress, {
+                chainIds: [base.id],
+            });
+            expect(balance.chains).toEqual({
+                [base.id]: { balance: 0.000000000001, balanceRaw: 1000000n },
+            });
+            expect(balance.totalBalanceRaw).toBe(1000000n);
+            expect(cm.getPublicClient).toHaveBeenCalledTimes(1);
+            expect(cm.getPublicClient).toHaveBeenCalledWith(base.id);
+        });
+    });
+    describe('fetchERC20Balance with chainIds filter', () => {
+        it('queries only the requested chains', async () => {
+            const cm = multiChainManager();
+            const balance = await fetchERC20Balance(cm, walletAddress, MockUSDCAsset, { chainIds: [optimism.id, base.id] });
+            expect(Object.keys(balance.chains).map(Number).sort()).toEqual([optimism.id, base.id].sort());
+            expect(balance.totalBalanceRaw).toBe(2000000n);
+        });
+        it('silently skips requested chains where the asset has no address', async () => {
+            const cm = multiChainManager();
+            const opOnly = {
+                ...MockUSDCAsset,
+                address: { [optimism.id]: MockUSDCAsset.address[optimism.id] },
+            };
+            const balance = await fetchERC20Balance(cm, walletAddress, opOnly, {
+                chainIds: [optimism.id, base.id],
+            });
+            expect(balance.chains).toEqual({
+                [optimism.id]: { balance: 1, balanceRaw: 1000000n },
+            });
+        });
     });
 });
 //# sourceMappingURL=tokenBalance.spec.js.map

package/dist/services/__tests__/tokenBalance.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenBalance.spec.js","sourceRoot":"","sources":["../../../src/services/__tests__/tokenBalance.spec.ts"],"names":[],"mappings":"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"}

package/dist/services/nameservices/ens/EnsNamespace.d.ts

@@ -0,0 +1,57 @@
+import { type Address } from 'viem';
+import type { ChainManager } from '../../ChainManager.js';
+import { type EnsInfo, type EnsName, type NameServiceProvider } from './types.js';
+/**
+ * Namespace for human-readable name resolution on Ethereum.
+ * Currently backed by ENS (Ethereum Name Service) on mainnet.
+ *
+ * Implements {@link NameServiceProvider} — designed to be extensible: future
+ * versions could support alternative name services alongside ENS (e.g. Basename,
+ * Unstoppable Domains, Lens handles). The natural evolution is additional
+ * NameServiceProvider implementations registered under their own namespace
+ * (e.g. `actions.basename`).
+ *
+ * Falls back to a public mainnet RPC automatically if mainnet is not included
+ * in your chain configuration, so ENS works even in L2-only setups.
+ */
+export declare class EnsNamespace implements NameServiceProvider {
+    private chainManager;
+    private readonly cacheTtlMs;
+    private addressCache;
+    private nameCache;
+    private infoCache;
+    constructor(chainManager: ChainManager, cacheTtlMs?: number);
+    /**
+     * Resolve an ENS name or hex address to a checksummed hex address.
+     * Hex addresses are returned as-is after format validation.
+     *
+     * If you need to resolve outside of an {@link Actions} instance (e.g. in a
+     * provider or script), use the lower-level `resolveAddress` utility instead.
+     * @param input - Hex address (0x...) or ENS name (e.g. "vitalik.eth")
+     * @returns Resolved hex address
+     * @throws {EnsResolutionError} If the name cannot be resolved
+     * @throws {EnsRpcError} If the RPC call fails
+     */
+    getAddress(input: Address | EnsName): Promise<Address>;
+    /**
+     * Reverse-resolve an address to its primary ENS name.
+     * @param address - Hex address to look up
+     * @returns ENS name, or null if none is set
+     * @throws {EnsRpcError} If the RPC call fails
+     */
+    getName(address: Address): Promise<EnsName | null>;
+    /**
+     * Fetch all standard ENS profile text record fields (ENSIP-5 / ENSIP-18)
+     * for an ENS name or address in a single batched call.
+     *
+     * All fields are null when not set. Returns all-null if the address has
+     * no primary ENS name.
+     * @param input - Hex address (0x...) or ENS name
+     * @returns EnsInfo object with all standard text record fields
+     * @throws {EnsResolutionError} If the name cannot be normalized
+     * @throws {EnsRpcError} If the RPC call fails
+     */
+    getInfo(input: Address | EnsName): Promise<EnsInfo>;
+    private getMainnetClient;
+}
+//# sourceMappingURL=EnsNamespace.d.ts.map

package/dist/services/nameservices/ens/EnsNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnsNamespace.d.ts","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/EnsNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA4B,MAAM,MAAM,CAAA;AAI7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAI9D,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EAEZ,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAA;AAsBnB;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IACtD,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,YAAY,CAGjB;IACH,OAAO,CAAC,SAAS,CAGd;IACH,OAAO,CAAC,SAAS,CAA2D;gBAEhE,YAAY,EAAE,YAAY,EAAE,UAAU,SAAuB;IAKzE;;;;;;;;;;OAUG;IACG,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAW5D;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAoBxD;;;;;;;;;;OAUG;IACG,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA2DzD,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/services/nameservices/ens/EnsNamespace.js

@@ -0,0 +1,158 @@
+import { createPublicClient, http } from 'viem';
+import { mainnet } from 'viem/chains';
+import { normalize } from 'viem/ens';
+import { resolveAddress } from './utils.js';
+import { EnsResolutionError, EnsRpcError } from './errors.js';
+import { isEnsName, } from './types.js';
+/** Default TTL for cached ENS lookups — 5 minutes */
+const DEFAULT_CACHE_TTL_MS = 5 * 60 * 1000;
+/** Public mainnet RPC used as fallback when mainnet is not in chain config */
+const FALLBACK_MAINNET_RPC = 'https://cloudflare-eth.com';
+/** ENSIP-5 / ENSIP-18 standard text record keys mapped to EnsInfo field names */
+const ENS_TEXT_KEYS = {
+    avatar: 'avatar',
+    display: 'display',
+    description: 'description',
+    url: 'url',
+    email: 'email',
+    keywords: 'keywords',
+    twitter: 'com.twitter',
+    github: 'com.github',
+    discord: 'com.discord',
+    reddit: 'org.reddit',
+};
+/**
+ * Namespace for human-readable name resolution on Ethereum.
+ * Currently backed by ENS (Ethereum Name Service) on mainnet.
+ *
+ * Implements {@link NameServiceProvider} — designed to be extensible: future
+ * versions could support alternative name services alongside ENS (e.g. Basename,
+ * Unstoppable Domains, Lens handles). The natural evolution is additional
+ * NameServiceProvider implementations registered under their own namespace
+ * (e.g. `actions.basename`).
+ *
+ * Falls back to a public mainnet RPC automatically if mainnet is not included
+ * in your chain configuration, so ENS works even in L2-only setups.
+ */
+export class EnsNamespace {
+    constructor(chainManager, cacheTtlMs = DEFAULT_CACHE_TTL_MS) {
+        this.addressCache = new Map();
+        this.nameCache = new Map();
+        this.infoCache = new Map();
+        this.chainManager = chainManager;
+        this.cacheTtlMs = cacheTtlMs;
+    }
+    /**
+     * Resolve an ENS name or hex address to a checksummed hex address.
+     * Hex addresses are returned as-is after format validation.
+     *
+     * If you need to resolve outside of an {@link Actions} instance (e.g. in a
+     * provider or script), use the lower-level `resolveAddress` utility instead.
+     * @param input - Hex address (0x...) or ENS name (e.g. "vitalik.eth")
+     * @returns Resolved hex address
+     * @throws {EnsResolutionError} If the name cannot be resolved
+     * @throws {EnsRpcError} If the RPC call fails
+     */
+    async getAddress(input) {
+        const cached = this.addressCache.get(input);
+        if (cached && Date.now() < cached.expiresAt)
+            return cached.value;
+        const value = await resolveAddress(input, this.getMainnetClient());
+        this.addressCache.set(input, {
+            value,
+            expiresAt: Date.now() + this.cacheTtlMs,
+        });
+        return value;
+    }
+    /**
+     * Reverse-resolve an address to its primary ENS name.
+     * @param address - Hex address to look up
+     * @returns ENS name, or null if none is set
+     * @throws {EnsRpcError} If the RPC call fails
+     */
+    async getName(address) {
+        const cached = this.nameCache.get(address);
+        if (cached && Date.now() < cached.expiresAt)
+            return cached.value;
+        const name = await this.getMainnetClient()
+            .getEnsName({ address })
+            .catch((cause) => {
+            throw new EnsRpcError(`ENS reverse resolution failed for "${address}": RPC error`, address, { cause });
+        });
+        const value = name && isEnsName(name) ? name : null;
+        this.nameCache.set(address, {
+            value,
+            expiresAt: Date.now() + this.cacheTtlMs,
+        });
+        return value;
+    }
+    /**
+     * Fetch all standard ENS profile text record fields (ENSIP-5 / ENSIP-18)
+     * for an ENS name or address in a single batched call.
+     *
+     * All fields are null when not set. Returns all-null if the address has
+     * no primary ENS name.
+     * @param input - Hex address (0x...) or ENS name
+     * @returns EnsInfo object with all standard text record fields
+     * @throws {EnsResolutionError} If the name cannot be normalized
+     * @throws {EnsRpcError} If the RPC call fails
+     */
+    async getInfo(input) {
+        const name = isEnsName(input) ? input : await this.getName(input);
+        if (!name)
+            return nullInfo();
+        const cached = this.infoCache.get(name);
+        if (cached && Date.now() < cached.expiresAt)
+            return cached.value;
+        const normalized = (() => {
+            try {
+                return normalize(name);
+            }
+            catch (cause) {
+                throw new EnsResolutionError(`ENS name "${name}" is invalid and cannot be normalized`, name, { cause });
+            }
+        })();
+        const client = this.getMainnetClient();
+        const fetchKey = (key) => client.getEnsText({ name: normalized, key }).catch((cause) => {
+            throw new EnsRpcError(`ENS text record lookup failed for "${name}" key "${key}": RPC error`, name, { cause });
+        });
+        const [avatar, display, description, url, email, keywords, twitter, github, discord, reddit,] = await Promise.all(Object.values(ENS_TEXT_KEYS).map(fetchKey));
+        const value = {
+            avatar: avatar ?? null,
+            display: display ?? null,
+            description: description ?? null,
+            url: url ?? null,
+            email: email ?? null,
+            keywords: keywords ?? null,
+            twitter: twitter ?? null,
+            github: github ?? null,
+            discord: discord ?? null,
+            reddit: reddit ?? null,
+        };
+        this.infoCache.set(name, { value, expiresAt: Date.now() + this.cacheTtlMs });
+        return value;
+    }
+    getMainnetClient() {
+        return (this.chainManager.tryGetPublicClient(mainnet.id) ??
+            createPublicClient({
+                chain: mainnet,
+                transport: http(FALLBACK_MAINNET_RPC),
+                batch: { multicall: true },
+            }));
+    }
+}
+function nullInfo() {
+    return {
+        avatar: null,
+        display: null,
+        description: null,
+        url: null,
+        email: null,
+        keywords: null,
+        twitter: null,
+        github: null,
+        discord: null,
+        reddit: null,
+    };
+}
+//# sourceMappingURL=EnsNamespace.js.map

package/dist/services/nameservices/ens/EnsNamespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnsNamespace.js","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/EnsNamespace.ts"],"names":[],"mappings":"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"}

package/dist/services/nameservices/ens/__tests__/EnsNamespace.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EnsNamespace.spec.d.ts.map

package/dist/services/nameservices/ens/__tests__/EnsNamespace.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnsNamespace.spec.d.ts","sourceRoot":"","sources":["../../../../../src/services/nameservices/ens/__tests__/EnsNamespace.spec.ts"],"names":[],"mappings":""}