01 · 프로젝트 및 연동 개요
이 매뉴얼은 BOT Chain에서 RWA 자산을 조회, 연동 또는 발행하려는 개발자를 위한 문서입니다. RWA나 ERC-3643을 처음 접한다면 이 장부터 번호 순서대로 읽으십시오.
1.1 1분 안에 이해하는 Project RWA
Project RWA는 ERC-3643 기반의 규제 자산 발행 및 유통 인프라입니다.
ERC-20의 잔액, 승인, 전송 기능을 유지하면서 다음 두 가지 온체인 검사를 추가합니다.
- 자산을 받는 지갑이 해당 자산의 투자자 자격 요건을 충족하는지 검사합니다.
- mint 또는 전송이 해당 자산에 설정된 거래 규칙을 준수하는지 검사합니다.
Project RWA는 온체인 지분, 신원, 자격, 거래 규칙을 관리합니다. 기초 자산의 진위, 법률 문서, 수탁, 가치평가, 상환은 자산 발행자와 관련 전문기관이 계속 책임집니다.
1.2 ERC-3643과 일반 ERC-20의 차이
ERC-3643은 신원 검증과 컴플라이언스 검사를 포함하는 ERC-20 발행 프레임워크입니다. 수익률이나 가치평가를 정의하는 프로토콜이 아닙니다.
| 기능 | 일반 ERC-20 | ERC-3643 |
|---|---|---|
| 수신자 | 일반적으로 모든 주소 | 자산 자격 검사를 통과해야 함 |
| 전송 규칙 | 주로 잔액과 allowance 검사 | 국가, 한도, 락업 등의 규칙도 검사 가능 |
| 관리 작업 | 일반적으로 mint와 burn | pause, freeze, 강제 이전, 지갑 복구 지원 |
| 신원 | 포함하지 않음 | ONCHAINID와 Claim으로 자격을 표현 |
| 규칙 변경 | 일반적으로 Token 변경 또는 교체 | 자격 설정과 컴플라이언스 모듈 조정 가능 |
애플리케이션은 Token을 ERC-20처럼 읽을 수 있지만 잔액이 충분하더라도 전송이 항상 성공하는 것은 아닙니다.
1.3 자산 하나가 동작하는 과정
다음 다섯 개 객체를 먼저 이해하십시오.
Token: 자산 지분을 나타냅니다.ONCHAINID: 투자자의 온체인 신원을 나타냅니다.Claim: 기관이 서명한 자격 결론을 나타냅니다.IdentityRegistry: 지갑이 특정 자산을 보유할 수 있는지 판단합니다.ModularCompliance: 거래가 규칙을 준수하는지 판단합니다.
각 객체는 02장에서 설명합니다.
1.4 Project RWA가 제공하는 기능
모든 개발자가 사용 가능
- 자산 이름, 심볼, 총공급량, 지갑 잔액 조회.
- 지갑의 해당 자산 보유 자격 조회.
- 자산이 요구하는 Claim Topic과 승인된 ClaimIssuer 조회.
- pause, freeze, 컴플라이언스 설정 읽기.
- mint, burn, transfer, 신원 등록 이벤트 모니터링.
- 적격 Token 보유자의 전송 실행.
투자자가 수행 가능
- 본인 지갑으로 ONCHAINID 생성.
- 자격 기관이 서명한 Claim을 본인의 ONCHAINID에 기록.
- 본인의 신원, 자격, 자산 상태 조회.
transfer,approve같은 보유자 작업 실행.
권한을 가진 발행자가 수행 가능
- 새로운 ERC-3643 자산 Suite 발행.
- 투자자 신원 등록 또는 갱신.
- mint, burn, pause, freeze, 강제 이전.
- 자산의 자격 요건과 거래 규칙 설정.
권한 작업은 해당 Owner 또는 Agent가 수행해야 합니다. 공개 애플리케이션은 트랜잭션을 구성할 수 있지만 이 역할들의 개인 키를 보관해서는 안 됩니다.
1.5 Project RWA의 책임 범위 밖
온체인 컨트랙트만으로 실물 자산의 존재를 증명할 수 없으며 다음 업무를 대체하지 않습니다.
- 법적 소유권과 발행 문서.
- 자산 수탁, 감사, 가치평가.
- KYC/AML 원본 자료 심사.
- 법정화폐 결제와 실물 자산 상환.
- 발행자 관할권의 규제 의무.
온체인 mint 성공은 지분 발행을, burn 성공은 지분 소각을 의미합니다. 실물 자산 인도 또는 자금 결제는 별도로 확인해야 합니다.
1.6 세 가지 연동 수준
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 ID | RPC | 용도 |
|---|---|---|---|
| Bohr Testnet | 968 | https://rpc.bohr.life | 개발 및 연동 테스트 |
| BOT Mainnet | 677 | https://rpc.botchain.ai | 메인넷 기능 데모 |
두 환경의 주소, 잔액, 신원, Claim은 완전히 독립적입니다.
BOT Mainnet에 공개된 PRWA는 기술 기능 데모 자산입니다. Country Allowlist 모듈은 프로덕션 감사를 완료하지 않았고 실물 자산 권리를 나타내지 않으며 실제 자산을 직접 수용해서는 안 됩니다.
1.9 읽기 순서
| 장 | 해결하는 질문 |
|---|---|
| 01 · 프로젝트 및 연동 개요 | 프로젝트의 목적과 연동 수준 |
| 02 · 핵심 개념 | Token, 신원, Claim, 자격, 규칙의 의미 |
| 03 · 시스템 아키텍처 및 역할 | 컨트랙트 계층, 공유 범위, 책임 |
| 04 · 전체 비즈니스 프로세스 | 발행, 온보딩, mint, transfer, burn의 과정 |
| 05 · 컨트랙트 인터페이스 및 이벤트 | 호출할 메서드와 모니터링할 이벤트 |
| 06 · 환경 구성 및 인수 검증 | 공개 주소, 실행 예제, 인수 체크리스트 |
1.10 개발 전 점검
- 대상 환경과 Chain ID를 확인합니다.
- 06장에서 대상 자산의 프록시 주소를 가져옵니다.
- ethers.js, web3.js 또는 다른 EVM 클라이언트를 사용합니다.
- 읽기 전용 작업과 지갑 서명이 필요한 작업을 구분합니다.
- Token의
decimals를 동적으로 읽습니다. - KYC 평문 자료를 온체인에 저장하지 않습니다.
- 개인 키를 프런트엔드, 저장소 또는 로그에 넣지 않습니다.
- 트랜잭션 영수증을 기다린 후 최종 비즈니스 상태를 갱신합니다.