@eth-optimism/actions-sdk 0.0.0-main-20251009211102

package/dist/wallet/core/providers/__tests__/WalletProvider.spec.js

@@ -0,0 +1,246 @@
+import { unichain } from 'viem/chains';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { MockChainManager } from '../../../../test/MockChainManager.js';
+import { createMockLendProvider } from '../../../../test/MockLendProvider.js';
+import { createMockPrivyClient } from '../../../../test/MockPrivyClient.js';
+import { getRandomAddress } from '../../../../test/utils.js';
+import { DefaultSmartWalletProvider } from '../smart/default/DefaultSmartWalletProvider.js';
+import { WalletProvider } from '../WalletProvider.js';
+import { Wallet } from '../../wallets/abstract/Wallet.js';
+import { DefaultSmartWallet } from '../../wallets/smart/default/DefaultSmartWallet.js';
+import { SmartWalletDeploymentError } from '../../wallets/smart/error/errors.js';
+import { PrivyHostedWalletProvider } from '../../../node/providers/hosted/privy/PrivyHostedWalletProvider.js';
+const mockChainManager = new MockChainManager({
+    supportedChains: [unichain.id],
+});
+const mockLendProvider = createMockLendProvider();
+describe('WalletProvider', () => {
+    let mockPrivyClient;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockPrivyClient = createMockPrivyClient('test-app-id', 'test-app-secret');
+    });
+    describe('createSmartWallet', () => {
+        it('should create a smart wallet and return deployment result', async () => {
+            const hostedWalletProvider = new PrivyHostedWalletProvider(mockPrivyClient, mockChainManager);
+            const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, mockLendProvider);
+            const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
+            // Create a hosted wallet to use as signer
+            const hostedWallet = (await hostedWalletProvider.toActionsWallet({
+                walletId: 'mock-wallet-1',
+                address: getRandomAddress(),
+            }));
+            const signer = hostedWallet.signer;
+            const signers = [getRandomAddress(), hostedWallet.address];
+            const nonce = BigInt(123);
+            const mockWallet = {};
+            const mockDeploymentResult = {
+                wallet: mockWallet,
+                deployments: [
+                    {
+                        chainId: unichain.id,
+                        receipt: undefined,
+                        success: true,
+                    },
+                ],
+            };
+            const createWalletSpy = vi
+                .spyOn(smartWalletProvider, 'createWallet')
+                .mockResolvedValue(mockDeploymentResult);
+            const result = await walletProvider.createSmartWallet({
+                signers,
+                signer,
+                nonce,
+            });
+            expect(createWalletSpy).toHaveBeenCalledWith({
+                signers,
+                signer,
+                nonce,
+            });
+            expect(result).toEqual(mockDeploymentResult);
+        });
+        it('should pass through deployment successes and failures', async () => {
+            const hostedWalletProvider = new PrivyHostedWalletProvider(mockPrivyClient, mockChainManager);
+            const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, mockLendProvider);
+            const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
+            const hostedWallet = (await hostedWalletProvider.toActionsWallet({
+                walletId: 'mock-wallet-1',
+                address: getRandomAddress(),
+            }));
+            const signer = hostedWallet.signer;
+            const signers = [getRandomAddress(), hostedWallet.address];
+            const mockWallet = {};
+            const mockReceipt = {
+                success: true,
+            };
+            const mockDeploymentResult = {
+                wallet: mockWallet,
+                deployments: [
+                    {
+                        chainId: unichain.id,
+                        receipt: mockReceipt,
+                        success: true,
+                    },
+                    {
+                        chainId: 8453,
+                        receipt: mockReceipt,
+                        success: false,
+                        error: new SmartWalletDeploymentError('Deployment failed', 8453),
+                    },
+                ],
+            };
+            vi.spyOn(smartWalletProvider, 'createWallet').mockResolvedValue(mockDeploymentResult);
+            const result = await walletProvider.createSmartWallet({
+                signers,
+                signer,
+            });
+            expect(result).toEqual(mockDeploymentResult);
+        });
+        it('should forward deploymentChainIds parameter', async () => {
+            const hostedWalletProvider = new PrivyHostedWalletProvider(mockPrivyClient, mockChainManager);
+            const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, mockLendProvider);
+            const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
+            const hostedWallet = (await hostedWalletProvider.toActionsWallet({
+                walletId: 'mock-wallet-1',
+                address: getRandomAddress(),
+            }));
+            const signer = hostedWallet.signer;
+            const signers = [getRandomAddress(), hostedWallet.address];
+            const deploymentChainIds = [8453];
+            const mockWallet = {};
+            const mockDeploymentResult = {
+                wallet: mockWallet,
+                deployments: [
+                    {
+                        chainId: 8453,
+                        receipt: undefined,
+                        success: true,
+                    },
+                ],
+            };
+            const createWalletSpy = vi
+                .spyOn(smartWalletProvider, 'createWallet')
+                .mockResolvedValue(mockDeploymentResult);
+            const result = await walletProvider.createSmartWallet({
+                signers,
+                signer,
+                deploymentChainIds,
+            });
+            expect(createWalletSpy).toHaveBeenCalledWith({
+                signers,
+                signer,
+                deploymentChainIds,
+            });
+            expect(result).toEqual(mockDeploymentResult);
+        });
+        it('should throw error if signer is not in signers array', async () => {
+            const hostedWalletProvider = new PrivyHostedWalletProvider(mockPrivyClient, mockChainManager);
+            const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, mockLendProvider);
+            const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
+            const hostedWallet = (await hostedWalletProvider.toActionsWallet({
+                walletId: 'mock-wallet-1',
+                address: getRandomAddress(),
+            }));
+            const signer = hostedWallet.signer;
+            // Signer is NOT in the signers array
+            const signers = [getRandomAddress(), getRandomAddress()];
+            await expect(walletProvider.createSmartWallet({
+                signers,
+                signer,
+            })).rejects.toThrow('Signer does not match any signer in the signers array');
+        });
+    });
+    describe('getSmartWallet', () => {
+        it('should get a smart wallet with provided signer', async () => {
+            const hostedWalletProvider = new PrivyHostedWalletProvider(mockPrivyClient, mockChainManager);
+            const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, mockLendProvider);
+            const mockWalletAddress = getRandomAddress();
+            const getWalletAddressSpy = vi
+                .spyOn(smartWalletProvider, 'getWalletAddress')
+                .mockResolvedValue(mockWalletAddress);
+            const getWalletSpy = vi.spyOn(smartWalletProvider, 'getWallet');
+            const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
+            const hostedWallet = (await hostedWalletProvider.toActionsWallet({
+                walletId: 'mock-wallet-1',
+                address: getRandomAddress(),
+            }));
+            const signer = hostedWallet.signer;
+            const deploymentSigners = [hostedWallet.address, getRandomAddress()];
+            const nonce = BigInt(789);
+            const smartWallet = await walletProvider.getSmartWallet({
+                signer,
+                deploymentSigners,
+                signers: [signer.address],
+                nonce,
+            });
+            expect(smartWallet).toBeInstanceOf(DefaultSmartWallet);
+            expect(getWalletAddressSpy).toHaveBeenCalledWith({
+                signers: deploymentSigners,
+                nonce,
+            });
+            expect(getWalletSpy).toHaveBeenCalledWith({
+                walletAddress: mockWalletAddress,
+                signer,
+                signers: [signer.address],
+            });
+        });
+        it('should throw error when getting smart wallet without required parameters', async () => {
+            const hostedWalletProvider = new PrivyHostedWalletProvider(mockPrivyClient, mockChainManager);
+            const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, mockLendProvider);
+            const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
+            const hostedWallet = (await hostedWalletProvider.toActionsWallet({
+                walletId: 'mock-wallet-1',
+                address: getRandomAddress(),
+            }));
+            const signer = hostedWallet.signer;
+            await expect(walletProvider.getSmartWallet({
+                signer,
+                signers: [signer.address],
+                // Missing both walletAddress and deploymentSigners
+            })).rejects.toThrow('Either walletAddress or deploymentSigners array must be provided to locate the smart wallet');
+        });
+    });
+    describe('hostedWalletToActionsWallet', () => {
+        it('should convert a hosted wallet to an Actions wallet', async () => {
+            const hostedWalletProvider = new PrivyHostedWalletProvider(mockPrivyClient, mockChainManager);
+            const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, mockLendProvider);
+            const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
+            const toActionsWalletSpy = vi.spyOn(hostedWalletProvider, 'toActionsWallet');
+            const privyWallet = await mockPrivyClient.walletApi.createWallet({
+                chainType: 'ethereum',
+            });
+            const hostedWallet = await walletProvider.hostedWalletToActionsWallet({
+                walletId: privyWallet.id,
+                address: privyWallet.address,
+            });
+            expect(toActionsWalletSpy).toHaveBeenCalledWith({
+                walletId: privyWallet.id,
+                address: privyWallet.address,
+            });
+            expect(hostedWallet).toBeInstanceOf(Wallet);
+            expect(hostedWallet.signer.address).toBe(privyWallet.address);
+            expect(hostedWallet.address).toBe(privyWallet.address);
+        });
+    });
+    describe('createSigner', () => {
+        it('should delegate to hosted wallet provider createSigner', async () => {
+            const mockPrivyClient = createMockPrivyClient('test-app-id', 'test-app-secret');
+            const hostedWalletProvider = new PrivyHostedWalletProvider(mockPrivyClient, mockChainManager);
+            const smartWalletProvider = new DefaultSmartWalletProvider(mockChainManager, mockLendProvider);
+            const walletProvider = new WalletProvider(hostedWalletProvider, smartWalletProvider);
+            const createSignerSpy = vi.spyOn(hostedWalletProvider, 'createSigner');
+            const privyWallet = await mockPrivyClient.walletApi.createWallet({
+                chainType: 'ethereum',
+            });
+            const params = {
+                walletId: privyWallet.id,
+                address: privyWallet.address,
+            };
+            const signer = await walletProvider.createSigner(params);
+            expect(createSignerSpy).toHaveBeenCalledWith(params);
+            expect(signer.address).toBe(privyWallet.address);
+            expect(signer.type).toBe('local');
+        });
+    });
+});
+//# sourceMappingURL=WalletProvider.spec.js.map

