@deserialize/multi-vm-wallet 1.2.441 → 1.3.0

package/dist/evm/aa-service/lib/account-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-adapter.js","sourceRoot":"","sources":["../../../../utils/evm/aa-service/lib/account-adapter.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAgBH,kDAYC;AAQD,wDAkBC;AAnDD,kEAA+D;AAG/D;;;;;;;;;GASG;AACH,SAAgB,mBAAmB,CAC/B,OAAY,EACZ,KAAY;IAEZ,OAAO;QACH,GAAG,OAAO;QACV,KAAK;QACL,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI;YAC9B,OAAO,EAAE,yCAAmB;YAC5B,OAAO,EAAE,KAAK;SACjB;KACqB,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAClC,iBAAsB,EACtB,aAAoC;IAEpC,wCAAwC;IACxC,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,IAAI,aAAa,CAAC,UAAU,IAAI;QAC3E,OAAO,EAAE,yCAAmB;QAC5B,OAAO,EAAE,KAAK;KACjB,CAAC;IAEF,OAAO;QACH,GAAG,iBAAiB;QACpB,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,UAAU,EAAE;YACR,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,yCAAmB;YAClD,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,KAAK;SACvC;KACqB,CAAC;AAC/B,CAAC"}

package/dist/evm/aa-service/lib/kernel-account.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Kernel Account Factory
+ *
+ * Modular factory for creating Kernel smart accounts with EIP-7702.
+ * Supports multiple bundlers, chains, and EntryPoint versions.
+ */
+import { Chain, Hex, SignAuthorizationReturnType } from 'viem';
+import { PrivateKeyAccount } from 'viem/accounts';
+import { BundlerManager } from '../services/bundler';
+import { BatchTransactionConfig, EntryPointVersion, KernelAccountConfig, KernelAccountInstance, KernelVersion, SingleTransactionConfig, Call } from './type';
+export type { Call, KernelAccountInstance, EntryPointVersion, KernelVersion, KernelAccountConfig, BatchTransactionConfig, SingleTransactionConfig } from './type';
+export declare function createKernel7702Account(config: KernelAccountConfig): Promise<KernelAccountInstance>;
+export declare function createKernelAuthorization(config: {
+    owner: PrivateKeyAccount;
+    chain: Chain;
+    bundlerManager: BundlerManager;
+    kernelVersion?: KernelVersion;
+}): Promise<SignAuthorizationReturnType | undefined>;
+/**
+ * Send batch transaction (RECOMMENDED for smart accounts)
+ *
+ * Sends multiple calls in a single UserOperation, paying gas only once.
+ * This is one of the main benefits of smart accounts over EOAs.
+ *
+ * @example
+ * // Send ETH to 3 recipients in one transaction
+ * await sendBatchTransaction({
+ *   kernelAccount: account,
+ *   bundlerManager,
+ *   calls: [
+ *     { to: '0xRecipient1', value: parseEther('0.01') },
+ *     { to: '0xRecipient2', value: parseEther('0.02') },
+ *     { to: '0xRecipient3', value: parseEther('0.03') }
+ *   ]
+ * });
+ */
+export declare function sendBatchTransaction(config: BatchTransactionConfig): Promise<Hex>;
+/**
+ * Send single transaction (convenience wrapper around sendBatchTransaction)
+ *
+ * For single operations, you can use this instead of sendBatchTransaction.
+ * Under the hood, it creates a batch with one call.
+ */
+export declare function sendKernelTransaction(config: SingleTransactionConfig): Promise<Hex>;
+export declare function waitForKernelReceipt(config: {
+    userOpHash: Hex;
+    chain: Chain;
+    bundlerManager: BundlerManager;
+}): Promise<any>;
+/**
+ * Configuration for sponsored batch transaction
+ */
+export interface SponsoredBatchTransactionConfig {
+    ownerAuthorization: SignAuthorizationReturnType;
+    calls: Call[];
+    feePayerPrivateKey: Hex;
+    bundlerUrl: string;
+    paymasterUrl?: string;
+    chain: Chain;
+    entryPointVersion?: EntryPointVersion;
+}
+/**
+ * Send sponsored batch transaction using EIP-7702
+ *
+ * Allows a feePayer wallet to pay gas fees for another wallet's transaction.
+ * The transaction executes from the owner's address, but gas is paid by the feePayer.
+ *
+ * @param config - Sponsored transaction configuration
+ * @returns UserOperation hash and transaction hash
+ *
+ * @example
+ * // Owner creates authorization
+ * const authorization = await createKernelAuthorization({
+ *   owner: ownerAccount,
+ *   chain,
+ *   bundlerManager
+ * });
+ *
+ * // FeePayer sends transaction
+ * const result = await sendSponsoredBatchTransaction({
+ *   ownerAuthorization: authorization,
+ *   calls: [{ to: recipient, value: parseEther('0.1') }],
+ *   feePayerPrivateKey: sponsorPrivateKey,
+ *   bundlerUrl,
+ *   chain
+ * });
+ */
+export declare function sendSponsoredBatchTransaction(config: SponsoredBatchTransactionConfig): Promise<{
+    userOpHash: Hex;
+    transactionHash?: string;
+}>;

