跳到主要内容

01 · 项目与接入概览

本手册面向希望在 BOT Chain 上查询、集成或发行 RWA 资产的开发者。第一次接触 RWA 或 ERC-3643 时，请从本章开始并按编号阅读。

1.1 一分钟理解 Project RWA​

Project RWA 是一套基于 ERC-3643 的受监管资产发行与流转基础设施。

它保留 ERC-20 的余额、授权和转账能力，同时增加两道链上检查：

  1. 接收资产的钱包是否满足该资产的投资者资格；
  2. 增发或转账是否符合该资产配置的交易规则。

Project RWA 负责链上的份额、身份、资格和交易规则。底层资产真实性、法律文件、托管、估值和兑付仍由资产发行方及相关专业机构负责。

1.2 ERC-3643 与普通 ERC-20 的区别​

ERC-3643 不是收益或估值协议，而是带身份验证和合规检查的 ERC-20 发行框架。

能力普通 ERC-20ERC-3643
接收方通常任何地址均可接收接收方必须通过资产资格检查
转账规则主要检查余额和授权还可检查国家、额度、锁定期等规则
管理操作通常只有增发和销毁支持暂停、冻结、强制转移和钱包恢复
身份不包含通过 ONCHAINID 和 Claim 表达资格
规则调整通常修改或更换 Token可调整资格配置和合规模块

因此，应用可以像 ERC-20 一样读取 Token，但不能假设“余额足够就一定能转账”。

1.3 一项资产如何运行​

先记住五个对象：

  • Token：表示资产份额；
  • ONCHAINID：表示投资者链上身份；
  • Claim：表示机构签名的资格结论；
  • IdentityRegistry：判断钱包能否持有某项资产；
  • ModularCompliance：判断一笔交易是否符合规则。

这些对象会在第 02 章逐一解释。

1.4 Project RWA 提供的能力​

所有开发者均可使用​

  • 查询资产名称、代号、总量和钱包余额；
  • 查询钱包是否具备某项资产的持有资格；
  • 查询资产要求的 Claim Topic 和认可的 ClaimIssuer；
  • 读取暂停、冻结和合规配置；
  • 监听增发、销毁、转账和身份登记事件；
  • 由合格 Token 持有人发起转账。

投资者可以完成​

  • 使用自己的钱包创建 ONCHAINID；
  • 将资格机构签名的 Claim 写入自己的 ONCHAINID；
  • 查询自己的身份、资格和资产状态；
  • 发起 transfer、approve 等持有人操作。

获授权发行方可以完成​

  • 发行新的 ERC-3643 资产 Suite；
  • 登记或更新投资者身份；
  • 增发、销毁、暂停、冻结和强制转移；
  • 配置资产要求的资格和交易规则。

权限操作必须由相应 Owner 或 Agent 完成。公开应用可以构造交易，但不应持有这些角色的私钥。

1.5 Project RWA 不负责什么​

链上合约不能独立证明现实资产真实存在，也不能替代：

  • 法律权属和发行文件；
  • 资产托管、审计和估值；
  • KYC/AML 原始材料审核；
  • 法币收付和现实资产兑付；
  • 发行方所在司法辖区的监管义务。

链上 mint 成功只代表份额已经增发；链上 burn 成功只代表份额已经销毁。现实资产交割或资金兑付必须另行确认。

1.6 三种接入深度​

第一层：只读数据​

适合钱包、区块浏览器、资产看板和报表系统。

最少需要：

Chain ID
RPC
Token 地址
IdentityRegistry 地址

完成标准：

  • 能读取 name、symbol、decimals 和 totalSupply；
  • 能查询钱包余额；
  • 能查询 isVerified(wallet)；
  • 能正确解析 Transfer 事件。

第二层：投资者接入​

适合投资者门户、申购应用和交易应用。除只读能力外，还需要组织：

创建 ONCHAINID
→ 链下资格审核
→ 提交已签名 Claim
→ 等待发行方登记
→ 查询最终资格
→ 发起合规转账

这些步骤由投资者、资格签发机构和资产发行方共同完成，不是一个接口可以独立完成。

第三层：资产发行与管理​

适合希望在 Project RWA 上发行资产的项目方。发行前需要确定：

  • 资产名称、代号、精度和现实权益；
  • 投资者必须满足哪些 Claim Topic；
  • 认可哪些 ClaimIssuer；
  • 使用哪些国家、额度或锁定规则；
  • Owner、Token Agent 和 IR Agent 地址；
  • 测试、主网和上线验收方案。

发行方通过平台准入后，获得一套独立的 Token 和配套合约。

1.7 最小接入边界​

只做资产展示时，不需要连接 Factory、Gateway 治理或升级合约。始终使用完成目标所需的最少地址和 ABI。

1.8 公开环境​

环境Chain IDRPC用途
Bohr Testnet968https://rpc.bohr.life开发和联调
BOT Mainnet677https://rpc.botchain.ai主网能力演示

两个环境中的地址、余额、身份和 Claim 完全独立。

BOT 主网当前公开的 PRWA 是技术能力演示资产，其 Country Allowlist 模块未经过生产审计，不代表真实资产权益，也不得直接用于承载真实资产。

1.9 阅读顺序​

章节解决的问题
01 · 项目与接入概览项目是什么、可以接入到什么程度
02 · 核心概念Token、身份、Claim、资格和规则分别是什么
03 · 系统架构与角色合约如何分层、哪些共享、谁负责什么
04 · 完整业务流程发行、准入、增发、转账和销毁如何发生
05 · 合约接口与事件编码需要调用哪些方法、监听哪些事件
06 · 环境配置与验收公开地址、运行示例和验收清单

1.10 开发前检查​

  1. 确认目标环境和 Chain ID；
  2. 从第 06 章取得目标资产代理地址；
  3. 使用 ethers.js、web3.js 或其他 EVM 客户端；
  4. 明确哪些操作只读、哪些需要钱包签名；
  5. 动态读取 Token 的 decimals；
  6. KYC 明文资料不上链；
  7. 私钥不进入前端、代码仓库或日志；
  8. 等待交易回执后再更新业务最终状态。

继续阅读：02 · 核心概念