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

package/dist/wallet/node/providers/hosted/privy/__tests__/PrivyHostedWalletProvider.spec.js

@@ -0,0 +1,80 @@
+import { getAddress } from 'viem';
+import { unichain } from 'viem/chains';
+import { describe, expect, it, vi } from 'vitest';
+import { MockChainManager } from '../../../../../../test/MockChainManager.js';
+import { createMockPrivyClient } from '../../../../../../test/MockPrivyClient.js';
+import { getRandomAddress } from '../../../../../../test/utils.js';
+import { Wallet } from '../../../../../core/wallets/abstract/Wallet.js';
+import { PrivyHostedWalletProvider } from '../PrivyHostedWalletProvider.js';
+import { PrivyWallet } from '../../../../wallets/hosted/privy/PrivyWallet.js';
+describe('PrivyHostedWalletProvider', () => {
+    const mockChainManager = new MockChainManager({
+        supportedChains: [unichain.id],
+    });
+    describe('toActionsWallet', () => {
+        it('toActionsWallet creates an ActionsWallet with correct address and signer', async () => {
+            const privy = createMockPrivyClient('app', 'secret');
+            const provider = new PrivyHostedWalletProvider(privy, mockChainManager);
+            const hostedWallet = await privy.walletApi.createWallet({
+                chainType: 'ethereum',
+            });
+            const actionsWallet = await provider.toActionsWallet({
+                walletId: hostedWallet.id,
+                address: hostedWallet.address,
+            });
+            expect(actionsWallet).toBeInstanceOf(Wallet);
+            expect(actionsWallet.address).toBe(hostedWallet.address);
+            expect(actionsWallet.signer.address).toBe(hostedWallet.address);
+        });
+        it('forwards params to PrivyWallet.create', async () => {
+            const privy = createMockPrivyClient('app', 'secret');
+            const provider = new PrivyHostedWalletProvider(privy, mockChainManager);
+            const spy = vi.spyOn(PrivyWallet, 'create');
+            const id = 'mock-wallet-123';
+            const addr = getRandomAddress().toLowerCase();
+            await provider.toActionsWallet({ walletId: id, address: addr });
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({
+                privyClient: privy,
+                walletId: id,
+                address: getAddress(addr),
+                chainManager: mockChainManager,
+            }));
+        });
+        it('throws on invalid address', async () => {
+            const privy = createMockPrivyClient('app', 'secret');
+            const provider = new PrivyHostedWalletProvider(privy, mockChainManager);
+            await expect(provider.toActionsWallet({ walletId: 'id', address: '0x123' })).rejects.toBeTruthy();
+        });
+        it('forwards lendProvider when provided to constructor', async () => {
+            const privy = createMockPrivyClient('app', 'secret');
+            const mockLendProvider = {};
+            const provider = new PrivyHostedWalletProvider(privy, mockChainManager, mockLendProvider);
+            const spy = vi.spyOn(PrivyWallet, 'create');
+            const id = 'mock-wallet-123';
+            const addr = getRandomAddress().toLowerCase();
+            await provider.toActionsWallet({
+                walletId: id,
+                address: addr,
+            });
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({
+                lendProvider: mockLendProvider,
+            }));
+        });
+    });
+    describe('createSigner', () => {
+        it('should create a LocalAccount with correct address', async () => {
+            const privy = createMockPrivyClient('app', 'secret');
+            const provider = new PrivyHostedWalletProvider(privy, mockChainManager);
+            const hostedWallet = await privy.walletApi.createWallet({
+                chainType: 'ethereum',
+            });
+            const signer = await provider.createSigner({
+                walletId: hostedWallet.id,
+                address: hostedWallet.address,
+            });
+            expect(signer.address).toBe(hostedWallet.address);
+            expect(signer.type).toBe('local');
+        });
+    });
+});
+//# sourceMappingURL=PrivyHostedWalletProvider.spec.js.map

package/dist/wallet/node/providers/hosted/privy/__tests__/PrivyHostedWalletProvider.spec.js.map

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

package/dist/wallet/node/providers/hosted/registry/NodeHostedWalletProviderRegistry.d.ts

