@aastar/sdk 0.14.3 → 0.16.8

package/docs/Plan.md

@@ -1,266 +0,0 @@
-# AAStar计划
-
-
-## V2
-
-好的，完全理解你的思路！MVP阶段聚焦核心功能，快速验证，是非常明智的选择。
-
-根据你的优先级分析：
-
-*   **最高优先级 (High Priority - H)**:
-    1.  核心账户功能 (二次签名验证 + 整体集成，包括Relay)
-    2.  Demo 应用 (页面JS版本 + 简单后端配合，为后续集成COS72做准备)
-*   **中等优先级 (Medium Priority - M)**:
-    1.  基础的Gasless功能对接 (SuperPaymaster的初步集成)
-*   **低优先级 (Low Priority - L)**:
-    1.  SDSS的完全去中心化 (先采用中心化或简化版)
-    2.  完整的SDK化
-    3.  其他高级功能和研究性课题
-
-现在，我们基于这个思路，从你之前的详细任务列表中筛选和重组，形成一个更聚焦的MVP计划表格。
-
----
-
-## AirAccount MVP 开发计划 (V2)
-
-### 一、最高优先级 (High Priority - H)
-
-#### H1. 核心账户功能与集成 (Core Account Functionality & Integration)
-    - [ ] **H1.1 账户基础与二次签名验证 (Account Primitives & Dual-Signature Verification)**
-        - [ ] H1.1.1 最小版二次签名验证账户的合约实现 (BLS with DVT or simplified approach for MVP, plan EIP-7212 for future)
-        - [ ] H1.1.2 账户的注册、生成流程实现
-        - [ ] H1.1.3 指纹 (Passkey) 绑定与账户管理 (添加、查询) 的基本API和逻辑
-    - [ ] **H1.2 TEE 集成与核心钱包逻辑 (TEE Integration & Core Wallet Logic)**
-        - [ ] H1.2.1 AirAccount Relay 在 ARM 平台运行 TEE Wallet (TA) 的核心功能 (私钥安全存储与签名)
-        - [ ] H1.2.2 不可信应用 (CA) 与 TEE API 的基础交互逻辑 (用于Demo调用)
-        - [ ] H1.2.3 CA 与 TA 的核心交互流程联调 (签名请求与响应)
-    - [ ] **H1.3 Relay 与 Bundler 核心功能 (Relay & Bundler Core Functionality)**
-        - [ ] H1.3.1 内部 Bundler 的核心实现 (打包UserOperation)
-        - [ ] H1.3.2 Relay 的核心实现 (接收CA请求，与TEE交互，与Bundler交互，提交交易)
-    - [ ] **H1.4 整体核心流程联调 (Overall Core Flow Integration & Testing)**
-        - [ ] H1.4.1 从用户发起操作 (CA) -> Relay -> TEE签名 -> Bundler打包 -> 交易上链 的核心流程联调
-        - [ ] H1.4.2 部署与测试环境搭建 (例如，本地测试网，目标硬件初步验证 NXP iMX93)
-
-#### H2. Demo 应用与初步用户体验 (Demo Application & Initial UX)
-    - [ ] **H2.1 Demo 前端页面 (JS 版本) (Demo Frontend - JS Version)**
-        - [ ] H2.1.1 核心账户操作的用户界面 (账户创建、指纹绑定、发起简单交易)
-        - [ ] H2.1.2 与后端/Relay交互的API调用实现
-        - [ ] H2.1.3 基本的用户反馈和状态显示
-    - [ ] **H2.2 Demo 简易后端/模拟服务 (Demo Simplified Backend/Mock Service)**
-        - [ ] H2.2.1 (如果需要) 提供必要的后端API支持Demo前端 (例如，用户管理、状态查询的简化版)
-        - [ ] H2.2.2 (如果需要) 模拟部分链上交互或TEE行为，以便前端独立开发和测试
-    - [ ] **H2.3 Demo 流程验证与用户体验初步打磨 (Demo Flow Validation & Initial UX Refinement)**
-        - [ ] H2.3.1 完整演示核心账户创建、绑定、使用流程
-        - [ ] H2.3.2 收集初步用户体验反馈，进行界面和流程优化
-
-### 二、中等优先级 (Medium Priority - M)
-
-#### M1. 基础 Gasless 功能对接 (Basic Gasless Functionality Integration)
-    - [ ] **M1.1 SuperPaymaster 初步集成 (Initial SuperPaymaster Integration)**
-        - [ ] M1.1.1 部署或对接一个基础功能的 Paymaster 合约
-        - [ ] M1.1.2 实现 AirAccount 账户与该 Paymaster 的交互逻辑 (例如，允许特定ERC20代付)
-        - [ ] M1.1.3 在 Demo 应用中集成基础的 Gasless 交易体验 (例如，特定操作免Gas)
-    - [ ] **M1.2 Gasless 流程测试与验证 (Gasless Flow Testing & Validation)**
-        - [ ] M1.2.1 测试通过 Paymaster 完成 ERC20 代付的流程
-        - [ ] M1.2.2 验证 Gasless 交易的正确性和稳定性
-
----
-
-**计划V2说明与思考：**
-
-1.  **聚焦核心**: 这个版本严格筛选了任务，确保所有高优先级任务都直接服务于“可用的核心账户”和“能展示核心价值的Demo”。
-2.  **二次签名验证的简化**: 在H1.1.1中提到 "BLS with DVT or simplified approach for MVP"，意味着MVP阶段可以考虑一个更易于快速实现的二次签名方案，后续再升级到更复杂的链上验证方案。
-3.  **TEE的核心价值**: H1.2 强调了TEE在私钥安全存储和签名方面的核心作用，这是AirAccount安全性的基石。
-4.  **Relay是枢纽**: H1.3 将Relay和Bundler作为核心集成部分，它们是连接用户、TEE和区块链的关键。
-5.  **Demo驱动**: H2 的目标是快速构建一个能跑通核心流程的Demo，用于验证、展示和收集早期反馈。先有JS版本，后续再考虑集成到COS72。
-6.  **Gasless作为重要加分项**: M1 将基础的Gasless功能作为中等优先级，因为它能显著提升用户体验，是账户抽象的一个重要特性。MVP阶段实现基础对接即可。
-7.  **隐含的任务**:
-    *   **合约部署与管理**: 部署账户合约、Paymaster合约等。
-    *   **测试用例编写**: 对核心功能进行单元测试和集成测试。
-    *   **文档**: 核心API和流程的初步文档。
-8.  **后续迭代**:
-    *   **低优先级任务**: SDSS的去中心化、完整的SDK、社交恢复、ERC-7702、更多应用协议、AI集成等都放在MVP成功验证之后。
-    *   **COS72集成**: 在Demo JS版本稳定后，再考虑将其能力集成到更成熟的COS72框架中。
-
-这个V2计划更加精炼，目标更明确，希望能帮助你的团队高效推进MVP的开发。记住，MVP的关键在于“最小”和“可行”，快速迭代，持续优化。
-
---------
-下面是V1的
-
-------
-
-好的，这是一个非常详细和全面的开发计划！我将根据你提供的架构思考、Research重点和明细开发任务，帮你整理成一个包含checkbox的计划表格。
-
-**重要说明：**
-
-*   **层级与拆解**: 你提到了“表格罗列两层任务足够”，但你提供的明细任务非常细致，很多可以看作是第三层甚至第四层的任务。为了保持表格的可读性，我会尽量将相关的细致任务组织在更大的特性或模块下。
-*   **负责人与时间**: 这个表格**不包含**负责人和预计完成时间，这些需要你和你的团队根据实际情况来分配。
-*   **依赖关系**: 很多任务之间存在依赖关系，这个表格主要关注任务列表，具体的依赖管理需要在项目管理工具中体现。
-*   **动态调整**: 这是一个初步的计划，实际开发过程中肯定会遇到变化，需要灵活调整。
-*   **N0-N3**: 我理解这是指不同的部署阶段或节点类型，在相关任务中会体现。
-
-**开发计划表格 (Markdown格式)**
-
----
-
-## AirAccount 开发计划
-
-### 一、基础设施 (Infrastructure)
-
-#### 1. 核心账户与签名 (Core Account & Signature)
-    - [ ] **1.1 账户基础 (Account Primitives)**
-        - [ ] 1.1.1 最小版二次签名验证账户的注册、生成 (BLS with DVT, plan EIP-7212)
-        - [ ] 1.1.2 指纹 (Passkey) 绑定与账户管理 (添加、查询)
-    - [ ] **1.2 Paymaster 与 Gas 管理 (Paymaster & Gas Management)**
-        - [ ] 1.2.1 使用 Paymaster 完成 ERC20 代付
-        - [ ] 1.2.2 Gas Card 设计：查询、绑定、ERC20 代扣
-    - [ ] **1.3 Bundler 与 Relay (Bundler & Relay)**
-        - [ ] 1.3.1 Bundler 实现：从外部依赖过渡到内部 Bundler
-        - [ ] 1.3.2 优化：内部 Bundler 与 Paymaster Relay 合并，实现一步提交
-    - [ ] **1.4 TEE 集成与硬件钱包交互 (TEE Integration & HW Wallet Interaction)**
-        - [ ] 1.4.1 AirAccount Relay 在 ARM 平台运行 TEE Wallet (TA)
-        - [ ] 1.4.2 不可信应用 (CA) 开发
-        - [ ] 1.4.3 CA 通过 TEE API 调用可信应用 TA (硬件钱包) 的联合调试
-    - [ ] **1.5 社交恢复与账户升级 (Social Recovery & Account Upgrade)**
-        - [ ] 1.5.1 AirAccount 社交恢复的多签账户设计与实现
-        - [ ] 1.5.2 AirAccount 账户升级到社交恢复多签账户的流程
-        - [ ] 1.5.3 (可选) ERC-7702 账户集成与多签恢复嵌入
-    - [ ] **1.6 整体联调与测试 (Overall Integration & Testing)**
-        - [ ] 1.6.1 整体 AirAccount 基础设施联调 (目标平台: NXP iMX93 或更低配置)
-
-#### 2. SDSS (Standardized Decentralized Service System) - V0.1
-    - [ ] **2.1 核心服务与API (Core Services & API)**
-        - [ ] 2.1.1 SDSS ENS (或类似域名服务) 实现
-        - [ ] 2.1.2 SDSS API 服务基础框架搭建
-        - [ ] 2.1.3 路由注册、发现机制
-        - [ ] 2.1.4 API 标准数据提交、更新、缓存、错误处理机制
-    - [ ] **2.2 核心提交服务 (Core Submission Service)**
-        - [ ] 2.2.1 SDSS Submit 服务基础：一次提交 (Gas Sponsor + Bundler 上链)
-
-#### 3. 客户端与工具 (Client & Tools)
-    - [ ] **3.1 Tauri 客户端 (Tauri Client)**
-        - [ ] 3.1.1 Tauri 客户端多端发布与测试
-        - [ ] 3.1.2 Tauri 集成测试：COS72 基础 Web 版本开发与集成
-    - [ ] **3.2 SSO 与 SDK (SSO & SDK)**
-        - [ ] 3.2.1 SSO (单点登录) 插件/JS/SDK 开发与测试
-
-### 二、框架层 (Framework)
-
-#### 4. AAStar SDK 与集成
-    - [ ] **4.1 AAStar SDK 开发 (AAStar SDK Development)**
-        - [ ] 4.1.1 AAStar SDK Web 版本开发与测试
-    - [ ] **4.2 COS72 与 AAStar SDK 集成 (COS72 & AAStar SDK Integration)**
-        - [ ] 4.2.1 COS72 与 AAStar SDK 集成测试
-
-#### 5. Relay 技术栈演进与集成 (Relay Stack Evolution & Integration)
-    - [ ] **5.1 Relay 版本统一 (Relay Version Unification)**
-        - [ ] 5.1.1 Go 版本 Relay 与 Rust 版本 Relay 的尝试合并/搬迁
-    - [ ] **5.2 Rust Relay 集成 (Rust Relay Integration)**
-        - [ ] 5.2.1 Rust 版本 Relay 集成到 COS72 (N0-N3 部署)
-
-#### 6. SDSS 服务集成到 COS72 (SDSS Service Integration into COS72)
-    - [ ] **6.1 文件服务 SDSS (File Service SDSS)**
-        - [ ] 6.1.1 文件服务 SDSS 集成到 COS72
-    - [ ] **6.2 Supabase SDSS (Supabase SDSS)**
-        - [ ] 6.2.1 Supabase (或类似 BaaS) SDSS 集成到 COS72
-    - [ ] **6.3 硬件钱包 SDSS (Hardware Wallet SDSS)**
-        - [ ] 6.3.1 硬件钱包 SDSS 集成到 COS72
-
-#### 7. COS72 可定制化与发布 (COS72 Customization & Release)
-    - [ ] **7.1 可定制化 COS72 (Customizable COS72)**
-        - [ ] 7.1.1 COS72 配置化方案设计与实现
-        - [ ] 7.1.2 COS72 构建 (Build) 流程优化
-        - [ ] 7.1.3 COS72 发布流程建立
-
-### 三、应用层 (Application)
-
-#### 8. 核心协议与应用 (Core Protocols & Applications)
-    - [ ] **8.1 OpenPNTs (Programmable Non-fungible Tokens)**
-        - [ ] 8.1.1 OpenPNTs 协议设计与基础应用开发
-        - [ ] 8.1.2 OpenPNTs 集成到 COS72
-    - [ ] **8.2 OpenCards**
-        - [ ] 8.2.1 OpenCards 协议设计与基础应用开发
-        - [ ] 8.2.2 OpenCards 集成到 COS72
-    - [ ] **8.3 Uniswap V4 Launchpad (可选/探索)**
-        - [ ] 8.3.1 Uniswap V4 Launchpad 功能开发
-
-#### 9. PNTs 发行与演示 (PNTs Issuance & Demo)
-    - [ ] **9.1 PNTs 发行流程设计 (PNTs Issuance Flow Design)**
-        - [ ] 9.1.1 PNTs 发行流程 (线上线下、链上) Demo 设计
-    - [ ] **9.2 PNTs 发行流程开发 (PNTs Issuance Flow Development)**
-        - [ ] 9.2.1 PNTs 发行流程功能开发
-
-#### 10. COS72 版本发布 (COS72 Release)
-    - [ ] **10.1 COS72 V0.14 发布**
-        - [ ] 10.1.1 实现无侵入使用特性
-        - [ ] 10.1.2 实现随时解绑账户特性
-        - [ ] 10.1.3 支持用户发行自己的积分和 GasCard
-
-#### 11. AAStar 生态应用 (AAStar Ecosystem Applications)
-    - [ ] **11.1 AAStar 积分 (aPNTs)**
-        - [ ] 11.1.1 AAStar 发行自己的积分 aPNTs (基于 OpenPNTs)
-        - [ ] 11.1.2 aPNTs 引入 SDSS，管理积分发行
-
-#### 12. Arcadia (探索性项目)
-    - [ ] **12.1 Arcadia 设计与 Demo 开发**
-        - [ ] 12.1.1 Arcadia 概念讨论与哲学 AI 基础研究
-        - [ ] 12.1.2 Arcadia Demo2 开发
-
-#### 13. 插件生态 (Plugin Ecosystem)
-    - [ ] **13.1 插件规划**
-        - [ ] 13.1.1 ~20+ 插件的思考、规划与优先级排序
-
-### 四、AI 集成 (AI Integration) - (探索与研究阶段为主)
-
-#### 14. AI 辅助决策与知识库 (AI-Assisted Decision Making & Knowledge Base)
-    - [ ] **14.1 人生路径与未来知识库**
-        - [ ] 14.1.1 知识库构建与使用场景探索
-    - [ ] **14.2 常规选择与决策 AI 辅助**
-        - [ ] 14.2.1 AI 辅助模型研究与原型
-    - [ ] **14.3 消费决策 AI**
-        - [ ] 14.3.1 消费决策 AI 模型研究与原型
-
-#### 15. Crypto + AI (Asset3)
-    - [ ] **15.1 Asset3 概念与实现探索**
-        - [ ] 15.1.1 Crypto 资产与 AI 结合的创新应用探索
-
-### 五、Research 重点 (与开发并行或指导开发)
-
-*(这些是研究方向，可能不会直接转化为开发任务，但会影响设计和实现)*
-    - [ ] **R1. 签名方案研究**
-        - [ ] R1.1 当前签名方案优化与安全性分析 (BLS, EIP-7212 等)
-        - [ ] R1.2 后量子密码 (PQC) 签名方案调研与集成可行性分析
-    - [ ] **R2. TEE 可信方案研究**
-        - [ ] R2.1 TEE 技术栈选择与安全性评估 (e.g., Intel SGX, ARM TrustZone)
-        - [ ] R2.2 TEE 证明与远程认证机制研究
-    - [ ] **R3. 漏洞与作恶防范研究**
-        - [ ] R3.1 硬件层面漏洞分析与防范 (TEE, Secure Element)
-        - [ ] R3.2 应用层面安全设计与代码审计方法研究
-        - [ ] R3.3 智能合约安全审计与形式化验证方法研究
-    - [ ] **R4. 隐私保护技术研究**
-        - [ ] R4.1 ZKP (零知识证明) 在账户抽象和 SDSS 中的应用研究
-        - [ ] R4.2 匿名地址与隐私交易方案研究
-    - [ ] **R5. SDSS V0.1 性能评估**
-        - [ ] R5.1 SDSS V0.1 效率、吞吐量、延迟等性能指标测试与分析
-    - [ ] **R6. SDSS V0.2 (P2P) 演进研究**
-        - [ ] R6.1 SDSS 引入 P2P 网络后的架构变化、性能影响、去中心化程度分析
-
----
-
-**使用建议：**
-
-1.  **优先级排序**: 你的任务列表非常庞大。强烈建议根据 MVP (最小可行产品) 原则，对这些任务进行优先级排序。哪些是核心功能，哪些是后续迭代？
-2.  **分配负责人和时间**: 将每个 `- [ ]` 任务分配给具体的负责人，并估算完成时间。
-3.  **工具**: 使用专业的项目管理工具 (如 Jira, Trello, Asana, Notion, ClickUp 等) 来跟踪这些任务、依赖关系和进度。这个 Markdown 表格可以作为初始导入或高级概览。
-4.  **迭代**: 将开发过程划分为多个 Sprint 或迭代，每个迭代有明确的目标。
-5.  **定期同步**: 团队内部需要定期开会同步进度、讨论问题和调整计划。
-
-这个计划表非常宏大，预祝你的项目顺利推进！
-
-分析和思考：
-当务之急是MVP，因此
-1. 低优先级：SDSS是去中心化的，可以独立和分离，因此降低优先级，先中心化，再去中心，迁移难度不大
-2. 低优先级：相对独立的Superpaymaster，Gasless是独立的，可选的，因此中等优先级，完成基础的对接和基础的gasless即可
-3. 最高优先级：账户是串联所有的基础，目前核心是二次签名验证+整体集成（relay等），非SDK（后面再整合为sdk）
-4. 考虑demo也是高优先级，因此需要页面和服务器配合，先有页面js版本，再集成到cos72
-5. 所以计划的第二个版本，只设计高优先级（两个）和中等优先级（1个），请按这个思路筛选，不必那么严苛任务数量

