@aspect-wallet/sdk 0.1.0

package/dist/userop/encoding.js

@@ -0,0 +1,99 @@
+/**
+ * UserOperation callData and initCode encoding.
+ * Corresponds to SPEC-013 Sections 4-5, SPEC-002.
+ */
+import { encodeFunctionData, concat, } from 'viem';
+/** Smart Account execute function ABI */
+const EXECUTE_ABI = [
+    {
+        name: 'execute',
+        type: 'function',
+        inputs: [
+            { name: 'target', type: 'address' },
+            { name: 'value', type: 'uint256' },
+            { name: 'data', type: 'bytes' },
+        ],
+        outputs: [],
+        stateMutability: 'payable',
+    },
+];
+/** Smart Account executeBatch function ABI */
+const EXECUTE_BATCH_ABI = [
+    {
+        name: 'executeBatch',
+        type: 'function',
+        inputs: [
+            {
+                name: 'calls',
+                type: 'tuple[]',
+                components: [
+                    { name: 'target', type: 'address' },
+                    { name: 'value', type: 'uint256' },
+                    { name: 'data', type: 'bytes' },
+                ],
+            },
+        ],
+        outputs: [],
+        stateMutability: 'payable',
+    },
+];
+/** Factory createAccount function ABI */
+const CREATE_ACCOUNT_ABI = [
+    {
+        name: 'createAccount',
+        type: 'function',
+        inputs: [
+            { name: 'owner', type: 'address' },
+            { name: 'salt', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'address' }],
+        stateMutability: 'nonpayable',
+    },
+];
+/**
+ * Encode callData for a single execute call on the smart account.
+ */
+export function encodeCallData(params) {
+    return encodeFunctionData({
+        abi: EXECUTE_ABI,
+        functionName: 'execute',
+        args: [params.target, params.value, params.data],
+    });
+}
+/**
+ * Encode callData for a batch execute call on the smart account.
+ */
+export function encodeBatchCallData(calls) {
+    return encodeFunctionData({
+        abi: EXECUTE_BATCH_ABI,
+        functionName: 'executeBatch',
+        args: [calls],
+    });
+}
+/**
+ * Encode initCode for first-time account deployment.
+ * Format: factory address (20 bytes) + factory.createAccount(owner, salt) calldata
+ *
+ * @param factory - The factory contract address
+ * @param owner - The initial owner/signer address
+ * @param salt - Deployment salt for CREATE2
+ */
+export function encodeInitCode(params) {
+    const createAccountData = encodeFunctionData({
+        abi: CREATE_ACCOUNT_ABI,
+        functionName: 'createAccount',
+        args: [params.owner, params.salt],
+    });
+    return concat([params.factory, createAccountData]);
+}
+/**
+ * Encode arbitrary function call data using an ABI.
+ */
+export function encodeCall(params) {
+    return encodeFunctionData({
+        abi: params.abi,
+        functionName: params.functionName,
+        args: params.args ?? [],
+    });
+}
+//# sourceMappingURL=encoding.js.map

package/dist/userop/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../src/userop/encoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAElB,MAAM,GAEP,MAAM,MAAM,CAAC;AAGd,yCAAyC;AACzC,MAAM,WAAW,GAAG;IAClB;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;SAChC;QACD,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,SAAS;KAC3B;CACO,CAAC;AAEX,8CAA8C;AAC9C,MAAM,iBAAiB,GAAG;IACxB;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;oBACnC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;oBAClC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;iBAChC;aACF;SACF;QACD,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,SAAS;KAC3B;CACO,CAAC;AAEX,yCAAyC;AACzC,MAAM,kBAAkB,GAAG;IACzB;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;SAClC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACxC,eAAe,EAAE,YAAY;KAC9B;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAI9B;IACC,OAAO,kBAAkB,CAAC;QACxB,GAAG,EAAE,WAAW;QAChB,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;KACjD,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA2D;IAE3D,OAAO,kBAAkB,CAAC;QACxB,GAAG,EAAE,iBAAiB;QACtB,YAAY,EAAE,cAAc;QAC5B,IAAI,EAAE,CAAC,KAAK,CAAC;KACd,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAI9B;IACC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;QAC3C,GAAG,EAAE,kBAAkB;QACvB,YAAY,EAAE,eAAe;QAC7B,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;KAClC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAI1B;IACC,OAAO,kBAAkB,CAAC;QACxB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;KACxB,CAAC,CAAC;AACL,CAAC"}

