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

package/dist/wallet/core/wallets/eoa/__tests__/EOAWallet.spec.js

@@ -0,0 +1,191 @@
+import { createWalletClient } from 'viem';
+import { unichain } from 'viem/chains';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { MockChainManager } from '../../../../../test/MockChainManager.js';
+import { getRandomAddress } from '../../../../../test/utils.js';
+import { EOAWallet } from '../EOAWallet.js';
+vi.mock('viem', async () => ({
+    // @ts-ignore - importActual returns unknown
+    ...(await vi.importActual('viem')),
+    createWalletClient: vi.fn(),
+}));
+// Concrete implementation for testing abstract class
+class TestEOAWallet extends EOAWallet {
+    constructor(address, signer, chainManager) {
+        super(chainManager);
+        this.address = address;
+        this.signer = signer;
+    }
+    static async create(address, signer, chainManager) {
+        const wallet = new TestEOAWallet(address, signer, chainManager);
+        await wallet.initialize();
+        return wallet;
+    }
+}
+const mockAddress = getRandomAddress();
+const mockChainManager = new MockChainManager({
+    supportedChains: [130], // Unichain
+});
+const mockLocalAccount = {
+    address: mockAddress,
+    signMessage: vi.fn(),
+    sign: vi.fn(),
+    signTransaction: vi.fn(),
+    signTypedData: vi.fn(),
+};
+const mockTransactionHash = '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef';
+const mockReceipt = {
+    transactionHash: mockTransactionHash,
+    blockNumber: 12345n,
+    status: 'success',
+    from: mockAddress,
+    to: getRandomAddress(),
+    gasUsed: 21000n,
+};
+describe('EOAWallet', () => {
+    let wallet;
+    let mockWalletClient;
+    let mockPublicClient;
+    beforeEach(async () => {
+        vi.clearAllMocks();
+        // Setup mock wallet client
+        mockWalletClient = {
+            sendTransaction: vi.fn().mockResolvedValue(mockTransactionHash),
+        };
+        // Setup mock public client
+        mockPublicClient = {
+            waitForTransactionReceipt: vi.fn().mockResolvedValue(mockReceipt),
+        };
+        // Mock chainManager methods
+        vi.spyOn(mockChainManager, 'getChain').mockReturnValue(unichain);
+        vi.spyOn(mockChainManager, 'getRpcUrls').mockReturnValue([
+            'https://rpc1.example.com',
+            'https://rpc2.example.com',
+        ]);
+        vi.spyOn(mockChainManager, 'getPublicClient').mockReturnValue(mockPublicClient);
+        // Mock createWalletClient
+        vi.mocked(createWalletClient).mockResolvedValue(mockWalletClient);
+        wallet = await TestEOAWallet.create(mockAddress, mockLocalAccount, mockChainManager);
+    });
+    describe('walletClient', () => {
+        it('should create a wallet client with correct configuration', async () => {
+            const walletClient = await wallet.walletClient(unichain.id);
+            expect(createWalletClient).toHaveBeenCalledOnce();
+            const callArgs = vi.mocked(createWalletClient).mock.calls[0][0];
+            expect(callArgs.account).toBe(mockLocalAccount);
+            expect(callArgs.chain).toBe(unichain);
+            expect(walletClient).toBe(mockWalletClient);
+        });
+    });
+    describe('send', () => {
+        const mockTransactionData = {
+            to: getRandomAddress(),
+            value: 1000000000000000000n, // 1 ETH
+            data: '0x',
+        };
+        it('should send a transaction and return receipt', async () => {
+            const receipt = await wallet.send(mockTransactionData, unichain.id);
+            expect(mockWalletClient.sendTransaction).toHaveBeenCalledWith(mockTransactionData);
+            expect(mockChainManager.getPublicClient).toHaveBeenCalledWith(unichain.id);
+            expect(mockPublicClient.waitForTransactionReceipt).toHaveBeenCalledWith({
+                hash: mockTransactionHash,
+            });
+            expect(receipt).toBe(mockReceipt);
+        });
+        it('should create wallet client with correct chain', async () => {
+            await wallet.send(mockTransactionData, unichain.id);
+            expect(mockChainManager.getChain).toHaveBeenCalledWith(unichain.id);
+            expect(createWalletClient).toHaveBeenCalled();
+        });
+    });
+    describe('sendBatch', () => {
+        const mockTransactionData1 = {
+            to: getRandomAddress(),
+            value: 1000000000000000000n,
+            data: '0x',
+        };
+        const mockTransactionData2 = {
+            to: getRandomAddress(),
+            value: 2000000000000000000n,
+            data: '0xabcd',
+        };
+        const mockTransactionData3 = {
+            to: getRandomAddress(),
+            value: 3000000000000000000n,
+            data: '0x1234',
+        };
+        const mockReceipt2 = {
+            ...mockReceipt,
+            transactionHash: '0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd',
+        };
+        const mockReceipt3 = {
+            ...mockReceipt,
+            transactionHash: '0x9876543210987654321098765432109876543210987654321098765432109876',
+        };
+        beforeEach(() => {
+            vi.mocked(mockWalletClient.sendTransaction)
+                .mockResolvedValueOnce(mockReceipt.transactionHash)
+                .mockResolvedValueOnce(mockReceipt2.transactionHash)
+                .mockResolvedValueOnce(mockReceipt3.transactionHash);
+            vi.mocked(mockPublicClient.waitForTransactionReceipt)
+                .mockResolvedValueOnce(mockReceipt)
+                .mockResolvedValueOnce(mockReceipt)
+                .mockResolvedValueOnce(mockReceipt2)
+                .mockResolvedValueOnce(mockReceipt2)
+                .mockResolvedValueOnce(mockReceipt3)
+                .mockResolvedValueOnce(mockReceipt3);
+        });
+        it('should send multiple transactions sequentially', async () => {
+            const receipts = await wallet.sendBatch([mockTransactionData1, mockTransactionData2, mockTransactionData3], unichain.id);
+            expect(receipts).toHaveLength(3);
+            expect(receipts[0]).toBe(mockReceipt);
+            expect(receipts[1]).toBe(mockReceipt2);
+            expect(receipts[2]).toBe(mockReceipt3);
+            expect(mockWalletClient.sendTransaction).toHaveBeenCalledTimes(3);
+            expect(mockWalletClient.sendTransaction).toHaveBeenNthCalledWith(1, mockTransactionData1);
+            expect(mockWalletClient.sendTransaction).toHaveBeenNthCalledWith(2, mockTransactionData2);
+            expect(mockWalletClient.sendTransaction).toHaveBeenNthCalledWith(3, mockTransactionData3);
+        });
+        it('should wait for extra confirmations after each transaction', async () => {
+            await wallet.sendBatch([mockTransactionData1, mockTransactionData2], unichain.id);
+            // Should be called twice per transaction:
+            // 1. Initial wait in send()
+            // 2. Extra confirmation wait (confirmations: 2) in sendBatch()
+            expect(mockPublicClient.waitForTransactionReceipt).toHaveBeenCalledTimes(4);
+            // Check that extra confirmation wait was called with confirmations: 2
+            expect(mockPublicClient.waitForTransactionReceipt).toHaveBeenNthCalledWith(2, {
+                hash: mockReceipt.transactionHash,
+                confirmations: 2,
+            });
+            expect(mockPublicClient.waitForTransactionReceipt).toHaveBeenNthCalledWith(4, {
+                hash: mockReceipt2.transactionHash,
+                confirmations: 2,
+            });
+        });
+        it('should get public client for each transaction', async () => {
+            await wallet.sendBatch([mockTransactionData1, mockTransactionData2], unichain.id);
+            // Called twice per transaction (once in send, once for extra confirmation)
+            expect(mockChainManager.getPublicClient).toHaveBeenCalledTimes(4);
+            expect(mockChainManager.getPublicClient).toHaveBeenCalledWith(unichain.id);
+        });
+        it('should handle single transaction in batch', async () => {
+            const receipts = await wallet.sendBatch([mockTransactionData1], unichain.id);
+            expect(receipts).toHaveLength(1);
+            expect(receipts[0]).toBe(mockReceipt);
+            expect(mockWalletClient.sendTransaction).toHaveBeenCalledOnce();
+        });
+        it('should return empty array for empty batch', async () => {
+            const receipts = await wallet.sendBatch([], unichain.id);
+            expect(receipts).toEqual([]);
+            expect(mockWalletClient.sendTransaction).not.toHaveBeenCalled();
+        });
+        it('should maintain transaction order in results', async () => {
+            const receipts = await wallet.sendBatch([mockTransactionData1, mockTransactionData2, mockTransactionData3], unichain.id);
+            // Verify order is preserved
+            expect(receipts[0].transactionHash).toBe(mockReceipt.transactionHash);
+            expect(receipts[1].transactionHash).toBe(mockReceipt2.transactionHash);
+            expect(receipts[2].transactionHash).toBe(mockReceipt3.transactionHash);
+        });
+    });
+});
+//# sourceMappingURL=EOAWallet.spec.js.map

