Skip to main content

Source code

查看 RWAToken 合约源码
RWAToken 不是一个只负责记账的普通 ERC-20。从系统角色上看，它负责两件事情：
  • 作为 RWA 份额的链上代币载体，记录余额、转账和销毁。
  • 作为一级销售入口，在销售窗口内接收 USDT 并按规则铸造代币给买方。
本合约的业务目标是面向受控发行的 RWA 场景。设计重点是“可发行、可限制、可恢复、可升级”。核心职责包括：
  • 在初始化时完成代币参数、托管钱包、USDT 地址和合规模块地址的绑定。
  • 按固定总上限管理代币供给，部署时把保留份额直接铸造给 custodyWallet。
  • 通过 mint() 承接一级销售，买家在支付 USDT 之前需通过外部合规签名校验。
  • 在转账路径上联动 ComplianceManage，对黑名单地址进行限制。
  • 为运营与合规处理预留强制转账、回收代币和更新时间锁等管理能力。
RWAToken 依赖以下外部组件：
  • USDT：一级销售的支付资产。
  • ComplianceManage：外部合规服务合约，负责黑名单、签名校验等。
  • ArtStarERC1967Proxy：部署时承载代理状态的外层代理合约。
Hardhat Ignition 会先部署实现合约，再通过代理传入编码后的 initialize() 数据完成初始化，随后把代理地址注册到 ComplianceManage 的 verifiedTokens 中。
保留了标准代币接口，在转账和铸造路径上叠加了更多业务限制。使用 SafeERC20 把 transferFrom 和 transfer 包装为更稳健的调用，降低交互风险。
本合约围绕三个核心不变量组织状态：
  • TOTAL_SUPPLY_CAP = 10,000,000 * 1e18
  • RESERVED_AMOUNT = 2,000,000 * 1e18
  • SALE_CAP = TOTAL_SUPPLY_CAP - RESERVED_AMOUNT
200 万枚在初始化时直接铸造给 custodyWallet，剩余 800 万枚作为一级销售可出售上限。其他关键状态：
  • sold：已售出的一级销售代币总量。
  • priceUSDT / minPurchaseUSDT / maxPurchaseUSDT：销售定价和认购范围。
  • saleActive / saleStartTime / saleEndTime：销售开关与时间窗。
  • unlockTime：转账解锁时间，0 表示不锁定。
  • assetInfo：底层资产元数据 URI、估值和最近估值更新时间。
initialize() 需要传入代币名称符号、初始 owner、custodyWallet、USDT 地址和 ComplianceManage 地址。流程包括：
  1. 调用内部的 init 函数。
  2. 校验外部依赖地址不为零地址并保存引用。
  3. 把 RESERVED_AMOUNT 直接铸造到 custodyWallet。
链上真正对外暴露的入口是代理地址。
一级销售典型认购流程如下：
1

运营配置

owner 设置价格、认购额限制，设置时间窗并调用 startSale()。
2

买家认购

买家提交 amountUSDT、签名和过期时间。
3

合规校验

合约校验时间窗、单笔限额和硬顶，并通过 ComplianceManage 验证买家授权。
4

支付与铸造

校验通过后，从买家账户把 USDT 转入 custodyWallet。合约更新状态，向买家铸造代币。
RWAToken 把合规授权外包给 ComplianceManage，代币逻辑和合规逻辑分层，但一级销售的可用性依赖外部合规合约状态。
本合约通过重写 _update() 把多个限制统一放到状态变更入口中：
  • 暂停约束：系统暂停时，普通转账和一级销售（mint）都会被拒绝。
  • 锁仓约束：unlockTime != 0 且未到解锁时间时，普通转账会被拒绝。
  • 黑名单约束：发送方或接收方在 ComplianceManage 中被标记为黑名单时，普通转账被拒绝。
owner 拥有显著的运营权限，主要包括：
  • 配置价格和认购上下限、时间窗及销售开关。
  • 设置或紧急清除转账锁定时间。
  • 暂停和恢复整套代币系统。
  • 强制转账 forcedTransfer()、销毁 burn()、回收资产 recoverTokens() 等。
  • 更新底层资产信息 updateAssetInfo()。
这些能力提高了可运营性，但也表明该代币带有明确治理与合规介入入口，并非完全去中心化的自由流通资产。
assetInfo 保存底层资产的 metadataURI 和估值信息。估值真实性完全依赖 owner 更新。恢复类函数体现了对实际运营场景的考虑：
  • recoverTokens()：回收误转入的任意 ERC-20。
  • recoverUnsoldTokens()：销售结束后，将剩余可售额度一次性铸造到托管钱包。
  • forcedTransfer()：在合规或纠纷处理场景下强制移动代币。
升级注意事项
  • 代理地址不变，状态保留在代理中。
  • 只有 owner 可调用 _authorizeUpgrade()。
  • 新实现必须与旧版本保持存储布局兼容。
审计关注点
  • 合规依赖：依赖 ComplianceManage 的正确配置。
  • 权限集中：高权限操作需配套安全的密钥管理。
  • 价格换算：priceUSDT 的精度与换算必须严格统一。