Participantes

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

1. Proceso de inicialización del Workspace (espacio de trabajo)

(Gestionado por el usuario y Fireblocks)

Paso 1. El usuario contacta con Fireblocks – Solicitud de creación del espacio de trabajo

El usuario envía una solicitud a Fireblocks y este crea un nuevo espacio de trabajo para el usuario.

Paso 2. Fireblocks configura el espacio de trabajo como un "espacio de trabajo de OES"

Fireblocks configura el espacio de trabajo (Workspace) para que sea compatible con el modo OES de Gate y habilita las funciones necesarias, tales como Delegate (Delegar), Undelegate (Anular delegación), Pago de tarifas de gas, etc.

Paso 3. El usuario genera una clave API en Gate

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

• Debe crearse con la cuenta principal de Gate .

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

• No tener posiciones abiertas.

• Tener el saldo a cero.

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

El usuario regresa a Fireblocks y vincula la clave API de Gate en los ajustes del espacio de trabajo.
Tras este paso, Fireblocks podrá interactuar con Gate en nombre del usuario (para delegación, liquidación, etc.).

Paso 5. El usuario comienza la delegación de cada moneda admitida (activa la creación de billetera en Gate)

El usuario delega cada moneda de liquidación que admite Fireblocks.
Acciones de delegación:

• Activa una solicitud de Fireblocks → solicitud de Gate.
• Gate genera automáticamente una dirección de billetera asignada para ese activo.

Notas:

• Es probable que el primer intento de delegación fracase (billetera aún no inicializada) → Este error puede ignorarse.
• Espera unos 10 minutos y vuelve a realizar la delegación para que se complete correctamente.
• Cada activo de liquidación admitido debe delegarse al menos una vez para activar la billetera correspondiente.

Depósitos del usuario y colateral para comisiones de gas (garantía)

En el modelo OES tradicional, ambas partes deben depositar colaterales multimillonarios en las billeteras de la otra parte.
En el modo OES de custodia propia de Fireblocks:

• Gate no requiere que el usuario deposite grandes cantidades de colateral en la plataforma Gate.

• El usuario debe mantener activos en la cadena principal por un valor equivalente a 100 USDT dentro de su propio espacio de trabajo de Fireblocks. (delegado a Gate).

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

• Los activos permanecen totalmente custodiados dentro de Fireblocks y nunca salen del espacio de trabajo.

• El usuario debe mantener activos en la cadena principal por un valor equivalente a 50 USDT dentro de su propio espacio de trabajo de Fireblocks. (sin delegarlo a la Gate)

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

Ventaja: el requisito de colateral se reduce de millones a unos cientos de USDT .

Detalles de los activos de la cadena principal

① El usuario deposita los activos de la cadena principal en el espacio de trabajo de Fireblocks.

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

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

② Delegar la cantidad de monedas de la cadena principal equivalente a 100 USDT a Gate

Gate congelará automáticamente esta cantidad como colateral de la tarifa de gas.

③ Mantener un saldo en la billetera asignada a Gate ≥ 100 USDT

Esto garantiza la disponibilidad suficiente de la tarifa de gas.

④ Prepara aproximadamente 50 USDT adicionales en monedas de la cadena principal.

(en el espacio de trabajo de Fireblocks)
Se usa para cubrir distintas transacciones de liquidación.

Monedas admitidas para liquidaciones y requisitos de la cadena principal

3. Condiciones previas para la liquidación y gestión de fallos

3.1 Notificación de errores de liquidación por parte de Gate

Gate puede proporcionar datos sobre errores en acuerdos estructurados:
Pero estos datos se proporcionan a los cortafuegos, no directamente a los clientes.
Información proporcionada:

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

3.2 Qué hacer si falla una liquidación (p. ej., por tarifa de gas insuficiente)

Gate devuelve una estructura de error estandarizada a Fireblocks.
Sin embargo, Fireblocks aún no muestra estos errores de forma detallada en su interfaz.
Si el usuario se encuentra con un error en la liquidación:
→ Ponte en contacto con tu representante de asistencia técnica de 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 red principal → devuelve un error.
• El usuario repone los activos de la cadena principal o aumenta el saldo de la billetera asignada a Gate → vuelve a intentar la liquidación.

Resumen final del proceso de principio a fin

Fase de inicialización

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

Fase de colateral de la tarifa de gas

1. El usuario deposita monedas nativas en el espacio de trabajo de Fireblocks.
2. El usuario delega el equivalente a 100 USDT en monedas nativas a Gate (quedan congelados).
3. Mantén un saldo en tu billetera Gate asignada ≥ 100 USDT.
4. Mantener unos 50 USDT en activos nativos en el espacio de trabajo para liquidaciones recurrentes.

Fase de liquidación

1. Gate calcula el gas necesario para 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 → se reintenta la liquidación.