En esta página
Las integraciones de ROC deben contemplar dos buckets de colateral y un token USDRIF compartido. Parte de la implementación y las interfaces de contratos actuales, en lugar de un ejemplo anterior de colateral único. Un bucket es un compartimento contable del protocolo para un activo de colateral.
Lee la arquitectura
El repositorio del protocolo contiene módulos de despliegue, contratos y pruebas sobre forks de la actualización multicolateral. El whitepaper explica el modelo económico y los roles de los buckets de RIF y DOC y del Multi Collateral Guard.
RIF y DOC son activos de colateral (AC); USDRIF es el token vinculado al dólar (TP). RIFPRO (RIFP en la dApp) es el token de colateral o residual (TC) del bucket de RIF. No asumas que los buckets tienen parámetros u operaciones idénticos.
El Multi Collateral Guard coordina los buckets y los procedimientos de estabilización. Cada bucket contabiliza su colateral y sus obligaciones en USDRIF; el guard coordina acciones del sistema sin crear un segundo token USDRIF. La cobertura compara el valor del colateral con las obligaciones en stablecoins. La cobertura requerida y los controles de volumen reciente determinan si una operación es admisible.
Verifica la implementación
Confirma la red, la versión, las direcciones, el ABI y los decimales a partir de los artefactos del despliegue correspondiente y los contratos verificados. Evita copiar direcciones de capturas, tickers u otras redes. La gobernanza puede actualizar implementaciones y parámetros.
Verifica que las operaciones que integras estén disponibles en la interfaz utilizada. Esta guía cubre la emisión y redención de USDRIF con RIF o DOC, las operaciones con RIFP y las operaciones combinadas con RIF.
Modela el ciclo de la operación
Distingue en tu aplicación la aprobación, el envío, la entrada en la cola y la ejecución final. Registra los identificadores de operación y los eventos de ejecución; no marques una solicitud como completada sólo por el recibo de envío.
En una emisión combinada, contempla ambas salidas y el colateral total de entrada. En una redención combinada, contempla ambos tokens requeridos y sus límites de gasto autorizados (allowances). Maneja explícitamente el colateral máximo, las salidas mínimas, las comisiones, los costos de ejecución en rBTC y los errores.
Utiliza las restricciones actuales
Cotiza contra el estado del bucket elegido. La cobertura, las obligaciones atribuidas en USDRIF y los controles de volumen pueden limitar las operaciones. Una cifra global disponible para mintear o redimir no reemplaza la validación de cada operación.
Consulta las pruebas sobre forks de emisión y redención del bucket de DOC y de emisión combinada con RIF; luego prueba contra el entorno elegido. Las pruebas demuestran comportamiento del contrato, pero no establecen que una dirección o parámetro siga vigente para tu implementación.
Referencia de operaciones
| Flujo | Entradas | Salidas |
|---|---|---|
| Emisión del bucket RIF | RIF | USDRIF o RIFP |
| Redención del bucket RIF | USDRIF o RIFP | RIF |
| Emisión del bucket DOC | DOC | USDRIF |
| Redención del bucket DOC | USDRIF | DOC |
| Emisión / redención combinada con RIF | RIF / RIFP + USDRIF | USDRIF + RIFP / RIF |
USDRIF es un único token fungible. El monto redimible depende de las obligaciones en USDRIF y la cobertura del bucket elegido, no del origen de emisión de los tokens del usuario. El valor residual pertenece al TC del bucket después de contabilizar las obligaciones en TP.
Una integración necesita una wallet (billetera) o firmante en la red elegida, saldos de entrada suficientes y rBTC para ejecución. Lee el estado actual, calcula la cotización y sus límites, comprueba los límites de gasto autorizados (allowances) para cada entrada ERC-20, envía las aprobaciones faltantes y luego la operación. Registra su identificador, sigue la cola y el recibo de ejecución, maneja una ejecución fallida y actualiza los saldos después del resultado final. Una redención combinada requiere dos saldos y posiblemente dos límites de gasto autorizados.
Por ejemplo, DOC → USDRIF consume colateral DOC y produce USDRIF. La inversa consume USDRIF y devuelve DOC de ese bucket. La emisión combinada con RIF consume el RIF total cotizado y produce USDRIF y RIFP juntos; su inversa consume ambos tokens. Son flujos de emisión y redención del protocolo, no un puente ni un swap contra un pool externo.