package/docs/Regression_Testing_Guide.md

@@ -1,70 +0,0 @@
-# 回归测试脚本使用说明
-
-## 仅使用两个回归脚本
-
-### 1. `run_full_regression.sh` - 完整回归测试
-
-**用途**: Anvil本地完整测试套件
-
-**包含内容**:
-- Anvil启动与清理
-- 合约部署(DeployV3FullLocal.s.sol)
-- 配置同步
-- 24个测试脚本:
-  - ✅ V2回归测试 (6个): 00-05
-  - ✅ V3核心测试 (6个): 06-11
-  - ✅ 高级功能测试 (12个): 12-23, 98-99
-
-**运行方式**:
-```bash
-# Anvil模式(默认)
-./run_full_regression.sh
-
-# Sepolia模式(跳过部署)
-./run_full_regression.sh --env sepolia
-```
-
----
-
-### 2. `run_sdk_regression.sh` - SDK独立测试
-
-**用途**: SDK API层面的独立功能测试
-
-**包含内容**:
-- BLS签名测试
-- Middleware测试
-- 不依赖Anvil的纯SDK功能
-
-**运行方式**:
-```bash
-./run_sdk_regression.sh
-```
-
----
-
-## ⚠️ 已删除脚本
-
-- ❌ `scripts/run_regression.sh` (冗余,已合并到run_full_regression.sh)
-
----
-
-## 快速使用指南
-
-### 本地开发验证
-```bash
-./run_full_regression.sh
-```
-
-### Sepolia测试网验证
-```bash
-./run_full_regression.sh --env sepolia
-```
-
-### SDK功能测试
-```bash
-./run_sdk_regression.sh
-```
-
----
-
-**结论**: 只需要这两个脚本即可完成所有回归测试! ✅