package/dist/wallet/core/wallets/eoa/__tests__/EOAWallet.spec.js.map

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

package/dist/wallet/core/wallets/smart/abstract/SmartWallet.d.ts

@@ -0,0 +1,69 @@
+import type { Address } from 'viem';
+import type { WaitForUserOperationReceiptReturnType } from 'viem/account-abstraction';
+import type { SupportedChainId } from '../../../../../constants/supportedChains.js';
+import type { Asset } from '../../../../../types/asset.js';
+import type { TransactionData } from '../../../../../types/lend/index.js';
+import { Wallet } from '../../abstract/Wallet.js';
+import type { Signer } from './types/index.js';
+/**
+ * Base smart wallet class
+ * @description Abstract base class for smart wallet implementations (ERC-4337 compatible wallets).
+ */
+export declare abstract class SmartWallet extends Wallet {
+    /**
+     * Send a transaction using this smart wallet
+     * @description Executes a transaction through the smart wallet, handling gas sponsorship
+     * and ERC-4337 UserOperation creation automatically.
+     * @param transactionData - The transaction data to execute
+     * @param chainId - Target blockchain chain ID
+     * @returns Promise resolving to the transaction hash
+     */
+    abstract send(transactionData: TransactionData, chainId: SupportedChainId): Promise<WaitForUserOperationReceiptReturnType>;
+    /**
+     * Send a batch of transactions using this smart wallet
+     * @description Executes a batch of transactions through the smart wallet, handling gas sponsorship
+     * and ERC-4337 UserOperation creation automatically.
+     * @param transactionData - The transaction data to execute
+     * @param chainId
+     */
+    abstract sendBatch(transactionData: TransactionData[], chainId: SupportedChainId): Promise<WaitForUserOperationReceiptReturnType>;
+    /**
+     * Add a new signer to the smart wallet
+     * @description Adds either an EOA address signer or a WebAuthn account signer
+     * to the underlying smart wallet contract.
+     * @param signer - Ethereum address (EOA) or a `WebAuthnAccount` to add
+     * @param chainId - Target chain on which the smart wallet operates
+     * @returns Promise resolving to the onchain signer index for the newly added signer
+     * @throws Error if the add operation fails or the owner index cannot be found
+     */
+    abstract addSigner(signer: Signer, chainId: SupportedChainId): Promise<number>;
+    /**
+     * Remove a signer from the smart wallet
+     * @param signer - Ethereum address (EOA) or a `WebAuthnAccount` to remove
+     * @param chainId - Target chain on which the smart wallet operates
+     * @param signerIndex - Index of the signer to remove, if not provided, it will be found by
+     * doing a lookup on the smart wallet contract.
+     * @returns Promise resolving to the receipt of the remove operation
+     */
+    abstract removeSigner(signer: Signer, chainId: SupportedChainId, signerIndex?: number): Promise<WaitForUserOperationReceiptReturnType>;
+    /**
+     * Find the index of a signer in the smart wallet
+     * @param signer - Ethereum address (EOA) or a `WebAuthnAccount` to find
+     * @param chainId - Target chain on which the smart wallet operates
+     * @returns Promise resolving to the onchain signer index for the found signer
+     * returns -1 if the signer is not found
+     */
+    abstract findSignerIndexOnChain(signer: Signer, chainId: SupportedChainId): Promise<number>;
+    /**
+     * Send tokens to another address
+     * @description Prepares transaction data for sending tokens from this smart wallet
+     * to a recipient address. Returns transaction data that can be executed via send().
+     * @param amount - Amount to send in human-readable format
+     * @param asset - Asset object with address mapping and metadata
+     * @param chainId - Chain ID for the transaction
+     * @param recipientAddress - Destination address for the tokens
+     * @returns Promise resolving to prepared transaction data
+     */
+    abstract sendTokens(amount: number, asset: Asset, chainId: SupportedChainId, recipientAddress: Address): Promise<TransactionData>;
+}
+//# sourceMappingURL=SmartWallet.d.ts.map

