@deserialize/multi-vm-wallet 1.2.441 → 1.3.1

package/dist/evm/aa-service/lib/session-keys.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * EIP-7702 Session Keys Utilities
+ *
+ * Utilities for creating and managing session keys with ZeroDev's permission system.
+ * This uses the NEW EIP-7702 pattern, not the legacy smart account pattern.
+ *
+ * Key differences from legacy pattern:
+ * - Uses `eip7702Account` instead of `address`
+ * - Uses `addressToEmptyAccount` for permission validator creation
+ * - Passes `sessionKeySigner` to `deserializePermissionAccount`
+ * - No sudo validator needed, only permission plugin
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSessionKey = generateSessionKey;
+exports.recreateSessionKey = recreateSessionKey;
+exports.createSessionKeyApproval = createSessionKeyApproval;
+exports.deserializeSessionKey = deserializeSessionKey;
+exports.createSessionKeyClient = createSessionKeyClient;
+exports.createUSDCTransferPermission = createUSDCTransferPermission;
+exports.createETHTransferPermission = createETHTransferPermission;
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const sdk_1 = require("@zerodev/sdk");
+const signers_1 = require("@zerodev/permissions/signers");
+const permissions_1 = require("@zerodev/permissions");
+const policies_1 = require("@zerodev/permissions/policies");
+const constants_1 = require("@zerodev/sdk/constants");
+// ============================================
+// Session Key Generation
+// ============================================
+/**
+ * Generate a new session key
+ *
+ * Creates a new keypair for use as a session key.
+ * The private key should be stored securely and shared with the agent.
+ * The address should be shared with the owner for approval.
+ *
+ * @returns Session key info including private key, address, and signer
+ *
+ * @example
+ * const sessionKey = await generateSessionKey();
+ * console.log("Share this address with owner:", sessionKey.address);
+ * console.log("Keep this private key secure:", sessionKey.privateKey);
+ */
+async function generateSessionKey() {
+    const sessionPrivateKey = (0, accounts_1.generatePrivateKey)();
+    const sessionKeyAccount = (0, accounts_1.privateKeyToAccount)(sessionPrivateKey);
+    const sessionKeySigner = await (0, signers_1.toECDSASigner)({
+        signer: sessionKeyAccount,
+    });
+    return {
+        privateKey: sessionPrivateKey,
+        address: sessionKeyAccount.address,
+        signer: sessionKeySigner
+    };
+}
+/**
+ * Recreate session key from private key
+ *
+ * Recreates a session key signer from a stored private key.
+ *
+ * @param privateKey - The session key private key
+ * @returns Session key info
+ *
+ * @example
+ * const sessionKey = await recreateSessionKey(storedPrivateKey);
+ */
+async function recreateSessionKey(privateKey) {
+    const sessionKeyAccount = (0, accounts_1.privateKeyToAccount)(privateKey);
+    const sessionKeySigner = await (0, signers_1.toECDSASigner)({
+        signer: sessionKeyAccount,
+    });
+    return {
+        privateKey,
+        address: sessionKeyAccount.address,
+        signer: sessionKeySigner
+    };
+}
+// ============================================
+// Owner Side: Create Approval
+// ============================================
+/**
+ * Create session key approval (Owner side)
+ *
+ * The owner calls this to create an approval for a session key address.
+ * This uses the NEW EIP-7702 pattern with addressToEmptyAccount.
+ *
+ * @param options - Configuration options
+ * @returns Serialized approval string to share with the agent
+ *
+ * @example
+ * // Owner approves session key
+ * const approval = await createSessionKeyApproval({
+ *     sessionKeyAddress: '0x...', // Agent's session key address
+ *     owner: ownerAccount,
+ *     chain: sepolia,
+ *     permissions: [{
+ *         target: USDC_ADDRESS,
+ *         abi: parseAbi(['function transfer(address to, uint256 amount)']),
+ *         functionName: 'transfer',
+ *         args: [null, { condition: 3, value: parseUnits('10', 6) }]
+ *     }]
+ * });
+ * // Share approval with agent
+ */
+async function createSessionKeyApproval(options) {
+    const { sessionKeyAddress, owner, chain, entryPointVersion = '0.7', useSudoPolicy = false, permissions = [] } = options;
+    const publicClient = (0, viem_1.createPublicClient)({
+        chain,
+        transport: (0, viem_1.http)()
+    });
+    const entryPoint = (0, constants_1.getEntryPoint)(entryPointVersion);
+    // Create "empty account" from just the session key address
+    // This is the KEY difference from legacy pattern!
+    const emptyAccount = (0, sdk_1.addressToEmptyAccount)(sessionKeyAddress);
+    const emptySessionKeySigner = await (0, signers_1.toECDSASigner)({
+        signer: emptyAccount
+    });
+    // Create permission plugin
+    let policies;
+    if (useSudoPolicy || permissions.length === 0) {
+        // Sudo policy - unrestricted access
+        policies = [(0, policies_1.toSudoPolicy)({})];
+    }
+    else {
+        // Call policy - restricted access
+        const callPermissions = permissions.map(perm => ({
+            target: perm.target,
+            abi: perm.abi,
+            functionName: perm.functionName,
+            args: perm.args || []
+        }));
+        policies = [
+            (0, policies_1.toCallPolicy)({
+                policyVersion: policies_1.CallPolicyVersion.V0_0_5,
+                permissions: callPermissions
+            })
+        ];
+    }
+    const permissionPlugin = await (0, permissions_1.toPermissionValidator)(publicClient, {
+        entryPoint,
+        signer: emptySessionKeySigner,
+        policies,
+        kernelVersion: constants_1.KERNEL_V3_3,
+    });
+    // Create kernel account with eip7702Account (NOT address!)
+    const sessionKeyAccount = await (0, sdk_1.createKernelAccount)(publicClient, {
+        entryPoint,
+        eip7702Account: owner, // ← EIP-7702 pattern
+        plugins: {
+            regular: permissionPlugin,
+        },
+        kernelVersion: constants_1.KERNEL_V3_3,
+        // NO address parameter!
+    });
+    // Serialize approval (no private key in approval)
+    // TODO: serializePermissionAccount not available in @zerodev/sdk yet
+    // const approval = await serializePermissionAccount(sessionKeyAccount);
+    const approval = JSON.stringify({ sessionKeyAccount: 'placeholder' });
+    return approval;
+}
+// ============================================
+// Agent Side: Use Session Key
+// ============================================
+/**
+ * Deserialize session key account (Agent side)
+ *
+ * The agent calls this to reconstruct the session key account from the approval.
+ * This requires BOTH the approval AND the session key signer.
+ *
+ * @param approval - Approval string from owner
+ * @param sessionKeySigner - Session key signer (created from private key)
+ * @param chain - Chain to use
+ * @param entryPointVersion - EntryPoint version
+ * @returns Deserialized session key account
+ *
+ * @example
+ * // Agent deserializes with private key
+ * const sessionKey = await recreateSessionKey(storedPrivateKey);
+ * const account = await deserializeSessionKey({
+ *     approval,
+ *     sessionKeySigner: sessionKey.signer,
+ *     chain: sepolia
+ * });
+ */
+async function deserializeSessionKey(options) {
+    const { approval, sessionKeySigner, chain, entryPointVersion = '0.7' } = options;
+    const publicClient = (0, viem_1.createPublicClient)({
+        chain,
+        transport: (0, viem_1.http)()
+    });
+    const entryPoint = (0, constants_1.getEntryPoint)(entryPointVersion);
+    // Deserialize WITH the session key signer
+    // This is the 5-parameter version (not 4!)
+    // TODO: deserializePermissionAccount not available in @zerodev/sdk yet
+    // const sessionKeyAccount = await deserializePermissionAccount(
+    //     publicClient,
+    //     entryPoint,
+    //     KERNEL_V3_3,
+    //     approval,
+    //     sessionKeySigner  // ← Must pass the signer!
+    // );
+    // Placeholder until SDK is available
+    const sessionKeyAccount = null;
+    return sessionKeyAccount;
+}
+/**
+ * Create kernel client for session key
+ *
+ * Creates a client for sending transactions with the session key.
+ *
+ * @param account - Deserialized session key account
+ * @param chain - Chain to use
+ * @param bundlerUrl - Bundler RPC URL
+ * @param paymasterUrl - Optional paymaster URL for gas sponsorship
+ * @returns Kernel account client
+ *
+ * @example
+ * const client = createSessionKeyClient({
+ *     account: sessionKeyAccount,
+ *     chain: sepolia,
+ *     bundlerUrl: 'https://api.pimlico.io/...'
+ * });
+ */
+function createSessionKeyClient(options) {
+    const { account, chain, bundlerUrl, paymasterUrl } = options;
+    const clientOptions = {
+        account,
+        chain,
+        bundlerTransport: (0, viem_1.http)(bundlerUrl)
+    };
+    // Add paymaster if provided
+    if (paymasterUrl) {
+        // Note: Paymaster client creation would go here
+        // For now, just the basic client
+    }
+    const kernelClient = (0, sdk_1.createKernelAccountClient)(clientOptions);
+    return kernelClient;
+}
+// ============================================
+// Convenience Functions
+// ============================================
+/**
+ * Create USDC transfer permission rule
+ *
+ * Helper to create a permission rule for USDC transfers with a maximum amount.
+ *
+ * @param usdcAddress - USDC contract address
+ * @param maxAmount - Maximum USDC amount (in USDC units, e.g., "10" for 10 USDC)
+ * @returns Permission rule
+ *
+ * @example
+ * const rule = createUSDCTransferPermission(
+ *     '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+ *     '10' // Max 10 USDC
+ * );
+ */
+function createUSDCTransferPermission(usdcAddress, maxAmount) {
+    return {
+        target: usdcAddress,
+        abi: (0, viem_1.parseAbi)(['function transfer(address to, uint256 amount) returns (bool)']),
+        functionName: 'transfer',
+        args: [
+            null, // Any recipient
+            {
+                condition: 3, // LESS_THAN_OR_EQUAL
+                value: (0, viem_1.parseUnits)(maxAmount, 6) // USDC has 6 decimals
+            }
+        ]
+    };
+}
+/**
+ * Create ETH transfer permission rule
+ *
+ * Helper to create a permission rule for ETH transfers with a maximum value.
+ *
+ * @param maxValue - Maximum ETH value (in ether units, e.g., "0.1" for 0.1 ETH)
+ * @returns Permission rule
+ *
+ * @example
+ * const rule = createETHTransferPermission('0.1'); // Max 0.1 ETH
+ */
+function createETHTransferPermission(maxValue) {
+    return {
+        target: '0x0000000000000000000000000000000000000000', // Native token
+        abi: [],
+        functionName: '',
+        args: [
+            {
+                condition: 3, // LESS_THAN_OR_EQUAL
+                value: (0, viem_1.parseEther)(maxValue)
+            }
+        ]
+    };
+}
+//# sourceMappingURL=session-keys.js.map

