01 · Panorama del proyecto y la integración
Este manual está dirigido a desarrolladores que desean consultar, integrar o emitir activos RWA en BOT Chain. Si es su primer contacto con RWA o ERC-3643, empiece por este capítulo y siga el orden numérico.
1.1 Project RWA en un minuto
Project RWA es una infraestructura de emisión y transferencia de activos regulados basada en ERC-3643.
Conserva saldos, autorizaciones y transferencias de ERC-20, y añade dos comprobaciones en cadena:
- si la cartera receptora cumple los requisitos de elegibilidad del activo;
- si una emisión o transferencia cumple las reglas configuradas para el activo.
Project RWA gestiona participaciones, identidades, cualificaciones y reglas en cadena. El emisor y las instituciones profesionales siguen siendo responsables de la autenticidad del activo subyacente, la documentación legal, custodia, valoración y reembolso.
1.2 ERC-3643 frente a ERC-20
ERC-3643 es un marco de emisión ERC-20 con identidad y cumplimiento. No define rentabilidad ni valoración.
| Capacidad | ERC-20 común | ERC-3643 |
|---|---|---|
| Receptor | Normalmente cualquier dirección | Debe superar la elegibilidad del activo |
| Reglas de transferencia | Saldo y autorización | También país, límites, bloqueo y otras reglas |
| Administración | Normalmente mint y burn | Pausa, congelación, transferencia forzada y recuperación |
| Identidad | No incluida | ONCHAINID y Claims |
| Ajuste de reglas | Modificar o sustituir Token | Ajustar cualificaciones y módulos |
Una aplicación puede leer el Token como ERC-20, pero un saldo suficiente no garantiza una transferencia.
1.3 Funcionamiento de un activo
Cinco objetos fundamentales:
Token: participaciones del activo;ONCHAINID: identidad en cadena del inversor;Claim: conclusión de elegibilidad firmada;IdentityRegistry: decide si una cartera puede mantener el activo;ModularCompliance: decide si una operación cumple las reglas.
El capítulo 02 los explica en detalle.
1.4 Capacidades de Project RWA
Para todos los desarrolladores
- Consultar nombre, símbolo, oferta y saldo;
- Consultar elegibilidad;
- Consultar Topics requeridos y ClaimIssuers reconocidos;
- Leer pausa, congelación y cumplimiento;
- Escuchar mint, burn, transferencias y registros;
- Permitir transferencias iniciadas por titulares elegibles.
Para inversores
- Crear ONCHAINID con su cartera;
- Escribir un Claim firmado en su ONCHAINID;
- Consultar identidad, cualificación y activo;
- Ejecutar
transfer,approvey otras operaciones de titular.
Para emisores autorizados
- Emitir una Suite ERC-3643;
- Registrar o actualizar identidades;
- Acuñar, quemar, pausar, congelar y forzar transferencias;
- Configurar cualificaciones y reglas.
Las operaciones privilegiadas corresponden al Owner o Agent. Una aplicación pública puede construir transacciones, pero no debe custodiar sus claves privadas.
1.5 Límites de Project RWA
Los contratos no prueban por sí solos la existencia del activo real ni sustituyen:
- título legal y documentos de emisión;
- custodia, auditoría y valoración;
- revisión de materiales KYC/AML;
- cobros fiat y reembolso real;
- obligaciones regulatorias del emisor.
Un mint correcto solo confirma la emisión en cadena; un burn correcto solo confirma la destrucción. La entrega o liquidación real se confirma por separado.
1.6 Tres niveles de integración
Nivel 1: solo lectura
Para carteras, exploradores, paneles e informes.
Chain ID
RPC
Dirección Token
Dirección IdentityRegistry
Criterios: leer name, symbol, decimals, totalSupply, saldo, isVerified(wallet) y eventos Transfer.
Nivel 2: integración del inversor
Para portales, suscripción y negociación:
Crear ONCHAINID
→ Revisión fuera de cadena
→ Enviar Claim firmado
→ Esperar registro del emisor
→ Consultar elegibilidad final
→ Iniciar transferencia conforme
Inversor, institución y emisor completan el proceso conjuntamente.
Nivel 3: emisión y gestión
Antes de emitir, defina:
- nombre, símbolo, precisión y derecho real;
- Topics obligatorios;
- ClaimIssuers reconocidos;
- reglas de país, límites o bloqueo;
- direcciones Owner, Token Agent e IR Agent;
- planes de test, mainnet y aceptación.
Tras la admisión, el emisor recibe un Token y contratos independientes.
1.7 Límite mínimo de integración
Una aplicación de visualización no necesita Factory, gobernanza de Gateway ni contratos de actualización. Use solo las direcciones y ABI necesarias.
1.8 Entornos públicos
| Entorno | Chain ID | RPC | Uso |
|---|---|---|---|
| Bohr Testnet | 968 | https://rpc.bohr.life | Desarrollo e integración |
| BOT Mainnet | 677 | https://rpc.botchain.ai | Demostración de capacidades |
Direcciones, saldos, identidades y Claims son independientes.
El PRWA público de BOT Mainnet es un activo de demostración técnica. Su módulo Country Allowlist no ha superado una auditoría de producción, no representa derechos reales y no debe utilizarse para activos reales.
1.9 Orden de lectura
| Capítulo | Contenido |
|---|---|
| 01 · Panorama del proyecto y la integración | Proyecto y niveles de integración |
| 02 · Conceptos fundamentales | Token, identidad, Claim, elegibilidad y reglas |
| 03 · Arquitectura del sistema y roles | Capas, elementos compartidos y responsabilidades |
| 04 · Procesos de negocio completos | Emisión, onboarding, mint, transferencia y burn |
| 05 · Interfaces y eventos de contratos | Métodos y eventos |
| 06 · Configuración de entornos y aceptación | Direcciones, ejemplos y aceptación |
1.10 Antes de desarrollar
- Confirme entorno y Chain ID;
- Obtenga el proxy del activo en el capítulo 06;
- Use ethers.js, web3.js u otro cliente EVM;
- Distinga lectura y firma;
- Lea
decimalsdinámicamente; - Mantenga KYC en texto claro fuera de cadena;
- Mantenga claves fuera del frontend, repositorio y logs;
- Espere el recibo antes de actualizar el estado final.