package/dist/wallet/core/wallets/smart/abstract/SmartWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartWallet.d.ts","sourceRoot":"","sources":["../../../../../../src/wallet/core/wallets/smart/abstract/SmartWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,0BAA0B,CAAA;AAErF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAA;AAEjF;;;GAGG;AACH,8BAAsB,WAAY,SAAQ,MAAM;IAC9C;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CACX,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,qCAAqC,CAAC;IAEjD;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAChB,eAAe,EAAE,eAAe,EAAE,EAClC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,qCAAqC,CAAC;IAEjD;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9E;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,qCAAqC,CAAC;IAEjD;;;;;;OAMG;IACH,QAAQ,CAAC,sBAAsB,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC;IAElB;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAU,CACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,gBAAgB,EACzB,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAAC,eAAe,CAAC;CAC5B"}

package/dist/wallet/core/wallets/smart/abstract/SmartWallet.js

@@ -0,0 +1,8 @@
+import { Wallet } from '../../abstract/Wallet.js';
+/**
+ * Base smart wallet class
+ * @description Abstract base class for smart wallet implementations (ERC-4337 compatible wallets).
+ */
+export class SmartWallet extends Wallet {
+}
+//# sourceMappingURL=SmartWallet.js.map

package/dist/wallet/core/wallets/smart/abstract/SmartWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartWallet.js","sourceRoot":"","sources":["../../../../../../src/wallet/core/wallets/smart/abstract/SmartWallet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AAGjE;;;GAGG;AACH,MAAM,OAAgB,WAAY,SAAQ,MAAM;CA+E/C"}

