@aastar/sdk 0.14.3 → 0.16.6

package/abis/SuperPaymaster.json

@@ -204,6 +204,30 @@
     "outputs": [],
     "stateMutability": "payable"
   },
+  {
+    "type": "function",
+    "name": "blockedUsers",
+    "inputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "view"
+  },
   {
     "type": "function",
     "name": "cachedPrice",
@@ -477,6 +501,30 @@
     ],
     "stateMutability": "view"
   },
+  {
+    "type": "function",
+    "name": "lastUserOpTimestamp",
+    "inputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint48",
+        "internalType": "uint48"
+      }
+    ],
+    "stateMutability": "view"
+  },
   {
     "type": "function",
     "name": "onTransferReceived",
@@ -552,6 +600,11 @@
         "type": "uint32",
         "internalType": "uint32"
       },
+      {
+        "name": "minTxInterval",
+        "type": "uint48",
+        "internalType": "uint48"
+      },
       {
         "name": "treasury",
         "type": "address",
@@ -683,6 +736,19 @@
     "outputs": [],
     "stateMutability": "nonpayable"
   },
+  {
+    "type": "function",
+    "name": "setOperatorLimits",
+    "inputs": [
+      {
+        "name": "_minTxInterval",
+        "type": "uint48",
+        "internalType": "uint48"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
   {
     "type": "function",
     "name": "setOperatorPaused",
@@ -858,6 +924,29 @@
     "outputs": [],
     "stateMutability": "nonpayable"
   },
+  {
+    "type": "function",
+    "name": "updateBlockedStatus",
+    "inputs": [
+      {
+        "name": "operator",
+        "type": "address",
+        "internalType": "address"
+      },
+      {
+        "name": "users",
+        "type": "address[]",
+        "internalType": "address[]"
+      },
+      {
+        "name": "statuses",
+        "type": "bool[]",
+        "internalType": "bool[]"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
   {
     "type": "function",
     "name": "updatePrice",
@@ -865,6 +954,29 @@
     "outputs": [],
     "stateMutability": "nonpayable"
   },
+  {
+    "type": "function",
+    "name": "updatePriceDVT",
+    "inputs": [
+      {
+        "name": "price",
+        "type": "int256",
+        "internalType": "int256"
+      },
+      {
+        "name": "updatedAt",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "",
+        "type": "bytes",
+        "internalType": "bytes"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
   {
     "type": "function",
     "name": "updateReputation",
@@ -964,6 +1076,19 @@
     ],
     "stateMutability": "nonpayable"
   },
+  {
+    "type": "function",
+    "name": "version",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "stateMutability": "pure"
+  },
   {
     "type": "function",
     "name": "withdraw",
@@ -1108,6 +1233,25 @@
     ],
     "anonymous": false
   },
+  {
+    "type": "event",
+    "name": "OperatorMinTxIntervalUpdated",
+    "inputs": [
+      {
+        "name": "operator",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "newInterval",
+        "type": "uint48",
+        "indexed": false,
+        "internalType": "uint48"
+      }
+    ],
+    "anonymous": false
+  },
   {
     "type": "event",
     "name": "OperatorPaused",
@@ -1247,6 +1391,31 @@
     ],
     "anonymous": false
   },
+  {
+    "type": "event",
+    "name": "UserBlockedStatusUpdated",
+    "inputs": [
+      {
+        "name": "operator",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "user",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "isBlocked",
+        "type": "bool",
+        "indexed": false,
+        "internalType": "bool"
+      }
+    ],
+    "anonymous": false
+  },
   {
     "type": "event",
     "name": "UserReputationAccrued",

package/abis/aPNTs.json

@@ -74,32 +74,6 @@
     ],
     "stateMutability": "view"
   },
-  {
-    "type": "function",
-    "name": "VERSION",
-    "inputs": [],
-    "outputs": [
-      {
-        "name": "",
-        "type": "string",
-        "internalType": "string"
-      }
-    ],
-    "stateMutability": "view"
-  },
-  {
-    "type": "function",
-    "name": "VERSION_CODE",
-    "inputs": [],
-    "outputs": [
-      {
-        "name": "",
-        "type": "uint256",
-        "internalType": "uint256"
-      }
-    ],
-    "stateMutability": "view"
-  },
   {
     "type": "function",
     "name": "addAutoApprovedSpender",
@@ -788,6 +762,19 @@
     ],
     "stateMutability": "view"
   },
+  {
+    "type": "function",
+    "name": "version",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "stateMutability": "pure"
+  },
   {
     "type": "event",
     "name": "Approval",

package/abis/xPNTsFactory.json

@@ -67,32 +67,6 @@
     ],
     "stateMutability": "view"
   },
-  {
-    "type": "function",
-    "name": "VERSION",
-    "inputs": [],
-    "outputs": [
-      {
-        "name": "",
-        "type": "string",
-        "internalType": "string"
-      }
-    ],
-    "stateMutability": "view"
-  },
-  {
-    "type": "function",
-    "name": "VERSION_CODE",
-    "inputs": [],
-    "outputs": [
-      {
-        "name": "",
-        "type": "uint256",
-        "internalType": "uint256"
-      }
-    ],
-    "stateMutability": "view"
-  },
   {
     "type": "function",
     "name": "aPNTsPriceUSD",
@@ -569,6 +543,19 @@
     "outputs": [],
     "stateMutability": "nonpayable"
   },
+  {
+    "type": "function",
+    "name": "version",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "stateMutability": "pure"
+  },
   {
     "type": "event",
     "name": "APNTsPriceUpdated",

package/abis/xPNTsToken.json

@@ -74,32 +74,6 @@
     ],
     "stateMutability": "view"
   },
-  {
-    "type": "function",
-    "name": "VERSION",
-    "inputs": [],
-    "outputs": [
-      {
-        "name": "",
-        "type": "string",
-        "internalType": "string"
-      }
-    ],
-    "stateMutability": "view"
-  },
-  {
-    "type": "function",
-    "name": "VERSION_CODE",
-    "inputs": [],
-    "outputs": [
-      {
-        "name": "",
-        "type": "uint256",
-        "internalType": "uint256"
-      }
-    ],
-    "stateMutability": "view"
-  },
   {
     "type": "function",
     "name": "addAutoApprovedSpender",
@@ -788,6 +762,19 @@
     ],
     "stateMutability": "view"
   },
+  {
+    "type": "function",
+    "name": "version",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "stateMutability": "pure"
+  },
   {
     "type": "event",
     "name": "Approval",

package/config.anvil.json

@@ -0,0 +1 @@
+{"aPNTs":"0x1f10F3Ba7ACB61b2F50B9d6DdCf91a6f787C0E82","blsAggregator":"0x38a024C0b412B9d1db8BC398140D00F5Af3093D4","blsValidator":"0xB82008565FdC7e44609fA118A4a681E92581e680","dvtValidator":"0x5fc748f1FEb28d7b76fa1c6B07D8ba2d5535177c","entryPoint":"0x5bf5b11053e734690269C6B9D438F8C9d48F528A","gToken":"0xffa7CA1AEEEbBc30C874d32C7e22F052BbEa0429","paymasterFactory":"0xb9bEECD1A582768711dE1EE7B0A1d582D9d72a6C","paymasterV4Impl":"0x8A93d247134d91e0de6f96547cB0204e5BE8e5D8","registry":"0xE3011A37A904aB90C8881a99BD1F6E21401f1522","reputationSystem":"0x525C7063E7C20997BaaE9bDa922159152D0e8417","sbt":"0xab16A69A5a8c12C732e0DEFF4BE56A70bb64c926","simpleAccountFactory":"0x40918Ba7f132E0aCba2CE4de4c4baF9BD2D7D849","srcHash":"","staking":"0x3aAde2dCD2Df6a8cAc689EE797591b2913658659","superPaymaster":"0x457cCf29090fe5A24c19c1bc95F492168C0EaFdb","xPNTsFactory":"0x2a810409872AfC346F9B5b26571Fd6eC42EA4849"}

package/config.sepolia.json

@@ -0,0 +1 @@
+{"aPNTs":"0xb26399500aBee1123730f778a23598e0bE406CDC","blsAggregator":"0x633aa91b184B8013AfB01Fe954ee5f4b28F8DCf0","blsValidator":"0x93C73f81C70f1Be3bFE4898f216de3c4D0f324C1","dvtValidator":"0xCE05732bC336d86002c6E643DB06E489aB957Dcf","entryPoint":"0x0000000071727De22E5E9d8BAf0edAc6f37da032","gToken":"0x60dDD2b4BEb69d9760bBF90e05C34A716736840D","paymasterFactory":"0xDaC3904219B14f0D0b65B878A8314C113B9b9060","paymasterV4Impl":"0x6103ae3471fD718e057e00E12132CC8EC8482EFC","registry":"0x2c738da36d9763F77335f5b0F87603f892af980b","reputationSystem":"0xAcf3E34F61f423a164a9625A0286138DC195cd6d","sbt":"0x6c17f40770C811060C55956A6822fdFD11DF00c5","srcHash":"9c12d7e7fc4a4296623fe319674e47cd68946b7be9092e5a765ecc54de124690","staking":"0xd71d7581927384437d1afc9c9a9F0A7D80cac602","superPaymaster":"0xec7E0A785d891ad4E3365b0998C2D8ED05E8b60D","xPNTsFactory":"0x42f17c5722b5EE72659f74D3043382A672b3D30b"}

package/config.test.json

@@ -0,0 +1,27 @@
+{
+  "communities": {
+    "AAStar": {
+      "name": "AAStar",
+      "ensName": "aastar.eth",
+      "website": "aastar.io",
+      "description": "AAStar Community - Empower Community! Twitter: https://X.com/AAStarCommunity",
+      "logoURI": "ipfs://aastar-logo",
+      "stakeAmount": "30000000000000000000",
+      "pointsName": "aPNTs"
+    },
+    "Demo": {
+      "name": "DemoCommunity",
+      "ensName": "demo.eth",
+      "website": "demo.com",
+      "description": "Demo Community for testing purposes.",
+      "logoURI": "ipfs://demo-logo",
+      "stakeAmount": "30000000000000000000",
+      "pointsName": "dPNTs"
+    }
+  },
+  "accounts": {
+    "jason": "0xb5600060e6de5E11D3636731964218E53caadf0E",
+    "anni": "0xEcAACb915f7D92e9916f449F7ad42BD0408733c9",
+    "attacker": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8"
+  }
+}

package/docs/ABI_Change_Tracking_Workflow.md

@@ -0,0 +1,41 @@
+# ABI Change Tracking Workflow
+
+This guide explains how to use the automated ABI coverage audit tool to maintain alignment between smart contract ABIs and the AAStar SDK.
+pnpm exec vitest run --coverage packages/core/src/actions/*.test.ts
+
+## Overview
+
+The `audit:abi` tool detects changes in ABI files and verifies that all critical contract functions are implemented in the SDK Action modules. It uses MD5 hashes to track changes efficiently.
+
+## Running the Audit
+
+To run the audit manually:
+
+```bash
+pnpm run audit:abi
+```
+
+The tool will output:
+- **⚡ CHANGED**: ABI has changed since the last audit.
+- **✅ UNCHANGED**: ABI is consistent with the last baseline.
+- **Coverage %**: Percentage of ABI functions matched in the SDK.
+- **Missing Functions**: A list of ABI functions not yet implemented or mapped.
+
+## Workflow for ABI Changes
+
+When a contract is updated and new ABIs are generated:
+
+1.  **Update ABIs**: Copy the new JSON files into `packages/core/src/abis/`.
+2.  **Run Audit**: Execute `pnpm run audit:abi`.
+3.  **Analyze Report**:
+    -   If a function name changed: Update the corresponding action in `src/actions/`.
+    -   If a new critical function was added: Implement it in the action module.
+    -   If a function was removed: Remove the dead code from the action module.
+4.  **Update Tests**: Review and adjust tests in `src/actions/*.test.ts` to reflect the changes.
+5.  **Re-baseline**: Running the audit script again will update the `.abi-hashes.json` baseline.
+
+## Implementation Details
+
+- **Mapping**: The tool maps `ContractName.json` to `contractName.ts` (camelCase).
+- **Matching**: It uses case-insensitive matching for function names to accommodate semantic naming in the SDK.
+- **Cache**: Pre-calculated hashes are stored in `src/abis/.abi-hashes.json`.

package/docs/ABI_MAINTENANCE_PLAN.md

@@ -0,0 +1,132 @@
+# SDK ABI 维护计划
+
+## 命名策略（最终版）
+
+**统一无版本号命名**：
+- 文件名：`BLSAggregator.json`（无 V3 后缀）
+- 版本信息：通过 ABI 的 `version()` 函数获取
+- 同步时自动去除版本号后缀
+
+## 最终 ABI 配置（20个）
+
+### 从 SuperPaymaster 同步（16个）
+
+#### 核心合约（13个）
+来源：`SuperPaymaster/abis/*.json`（同步时去除版本号）
+
+- BLSAggregator.json ← BLSAggregatorV3.json
+- BLSValidator.json
+- DVTValidator.json ← DVTValidatorV3.json
+- GToken.json
+- GTokenStaking.json
+- MySBT.json
+- PaymasterFactory.json
+- PaymasterV4_2.json
+- Registry.json
+- ReputationSystem.json ← ReputationSystemV3.json
+- SuperPaymaster.json ← SuperPaymasterV3.json
+- xPNTsFactory.json
+- xPNTsToken.json
+
+#### AA 标准（3个）
+来源：`SuperPaymaster/out/*.sol/*.json`（提取 `.abi` 字段）
+
+- EntryPoint.json
+- SimpleAccount.json
+- SimpleAccountFactory.json
+
+### SDK 自维护（4个）
+
+- SimpleAccountV08.json
+- SimpleAccountFactoryV08.json
+- Simple7702Account.json
+- Eip7702Support.json
+- SenderCreator.json
+- LegacyAccount.json
+- UserOperationLib.json
+
+## 自动同步流程
+
+### 触发
+每次运行回归测试前自动同步：
+```bash
+pnpm tsx scripts/phase1_verify_contracts.ts
+```
+
+### 同步步骤
+
+**步骤1**：合约地址
+- `SuperPaymaster/deployments/sepolia.json` → SDK `.env.sepolia`
+
+**步骤2.1**：核心合约 ABI（13个）
+- `SuperPaymaster/abis/*.json` → SDK `packages/core/src/abis/`
+- **自动去除版本号**：`BLSAggregatorV3.json` → `BLSAggregator.json`
+
+**步骤2.2**：AA 标准 ABI（3个）
+- 从 `SuperPaymaster/out/` 提取纯 ABI 数组
+
+**步骤3**：环境配置（可选）
+- 提示手动复制 `.env.sepolia`
+
+## 典型使用场景
+
+### 场景1：更新核心合约（最常见）
+
+```bash
+# 在 SuperPaymaster 修改合约
+cd SuperPaymaster
+forge build
+./extract_abis.sh
+
+# 切换到 SDK，运行测试（自动同步）
+cd ../aastar-sdk
+pnpm tsx scripts/phase1_verify_contracts.ts
+```
+
+**自动执行**：
+1. 同步合约地址
+2. 同步 ABI（自动去除版本号）
+3. 验证合约环境
+
+### 场景2：查看合约版本
+
+```typescript
+import { SuperPaymasterABI } from '@aastar/core';
+import { createPublicClient } from 'viem';
+
+const version = await client.readContract({
+  address: superPaymasterAddress,
+  abi: SuperPaymasterABI,
+  functionName: 'version'
+});
+// 返回: "SuperPaymaster-3.2.0"
+```
+
+## 维护检查清单
+
+### 每次合约更新后
+- [ ] SuperPaymaster 编译成功
+- [ ] `extract_abis.sh` 已运行
+- [ ] SDK 测试自动同步 ABI
+- [ ] SDK 构建成功（`pnpm build`）
+
+### 定期检查
+- [ ] 确认无重复 ABI 文件
+- [ ] 确认 `index.ts` 导出完整
+- [ ] 确认命名统一（无版本号后缀）
+
+## 总结
+
+**核心原则**：
+1. **单一数据源**：SuperPaymaster 是唯一来源
+2. **自动同步**：每次测试前自动更新
+3. **统一命名**：文件名无版本号，版本信息在 ABI 内
+4. **无重复**：一个合约一个 ABI 文件
+
+**日常使用**：
+```bash
+# 更新合约 → 编译 → 运行 SDK 测试 → 自动同步 ✅
+pnpm tsx scripts/phase1_verify_contracts.ts
+```
+
+大多数时候只更新13个核心 ABI，AA 标准和辅助 ABI 基本不变。