package/dist/evm/aa-service/lib/kernel-account.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * Kernel Account Factory
+ *
+ * Modular factory for creating Kernel smart accounts with EIP-7702.
+ * Supports multiple bundlers, chains, and EntryPoint versions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKernel7702Account = createKernel7702Account;
+exports.createKernelAuthorization = createKernelAuthorization;
+exports.sendBatchTransaction = sendBatchTransaction;
+exports.sendKernelTransaction = sendKernelTransaction;
+exports.waitForKernelReceipt = waitForKernelReceipt;
+exports.sendSponsoredBatchTransaction = sendSponsoredBatchTransaction;
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const sdk_1 = require("@zerodev/sdk");
+const constants_1 = require("@zerodev/sdk/constants");
+const account_abstraction_1 = require("viem/account-abstraction");
+const bundler_1 = require("../services/bundler");
+// ============================================
+// EntryPoint Mapping
+// ============================================
+const ENTRYPOINT_MAP = {
+    '0.6': account_abstraction_1.entryPoint07Address, // Fallback to 0.7 for 0.6 requests
+    '0.7': account_abstraction_1.entryPoint07Address
+};
+// ============================================
+// Kernel Account Factory
+// ============================================
+async function createKernel7702Account(config) {
+    const { chain, owner, bundlerManager, entryPointVersion = '0.7', kernelVersion = '0.3.3' } = config;
+    // Create public client for standard RPC calls
+    // (Bundler clients don't support standard eth_* methods)
+    const publicClient = (0, viem_1.createPublicClient)({
+        chain,
+        transport: (0, viem_1.http)()
+    });
+    // Get EntryPoint address
+    const entryPointAddress = ENTRYPOINT_MAP[entryPointVersion];
+    if (!entryPointAddress) {
+        throw new Error(`Unsupported EntryPoint version: ${entryPointVersion}`);
+    }
+    // Create Kernel account with EIP-7702
+    // Use public client for account creation (needs eth_call, eth_getCode, etc.)
+    const kernelAccount = await (0, sdk_1.createKernelAccount)(publicClient, {
+        entryPoint: {
+            address: entryPointAddress,
+            version: entryPointVersion
+        },
+        kernelVersion: constants_1.KERNEL_V3_3,
+        eip7702Account: owner
+    });
+    return {
+        account: kernelAccount,
+        address: kernelAccount.address,
+        owner,
+        chain,
+        entryPoint: {
+            address: entryPointAddress,
+            version: entryPointVersion
+        }
+    };
+}
+// ============================================
+// EIP-7702 Authorization Helper
+// ============================================
+async function createKernelAuthorization(config) {
+    const { owner, chain, bundlerManager, kernelVersion = '0.3.3' } = config;
+    const bundlerClient = bundlerManager.getClient(chain);
+    // Create public client for eth_getCode (bundler clients don't support it)
+    const publicClient = (0, viem_1.createPublicClient)({
+        chain,
+        transport: (0, viem_1.http)()
+    });
+    // Get Kernel implementation address
+    const delegateAddress = constants_1.KernelVersionToAddressesMap[constants_1.KERNEL_V3_3].accountImplementationAddress;
+    // Check if already delegated
+    const code = await publicClient.getCode({ address: owner.address });
+    const expectedCode = `0xef0100${delegateAddress.toLowerCase().substring(2)}`;
+    if (code === expectedCode) {
+        console.log('Already delegated to Kernel, no authorization needed');
+        return undefined;
+    }
+    // Create authorization
+    console.log('Creating EIP-7702 authorization for Kernel...');
+    // Get nonce for authorization
+    const nonce = await publicClient.getTransactionCount({
+        address: owner.address,
+        blockTag: 'pending'
+    });
+    // Sign authorization using the account's signAuthorization method
+    const authorization = await owner.signAuthorization({
+        contractAddress: delegateAddress,
+        chainId: chain.id,
+        nonce: nonce
+    });
+    return authorization;
+}
+// ============================================
+// Transaction Helpers
+// ============================================
+/**
+ * Send batch transaction (RECOMMENDED for smart accounts)
+ *
+ * Sends multiple calls in a single UserOperation, paying gas only once.
+ * This is one of the main benefits of smart accounts over EOAs.
+ *
+ * @example
+ * // Send ETH to 3 recipients in one transaction
+ * await sendBatchTransaction({
+ *   kernelAccount: account,
+ *   bundlerManager,
+ *   calls: [
+ *     { to: '0xRecipient1', value: parseEther('0.01') },
+ *     { to: '0xRecipient2', value: parseEther('0.02') },
+ *     { to: '0xRecipient3', value: parseEther('0.03') }
+ *   ]
+ * });
+ */
+async function sendBatchTransaction(config) {
+    const { kernelAccount, bundlerManager, authorization, calls } = config;
+    if (calls.length === 0) {
+        throw new Error('Batch transaction must have at least one call');
+    }
+    const bundlerClient = bundlerManager.getClient(kernelAccount.chain);
+    // Normalize calls to ensure value and data are set
+    const normalizedCalls = calls.map(call => ({
+        to: call.to,
+        value: call.value ?? 0n,
+        data: call.data ?? '0x'
+    }));
+    const userOpHash = await bundlerClient.sendUserOperation({
+        account: kernelAccount.account,
+        authorization,
+        calls: normalizedCalls
+    });
+    return userOpHash;
+}
+/**
+ * Send single transaction (convenience wrapper around sendBatchTransaction)
+ *
+ * For single operations, you can use this instead of sendBatchTransaction.
+ * Under the hood, it creates a batch with one call.
+ */
+async function sendKernelTransaction(config) {
+    const { kernelAccount, bundlerManager, authorization, to, value = 0n, data = '0x' } = config;
+    // Use batch transaction with single call
+    return sendBatchTransaction({
+        kernelAccount,
+        bundlerManager,
+        authorization,
+        calls: [{
+                to,
+                value,
+                data
+            }]
+    });
+}
+// ============================================
+// Wait for Receipt Helper
+// ============================================
+async function waitForKernelReceipt(config) {
+    const { userOpHash, chain, bundlerManager } = config;
+    const bundlerClient = bundlerManager.getClient(chain);
+    const receipt = await bundlerClient.waitForUserOperationReceipt({
+        hash: userOpHash
+    });
+    return receipt;
+}
+/**
+ * Send sponsored batch transaction using EIP-7702
+ *
+ * Allows a feePayer wallet to pay gas fees for another wallet's transaction.
+ * The transaction executes from the owner's address, but gas is paid by the feePayer.
+ *
+ * @param config - Sponsored transaction configuration
+ * @returns UserOperation hash and transaction hash
+ *
+ * @example
+ * // Owner creates authorization
+ * const authorization = await createKernelAuthorization({
+ *   owner: ownerAccount,
+ *   chain,
+ *   bundlerManager
+ * });
+ *
+ * // FeePayer sends transaction
+ * const result = await sendSponsoredBatchTransaction({
+ *   ownerAuthorization: authorization,
+ *   calls: [{ to: recipient, value: parseEther('0.1') }],
+ *   feePayerPrivateKey: sponsorPrivateKey,
+ *   bundlerUrl,
+ *   chain
+ * });
+ */
+async function sendSponsoredBatchTransaction(config) {
+    const { ownerAuthorization, calls, feePayerPrivateKey, bundlerUrl, paymasterUrl, chain, entryPointVersion = '0.7' } = config;
+    if (calls.length === 0) {
+        throw new Error('Sponsored transaction must have at least one call');
+    }
+    // Create feePayer account
+    const feePayerAccount = (0, accounts_1.privateKeyToAccount)(feePayerPrivateKey);
+    // Create bundler service for feePayer
+    const feePayerBundlerService = (0, bundler_1.createBundlerService)({
+        provider: "custom",
+        customUrl: bundlerUrl,
+        chain
+    });
+    // Get bundler client (uses feePayer account internally)
+    const bundlerClient = feePayerBundlerService.getClient(chain);
+    // Create kernel account for feePayer (needed for sendUserOperation)
+    const publicClient = (0, viem_1.createPublicClient)({
+        chain,
+        transport: (0, viem_1.http)(chain.rpcUrls.default.http[0])
+    });
+    const entryPointAddress = ENTRYPOINT_MAP[entryPointVersion];
+    if (!entryPointAddress) {
+        throw new Error(`Unsupported EntryPoint version: ${entryPointVersion}`);
+    }
+    const feePayerKernelAccount = await (0, sdk_1.createKernelAccount)(publicClient, {
+        entryPoint: {
+            address: entryPointAddress,
+            version: entryPointVersion
+        },
+        kernelVersion: constants_1.KERNEL_V3_3,
+        eip7702Account: feePayerAccount
+    });
+    // Normalize calls
+    const normalizedCalls = calls.map(call => ({
+        to: call.to,
+        value: call.value ?? 0n,
+        data: call.data ?? '0x'
+    }));
+    // Send UserOperation with owner's authorization
+    // The transaction executes from owner's address, but feePayer pays gas
+    const userOpHash = await bundlerClient.sendUserOperation({
+        account: feePayerKernelAccount,
+        authorization: ownerAuthorization,
+        calls: normalizedCalls
+    });
+    // Wait for receipt
+    const receipt = await bundlerClient.waitForUserOperationReceipt({
+        hash: userOpHash
+    });
+    return {
+        userOpHash: userOpHash,
+        transactionHash: receipt?.receipt?.transactionHash
+    };
+}
+//# sourceMappingURL=kernel-account.js.map