package/dist/wallet/core/providers/__tests__/WalletProvider.spec.js.map

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

package/dist/wallet/core/providers/hosted/abstract/HostedWalletProvider.d.ts

@@ -0,0 +1,33 @@
+import type { LocalAccount } from 'viem';
+import type { ChainManager } from '../../../../../services/ChainManager.js';
+import type { LendConfig, LendProvider } from '../../../../../types/lend/index.js';
+import type { Wallet } from '../../../wallets/abstract/Wallet.js';
+/**
+ * Base hosted wallet provider class
+ * @description Abstract base class for hosted wallet provider implementations (Privy, Dynamic, etc.).
+ * Provides a standard interface for creating and retrieving hosted wallets that can be used
+ * as signers for smart wallets or standalone wallet functionality.
+ */
+export declare abstract class HostedWalletProvider<TType extends string, TOptionsMap extends Record<TType, unknown>> {
+    protected chainManager: ChainManager;
+    protected lendProvider?: LendProvider<LendConfig>;
+    protected constructor(chainManager: ChainManager, lendProvider?: LendProvider<LendConfig>);
+    /**
+     * Convert a hosted wallet to an Actions wallet
+     * @description Converts a hosted wallet to an Actions wallet instance.
+     * @param params - Parameters for converting a hosted wallet to an Actions wallet
+     * @returns Promise resolving to the Actions wallet instance
+     */
+    abstract toActionsWallet(params: TOptionsMap[TType]): Promise<Wallet>;
+    /**
+     * Create a viem LocalAccount signer from the hosted wallet
+     * @description Produces a signing account backed by the hosted wallet without wrapping
+     * it in a full Actions wallet. This is useful when you need to pass the signer
+     * into an Actions smart wallet as a signer, for lower-level viem operations, or
+     * for passing to other libraries that accept a viem `LocalAccount`.
+     * @param params - Configuration for the signer
+     * @returns Promise resolving to a viem `LocalAccount` with the hosted wallet as the signer backend
+     */
+    abstract createSigner(params: TOptionsMap[TType]): Promise<LocalAccount>;
+}
+//# sourceMappingURL=HostedWalletProvider.d.ts.map

