@aastar/sdk 0.14.0 → 0.16.6

package/docs/Plan.md

@@ -0,0 +1,266 @@
+# 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

@@ -0,0 +1,70 @@
+# 回归测试脚本使用说明
+
+## 仅使用两个回归脚本
+
+### 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
+```
+
+---
+
+**结论**: 只需要这两个脚本即可完成所有回归测试! ✅