package/dist/userop/gas.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Gas estimation with safety margins.
+ * Corresponds to SPEC-013 Section 5.2, CLAUDE.md critical constants.
+ *
+ * Safety margins: 130% on gas limits, 120% on fee estimates.
+ */
+import type { UserOperation, Hex } from '../types.js';
+import { BundlerClient } from '../transport/bundler.js';
+/**
+ * Apply the 130% gas safety margin to a value.
+ */
+export declare function applyGasSafetyMargin(value: bigint): bigint;
+/**
+ * Apply the 120% fee safety margin to a value.
+ */
+export declare function applyFeeSafetyMargin(value: bigint): bigint;
+/**
+ * Estimate gas for a UserOperation using the bundler,
+ * then apply safety margins.
+ *
+ * @param bundler - Bundler RPC client
+ * @param userOp - The UserOperation to estimate (can have zero gas fields)
+ * @returns UserOperation with gas fields populated and safety margins applied
+ */
+export declare function estimateGas(bundler: BundlerClient, userOp: UserOperation): Promise<UserOperation>;
+/**
+ * Estimate current gas fees (maxFeePerGas, maxPriorityFeePerGas)
+ * using eth_maxPriorityFeePerGas and eth_gasPrice.
+ * Applies 120% fee safety margin.
+ */
+export declare function estimateFees(rpcCall: (method: string, params: unknown[]) => Promise<Hex>): Promise<{
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}>;
+//# sourceMappingURL=gas.d.ts.map

package/dist/userop/gas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../../src/userop/gas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQxD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CASxB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAC3D,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,CAAC,CAajE"}

package/dist/userop/gas.js

@@ -0,0 +1,53 @@
+/**
+ * Gas estimation with safety margins.
+ * Corresponds to SPEC-013 Section 5.2, CLAUDE.md critical constants.
+ *
+ * Safety margins: 130% on gas limits, 120% on fee estimates.
+ */
+/**
+ * Apply the 130% gas safety margin to a value.
+ */
+export function applyGasSafetyMargin(value) {
+    return (value * 130n) / 100n;
+}
+/**
+ * Apply the 120% fee safety margin to a value.
+ */
+export function applyFeeSafetyMargin(value) {
+    return (value * 120n) / 100n;
+}
+/**
+ * Estimate gas for a UserOperation using the bundler,
+ * then apply safety margins.
+ *
+ * @param bundler - Bundler RPC client
+ * @param userOp - The UserOperation to estimate (can have zero gas fields)
+ * @returns UserOperation with gas fields populated and safety margins applied
+ */
+export async function estimateGas(bundler, userOp) {
+    const estimate = await bundler.estimateUserOperationGas(userOp);
+    return {
+        ...userOp,
+        preVerificationGas: applyGasSafetyMargin(BigInt(estimate.preVerificationGas)),
+        verificationGasLimit: applyGasSafetyMargin(BigInt(estimate.verificationGasLimit)),
+        callGasLimit: applyGasSafetyMargin(BigInt(estimate.callGasLimit)),
+    };
+}
+/**
+ * Estimate current gas fees (maxFeePerGas, maxPriorityFeePerGas)
+ * using eth_maxPriorityFeePerGas and eth_gasPrice.
+ * Applies 120% fee safety margin.
+ */
+export async function estimateFees(rpcCall) {
+    const [gasPriceHex, priorityFeeHex] = await Promise.all([
+        rpcCall('eth_gasPrice', []),
+        rpcCall('eth_maxPriorityFeePerGas', []).catch(() => '0x0'),
+    ]);
+    const gasPrice = BigInt(gasPriceHex);
+    const priorityFee = BigInt(priorityFeeHex);
+    return {
+        maxFeePerGas: applyFeeSafetyMargin(gasPrice),
+        maxPriorityFeePerGas: applyFeeSafetyMargin(priorityFee),
+    };
+}
+//# sourceMappingURL=gas.js.map

