Participantes

• Usuario
• Fireblocks
• Gate (Módulo OES)

1. Proceso de Inicialización del Workspace

(Gestionado por Usuario y Fireblocks)

Paso 1. El usuario contacta con Fireblocks – Solicitud de creación de un Workspace

El usuario envía una solicitud a Fireblocks, y Fireblocks crea un nuevo workspace para el usuario.

Paso 2. Fireblocks configura el Workspace como un Workspace OES

Fireblocks configura el workspace para que sea compatible con el modo OES de Gate y habilita las capacidades necesarias como Delegar, Retirar delegación, Pago de comisiones de gas, etc.

Paso 3. El usuario genera una clave API en Gate

El usuario inicia sesión en la plataforma de Gate y genera una clave API específicamente para Fireblocks.
Requisitos:

• Debe ser creada por la cuenta principal de Gate.

• La cuenta principal (incluidas todas las subcuentas) debe cumplir ambas condiciones:

• Sin posiciones abiertas

• Saldo cero

Paso 4. El usuario vincula la clave API de Gate al Workspace de Fireblocks

El usuario regresa a Fireblocks y vincula la clave API de Gate en la configuración del Workspace.
Después de este paso, Fireblocks puede interactuar con Gate en nombre del usuario (delegar, liquidar, etc.).

Paso 5. El usuario comienza a delegar cada moneda soportada (inicia la creación de la wallet en Gate)

El usuario delega cada moneda de liquidación soportada por Fireblocks.
Acciones de delegación:

• Dispara una solicitud Fireblocks → Gate
• Gate genera automáticamente una dirección de wallet mapeada para ese activo

Notas:

• Es probable que el primer intento de delegación falle (la wallet aún no está inicializada) → Este error puede ignorarse
• Espere ~10 minutos, luego delegue de nuevo para tener éxito
• Cada activo de liquidación soportado debe delegarse al menos una vez para activar la wallet

Depósitos del Usuario y Colateral para Gas Fee (Garantía)

En el modelo OES tradicional, ambas partes deben depositar colaterales de varios millones de dólares en las wallets de la otra parte.
En el modo OES de autocustodia de Fireblocks:

• Gate no requiere que el usuario deposite un gran colateral en Gate.

• El usuario debe mantener el equivalente a 100 USDT en activos de la cadena principal dentro de su propio Workspace de Fireblocks. (delegar a Gate)

• Gate congelará esta pequeña cantidad para cubrir las comisiones de gas de las liquidaciones.

• Los activos permanecen totalmente bajo autocustodia dentro de Fireblocks y nunca salen del workspace.

• El usuario debe mantener el equivalente a 50 USDT en activos de la cadena principal dentro de su propio Workspace de Fireblocks. (sin delegarlo a Gate)

• En total, se necesitan 150 USDT de colateral en la cadena principal

Ventaja: El requisito de colateral baja de millones → ~cientos de USDT.

Detalles de Activos en la Cadena Principal

① El usuario deposita activos de la cadena principal en el Workspace de Fireblocks

Cada cadena de liquidación debe tener su moneda principal correspondiente.
Ejemplos:

• ERC → ETH
• BRC → BTC
• Solana → SOL
• Tron → TRX

② Delegar el importe equivalente a 100 USDT en monedas de la cadena principal a Gate

Gate congelará automáticamente esta cantidad como colateral para comisiones de gas.

③ Mantener el saldo de la wallet mapeada de Gate ≥ 100 USDT

Esto garantiza la disponibilidad suficiente de comisiones de gas.

④ Preparar ~50 USDT adicionales en monedas de la cadena principal

(En el Workspace de Fireblocks)
Utilizado para cubrir múltiples transacciones de liquidación.

Monedas de Liquidación Soportadas y Requisitos de Cadena Principal

3. Precondiciones para la Liquidación y Gestión de Errores

3.1 Reporte de Errores de Liquidación por parte de Gate

Gate puede proporcionar datos estructurados sobre errores de liquidación:
Pero estos datos se entregan a Fireblocks, no directamente a los clientes.
Información proporcionada:

1. Moneda de liquidación
2. Importe de la liquidación
3. Red de liquidación (ERC / BRC / Solana / Tron)
4. Activo de la cadena principal requerido
5. Cantidad de la cadena principal requerida

3.2 Cuando una Liquidación Falla (por ejemplo, gas fee insuficiente)

Gate devuelve una estructura de error estandarizada a Fireblocks.
Sin embargo, Fireblocks aún no muestra completamente estos errores.
Si el usuario encuentra un fallo en la liquidación:
→ Por favor, contacte con su representante de soporte API para conocer la causa detallada.

Ejemplo de Respuesta de Error

{
"success": false,
"errors": [
{
"type": "gas_fee_insufficient",
"currency": "USDT",
"network": "ETH",
"message": "Missing gas fee",
"details": {
"available": "0",
"mainCoin": "ETH",
"required": "0.01"
},
"severity": "error"
}
],
"message": "Gas fee insufficient for settlement/withdrawal",
"data": {
"amount": "100.0",
"collateralId": "fb_test_2001",
"currency": "USDT",
"userId": 2001
}
}

Lógica de Gate

• Detecta saldo insuficiente en la cadena principal → devuelve un error
• El usuario repone el activo de la cadena principal o aumenta el saldo de la wallet mapeada de Gate → vuelve a intentar la liquidación

Resumen Final del Proceso End-to-End

Fase de Inicialización

1. El usuario contacta con Fireblocks
2. Fireblocks crea un Workspace
3. Fireblocks lo configura como un Workspace OES
4. El usuario genera una clave API de Gate
5. El usuario vincula la clave API en Fireblocks
6. El usuario delega cada moneda soportada (el primer intento falla → esperar 10 min → reintentar)

Fase de Colateral para Gas Fee

1. El usuario deposita monedas de la cadena principal en el Workspace de Fireblocks
2. El usuario delega el equivalente a 100 USDT en monedas de la cadena principal a Gate (congelado)
3. Mantener el saldo de la wallet mapeada de Gate ≥ 100 USDT
4. Mantener ~50 USDT en activos de la cadena principal en el Workspace para liquidaciones repetidas

Fase de Liquidación

1. Gate calcula el gas necesario en la cadena principal e inicia la liquidación
2. Si el gas es insuficiente → Gate devuelve un error estandarizado
3. El usuario repone el gas → vuelve a intentar la liquidación