メインコンテンツまでスキップ

01 · プロジェクトと統合の概要

本マニュアルは、BOT Chain 上の RWA 資産を照会、統合、発行する開発者向けです。RWA または ERC-3643 を初めて扱う場合は、本章から番号順に読んでください。

1.1 Project RWA を 1 分で理解する​

Project RWA は、ERC-3643 に基づく規制対象資産の発行・流通インフラです。

ERC-20 の残高、承認、送金機能を維持しながら、次の 2 つのオンチェーン検査を追加します。

  1. 受取ウォレットが対象資産の投資家適格要件を満たしているか。
  2. mint または送金が対象資産に設定された取引ルールに適合しているか。

Project RWA はオンチェーンの持分、ID、適格性、取引ルールを管理します。原資産の真正性、法的文書、カストディ、評価、償還は、資産発行者および関連専門機関が引き続き責任を負います。

1.2 ERC-3643 と通常の ERC-20 の違い​

ERC-3643 は、本人確認とコンプライアンス検査を備えた ERC-20 発行フレームワークです。利回りや評価額を定義するプロトコルではありません。

機能通常の ERC-20ERC-3643
受取人通常は任意のアドレス資産の適格性検査に合格する必要がある
送金ルール主に残高と allowance を検査国、上限、ロックアップなども検査可能
管理操作通常は mint と burnpause、freeze、強制移転、ウォレット復旧に対応
ID含まれないONCHAINID と Claim で適格性を表現
ルール変更通常は Token の変更または置換適格性設定とコンプライアンスモジュールを調整可能

アプリケーションは Token を ERC-20 と同様に読み取れますが、残高が十分でも送金が成功するとは限りません。

1.3 1 つの資産が動作する流れ​

最初に次の 5 つを把握してください。

  • Token：資産持分を表す。
  • ONCHAINID：投資家のオンチェーン ID を表す。
  • Claim：機関が署名した適格性判断を表す。
  • IdentityRegistry：ウォレットが特定資産を保有できるかを判定する。
  • ModularCompliance：取引がルールに適合するかを判定する。

各オブジェクトは第 02 章で説明します。

1.4 Project RWA が提供する機能​

すべての開発者が利用可能​

  • 資産名、シンボル、総供給量、ウォレット残高の照会。
  • ウォレットが対象資産を保有する資格を持つかの照会。
  • 資産が要求する Claim Topic と承認済み ClaimIssuer の照会。
  • pause、freeze、コンプライアンス設定の読み取り。
  • mint、burn、transfer、ID 登録イベントの監視。
  • 適格な Token 保有者による送金。

投資家が実行可能​

  • 自分のウォレットで ONCHAINID を作成。
  • 適格性機関が署名した Claim を自分の ONCHAINID に書き込み。
  • 自分の ID、適格性、資産状態を照会。
  • transfer、approve などの保有者操作を開始。

権限を持つ発行者が実行可能​

  • 新しい ERC-3643 資産 Suite を発行。
  • 投資家 ID を登録または更新。
  • mint、burn、pause、freeze、強制移転。
  • 資産の適格要件と取引ルールを設定。

権限操作は対応する Owner または Agent が実行します。公開アプリケーションはトランザクションを構築できますが、これらのロールの秘密鍵を保持してはいけません。

1.5 Project RWA の責任範囲外​

オンチェーンコントラクトだけでは現実資産の実在を証明できず、次の業務を代替しません。

  • 法的権原と発行文書。
  • 資産のカストディ、監査、評価。
  • KYC/AML 原資料の審査。
  • 法定通貨決済と現実資産の償還。
  • 発行者の法域における規制義務。

オンチェーンの mint 成功は持分発行を、burn 成功は持分消却を示します。現実資産の引渡しまたは資金決済は別途確認が必要です。

1.6 3 段階の統合レベル​

第 1 段階：読み取り専用データ​

ウォレット、ブロックエクスプローラー、資産ダッシュボード、レポートシステム向けです。

最低限必要な情報：

Chain ID
RPC
Token アドレス
IdentityRegistry アドレス

完了基準：

  • name、symbol、decimals、totalSupply を読み取れる。
  • ウォレット残高を照会できる。
  • isVerified(wallet) を照会できる。
  • Transfer イベントを正しく解析できる。

第 2 段階：投資家統合​

投資家ポータル、申込アプリ、取引アプリ向けです。読み取り機能に加えて、次の工程を連携します。

ONCHAINID を作成
→ オフチェーン適格性審査
→ 署名済み Claim を提出
→ 発行者による登録を待機
→ 最終適格性を照会
→ コンプライアンスに適合する送金を開始

投資家、適格性発行機関、資産発行者が共同で完了します。単一のインターフェースだけで全工程は完結しません。

第 3 段階：資産発行と管理​

Project RWA で資産を発行するプロジェクト向けです。発行前に次を確定します。

  • 資産名、シンボル、decimals、対応する現実の権利。
  • 投資家が満たす 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メインネット機能デモ

2 環境のアドレス、残高、ID、Claim は完全に独立しています。

BOT Mainnet で公開中の PRWA は技術機能デモ用資産です。Country Allowlist モジュールは本番監査を完了しておらず、現実資産の権利を表さず、実資産を直接載せてはいけません。

1.9 読む順序​

章解決する問い
01 · プロジェクトと統合の概要プロジェクトの目的と統合レベル
02 · 主要概念Token、ID、Claim、適格性、ルールの意味
03 · システムアーキテクチャと役割コントラクトの階層、共有範囲、責任
04 · 完全なビジネスプロセス発行、オンボーディング、mint、transfer、burn の流れ
05 · コントラクトインターフェースとイベント呼び出すメソッドと監視するイベント
06 · 環境設定と受入検証公開アドレス、実行例、受入チェックリスト

1.10 開発前チェック​

  1. 対象環境と Chain ID を確認する。
  2. 第 06 章から対象資産のプロキシアドレスを取得する。
  3. ethers.js、web3.js、または他の EVM クライアントを使用する。
  4. 読み取り専用操作とウォレット署名が必要な操作を区別する。
  5. Token の decimals を動的に読み取る。
  6. KYC の平文資料をオンチェーンに保存しない。
  7. 秘密鍵をフロントエンド、リポジトリ、ログに入れない。
  8. トランザクションレシートを待ってから最終業務状態を更新する。

次へ：02 · 主要概念