package/dist/userop/gas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas.js","sourceRoot":"","sources":["../../src/userop/gas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAsB,EACtB,MAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAEhE,OAAO;QACL,GAAG,MAAM;QACT,kBAAkB,EAAE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAC7E,oBAAoB,EAAE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QACjF,YAAY,EAAE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;KAClE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA4D;IAE5D,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtD,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC3B,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAY,CAAC;KAClE,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IAE3C,OAAO;QACL,YAAY,EAAE,oBAAoB,CAAC,QAAQ,CAAC;QAC5C,oBAAoB,EAAE,oBAAoB,CAAC,WAAW,CAAC;KACxD,CAAC;AACJ,CAAC"}

package/dist/userop/hash.d.ts

@@ -0,0 +1,34 @@
+/**
+ * UserOperation hash computation.
+ * CRITICAL: Must match EntryPoint.getUserOpHash() exactly.
+ *
+ * Corresponds to SPEC-013 Section 5.3, SPEC-002, SPEC-004.
+ *
+ * Algorithm:
+ * 1. Pack all fields except signature
+ * 2. Hash variable-length fields individually: keccak256(initCode), keccak256(callData), keccak256(paymasterAndData)
+ * 3. keccak256(packed) -> innerHash
+ * 4. keccak256(abi.encode(innerHash, entryPoint, chainId)) -> userOpHash
+ */
+import type { Address, Hex, UserOperation } from '../types.js';
+/**
+ * Pack a UserOperation for hashing (step 1-2).
+ * Variable-length fields (initCode, callData, paymasterAndData) are individually hashed.
+ * All other fields are ABI-encoded directly.
+ */
+export declare function packUserOp(userOp: UserOperation): Hex;
+/**
+ * Compute the UserOperation hash exactly as EntryPoint.getUserOpHash() does.
+ *
+ * @param userOp - The UserOperation to hash (signature field is ignored)
+ * @param entryPoint - The EntryPoint contract address
+ * @param chainId - The numeric chain ID
+ * @returns The 32-byte hash that signers must sign
+ *
+ * @example
+ * ```ts
+ * const hash = getUserOpHash(userOp, ENTRYPOINT_V06, 42161n);
+ * ```
+ */
+export declare function getUserOpHash(userOp: UserOperation, entryPoint: Address, chainId: bigint): Hex;
+//# sourceMappingURL=hash.d.ts.map

package/dist/userop/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/userop/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,GAAG,CAkBrD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,GACd,GAAG,CAcL"}

package/dist/userop/hash.js