package/dist/wallet/core/wallets/smart/abstract/__mocks__/SmartWallet.d.ts

@@ -0,0 +1,43 @@
+import type { Address, Hex, LocalAccount, WalletClient } from 'viem';
+import type { WaitForUserOperationReceiptReturnType } from 'viem/account-abstraction';
+import type { SupportedChainId } from '../../../../../../constants/supportedChains.js';
+import type { Asset } from '../../../../../../types/asset.js';
+import type { TransactionData } from '../../../../../../types/lend/index.js';
+import type { SmartWallet } from '../SmartWallet.js';
+export type CreateSmartWalletMockOptions = {
+    /** Mock wallet address */
+    address?: Address;
+    /** Mock signer */
+    signer?: LocalAccount;
+    /** Custom implementation for addSigner */
+    addSignerImpl?: (owner: Address | {
+        type: 'webAuthn';
+        publicKey: Hex;
+    }, chainId: SupportedChainId) => Promise<number | void>;
+    /** Custom implementation for findSignerIndex */
+    findSignerIndexImpl?: (signer: Address | {
+        type: 'webAuthn';
+        publicKey: Hex;
+    }, chainId: SupportedChainId) => Promise<number>;
+    /** Custom implementation for removeSigner */
+    removeSignerImpl?: (signer: Address | {
+        type: 'webAuthn';
+        publicKey: Hex;
+    }, chainId: SupportedChainId, signerIndex?: number) => Promise<WaitForUserOperationReceiptReturnType>;
+    /** Custom implementation for send */
+    sendImpl?: (transactionData: TransactionData, chainId: SupportedChainId) => Promise<WaitForUserOperationReceiptReturnType>;
+    /** Custom implementation for sendBatch */
+    sendBatchImpl?: (transactionData: TransactionData[], chainId: SupportedChainId) => Promise<WaitForUserOperationReceiptReturnType>;
+    /** Optional custom walletClient implementation */
+    walletClientImpl?: (chainId: SupportedChainId) => Promise<WalletClient>;
+    /** Optional custom sendTokens implementation */
+    sendTokensImpl?: (amount: number, asset: Asset, chainId: SupportedChainId, recipientAddress: Address) => Promise<TransactionData>;
+};
+/**
+ * Create a mock SmartWallet instance
+ * @description Returns an object typed as `SmartWallet` with configurable
+ * implementations for `send` and `sendBatch`. Other abstract members are
+ * provided with minimal defaults or throw if invoked (unless overridden).
+ */
+export declare function createMock(options?: CreateSmartWalletMockOptions): SmartWallet;
+//# sourceMappingURL=SmartWallet.d.ts.map

