@aastar/enduser 0.16.12 → 0.16.16

package/dist/paymaster/src/V4/PaymasterUtils.js

@@ -0,0 +1,141 @@
+import { concat, pad, toHex, keccak256, encodeAbiParameters, toBytes } from 'viem';
+const DEFAULT_VERIFICATION_GAS_V4 = 1500000n; // ~1.5M for safety
+const DEFAULT_POSTOP_GAS_V4 = 300000n; // ~300k for postOp logic
+/**
+ * Constructs the middleware for Paymaster V4.
+ * Returns the `paymasterAndData` hex string.
+ */
+export function getPaymasterV4Middleware(config) {
+    return {
+        sponsorUserOperation: async (args) => {
+            const verGas = config.verificationGasLimit ?? DEFAULT_VERIFICATION_GAS_V4;
+            const postGas = config.postOpGasLimit ?? DEFAULT_POSTOP_GAS_V4;
+            // Layout: [Paymaster(20)] [VerGas(16)] [PostOpGas(16)] [Token(20)]
+            const paymasterAndData = concat([
+                config.paymasterAddress,
+                pad(toHex(verGas), { size: 16 }),
+                pad(toHex(postGas), { size: 16 }),
+                config.gasToken
+            ]);
+            return {
+                paymasterAndData,
+                verificationGasLimit: verGas,
+                preVerificationGas: args.userOperation.preVerificationGas
+            };
+        }
+    };
+}
+/**
+ * Build paymasterAndData for gasless UserOperation.
+ * Layout: [Paymaster(20)] [VerificationGasLimit(16)] [PostOpGasLimit(16)] [Token(20)] [ValidUntil(6)] [ValidAfter(6)]
+ */
+export function buildPaymasterData(paymasterAddress, token, options) {
+    const validityWindow = options?.validityWindow ?? 3600;
+    const verGas = options?.verificationGasLimit ?? 200000n; // Increased for estimation
+    const postGas = options?.postOpGasLimit ?? 100000n;
+    const now = Math.floor(Date.now() / 1000);
+    const validUntil = now + validityWindow;
+    const validAfter = now - 100; // 100 seconds grace period
+    return concat([
+        paymasterAddress,
+        pad(toHex(verGas), { size: 16 }),
+        pad(toHex(postGas), { size: 16 }),
+        token,
+        pad(toHex(validUntil), { size: 6 }),
+        pad(toHex(validAfter), { size: 6 })
+    ]);
+}
+/**
+ * Build paymasterAndData for SuperPaymaster V3.
+ * Layout: [Paymaster(20)] [verGas(16)] [postGas(16)] [operator(20)] [maxRate(32)]
+ * Total: 104 bytes
+ *
+ * IMPORTANT: SuperPaymaster contract generates validUntil internally using:
+ *   validUntil = cachedPrice.updatedAt + priceStalenessThreshold
+ * Do NOT include validUntil/validAfter in paymasterAndData!
+ */
+export function buildSuperPaymasterData(paymasterAddress, operator, options) {
+    const verGas = options?.verificationGasLimit ?? 80000n;
+    const postGas = options?.postOpGasLimit ?? 100000n;
+    const maxRate = options?.maxRate ?? ((1n << 256n) - 1n); // Default: max uint256, no rate limit
+    return concat([
+        paymasterAddress,
+        pad(toHex(verGas), { size: 16 }),
+        pad(toHex(postGas), { size: 16 }),
+        operator,
+        pad(toHex(maxRate), { size: 32 }) // Optional rate commitment (rug pull protection)
+    ]);
+}
+/**
+ * Helper to format UserOp for Alchemy/Standard Bundlers (v0.7 Decomposed)
+ */
+export function formatUserOpV07(userOp) {
+    const result = {
+        sender: userOp.sender,
+        nonce: toHex(userOp.nonce),
+        callData: userOp.callData,
+        preVerificationGas: toHex(userOp.preVerificationGas),
+        signature: userOp.signature
+    };
+    // Only include factory/factoryData if account is NOT deployed (initCode not empty)
+    if (userOp.initCode && userOp.initCode !== '0x' && userOp.initCode.length > 2) {
+        result.initCode = userOp.initCode;
+        if (userOp.initCode.length > 42) {
+            result.factory = userOp.initCode.slice(0, 42);
+            result.factoryData = '0x' + userOp.initCode.slice(42);
+        }
+        else {
+            result.factory = '0x0000000000000000000000000000000000000000';
+            result.factoryData = '0x';
+        }
+    }
+    // If account is deployed, don't include any factory fields at all
+    // Unpack accountGasLimits: [verificationGasLimit(16)][callGasLimit(16)]
+    if (userOp.accountGasLimits && userOp.accountGasLimits !== '0x') {
+        const packed = userOp.accountGasLimits.replace('0x', '').padStart(64, '0');
+        result.verificationGasLimit = '0x' + BigInt('0x' + packed.slice(0, 32)).toString(16);
+        result.callGasLimit = '0x' + BigInt('0x' + packed.slice(32, 64)).toString(16);
+    }
+    // Unpack gasFees: [maxPriorityFee(16)][maxFee(16)]
+    if (userOp.gasFees && userOp.gasFees !== '0x') {
+        const packed = userOp.gasFees.replace('0x', '').padStart(64, '0');
+        result.maxPriorityFeePerGas = '0x' + BigInt('0x' + packed.slice(0, 32)).toString(16);
+        result.maxFeePerGas = '0x' + BigInt('0x' + packed.slice(32, 64)).toString(16);
+    }
+    // Unpack paymasterAndData: [paymaster(20)][verificationGas(16)][postOpGas(16)][paymasterData]
+    if (userOp.paymasterAndData && userOp.paymasterAndData !== '0x') {
+        const packed = userOp.paymasterAndData.replace('0x', '');
+        if (packed.length >= 104) {
+            result.paymaster = '0x' + packed.slice(0, 40);
+            result.paymasterVerificationGasLimit = '0x' + BigInt('0x' + packed.slice(40, 72)).toString(16);
+            result.paymasterPostOpGasLimit = '0x' + BigInt('0x' + packed.slice(72, 104)).toString(16);
+            result.paymasterData = '0x' + packed.slice(104);
+        }
+    }
+    return result;
+}
+export function getUserOpHashV07(userOp, entryPoint, chainId) {
+    const hashedUserOp = keccak256(encodeAbiParameters(['address', 'uint256', 'bytes32', 'bytes32', 'bytes32', 'uint256', 'bytes32', 'bytes32'].map(t => ({ type: t })), [
+        userOp.sender,
+        userOp.nonce,
+        keccak256(toBytes(userOp.initCode)),
+        keccak256(toBytes(userOp.callData)),
+        userOp.accountGasLimits,
+        toHex(userOp.preVerificationGas),
+        userOp.gasFees,
+        keccak256(toBytes(userOp.paymasterAndData))
+    ]));
+    return keccak256(encodeAbiParameters(['bytes32', 'address', 'uint256'].map(t => ({ type: t })), [hashedUserOp, entryPoint, chainId]));
+}
+/**
+ * Tune gas limit using a dynamic nominal ceiling to satisfy Bundler efficiency (0.4)
+ * Target: Actual / Limit >= targetEfficiency
+ */
+export function tuneGasLimit(estimate, nominalActual, targetEfficiency = 0.45) {
+    if (estimate === 0n)
+        return 0n;
+    // targetEfficiency = actual / ceiling => ceiling = actual / targetEfficiency
+    const ceiling = (nominalActual * 100n) / BigInt(Math.floor(targetEfficiency * 100));
+    // Return the more restrictive limit to ensure efficiency ratio is met
+    return estimate < ceiling ? estimate : ceiling;
+}

