@aastar/sdk 0.16.11 → 0.16.14

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/Reputation-to-Credit_Mapping_Whitepaper.md

@@ -1,242 +0,0 @@
-# Reputation-to-Credit 技术映射白皮书
-
-## 1. 设计初衷与哲学 (Design Philosophy)
-
-AAStar 协议的核心愿景是构建一个“赋能社区、简化开发”的账户抽象基础设施。在这个体系中，**Reputation (声誉)** 和 **Credit (信用/授信)** 是连接链上资产与社交共识的桥梁。
-
-### 核心理念：
-- **Reputation 是主观度量**：它代表了社区成员之间的共识。声誉不是单纯的数字，而是基于用户活动（Entropic Factor）和社交关系（Social Graph）的综合评分。
-- **Credit 是经济表现**：信用是将主观声誉转化为客观支付能力的机制。通过信用系统，用户可以“预支”Gas 费用，实现真正的无感交互。
-- **去中心化的安全底线**：通过 DVT (Distributed Validator Technology) 和 BLS 聚合签名，确保声誉的更新不依赖于任何单一中心化实体。
-
----
-
-## 2. 技术架构与映射逻辑
-
-### 2.1 声誉增长路径 (The Three Tiers)
-
-系统设计了三种平行的声誉更新路径，以适应不同的信任级别：
-
-| 级别 | 名称 | 触发逻辑 | 验证机制 | 适用场景 |
-| :--- | :--- | :--- | :--- | :--- |
-| **Tier 1** | **Manual Inject** | 管理员手动设定 | 合约 Owner 权限 | 测试、紧急干预、初始数据导入 |
-| **Tier 2** | **Rule-based Sync** | 链上规则自动累加 | 预定义智能合约算法 | 质押奖励、固定活动积分 |
-| **Tier 3** | **DVT Batch Sync** | 离线计算批量同步 | **BLS256 聚合签名证明** | 生产环境、综合行为建模、跨链声誉 |
-
-### 2.2 映射模型：从分数到额度
-
-声誉分数的转换遵循以下三级映射：
-
-1.  **Reputation Score (25分)**: 用户在特定社区或全局的活动积分。
-2.  **Credit Level (Level 2)**: 在 `Registry` 中注册的等级阈值。
-    - *配置示例*：Level 1 (>10分), Level 2 (>20分), Level 3 (>50分)。
-3.  **Credit Limit (100 aPNTs)**: 每个等级对应一个全局的基础信用额度。
-4.  **Community Limits (xPNTs)**: 各社区可基于全局额度进行微调或设置黑名单。
-
----
-
-## 3. 用户场景与活动路径
-
-### 场景 A：终端用户 Gasless 体验 (End-user Flow)
-1.  **活动产生**：用户在 App 内完成每日签到。
-2.  **声誉增长**：`ReputationSystem` 根据 Tier 2 规则自动计算分数增长。
-3.  **信用变现**：用户发起交易，`SuperPaymaster` 发现该用户 `Credit Level` 已达标。
-4.  **代付执行**：`SuperPaymaster` 为用户垫付 Gas，并在 `xPNTsToken` 中记录债务（Debt）。
-5.  **自动偿还**：当用户获得新的社区激励（Mint）时，债务先于余额自动扣除。
-
-### 场景 B：社区管理员配置 (Admin Flow)
-1.  **启动社区**：通过 `createCommunityClient` 启动并部署社区专属 `xPNTsToken`。
-2.  **定义规则**：调用 `ReputationSystem.setRule` 设置“质押 100 GT 每日增 1 分”的规则。
-3.  **设置阈值**：在 `Registry` 中定义不同信用等级对应的 Airdrop 权限。
-
-### 场景 C：生产级去中心化同步 (DVT Consensus Flow)
-1.  **离线分析**：DVT 节点群分析用户的跨链及链上行为。
-2.  **共识签名**：多个 DVT 节点对更新后的声誉列表进行 BLS 签名。
-3.  **批量注入**：调用 `Registry.batchUpdateGlobalReputation`。合约在毫秒内验证 BLS 证明。
-4.  **权限锁死**：Owner 权限收缩，确保非 DVT 签名的声誉更新会被拒绝。
-
----
-
-## 4. 关键初始化配置 (Default Setup)
-
-为了确保系统的“开箱即用”且安全，我们预设了以下基准配置：
-
-- **基础信用阈值 (Level Thresholds)**:
-  - Level 1: 13 points (入门级，支持基础转账代付)。
-  - Level 2: 50 points (高级用户，支持复杂合约交互)。
-- **信用额度配额 (Credit Tiers)**:
-  - Level 1 Limit: 等值 $10 USD 的 aPNTs。
-  - Level 2 Limit: 等值 $50 USD 的 aPNTs。
-- **安全拦截器 (Safety Interceptor)**:
-  - `SuperPaymaster` 采用**被动黑名单机制**。即使额度足够，若 DVT 标记 `isBlocked=true`，交易仍会被拒绝。
-
----
-
-## 5. 结论
-
-Reputation-to-Credit 映射不仅是一套算法，它是 AAStar 网络治理的核心。它通过将“社交声誉”转化为“链上信用”，解决了 Web3 用户进入门槛高的痛点，同时利用 DVT 技术确保了这套信用体系的公正与去中心化。
-
----
-
-## 6. 核心数据结构与关系映射 (Core Data Structures & Relationships)
-
-为了深入理解系统如何从底层数据层面支撑声誉到信用的转换，本节整理了三大核心合约的关键数据对象及其交互关系。
-
-### 6.1 对象关系图 (Object Relationship Diagram)
-
-```mermaid
-classDiagram
-    class Registry {
-        +mapping(address => uint256) globalReputation
-        +mapping(uint256 => uint256) creditTierConfig
-        +uint256[] levelThresholds
-        +RoleConfig[] roleConfigs
-        +getCreditLimit(user)
-    }
-
-    class ReputationSystem {
-        +mapping(community => Rule) communityRules
-        +mapping(user => score) communityReputations
-        +computeScore()
-        +syncToRegistry()
-    }
-
-    class SuperPaymaster {
-        +mapping(operator => OperatorConfig) operators
-        +mapping(operator => user => UserOpState) userOpState
-        +validatePaymasterUserOp()
-    }
-
-    class User {
-        +address account
-        +uint256 reputationScore
-        +uint256 creditLimit
-    }
-
-    %% Relationships
-    ReputationSystem ..> Registry : 1. Sync Score (Write)
-    User --> Registry : 2. Check Level (Read)
-    Registry --> SuperPaymaster : 3. Credit Limit (Read)
-    SuperPaymaster ..> User : 4. Enforce Blocking (Read State)
-```
-
-### 6.2 核心数据对象 (Key Data Objects)
-
-#### A. Registry (Single Source of Truth)
-Registry 是整个系统的状态中心，存储了用户的全局声誉和信用配置。
-
-| 数据结构 | 类型 | 描述 | 关键字段 (Struct/Field) |
-| :--- | :--- | :--- | :--- |
-| **Global Reputation** | `mapping` | 所有用户的全局声誉分 | `globalReputation[user] => uint256 score` |
-| **Credit Tiers** | `mapping` | 等级与信用额度的映射 | `creditTierConfig[level] => uint256 limit (aPNTs)` |
-| **Level Thresholds** | `array` | 晋升等级所需的分数线 | `levelThresholds[] = [13, 34, 89...]` |
-| **Role Config** | `struct` | 角色行为定义 | `minStake`, `exitFeePercent`, `roleLockDuration` |
-
-#### B. ReputationSystem (Calculation Engine)
-负责计算分数的逻辑层，支持规则定义和即时计算。
-
-| 数据结构 | 类型 | 描述 | 关键字段 (Struct/Field) |
-| :--- | :--- | :--- | :--- |
-| **Rule** | `struct` | 社区定义的声誉获取规则 | `baseScore`, `activityBonus`, `maxBonus` |
-| **Community Rules** | `mapping` | 社区特有规则集 | `communityRules[community][ruleId] => Rule` |
-| **Score Cache** | `mapping` | 社区内局部声誉缓存 | `communityReputations[community][user] => uint256` |
-
-#### C. SuperPaymaster (Execution Layer)
-根据 Registry 的数据执行支付逻辑，并维护自身的风险控制状态。
-
-| 数据结构 | 类型 | 描述 | 关键字段 (Struct/Field) |
-| :--- | :--- | :--- | :--- |
-| **OperatorConfig** | `struct` | Paymaster 运营商配置 | `aPNTsBalance`, `exchangeRate`, `isPaused` |
-| **UserOpState** | `struct` | 压缩的用户状态(省Gas) | `uint48 lastTimestamp`, `bool isBlocked` |
-| **PriceCache** | `struct` | 代币价格预言机缓存 | `int256 price`, `uint256 updatedAt` |
-
-### 6.3 数据流转逻辑 (Data Flow)
-
-整个信用体系的数据流转遵循 **"计算 -> 存储 -> 消费"** 的闭环：
-
-1.  **计算 (Compute)**: `ReputationSystem` 根据 `Rule` 和用户活动（Activities）计算出 `communityScore`。
-2.  **同步 (Sync)**: 通过 `syncToRegistry` 或 DVT 共识，将计算结果写入 `Registry.globalReputation`。
-3.  **映射 (Map)**: `Registry` 内部通过 `levelThresholds` 将分数动态映射为 `Credit Level`。
-4.  **消费 (Consume)**: 用户发起交易时，`SuperPaymaster` 调用 `Registry.getCreditLimit(user)` 获取最新的信用额度。
-5.  **校验 (Validate)**: `SuperPaymaster` 结合自身的 `UserOpState` (是否被屏蔽、频率限制) 和额度，决定是否为该 UserOperation 支付 Gas。
-
----
-
-## 7. 深度解析：多社区协同与算法聚合 (Deep Dive: Multi-Community Aggregation)
-
-本节通过具体的用户案例（Alice）和运营视角，解析声誉系统如何在去中心化的环境下处理多源数据。
-
-### 7.1 用户视角：Alice 的多重身份 (The User Journey)
-
-假设用户 **Alice** 加入了三个不同的 DAO 社区，并在每个社区通过不同的行为积累声誉。
-
-#### A. 行为记录
-| 社区 | 角色/身份 | 参与活动 (Activity) | 原始积分 |
-| :--- | :--- | :--- | :--- |
-| **Panda DAO** | 治理成员 | **投票 (Vote)**: 参与了 15 次治理投票 | 150 pts |
-| **Dev Guild** | 开发者 | **代码贡献 (PR)**: 合并了 3 个 PR | 300 pts |
-| **Charity Fund**| 捐赠者 | **捐款 (Donate)**: 捐赠了 0.5 ETH | 500 pts |
-
-#### B. 数据展示与查询
-Alice 不需要去三个不同的应用查看积分。通过 Aggregator（聚合器）前端或 SDK，她可以调用统一的 ABI 获取全视图：
-- **查询单社区分**：`ReputationSystem.calculateReputation(Alice, PandaDAO, 0)` -> 返回 `150`。
-- **查询全局分**：`Registry.globalReputation(Alice)` -> 返回聚合后的总分（如 `950`）。
-- **查询明细**：`ReputationSystem.getReputationBreakdown(Alice, DevGuild, ...)` -> 返回 `baseScore`, `activityBonus` 等。
-
-### 7.2 运营视角：规则配置 (Operator Configuration)
-
-三个社区的 Operator (运营者账户) 可以在不修改合约代码的情况下，通过 ABI 设置各自的激励规则。
-
-#### A. 规则定义 (Rule Definition)
-通过调用 `ReputationSystem.setRule(bytes32 ruleId, uint base, uint bonus, uint max, string desc)`：
-
-1.  **Panda DAO (投票)**: 
-    - `ruleId`: `keccak256("VOTE_ACTION")`
-    - `base`: 10 (每次参与的基础分)
-    - `bonus`: 0
-    - `max`: 1000
-2.  **Dev Guild (PR)**: 
-    - `ruleId`: `keccak256("PR_MERGED")`
-    - `base`: 50
-    - `bonus`: 10 (代码量额外奖励)
-    - `max`: 500
-
-#### B. 规则生效逻辑
-规则配置立即存储在链上 `communityRules[communityAddr][ruleId]` 中。只要 Alice 在该社区产生交互（触发 SDK 的 `l4-reputation-tiers.ts` 脚本或后端触发），积分计算逻辑会自动拉取最新的配置进行计算。
-
-### 7.3 算法核心：熵增因子与聚合 (The Aggregation Algorithm)
-
-系统如何避免“积分通胀”？如何平衡不同社区的权重？核心在于 **内置的加权聚合算法**。
-
-#### A. 当前算法逻辑 (Current Logic)
-`ReputationSystem.computeScore` 采用线性加权求和模型：
-
-```solidity
-// 伪代码逻辑
-function computeScore(user, communities, activities) {
-    totalScore = 0;
-    for (comm in communities) {
-         rawScore = rules[comm].base + (activity * rules[comm].bonus);
-         // 关键：熵增因子 (Entropy Factor)
-         // 1e18 = 1.0 (标准权重)
-         // 0.5e18 = 0.5 (低质量社区降权)
-         weight = entropyFactors[comm]; 
-         totalScore += (rawScore * weight) / 1e18;
-    }
-    return totalScore;
-}
-```
-
-- **Panda DAO** (权重 1.0): 150 * 1.0 = 150
-- **Dev Guild** (权重 1.5 - 技术公会): 300 * 1.5 = 450
-- **Charity Fund** (权重 0.8): 500 * 0.8 = 400
-- **Global Score**: 150 + 450 + 400 = **1000**
-
-这种设计允许 Registry 管理员（或 DAO 治理）通过调整 `entropyFactors` 来宏观调控不同社区对全局信用的贡献度，防止恶意刷分社区破坏系统平衡。
-
-#### B. 未来演进：可插拔算法模块 (Pluggable Algorithm)
-`ReputationSystem` 目前实现了 `IReputationCalculator` 接口。由于 `Registry` 与计算逻辑是**解耦**的（Registry 只存结果，不存过程），未来可以轻松升级：
-
-1.  **外置模块化**: 可以部署 `ReputationSystemV2`（例如引入 PageRank 算法或通过 AI 模型分析链上行为）。
-2.  **多源喂价**: `Registry.isReputationSource` 允许白名单机制。未来可以授权给 Chainlink Oracle 或 ZK-Verifier 合约，它们可以使用完全不同的链下算法计算分数，只需将最终结果 "Feed" 给 Registry。
-3.  **无缝迁移**: 由于 Alice 的 Global Reputation 是累积的，新的算法可以基于旧分进行增量更新，或者通过 Epoch 版本号完全重置，实现平滑过渡。