package/dist/wallet/core/wallets/smart/abstract/__mocks__/SmartWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartWallet.d.ts","sourceRoot":"","sources":["../../../../../../../src/wallet/core/wallets/smart/abstract/__mocks__/SmartWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AACpE,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,0BAA0B,CAAA;AAGrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAA;AAEtF,MAAM,MAAM,4BAA4B,GAAG;IACzC,0BAA0B;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,kBAAkB;IAClB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,OAAO,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,GAAG,CAAA;KAAE,EACrD,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC3B,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,OAAO,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,GAAG,CAAA;KAAE,EACtD,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,MAAM,CAAC,CAAA;IACpB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,OAAO,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,GAAG,CAAA;KAAE,EACtD,OAAO,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,MAAM,KACjB,OAAO,CAAC,qCAAqC,CAAC,CAAA;IACnD,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CACT,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,qCAAqC,CAAC,CAAA;IACnD,0CAA0C;IAC1C,aAAa,CAAC,EAAE,CACd,eAAe,EAAE,eAAe,EAAE,EAClC,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,qCAAqC,CAAC,CAAA;IACnD,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IACvE,gDAAgD;IAChD,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,gBAAgB,EACzB,gBAAgB,EAAE,OAAO,KACtB,OAAO,CAAC,eAAe,CAAC,CAAA;CAC9B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAE,4BAAiC,GACzC,WAAW,CAqGb"}

package/dist/wallet/core/wallets/smart/abstract/__mocks__/SmartWallet.js

@@ -0,0 +1,67 @@
+import { vi } from 'vitest';
+/**
+ * Create a mock SmartWallet instance
+ * @description Returns an object typed as `SmartWallet` with configurable
+ * implementations for `send` and `sendBatch`. Other abstract members are
+ * provided with minimal defaults or throw if invoked (unless overridden).
+ */
+export function createMock(options = {}) {
+    const defaultReceipt = {
+        success: true,
+    };
+    const address = (options.address ??
+        '0x0000000000000000000000000000000000000000');
+    const signer = options.signer ?? { address, type: 'local' };
+    const addSigner = vi.fn(async (owner, chainId) => {
+        if (options.addSignerImpl)
+            return options.addSignerImpl(owner, chainId);
+        return undefined;
+    });
+    const findSignerIndex = vi.fn(async (signer, chainId) => {
+        if (options.findSignerIndexImpl)
+            return options.findSignerIndexImpl(signer, chainId);
+        return -1;
+    });
+    const removeSigner = vi.fn(async (signer, chainId, signerIndex) => {
+        if (options.removeSignerImpl)
+            return options.removeSignerImpl(signer, chainId, signerIndex);
+        return defaultReceipt;
+    });
+    const send = vi.fn(async (transactionData, chainId) => {
+        if (options.sendImpl)
+            return options.sendImpl(transactionData, chainId);
+        return defaultReceipt;
+    });
+    const sendBatch = vi.fn(async (transactionData, chainId) => {
+        if (options.sendBatchImpl)
+            return options.sendBatchImpl(transactionData, chainId);
+        return defaultReceipt;
+    });
+    const walletClient = vi.fn(async (chainId) => {
+        if (options.walletClientImpl)
+            return options.walletClientImpl(chainId);
+        throw new Error('walletClient not implemented in SmartWallet mock');
+    });
+    const sendTokens = vi.fn(async (amount, asset, chainId, recipientAddress) => {
+        if (options.sendTokensImpl)
+            return options.sendTokensImpl(amount, asset, chainId, recipientAddress);
+        throw new Error('sendTokens not implemented in SmartWallet mock');
+    });
+    const mock = {
+        get address() {
+            return address;
+        },
+        get signer() {
+            return signer;
+        },
+        addSigner,
+        findSignerIndex,
+        removeSigner,
+        walletClient,
+        send,
+        sendBatch,
+        sendTokens,
+    };
+    return mock;
+}
+//# sourceMappingURL=SmartWallet.js.map