@@ -0,0 +1,55 @@
+/**
+ * UserOperation hash computation.
+ * CRITICAL: Must match EntryPoint.getUserOpHash() exactly.
+ *
+ * Corresponds to SPEC-013 Section 5.3, SPEC-002, SPEC-004.
+ *
+ * Algorithm:
+ * 1. Pack all fields except signature
+ * 2. Hash variable-length fields individually: keccak256(initCode), keccak256(callData), keccak256(paymasterAndData)
+ * 3. keccak256(packed) -> innerHash
+ * 4. keccak256(abi.encode(innerHash, entryPoint, chainId)) -> userOpHash
+ */
+import { keccak256, encodeAbiParameters, parseAbiParameters, } from 'viem';
+/**
+ * Pack a UserOperation for hashing (step 1-2).
+ * Variable-length fields (initCode, callData, paymasterAndData) are individually hashed.
+ * All other fields are ABI-encoded directly.
+ */
+export function packUserOp(userOp) {
+    return encodeAbiParameters(parseAbiParameters('address, uint256, bytes32, bytes32, uint256, uint256, uint256, uint256, uint256, bytes32'), [
+        userOp.sender,
+        userOp.nonce,
+        keccak256(userOp.initCode), // hash variable-length initCode
+        keccak256(userOp.callData), // hash variable-length callData
+        userOp.callGasLimit,
+        userOp.verificationGasLimit,
+        userOp.preVerificationGas,
+        userOp.maxFeePerGas,
+        userOp.maxPriorityFeePerGas,
+        keccak256(userOp.paymasterAndData), // hash variable-length paymasterAndData
+    ]);
+}
+/**
+ * Compute the UserOperation hash exactly as EntryPoint.getUserOpHash() does.
+ *
+ * @param userOp - The UserOperation to hash (signature field is ignored)
+ * @param entryPoint - The EntryPoint contract address
+ * @param chainId - The numeric chain ID
+ * @returns The 32-byte hash that signers must sign
+ *
+ * @example
+ * ```ts
+ * const hash = getUserOpHash(userOp, ENTRYPOINT_V06, 42161n);
+ * ```
+ */
+export function getUserOpHash(userOp, entryPoint, chainId) {
+    // Step 1-2: Pack with individually-hashed variable-length fields
+    const packed = packUserOp(userOp);
+    // Step 3: Hash the packed data
+    const innerHash = keccak256(packed);
+    // Step 4: Encode with entryPoint and chainId, then hash again
+    const encoded = encodeAbiParameters(parseAbiParameters('bytes32, address, uint256'), [innerHash, entryPoint, chainId]);
+    return keccak256(encoded);
+}
+//# sourceMappingURL=hash.js.map

package/dist/userop/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/userop/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,MAAM,CAAC;AAGd;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,OAAO,mBAAmB,CACxB,kBAAkB,CAChB,0FAA0F,CAC3F,EACD;QACE,MAAM,CAAC,MAAM;QACb,MAAM,CAAC,KAAK;QACZ,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAY,gCAAgC;QACtE,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAa,gCAAgC;QACvE,MAAM,CAAC,YAAY;QACnB,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,kBAAkB;QACzB,MAAM,CAAC,YAAY;QACnB,MAAM,CAAC,oBAAoB;QAC3B,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAK,wCAAwC;KAChF,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAqB,EACrB,UAAmB,EACnB,OAAe;IAEf,iEAAiE;IACjE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAElC,+BAA+B;IAC/B,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAEpC,8DAA8D;IAC9D,MAAM,OAAO,GAAG,mBAAmB,CACjC,kBAAkB,CAAC,2BAA2B,CAAC,EAC/C,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CACjC,CAAC;IAEF,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/dist/userop/nonce.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 2D nonce management for parallel transaction streams.
+ * Corresponds to SPEC-013 Section 5.5.
+ *
+ * Nonce encoding: uint256 nonce = (uint256(key) << 64) | sequence
+ * - key=0: user transactions (default)
+ * - key=1+: session keys and parallel streams
+ * Each key has an independent sequential counter.
+ */
+import type { Address, Hex } from '../types.js';
+/**
+ * Manages 2D nonces for parallel UserOp streams.
+ * Each nonce key has an independent sequence counter, allowing
+ * multiple parallel transaction streams without blocking.
+ */
+export declare class NonceManager {
+    private readonly entryPoint;
+    private readonly rpcCall;
+    private cache;
+    constructor(entryPoint: Address, rpcCall: (method: string, params: unknown[]) => Promise<Hex>);
+    /**
+     * Get the next nonce for a wallet address and nonce key.
+     *
+     * @param sender - The smart wallet address
+     * @param key - The nonce key (0 = default user txs, 1+ = session keys)
+     * @returns The full 256-bit nonce (key << 64 | sequence)
+     */
+    get(sender: Address, key?: bigint): Promise<bigint>;
+    /**
+     * Encode a 2D nonce from key and sequence.
+     * nonce = (key << 64) | sequence
+     */
+    static encode(key: bigint, sequence: bigint): bigint;
+    /**
+     * Decode a 2D nonce into key and sequence.
+     */
+    static decode(nonce: bigint): {
+        key: bigint;
+        sequence: bigint;
+    };
+}
+/**
+ * Encode a 2D nonce: (key << 64) | sequence
+ */
+export declare function encodeNonce(key: bigint, sequence: bigint): bigint;
+/**
+ * Decode a 2D nonce into key and sequence components.
+ */
+export declare function decodeNonce(nonce: bigint): {
+    key: bigint;
+    sequence: bigint;
+};
+//# sourceMappingURL=nonce.d.ts.map

