I.
潜在用户
你想知道这是什么，是否要参与。
- 读 Narrative · Why eDMT。
- 速览 FAQ。
- 打开 Mint，观察一个区块。
规范 文档。
eDMT 的文档很小、很严、对自己的边界很诚实。协议规则部署后不可变；其余各层都是可分叉、可替代的参考实现。
四个 表面。
协议在底；合约、后端、前端在上；叙事与 FAQ 在侧。每一层的变更策略都不一样。
protocol/
协议 层
Trustless。规则在部署时冻结。无 admin、无升级钥匙、无 pause。
- 协议语义的唯一权威来源——mint、transfer、FIFO、first-is-first。
- 合规 indexer 的行为规范，包括 reorg 处理与收敛策略。
contracts/
合约 参考实现
应用层。可分叉；每个分叉承担自己的信任假设。
- ERC-721 / ERC-20 包装、Marketplace、Oracle 规范。含「托管 = 签名」硬约束。
frontend/
前端 参考实现
任何人可独立部署 UI。所有用户动作都必须披露信任。
- 产品规范——Mint、Explore、Trade、Wrap、Stats、Profile、Docs。
- 为什么这个设计系统像国家公报而不像初创落地页。
- 设计系统手册——tokens、patterns、组件、do/don't。
narrative/
叙事 与文化
跨层。教育性。不得与协议规范冲突。
- 在本站打开。
- 在仓库打开。
- 在仓库打开。
- 在本站打开。
按读者 角色入门。
每个角色都有推荐的阅读路径。你总可以乱序阅读——后读的内容不会推翻先读的。
II.
协议工程师
你要跑一份合规 indexer，或审计协议规则。
- 通读 protocol/00。
- 读 protocol/05 实现规范。
- 与参考 indexer 并行运行并 diff state。
III.
智能合约工程师
你要实现或审计 ERC 包装 + Marketplace。
- 先读 protocol/00 中合约所依赖的硬规则。
- 通读 contracts/06，含 §1.5 「托管 = 签名」。
- 把实现对照参考 ABI 做 diff。
IV.
后端 · DevOps
你要部署 indexer、API 与多签守护进程。
- 读 backend/07 部署规范。
- 读 protocol/05 了解 indexer 必须产出什么。
- 读 contracts/06 §5 理解 oracle 多签拓扑。
V.
前端 · 设计
你要在参考后端之上发 Web 应用。
- 读 frontend/08 产品规范。
- 读 frontend/design-system.md 与 09-Design-Tokens.md。
- 读 contracts/06 §1.5 / §7 的强制信任披露 UI。
VI.
协议研究者
你要理解设计原因或考虑分叉。
- 按 00 → 05 → 06 → 07 → 08 → narrative 通读全部。
- 重点看每层的「信任假设」与「反模式」。
- 把你想 fork 的分歧点列清楚，给每条写理由。
我们 承诺什么。
一张简短的承诺表。每条承诺绑定在特定层——违反即偏离参考规范。
| 承诺 | 层 | 实质 |
|---|---|---|
| 规则永不修改 | 一旦在主网发布（element 注册 + ticker 部署），协议字面规则永远不变。 | |
| 无 admin、无升级、无 pause | 协议层 selectors 内无任何管理员权限，没有东西可被夺取。 | |
| 无 burn 阈值（≥ 1 gwei 除外）、无供给上限、无团队保留 | 稀缺由 EIP-1559 分布自然决定，我们不加人为约束。 | |
| 任何人可跑独立 indexer | 不依赖任何中心化数据源。参考实现只是便利，不是门禁。 | |
| 合约部署后代码不可变 | 包装合约自身无升级、无 pause、无费率调整。 | |
| 包装层不假装 trustless | 多签 EOA 托管在每个应用层页面都显式披露。 | |
| 用户总有 raw calldata 退路 | 不信任应用层时，你可以永远走协议层 P2P calldata。 |
核心 概念。
- eDMT
- Ethereum Digital Matter — 部署在 ETH 主网的非任意代币协议。
- eNAT
- eDMT 下的首个 ticker；一个区块对应一张 eNAT，绑定该区块的 EIP-1559 burn。
- burn(N)
- floor(baseFeePerGas(N) × gasUsed(N) / 10^9)，单位 gwei。
- first-is-first
- 对区块 N，归属永远归最早提交合规 emt-mint 并被主网确认的 tx.from。
- whole
- 绑定单一区块的完整 eNAT，内含其全部 burn。
- fragment
- 整张部分 transfer 后产生的 sub-gwei 余额；按地址维护 FIFO 队列。
- src
- emt-transfer 必备字段："«blk»" 为整张视图，"balance" 为碎片视图。
- Indexer
- 把 ETH 主网 calldata 解码为 eDMT state 的程序——它不创造事实，只报告事实。
- Protocol Operator
- M-of-N 多签 EOA；wrap 资产在协议层视角下的实际持有人。
- Oracle
- 多 indexer 多签见证机制，把 indexer state 喂给应用层合约。