# AxBlade 技术黄皮书

> **AxBlade** 是基于 zkSync-era fork 的 Layer-2 ZK Rollup，搭载 **5-层 AI Agent Governance 架构**（L0 行为记录 / L1 决策回执 / L2 策略引擎 / L3 解释层 / L4 监管锚点），目标是把 AI Agent 的行为、决策、策略合规、可解释性、监管对齐统一上链。

***

## 本黄皮书覆盖什么

不同于市场宣传向的白皮书 (`docs/whitepaper/白皮书_中文v0.3.md`)，本黄皮书面向**集成方 / 智能合约开发者 / 审计师 / 监管机构**，按以下 5 个维度组织：

| 维度                    | 章节                                                                  | 适用读者                 |
| --------------------- | ------------------------------------------------------------------- | -------------------- |
| **算法 Algorithms**     | [Algorithms](/algorithms/merkle-tree-positional.md)                 | 协议工程师 / 审计 firm      |
| **使用场景 Use Cases**    | [Protocol Mechanics](/protocol-mechanics/pob-behavior-recording.md) | 产品 / 业务 / 法规         |
| **结构体系 Architecture** | [Overview](/overview/5-layer-architecture.md)                       | 技术 stakeholder / 投资人 |
| **确权 Ownership**      | [Registries](/registries-que-quan/policy-registry.md)               | 合规 / 法律 / 模型方        |
| **接入方式 Integration**  | [Integration](/integration-jie-ru-fang-shi/sdk-typescript.md)       | Agent 开发者 / 集成方      |

***

## 当前状态：PoC LIVE on chain 391

> **注意**：AxBlade 当前为 PoC（概念验证）阶段，**不能上 Ethereum 主网**。详见 [非主网就绪声明](/legal-and-disclaimers/not-mainnet-ready.md)。

| 维度          | 状态                                                                          |
| ----------- | --------------------------------------------------------------------------- |
| **链**       | chain 391 (`https://rpc-testnet.axblade.io`) — anvil-zksync 单节点 demo        |
| **合约**      | 33 个生产合约部署 + 1248 测试 100% 通过                                                |
| **L0 行为记录** | PoB v2 + ChallengeManager + 真链 fraud-proof e2e (0.5 ETH 真 slash)            |
| **L1 决策回执** | PoD + ECDSA 真验签 + ZK/TEE mock 待 swap                                        |
| **L2 策略引擎** | PolicyRegistry + EU AI Act high-risk 模板 + 真链 SDK e2e                        |
| **L3 解释层**  | ExplanationRegistry + deterministic stub explainer                          |
| **L4 监管锚点** | EU AI Act 策略 hash 链上                                                        |
| **审计**      | 0 轮独立审计；自审 prep 完成（[送审包](/consolidated-resources/audit-prep-package.md)）    |
| **稳定性**     | G3 30-min soak: 100% uptime / p50=749ms / 0 drift                           |
| **链上事实**    | 13 笔关键 tx 上链（[查表](/consolidated-resources/contract-addresses-chain-391.md)） |

***

## 导航

* [5-层架构总览](/overview/5-layer-architecture.md) — 一图看懂
* [Chain 391 Quickstart](/getting-started/chain-391-quickstart.md) — 5 分钟跑起来
* [Fraud-Proof 机制](/protocol-mechanics/fraud-proof-mechanism.md) — 真 slash 真链 e2e 拆解
* [PolicyRegistry 确权](/registries-que-quan/policy-registry.md) — 谁能注册策略
* [TypeScript SDK](/integration-jie-ru-fang-shi/sdk-typescript.md) — viem + @babydriver/sdk

***

## 概述

1. **传统 AI 没有可追溯的行为账本** — AxBlade 把每个 AI Agent 的"做了什么、为什么这么做、依据什么策略、能否解释、合不合规"五个问题的答案全部哈希上链，不可篡改。
2. **不是又一个 ZK Rollup** — AxBlade 在 ZK Rollup 之上叠加了**专门为 AI Agent 设计的 5 层治理协议**，对应 EU AI Act / NIST AI RMF / 中国生成式 AI 服务管理办法等监管要求。
3. **现在 PoC 完整 + 主网还差 12-18 个月** — 链上事实可被独立第三方在 chain 391 验证；主网部署需 2-3 轮独立审计 + 真 ZK prover + 真 TEE 替换 mock + 法律实体。

***

## 文档版本

* **黄皮书版本**：v1.0 — 2026-05-09 (commit `7c438db`)
* **白皮书对应版本**：v0.3 (2026-04-30)
* **链基线**：chain 391, block ≥ 21055 (2026-05-05 G3 soak)
* **送审基线**：commit `7c438db` (post 6 audit prep commits)

***

## 反馈与协作

* 代码：[github.com/leeleeEcho/babyDriver\_Layer2](https://github.com/leeleeEcho/babyDriver_Layer2)
* 漏洞披露：见 [Responsible Disclosure](/security/responsible-disclosure.md)
* 审计 firm 报价请求：见 [审计送审包](/consolidated-resources/audit-prep-package.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://yellowpaper.axblade.io/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.