package/dist/evm/aa-service/lib/session-keys.js.map

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

package/dist/evm/aa-service/lib/type.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Smart Wallet Types
+ *
+ * Type definitions for EVM smart wallet functionality using Account Abstraction (EIP-4337)
+ * and EIP-7702 delegation features.
+ */
+import { Chain, Hex, SignAuthorizationReturnType } from "viem";
+import { PrivateKeyAccount } from "viem/accounts";
+import { ModularSigner } from "@zerodev/permissions";
+import { BundlerManager } from "../services/bundler";
+import { ModuleType } from "./kernel-modules";
+import { SessionKeyPermissionRule } from "./session-keys";
+export type KernelVersion = '0.3.3';
+export type EntryPointVersion = '0.6' | '0.7';
+/**
+ * Single call/operation in a transaction
+ */
+export interface Call {
+    /** Target contract address */
+    to: Hex;
+    /** ETH value to send (optional, defaults to 0) */
+    value?: bigint;
+    /** Calldata (optional, defaults to '0x') */
+    data?: Hex;
+}
+/**
+ * Batch transaction configuration
+ */
+export interface BatchTransactionConfig {
+    kernelAccount: KernelAccountInstance;
+    bundlerManager: BundlerManager;
+    authorization?: SignAuthorizationReturnType;
+    calls: Call[];
+}
+/**
+ * Single transaction configuration (convenience)
+ */
+export interface SingleTransactionConfig {
+    kernelAccount: KernelAccountInstance;
+    bundlerManager: BundlerManager;
+    authorization?: SignAuthorizationReturnType;
+    to: Hex;
+    value?: bigint;
+    data?: Hex;
+}
+export interface KernelAccountConfig {
+    chain: Chain;
+    owner: PrivateKeyAccount;
+    bundlerManager: BundlerManager;
+    entryPointVersion?: EntryPointVersion;
+    kernelVersion?: KernelVersion;
+}
+export interface KernelAccountInstance {
+    account: any;
+    address: string;
+    owner: PrivateKeyAccount;
+    chain: Chain;
+    entryPoint: {
+        address: Hex;
+        version: EntryPointVersion;
+    };
+}
+export interface SmartWalletOptions {
+    /** Bundler URL for submitting UserOperations */
+    bundlerUrl?: string;
+    /** Paymaster URL for gas sponsorship (optional) */
+    paymasterUrl?: string;
+    /** EntryPoint version to use (default: '0.7') */
+    entryPointVersion?: EntryPointVersion;
+    /** Auto-initialize on extend (default: true) */
+    autoInitialize?: boolean;
+}
+export interface SmartWalletTransactionResult {
+    /** Whether the transaction succeeded */
+    success: boolean;
+    /** UserOperation hash */
+    userOpHash: Hex;
+    /** Transaction hash (after bundler execution) */
+    transactionHash?: string;
+    /** Error message if failed */
+    error?: string;
+}
+export interface GasEstimate {
+    /** Estimated gas for UserOperation */
+    callGasLimit: bigint;
+    /** Estimated verification gas */
+    verificationGasLimit: bigint;
+    /** Estimated pre-verification gas */
+    preVerificationGas: bigint;
+    /** Total estimated gas */
+    total: bigint;
+}
+export interface SessionKeyApprovalOptions {
+    /** Session key address to approve */
+    sessionKeyAddress: Hex;
+    /** Permission rules for the session key */
+    permissions?: SessionKeyPermissionRule[];
+    /** Use unrestricted sudo policy (not recommended for production) */
+    useSudoPolicy?: boolean;
+}
+export interface SessionKeyUsageOptions {
+    /** Serialized approval from owner */
+    approval: string;
+    /** Session key signer */
+    sessionKeySigner: ModularSigner;
+}
+export interface ModuleInstallOptions {
+    /** Type of module to install */
+    moduleType: ModuleType;
+    /** Module contract address */
+    moduleAddress: Hex;
+    /** Initialization data for the module */
+    initData?: Hex;
+}
+export interface ModuleUninstallOptions {
+    /** Type of module to uninstall */
+    moduleType: ModuleType;
+    /** Module contract address */
+    moduleAddress: Hex;
+    /** De-initialization data for the module */
+    deInitData?: Hex;
+}
+export interface MultiSigConfig {
+    /** List of owner addresses */
+    owners: Hex[];
+    /** Number of signatures required (threshold) */
+    threshold: number;
+}
+export interface RecoveryConfig {
+    /** Guardian addresses for account recovery */
+    guardians: Hex[];
+    /** Recovery delay in seconds */
+    recoveryDelay?: number;
+}
+export interface PaymasterConfig {
+    /** Paymaster URL for sponsored transactions */
+    paymasterUrl: string;
+    /** Paymaster context (optional, provider-specific) */
+    context?: any;
+}
+export interface SmartAccountInfo {
+    /** Smart account address */
+    address: Hex;
+    /** Owner EOA address */
+    ownerAddress: Hex;
+    /** Chain information */
+    chain: Chain;
+    /** EntryPoint version */
+    entryPointVersion: EntryPointVersion;
+    /** Whether account is delegated (EIP-7702) */
+    isDelegated: boolean;
+    /** Current balance in wei */
+    balance: bigint;
+}
+export declare class SmartWalletError extends Error {
+    code: string;
+    constructor(message: string, code?: string);
+}
+export declare class SessionKeyError extends SmartWalletError {
+    constructor(message: string);
+}
+export declare class ModuleError extends SmartWalletError {
+    constructor(message: string);
+}
+export declare class TransactionError extends SmartWalletError {
+    constructor(message: string);
+}