package/dist/wallet/core/providers/hosted/abstract/HostedWalletProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostedWalletProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/wallet/core/providers/hosted/abstract/HostedWalletProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AAEtE;;;;;GAKG;AACH,8BAAsB,oBAAoB,CACxC,KAAK,SAAS,MAAM,EACpB,WAAW,SAAS,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC;IAE1C,SAAS,CAAC,YAAY,EAAE,YAAY,CAAA;IACpC,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;IAEjD,SAAS,aACP,YAAY,EAAE,YAAY,EAC1B,YAAY,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC;IAKzC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAErE;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;CACzE"}

package/dist/wallet/core/providers/hosted/abstract/HostedWalletProvider.js

@@ -0,0 +1,13 @@
+/**
+ * Base hosted wallet provider class
+ * @description Abstract base class for hosted wallet provider implementations (Privy, Dynamic, etc.).
+ * Provides a standard interface for creating and retrieving hosted wallets that can be used
+ * as signers for smart wallets or standalone wallet functionality.
+ */
+export class HostedWalletProvider {
+    constructor(chainManager, lendProvider) {
+        this.chainManager = chainManager;
+        this.lendProvider = lendProvider;
+    }
+}
+//# sourceMappingURL=HostedWalletProvider.js.map

package/dist/wallet/core/providers/hosted/abstract/HostedWalletProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostedWalletProvider.js","sourceRoot":"","sources":["../../../../../../src/wallet/core/providers/hosted/abstract/HostedWalletProvider.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,OAAgB,oBAAoB;IAOxC,YACE,YAA0B,EAC1B,YAAuC;QAEvC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IAClC,CAAC;CAmBF"}

