@eth-optimism/actions-sdk 0.0.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"assets.test.js","sourceRoot":"","sources":["../../src/utils/assets.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,CAAC,uBAAuB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChE,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,CAAC,uBAAuB,CAAC,aAAa,EAAE,GAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxE,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAClD,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC/C,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAClD,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAChD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/utils/markets.d.ts

@@ -0,0 +1,17 @@
+import type { Asset } from '../types/asset.js';
+import type { LendMarket } from '../types/lend/index.js';
+/**
+ * Validates that an asset matches the market's asset
+ * @param market - Market information
+ * @param asset - Asset to validate
+ * @throws Error if asset doesn't match the market's asset
+ */
+export declare function validateMarketAsset(market: LendMarket, asset: Asset): void;
+/**
+ * Checks if an asset matches the market's asset
+ * @param market - Market information
+ * @param asset - Asset to check
+ * @returns true if asset matches market's asset, false otherwise
+ */
+export declare function isMarketAsset(market: LendMarket, asset: Asset): boolean;
+//# sourceMappingURL=markets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../src/utils/markets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAU1E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAMvE"}

package/dist/utils/markets.js

@@ -0,0 +1,25 @@
+/**
+ * Validates that an asset matches the market's asset
+ * @param market - Market information
+ * @param asset - Asset to validate
+ * @throws Error if asset doesn't match the market's asset
+ */
+export function validateMarketAsset(market, asset) {
+    if (!isMarketAsset(market, asset)) {
+        const marketAssetAddress = market.asset.address[market.marketId.chainId];
+        const providedAssetAddress = asset.address[market.marketId.chainId];
+        throw new Error(`Asset mismatch: provided ${providedAssetAddress} but market ${market.marketId.address} uses ${marketAssetAddress}`);
+    }
+}
+/**
+ * Checks if an asset matches the market's asset
+ * @param market - Market information
+ * @param asset - Asset to check
+ * @returns true if asset matches market's asset, false otherwise
+ */
+export function isMarketAsset(market, asset) {
+    const marketAssetAddress = market.asset.address[market.marketId.chainId];
+    const providedAssetAddress = asset.address[market.marketId.chainId];
+    return marketAssetAddress === providedAssetAddress;
+}
+//# sourceMappingURL=markets.js.map

package/dist/utils/markets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markets.js","sourceRoot":"","sources":["../../src/utils/markets.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB,EAAE,KAAY;IAClE,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,kBAAkB,GACtB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAA2B,CAAC,CAAA;QACnE,MAAM,oBAAoB,GACxB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAA2B,CAAC,CAAA;QAC5D,MAAM,IAAI,KAAK,CACb,4BAA4B,oBAAoB,eAAe,MAAM,CAAC,QAAQ,CAAC,OAAO,SAAS,kBAAkB,EAAE,CACpH,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,KAAY;IAC5D,MAAM,kBAAkB,GACtB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAA2B,CAAC,CAAA;IACnE,MAAM,oBAAoB,GACxB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAA2B,CAAC,CAAA;IAC5D,OAAO,kBAAkB,KAAK,oBAAoB,CAAA;AACpD,CAAC"}

package/dist/utils/test.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Test utilities for the Actions SDK
+ */
+import type { ChildProcess } from 'child_process';
+import type { Chain, PublicClient } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+/**
+ * Standard anvil/foundry test accounts with predictable private keys
+ * These are the default accounts created by anvil and are safe to use in tests
+ */
+export declare const ANVIL_ACCOUNTS: {
+    /** Account #0 - Default primary test account */
+    readonly ACCOUNT_0: "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+    /** Account #1 - Secondary test account, commonly used as funder */
+    readonly ACCOUNT_1: "0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d";
+    /** Account #2 - Third test account */
+    readonly ACCOUNT_2: "0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a";
+};
+/**
+ * Helper function to check if external tests should run
+ * External tests make real network requests and are only run when EXTERNAL_TEST=true
+ *
+ * Usage:
+ * ```typescript
+ * import { externalTest } from './test.js'
+ *
+ * it.runIf(externalTest())('should make real API request', async () => {
+ *   // Test that makes actual network calls
+ * })
+ * ```
+ */
+export declare const externalTest: () => boolean;
+/**
+ * Helper function to check if supersim tests should run
+ * Supersim tests require supersim to be installed and are only run when SUPERSIM_TEST=true
+ *
+ * Usage:
+ * ```typescript
+ * import { supersimTest } from './test.js'
+ *
+ * describe.runIf(supersimTest())('Supersim Integration', () => {
+ *   // Tests that require supersim
+ * })
+ * ```
+ */
+export declare const supersimTest: () => boolean;
+/**
+ * Configuration for supersim test setup
+ */
+export interface SupersimConfig {
+    /** L1 port (default: 8546) */
+    l1Port?: number;
+    /** L2 starting port (default: 9546) */
+    l2StartingPort?: number;
+    /** Chains to fork (default: ['unichain']) */
+    chains?: string[];
+    /** Enable verbose logging (default: false) */
+    verbose?: boolean;
+}
+/**
+ * Start supersim with forked chains
+ *
+ * Prerequisites:
+ * - supersim must be installed (brew install ethereum-optimism/tap/supersim)
+ * - foundry must be installed (curl -L https://foundry.paradigm.xyz | bash)
+ * @param config - Supersim configuration
+ * @returns Promise that resolves with the supersim process when ready
+ * @throws Error if supersim is not available
+ */
+export declare function startSupersim(config?: SupersimConfig): Promise<ChildProcess>;
+/**
+ * Stop supersim process and all child processes gracefully
+ * @param supersimProcess - The supersim process to stop
+ */
+export declare function stopSupersim(supersimProcess: ChildProcess): Promise<void>;
+/**
+ * Configuration for wallet funding
+ */
+export interface FundWalletConfig {
+    /** RPC URL for the chain */
+    rpcUrl: string;
+    /** Chain configuration */
+    chain: Chain;
+    /** Target wallet address to fund */
+    targetAddress: `0x${string}`;
+    /** Amount to fund in ETH (default: '10') */
+    amount?: string;
+    /** Funder private key (default: ANVIL_ACCOUNTS.ACCOUNT_1) */
+    funderPrivateKey?: `0x${string}`;
+    /** Whether to also fund with USDC (default: false) */
+    fundUsdc?: boolean;
+    /** Amount of USDC to fund (default: '1000') */
+    usdcAmount?: string;
+}
+/**
+ * Fund a wallet with ETH and optionally USDC using a funder account
+ * @param config - Wallet funding configuration
+ * @returns Promise that resolves when funding is complete
+ */
+export declare function fundWallet(config: FundWalletConfig): Promise<void>;
+/**
+ * Create a test setup for supersim with funded wallet
+ * @param config - Combined configuration for supersim and wallet funding
+ * @returns Promise that resolves with supersim process, public client, and test account
+ */
+export declare function setupSupersimTest(config: {
+    supersim?: SupersimConfig;
+    wallet: Omit<FundWalletConfig, 'targetAddress'> & {
+        testPrivateKey?: `0x${string}`;
+        address?: `0x${string}`;
+    };
+}): Promise<{
+    supersimProcess: ChildProcess;
+    publicClient: PublicClient;
+    testAccount: ReturnType<typeof privateKeyToAccount>;
+}>;
+//# sourceMappingURL=test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/utils/test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAEnD;;;GAGG;AACH,eAAO,MAAM,cAAc;IACzB,gDAAgD;;IAGhD,mEAAmE;;IAGnE,sCAAsC;;CAG9B,CAAA;AAEV;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,eAA6C,CAAA;AAEtE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,eAA6C,CAAA;AAEtE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,MAAM,GAAE,cAAmB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA2EvB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,eAAe,EAAE,YAAY,GAC5B,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,oCAAoC;IACpC,aAAa,EAAE,KAAK,MAAM,EAAE,CAAA;IAC5B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;IAChC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2GxE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,GAAG;QAChD,cAAc,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;QAC9B,OAAO,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;KACxB,CAAA;CACF,GAAG,OAAO,CAAC;IACV,eAAe,EAAE,YAAY,CAAA;IAC7B,YAAY,EAAE,YAAY,CAAA;IAC1B,WAAW,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;CACpD,CAAC,CA4BD"}

package/dist/utils/test.js

@@ -0,0 +1,265 @@
+/**
+ * Test utilities for the Actions SDK
+ */
+import { spawn } from 'child_process';
+import { createPublicClient, createWalletClient, http, parseEther } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+/**
+ * Standard anvil/foundry test accounts with predictable private keys
+ * These are the default accounts created by anvil and are safe to use in tests
+ */
+export const ANVIL_ACCOUNTS = {
+    /** Account #0 - Default primary test account */
+    ACCOUNT_0: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
+    /** Account #1 - Secondary test account, commonly used as funder */
+    ACCOUNT_1: '0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d',
+    /** Account #2 - Third test account */
+    ACCOUNT_2: '0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a',
+};
+/**
+ * Helper function to check if external tests should run
+ * External tests make real network requests and are only run when EXTERNAL_TEST=true
+ *
+ * Usage:
+ * ```typescript
+ * import { externalTest } from './test.js'
+ *
+ * it.runIf(externalTest())('should make real API request', async () => {
+ *   // Test that makes actual network calls
+ * })
+ * ```
+ */
+export const externalTest = () => process.env.EXTERNAL_TEST === 'true';
+/**
+ * Helper function to check if supersim tests should run
+ * Supersim tests require supersim to be installed and are only run when SUPERSIM_TEST=true
+ *
+ * Usage:
+ * ```typescript
+ * import { supersimTest } from './test.js'
+ *
+ * describe.runIf(supersimTest())('Supersim Integration', () => {
+ *   // Tests that require supersim
+ * })
+ * ```
+ */
+export const supersimTest = () => process.env.SUPERSIM_TEST === 'true';
+/**
+ * Start supersim with forked chains
+ *
+ * Prerequisites:
+ * - supersim must be installed (brew install ethereum-optimism/tap/supersim)
+ * - foundry must be installed (curl -L https://foundry.paradigm.xyz | bash)
+ * @param config - Supersim configuration
+ * @returns Promise that resolves with the supersim process when ready
+ * @throws Error if supersim is not available
+ */
+export async function startSupersim(config = {}) {
+    const { l1Port = 8546, l2StartingPort = 9546, chains = ['unichain'], verbose = true, // Always verbose for supersim tests
+     } = config;
+    console.log(`Starting supersim with forked chains: ${chains.join(', ')}...`);
+    console.log('Verbose mode enabled - supersim logs will be displayed');
+    // Start supersim with forked chains on custom ports to avoid conflicts
+    const supersimProcess = spawn('supersim', [
+        'fork',
+        '--chains',
+        ...chains,
+        '--l1.port',
+        l1Port.toString(),
+        '--l2.starting.port',
+        l2StartingPort.toString(),
+    ], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        detached: true, // Create new process group so we can kill all children
+    });
+    // Handle case where supersim command is not found
+    supersimProcess.on('error', (error) => {
+        if (error.code === 'ENOENT') {
+            throw new Error('supersim command not found. Please install supersim:\n' +
+                '  macOS/Linux: brew install ethereum-optimism/tap/supersim\n' +
+                '  Or download from: https://github.com/ethereum-optimism/supersim/releases');
+        }
+        throw error;
+    });
+    // Wait for supersim to be ready
+    await new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            reject(new Error('Supersim failed to start within 30 seconds'));
+        }, 30000);
+        // Log supersim output and wait for ready message
+        supersimProcess?.stdout?.on('data', (data) => {
+            const output = data.toString();
+            if (verbose) {
+                console.log(`[supersim stdout]: ${output}`);
+            }
+            if (output.includes('supersim is ready')) {
+                clearTimeout(timeout);
+                console.log('Supersim is ready!');
+                resolve();
+            }
+        });
+        supersimProcess?.stderr?.on('data', (data) => {
+            const errorOutput = data.toString();
+            if (verbose) {
+                console.error(`[supersim stderr]: ${errorOutput}`);
+            }
+        });
+        supersimProcess?.on('error', (err) => {
+            clearTimeout(timeout);
+            reject(err);
+        });
+    });
+    return supersimProcess;
+}
+/**
+ * Stop supersim process and all child processes gracefully
+ * @param supersimProcess - The supersim process to stop
+ */
+export async function stopSupersim(supersimProcess) {
+    console.log('Stopping supersim...');
+    if (supersimProcess && supersimProcess.pid) {
+        try {
+            // Kill the entire process group (negative PID kills the group)
+            process.kill(-supersimProcess.pid, 'SIGTERM');
+        }
+        catch {
+            // Fallback to killing just the main process
+            supersimProcess.kill('SIGTERM');
+        }
+        // Wait for process to exit with timeout
+        await new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                // Force kill if still running after timeout
+                try {
+                    if (supersimProcess.pid && !supersimProcess.killed) {
+                        process.kill(-supersimProcess.pid, 'SIGKILL');
+                    }
+                }
+                catch {
+                    if (!supersimProcess.killed) {
+                        supersimProcess.kill('SIGKILL');
+                    }
+                }
+                resolve(undefined);
+            }, 10000); // 10 second timeout for graceful shutdown
+            supersimProcess?.on('exit', () => {
+                clearTimeout(timeout);
+                resolve(undefined);
+            });
+        });
+    }
+    console.log('Supersim stopped');
+}
+/**
+ * Fund a wallet with ETH and optionally USDC using a funder account
+ * @param config - Wallet funding configuration
+ * @returns Promise that resolves when funding is complete
+ */
+export async function fundWallet(config) {
+    const { rpcUrl, chain, targetAddress, amount = '10', funderPrivateKey = ANVIL_ACCOUNTS.ACCOUNT_1, // Use anvil account #1 as default funder
+    fundUsdc = false, usdcAmount = '1000', } = config;
+    console.log('Funding test wallet...');
+    // Create public client for waiting for transaction receipt
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(rpcUrl),
+    });
+    // Create funder account and wallet client
+    const funderAccount = privateKeyToAccount(funderPrivateKey);
+    const funderClient = createWalletClient({
+        account: funderAccount,
+        chain,
+        transport: http(rpcUrl),
+    }); // Type assertion to avoid viem version compatibility issue
+    // Send ETH funding transaction
+    const fundingTx = await funderClient.sendTransaction({
+        to: targetAddress,
+        value: parseEther(amount),
+    });
+    // Wait for transaction confirmation
+    await publicClient.waitForTransactionReceipt({ hash: fundingTx });
+    console.log(`Test wallet funded with ${amount} ETH at ${targetAddress}`);
+    // Fund with USDC if requested using whale impersonation
+    if (fundUsdc) {
+        try {
+            console.log(`Attempting to fund ${usdcAmount} USDC using whale impersonation...`);
+            // USDC whale address with large balance
+            const usdcWhale = '0x5752e57DcfA070e3822d69498185B706c293C792';
+            // Impersonate the whale account
+            console.log(`Impersonating whale account: ${usdcWhale}`);
+            await publicClient.request({
+                method: 'anvil_impersonateAccount',
+                params: [usdcWhale],
+            });
+            // USDC contract address on Unichain (from vault config)
+            const usdcAddress = '0x078d782b760474a361dda0af3839290b0ef57ad6';
+            // Create whale wallet client (for impersonated account, we use the address directly)
+            const whaleClient = createWalletClient({
+                account: usdcWhale,
+                chain,
+                transport: http(rpcUrl),
+            });
+            // Transfer USDC from whale to target
+            const usdcAmountWei = BigInt(parseFloat(usdcAmount) * 1e6); // USDC has 6 decimals
+            console.log(`Transferring ${usdcAmount} USDC (${usdcAmountWei} units) from whale to ${targetAddress}`);
+            const transferTx = await whaleClient.writeContract({
+                address: usdcAddress,
+                abi: [
+                    {
+                        name: 'transfer',
+                        type: 'function',
+                        stateMutability: 'nonpayable',
+                        inputs: [
+                            { name: 'to', type: 'address' },
+                            { name: 'amount', type: 'uint256' },
+                        ],
+                        outputs: [{ name: '', type: 'bool' }],
+                    },
+                ],
+                functionName: 'transfer',
+                args: [targetAddress, usdcAmountWei],
+            });
+            // Wait for transaction confirmation
+            await publicClient.waitForTransactionReceipt({ hash: transferTx });
+            console.log(`✅ Successfully funded ${usdcAmount} USDC to ${targetAddress}`);
+            // Stop impersonating the account
+            await publicClient.request({
+                method: 'anvil_stopImpersonatingAccount',
+                params: [usdcWhale],
+            });
+        }
+        catch (error) {
+            console.log(`❌ Failed to fund USDC: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            console.log(`   This may cause lending tests to fail if USDC is required`);
+        }
+    }
+}
+/**
+ * Create a test setup for supersim with funded wallet
+ * @param config - Combined configuration for supersim and wallet funding
+ * @returns Promise that resolves with supersim process, public client, and test account
+ */
+export async function setupSupersimTest(config) {
+    const testPrivateKey = config.wallet.testPrivateKey || ANVIL_ACCOUNTS.ACCOUNT_0; // Use anvil account #0 as default test account
+    // Start supersim
+    const supersimProcess = await startSupersim(config.supersim);
+    // Setup viem clients
+    const publicClient = createPublicClient({
+        chain: config.wallet.chain,
+        transport: http(config.wallet.rpcUrl),
+    });
+    // Create test account
+    const testAccount = privateKeyToAccount(testPrivateKey);
+    // Fund the wallet - use custom address if provided, otherwise use test account
+    const targetAddress = config.wallet.address || testAccount.address;
+    await fundWallet({
+        ...config.wallet,
+        targetAddress,
+    });
+    return {
+        supersimProcess,
+        publicClient,
+        testAccount,
+    };
+}
+//# sourceMappingURL=test.js.map

package/dist/utils/test.js.map

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

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

@@ -0,0 +1,84 @@
+import type { LocalAccount } from 'viem';
+import type { CreateSmartWalletOptions, GetSmartWalletOptions } from '../../../types/wallet.js';
+import type { HostedWalletProvider } from '../providers/hosted/abstract/HostedWalletProvider.js';
+import type { SmartWalletProvider } from '../providers/smart/abstract/SmartWalletProvider.js';
+import type { SmartWalletCreationResult } from '../providers/smart/abstract/types/index.js';
+import type { WalletProvider } from '../providers/WalletProvider.js';
+import type { Wallet } from '../wallets/abstract/Wallet.js';
+import type { SmartWallet } from '../wallets/smart/abstract/SmartWallet.js';
+/**
+ * Wallet namespace that provides unified wallet operations
+ * @description Provides access to wallet functionality through a single provider interface
+ */
+export declare class WalletNamespace<THostedProviderType extends string, TToActionsMap extends Record<THostedProviderType, unknown>, H extends HostedWalletProvider<THostedProviderType, TToActionsMap> = HostedWalletProvider<THostedProviderType, TToActionsMap>, S extends SmartWalletProvider = SmartWalletProvider> {
+    private provider;
+    constructor(provider: WalletProvider<THostedProviderType, TToActionsMap, H, S>);
+    /**
+     * Get direct access to the hosted wallet provider
+     * @description Provides direct access to the underlying hosted wallet provider when
+     * advanced functionality beyond the unified interface is needed
+     * @returns The configured hosted wallet provider instance
+     */
+    get hostedWalletProvider(): H;
+    /**
+     * Get direct access to the smart wallet provider
+     * @description Provides direct access to the underlying smart wallet provider when
+     * advanced functionality beyond the unified interface is needed
+     * @returns The configured smart wallet provider instance
+     */
+    get smartWalletProvider(): S;
+    /**
+     * Create a new smart wallet
+     * @description Creates a smart wallet and attempts to deploy it across all supported chains.
+     * The wallet address is deterministically calculated from owners and nonce. The signer must
+     * be included in the owners array. Deployment failures on individual chains do not prevent
+     * wallet creation - they are reported in the result.
+     * @param params - Smart wallet creation parameters
+     * @param params.owners - Array of owners for the smart wallet (addresses or WebAuthn public keys)
+     * @param params.signer - Local account used for signing transactions (must be in owners array)
+     * @param params.nonce - Optional nonce for smart wallet 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
+     * @throws Error if signer is not included in the owners array
+     */
+    createSmartWallet(params: CreateSmartWalletOptions): Promise<SmartWalletCreationResult<SmartWallet>>;
+    /**
+     * 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
+     */
+    createSigner(params: TToActionsMap[THostedProviderType]): Promise<LocalAccount>;
+    /**
+     * 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
+     * @param params.walletId - Unique identifier for the hosted wallet
+     * @param params.address - Ethereum address of the hosted wallet
+     * @returns Promise resolving to the Actions wallet instance
+     */
+    hostedWalletToActionsWallet(params: TToActionsMap[THostedProviderType]): Promise<Wallet>;
+    /**
+     * Get an existing smart wallet with a provided signer
+     * @description Retrieves a smart wallet using a directly provided signer. This is useful when
+     * you already have a LocalAccount signer and want to access an existing smart wallet without
+     * going through the hosted wallet provider. Use this instead of getSmartWalletWithHostedSigner
+     * when you have direct control over the signer.
+     * @param signer - Local account to use for signing transactions on the smart wallet
+     * @param getWalletParams - Wallet retrieval parameters
+     * @param getWalletParams.deploymentOwners - Array of original deployment owners for smart wallet address calculation. Required if walletAddress not provided. Must match the exact owners array used during wallet deployment.
+     * @param getWalletParams.signerOwnerIndex - Current index of the signer in the smart wallet's current owners array (used for transaction signing). Defaults to 0 if not specified. This may differ from the original deployment index if owners have been modified.
+     * @param getWalletParams.walletAddress - Optional explicit smart wallet address (skips address calculation)
+     * @param getWalletParams.nonce - Optional nonce used during smart wallet creation
+     * @returns Promise resolving to the smart wallet instance with the provided signer
+     * @throws Error if neither walletAddress nor deploymentOwners provided
+     */
+    getSmartWallet(params: GetSmartWalletOptions): Promise<SmartWallet>;
+}
+//# sourceMappingURL=WalletNamespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletNamespace.d.ts","sourceRoot":"","sources":["../../../../src/wallet/core/namespace/WalletNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAA;AAC3G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAA;AACxG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAA;AAEtF;;;GAGG;AACH,qBAAa,eAAe,CAC1B,mBAAmB,SAAS,MAAM,EAClC,aAAa,SAAS,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAC1D,CAAC,SAAS,oBAAoB,CAC5B,mBAAmB,EACnB,aAAa,CACd,GAAG,oBAAoB,CAAC,mBAAmB,EAAE,aAAa,CAAC,EAC5D,CAAC,SAAS,mBAAmB,GAAG,mBAAmB;IAEnD,OAAO,CAAC,QAAQ,CAA0D;gBAGxE,QAAQ,EAAE,cAAc,CAAC,mBAAmB,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAKpE;;;;;OAKG;IACH,IAAI,oBAAoB,IAAI,CAAC,CAE5B;IAED;;;;;OAKG;IACH,IAAI,mBAAmB,IAAI,CAAC,CAE3B;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,iBAAiB,CACrB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAIlD;;;;;;;;OAQG;IACG,YAAY,CAChB,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACzC,OAAO,CAAC,YAAY,CAAC;IAIxB;;;;;;;OAOG;IACG,2BAA2B,CAC/B,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;;;;;;;;;OAcG;IACG,cAAc,CAAC,MAAM,EAAE,qBAAqB;CAGnD"}

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

@@ -0,0 +1,89 @@
+/**
+ * Wallet namespace that provides unified wallet operations
+ * @description Provides access to wallet functionality through a single provider interface
+ */
+export class WalletNamespace {
+    constructor(provider) {
+        this.provider = provider;
+    }
+    /**
+     * Get direct access to the hosted wallet provider
+     * @description Provides direct access to the underlying hosted wallet provider when
+     * advanced functionality beyond the unified interface is needed
+     * @returns The configured hosted wallet provider instance
+     */
+    get hostedWalletProvider() {
+        return this.provider.hostedWalletProvider;
+    }
+    /**
+     * Get direct access to the smart wallet provider
+     * @description Provides direct access to the underlying smart wallet provider when
+     * advanced functionality beyond the unified interface is needed
+     * @returns The configured smart wallet provider instance
+     */
+    get smartWalletProvider() {
+        return this.provider.smartWalletProvider;
+    }
+    /**
+     * Create a new smart wallet
+     * @description Creates a smart wallet and attempts to deploy it across all supported chains.
+     * The wallet address is deterministically calculated from owners and nonce. The signer must
+     * be included in the owners array. Deployment failures on individual chains do not prevent
+     * wallet creation - they are reported in the result.
+     * @param params - Smart wallet creation parameters
+     * @param params.owners - Array of owners for the smart wallet (addresses or WebAuthn public keys)
+     * @param params.signer - Local account used for signing transactions (must be in owners array)
+     * @param params.nonce - Optional nonce for smart wallet 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
+     * @throws Error if signer is not included in the owners array
+     */
+    async createSmartWallet(params) {
+        return this.provider.createSmartWallet(params);
+    }
+    /**
+     * 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
+     */
+    async createSigner(params) {
+        return this.provider.createSigner(params);
+    }
+    /**
+     * 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
+     * @param params.walletId - Unique identifier for the hosted wallet
+     * @param params.address - Ethereum address of the hosted wallet
+     * @returns Promise resolving to the Actions wallet instance
+     */
+    async hostedWalletToActionsWallet(params) {
+        return this.provider.hostedWalletToActionsWallet(params);
+    }
+    /**
+     * Get an existing smart wallet with a provided signer
+     * @description Retrieves a smart wallet using a directly provided signer. This is useful when
+     * you already have a LocalAccount signer and want to access an existing smart wallet without
+     * going through the hosted wallet provider. Use this instead of getSmartWalletWithHostedSigner
+     * when you have direct control over the signer.
+     * @param signer - Local account to use for signing transactions on the smart wallet
+     * @param getWalletParams - Wallet retrieval parameters
+     * @param getWalletParams.deploymentOwners - Array of original deployment owners for smart wallet address calculation. Required if walletAddress not provided. Must match the exact owners array used during wallet deployment.
+     * @param getWalletParams.signerOwnerIndex - Current index of the signer in the smart wallet's current owners array (used for transaction signing). Defaults to 0 if not specified. This may differ from the original deployment index if owners have been modified.
+     * @param getWalletParams.walletAddress - Optional explicit smart wallet address (skips address calculation)
+     * @param getWalletParams.nonce - Optional nonce used during smart wallet creation
+     * @returns Promise resolving to the smart wallet instance with the provided signer
+     * @throws Error if neither walletAddress nor deploymentOwners provided
+     */
+    async getSmartWallet(params) {
+        return this.provider.getSmartWallet(params);
+    }
+}
+//# sourceMappingURL=WalletNamespace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletNamespace.js","sourceRoot":"","sources":["../../../../src/wallet/core/namespace/WalletNamespace.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,OAAO,eAAe;IAW1B,YACE,QAAkE;QAElE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAED;;;;;OAKG;IACH,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAA;IAC3C,CAAC;IAED;;;;;OAKG;IACH,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAA;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,iBAAiB,CACrB,MAAgC;QAEhC,OAAO,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAChD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAChB,MAA0C;QAE1C,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,2BAA2B,CAC/B,MAA0C;QAE1C,OAAO,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IAC1D,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,cAAc,CAAC,MAA6B;QAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;IAC7C,CAAC;CACF"}

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

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

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

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