package/dist/wallet/core/wallets/smart/abstract/__mocks__/SmartWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartWallet.js","sourceRoot":"","sources":["../../../../../../../src/wallet/core/wallets/smart/abstract/__mocks__/SmartWallet.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+import type { Address, LocalAccount, OneOf } from 'viem';
+import type { WebAuthnAccount } from 'viem/account-abstraction';
+/**
+ * A single signer/owner for a Smart Wallet.
+ *
+ * Can be one of three types:
+ * - **`Address`**: A plain Ethereum address (hex string like `'0x123...'`). The address itself cannot sign,
+ * but can be used as an owner identifier.
+ * - **`LocalAccount`**: A local account (e.g., from a private key or mnemonic) that can sign transactions
+ * and messages using standard ECDSA signatures.
+ * - **`WebAuthnAccount`**: A WebAuthn/passkey account that signs using the WebAuthn P256 curve,
+ * typically used for biometric authentication.
+ *
+ * The `OneOf` utility ensures that account objects are mutually exclusive - an account can be
+ * either a `LocalAccount` OR a `WebAuthnAccount`, never a hybrid with properties from both types.
+ * This prevents type confusion and ensures proper signature handling for each account type.
+ */
+export type Signer = Address | OneOf<LocalAccount | WebAuthnAccount>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/wallet/core/wallets/smart/abstract/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,YAAY,GAAG,eAAe,CAAC,CAAA"}

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

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

package/dist/wallet/core/wallets/smart/abstract/types/index.js.map

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

package/dist/wallet/core/wallets/smart/default/DefaultSmartWallet.d.ts