@@ -0,0 +1,15 @@
+import { HostedWalletProviderRegistry } from '../../../../core/providers/hosted/registry/HostedWalletProviderRegistry.js';
+import type { NodeHostedProviderInstanceMap, NodeOptionsMap, NodeProviderTypes } from '../types/index.js';
+/**
+ * Node hosted wallet provider registry
+ * @description
+ * Environment-scoped registry that binds Node/server provider keys to their
+ * factory implementations. This ensures browser-only hosted providers are
+ * discoverable at runtime without importing Node-only code. The registry
+ * pre-registers 'privy' and 'turnkey' providers and can be extended with
+ * additional providers via `register`.
+ */
+export declare class NodeHostedWalletProviderRegistry extends HostedWalletProviderRegistry<NodeHostedProviderInstanceMap, NodeOptionsMap, NodeProviderTypes> {
+    constructor();
+}
+//# sourceMappingURL=NodeHostedWalletProviderRegistry.d.ts.map

package/dist/wallet/node/providers/hosted/registry/NodeHostedWalletProviderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeHostedWalletProviderRegistry.d.ts","sourceRoot":"","sources":["../../../../../../src/wallet/node/providers/hosted/registry/NodeHostedWalletProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,yEAAyE,CAAA;AAGtH,OAAO,KAAK,EACV,6BAA6B,EAC7B,cAAc,EACd,iBAAiB,EAClB,MAAM,+CAA+C,CAAA;AAEtD;;;;;;;;GAQG;AACH,qBAAa,gCAAiC,SAAQ,4BAA4B,CAChF,6BAA6B,EAC7B,cAAc,EACd,iBAAiB,CAClB;;CAgCA"}

package/dist/wallet/node/providers/hosted/registry/NodeHostedWalletProviderRegistry.js

@@ -0,0 +1,37 @@
+import { HostedWalletProviderRegistry } from '../../../../core/providers/hosted/registry/HostedWalletProviderRegistry.js';
+import { PrivyHostedWalletProvider } from '../privy/PrivyHostedWalletProvider.js';
+import { TurnkeyHostedWalletProvider } from '../turnkey/TurnkeyHostedWalletProvider.js';
+/**
+ * Node hosted wallet provider registry
+ * @description
+ * Environment-scoped registry that binds Node/server provider keys to their
+ * factory implementations. This ensures browser-only hosted providers are
+ * discoverable at runtime without importing Node-only code. The registry
+ * pre-registers 'privy' and 'turnkey' providers and can be extended with
+ * additional providers via `register`.
+ */
+export class NodeHostedWalletProviderRegistry extends HostedWalletProviderRegistry {
+    constructor() {
+        super();
+        this.register({
+            type: 'privy',
+            validateOptions(options) {
+                return Boolean(options?.privyClient);
+            },
+            create({ chainManager, lendProvider }, options) {
+                return new PrivyHostedWalletProvider(options.privyClient, chainManager, lendProvider);
+            },
+        });
+        this.register({
+            type: 'turnkey',
+            validateOptions(options) {
+                const o = options;
+                return Boolean(o?.client);
+            },
+            create({ chainManager, lendProvider }, options) {
+                return new TurnkeyHostedWalletProvider(options.client, chainManager, lendProvider);
+            },
+        });
+    }
+}
+//# sourceMappingURL=NodeHostedWalletProviderRegistry.js.map

package/dist/wallet/node/providers/hosted/registry/NodeHostedWalletProviderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeHostedWalletProviderRegistry.js","sourceRoot":"","sources":["../../../../../../src/wallet/node/providers/hosted/registry/NodeHostedWalletProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,yEAAyE,CAAA;AACtH,OAAO,EAAE,yBAAyB,EAAE,MAAM,mEAAmE,CAAA;AAC7G,OAAO,EAAE,2BAA2B,EAAE,MAAM,uEAAuE,CAAA;AAOnH;;;;;;;;GAQG;AACH,MAAM,OAAO,gCAAiC,SAAQ,4BAIrD;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,YAAY,EAAE,EAAE,OAAO;gBAC5C,OAAO,IAAI,yBAAyB,CAClC,OAAO,CAAC,WAAW,EACnB,YAAY,EACZ,YAAY,CACb,CAAA;YACH,CAAC;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAY;YACvB,IAAI,EAAE,SAAS;YACf,eAAe,CAAC,OAAO;gBACrB,MAAM,CAAC,GAAG,OAAoC,CAAA;gBAC9C,OAAO,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;YAC3B,CAAC;YACD,MAAM,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,OAAO;gBAC5C,OAAO,IAAI,2BAA2B,CACpC,OAAO,CAAC,MAAM,EACd,YAAY,EACZ,YAAY,CACb,CAAA;YACH,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/wallet/node/providers/hosted/registry/__tests__/NodeHostedWalletProviderRegistry.spec.d.ts

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

