Skip to main contentA-REX Foundation

白皮书 · 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)。
EPCISGS1 Electronic Product Code Information Services,可追溯性的事件词汇表(2.0 版)。
CPR / CPR-eCédula de Produto Rural,巴西的作物应收账款;其电子形式在获授权的实体处登记。
EWR美国《仓储法》下的电子仓单。
MLETRUNCITRAL《电子可转让记录示范法》。
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。

代币是证券吗? 标准不作决定,发售才决定。请咨询法律顾问;无论答案如何,强制执行接口都在那里。