package/docs/SDK_Optimization_Evaluation_Plan.md

@@ -1,51 +0,0 @@
-# SDK & Contract Optimization Evaluation Plan (GBT5.2 Recommendations)
-
-## 概述
-本方案针对 GBT5.2 对 `aastar-sdk` 及相关合约 ABI 扫描后给出的建议进行评估，并制定后续优化计划。我们将建议分为 **SDK 优化**、**合约安全加固** 以及 **架构对齐** 三个维度，并根据优先级划定动作：**优化 (Optimize)**、**置之不理 (Ignore)** 或 **更好的方案 (Better Solution)**。
-
----
-
-## 评估与动作列表
-
-### 1. SDK 侧建议评估 (packages/superpaymaster & core)
-
-| 建议点 | 评估 | 动作 | 理由/方案 |
-| :--- | :--- | :--- | :--- |
-| **`getPaymasterAndData` 输入上界校验** | 高 | **优化 (Optimize)** | `uint128` 溢出或格式错误会导致 Bundler 端不可预测的失败。应在 SDK 侧拦截并抛出清晰错误。 |
-| **`checkEligibility` 移除硬编码 Sepolia** | 中 | **优化 (Optimize)** | 支持多链是 SDK 的基本要求。应允许用户传入 `chainId` 或从 `provider` 自动获取。 |
-| **`formatUserOpToBundlerV07` 字段长度严格断言** | 高 | **优化 (Optimize)** | V0.7 格式对字节长度（如 `0x...` 字符串长度）有严格要求，由于 JS 没有原生固定长度字节类型，SDK 必须代劳检查。 |
-
-### 2. 合约侧（基于 ABI 反推）建议评估
-
-| 建议点 | 评估 | 动作 | 理由/方案 |
-| :--- | :--- | :--- | :--- |
-| **`PaymasterV4` 价格预言机新鲜度与权限校验** | 极高 | **优化 (Optimize)** | 关键安全路径。需确认合约源码中是否有 `updatedAt` 和 `roundId` 校验。SDK 侧无法修正，需同步到合约端。 |
-| **`SuperPaymasterV3` 债务隔离与 Slash 路径** | 高 | **优化 (Optimize)** | 多运营方模式下，用户债务必须隔离。Slash 逻辑需严格绑定 BLS 证明，防止误伤或攻击。 |
-| **`BLS/DVT` 聚合签名实操验证** | 极高 | **更好的方案 (Better Solution)** | 若目前仅为逻辑占位，主网前必须实现完整的 BLS 配对验证，或先行降级为多签治理方案以保安全。 |
-| **`Registry` 重放攻击防御 (Epoch/Nonce)** | 中 | **优化 (Optimize)** | Reputation 同步必须单调递增或带 Nonce，防止过期状态覆盖新状态。 |
-| **`ReputationSystemV3` 数组上限与 NFT 真实性** | 中 | **优化 (Optimize)** | 防止 Gas DoS 攻击。NFT Boost 必须做 `balanceOf` 校验而非仅仅依赖输入数组。 |
-
----
-
-## 执行计划与优先级
-
-### 第一阶段：SDK 鲁棒性增强 (Priority: P0)
-**目标**：确保 SDK 生成的 Payload 100% 符合规范，并能拦截低级输入错误。
-- [ ] 在 `getPaymasterAndData` 中增加 `uint128` 范围检查与地址合法性检查。
-- [ ] 重构 `checkEligibility`，支持从配置或环境中读取 `chainId`。
-- [ ] 为 `formatUserOpToBundlerV07` 增加对 `Hex` 长度的显式断言。
-
-### 第二阶段：合约安全与逻辑核对 (Priority: P1)
-**目标**：将 ABI 发现的高风险点在合约源码中进行逐一核对与修复。
-- [ ] 对接 `SuperPaymaster` 仓库，核对 `PaymasterV4` 和 `SuperPaymasterV3` 的关键权限代码。
-- [ ] 评估 `BLS/DVT` 的实现深度，并给出迁移/补全方案。
-
-### 第三阶段：文档与标准对齐 (Priority: P2)
-**目标**：更新技术文档，确保 SDK 行为与合约逻辑完全一致。
-- [ ] 更新 `projects/aastar-sdk/docs` 下的各组件文档。
-
----
-
-## 备注
-> [!IMPORTANT]
-> 由于本仓库仅包含 ABI 且当前处于 SDK 开发模式，上述合约侧建议需在切换至合约仓库时强制执行。SDK 的优化可即刻开始。