package/dist/testAccountManager.d.ts

@@ -1,4 +1,5 @@
-import { Address, Hash, PublicClient, WalletClient } from 'viem';
+import { Address, Hash } from 'viem';
+import { type PublicClient, type WalletClient } from '@aastar/core';
 /**
  * PhD Paper Experiment Test Toolkit
  *
@@ -29,9 +30,15 @@ import { Address, Hash, PublicClient, WalletClient } from 'viem';
  * ```
  */
 export declare class TestAccountManager {
+    /** @internal */
     private publicClient;
+    /** @internal */
     private walletClient;
-    constructor(publicClient: PublicClient, walletClient: WalletClient);
+    constructor(
+    /** @internal */
+    publicClient: PublicClient, 
+    /** @internal */
+    walletClient: WalletClient);
     /**
      * Prepare complete test environment for PhD experiments
      *

package/dist/testAccountManager.js

@@ -33,7 +33,11 @@ import { accountFactoryActions, TEST_ACCOUNT_ADDRESSES } from '@aastar/core';
 export class TestAccountManager {
     publicClient;
     walletClient;
-    constructor(publicClient, walletClient) {
+    constructor(
+    /** @internal */
+    publicClient, 
+    /** @internal */
+    walletClient) {
         this.publicClient = publicClient;
         this.walletClient = walletClient;
         if (!walletClient.account) {

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@aastar/enduser",
-  "version": "0.16.12",
+  "version": "0.16.16",
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "description": "Enduser client for AAstar SDK",
   "main": "dist/index.js",
@@ -17,10 +20,11 @@
   "license": "MIT",
   "dependencies": {
     "viem": "2.43.3",
-    "@aastar/core": "0.16.12"
+    "@aastar/core": "0.16.16"
   },
   "devDependencies": {
-    "typescript": "5.7.2"
+    "typescript": "5.7.2",
+    "vitest": "4.0.17"
   },
   "scripts": {
     "build": "tsc",