package/dist/evm/aa-service/lib/kernel-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-account.js","sourceRoot":"","sources":["../../../../utils/evm/aa-service/lib/kernel-account.ts"],"names":[],"mappings":"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"}

package/dist/evm/aa-service/lib/kernel-modules.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Kernel Module Management
+ *
+ * Handles installation and management of ERC-7579 modules for Kernel v3 accounts:
+ * - Validators: Session keys, multi-sig, passkeys
+ * - Executors: Additional execution logic
+ * - Hooks: Pre/post execution hooks
+ * - Fallbacks: Handle unknown function calls
+ *
+ * ERC-7579 Module Types:
+ * 1 = Validator
+ * 2 = Executor
+ * 3 = Fallback
+ * 4 = Hook
+ */
+import { Hex } from 'viem';
+import { KernelAccountInstance } from './kernel-account';
+import { BundlerManager } from '../services/bundler';
+export type ModuleType = 'validator' | 'executor' | 'fallback' | 'hook';
+export declare const MODULE_TYPE_IDS: Record<ModuleType, number>;
+export interface InstallModuleConfig {
+    account: KernelAccountInstance;
+    bundlerManager: BundlerManager;
+    moduleType: ModuleType;
+    moduleAddress: Hex;
+    initData?: Hex;
+}
+export interface UninstallModuleConfig {
+    account: KernelAccountInstance;
+    bundlerManager: BundlerManager;
+    moduleType: ModuleType;
+    moduleAddress: Hex;
+    deInitData?: Hex;
+}
+export interface ModuleStatus {
+    isInstalled: boolean;
+    moduleAddress: Hex;
+    moduleType: ModuleType;
+}
+/**
+ * Session key permissions for automated operations
+ *
+ * Example: Allow automated monthly transfers to a savings account
+ */
+export interface SessionKeyPermission {
+    /** Target contract address (token, vault, etc.) */
+    target: Hex;
+    /** Maximum value per transaction (for ETH transfers) */
+    maxValuePerUse?: bigint;
+    /** Function selector to allow (e.g., transfer, approve) */
+    functionSelector?: Hex;
+    /** Maximum gas per transaction */
+    maxGasPerUse?: bigint;
+    /** Session expiry timestamp */
+    validUntil?: number;
+    /** Session start timestamp */
+    validAfter?: number;
+    /** Maximum number of uses */
+    maxUses?: number;
+}
+export interface CreateSessionKeyConfig {
+    account: KernelAccountInstance;
+    bundlerManager: BundlerManager;
+    sessionKeyAddress: Hex;
+    permissions: SessionKeyPermission[];
+}
+import { Call } from './kernel-account';
+/**
+ * Prepare installModule call (for batching)
+ *
+ * Returns a Call object that can be batched with other operations.
+ * Use this when you want to install multiple modules in one transaction.
+ *
+ * @example
+ * // Batch install multiple modules
+ * const calls = [
+ *     prepareInstallModule({ account, moduleType: 'validator', moduleAddress: '0x...' }),
+ *     prepareInstallModule({ account, moduleType: 'hook', moduleAddress: '0x...' })
+ * ];
+ * await aaService.sendBatchTransaction({ account, calls });
+ */
+export declare function prepareInstallModule(config: Omit<InstallModuleConfig, 'bundlerManager'>): Call;
+/**
+ * Install a module on a Kernel account (execute immediately)
+ *
+ * This uses the ERC-7579 standard installModule function.
+ * For batching multiple modules, use prepareInstallModule instead.
+ *
+ * @example
+ * // Install a single module
+ * const userOpHash = await installModule({
+ *     account,
+ *     bundlerManager,
+ *     moduleType: 'validator',
+ *     moduleAddress: SESSION_KEY_VALIDATOR_ADDRESS,
+ *     initData: encodedPermissions
+ * });
+ */
+export declare function installModule(config: InstallModuleConfig): Promise<Hex>;
+/**
+ * Prepare uninstallModule call (for batching)
+ *
+ * Returns a Call object that can be batched with other operations.
+ *
+ * @example
+ * // Batch uninstall multiple modules
+ * const calls = [
+ *     prepareUninstallModule({ account, moduleType: 'validator', moduleAddress: '0x...' }),
+ *     prepareUninstallModule({ account, moduleType: 'hook', moduleAddress: '0x...' })
+ * ];
+ * await aaService.sendBatchTransaction({ account, calls });
+ */
+export declare function prepareUninstallModule(config: Omit<UninstallModuleConfig, 'bundlerManager'>): Call;
+/**
+ * Uninstall a module from a Kernel account (execute immediately)
+ *
+ * For batching multiple uninstalls, use prepareUninstallModule instead.
+ *
+ * @example
+ * // Uninstall a single module
+ * const userOpHash = await uninstallModule({
+ *     account,
+ *     bundlerManager,
+ *     moduleType: 'validator',
+ *     moduleAddress: SESSION_KEY_VALIDATOR_ADDRESS
+ * });
+ */
+export declare function uninstallModule(config: UninstallModuleConfig): Promise<Hex>;
+/**
+ * Check if a module is installed on an account
+ *
+ * @example
+ * const isInstalled = await isModuleInstalled({
+ *     account,
+ *     bundlerManager,
+ *     moduleType: 'validator',
+ *     moduleAddress: SESSION_KEY_VALIDATOR_ADDRESS
+ * });
+ */
+export declare function isModuleInstalled(config: Omit<InstallModuleConfig, 'initData'>): Promise<boolean>;
+/**
+ * Prepare session key installation call (for batching)
+ *
+ * Returns a Call object that can be batched with other operations.
+ *
+ * @example
+ * // Batch install session key with other modules
+ * const calls = [
+ *     prepareInstallSessionKey({ account, sessionKeyAddress, permissions }),
+ *     prepareInstallModule({ account, moduleType: 'hook', moduleAddress: '0x...' })
+ * ];
+ * await aaService.sendBatchTransaction({ account, calls });
+ */
+export declare function prepareInstallSessionKey(config: Omit<CreateSessionKeyConfig, 'bundlerManager'>): Call;
+/**
+ * Create and install a session key validator (execute immediately)
+ *
+ * Session keys allow delegated access with specific permissions.
+ * Perfect for automated operations like recurring payments.
+ *
+ * For batching with other operations, use prepareInstallSessionKey instead.
+ *
+ * @example
+ * // Install session key for monthly savings automation
+ * const sessionKey = privateKeyToAccount('0x...');
+ *
+ * await createSessionKey({
+ *     account,
+ *     bundlerManager,
+ *     sessionKeyAddress: sessionKey.address,
+ *     permissions: [{
+ *         target: USDC_ADDRESS,
+ *         functionSelector: '0xa9059cbb', // transfer(address,uint256)
+ *         maxValuePerUse: parseUnits('100', 6), // Max 100 USDC per tx
+ *         validUntil: Date.now() + 30 * 24 * 60 * 60 * 1000, // 30 days
+ *         maxUses: 1 // Once per month
+ *     }]
+ * });
+ */
+export declare function createSessionKey(config: CreateSessionKeyConfig): Promise<Hex>;
+/**
+ * Prepare session key revocation call (for batching)
+ *
+ * Returns a Call object that can be batched with other operations.
+ *
+ * @example
+ * // Batch revoke multiple session keys
+ * const calls = [
+ *     prepareRevokeSessionKey({ account, sessionKeyAddress: key1 }),
+ *     prepareRevokeSessionKey({ account, sessionKeyAddress: key2 })
+ * ];
+ * await aaService.sendBatchTransaction({ account, calls });
+ */
+export declare function prepareRevokeSessionKey(config: {
+    account: KernelAccountInstance;
+    sessionKeyAddress: Hex;
+}): Call;
+/**
+ * Revoke a session key (execute immediately)
+ *
+ * For batching with other operations, use prepareRevokeSessionKey instead.
+ */
+export declare function revokeSessionKey(account: KernelAccountInstance, bundlerManager: BundlerManager, sessionKeyAddress: Hex): Promise<Hex>;
+/**
+ * Prepare multi-sig validator installation call (for batching)
+ *
+ * Returns a Call object that can be batched with other operations.
+ *
+ * @example
+ * // Batch install multi-sig with session key
+ * const calls = [
+ *     prepareInstallMultiSigValidator({ account, owners, threshold: 2 }),
+ *     prepareInstallSessionKey({ account, sessionKeyAddress, permissions })
+ * ];
+ * await aaService.sendBatchTransaction({ account, calls });
+ */
+export declare function prepareInstallMultiSigValidator(config: {
+    account: KernelAccountInstance;
+    owners: Hex[];
+    threshold: number;
+}): Call;
+/**
+ * Install a multi-signature validator (execute immediately)
+ *
+ * For batching with other operations, use prepareInstallMultiSigValidator instead.
+ *
+ * @example
+ * await installMultiSigValidator({
+ *     account,
+ *     bundlerManager,
+ *     owners: [owner1, owner2, owner3],
+ *     threshold: 2 // 2 of 3 signatures required
+ * });
+ */
+export declare function installMultiSigValidator(config: {
+    account: KernelAccountInstance;
+    bundlerManager: BundlerManager;
+    owners: Hex[];
+    threshold: number;
+}): Promise<Hex>;