package/dist/userop/nonce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce.d.ts","sourceRoot":"","sources":["../../src/userop/nonce.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGhD;;;;GAIG;AACH,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,KAAK,CAA6B;gBAGvB,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC;IAG/E;;;;;;OAMG;IACG,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAa7D;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIpD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;CAGhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAK5E"}

package/dist/userop/nonce.js

@@ -0,0 +1,79 @@
+/**
+ * 2D nonce management for parallel transaction streams.
+ * Corresponds to SPEC-013 Section 5.5.
+ *
+ * Nonce encoding: uint256 nonce = (uint256(key) << 64) | sequence
+ * - key=0: user transactions (default)
+ * - key=1+: session keys and parallel streams
+ * Each key has an independent sequential counter.
+ */
+/**
+ * Manages 2D nonces for parallel UserOp streams.
+ * Each nonce key has an independent sequence counter, allowing
+ * multiple parallel transaction streams without blocking.
+ */
+export class NonceManager {
+    entryPoint;
+    rpcCall;
+    cache = new Map();
+    constructor(entryPoint, rpcCall) {
+        this.entryPoint = entryPoint;
+        this.rpcCall = rpcCall;
+    }
+    /**
+     * Get the next nonce for a wallet address and nonce key.
+     *
+     * @param sender - The smart wallet address
+     * @param key - The nonce key (0 = default user txs, 1+ = session keys)
+     * @returns The full 256-bit nonce (key << 64 | sequence)
+     */
+    async get(sender, key = 0n) {
+        const nonceHex = await this.rpcCall('eth_call', [
+            {
+                to: this.entryPoint,
+                data: encodeGetNonce(sender, key),
+            },
+            'latest',
+        ]);
+        const sequence = BigInt(nonceHex);
+        return encodeNonce(key, sequence);
+    }
+    /**
+     * Encode a 2D nonce from key and sequence.
+     * nonce = (key << 64) | sequence
+     */
+    static encode(key, sequence) {
+        return encodeNonce(key, sequence);
+    }
+    /**
+     * Decode a 2D nonce into key and sequence.
+     */
+    static decode(nonce) {
+        return decodeNonce(nonce);
+    }
+}
+/**
+ * Encode a 2D nonce: (key << 64) | sequence
+ */
+export function encodeNonce(key, sequence) {
+    return (key << 64n) | (sequence & 0xffffffffffffffffn);
+}
+/**
+ * Decode a 2D nonce into key and sequence components.
+ */
+export function decodeNonce(nonce) {
+    return {
+        key: nonce >> 64n,
+        sequence: nonce & 0xffffffffffffffffn,
+    };
+}
+/**
+ * Encode the EntryPoint.getNonce(sender, key) call.
+ * Selector: 0x35567e1a
+ */
+function encodeGetNonce(sender, key) {
+    const senderPadded = sender.slice(2).padStart(64, '0');
+    const keyPadded = key.toString(16).padStart(64, '0');
+    return `0x35567e1a${senderPadded}${keyPadded}`;
+}
+//# sourceMappingURL=nonce.js.map