@@ -0,0 +1,191 @@
+import type { Address, Hex, LocalAccount } from 'viem';
+import type { WaitForUserOperationReceiptReturnType } from 'viem/account-abstraction';
+import { toCoinbaseSmartAccount } from 'viem/account-abstraction';
+import type { SupportedChainId } from '../../../../../constants/supportedChains.js';
+import type { ChainManager } from '../../../../../services/ChainManager.js';
+import type { Asset } from '../../../../../types/asset.js';
+import type { LendConfig, LendProvider, TransactionData } from '../../../../../types/lend/index.js';
+import { SmartWallet } from '../abstract/SmartWallet.js';
+import type { Signer } from '../abstract/types/index.js';
+/**
+ * Smart Wallet Implementation
+ * @description ERC-4337 compatible smart wallet that uses Coinbase Smart Account (https://github.com/coinbase/smart-wallet/blob/main/src/CoinbaseSmartWallet.sol).
+ * Supports multi-owner wallets, gasless transactions via paymasters, and cross-chain operations.
+ */
+export declare class DefaultSmartWallet extends SmartWallet {
+    /** Local account used for signing transactions and UserOperations */
+    readonly signer: LocalAccount;
+    /** Address of the smart wallet */
+    private _address;
+    /** Array of wallet signers */
+    private signers;
+    /** Index of this.signer in this.signers array */
+    private signerIndex;
+    /** Known deployment address of the wallet (if already deployed) */
+    private deploymentAddress?;
+    /** Nonce used for deterministic address generation (defaults to 0) */
+    private nonce?;
+    /** Optional 16-byte attribution suffix appended to callData */
+    private attributionSuffix?;
+    /**
+     * Create a Smart Wallet instance
+     * @param owners - Array of wallet owners (addresses or WebAuthn accounts)
+     * @param signer - Local account for signing transactions
+     * @param chainManager - Network management service
+     * @param lendProvider - Lending operations provider
+     * @param deploymentAddress - Known wallet address (if already deployed)
+     * @param ownerIndex - Index of signer in owners array
+     * @param nonce - Nonce for address generation
+     */
+    private constructor();
+    get address(): `0x${string}`;
+    /**
+     * Get the formatted owner bytes for smart wallet operations
+     * @description Converts the wallet's owners array into the bytes format expected by the smart wallet
+     * factory and contract. EOA addresses are padded to 32 bytes, LocalAccount addresses are extracted and padded,
+     * and WebAuthn public keys are passed through.
+     * @returns Array of 32-byte formatted owner identifiers
+     * @private
+     */
+    get _signerBytes(): `0x${string}`[];
+    static create(params: {
+        signer: LocalAccount;
+        chainManager: ChainManager;
+        signers?: Signer[];
+        lendProvider?: LendProvider<LendConfig>;
+        deploymentAddress?: Address;
+        nonce?: bigint;
+        attributionSuffix?: Hex;
+    }): Promise<DefaultSmartWallet>;
+    /**
+     * Ensures the LocalAccount signer is present in the signers array for signing operations.
+     * This is needed because the toCoinbaseSmartAccount requires two things:
+     * 1. The signers array to contain the signer (LocalAccount).
+     * 2. The index that the signer is at in the signers array.
+     *
+     *
+     * Another benefit of this is that it allows flexible constructor arguments because it can take a mix
+     * of public keys/addresses or LocalAccounts.
+     * Searches for the signer's public key in the array and replaces that entry with the LocalAccount.
+     * If the LocalAccount is already at that index, this is a no-op.
+     * @param signers - Array of signers (addresses, LocalAccounts, or WebAuthnAccounts)
+     * @param signer - LocalAccount that will sign transactions
+     * @returns The signers array with LocalAccount at the correct index, and that index
+     * @throws Error if signer's public key is not found in the signers array
+     */
+    private static ensureLocalAccountSigner;
+    /**
+     * Checks if a 16-byte attribution suffix is valid
+     * @description Checks if the suffix is a valid hex string and is exactly 16 bytes
+     * @throws Error if suffix is not hex or is not exactly 16 bytes
+     */
+    private static isValidAttributionSuffix;
+    /**
+     * Create a Coinbase Smart Account instance
+     * @description Converts this wallet into a viem-compatible smart account for ERC-4337 operations.
+     * @param chainId - Target blockchain network ID
+     * @returns Coinbase Smart Account instance configured for the specified chain
+     */
+    getCoinbaseSmartAccount(chainId: SupportedChainId): ReturnType<typeof toCoinbaseSmartAccount>;
+    /**
+     * Send a batch of transactions using this smart wallet
+     * @description Executes a batch of transactions through the smart wallet, handling gas sponsorship
+     * and ERC-4337 UserOperation creation automatically.
+     * @param transactionData - The transaction data to execute
+     * @param chainId - Target blockchain chain ID
+     * @returns Promise resolving to the transaction hash
+     */
+    sendBatch(transactionData: TransactionData[], chainId: SupportedChainId): Promise<WaitForUserOperationReceiptReturnType>;
+    /**
+     * Send a transaction via ERC-4337
+     * @description Executes a transaction using the smart wallet with automatic gas sponsorship.
+     * The transaction is sent as a UserOperation through the bundler service.
+     * @param transactionData - Transaction details (to, value, data)
+     * @param chainId - Target blockchain network ID
+     * @returns Promise resolving to UserOperation hash
+     * @throws Error if transaction fails or validation errors occur
+     */
+    send(transactionData: TransactionData, chainId: SupportedChainId): Promise<WaitForUserOperationReceiptReturnType>;
+    /**
+     * Add a new signer to the smart wallet
+     * @description Adds either an EOA address signer or a WebAuthn account signer
+     * to the underlying smart wallet contract. For WebAuthn accounts, the method
+     * extracts the x and y coordinates from the provided 64-byte public key and
+     * calls the contract's `addOwnerPublicKey`. For EOA addresses it calls
+     * `addOwnerAddress`. The add operation is sent as a UserOperation via
+     * {@link sendBatch}, and upon success the method queries the contract to
+     * resolve the signer's index.
+     * @param signer - Ethereum address (EOA) or a `WebAuthnAccount` to add
+     * @param chainId - Target chain on which the smart wallet operates
+     * @returns Promise resolving to the onchain signer index for the newly added signer
+     * @throws Error if the add operation fails or the owner index cannot be found
+     */
+    addSigner(signer: Signer, chainId: SupportedChainId): Promise<number>;
+    /**
+     * Remove an existing signer from the smart wallet
+     * @description Removes a signer (EOA address or WebAuthn public key) from the
+     * smart wallet contract. If `signerIndex` is not provided, the method resolves
+     * it via {@link findSignerIndexOnChain}. The removal is executed via {@link sendBatch}
+     * by calling the contract function `removeOwnerAtIndex(index, signerBytes)`.
+     * Returns the ERC-4337 UserOperation receipt on success.
+     * @param signer - Signer to remove: EOA address or `WebAuthnAccount`
+     * @param chainId - Target chain on which the smart wallet operates
+     * @param signerIndex - Optional known on-chain index of the signer (skips lookup when provided)
+     * @returns Promise resolving to the UserOperation receipt for the removal
+     * @throws Error if the signer index cannot be found or the removal operation fails
+     */
+    removeSigner(signer: Signer, chainId: SupportedChainId, signerIndex?: number): Promise<WaitForUserOperationReceiptReturnType>;
+    /**
+     * Find the index of a signer in the smart wallet
+     * @param signer - Ethereum address (EOA) or a `WebAuthnAccount` to find
+     * @param chainId - Target chain on which the smart wallet operates
+     * @returns Promise resolving to the onchain signer index for the found signer
+     * returns -1 if the signer is not found
+     */
+    findSignerIndexOnChain(signer: Signer, chainId: SupportedChainId): Promise<number>;
+    /**
+     * Deploy the smart wallet on a specific chain
+     * @description Triggers deployment of the smart wallet contract on the specified chain.
+     * If the wallet is already deployed, returns success immediately without creating a new transaction.
+     * Deployment is done by calling the factory's `createAccount` function, which is idempotent and will
+     * return the existing address if already deployed. The factory address is a fixed address that can be
+     * added to paymaster allowlists once, avoiding the need to allowlist each dynamically created wallet.
+     * @param chainId - Target chain ID to deploy the wallet on
+     * @returns Promise resolving to deployment result containing:
+     * - `chainId`: The chain ID where deployment was attempted
+     * - `success`: Whether the deployment succeeded
+     * - `receipt`: UserOperation receipt (undefined if wallet was already deployed)
+     * @throws {SmartWalletDeploymentError} If deployment fails or transaction reverts
+     */
+    deploy(chainId: SupportedChainId): Promise<{
+        chainId: SupportedChainId;
+        success: boolean;
+        receipt?: WaitForUserOperationReceiptReturnType;
+    }>;
+    /**
+     * Send tokens to another address
+     * @description Sends ETH or ERC20 tokens to a recipient address
+     * @param amount - Human-readable amount to send (e.g. 1.5)
+     * @param asset - Asset object with address mapping and metadata
+     * @param chainId - Chain ID for the transaction
+     * @param recipientAddress - Address to send to
+     * @returns Promise resolving to transaction data
+     * @throws Error if wallet is not initialized or asset is not supported
+     */
+    sendTokens(amount: number, asset: Asset, chainId: SupportedChainId, recipientAddress: Address): Promise<TransactionData>;
+    protected performInitialization(): Promise<void>;
+    /**
+     * Get the smart wallet address
+     * @description Returns the deployment address if known, otherwise calculates the deterministic
+     * address using CREATE2 based on signers and nonce.
+     * @returns Promise resolving to the wallet address
+     */
+    private getAddress;
+    /**
+     * Appends the attribution suffix to the bytes
+     * @param bytes
+     * @returns The bytes with the attribution suffix appended
+     */
+    private appendAttributionSuffix;
+}
+//# sourceMappingURL=DefaultSmartWallet.d.ts.map