RWA 开发手册

本工程是一套基于 ERC-3643（T-REX） 标准的真实世界资产（RWA）发行与流转系统。它做的事情可以用一句话概括：让一份现实资产变成链上代币，并且只有通过资格审核的人才能持有和转让它。

本文档面向第一次接触本工程的开发者。按顺序读完六章，你应该能做到：说清楚系统由哪些合约组成、一笔资产是怎么发出来的、一个投资者是怎么获得持有资格的、增发和销毁调用哪个方法、以及从链上查到这些结果。

一、一页读懂

问题	答案
这是什么	一套受资格约束的代币发行系统，代币标准是 ERC-3643
和普通代币的区别	普通 ERC-20 有余额就能转；本系统还要求「接收方资格合格」且「本笔交易符合规则」
代币兼容性	完全兼容 ERC-20，钱包和交易所可以像普通代币一样读取余额、监听 `Transfer`
一种资产由几个合约组成	6 个核心合约，统称一套 Suite，由工厂一键部署
谁来判断"人合格"	`IdentityRegistry`（身份注册表）
谁来判断"交易合规"	`ModularCompliance`（规则中枢）
资格证明存在哪	投资者自己的链上身份合约 `ONCHAINID` 上的 Claim
链上会存身份证照片吗	不会。链上只存"是否通过了某类资格"这个结论
环境	Bohr 测试网（Chain ID `968`）与 BOT 主网能力演示（Chain ID `677`）各有一套独立 `PRWA` Suite

最重要的一句话，贯穿全文：

Token 负责记账，IdentityRegistry 负责判断"人是否合格"，ModularCompliance 负责判断"这笔交易是否合规"。

从资产上线到投资者持币，整体只有四步：

每一步对应的关键动作与结果：

步骤	主要调用	完成后可验证的结果
发行资产	`TREXGateway.deployTREXSuite`	得到 Token 及其配套 5 个合约地址
投资者准入	`ONCHAINIDGateway.deployIdentityForWallet` → `Identity.addClaim` → `IdentityRegistry.registerIdentity`	`IdentityRegistry.isVerified(钱包)` 返回 `true`
增发 / 销毁	`Token.mint` / `Token.burn`	`Transfer` 事件，且 `balanceOf` 变化
流转	`Token.transfer`	校验通过则成功，任一校验不通过则整笔回滚

章节	讲什么	什么时候看
01 · 项目与接入概览	项目边界、ERC-3643 差异、接入层次和公开环境	第一次接触时先看
02-核心概念	ONCHAINID、Claim、Topic、可信签发机构、身份注册表、合规规则等名词到底指什么	看不懂术语时回来查
03 · 系统架构与角色	合约分层、共享范围、参与方职责和代理地址	理解系统组织方式时看
04 · 完整业务流程	发行、准入、增发、转账和销毁的完整流程与校验	实际接入前看
05 · 合约接口与事件	合约方法、事件、调用示例和最小 ABI	编码时查阅
06 · 环境配置与验收	测试网与 BOT 主网配置、公开样例和验收清单	联调与验收时看

推荐阅读路径：

最短阅读路径：本页 → 04 · 完整业务流程 → 06 · 环境配置与验收。