@eth-optimism/actions-sdk 0.2.0 → 0.4.0

package/dist/utils/validateAddresses.test.js

@@ -0,0 +1,314 @@
+import { unichain } from 'viem/chains';
+import { describe, expect, it } from 'vitest';
+import { createMockPrivyClient, getMockAuthorizationContext, } from '../__mocks__/MockPrivyClient.js';
+import { Actions } from '../actions.js';
+import { NATIVELY_SUPPORTED_ASSETS, OP_DEMO, USDC_DEMO, } from '../constants/assets.js';
+import { POOL_ADDRESSES_MAINNET, POOL_ADDRESSES_TESTNET, WETH_GATEWAY_ADDRESSES_MAINNET, WETH_GATEWAY_ADDRESSES_TESTNET, } from '../lend/providers/aave/addresses.js';
+import { MORPHO_CONTRACTS } from '../lend/providers/morpho/contracts.js';
+import { UNISWAP_ADDRESSES } from '../swap/providers/uniswap/addresses.js';
+import { VELODROME_CHAINS } from '../swap/providers/velodrome/addresses.js';
+import { validateAddressMap, validateAssetAddresses, validateConfigAddresses, } from './validateAddresses.js';
+import { HostedWalletProviderRegistry } from '../wallet/core/providers/hosted/registry/HostedWalletProviderRegistry.js';
+import { PrivyHostedWalletProvider } from '../wallet/node/providers/hosted/privy/PrivyHostedWalletProvider.js';
+const VALID_ADDRESS = '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48';
+const VALID_ADDRESS_2 = '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2';
+const INVALID_ADDRESS = '0xabc';
+const INVALID_ADDRESS_2 = '0xdeadbeef';
+describe('validateAddressMap', () => {
+    it('throws when any address in the map is malformed, listing the bad address, key name, and chain ID', () => {
+        const map = {
+            10: { poolAddress: INVALID_ADDRESS },
+        };
+        expect(() => validateAddressMap(map)).toThrow(/poolAddress\[10\]/);
+        expect(() => validateAddressMap(map)).toThrow(INVALID_ADDRESS);
+    });
+    it('collects multiple failures and throws once with all of them listed', () => {
+        const map = {
+            10: { poolAddress: INVALID_ADDRESS },
+            8453: { rewardAddress: INVALID_ADDRESS_2 },
+        };
+        let err;
+        try {
+            validateAddressMap(map);
+        }
+        catch (e) {
+            err = e;
+        }
+        expect(err).toBeDefined();
+        expect(err.message).toMatch(/poolAddress\[10\]/);
+        expect(err.message).toMatch(/rewardAddress\[8453\]/);
+    });
+    it('passes for valid checksummed addresses', () => {
+        const map = {
+            10: { poolAddress: VALID_ADDRESS },
+            8453: { rewardAddress: VALID_ADDRESS_2 },
+        };
+        expect(() => validateAddressMap(map)).not.toThrow();
+    });
+    it('passes for valid lowercase (non-checksummed) addresses', () => {
+        const map = {
+            10: { poolAddress: VALID_ADDRESS.toLowerCase() },
+        };
+        expect(() => validateAddressMap(map)).not.toThrow();
+    });
+    it('returns the original map reference on success', () => {
+        const map = { 10: { poolAddress: VALID_ADDRESS } };
+        expect(validateAddressMap(map)).toBe(map);
+    });
+    it('handles simple Record<number, Address> values', () => {
+        const map = { 10: INVALID_ADDRESS };
+        expect(() => validateAddressMap(map)).toThrow(/\[10\]/);
+    });
+});
+describe('validateAssetAddresses', () => {
+    it("skips 'native' entries without throwing", () => {
+        const map = { 1: 'native', 10: 'native' };
+        expect(() => validateAssetAddresses(map)).not.toThrow();
+    });
+    it('throws with location info for invalid non-native addresses', () => {
+        const map = { 10: INVALID_ADDRESS };
+        expect(() => validateAssetAddresses(map)).toThrow(/\[10\]/);
+        expect(() => validateAssetAddresses(map)).toThrow(INVALID_ADDRESS);
+    });
+    it('collects multiple failures before throwing', () => {
+        const map = { 10: INVALID_ADDRESS, 8453: INVALID_ADDRESS_2 };
+        let err;
+        try {
+            validateAssetAddresses(map);
+        }
+        catch (e) {
+            err = e;
+        }
+        expect(err).toBeDefined();
+        expect(err.message).toMatch(/\[10\]/);
+        expect(err.message).toMatch(/\[8453\]/);
+    });
+    it('passes for valid addresses and skips native', () => {
+        const map = { 1: 'native', 10: VALID_ADDRESS };
+        expect(() => validateAssetAddresses(map)).not.toThrow();
+    });
+    it('passes for valid addresses', () => {
+        const map = { 10: VALID_ADDRESS };
+        expect(() => validateAssetAddresses(map)).not.toThrow();
+    });
+});
+describe('validateConfigAddresses', () => {
+    const validMarket = {
+        address: VALID_ADDRESS,
+        chainId: unichain.id,
+        name: 'Valid Market',
+        asset: {
+            address: { [unichain.id]: VALID_ADDRESS_2 },
+            metadata: { decimals: 18, name: 'WETH', symbol: 'WETH' },
+            type: 'erc20',
+        },
+        lendProvider: 'morpho',
+    };
+    const invalidMarketAddress = {
+        ...validMarket,
+        address: INVALID_ADDRESS,
+    };
+    const invalidAssetAddress = {
+        ...validMarket,
+        asset: {
+            ...validMarket.asset,
+            address: { [unichain.id]: INVALID_ADDRESS },
+        },
+    };
+    const validAsset = {
+        address: { [unichain.id]: VALID_ADDRESS },
+        metadata: { decimals: 6, name: 'USDC', symbol: 'USDC' },
+        type: 'erc20',
+    };
+    const invalidAsset = {
+        address: { [unichain.id]: INVALID_ADDRESS },
+        metadata: { decimals: 6, name: 'USDC', symbol: 'USDC' },
+        type: 'erc20',
+    };
+    it('throws with a descriptive message when a bad address appears in marketAllowlist', () => {
+        expect(() => validateConfigAddresses({
+            lend: { morpho: { marketAllowlist: [invalidMarketAddress] } },
+        })).toThrow(/lend\.morpho\.marketAllowlist/);
+    });
+    it('throws with a descriptive message when a bad address appears in marketBlocklist', () => {
+        expect(() => validateConfigAddresses({
+            lend: { morpho: { marketBlocklist: [invalidMarketAddress] } },
+        })).toThrow(/lend\.morpho\.marketBlocklist/);
+    });
+    it('throws with a descriptive message when a bad address appears in assets.allow', () => {
+        expect(() => validateConfigAddresses({ assets: { allow: [invalidAsset] } })).toThrow(/assets\.allow/);
+    });
+    it('throws with a descriptive message when a bad address appears in assets.block', () => {
+        expect(() => validateConfigAddresses({ assets: { block: [invalidAsset] } })).toThrow(/assets\.block/);
+    });
+    it('throws with a descriptive message when a bad address appears in lend.aave.marketAllowlist', () => {
+        expect(() => validateConfigAddresses({
+            lend: {
+                aave: {
+                    marketAllowlist: [
+                        { ...invalidMarketAddress, lendProvider: 'aave' },
+                    ],
+                },
+            },
+        })).toThrow(/lend\.aave\.marketAllowlist/);
+    });
+    it('throws with a descriptive message when a bad address appears in lend.aave.marketBlocklist', () => {
+        expect(() => validateConfigAddresses({
+            lend: {
+                aave: {
+                    marketBlocklist: [
+                        { ...invalidMarketAddress, lendProvider: 'aave' },
+                    ],
+                },
+            },
+        })).toThrow(/lend\.aave\.marketBlocklist/);
+    });
+    it('throws with a descriptive message when a bad address appears in swap.uniswap.marketAllowlist', () => {
+        expect(() => validateConfigAddresses({
+            swap: {
+                uniswap: {
+                    marketAllowlist: [{ assets: [invalidAsset, validAsset] }],
+                },
+            },
+        })).toThrow(/swap\.uniswap\.marketAllowlist/);
+    });
+    it('throws with a descriptive message when a bad address appears in swap.uniswap.marketBlocklist', () => {
+        expect(() => validateConfigAddresses({
+            swap: {
+                uniswap: {
+                    marketBlocklist: [{ assets: [invalidAsset, validAsset] }],
+                },
+            },
+        })).toThrow(/swap\.uniswap\.marketBlocklist/);
+    });
+    it('collects failures across multiple config sections and throws once with all of them', () => {
+        let err;
+        try {
+            validateConfigAddresses({
+                lend: {
+                    morpho: {
+                        marketAllowlist: [invalidMarketAddress],
+                        marketBlocklist: [invalidAssetAddress],
+                    },
+                },
+                assets: { allow: [invalidAsset] },
+            });
+        }
+        catch (e) {
+            err = e;
+        }
+        expect(err).toBeDefined();
+        expect(err.message).toMatch(/lend\.morpho\.marketAllowlist/);
+        expect(err.message).toMatch(/lend\.morpho\.marketBlocklist/);
+        expect(err.message).toMatch(/assets\.allow/);
+    });
+    it('returns void (no throw) when all addresses are valid', () => {
+        expect(() => validateConfigAddresses({
+            lend: { morpho: { marketAllowlist: [validMarket] } },
+            assets: { allow: [validAsset] },
+        })).not.toThrow();
+    });
+});
+describe('hardcoded address maps contain valid EVM addresses', () => {
+    it('all hardcoded address maps contain valid EVM addresses', () => {
+        expect(() => validateAddressMap(POOL_ADDRESSES_MAINNET)).not.toThrow();
+        expect(() => validateAddressMap(POOL_ADDRESSES_TESTNET)).not.toThrow();
+        expect(() => validateAddressMap(WETH_GATEWAY_ADDRESSES_MAINNET)).not.toThrow();
+        expect(() => validateAddressMap(WETH_GATEWAY_ADDRESSES_TESTNET)).not.toThrow();
+        expect(() => validateAddressMap(MORPHO_CONTRACTS)).not.toThrow();
+        expect(() => validateAddressMap(UNISWAP_ADDRESSES)).not.toThrow();
+        // Velodrome: contracts are cleanly separated from metadata
+        const veloContracts = Object.fromEntries(Object.entries(VELODROME_CHAINS).map(([id, cfg]) => [id, cfg.contracts]));
+        expect(() => validateAddressMap(veloContracts)).not.toThrow();
+    });
+    it('all hardcoded asset address maps contain valid EVM addresses', () => {
+        for (const asset of NATIVELY_SUPPORTED_ASSETS) {
+            expect(() => validateAssetAddresses(asset.address)).not.toThrow();
+        }
+        expect(() => validateAssetAddresses(USDC_DEMO.address)).not.toThrow();
+        expect(() => validateAssetAddresses(OP_DEMO.address)).not.toThrow();
+    });
+});
+describe('Actions constructor address validation', () => {
+    class TestHostedWalletProviderRegistry extends HostedWalletProviderRegistry {
+        constructor() {
+            super();
+            this.register({
+                type: 'privy',
+                validateOptions(options) {
+                    return Boolean(options?.privyClient);
+                },
+                create({ chainManager }, options) {
+                    return new PrivyHostedWalletProvider({
+                        privyClient: options.privyClient,
+                        chainManager,
+                        authorizationContext: options.authorizationContext,
+                    });
+                },
+            });
+        }
+    }
+    const baseWalletConfig = {
+        hostedWalletConfig: {
+            provider: {
+                type: 'privy',
+                config: {
+                    privyClient: createMockPrivyClient('test-id', 'test-secret'),
+                    authorizationContext: getMockAuthorizationContext(),
+                },
+            },
+        },
+        smartWalletConfig: { provider: { type: 'default' } },
+    };
+    it('throws on construction when ActionsConfig contains an invalid address', () => {
+        expect(() => new Actions({
+            chains: [{ chainId: unichain.id }],
+            lend: {
+                morpho: {
+                    marketAllowlist: [
+                        {
+                            address: '0xbad',
+                            chainId: unichain.id,
+                            name: 'Bad Market',
+                            asset: {
+                                address: { [unichain.id]: VALID_ADDRESS },
+                                metadata: { decimals: 18, name: 'WETH', symbol: 'WETH' },
+                                type: 'erc20',
+                            },
+                            lendProvider: 'morpho',
+                        },
+                    ],
+                },
+            },
+            wallet: baseWalletConfig,
+        }, {
+            hostedWalletProviderRegistry: new TestHostedWalletProviderRegistry(),
+        })).toThrow(/Invalid addresses found/);
+    });
+    it('constructs successfully when all addresses are valid', () => {
+        expect(() => new Actions({
+            chains: [{ chainId: unichain.id }],
+            lend: {
+                morpho: {
+                    marketAllowlist: [
+                        {
+                            address: VALID_ADDRESS,
+                            chainId: unichain.id,
+                            name: 'Valid Market',
+                            asset: {
+                                address: { [unichain.id]: VALID_ADDRESS_2 },
+                                metadata: { decimals: 18, name: 'WETH', symbol: 'WETH' },
+                                type: 'erc20',
+                            },
+                            lendProvider: 'morpho',
+                        },
+                    ],
+                },
+            },
+            wallet: baseWalletConfig,
+        }, {
+            hostedWalletProviderRegistry: new TestHostedWalletProviderRegistry(),
+        })).not.toThrow();
+    });
+});
+//# sourceMappingURL=validateAddresses.test.js.map