package/dist/wallet/core/providers/hosted/registry/HostedWalletProviderRegistry.d.ts

@@ -0,0 +1,20 @@
+import type { HostedProviderFactory } from '../types/index.js';
+/**
+ * Base registry for hosted wallet providers.
+ * Maintains a map of provider factories keyed by provider type.
+ * Environment-specific subclasses register available providers.
+ */
+export declare abstract class HostedWalletProviderRegistry<TInstanceMap extends Record<TProviderType, unknown>, TConfigMap extends Record<TProviderType, unknown>, TProviderType extends keyof TInstanceMap & keyof TConfigMap & string> {
+    protected readonly registry: Map<TProviderType, HostedProviderFactory<TProviderType, TInstanceMap[TProviderType], TConfigMap[TProviderType]>>;
+    /**
+     * Get a provider factory by type.
+     * Throws if the provider type is not registered.
+     */
+    getFactory<TType extends TProviderType>(type: TType): HostedProviderFactory<TType, TInstanceMap[TType], TConfigMap[TType]>;
+    /**
+     * Register a provider factory if not already present.
+     * Intended for use by subclasses during construction.
+     */
+    protected register<T extends TProviderType>(factory: HostedProviderFactory<T, TInstanceMap[T], TConfigMap[T]>): void;
+}
+//# sourceMappingURL=HostedWalletProviderRegistry.d.ts.map

package/dist/wallet/core/providers/hosted/registry/HostedWalletProviderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostedWalletProviderRegistry.d.ts","sourceRoot":"","sources":["../../../../../../src/wallet/core/providers/hosted/registry/HostedWalletProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAA;AAE1F;;;;GAIG;AACH,8BAAsB,4BAA4B,CAChD,YAAY,SAAS,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,EACnD,UAAU,SAAS,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,EACjD,aAAa,SAAS,MAAM,YAAY,GAAG,MAAM,UAAU,GAAG,MAAM;IAEpE,SAAS,CAAC,QAAQ,CAAC,QAAQ,mHAOxB;IAEH;;;OAGG;IACH,UAAU,CAAC,KAAK,SAAS,aAAa,EACpC,IAAI,EAAE,KAAK,GACV,qBAAqB,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAQvE;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,aAAa,EACxC,OAAO,EAAE,qBAAqB,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CAKpE"}

package/dist/wallet/core/providers/hosted/registry/HostedWalletProviderRegistry.js

