> For the complete documentation index, see [llms.txt](https://chain-docs.babydriver.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chain-docs.babydriver.xyz/gai-lan/readme.md).

# 文档中心

> 面向机构与企业的高性能 ZK Rollup L2 区块链。 四大原生能力：**原生 Oracle** · **LP 快速桥** · **DID 身份** · **预测市场**。 "BabyDriver" 为项目开发代号，正式链名称将于主网上线前公布。

***

## 产品定位

BabyDriver 是一条为机构级 DeFi 和企业合规场景设计的以太坊 L2。与通用型 Rollup 不同，BabyDriver 在共识层原生集成了价格预言机、去中心化身份和合规基础设施，让 DApp 开发者不再依赖第三方中间件，直接获得零延迟喂价、ZK 身份验证和即时跨链提款能力。

**核心差异化：**

| 能力        | 说明                                 | 传统方案的问题                     |
| --------- | ---------------------------------- | --------------------------- |
| 原生 Oracle | Sequencer 级价格注入，<100ms 延迟，$0.001/次 | Chainlink 5-30s 延迟，$10-50/次 |
| LP 快速桥    | LP 垫付即时到账 <1h，Merkle proof 无信任结算   | ZK Rollup 标准提款 1-24h        |
| DID 身份    | ZK 选择性披露，合规但不暴露隐私                  | 全链上 KYC 违反 GDPR             |
| 预测市场      | OracleHub 自动结算，<1h 出结果             | UMA 人工裁决 48-72h             |

***

## 目录结构

```
docs/
├── README.md                 ← 你在这里
├── architecture/             ← 技术架构与选型论证
├── design/                   ← 产品设计文档（PRD、模块架构）
├── dev-notes/                ← 开发日志与技术笔记
├── FAQ/                      ← 常见问题
├── guides/                   ← 文档索引与导航
└── plans/                    ← 实施计划（按模块分目录）
```

***

## [产品路线图](/gai-lan/roadmap.md)

当前进度与未来规划一览。

***

## architecture/ — 技术架构

| 文档                                                            | 说明                |
| ------------------------------------------------------------- | ----------------- |
| [ARCHITECTURE-ANALYSIS.md](/jia-gou/architecture-analysis.md) | 技术选型论证与架构决策       |
| [L2-CORE-SUMMARY.md](/jia-gou/l2-core-summary.md)             | BabyDriver 架构优势总览 |

## design/ — 产品设计

| 文档                                                                                              | 说明                                    |
| ----------------------------------------------------------------------------------------------- | ------------------------------------- |
| [Layer2-Blockchain-PRD.md](/chan-pin-she-ji/layer2-blockchain-prd.md)                           | 产品需求文档（定位、市场分析、路线图）                   |
| [L2-Native-Oracle-Architecture.md](/chan-pin-she-ji/l2-native-oracle-architecture.md)           | 原生 Oracle 架构（Sequencer 级集成、<100ms 延迟） |
| [L2-Easy-Bridge-Architecture.md](/chan-pin-she-ji/l2-easy-bridge-architecture.md)               | 快速桥架构（LP 即时提款、Merkle proof 结算）        |
| [L2-BaaS-Enterprise-Design.md](/chan-pin-she-ji/l2-baas-enterprise-design.md)                   | 企业 BaaS 设计（RWA 通证化、合规服务）              |
| [Polymarket-Style-Prediction-Market.md](/chan-pin-she-ji/polymarket-style-prediction-market.md) | 预测市场设计（Gnosis CTF + CLOB）             |
| [AXBlade-Migration-Guide.md](/chan-pin-she-ji/axblade-migration-guide.md)                       | AXBlade 永续合约迁移方案                      |

## FAQ/ — 常见问题

| 文档                       | 说明                                 |
| ------------------------ | ---------------------------------- |
| [README.md](/faq/faq.md) | Q\&A 速查（Oracle、DID、Bridge、预测市场、架构） |

## dev-notes/ — 开发日志

| 文档                                      | 说明          |
| --------------------------------------- | ----------- |
| [dev-log.md](/kai-fa-ri-zhi/dev-log.md) | 技术决策记录与开发笔记 |

## plans/ — 实施计划

按模块分目录，每个功能包含设计稿和实现步骤。

### Oracle 集成

| 功能                 | 文件                                                                                                                  |
| ------------------ | ------------------------------------------------------------------------------------------------------------------- |
| Oracle API 集成      | [design](/oracle/2026-03-04-oracle-api-design.md) / [impl](/oracle/2026-03-04-oracle-api-impl.md)                   |
| Oracle Operator TX | [design](/oracle/2026-03-04-oracle-operator-tx-design.md) / [impl](/oracle/2026-03-04-oracle-operator-tx-impl.md)   |
| Oracle 自动化         | [design](/oracle/2026-03-05-oracle-automation-design.md) / [impl](/oracle/2026-03-05-oracle-automation-impl.md)     |
| Oracle 多符号         | [design](/oracle/2026-03-05-oracle-multi-symbol-design.md) / [impl](/oracle/2026-03-05-oracle-multi-symbol-impl.md) |

### Bridge 增强

| 功能                   | 文件                                                                                                                |
| -------------------- | ----------------------------------------------------------------------------------------------------------------- |
| FastWithdrawalPoolV2 | [design](/bridge/2026-03-03-bridge-enhancement-design.md) / [impl](/bridge/2026-03-03-bridge-enhancement-impl.md) |
| Bridge-Enhancer 自动结算 | [design](/bridge/2026-03-10-bridge-enhancer-design.md) / [impl](/bridge/2026-03-10-bridge-enhancer-impl.md)       |

### L1 合约

| 功能               | 文件                                                                                                                           |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| L1 Oracle Reader | [design](/l1-he-yue/2026-03-03-l1-contract-customization-design.md) / [impl](/l1-he-yue/2026-03-03-l1-oracle-reader-impl.md) |

### DID 身份系统

| 功能                  | 文件                                                                                                                            |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| DID 核心              | [design](/did-shen-fen/2026-03-04-did-system-design.md) / [impl](/did-shen-fen/2026-03-04-did-system-impl.md)                 |
| ZK 身份 + Oracle 信用评分 | [design](/did-shen-fen/2026-03-04-zk-identity-oracle-design.md) / [impl](/did-shen-fen/2026-03-04-zk-identity-oracle-impl.md) |
| L1 DIDFacet         | [design](/did-shen-fen/2026-03-04-l1-did-facet-design.md) / [impl](/did-shen-fen/2026-03-04-l1-did-facet-impl.md)             |
| Genesis 部署          | [design](/did-shen-fen/2026-03-05-genesis-redeploy-design.md) / [impl](/did-shen-fen/2026-03-05-genesis-redeploy-impl.md)     |
| 社会恢复 + 企业 IAM       | [design](/did-shen-fen/2026-03-06-phase5c-design.md) / [impl](/did-shen-fen/2026-03-06-phase5c-impl.md)                       |

### Testnet 部署

| 功能               | 文件                                                                |
| ---------------- | ----------------------------------------------------------------- |
| Sepolia AWS 全球部署 | [design](/testnet-bu-shu/2026-03-11-sepolia-aws-deploy-design.md) |

### 预测市场 + SDK

| 功能         | 文件                                                                                                                                        |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 预测市场 + SDK | [design](/yu-ce-shi-chang/2026-03-10-prediction-market-sdk-design.md) / [impl](/yu-ce-shi-chang/2026-03-10-prediction-market-sdk-impl.md) |

### Block Explorer

| 功能            | 文件                                                                                                                                        |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Blockscout 部署 | [design](/block-explorer/2026-03-03-blockscout-replacement-design.md) / [impl](/block-explorer/2026-03-03-blockscout-replacement-impl.md) |

***

## 系统合约

| 地址     | 合约                 | 说明                                              |
| ------ | ------------------ | ----------------------------------------------- |
| 0x8016 | OracleHub          | 原生价格预言机 — CoinGecko+Binance 双源聚合，Operator TX 注入 |
| 0x8017 | DIDRegistry        | 去中心化身份 — did:ethr:baby 标准，N-of-M 社会恢复           |
| 0x8018 | CredentialRegistry | 可验证凭证 — 发行、撤销、有效性检查                             |
| 0x8019 | IdentityVerifier   | 身份验证 — Groth16 ZK proof、信用评分、选择性披露              |
| 0x801A | EnterpriseIAM      | 企业权限 — 组织管理、角色、uint256 权限位图                     |

## 应用合约

| 合约                   | 说明                                   |
| -------------------- | ------------------------------------ |
| FastWithdrawalPoolV2 | LP 即时提款池 — 无信任结算，era Merkle proof 验证 |
| L1OracleReader       | L1 价格读取 — Mailbox proof 跨层验证         |
| ConditionalTokens    | 条件代币 — ERC-1155，Gnosis CTF 架构        |
| CTFExchange          | 订单簿 — 链上 CLOB，EIP-712 签名             |
| OracleResolver       | 市场结算 — OracleHub 自动 + 手动双模式          |

## SDK & 工具

| 包名              | 说明                                            |
| --------------- | --------------------------------------------- |
| @babydriver/sdk | TypeScript SDK — viem，ESM+CJS，覆盖预测市场 + Oracle |

## 测试覆盖

521 个自动化测试：400 Solidity (Foundry) + 14 SDK (vitest) + 87 Rust (cargo) + 20 电路 (circom)