package/dist/userop/nonce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce.js","sourceRoot":"","sources":["../../src/userop/nonce.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAIJ;IACA;IAJX,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,YACmB,UAAmB,EACnB,OAA4D;QAD5D,eAAU,GAAV,UAAU,CAAS;QACnB,YAAO,GAAP,OAAO,CAAqD;IAC5E,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,MAAe,EAAE,MAAc,EAAE;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;YAC9C;gBACE,EAAE,EAAE,IAAI,CAAC,UAAU;gBACnB,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC;aAClC;YACD,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,GAAW,EAAE,QAAgB;QACzC,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAa;QACzB,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,QAAgB;IACvD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,GAAG,mBAAmB,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO;QACL,GAAG,EAAE,KAAK,IAAI,GAAG;QACjB,QAAQ,EAAE,KAAK,GAAG,mBAAmB;KACtC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,MAAe,EAAE,GAAW;IAClD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACrD,OAAO,aAAa,YAAY,GAAG,SAAS,EAAE,CAAC;AACjD,CAAC"}

package/dist/wallet/factory.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Wallet factory -- address computation and account deployment.
+ * Corresponds to SPEC-013 Section 4, SPEC-001.
+ */
+import type { Address, WalletInfo, ChainId } from '../types.js';
+import { ApiClient } from '../transport/api.js';
+/**
+ * Computes the counterfactual wallet address using CREATE2 deterministic deployment.
+ *
+ * address = keccak256(0xff || factory || combinedSalt || keccak256(initCode))[12:]
+ * combinedSalt = keccak256(abi.encode(owner, salt))
+ */
+export declare function computeWalletAddress(factory: Address, implementation: Address, owner: Address, salt: bigint): Address;
+/**
+ * Wallet factory module.
+ * Handles counterfactual address generation and account state queries.
+ */
+export declare class WalletFactory {
+    private readonly api;
+    private readonly chain;
+    constructor(api: ApiClient, chain: ChainId);
+    /**
+     * Get or compute wallet address for an owner.
+     * If the wallet exists on the platform, returns full info including deployment status.
+     */
+    getAddress(params: {
+        owner: Address;
+        salt?: bigint;
+    }): Promise<WalletInfo>;
+    /**
+     * Get the on-chain state of a deployed wallet.
+     */
+    getState(address: Address): Promise<{
+        address: Address;
+        deployed: boolean;
+        owner: Address;
+        balance: string;
+        entryPointDeposit: string;
+        nonce: {
+            key: string;
+            sequence: string;
+        };
+        modules: Array<{
+            moduleId: number;
+            type: string;
+            signer: Address;
+            installedAt: number;
+            expiresAt?: number;
+        }>;
+        frozen: boolean;
+    }>;
+    /**
+     * List installed validation modules on a wallet.
+     */
+    getModules(address: Address): Promise<{
+        moduleId: number;
+        type: string;
+        signer: Address;
+        installedAt: number;
+        expiresAt?: number;
+    }[]>;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/wallet/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/wallet/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,OAAO,EAAO,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAqBT;AAED;;;GAGG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,OAAO;IAGjC;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAShF;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO;iBAElB,OAAO;kBACN,OAAO;eACV,OAAO;iBACL,MAAM;2BACI,MAAM;eAClB;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE;iBAC/B,KAAK,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,OAAO,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;gBACM,OAAO;;IAInB;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO;kBAGjB,MAAM;cACV,MAAM;gBACJ,OAAO;qBACF,MAAM;oBACP,MAAM;;CAIzB"}

package/dist/wallet/factory.js

@@ -0,0 +1,63 @@
+/**
+ * Wallet factory -- address computation and account deployment.
+ * Corresponds to SPEC-013 Section 4, SPEC-001.
+ */
+import { keccak256, encodePacked, encodeAbiParameters, getContractAddress, parseAbiParameters, } from 'viem';
+/**
+ * Computes the counterfactual wallet address using CREATE2 deterministic deployment.
+ *
+ * address = keccak256(0xff || factory || combinedSalt || keccak256(initCode))[12:]
+ * combinedSalt = keccak256(abi.encode(owner, salt))
+ */
+export function computeWalletAddress(factory, implementation, owner, salt) {
+    const combinedSalt = keccak256(encodeAbiParameters(parseAbiParameters('address, uint256'), [owner, salt]));
+    // Minimal proxy initCode (ERC-1167 clone pointing to implementation)
+    const proxyBytecode = encodePacked(['bytes', 'bytes20', 'bytes'], [
+        '0x3d602d80600a3d3981f3363d3d373d3d3d363d73',
+        implementation,
+        '0x5af43d82803e903d91602b57fd5bf3',
+    ]);
+    return getContractAddress({
+        bytecode: proxyBytecode,
+        from: factory,
+        opcode: 'CREATE2',
+        salt: combinedSalt,
+    });
+}
+/**
+ * Wallet factory module.
+ * Handles counterfactual address generation and account state queries.
+ */
+export class WalletFactory {
+    api;
+    chain;
+    constructor(api, chain) {
+        this.api = api;
+        this.chain = chain;
+    }
+    /**
+     * Get or compute wallet address for an owner.
+     * If the wallet exists on the platform, returns full info including deployment status.
+     */
+    async getAddress(params) {
+        const result = await this.api.post('/wallets', {
+            owner: params.owner,
+            salt: (params.salt ?? 0n).toString(),
+            chain: this.chain,
+        });
+        return result;
+    }
+    /**
+     * Get the on-chain state of a deployed wallet.
+     */
+    async getState(address) {
+        return this.api.get(`/wallets/${address}`);
+    }
+    /**
+     * List installed validation modules on a wallet.
+     */
+    async getModules(address) {
+        return this.api.get(`/wallets/${address}/modules`);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/wallet/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/wallet/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GAGnB,MAAM,MAAM,CAAC;AAId;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,cAAuB,EACvB,KAAc,EACd,IAAY;IAEZ,MAAM,YAAY,GAAG,SAAS,CAC5B,mBAAmB,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAC3E,CAAC;IAEF,qEAAqE;IACrE,MAAM,aAAa,GAAG,YAAY,CAChC,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAC7B;QACE,4CAAuD;QACvD,cAAyB;QACzB,kCAA6C;KAC9C,CACF,CAAC;IAEF,OAAO,kBAAkB,CAAC;QACxB,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,YAAuB;KAC9B,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IAEL;IACA;IAFnB,YACmB,GAAc,EACd,KAAc;QADd,QAAG,GAAH,GAAG,CAAW;QACd,UAAK,GAAL,KAAK,CAAS;IAC9B,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,MAAyC;QACxD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,UAAU,EAAE;YACzD,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAgB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAehB,YAAY,OAAO,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAQjB,YAAY,OAAO,UAAU,CAAC,CAAC;IACnC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@aspect-wallet/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for ERC-4337 Account Abstraction smart wallets. Gasless transactions, social logins, passkeys, session keys, multi-factor auth, and account recovery.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src/ --ext .ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "erc-4337",
+    "account-abstraction",
+    "smart-wallet",
+    "gasless",
+    "paymaster",
+    "bundler",
+    "useroperation",
+    "passkeys",
+    "webauthn",
+    "session-keys",
+    "social-login",
+    "turnkey",
+    "ethereum",
+    "arbitrum",
+    "web3"
+  ],
+  "author": "Future CX Lanka",
+  "homepage": "https://docs.aspectwallet.com",
+  "dependencies": {
+    "viem": "^2.21.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}