@@ -0,0 +1,29 @@
+/**
+ * Base registry for hosted wallet providers.
+ * Maintains a map of provider factories keyed by provider type.
+ * Environment-specific subclasses register available providers.
+ */
+export class HostedWalletProviderRegistry {
+    constructor() {
+        this.registry = new Map();
+    }
+    /**
+     * Get a provider factory by type.
+     * Throws if the provider type is not registered.
+     */
+    getFactory(type) {
+        const factory = this.registry.get(type);
+        if (!factory)
+            throw new Error(`Unknown hosted wallet provider: ${type}`);
+        return factory;
+    }
+    /**
+     * Register a provider factory if not already present.
+     * Intended for use by subclasses during construction.
+     */
+    register(factory) {
+        if (!this.registry.has(factory.type))
+            this.registry.set(factory.type, factory);
+    }
+}
+//# sourceMappingURL=HostedWalletProviderRegistry.js.map

package/dist/wallet/core/providers/hosted/registry/HostedWalletProviderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostedWalletProviderRegistry.js","sourceRoot":"","sources":["../../../../../../src/wallet/core/providers/hosted/registry/HostedWalletProviderRegistry.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAgB,4BAA4B;IAAlD;QAKqB,aAAQ,GAAG,IAAI,GAAG,EAOlC,CAAA;IA0BL,CAAC;IAxBC;;;OAGG;IACH,UAAU,CACR,IAAW;QAEX,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAEzB,CAAA;QACb,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAA;QACxE,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;OAGG;IACO,QAAQ,CAChB,OAAiE;QAEjE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC;CACF"}

package/dist/wallet/core/providers/hosted/registry/__tests__/HostedWalletProviderRegistry.spec.d.ts

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

package/dist/wallet/core/providers/hosted/registry/__tests__/HostedWalletProviderRegistry.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostedWalletProviderRegistry.spec.d.ts","sourceRoot":"","sources":["../../../../../../../src/wallet/core/providers/hosted/registry/__tests__/HostedWalletProviderRegistry.spec.ts"],"names":[],"mappings":""}

package/dist/wallet/core/providers/hosted/registry/__tests__/HostedWalletProviderRegistry.spec.js