package/docs/SEPOLIA_ENV_REFERENCE.md

@@ -1,51 +0,0 @@
-# Sepolia Environment Configuration Reference
-
-Copy this configuration to your `.env.sepolia` file in `aastar-sdk/scripts/experiment/stage3/`:
-
-```bash
-# Sepolia Testnet Configuration
-SEPOLIA_RPC_URL=https://eth-sepolia.g.alchemy.com/v2/Bx4QRW1-vnwJUePSAAD7N
-ETHERSCAN_API_KEY=<your-etherscan-key>
-
-# EntryPoint & Bundler
-ENTRYPOINT_ADDRESS=0x0000000071727De22E5E9d8BAf0edAc6f37da032
-BUNDLER_URL=https://sepolia.g.alchemy.com/v2/Bx4QRW1-vnwJUePSAAD7N
-
-# V3 Core Components
-GTOKEN_ADDRESS=0xbf0DD4c529cA321bCa8FBE23644a64eFA1BeaeB6
-GTOKENSTAKING_ADDRESS=0x5D5d930C295630e8f4130fef037E23105BE17B84
-MYSBT_ADDRESS=0x44088fE0Fc39FEE323aFc8a760E79C45D3c2fcF6
-REGISTRY_ADDRESS=0x0b72441C61D97D6c48F080E29F8Cd507A62Ce674
-
-# V3 Factory & SuperPaymaster
-XPNTS_FACTORY_ADDRESS=0xD127976771547966e1a86d5DdFA10756ae682c34
-APNTS_ADDRESS=0x7e4ACE9e0DACf6e1Bb86A53B1b12a825568273c7
-SUPERPAYMASTER_V3_ADDRESS=0x2D8Bb69A570c96E86F6A0F774975A90C30534d44
-
-# Auxiliary Modules
-REPUTATION_SYSTEM_ADDRESS=0xddF0b0283E88D809E711AA5CFcab1D5fA835c2Ca
-BLS_AGGREGATOR_ADDRESS=0x77D381AE02C12cD826e14BC7642D43a85F9aB035
-DVT_VALIDATOR_ADDRESS=0xCD6d236D638a9991b423433BFF0C737112A0D4fB
-BLS_VALIDATOR_ADDRESS=0xD6932C92d75be024a90002feDaFD4EE8768298e5
-
-# V4 Paymaster Suite
-PAYMASTER_FACTORY_V4_ADDRESS=0x81178D2CB3f4BB8b4020923b082a8bddbb27aFf0
-PAYMASTER_V4_IMPL_ADDRESS=0x8400209ADC02125747cfF360b7E4ABA83941DcA3
-PAYMASTER_V4_INSTANCE_ADDRESS=0xfBDAac70E9e1e978651A2dd40469C221096b7533
-
-# Stage 3 Experiment Keys (NEVER COMMIT TO GIT)
-ADMIN_PRIVATE_KEY=<your-admin-key>
-EOA_PRIVATE_KEY=<your-eoa-key>
-AA_OWNER_PRIVATE_KEY=<your-aa-owner-key>
-
-# Pimlico (for Group B - Standard AA)
-PIMLICO_API_KEY=<your-pimlico-key>
-```
-
-## Quick Setup
-
-```bash
-cd /Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/scripts/experiment/stage3
-cp .env.sepolia.example .env.sepolia
-# Then fill in the private keys and API keys
-```

