白皮书 · 16
附录
接口清单留在标准仓库中。
附录 A:接口参考
接口清单留在标准仓库中。
留在那里的内容
规范、接口源文和批次元数据模式。
公开读者可以知道的内容
A-REX Core 在多代币基础上增加批次身份、拆分或加工时的谱系、执行面、一条规则管道,以及来自受信任签发方的证明。
本章保留的内容
签名、错误名、存储布局和模式。
如何索取文本
想要实现 A-REX、用它发行批次或审计它的公司使用提前访问页面。每份申请都由人工审核。获准的读者获得标准仓库和参考实现的只读访问。
已经写下的条款
访问用于评估、实现和反馈。材料在发布之前保持机密。已写下的条款说明标准将以 CC0 发布,提前访问不授予排他权。
后续页面的范围
术语表、参考文献和随后的问题解释术语。它们是公开词汇。
被点名、未被复制的文档
本站点的标准一节列出同样的文档。
边界
会让读者复制接口的页面留在本章之外。
附录 B:术语表
| 术语 | 含义 |
|---|---|
| 批次 | 带有 Batch 记录的 ERC-1155 代币 id:同一种商品、同一单位、具有相同来源和生产时间的一批货物。 |
| 重新分批 | 输出与输入商品和单位相同、数量守恒的 transform(拆分、合并)。在参考实现中对持有人开放。 |
| 加工 | 改变商品、单位或数量的 transform。在参考实现中需要 TRANSFORMER_ROLE。 |
| 谱系 | 由 BatchTransformed 事件和 parentsOf 构成的图。 |
| 钩子 | 实现 IARexHook、注册在代币上、并在每次操作时按顺序求值的合约。 |
| 拒绝代码 | 钩子的 check 返回的 bytes32;0 表示允许;约定为 keccak256("NAMESPACE:NAME")。 |
| 资格 | 账户层面的发送或接收许可,由标记为 HOOK_ELIGIBILITY 的钩子回答;以 ERC-7943 canSend/canReceive 的形式公开。 |
| 冻结余额 | 账户持有但不能移动的单位(setFrozenTokens);可以超过余额。 |
| 强制转移 | ENFORCER_ROLE 在未经持有人同意的情况下移动单位(ERC-7943)。 |
| 证明 | 由该主题的可信签发方记录的 (batch, topic) → (issuer, reference, validity)。 |
| 主题 | 标识证明所涉事项的 bytes32;开放;可映射到 ERC-735 声明主题和 EAS schema id。 |
| 来源引用 | originRef:指向来源证据的哈希或引用;绝不是坐标。 |
| 元数据承诺 | metadataHash,即位于 uri 的规范链下文档的 keccak256。 |
| 状态 | uint8 生命周期取值;0 为活跃,255 为已注销(终态);1..254 由签发方定义。 |
| CTE / KDE | 关键追踪事件 / 关键数据元素(FSMA 204)。 |
| DDS | 尽职调查声明(EUDR)。 |
| EPCIS | GS1 Electronic Product Code Information Services,可追溯性的事件词汇表(2.0 版)。 |
| CPR / CPR-e | Cédula de Produto Rural,巴西的作物应收账款;其电子形式在获授权的实体处登记。 |
| EWR | 美国《仓储法》下的电子仓单。 |
| MLETR | UNCITRAL《电子可转让记录示范法》。 |
| ERC-7943 (uRWA) | 通用现实世界资产接口(Universal Real World Asset):冻结、强制转移、资格;Final,2026 年五月。 |
| ERC-3643 (T-REX) | 面向 ERC-20 上证券的许可制代币标准;Final,2023 年十二月。 |
| ERC-7201 | 用于可升级合约的命名空间存储布局。 |
附录 C:参考文献
标准与规范
- Radomski, W. 等。“EIP-1155: Multi Token Standard.” Ethereum Improvement Proposals,2018 年。
- Vogelsteller, F., Buterin, V. “EIP-20: Token Standard.” 2015 年。
- “ERC-165: Standard Interface Detection.” 2018 年。
- “ERC-3643: T-REX — Token for Regulated EXchanges.” Final,2023 年十二月 15 日。https://eips.ethereum.org/EIPS/eip-3643
- “ERC-7943: uRWA — Universal Real World Asset Interface.” Final,2026 年五月 27 日。https://eips.ethereum.org/EIPS/eip-7943
- “ERC-7201: Namespaced Storage Layout.” 2023 年。
- “ERC-735: Claim Holder.” 2017 年(草案)。
- Ethereum Attestation Service 文档。
- GS1. “EPCIS and CBV Standard 2.0.” 2022 年。GS1 US. “EPCIS Recommendations for FSMA 204 Critical Tracking Events.” 2024 年。
- UN/CEFACT. “Recommendation No. 20: Codes for Units of Measure Used in International Trade.”
- IETF RFC 8785. “JSON Canonicalization Scheme (JCS).” 2020 年。
- OpenZeppelin Contracts 5.x 文档;OpenZeppelin 与 T-REX Network 合作公告,2026 年七月。
监管与法律
- FDA. “Requirements for Additional Traceability Records for Certain Foods.” 最终规则,联邦公报 87(219),2022 年;“Compliance Date Extension,” 联邦公报,2025 年八月 7 日。
- 条例 (EU) 2023/1115(毁林);条例 (EU) 2025/2650(修订);欧盟理事会新闻稿,2025 年十二月 18 日。
- 条例 (EU) 2023/1114(MiCA);ESMA《关于将加密资产界定为金融工具的指南》,2024 年十二月。
- 欧洲数据保护委员会。“Guidelines 02/2025 on processing of personal data through blockchain technologies,” 2.0 版,2026 年七月 7 日。
- SEC。公告编号 33-11412,2026 年三月 17 日。SEC v. W.J. Howey Co.,328 U.S. 293 (1946)。
- GENIUS Act,公法 119-27(2025);实施条例,联邦公报,2026 年八月 18 日。
- 《统一商法典》2022 年修订,第 12 编(可控电子记录)。
- 美国《仓储法》;7 CFR Part 869(电子仓单)。
- UNCITRAL. “Model Law on Electronic Transferable Records.” 2017 年。英国,《2023 年电子贸易单据法》。
- Comisión Nacional de Valores(阿根廷)。Resolución General 1150/2026。Ley 9.643(权证)。
- 巴西。Lei 8.929/1994、Lei 13.986/2020(CPR);Lei 11.076/2004(CDA/WA);CVM Resolução 88 与 Consulta Pública SDM 05/2025。
- Verra. “Verra Addresses Crypto Instruments and Tokens.” 2022 年;VCS Program Guide。
- 指令 (EU) 2024/825(赋能消费者实现绿色转型)。
研究与行业
- Zhang, P., Schmidt, D. C. “Blockchain Applications in Food Supply Chain Management: A Systematic Review.” Journal of Food Engineering,279,2020 年。
- Caro, M. P. 等。“Blockchain-based Traceability in Agri-Food Supply Chain Management.” IEEE,2018 年。
- FAO. “The State of Food and Agriculture.” 2023 年。
- World Bank. “Future of Food: Harnessing Digital Technologies to Improve Food System Outcomes.” 2022 年。
- ERC3643 Association. “History of ERC-3643”;ISO TC 307 标准化倡议公告。
- Chainlink. “Automated Compliance Engine (ACE): Technical Overview.” 2025–2026 年。
附录 D:模板
钩子、部署和元数据文档的可运行示例留在仓库中。
它们为什么留在那里
这些示例足以复制一套实现。这一公开章节解释术语和后果。
它们在哪里
它们随标准仓库和参考实现提供给提前访问申请已获批准的读者。
附录 E:常见问题
A-REX 是 ERC 吗? 尚不是。该规范以 ERC 格式撰写,将在完成生产部署、出现独立实现并通过审计之后提交。尚未分配编号;代码中的名称不使用 ERC 前缀。
我必须使用 ARexToken 吗? 参考实现是一种实现。接口属于规范性文本。
我必须使用参考钩子吗? 它们是演示。已获访问的读者可以在参考仓库中阅读它们。
钩子可以阻止强制转移吗? 它可以针对 OP_FORCED_TRANSFER 返回一个代码,代币随即回滚。参考钩子不会这样做;规范强制执行的钩子(例如要求带有命令引用)则可以。
坐标放在哪里? 放在由元数据引用的受限链下存储中,绝不放在链上。
如何表示未来的收成? producedAt = 0;用 ExpiryHook(allowPreHarvestTransfers) 为转移设门槛。
transform 中的数量是否守恒? 标准并不要求;参考实现在数量守恒时允许任何持有人重新分批,否则需要 TRANSFORMER_ROLE。
代币是证券吗? 标准不作决定,发售才决定。请咨询法律顾问;无论答案如何,强制执行接口都在那里。