@@ -0,0 +1,52 @@
+import { unichain } from 'viem/chains';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { MockChainManager } from '../../../../../../test/MockChainManager.js';
+import { createMockPrivyClient } from '../../../../../../test/MockPrivyClient.js';
+import { HostedWalletProviderRegistry } from '../HostedWalletProviderRegistry.js';
+import { PrivyHostedWalletProvider } from '../../../../../node/providers/hosted/privy/PrivyHostedWalletProvider.js';
+class TestHostedWalletProviderRegistry extends HostedWalletProviderRegistry {
+    constructor() {
+        super();
+        this.register({
+            type: 'privy',
+            validateOptions(options) {
+                return Boolean(options?.privyClient);
+            },
+            create({ chainManager }, options) {
+                return new PrivyHostedWalletProvider(options.privyClient, chainManager);
+            },
+        });
+    }
+}
+describe('HostedWalletProviderRegistry', () => {
+    const mockChainManager = new MockChainManager({
+        supportedChains: [unichain.id],
+    });
+    let mockPrivyClient;
+    beforeEach(() => {
+        mockPrivyClient = createMockPrivyClient('test-app-id', 'test-app-secret');
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it('returns privy factory and validates options', () => {
+        const registry = new TestHostedWalletProviderRegistry();
+        const factory = registry.getFactory('privy');
+        expect(factory.type).toBe('privy');
+        expect(factory.validateOptions?.({ privyClient: mockPrivyClient })).toBe(true);
+        // Invalid shape should not pass validation
+        expect(factory.validateOptions?.({})).toBe(false);
+    });
+    it('creates a PrivyHostedWalletProvider instance', () => {
+        const registry = new TestHostedWalletProviderRegistry();
+        const factory = registry.getFactory('privy');
+        const provider = factory.create({ chainManager: mockChainManager }, { privyClient: mockPrivyClient });
+        expect(provider).toBeInstanceOf(PrivyHostedWalletProvider);
+    });
+    it('throws for unknown provider type', () => {
+        const registry = new TestHostedWalletProviderRegistry();
+        // @ts-expect-error: testing runtime error for unknown type
+        expect(() => registry.getFactory('unknown')).toThrow('Unknown hosted wallet provider: unknown');
+    });
+});
+//# sourceMappingURL=HostedWalletProviderRegistry.spec.js.map

package/dist/wallet/core/providers/hosted/registry/__tests__/HostedWalletProviderRegistry.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostedWalletProviderRegistry.spec.js","sourceRoot":"","sources":["../../../../../../../src/wallet/core/providers/hosted/registry/__tests__/HostedWalletProviderRegistry.spec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAGxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,yEAAyE,CAAA;AACtH,OAAO,EAAE,yBAAyB,EAAE,MAAM,mEAAmE,CAAA;AAI7G,MAAM,gCAAiC,SAAQ,4BAI9C;IACC;QACE,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,QAAQ,CAAU;YACrB,IAAI,EAAE,OAAO;YACb,eAAe,CAAC,OAAO;gBACrB,OAAO,OAAO,CAAE,OAAmC,EAAE,WAAW,CAAC,CAAA;YACnE,CAAC;YACD,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,OAAO;gBAC9B,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;YACzE,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;CACF;AAED,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC;QAC5C,eAAe,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;KAC/B,CAA4B,CAAA;IAC7B,IAAI,eAA4B,CAAA;IAEhC,UAAU,CAAC,GAAG,EAAE;QACd,eAAe,GAAG,qBAAqB,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAA;IACpB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,QAAQ,GAAG,IAAI,gCAAgC,EAAE,CAAA;QACvD,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QAE5C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAClC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CACtE,IAAI,CACL,CAAA;QACD,2CAA2C;QAC3C,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,QAAQ,GAAG,IAAI,gCAAgC,EAAE,CAAA;QACvD,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QAE5C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAC7B,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAClC,EAAE,WAAW,EAAE,eAAe,EAAE,CACjC,CAAA;QAED,MAAM,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,QAAQ,GAAG,IAAI,gCAAgC,EAAE,CAAA;QACvD,2DAA2D;QAC3D,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAClD,yCAAyC,CAC1C,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/wallet/core/providers/hosted/types/index.d.ts

@@ -0,0 +1,70 @@
+import type { ChainManager } from '../../../../../services/ChainManager.js';
+import type { LendConfig, LendProvider } from '../../../../../types/lend/index.js';
+import type { HostedWalletProvider } from '../abstract/HostedWalletProvider.js';
+/**
+ * Common dependencies provided to hosted provider factories
+ * @description
+ * Environment-agnostic services that providers require at creation time.
+ * Currently limited to `ChainManager`, but can be extended as needed.
+ */
+export interface HostedProviderDeps {
+    chainManager: ChainManager;
+    lendProvider?: LendProvider<LendConfig>;
+}
+/**
+ * Provider registration specification
+ * @description
+ * Declarative description of a hosted wallet provider used when registering
+ * a provider factory in a registry.
+ * @template TType Unique provider key (e.g. 'privy', 'turnkey')
+ * @template TConfig Configuration object type for the provider
+ */
+export type ProviderSpec<TType extends string, TConfigMap extends {
+    [K in TType]: unknown | undefined;
+}> = {
+    [K in TType]: undefined extends TConfigMap[K] ? {
+        type: K;
+    } : {
+        type: K;
+        config: TConfigMap[K];
+    };
+}[TType];
+/**
+ * Hosted wallet provider factory
+ * @description
+ * Factory contract used by registries to validate configuration and create
+ * concrete hosted wallet provider instances.
+ * @template TType Unique provider key
+ * @template TInstance Concrete provider instance produced by this factory
+ * @template TOptions Options type accepted by `validateOptions` and `create`
+ */
+export interface HostedProviderFactory<TType extends string, TInstance, TOptions = unknown> {
+    type: TType;
+    validateOptions(options: unknown): options is TOptions;
+    create(deps: HostedProviderDeps, options: TOptions): TInstance;
+}
+/**
+ * Complete hosted wallet providers schema (environment-agnostic)
+ * @description
+ * Bundles provider type keys, concrete provider instances, creation configs,
+ * and `toActionsWallet` parameter types for a given environment (Node or React).
+ * This schema enables precise typing in `Actions` and registries without widening
+ * keys to generic `string`.
+ * @template ProviderTypes Union of provider keys for the environment
+ * @template ProviderInstanceMap Map of provider key to concrete instance
+ * @template ProviderConfigMap Map of provider key to factory config type
+ * @template ToActionsOptionsMap Map of provider key to `toActionsWallet` params
+ */
+export type HostedWalletProvidersSchema<ProviderTypes extends string, ProviderInstanceMap extends {
+    [K in ProviderTypes]: HostedWalletProvider<K, ToActionsOptionsMap>;
+}, ProviderConfigMap extends {
+    [K in ProviderTypes]: unknown;
+}, ToActionsOptionsMap extends {
+    [K in ProviderTypes]: unknown;
+}> = {
+    providerTypes: ProviderTypes;
+    providerInstances: ProviderInstanceMap;
+    providerConfigs: ProviderConfigMap;
+    providerToActionsOptions: ToActionsOptionsMap;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/wallet/core/providers/hosted/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/wallet/core/providers/hosted/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAA;AAE3G;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,YAAY,CAAA;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;CACxC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,CACtB,KAAK,SAAS,MAAM,EACpB,UAAU,SAAS;KAAG,CAAC,IAAI,KAAK,GAAG,OAAO,GAAG,SAAS;CAAE,IACtD;KACD,CAAC,IAAI,KAAK,GAAG,SAAS,SAAS,UAAU,CAAC,CAAC,CAAC,GACzC;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GACX;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;KAAE;CACvC,CAAC,KAAK,CAAC,CAAA;AAER;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB,CACpC,KAAK,SAAS,MAAM,EACpB,SAAS,EACT,QAAQ,GAAG,OAAO;IAElB,IAAI,EAAE,KAAK,CAAA;IACX,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,CAAA;IACtD,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAA;CAC/D;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,2BAA2B,CACrC,aAAa,SAAS,MAAM,EAC5B,mBAAmB,SAAS;KACzB,CAAC,IAAI,aAAa,GAAG,oBAAoB,CAAC,CAAC,EAAE,mBAAmB,CAAC;CACnE,EACD,iBAAiB,SAAS;KAAG,CAAC,IAAI,aAAa,GAAG,OAAO;CAAE,EAC3D,mBAAmB,SAAS;KAAG,CAAC,IAAI,aAAa,GAAG,OAAO;CAAE,IAC3D;IACF,aAAa,EAAE,aAAa,CAAA;IAC5B,iBAAiB,EAAE,mBAAmB,CAAA;IACtC,eAAe,EAAE,iBAAiB,CAAA;IAClC,wBAAwB,EAAE,mBAAmB,CAAA;CAC9C,CAAA"}

package/dist/wallet/core/providers/hosted/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/wallet/core/providers/hosted/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/wallet/core/providers/hosted/types/index.ts"],"names":[],"mappings":""}

package/dist/wallet/core/providers/smart/abstract/SmartWalletProvider.d.ts

@@ -0,0 +1,61 @@
+import type { Address, LocalAccount } from 'viem';
+import type { SupportedChainId } from '../../../../../constants/supportedChains.js';
+import type { SmartWalletCreationResult } from './types/index.js';
+import type { SmartWallet } from '../../../wallets/smart/abstract/SmartWallet.js';
+import type { Signer } from '../../../wallets/smart/abstract/types/index.js';
+/**
+ * Base smart wallet provider interface
+ * @description Abstract interface for smart wallet providers.
+ */
+export declare abstract class SmartWalletProvider {
+    /**
+     * Create a new smart wallet instance
+     * @description Creates a new smart wallet and attempts to deploy it across all supported chains.
+     * The wallet address is deterministically calculated from signers and nonce. Deployment failures
+     * on individual chains do not prevent wallet creation - they are reported in the result.
+     * @param params - Wallet creation parameters
+     * @param params.signers - Array of wallet signers
+     * @param params.signer - Local account used for signing transactions
+     * @param params.nonce - Optional nonce for address generation (defaults to 0)
+     * @param params.deploymentChainIds - Optional chain IDs to deploy the wallet to.
+     * If not provided, the wallet will be deployed to all supported chains.
+     * @returns Promise resolving to deployment result containing:
+     * - `wallet`: The created SmartWallet instance
+     * - `deployments`: Array of deployment results with chainId, receipt, success flag, and error
+     */
+    abstract createWallet(params: {
+        signer: LocalAccount;
+        signers?: Signer[];
+        nonce?: bigint;
+        deploymentChainIds?: SupportedChainId[];
+    }): Promise<SmartWalletCreationResult<SmartWallet>>;
+    /**
+     * Get an existing smart wallet instance
+     * @description Creates a SmartWallet instance for an already deployed wallet.
+     * Use this when you know the wallet address and want to interact with it.
+     * @param params - Wallet retrieval parameters
+     * @param params.walletAddress - Address of the deployed smart wallet
+     * @param params.signer - Local account used for signing transactions
+     * @param params.signers - Array of wallet signers
+     * @returns SmartWallet instance for the existing wallet
+     */
+    abstract getWallet(params: {
+        walletAddress: Address;
+        signer: LocalAccount;
+        signers?: Signer[];
+    }): Promise<SmartWallet>;
+    /**
+     * Get the predicted smart wallet address
+     * @description Calculates the deterministic address where a smart wallet would be deployed
+     * given the specified signers and nonce. Uses CREATE2 for address prediction.
+     * @param params - Address prediction parameters
+     * @param params.signers - Array of wallet signers
+     * @param params.nonce - Nonce for address generation (defaults to 0)
+     * @returns Promise resolving to the predicted wallet address
+     */
+    abstract getWalletAddress(params: {
+        signers: Signer[];
+        nonce?: bigint;
+    }): Promise<Address>;
+}
+//# sourceMappingURL=SmartWalletProvider.d.ts.map

package/dist/wallet/core/providers/smart/abstract/SmartWalletProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartWalletProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/wallet/core/providers/smart/abstract/SmartWalletProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAEjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACtG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAA;AACtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAA;AAEjF;;;GAGG;AACH,8BAAsB,mBAAmB;IACvC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE;QAC5B,MAAM,EAAE,YAAY,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;QAClB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAA;KACxC,GAAG,OAAO,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAEnD;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;QACzB,aAAa,EAAE,OAAO,CAAA;QACtB,MAAM,EAAE,YAAY,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC;IAExB;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE;QAChC,OAAO,EAAE,MAAM,EAAE,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,GAAG,OAAO,CAAC,OAAO,CAAC;CACrB"}

package/dist/wallet/core/providers/smart/abstract/SmartWalletProvider.js

@@ -0,0 +1,7 @@
+/**
+ * Base smart wallet provider interface
+ * @description Abstract interface for smart wallet providers.
+ */
+export class SmartWalletProvider {
+}
+//# sourceMappingURL=SmartWalletProvider.js.map

package/dist/wallet/core/providers/smart/abstract/SmartWalletProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartWalletProvider.js","sourceRoot":"","sources":["../../../../../../src/wallet/core/providers/smart/abstract/SmartWalletProvider.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,OAAgB,mBAAmB;CAoDxC"}

package/dist/wallet/core/providers/smart/abstract/types/index.d.ts

@@ -0,0 +1,16 @@
+import type { WaitForUserOperationReceiptReturnType } from 'viem/account-abstraction';
+import type { SupportedChainId } from '../../../../../../constants/supportedChains.js';
+import type { SmartWallet } from '../../../../wallets/smart/abstract/SmartWallet.js';
+import type { SmartWalletDeploymentError } from '../../../../wallets/smart/error/errors.js';
+interface SmartWalletDeployment {
+    chainId: SupportedChainId;
+    success: boolean;
+    receipt?: WaitForUserOperationReceiptReturnType;
+    error?: SmartWalletDeploymentError;
+}
+export type SmartWalletCreationResult<TWallet extends SmartWallet> = {
+    wallet: TWallet;
+    deployments: SmartWalletDeployment[];
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/wallet/core/providers/smart/abstract/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/wallet/core/providers/smart/abstract/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,0BAA0B,CAAA;AAErF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAA;AACtF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAA;AAE7F,UAAU,qBAAqB;IAC7B,OAAO,EAAE,gBAAgB,CAAA;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,qCAAqC,CAAA;IAC/C,KAAK,CAAC,EAAE,0BAA0B,CAAA;CACnC;AAED,MAAM,MAAM,yBAAyB,CAAC,OAAO,SAAS,WAAW,IAAI;IACnE,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,qBAAqB,EAAE,CAAA;CACrC,CAAA"}

package/dist/wallet/core/providers/smart/abstract/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map