I.
潜在用户
你想知道这是什么，是否要参与。
- 读 Narrative · Why eDMT。
- 速览 FAQ。
- 打开 Mint，观察一个区块。
规范 文档。
协议层规则公开且不可变。应用层可以演化，叙事与 FAQ 会持续补充。
三 种文档。
协议规范是地基，公开后即冻结；应用层可以继续演化；叙事与 FAQ 是说明文字，我们会持续补充。
protocol/
协议 层
协议层没有合约、管理员、暂停键或升级钥匙。规则来自 calldata 规范与确定性 indexer，而不是某个可改的合约状态。
- 公开协议规范：calldata 格式、mint capture fee、transfer、FIFO、first-is-first 与 burn 语义。
- 公开 indexer 规范：合规 indexer 的重放、reorg、finality 与收敛要求。
contracts/
合约 参考实现
可以被任何人 fork。每个 fork 由 fork 它的人自己负责。
- 应用层合约文档不属于 public protocol package。第一版公开仓库只放协议层最小信任基础，不公开 wrapper / marketplace 规格。
narrative/
叙事 与文化
eDMT 为什么这样设计、背后做了哪些取舍，以及常见问题。
- 在本站打开。
- 技术综览 — 跨层通读不在公开协议仓库内。
- 在本站打开。
按读者 角色入门。
每个角色都有推荐的阅读路径。你总可以乱序阅读——后读的内容不会推翻先读的。
II.
协议工程师
你要跑一份合规 indexer，或审计协议规则。
- 通读 protocol/00。
- 读 protocol/05 实现规范。
- 与参考 indexer 并行运行并 diff state。
III.
智能合约工程师
你要实现或审计 ERC 包装 + Marketplace。
- 先读 protocol/00 中合约所依赖的硬规则。
- 通读 contracts/06，含 §1.5 「托管 = 签名」。
- 把实现对照参考 ABI 做 diff。
IV.
协议研究者
你要理解设计原因或考虑分叉。
- 按 00 → 05 → 06 → narrative 通读全部。
- 重点看每层的「信任假设」与「反模式」。
- 把你想 fork 的分歧点列清楚，给每条写理由。
核心 概念。
- eDMT
- Ethereum Digital Matter — 部署在以太坊主网的代币协议,铸造依据是区块的 EIP-1559 burn。
- 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。
- capture fee
- 激活阈值之后的 emt-mint 必须支付的 raw fragment 费用；由滚动 median burn 与 mint 拥堵倍率确定，按 FIFO 从发送方 fragment_balance 扣除并销毁。
- whole
- 绑定单一区块的完整 eNAT，内含其全部 burn。
- fragment
- 整张部分 transfer 后产生的 sub-gwei 余额；按地址维护 FIFO 队列。
- src
- emt-transfer 必备字段："«blk»" 为整张视图，"balance" 为碎片视图。
- Indexer
- 把 ETH 主网 calldata 解码为 eDMT state 的程序——它不创造事实，只报告事实。
- Protocol Operator
- 由创始人控制的单 EOA；wrap 资产在协议层视角下的实际持有人。不是多签——详见 /transparency 的信任模型披露。
- Oracle
- 理论上的多 indexer 见证机制，用于把 indexer state 喂给应用层合约。v1 没有实现：wrapper 合约直接信任 operator EOA 的视图。