package/docs/STAGE_3_SCENARIO_EXP_PLAN.md

@@ -1,77 +0,0 @@
-# Stage 3 Sepolia Experiment & Orchestration Pattern Design
-
-## 1. 背景与目标 (Context & Objectives)
-
-在 Phase 2 (Local Anvil) 阶段，我们验证了所有 17 个基础回归用例。进入 Phase 3 (Sepolia)，我们的重点将从“功能验证”转向“**场景化业务流验证**”和“**基准性能评估**”。
-
-本计划旨在通过四个核心业务场景，沉淀出 SDK 的**高阶抽象模式 (Orchestration Patterns)**，并为 SuperPaymaster 论文提供可信的实验数据。
-
----
-
-## 2. 实验分组与基准 (Experiment Groups & Baselines)
-
-为了评估 SuperPaymaster 的竞争力，我们将对比三组账户：
-
-| 分组 | 身份标识 | 支付机制 | 核心组件 | 预期优势 |
-| :--- | :--- | :--- | :--- | :--- |
-| Group A: EOA | Standard EOA | Self-pay (ETH) | WalletClient | Baseline (Min Overhead) |
-| **Group B: Standard AA** | SimpleAccount v0.7 | 3rd Party Sponsor | Alchemy/Pimlico | Industry Standard |
-| **Group C1: Paymaster V4** | SimpleAccount v0.7 | Token-based (v4) | PaymasterV4 Contract | Basic Token Sponsorship |
-| **Group C2: SuperPaymaster** | SimpleAccount v0.7 | Asset-based Gasless | SuperPaymaster V3 | Fully Decoupled & Credit Flow |
-
----
-
-## 3. 场景化测试用例 (Scenario-driven Test Cases)
-
-我们不仅测试单个 API，而是测试完整的“业务链路”。
-
-### 3.1 场景一：社区启动 (DAO Launchpad Pattern)
-- **业务逻辑**: 协议管理员批准 -> 社区管理员注册项目 -> 初始质押 GToken -> 部署专属 xPNTs 代币。
-- **SDK 沉淀**: `CommunityClient.onboardCommunity()` 组合操作。
-- **验证点**: 注册事件监听、xPNTs 部署地址验证、质押状态同步。
-
-### 3.2 场景二：运营商运维 (Operator Lifecycle)
-- **业务逻辑**: 运营商质押 -> 获取节点经营权 -> 通过 Factory 部署私有 Paymaster -> 激活 SuperPaymaster 路由。
-- **SDK 沉淀**: `OperatorClient.setupNode()` 模式。
-- **验证点**: 合约确定性部署 (CREATE2)、SuperPaymaster 权限映射、国库充值流转。
-
-### 3.3 场景三：终端用户旅程 (User Onboarding & Credit)
-- **业务逻辑**: 用户加入社区 -> 铸造 SBT (Auto-stake) -> 信用额度激活 -> 查看实时 Reputation。
-- **SDK 沉淀**: `EndUserClient.joinAndActivate()`。
-- **验证点**: SBT 余额、信用上限计算逻辑、信用恢复速度。
-
-### 3.4 场景四：极致 Gasless 体验 (High-Frequency UX)
-- **业务逻辑**: 用户在无 ETH 状态下，连续发送 10 笔跨协议交互。
-- **SDK 沉淀**: `EndUserClient.sendGaslessTransaction()`。
-- **数据采集**: Gas消耗明细、UserOp 处理耗时、Paymaster 扣费准确性。
-
----
-
-## 4. 实施规划 (Implementation Roadmap)
-
-### 4.1 目录结构
-在 `aastar-sdk` 下建立独立目录：
-```text
-scripts/experiment/stage3/
-├── .env.sepolia          # Sepolia 环境专用私钥与地址
-├── 01_dao_launch.ts      # 场景一脚本
-├── 02_operator_setup.ts  # 场景二脚本
-├── 03_user_onboarding.ts # 场景三脚本
-├── 04_benchmarking.ts    # 场景四 (数据采集)
-└── setup.ts              # 分组账号初始化与资金分发
-```
-
-### 4.2 开发与执行顺序
-1. **环境初始化**: 部署 V3.3.0 核心合约至 Sepolia -> 填充 `.env.sepolia`。
-2. **场景脚本编写**: 按照 3.1-3.4 逐步实现，优先关注“组合 API”的开发。
-3. **数据采集**: 运行 `04_benchmarking.ts` 至少 30 组数据，生成 JSON 报告。
-4. **模式沉淀**: 将脚本中重复的 Orchestration 逻辑提取到 `packages/sdk` 的高阶函数中。
-
----
-
-## 5. 预期交付物
-
-1. **`docs/STAGE_3_SCENARIO_EXP_PLAN.md`**: 详细的业务用例设计方案（即本文件）。
-2. **`scripts/experiment/stage3/`**: 完整的可运行测试代码库。
-3. **`docs/STAGE_3_REPORT.json`**: 包含三组对比数据的实验报告。
-4. **SDK Patterns**: 在 `docs/guide/patterns.md` 中更新高阶业务开发模式。

