Manual de desarrollo de RWA
Este proyecto es un sistema de emisión y transferencia de activos del mundo real (RWA) basado en el estándar ERC-3643 (T-REX). En una frase: convierte un activo real en tokens en cadena y permite que solo los inversores elegibles los mantengan y transfieran.
Esta documentación está dirigida a desarrolladores que conocen el proyecto por primera vez. Después de leer los seis capítulos en orden, podrá explicar qué contratos componen el sistema, cómo se emite un activo, cómo obtiene un inversor la habilitación para mantenerlo, qué métodos acuñan y queman tokens y cómo consultar los resultados en cadena.
1. Vista rápida
| Pregunta | Respuesta |
|---|---|
| ¿Qué es? | Un sistema de emisión de tokens sujeto a requisitos de elegibilidad y basado en ERC-3643 |
| ¿En qué se diferencia de un token común? | Un ERC-20 común se transfiere cuando hay saldo; este sistema también exige un destinatario elegible y una operación conforme a las reglas |
| Compatibilidad del token | Totalmente compatible con ERC-20; las carteras y los exchanges pueden leer saldos y escuchar eventos Transfer de la forma habitual |
| ¿Cuántos contratos representan un activo? | Seis contratos principales forman una Suite y una fábrica los despliega conjuntamente |
| ¿Quién determina si una persona es elegible? | IdentityRegistry |
| ¿Quién determina si una operación cumple las reglas? | ModularCompliance |
| ¿Dónde se almacena la acreditación? | En Claims dentro del contrato ONCHAINID propio del inversor |
| ¿Se guardan imágenes de documentos de identidad en cadena? | No. La cadena solo almacena la conclusión de que se aprobó una determinada cualificación |
| Entornos | Bohr Testnet (Chain ID 968) y demostración en BOT Mainnet (Chain ID 677), cada uno con una Suite PRWA independiente |
La idea clave de toda la documentación es:
Token mantiene el libro contable, IdentityRegistry determina si una persona es elegible y ModularCompliance determina si una operación cumple las reglas.
2. Flujo principal del sistema
El recorrido desde el lanzamiento del activo hasta que un inversor lo mantiene tiene cuatro pasos:
Acción principal y resultado verificable de cada paso:
| Paso | Llamada principal | Resultado verificable |
|---|---|---|
| Emitir el activo | TREXGateway.deployTREXSuite | Se obtienen la dirección del Token y las de los otros cinco contratos |
| Incorporar al inversor | ONCHAINIDGateway.deployIdentityForWallet → Identity.addClaim → IdentityRegistry.registerIdentity | IdentityRegistry.isVerified(cartera) devuelve true |
| Acuñar o quemar | Token.mint / Token.burn | Se emite un evento Transfer y cambia balanceOf |
| Transferir | Token.transfer | La transferencia se completa cuando pasan todos los controles; cualquier fallo revierte toda la transacción |
3. Mapa de la documentación
| Capítulo | Contenido | Cuándo consultarlo |
|---|---|---|
| 01 · Panorama del proyecto y la integración | Alcance, diferencias de ERC-3643, niveles de integración y entornos públicos | Léalo primero |
| 02 · Conceptos fundamentales | Significado de ONCHAINID, Claim, Topic, emisor de confianza, registro de identidades y reglas de cumplimiento | Consúltelo cuando un término no esté claro |
| 03 · Arquitectura del sistema y roles | Capas, responsabilidades, roles y proxies estables | Para entender la organización del sistema |
| 04 · Procesos de negocio completos | Emisión, incorporación, acuñación, transferencia y quema | Antes de operar el sistema |
| 05 · Interfaces y eventos de contratos | Métodos, eventos, ejemplos y ABI mínimos | Como referencia de desarrollo |
| 06 · Configuración de entornos y aceptación | Configuración de testnet y BOT Mainnet, muestras públicas y aceptación | Para integrar y validar |
Orden de lectura recomendado:
La ruta más corta es esta página, 04 · Procesos de negocio completos y 06 · Configuración de entornos y aceptación.
4. Referencia rápida de entornos
Entorno de pruebas
| Elemento | Valor |
|---|---|
| Red | Bohr Testnet |
| Chain ID | 968 |
| RPC | https://rpc.bohr.life |
| Explorador de bloques | https://scan.bohr.life |
| Nombre del activo | Project Real World Asset |
| Símbolo del activo | PRWA |
| Decimales | 6 |
| Dirección del Token | 0x922835859623d6F3b99a2742D585E093bBA0a740 |
| Dirección de IdentityRegistry | 0x17e33C394Ab783D6786011d01681D8Ad540C5F53 |
| ONCHAINID Gateway | 0x3B0FE2CD501534cbcbD1F97ec823Da535fc0224f |
Demostración de capacidades en BOT Mainnet
| Elemento | Valor |
|---|---|
| Red | BOT Chain Mainnet |
| Chain ID | 677 |
| RPC | https://rpc.botchain.ai |
| Explorador | https://scan.botchain.ai |
| Dirección del Token | 0x9115A020821fDFdf265Eea8788a500d17557c370 |
| IdentityRegistry | 0x7752dd107CDec2dF5feD585BCC70457c5312021a |
| ONCHAINID Gateway | 0xa6B4E53128915E0f980DD455De9F70B6Dc61E1ee |
Consulte 06 · Configuración de entornos y aceptación y la Tabla de direcciones RWA para la configuración completa.
5. Referencias
- Sitio oficial de ERC-3643: https://www.erc3643.org/
- Documentación de Tokeny sobre finanzas en cadena: https://docs.tokeny.com/docs/what-is-onchain-finance
- Estándar de identidad ONCHAINID, basado en ERC-734 y ERC-735: https://www.onchainid.com/