package/dist/wallet/node/providers/hosted/registry/__tests__/NodeHostedWalletProviderRegistry.spec.d.ts.map

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

package/dist/wallet/node/providers/hosted/registry/__tests__/NodeHostedWalletProviderRegistry.spec.js

@@ -0,0 +1,62 @@
+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 { PrivyHostedWalletProvider } from '../../privy/PrivyHostedWalletProvider.js';
+import { NodeHostedWalletProviderRegistry } from '../NodeHostedWalletProviderRegistry.js';
+import { TurnkeyHostedWalletProvider } from '../../turnkey/TurnkeyHostedWalletProvider.js';
+describe('NodeHostedWalletProviderRegistry', () => {
+    const mockChainManager = new MockChainManager({
+        supportedChains: [unichain.id],
+    });
+    let mockPrivyClient;
+    const mockTurnkeyClient = {};
+    beforeEach(() => {
+        mockPrivyClient = createMockPrivyClient('test-app-id', 'test-app-secret');
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it('returns privy factory and validates options', () => {
+        const registry = new NodeHostedWalletProviderRegistry();
+        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 NodeHostedWalletProviderRegistry();
+        const factory = registry.getFactory('privy');
+        const provider = factory.create({ chainManager: mockChainManager }, {
+            privyClient: mockPrivyClient,
+        });
+        expect(provider).toBeInstanceOf(PrivyHostedWalletProvider);
+    });
+    it('returns turnkey factory and validates options', () => {
+        const registry = new NodeHostedWalletProviderRegistry();
+        const factory = registry.getFactory('turnkey');
+        expect(factory.type).toBe('turnkey');
+        expect(factory.validateOptions?.({
+            client: mockTurnkeyClient,
+        })).toBe(true);
+        // Invalid shape should not pass validation
+        expect(factory.validateOptions?.({})).toBe(false);
+    });
+    it('creates a TurnkeyHostedWalletProvider instance', () => {
+        const registry = new NodeHostedWalletProviderRegistry();
+        const factory = registry.getFactory('turnkey');
+        const provider = factory.create({ chainManager: mockChainManager }, {
+            client: mockTurnkeyClient,
+        });
+        expect(provider).toBeInstanceOf(TurnkeyHostedWalletProvider);
+    });
+    it('throws for unknown provider type', () => {
+        const registry = new NodeHostedWalletProviderRegistry();
+        // @ts-expect-error: testing runtime error for unknown type
+        expect(() => registry.getFactory('unknown')).toThrow('Unknown hosted wallet provider: unknown');
+    });
+});
+//# sourceMappingURL=NodeHostedWalletProviderRegistry.spec.js.map

package/dist/wallet/node/providers/hosted/registry/__tests__/NodeHostedWalletProviderRegistry.spec.js.map

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

package/dist/wallet/node/providers/hosted/turnkey/TurnkeyHostedWalletProvider.d.ts

@@ -0,0 +1,50 @@
+import type { TurnkeySDKClientBase } from '@turnkey/core';
+import type { TurnkeyClient as TurnkeyHttpClient } from '@turnkey/http';
+import type { TurnkeyServerClient } from '@turnkey/sdk-server';
+import type { LocalAccount } from 'viem';
+import type { ChainManager } from '../../../../../services/ChainManager.js';
+import type { LendConfig, LendProvider } from '../../../../../types/lend/index.js';
+import { HostedWalletProvider } from '../../../../core/providers/hosted/abstract/HostedWalletProvider.js';
+import type { Wallet } from '../../../../core/wallets/abstract/Wallet.js';
+import type { NodeToActionsOptionsMap } from '../types/index.js';
+/**
+ * Turnkey wallet provider implementation
+ * @description Hosted wallet provider that wraps Turnkey's signing infrastructure
+ * and exposes an Actions-compatible wallet. This provider is intended for Node
+ * environments where the Turnkey client (HTTP, server, or core SDK) and
+ * organization context are provided at construction time.
+ */
+export declare class TurnkeyHostedWalletProvider extends HostedWalletProvider<'turnkey', NodeToActionsOptionsMap> {
+    private readonly client;
+    /**
+     * Create a new Turnkey wallet provider
+     * @param client - Turnkey client instance (HTTP, server, or core SDK base)
+     * @param chainManager - Chain manager used to resolve chains and RPC transports
+     */
+    constructor(client: TurnkeyHttpClient | TurnkeyServerClient | TurnkeySDKClientBase, chainManager: ChainManager, lendProvider?: LendProvider<LendConfig>);
+    /**
+     * Convert a Turnkey hosted wallet context into an Actions wallet
+     * @description Creates a `TurnkeyWallet` configured with the provider's Turnkey
+     * client and organization.
+     * @param params - Options for creating the Actions wallet from Turnkey context
+     * @param params.signWith - Wallet account address, private key address, or private key ID
+     * @param params.ethereumAddress - Ethereum address to use for this account, in the case that a private key ID is used to sign.
+     * @returns Promise resolving to an Actions-compatible wallet instance
+     */
+    toActionsWallet(params: NodeToActionsOptionsMap['turnkey']): Promise<Wallet>;
+    /**
+     * Create a viem LocalAccount signer from Turnkey credentials
+     * @description Produces a signing account backed by Turnkey 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 - Turnkey configuration for the signer
+     * @param params.client - Turnkey client instance
+     * @param params.organizationId - Turnkey organization ID that owns the signing key
+     * @param params.signWith - Wallet account address, private key address, or private key ID
+     * @param params.ethereumAddress - Optional Ethereum address (recommended for passkey clients to avoid extra prompts)
+     * @returns Promise resolving to a viem `LocalAccount` with Turnkey as the signer backend
+     */
+    createSigner(params: NodeToActionsOptionsMap['turnkey']): Promise<LocalAccount>;
+}
+//# sourceMappingURL=TurnkeyHostedWalletProvider.d.ts.map

package/dist/wallet/node/providers/hosted/turnkey/TurnkeyHostedWalletProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnkeyHostedWalletProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/wallet/node/providers/hosted/turnkey/TurnkeyHostedWalletProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,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,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAA;AACtG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAA;AAI5F;;;;;;GAMG;AACH,qBAAa,2BAA4B,SAAQ,oBAAoB,CACnE,SAAS,EACT,uBAAuB,CACxB;IAOG,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB;;;;OAIG;gBAEgB,MAAM,EACnB,iBAAiB,GACjB,mBAAmB,GACnB,oBAAoB,EACxB,YAAY,EAAE,YAAY,EAC1B,YAAY,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC;IAKzC;;;;;;;;OAQG;IACG,eAAe,CACnB,MAAM,EAAE,uBAAuB,CAAC,SAAS,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAWlB;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,MAAM,EAAE,uBAAuB,CAAC,SAAS,CAAC,GACzC,OAAO,CAAC,YAAY,CAAC;CAMzB"}

package/dist/wallet/node/providers/hosted/turnkey/TurnkeyHostedWalletProvider.js

@@ -0,0 +1,60 @@
+import { HostedWalletProvider } from '../../../../core/providers/hosted/abstract/HostedWalletProvider.js';
+import { TurnkeyWallet } from '../../../wallets/hosted/turnkey/TurnkeyWallet.js';
+import { createSigner } from '../../../wallets/hosted/turnkey/utils/createSigner.js';
+/**
+ * Turnkey wallet provider implementation
+ * @description Hosted wallet provider that wraps Turnkey's signing infrastructure
+ * and exposes an Actions-compatible wallet. This provider is intended for Node
+ * environments where the Turnkey client (HTTP, server, or core SDK) and
+ * organization context are provided at construction time.
+ */
+export class TurnkeyHostedWalletProvider extends HostedWalletProvider {
+    /**
+     * Create a new Turnkey wallet provider
+     * @param client - Turnkey client instance (HTTP, server, or core SDK base)
+     * @param chainManager - Chain manager used to resolve chains and RPC transports
+     */
+    constructor(client, chainManager, lendProvider) {
+        super(chainManager, lendProvider);
+        this.client = client;
+    }
+    /**
+     * Convert a Turnkey hosted wallet context into an Actions wallet
+     * @description Creates a `TurnkeyWallet` configured with the provider's Turnkey
+     * client and organization.
+     * @param params - Options for creating the Actions wallet from Turnkey context
+     * @param params.signWith - Wallet account address, private key address, or private key ID
+     * @param params.ethereumAddress - Ethereum address to use for this account, in the case that a private key ID is used to sign.
+     * @returns Promise resolving to an Actions-compatible wallet instance
+     */
+    async toActionsWallet(params) {
+        return TurnkeyWallet.create({
+            client: this.client,
+            organizationId: params.organizationId,
+            signWith: params.signWith,
+            ethereumAddress: params.ethereumAddress,
+            chainManager: this.chainManager,
+            lendProvider: this.lendProvider,
+        });
+    }
+    /**
+     * Create a viem LocalAccount signer from Turnkey credentials
+     * @description Produces a signing account backed by Turnkey 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 - Turnkey configuration for the signer
+     * @param params.client - Turnkey client instance
+     * @param params.organizationId - Turnkey organization ID that owns the signing key
+     * @param params.signWith - Wallet account address, private key address, or private key ID
+     * @param params.ethereumAddress - Optional Ethereum address (recommended for passkey clients to avoid extra prompts)
+     * @returns Promise resolving to a viem `LocalAccount` with Turnkey as the signer backend
+     */
+    async createSigner(params) {
+        return createSigner({
+            ...params,
+            client: this.client,
+        });
+    }
+}
+//# sourceMappingURL=TurnkeyHostedWalletProvider.js.map

package/dist/wallet/node/providers/hosted/turnkey/TurnkeyHostedWalletProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnkeyHostedWalletProvider.js","sourceRoot":"","sources":["../../../../../../src/wallet/node/providers/hosted/turnkey/TurnkeyHostedWalletProvider.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAA;AAGtG,OAAO,EAAE,aAAa,EAAE,MAAM,uDAAuD,CAAA;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,4DAA4D,CAAA;AAEzF;;;;;;GAMG;AACH,MAAM,OAAO,2BAA4B,SAAQ,oBAGhD;IACC;;;;OAIG;IACH,YACmB,MAGO,EACxB,YAA0B,EAC1B,YAAuC;QAEvC,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;QAPhB,WAAM,GAAN,MAAM,CAGC;IAK1B,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,eAAe,CACnB,MAA0C;QAE1C,OAAO,aAAa,CAAC,MAAM,CAAC;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,YAAY,CAChB,MAA0C;QAE1C,OAAO,YAAY,CAAC;YAClB,GAAG,MAAM;YACT,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/wallet/node/providers/hosted/turnkey/__tests__/TurnkeyHostedWalletProvider.spec.d.ts

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

package/dist/wallet/node/providers/hosted/turnkey/__tests__/TurnkeyHostedWalletProvider.spec.d.ts.map

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

package/dist/wallet/node/providers/hosted/turnkey/__tests__/TurnkeyHostedWalletProvider.spec.js

@@ -0,0 +1,132 @@
+import { unichain } from 'viem/chains';
+import { describe, expect, it, vi } from 'vitest';
+import { MockChainManager } from '../../../../../../test/MockChainManager.js';
+import { TurnkeyHostedWalletProvider } from '../TurnkeyHostedWalletProvider.js';
+import { TurnkeyWallet } from '../../../../wallets/hosted/turnkey/TurnkeyWallet.js';
+import * as createSignerUtil from '../../../../wallets/hosted/turnkey/utils/createSigner.js';
+describe('TurnkeyHostedWalletProvider', () => {
+    const mockChainManager = new MockChainManager({
+        supportedChains: [unichain.id],
+    });
+    describe('toActionsWallet', () => {
+        it('forwards params to TurnkeyWallet.create', async () => {
+            const turnkeyClient = {};
+            const provider = new TurnkeyHostedWalletProvider(turnkeyClient, mockChainManager);
+            const spyTurnkeyWalletCreate = vi
+                .spyOn(TurnkeyWallet, 'create')
+                .mockResolvedValueOnce({
+                address: '0xabc',
+            });
+            await provider.toActionsWallet({
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+            });
+            expect(spyTurnkeyWalletCreate).toHaveBeenCalledWith(expect.objectContaining({
+                client: turnkeyClient,
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+                ethereumAddress: undefined,
+                chainManager: mockChainManager,
+            }));
+        });
+        it('forwards ethereumAddress when provided', async () => {
+            const turnkeyClient = {};
+            const provider = new TurnkeyHostedWalletProvider(turnkeyClient, mockChainManager);
+            const spyTurnkeyWalletCreate = vi
+                .spyOn(TurnkeyWallet, 'create')
+                .mockResolvedValueOnce({
+                address: '0xabc',
+            });
+            await provider.toActionsWallet({
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+                ethereumAddress: '0x123',
+            });
+            expect(spyTurnkeyWalletCreate).toHaveBeenCalledWith(expect.objectContaining({
+                client: turnkeyClient,
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+                ethereumAddress: '0x123',
+                chainManager: mockChainManager,
+            }));
+        });
+        it('returns the created TurnkeyWallet instance', async () => {
+            const turnkeyClient = {};
+            const provider = new TurnkeyHostedWalletProvider(turnkeyClient, mockChainManager);
+            const fakeWallet = {
+                address: '0xabc',
+            };
+            vi.spyOn(TurnkeyWallet, 'create').mockResolvedValueOnce(fakeWallet);
+            const actionsWallet = await provider.toActionsWallet({
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+            });
+            expect(actionsWallet).toBe(fakeWallet);
+        });
+        it('forwards lendProvider when provided to constructor', async () => {
+            const turnkeyClient = {};
+            const mockLendProvider = {};
+            const provider = new TurnkeyHostedWalletProvider(turnkeyClient, mockChainManager, mockLendProvider);
+            const spyTurnkeyWalletCreate = vi
+                .spyOn(TurnkeyWallet, 'create')
+                .mockResolvedValueOnce({
+                address: '0xabc',
+            });
+            await provider.toActionsWallet({
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+            });
+            expect(spyTurnkeyWalletCreate).toHaveBeenCalledWith(expect.objectContaining({
+                lendProvider: mockLendProvider,
+            }));
+        });
+    });
+    describe('createSigner', () => {
+        it('should delegate to createSigner utility with correct params', async () => {
+            const turnkeyClient = {};
+            const provider = new TurnkeyHostedWalletProvider(turnkeyClient, mockChainManager);
+            const mockSigner = {
+                address: '0xabc',
+                type: 'local',
+            };
+            const createSignerSpy = vi
+                .spyOn(createSignerUtil, 'createSigner')
+                .mockResolvedValueOnce(mockSigner);
+            const params = {
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+            };
+            const signer = await provider.createSigner(params);
+            expect(createSignerSpy).toHaveBeenCalledWith({
+                client: turnkeyClient,
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+            });
+            expect(signer).toBe(mockSigner);
+        });
+        it('should forward ethereumAddress when provided', async () => {
+            const turnkeyClient = {};
+            const provider = new TurnkeyHostedWalletProvider(turnkeyClient, mockChainManager);
+            const mockSigner = {
+                address: '0x123',
+                type: 'local',
+            };
+            const createSignerSpy = vi
+                .spyOn(createSignerUtil, 'createSigner')
+                .mockResolvedValueOnce(mockSigner);
+            const params = {
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+                ethereumAddress: '0x123',
+            };
+            await provider.createSigner(params);
+            expect(createSignerSpy).toHaveBeenCalledWith({
+                client: turnkeyClient,
+                organizationId: 'org_123',
+                signWith: 'key_abc',
+                ethereumAddress: '0x123',
+            });
+        });
+    });
+});
+//# sourceMappingURL=TurnkeyHostedWalletProvider.spec.js.map

package/dist/wallet/node/providers/hosted/turnkey/__tests__/TurnkeyHostedWalletProvider.spec.js.map

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

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

@@ -0,0 +1,90 @@
+import type { PrivyClient } from '@privy-io/server-auth';
+import type { TurnkeySDKClientBase } from '@turnkey/core';
+import type { TurnkeyClient as TurnkeyHttpClient } from '@turnkey/http';
+import type { TurnkeyServerClient } from '@turnkey/sdk-server';
+import type { Address } from 'viem';
+import type { HostedWalletProvidersSchema } from '../../../../core/providers/hosted/types/index.js';
+import type { PrivyHostedWalletProvider } from '../privy/PrivyHostedWalletProvider.js';
+import type { TurnkeyHostedWalletProvider } from '../turnkey/TurnkeyHostedWalletProvider.js';
+/**
+ * Node provider type keys
+ * @description
+ * Narrow union of provider identifiers supported in the Node environment.
+ * Uses an intersection of the keys from each map to guarantee that all maps
+ * stay in sync (options, instances, and toActions options) at compile time.
+ */
+export type NodeProviderTypes = keyof NodeOptionsMap & keyof NodeHostedProviderInstanceMap & keyof NodeToActionsOptionsMap;
+/**
+ * Configuration options per Node hosted wallet provider
+ * @description
+ * Strongly-typed configuration inputs passed to each provider factory when
+ * creating a hosted wallet provider for Node.
+ */
+export interface NodeOptionsMap {
+    /**
+     * Privy provider configuration
+     * @property privyClient Server-side Privy client instance used to query/create wallets
+     */
+    privy: {
+        privyClient: PrivyClient;
+    };
+    /**
+     * Turnkey provider configuration
+     * @property client Turnkey SDK/HTTP client used to sign and manage keys
+     * @property organizationId Turnkey organization identifier that owns the key material
+     */
+    turnkey: {
+        client: TurnkeyHttpClient | TurnkeyServerClient | TurnkeySDKClientBase;
+    };
+}
+/**
+ * Options for converting a Turnkey hosted wallet to an Actions wallet
+ * @description Parameters for converting a hosted wallet to an Actions wallet
+ * @property signWith This can be a wallet account address, private key address, or private key ID.
+ * @property ethereumAddress Ethereum address to use for this account, in the case that a private key ID is used to sign.
+ * If left undefined, `createAccount` will fetch it from the Turnkey API. We recommend setting this if you're using a passkey
+ * client, so that your users are not prompted for a passkey signature just to fetch their address. You may leave this
+ * undefined if using an API key client.
+ */
+export type TurnkeyHostedWalletToActionsWalletOptions = {
+    organizationId: string;
+    signWith: string;
+    ethereumAddress?: string;
+};
+/**
+ * Options for converting a Privy hosted wallet to an Actions wallet
+ * @description Parameters for converting a hosted wallet to an Actions wallet
+ * @property walletId Privy wallet identifier
+ * @property address Ethereum address of the wallet
+ */
+export type PrivyHostedWalletToActionsWalletOptions = {
+    walletId: string;
+    address: Address;
+};
+/**
+ * Node environment hosted wallet registry.
+ * Registers server-safe providers for use in Node.
+ */
+export type NodeHostedProviderInstanceMap = {
+    privy: PrivyHostedWalletProvider;
+    turnkey: TurnkeyHostedWalletProvider;
+};
+/**
+ * Parameters required to convert each hosted wallet to an Actions wallet (Node)
+ * @description
+ * Provider-specific, caller-supplied data needed by `toActionsWallet`.
+ */
+export type NodeToActionsOptionsMap = {
+    privy: PrivyHostedWalletToActionsWalletOptions;
+    turnkey: TurnkeyHostedWalletToActionsWalletOptions;
+};
+/**
+ * Complete Node hosted wallet providers schema
+ * @description
+ * Bundles provider type keys, concrete provider instances, creation configs,
+ * and `toActionsWallet` parameter types for the Node environment.
+ * This schema is used to type `Actions` and its registries without widening
+ * to generic `string` keys.
+ */
+export type NodeHostedWalletProvidersSchema = HostedWalletProvidersSchema<NodeProviderTypes, NodeHostedProviderInstanceMap, NodeOptionsMap, NodeToActionsOptionsMap>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/wallet/node/providers/hosted/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAA;AAChG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mEAAmE,CAAA;AAClH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uEAAuE,CAAA;AAExH;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,cAAc,GAClD,MAAM,6BAA6B,GACnC,MAAM,uBAAuB,CAAA;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE,CAAA;IACnC;;;;OAIG;IACH,OAAO,EAAE;QACP,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,oBAAoB,CAAA;KACvE,CAAA;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,KAAK,EAAE,yBAAyB,CAAA;IAChC,OAAO,EAAE,2BAA2B,CAAA;CACrC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,uCAAuC,CAAA;IAC9C,OAAO,EAAE,yCAAyC,CAAA;CACnD,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,+BAA+B,GAAG,2BAA2B,CACvE,iBAAiB,EACjB,6BAA6B,EAC7B,cAAc,EACd,uBAAuB,CACxB,CAAA"}

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

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

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

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