package/dist/utils/validateAddresses.test.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,12 @@
+import type { Address } from 'viem';
+import type { SupportedChainId } from '../constants/supportedChains.js';
+import type { Asset } from '../types/asset.js';
+export declare function validateAmountProvided(amountIn?: number, amountOut?: number): void;
+export declare function validateAmountPositiveIfExists(amount?: number): void;
+export declare function validateNotBothAmounts(amountIn?: number, amountOut?: number): void;
+export declare function validateNotSameAsset(assetIn: Asset, assetOut: Asset): void;
+export declare function validateNotZeroAddress(address: Address, label: string): void;
+export declare function validateSlippage(slippage: number, maxSlippage: number): void;
+export declare function validateChainSupported(chainId: number, supportedChainIds: readonly number[]): void;
+export declare function validateAssetOnChain(asset: Asset, chainId: SupportedChainId): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAK7C,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAIN;AAED,wBAAgB,8BAA8B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpE;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAIN;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,IAAI,CAO1E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI5E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAM5E;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,SAAS,MAAM,EAAE,GACnC,IAAI,CAMN;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAMN"}

package/dist/utils/validation.js

@@ -0,0 +1,44 @@
+import { isAssetSupportedOnChain } from './assets.js';
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+export function validateAmountProvided(amountIn, amountOut) {
+    if (amountIn === undefined && amountOut === undefined) {
+        throw new Error('Either amountIn or amountOut must be provided');
+    }
+}
+export function validateAmountPositiveIfExists(amount) {
+    if (amount !== undefined && amount <= 0) {
+        throw new Error('Amount must be positive');
+    }
+}
+export function validateNotBothAmounts(amountIn, amountOut) {
+    if (amountIn !== undefined && amountOut !== undefined) {
+        throw new Error('Provide either amountIn or amountOut, not both');
+    }
+}
+export function validateNotSameAsset(assetIn, assetOut) {
+    if (assetIn.metadata.symbol.toLowerCase() ===
+        assetOut.metadata.symbol.toLowerCase()) {
+        throw new Error('Cannot swap an asset for itself');
+    }
+}
+export function validateNotZeroAddress(address, label) {
+    if (address === ZERO_ADDRESS) {
+        throw new Error(`${label} cannot be the zero address`);
+    }
+}
+export function validateSlippage(slippage, maxSlippage) {
+    if (slippage < 0 || slippage > maxSlippage) {
+        throw new Error(`Slippage ${slippage} exceeds allowed range [0, ${maxSlippage * 100}%]`);
+    }
+}
+export function validateChainSupported(chainId, supportedChainIds) {
+    if (!supportedChainIds.includes(chainId)) {
+        throw new Error(`Chain ${chainId} is not supported. Supported chains: ${supportedChainIds.join(', ')}`);
+    }
+}
+export function validateAssetOnChain(asset, chainId) {
+    if (!isAssetSupportedOnChain(asset, chainId)) {
+        throw new Error(`Asset ${asset.metadata.symbol} not supported on chain ${chainId}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,MAAM,YAAY,GAAG,4CAA4C,CAAA;AAEjE,MAAM,UAAU,sBAAsB,CACpC,QAAiB,EACjB,SAAkB;IAElB,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAe;IAC5D,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAiB,EACjB,SAAkB;IAElB,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACnE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAc,EAAE,QAAe;IAClE,IACE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE;QACrC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,EACtC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACpD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,KAAa;IACpE,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAA;IACxD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,WAAmB;IACpE,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,YAAY,QAAQ,8BAA8B,WAAW,GAAG,GAAG,IAAI,CACxE,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,iBAAoC;IAEpC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,SAAS,OAAO,wCAAwC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvF,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAY,EACZ,OAAyB;IAEzB,IAAI,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,QAAQ,CAAC,MAAM,2BAA2B,OAAO,EAAE,CACnE,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/wallet/core/namespace/WalletNamespace.d.ts

@@ -6,27 +6,38 @@ import type { SmartWalletCreationResult } from '../providers/smart/abstract/type
 import type { WalletProvider } from '../providers/WalletProvider.js';
 import type { Wallet } from '../wallets/abstract/Wallet.js';
 import type { SmartWallet } from '../wallets/smart/abstract/SmartWallet.js';
+/**
+ * Provider factory function for lazy initialization
+ */
+type WalletProviderFactory<THostedProviderType extends string, TToActionsMap extends Record<THostedProviderType, unknown>, H extends HostedWalletProvider<THostedProviderType, TToActionsMap>, S extends SmartWalletProvider> = () => Promise<WalletProvider<THostedProviderType, TToActionsMap, H, S>>;
 /**
  * Wallet namespace that provides unified wallet operations
- * @description Provides access to wallet functionality through a single provider interface
+ * @description Provides access to wallet functionality through a single provider interface.
+ * Supports lazy initialization — the wallet provider is created on first method call,
+ * enabling tree-shaking of unused wallet provider dependencies.
  */
 export declare class WalletNamespace<THostedProviderType extends string, TToActionsMap extends Record<THostedProviderType, unknown>, H extends HostedWalletProvider<THostedProviderType, TToActionsMap> = HostedWalletProvider<THostedProviderType, TToActionsMap>, S extends SmartWalletProvider = SmartWalletProvider> {
-    private provider;
-    constructor(provider: WalletProvider<THostedProviderType, TToActionsMap, H, S>);
+    private _provider;
+    private _providerFactory;
+    private _initPromise;
+    constructor(providerOrFactory: WalletProvider<THostedProviderType, TToActionsMap, H, S> | WalletProviderFactory<THostedProviderType, TToActionsMap, H, S>);
+    private resolveProvider;
     /**
      * Get direct access to the hosted wallet provider
      * @description Provides direct access to the underlying hosted wallet provider when
-     * advanced functionality beyond the unified interface is needed
-     * @returns The configured hosted wallet provider instance
+     * advanced functionality beyond the unified interface is needed.
+     * Lazily initializes the provider if not yet created.
+     * @returns Promise resolving to the configured hosted wallet provider instance
      */
-    get hostedWalletProvider(): H;
+    hostedWalletProvider(): Promise<H>;
     /**
      * Get direct access to the smart wallet provider
      * @description Provides direct access to the underlying smart wallet provider when
-     * advanced functionality beyond the unified interface is needed
-     * @returns The configured smart wallet provider instance
+     * advanced functionality beyond the unified interface is needed.
+     * Lazily initializes the provider if not yet created.
+     * @returns Promise resolving to the configured smart wallet provider instance
      */
-    get smartWalletProvider(): S;
+    smartWalletProvider(): Promise<S>;
     /**
      * Create a new smart wallet
      * @description Creates a smart wallet and attempts to deploy it across all supported chains.
@@ -81,4 +92,5 @@ export declare class WalletNamespace<THostedProviderType extends string, TToActi
      */
     getSmartWallet(params: GetSmartWalletOptions): Promise<SmartWallet>;
 }
+export {};
 //# sourceMappingURL=WalletNamespace.d.ts.map

package/dist/wallet/core/namespace/WalletNamespace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WalletNamespace.d.ts","sourceRoot":"","sources":["../../../../src/wallet/core/namespace/WalletNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAA;AAC3G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAA;AACxG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAA;AAEtF;;;GAGG;AACH,qBAAa,eAAe,CAC1B,mBAAmB,SAAS,MAAM,EAClC,aAAa,SAAS,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAC1D,CAAC,SAAS,oBAAoB,CAAC,mBAAmB,EAAE,aAAa,CAAC,GAChE,oBAAoB,CAAC,mBAAmB,EAAE,aAAa,CAAC,EAC1D,CAAC,SAAS,mBAAmB,GAAG,mBAAmB;IAEnD,OAAO,CAAC,QAAQ,CAA0D;gBAGxE,QAAQ,EAAE,cAAc,CAAC,mBAAmB,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAKpE;;;;;OAKG;IACH,IAAI,oBAAoB,IAAI,CAAC,CAE5B;IAED;;;;;OAKG;IACH,IAAI,mBAAmB,IAAI,CAAC,CAE3B;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,iBAAiB,CACrB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAIlD;;;;;;;;OAQG;IACG,YAAY,CAChB,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACzC,OAAO,CAAC,YAAY,CAAC;IAIxB;;;;;;;OAOG;IACG,eAAe,CACnB,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;;;;;;;;;OAcG;IACG,cAAc,CAAC,MAAM,EAAE,qBAAqB;CAGnD"}
+{"version":3,"file":"WalletNamespace.d.ts","sourceRoot":"","sources":["../../../../src/wallet/core/namespace/WalletNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAA;AAC3G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAA;AACxG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAA;AAEtF;;GAEG;AACH,KAAK,qBAAqB,CACxB,mBAAmB,SAAS,MAAM,EAClC,aAAa,SAAS,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAC1D,CAAC,SAAS,oBAAoB,CAAC,mBAAmB,EAAE,aAAa,CAAC,EAClE,CAAC,SAAS,mBAAmB,IAC3B,MAAM,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAE3E;;;;;GAKG;AACH,qBAAa,eAAe,CAC1B,mBAAmB,SAAS,MAAM,EAClC,aAAa,SAAS,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAC1D,CAAC,SAAS,oBAAoB,CAAC,mBAAmB,EAAE,aAAa,CAAC,GAChE,oBAAoB,CAAC,mBAAmB,EAAE,aAAa,CAAC,EAC1D,CAAC,SAAS,mBAAmB,GAAG,mBAAmB;IAEnD,OAAO,CAAC,SAAS,CAKF;IACf,OAAO,CAAC,gBAAgB,CAKvB;IACD,OAAO,CAAC,YAAY,CAEL;gBAGb,iBAAiB,EACb,cAAc,CAAC,mBAAmB,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC,GACxD,qBAAqB,CAAC,mBAAmB,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAUrE,OAAO,CAAC,eAAe;IAavB;;;;;;OAMG;IACG,oBAAoB,IAAI,OAAO,CAAC,CAAC,CAAC;IAKxC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,CAAC,CAAC;IAKvC;;;;;;;;;;;;;;;;OAgBG;IACG,iBAAiB,CACrB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAKlD;;;;;;;;OAQG;IACG,YAAY,CAChB,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACzC,OAAO,CAAC,YAAY,CAAC;IAKxB;;;;;;;OAOG;IACG,eAAe,CACnB,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAKlB;;;;;;;;;;;;;;OAcG;IACG,cAAc,CAAC,MAAM,EAAE,qBAAqB;CAInD"}

package/dist/wallet/core/namespace/WalletNamespace.js

@@ -1,28 +1,53 @@
 /**
  * Wallet namespace that provides unified wallet operations
- * @description Provides access to wallet functionality through a single provider interface
+ * @description Provides access to wallet functionality through a single provider interface.
+ * Supports lazy initialization — the wallet provider is created on first method call,
+ * enabling tree-shaking of unused wallet provider dependencies.
  */
 export class WalletNamespace {
-    constructor(provider) {
-        this.provider = provider;
+    constructor(providerOrFactory) {
+        this._provider = null;
+        this._initPromise = null;
+        if (typeof providerOrFactory === 'function') {
+            this._providerFactory = providerOrFactory;
+        }
+        else {
+            this._provider = providerOrFactory;
+            this._providerFactory = () => Promise.resolve(providerOrFactory);
+        }
+    }
+    resolveProvider() {
+        if (this._provider)
+            return Promise.resolve(this._provider);
+        if (!this._initPromise) {
+            this._initPromise = this._providerFactory().then((provider) => {
+                this._provider = provider;
+                return provider;
+            });
+        }
+        return this._initPromise;
     }
     /**
      * Get direct access to the hosted wallet provider
      * @description Provides direct access to the underlying hosted wallet provider when
-     * advanced functionality beyond the unified interface is needed
-     * @returns The configured hosted wallet provider instance
+     * advanced functionality beyond the unified interface is needed.
+     * Lazily initializes the provider if not yet created.
+     * @returns Promise resolving to the configured hosted wallet provider instance
      */
-    get hostedWalletProvider() {
-        return this.provider.hostedWalletProvider;
+    async hostedWalletProvider() {
+        const provider = await this.resolveProvider();
+        return provider.hostedWalletProvider;
     }
     /**
      * Get direct access to the smart wallet provider
      * @description Provides direct access to the underlying smart wallet provider when
-     * advanced functionality beyond the unified interface is needed
-     * @returns The configured smart wallet provider instance
+     * advanced functionality beyond the unified interface is needed.
+     * Lazily initializes the provider if not yet created.
+     * @returns Promise resolving to the configured smart wallet provider instance
      */
-    get smartWalletProvider() {
-        return this.provider.smartWalletProvider;
+    async smartWalletProvider() {
+        const provider = await this.resolveProvider();
+        return provider.smartWalletProvider;
     }
     /**
      * Create a new smart wallet
@@ -42,7 +67,8 @@ export class WalletNamespace {
      * @throws Error if signer is not included in the signers array
      */
     async createSmartWallet(params) {
-        return this.provider.createSmartWallet(params);
+        const provider = await this.resolveProvider();
+        return provider.createSmartWallet(params);
     }
     /**
      * Create a viem LocalAccount signer from the hosted wallet
@@ -54,7 +80,8 @@ export class WalletNamespace {
      * @returns Promise resolving to a viem `LocalAccount` with the hosted wallet as the signer backend
      */
     async createSigner(params) {
-        return this.provider.createSigner(params);
+        const provider = await this.resolveProvider();
+        return provider.createSigner(params);
     }
     /**
      * Convert a hosted wallet to an Actions wallet
@@ -65,7 +92,8 @@ export class WalletNamespace {
      * @returns Promise resolving to the Actions wallet instance
      */
     async toActionsWallet(params) {
-        return this.provider.hostedWalletToActionsWallet(params);
+        const provider = await this.resolveProvider();
+        return provider.hostedWalletToActionsWallet(params);
     }
     /**
      * Get an existing smart wallet with a provided signer
@@ -83,7 +111,8 @@ export class WalletNamespace {
      * @throws Error if neither walletAddress nor deploymentSigners provided
      */
     async getSmartWallet(params) {
-        return this.provider.getSmartWallet(params);
+        const provider = await this.resolveProvider();
+        return provider.getSmartWallet(params);
     }
 }
 //# sourceMappingURL=WalletNamespace.js.map

package/dist/wallet/core/namespace/WalletNamespace.js.map

@@ -1 +1 @@
-{"version":3,"file":"WalletNamespace.js","sourceRoot":"","sources":["../../../../src/wallet/core/namespace/WalletNamespace.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,OAAO,eAAe;IAS1B,YACE,QAAkE;QAElE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAED;;;;;OAKG;IACH,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAA;IAC3C,CAAC;IAED;;;;;OAKG;IACH,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAA;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,iBAAiB,CACrB,MAAgC;QAEhC,OAAO,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAChD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAChB,MAA0C;QAE1C,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CACnB,MAA0C;QAE1C,OAAO,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IAC1D,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,cAAc,CAAC,MAA6B;QAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;IAC7C,CAAC;CACF"}
+{"version":3,"file":"WalletNamespace.js","sourceRoot":"","sources":["../../../../src/wallet/core/namespace/WalletNamespace.ts"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAuB1B,YACE,iBAEmE;QAnB7D,cAAS,GAKN,IAAI,CAAA;QAOP,iBAAY,GAET,IAAI,CAAA;QAOb,IAAI,OAAO,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC5C,IAAI,CAAC,gBAAgB,GAAG,iBAAiB,CAAA;QAC3C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,GAAG,iBAAiB,CAAA;YAClC,IAAI,CAAC,gBAAgB,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;IAEO,eAAe;QAGrB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC1D,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC5D,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;gBACzB,OAAO,QAAQ,CAAA;YACjB,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,oBAAoB;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;QAC7C,OAAO,QAAQ,CAAC,oBAAoB,CAAA;IACtC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;QAC7C,OAAO,QAAQ,CAAC,mBAAmB,CAAA;IACrC,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,iBAAiB,CACrB,MAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;QAC7C,OAAO,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAChB,MAA0C;QAE1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;QAC7C,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CACnB,MAA0C;QAE1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;QAC7C,OAAO,QAAQ,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACrD,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,cAAc,CAAC,MAA6B;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;QAC7C,OAAO,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;IACxC,CAAC;CACF"}

package/dist/wallet/core/namespace/__tests__/WalletNamespace.spec.js

@@ -25,7 +25,7 @@ describe('WalletNamespace', () => {
         vi.clearAllMocks();
     });
     describe('hostedWalletProvider', () => {
-        it('should provide access to hosted wallet provider', () => {
+        it('should provide access to hosted wallet provider', async () => {
             const hostedWalletProvider = new PrivyHostedWalletProvider({
                 privyClient: mockPrivyClient,
                 chainManager: mockChainManager,
@@ -34,11 +34,11 @@ describe('WalletNamespace', () => {
             const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, { morpho: mockLendProvider });
             const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
             const walletNamespace = new WalletNamespace(walletProvider);
-            expect(walletNamespace.hostedWalletProvider).toBe(hostedWalletProvider);
+            expect(await walletNamespace.hostedWalletProvider()).toBe(hostedWalletProvider);
         });
     });
     describe('smartWalletProvider', () => {
-        it('should provide access to smart wallet provider', () => {
+        it('should provide access to smart wallet provider', async () => {
             const mockPrivyClient = createMockPrivyClient('test-app-id', 'test-app-secret');
             const hostedWalletProvider = new PrivyHostedWalletProvider({
                 privyClient: mockPrivyClient,
@@ -48,7 +48,7 @@ describe('WalletNamespace', () => {
             const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, { morpho: mockLendProvider });
             const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
             const walletNamespace = new WalletNamespace(walletProvider);
-            expect(walletNamespace.smartWalletProvider).toBe(smartWalletProvider);
+            expect(await walletNamespace.smartWalletProvider()).toBe(smartWalletProvider);
         });
     });
     describe('createSmartWallet', () => {