package/dist/evm/aa-service/lib/type.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Smart Wallet Types
+ *
+ * Type definitions for EVM smart wallet functionality using Account Abstraction (EIP-4337)
+ * and EIP-7702 delegation features.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionError = exports.ModuleError = exports.SessionKeyError = exports.SmartWalletError = void 0;
+// ============================================
+// Error Types
+// ============================================
+class SmartWalletError extends Error {
+    code;
+    constructor(message, code = 'SMART_WALLET_ERROR') {
+        super(message);
+        this.name = 'SmartWalletError';
+        this.code = code;
+    }
+}
+exports.SmartWalletError = SmartWalletError;
+class SessionKeyError extends SmartWalletError {
+    constructor(message) {
+        super(message, 'SESSION_KEY_ERROR');
+        this.name = 'SessionKeyError';
+    }
+}
+exports.SessionKeyError = SessionKeyError;
+class ModuleError extends SmartWalletError {
+    constructor(message) {
+        super(message, 'MODULE_ERROR');
+        this.name = 'ModuleError';
+    }
+}
+exports.ModuleError = ModuleError;
+class TransactionError extends SmartWalletError {
+    constructor(message) {
+        super(message, 'TRANSACTION_ERROR');
+        this.name = 'TransactionError';
+    }
+}
+exports.TransactionError = TransactionError;
+//# sourceMappingURL=type.js.map

package/dist/evm/aa-service/lib/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../../utils/evm/aa-service/lib/type.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAqMH,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C,MAAa,gBAAiB,SAAQ,KAAK;IACvC,IAAI,CAAS;IAEb,YAAY,OAAe,EAAE,OAAe,oBAAoB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AARD,4CAQC;AAED,MAAa,eAAgB,SAAQ,gBAAgB;IACjD,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ;AALD,0CAKC;AAED,MAAa,WAAY,SAAQ,gBAAgB;IAC7C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;CACJ;AALD,kCAKC;AAED,MAAa,gBAAiB,SAAQ,gBAAgB;IAClD,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ;AALD,4CAKC"}