RWA 개발 매뉴얼

이 프로젝트는 ERC-3643(T-REX) 표준을 기반으로 하는 실물자산(RWA) 발행 및 이전 시스템입니다. 한 문장으로 표현하면, 현실의 자산을 온체인 토큰으로 전환하고 적격 투자자만 보유하고 이전할 수 있게 합니다.

이 문서는 프로젝트를 처음 접하는 개발자를 위한 것입니다. 여섯 장을 순서대로 읽으면 시스템을 구성하는 컨트랙트, 자산 발행 방식, 투자자가 보유 자격을 얻는 방식, 토큰을 mint·burn하는 메서드, 온체인 결과 조회 방법을 설명할 수 있습니다.

1. 한눈에 보기

질문	답변
무엇인가요?	ERC-3643 기반의 자격 제한형 토큰 발행 시스템입니다
일반 토큰과 어떤 차이가 있나요?	일반 ERC-20은 잔액이 있으면 이전할 수 있습니다. 이 시스템은 수신자의 자격과 거래 규칙 준수도 요구합니다
토큰 호환성	ERC-20과 완전히 호환되며, 지갑과 거래소가 일반 토큰처럼 잔액을 읽고 `Transfer` 이벤트를 수신할 수 있습니다
하나의 자산을 구성하는 컨트랙트 수	여섯 개의 핵심 컨트랙트가 하나의 Suite를 이루며 팩토리에서 일괄 배포됩니다
사람의 자격을 판단하는 주체	`IdentityRegistry`
거래의 규정 준수를 판단하는 주체	`ModularCompliance`
자격 증명을 저장하는 위치	투자자 자신의 `ONCHAINID` 컨트랙트에 있는 Claim
신분증 이미지를 온체인에 저장하나요?	저장하지 않습니다. 특정 자격이 승인되었다는 결론만 저장합니다
환경	Bohr Testnet(Chain ID `968`)과 BOT Mainnet 기능 데모(Chain ID `677`)에 각각 독립된 `PRWA` Suite 배포

문서 전체를 관통하는 핵심 문장은 다음과 같습니다.

Token은 원장을 관리하고, IdentityRegistry는 사람의 자격을 판단하며, ModularCompliance는 거래의 규정 준수를 판단합니다.

자산 출시부터 투자자 보유까지 네 단계로 진행됩니다.

각 단계의 핵심 작업과 검증 가능한 결과:

단계	주요 호출	검증 가능한 결과
자산 발행	`TREXGateway.deployTREXSuite`	Token과 관련 컨트랙트 5개의 주소 획득
투자자 온보딩	`ONCHAINIDGateway.deployIdentityForWallet` → `Identity.addClaim` → `IdentityRegistry.registerIdentity`	`IdentityRegistry.isVerified(지갑)`이 `true` 반환
mint / burn	`Token.mint` / `Token.burn`	`Transfer` 이벤트가 발생하고 `balanceOf`가 변경
이전	`Token.transfer`	모든 검사를 통과하면 성공하며, 하나라도 실패하면 전체 트랜잭션이 revert

장	내용	읽는 시점
01 · 프로젝트 및 연동 개요	범위, ERC-3643 차이, 연동 수준, 공개 환경	처음 읽을 때
02 · 핵심 개념	ONCHAINID, Claim, Topic, 신뢰할 수 있는 발급자, 신원 레지스트리, 컴플라이언스 규칙의 의미	용어가 이해되지 않을 때
03 · 시스템 아키텍처 및 역할	계층, 책임, 참여자 역할, 안정적인 Proxy	시스템 구성 이해 시
04 · 전체 비즈니스 프로세스	발행, 온보딩, mint, 전송, burn	운영 전
05 · 컨트랙트 인터페이스 및 이벤트	메서드, 이벤트, 예시, 최소 ABI	개발 참조
06 · 환경 구성 및 인수 검증	Testnet 및 BOT Mainnet 구성, 공개 샘플, 인수 검증	연동 및 검증 시

권장 읽기 순서:

가장 짧은 경로는 이 페이지, 04 · 전체 비즈니스 프로세스, 06 · 환경 구성 및 인수 검증 순서입니다.