@aastar/sdk 0.16.21 → 0.16.23

package/README.md

@@ -16,16 +16,16 @@ AAstar SDK 提供了一套完整的工具集用于交互 AAstar 协议。它采
 
 ### Core Modules | 核心模块
 
-- **[`@aastar/community`](./@aastar/community)**: Launch & manage DAOs. (启动和管理 DAO)
-- **[`@aastar/operator`](./@aastar/operator)**: Run Paymasters & earn rewards. (运行 Paymaster 并赚取收益)
-- **[`@aastar/enduser`](./@aastar/enduser)**: Join communities & enjoy gasless txs. (加入社区并享受免 Gas 交易)
-- **[`@aastar/analytics`](./@aastar/analytics)**: Monitor ecosystem data. (监控生态系统数据)
-- **[`@aastar/tokens`](./@aastar/tokens)**: GToken & XPNTs finance tools. (GToken 和 XPNTs 金融工具)
-- **[`@aastar/identity`](./@aastar/identity)**: Reputation & SBT management. (声誉和 SBT 管理)
-- **[`@aastar/account`](./@aastar/account)**: Smart Account (ERC-4337) utilities. (智能账户工具)
-- **[`@aastar/core`](./@aastar/core)**: Shared logic, Roles, and configuration. (共享逻辑、角色和配置)
-- **[`@aastar/paymaster`](./@aastar/paymaster)**: Low-level Paymaster interactions. (低层级 Paymaster 交互)
-- **[`@aastar/dapp`](./@aastar/dapp)**: Pre-built UI components and React hooks. (预建 UI 组件和 React hooks)
+- **[`@aastar/community`](https://docs.aastar.io/api/@aastar/community)**: Launch & manage DAOs. (启动和管理 DAO)
+- **[`@aastar/operator`](https://docs.aastar.io/api/@aastar/operator)**: Run Paymasters & earn rewards. (运行 Paymaster 并赚取收益)
+- **[`@aastar/enduser`](https://docs.aastar.io/api/@aastar/enduser)**: Join communities & enjoy gasless txs. (加入社区并享受免 Gas 交易)
+- **[`@aastar/analytics`](https://docs.aastar.io/api/@aastar/analytics)**: Monitor ecosystem data. (监控生态系统数据)
+- **[`@aastar/tokens`](https://docs.aastar.io/api/@aastar/tokens)**: GToken & XPNTs finance tools. (GToken 和 XPNTs 金融工具)
+- **[`@aastar/identity`](https://docs.aastar.io/api/@aastar/identity)**: Reputation & SBT management. (声誉和 SBT 管理)
+- **[`@aastar/account`](https://docs.aastar.io/api/@aastar/account)**: Smart Account (ERC-4337) utilities. (智能账户工具)
+- **[`@aastar/core`](https://docs.aastar.io/api/@aastar/core)**: Shared logic, Roles, and configuration. (共享逻辑、角色和配置)
+- **[`@aastar/paymaster`](https://docs.aastar.io/api/@aastar/paymaster)**: Low-level Paymaster interactions. (低层级 Paymaster 交互)
+- **[`@aastar/dapp`](https://docs.aastar.io/api/@aastar/dapp)**: Pre-built UI components and React hooks. (预建 UI 组件和 React hooks)
 
 ---
 
@@ -39,6 +39,19 @@ npm install @aastar/sdk viem
 
 ---
 
+## 📚 Documentation | 文档导航
+
+- **Docs Home**: https://docs.aastar.io/
+- **API Reference**: https://docs.aastar.io/api/
+- **Examples**: https://docs.aastar.io/examples/
+- **Deployments**: https://docs.aastar.io/guide/deployments/verify.sepolia.contracts
+- **Configuration Sync**: https://docs.aastar.io/guide/docs/Configuration_Sync
+- **Regression Testing**: https://docs.aastar.io/guide/docs/Regression_Testing_Guide
+- **Gasless Tester Guide**: https://docs.aastar.io/guide/docs/TESTER_GUIDE_GASLESS
+- **Price Keeper Guide**: [docs/guide/keeper.md](../../docs/guide/keeper.md)
+
+---
+
 ## 🚀 Usage | 使用指南
 
 ### 1. Initialize Client | 初始化客户端
@@ -160,14 +173,14 @@ npx tsx packages/analytics/src/gas-analyzer-v4.ts
 - **Profit Tracking (利润追踪)**: Transparent breakdown of Protocol Revenue & Profit
 - **L2 Simulation (L2 模拟)**: Estimate savings for migrating UserOps to Optimism
 
-👉 **[View Full Analytics Documentation | 查看完整分析文档](./packages/analytics/README.md)**
+👉 **[View Full Analytics Documentation | 查看完整分析文档](https://docs.aastar.io/guide/packages/analytics/)**
 
 ---
 
 ## 🤝 Contributing | 贡献
 
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.  
-欢迎贡献！更多详情请参考 [贡献指南](CONTRIBUTING.md)。
+We welcome contributions! Please see our Contributing Guide for details.  
+欢迎贡献！更多详情请参考贡献指南。
 
 ---
 

package/dist/utils/userOp.d.ts

@@ -33,6 +33,17 @@ export declare class UserOperationBuilder {
      * Packs maxPriorityFeePerGas and maxFeePerGas into a bytes32 Hex string.
      */
     static packGasFees(maxPriorityFeePerGas: bigint, maxFeePerGas: bigint): Hex;
+    static estimatePreVerificationGasV07(userOp: {
+        sender: Address;
+        nonce: bigint | Hex | number | string;
+        initCode: Hex;
+        callData: Hex;
+        accountGasLimits: Hex;
+        preVerificationGas: bigint | Hex | number | string;
+        gasFees: Hex;
+        paymasterAndData: Hex;
+        signature: Hex;
+    }): bigint;
     /**
      * Packs Paymaster parameters into the v0.7 paymasterAndData format.
      */

package/dist/utils/userOp.js

@@ -1,4 +1,4 @@
-import { concat, pad } from 'viem';
+import { concat, pad, encodeAbiParameters, parseAbiParameters, toBytes } from 'viem';
 export class UserOperationBuilder {
     /**
      * Packs verificationGasLimit and callGasLimit into a bytes32 Hex string.
@@ -18,6 +18,36 @@ export class UserOperationBuilder {
             pad(`0x${maxFeePerGas.toString(16)}`, { dir: 'left', size: 16 })
         ]);
     }
+    static estimatePreVerificationGasV07(userOp) {
+        const nonce = typeof userOp.nonce === 'bigint'
+            ? userOp.nonce
+            : typeof userOp.nonce === 'number'
+                ? BigInt(userOp.nonce)
+                : BigInt(userOp.nonce);
+        const preVerificationGas = typeof userOp.preVerificationGas === 'bigint'
+            ? userOp.preVerificationGas
+            : typeof userOp.preVerificationGas === 'number'
+                ? BigInt(userOp.preVerificationGas)
+                : BigInt(userOp.preVerificationGas);
+        const encoded = encodeAbiParameters(parseAbiParameters('(address,uint256,bytes,bytes,bytes32,uint256,bytes32,bytes,bytes)'), [
+            [
+                userOp.sender,
+                nonce,
+                userOp.initCode,
+                userOp.callData,
+                userOp.accountGasLimits,
+                preVerificationGas,
+                userOp.gasFees,
+                userOp.paymasterAndData,
+                userOp.signature
+            ]
+        ]);
+        const bytes = toBytes(encoded);
+        let calldataCost = 0n;
+        for (const b of bytes)
+            calldataCost += b === 0 ? 4n : 16n;
+        return calldataCost + 26000n;
+    }
     /**
      * Packs Paymaster parameters into the v0.7 paymasterAndData format.
      */
@@ -127,9 +157,20 @@ export class UserOperationBuilder {
      * @param options.paymasterPostOpGasLimit - Gas limit for paymaster postOp (default: 200000)
      */
     static toAlchemyUserOperation(userOp, options) {
+        const toHexStr = (val) => {
+            if (val === undefined || val === null)
+                return undefined;
+            if (typeof val === 'bigint')
+                return `0x${val.toString(16)}`;
+            if (typeof val === 'number')
+                return `0x${val.toString(16)}`;
+            if (typeof val === 'string' && !val.startsWith('0x'))
+                return `0x${val}`;
+            return val;
+        };
         const result = {
             sender: userOp.sender,
-            nonce: userOp.nonce,
+            nonce: toHexStr(userOp.nonce),
             callData: userOp.callData,
             signature: userOp.signature
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aastar/sdk",
-  "version": "0.16.21",
+  "version": "0.16.23",
   "description": "AAStar SDK - The all-in-one package for Mycelium Network",
   "type": "module",
   "publishConfig": {
@@ -14,15 +14,15 @@
   ],
   "dependencies": {
     "viem": "2.43.3",
-    "@aastar/core": "0.16.21",
-    "@aastar/dapp": "0.16.21",
-    "@aastar/paymaster": "0.16.21",
-    "@aastar/enduser": "0.16.21",
-    "@aastar/tokens": "0.16.21",
-    "@aastar/operator": "0.16.21",
-    "@aastar/account": "0.16.21",
-    "@aastar/admin": "0.16.21",
-    "@aastar/identity": "0.16.21"
+    "@aastar/core": "0.16.23",
+    "@aastar/dapp": "0.16.23",
+    "@aastar/enduser": "0.16.23",
+    "@aastar/paymaster": "0.16.23",
+    "@aastar/identity": "0.16.23",
+    "@aastar/operator": "0.16.23",
+    "@aastar/tokens": "0.16.23",
+    "@aastar/account": "0.16.23",
+    "@aastar/admin": "0.16.23"
   },
   "devDependencies": {
     "typescript": "5.7.2"