package/docs/Script_Comparison_Report.md

@@ -1,91 +0,0 @@
-# 回归测试脚本对比验证
-
-## 对比结果
-
-### scripts/run_regression.sh (旧脚本)
-**测试内容**:
-```
-scripts/v2_regression/00_validate_env.ts
-scripts/v2_regression/01_setup_and_fund.ts
-scripts/v2_regression/02_operator_onboarding.ts
-scripts/v2_regression/03_community_registry.ts
-scripts/v2_regression/04_enduser_flow.ts
-scripts/v2_regression/05_admin_audit.ts
-```
-**特点**: 简单、仅运行V2回归测试、不处理Anvil启动
-
----
-
-### run_full_regression.sh (新主脚本)
-**测试内容** (包含上述所有6个 + 更多):
-```
-✅ scripts/v2_regression/00_validate_env.ts
-✅ scripts/v2_regression/01_setup_and_fund.ts
-✅ scripts/v2_regression/02_operator_onboarding.ts
-✅ scripts/v2_regression/03_community_registry.ts
-✅ scripts/v2_regression/04_enduser_flow.ts
-✅ scripts/v2_regression/05_admin_audit.ts
-   scripts/06_local_test_v3_admin.ts
-   scripts/06_local_test_v3_funding.ts
-   ...共24个测试
-```
-**特点**: 
-- ✅ 包含所有v2_regression测试
-- ✅ 自动启动Anvil
-- ✅ 自动部署合约
-- ✅ 支持Sepolia模式
-
----
-
-### run_sdk_regression.sh (SDK独立测试)
-**测试内容**:
-```
-22_test_bls_signing.ts
-23_test_middleware.ts
-20_sdk_full_capability.ts
-18_sdk_e2e_verification.ts
-19_sdk_experiment_runner.ts
-```
-**特点**: 
-- SDK层面测试
-- 不依赖Anvil
-- 不与scripts/run_regression.sh重复
-
----
-
-## ✅ 验证结论
-
-**scripts/run_regression.sh** 的所有功能已100%包含在:
-- ✅ `run_full_regression.sh` (包含全部6个v2_regression测试)
-
-**无遗漏内容**: 
-- run_full_regression.sh 是 scripts/run_regression.sh 的**超集**
-- 包含完全相同的测试 + 额外18个高级测试
-
-**可以安全删除**: 
-- ✅ scripts/run_regression.sh (冗余)
-
----
-
-## 推荐使用
-
-**V2回归测试** (仅6个基础测试):
-```bash
-# 直接在Sepolia运行
-REVISION_ENV=sepolia SDK_ENV_PATH=.env.sepolia \
-  ./run_full_regression.sh --env sepolia --skip-deploy
-```
-
-**完整回归测试** (24个测试):
-```bash
-# Anvil本地
-./run_full_regression.sh
-
-# Sepolia
-./run_full_regression.sh --env sepolia
-```
-
-**SDK独立测试**:
-```bash
-./run_sdk_regression.sh
-```