文档体系总结

---

文档结构

docs/
├── README.md                  # 文档中心（产品定位 + 目录）
├── ROADMAP.md                 # 产品路线图
├── architecture/              # 技术架构（2 篇）
├── design/                    # 产品设计（6 篇 + 1 PDF）
├── dev-notes/                 # 开发日志（1 篇，1300+ 行）
├── FAQ/                       # 常见问题（1 篇，15 个 Q&A）
├── guides/                    # 导航指南（2 篇）
└── plans/                     # 实施计划（9 目录，33 篇）

---

核心文档速览

文档	受众	内容
架构优势总览	所有人	四大原生能力 + 与主流 L2 对比
技术选型论证	技术团队	底层选型 + 定制化扩展方案
产品需求文档	决策者	市场分析 + 商业模式 + 路线图
Oracle 架构	工程师	三层架构 + 合约 + 防操纵
快速桥架构	工程师	LP 结算 + Sidecar 模式
预测市场	工程师	CTF + CLOB + 自动结算
产品路线图	所有人	已交付 + 当前阶段 + 未来规划

---

系统合约

地址	合约	功能
0x8016	OracleHub	原生 Oracle（双源聚合 + 偏差检测）
0x8017	DIDRegistry	DID 身份（did:ethr:baby + 社会恢复）
0x8018	CredentialRegistry	可验证凭证（发行 / 撤销）
0x8019	IdentityVerifier	ZK 验证（Groth16 + 选择性披露）
0x801A	EnterpriseIAM	企业权限（角色 + 权限位图）

---

测试覆盖

类别	数量	框架
Solidity 合约	400	Foundry
TypeScript SDK	14	vitest
Rust 模块	87	cargo test
ZK 电路	20	mocha / snarkjs
总计	521	—

---

实施计划目录

模块	文档数	内容
Oracle 集成	8	API 接入 + Operator TX + 自动化 + 多符号
Bridge 增强	4	FastWithdrawalPoolV2 + Rust 自动结算
L1 合约	2	L1OracleReader + Mailbox proof
DID 核心	2	3 系统合约 + 58 测试
ZK 身份	8	Groth16 电路 + 信用评分 + L1 DIDFacet + Genesis
社会恢复 + IAM	2	Guardian 恢复 + 企业权限
Testnet 部署	1	AWS 3-region EKS
预测市场	2	CTF + CLOB + SDK
Block Explorer	4	Blockscout Docker 部署