Procedimiento operativo estándar de Fireblocks ｜ Gate

Para ayudar a los clientes institucionales a establecer una gestión de activos y una conexión de trading seguras y eficientes entre Fireblocks y Gate, este documento proporciona el procedimiento operativo estándar (SOP) para la integración bajo el modelo OES (Off-Exchange Settlement) de Gate.
Este proceso está diseñado para usuarios institucionales verificados e integra Fireblocks Workspace con el módulo OES de Gate para separar la custodia del trading. Esta arquitectura mejora la seguridad de los fondos a la vez que permite operaciones de trading flexibles y eficientes.
La integración implica la coordinación entre tres partes: el cliente, Fireblocks y Gate. Tras completar la inicialización del Workspace y la activación de capacidades, siga los pasos a continuación para configurar la autorización y la conectividad, asegurando así una integración exitosa.

Participantes

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

1. Proceso de Inicialización del Workspace

(Gestionado por Usuario & 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:

1. Debe ser creada por la cuenta principal de Gate.
2. 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 vuelve a Fireblocks y vincula la clave API de Gate en la configuración del Workspace.
Tras este paso, Fireblocks puede interactuar con Gate en nombre del usuario (delegar, liquidar, etc.).

Paso 5. El usuario comienza a delegar cada moneda soportada (esto activa 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 de 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 que tenga éxito
• Cada activo de liquidación soportado debe ser delegado al menos una vez para activar la wallet

2.Depósitos del usuario y garantía de comisiones de gas2.Depósitos del usuario y garantía de comisiones de gas

En el modelo OES tradicional, ambas partes deben depositar garantías multimillonarias en las wallets de la otra parte.
En el modo OES de autocustodia con Fireblocks:

1. Gate no requiere que el usuario deposite una gran garantía en Gate.
2. El usuario debe mantener activos en la mainnet equivalentes a 100 USDT dentro de su propio Workspace de Fireblocks. (delegados a Gate)

• Gate congelará esta pequeña cantidad para cubrir las comisiones de gas de las liquidaciones.
• Los activos permanecen totalmente bajo autocustodia en Fireblocks y nunca salen del workspace.

3. El usuario debe mantener activos en la mainnet equivalentes a 50 USDT dentro de su propio Workspace de Fireblocks. (sin delegarlos a Gate)
4. En total, se necesita una garantía en la mainnet de 150 USDT

Ventaja: El requisito de garantía baja de millones → ~cientos de USDT.

Detalles de los activos en la mainnet

① El usuario deposita activos de la mainnet 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 la cantidad de monedas principales equivalente a 100 USDT a Gate
Gate congelará automáticamente esta cantidad como garantía para comisiones de gas.

③ Mantener el saldo de la wallet mapeada de Gate ≥ 100 USDT
Esto garantiza disponibilidad suficiente para comisiones de gas.

④ Preparar ~50 USDT adicionales en monedas principales
(En el Workspace de Fireblocks)
Se utilizarán para cubrir múltiples transacciones de liquidación.

Monedas de liquidación soportadas y requisitos de mainnet

3.Precondiciones de liquidación y gestión de errores

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

Gate puede proporcionar datos estructurados de 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 principal requerido
5. Cantidad principal requerida

3.2 Cuando una liquidación falla (por ejemplo, por comisión de gas insuficiente)

Gate devuelve una estructura de error estandarizada a Fireblocks.
Sin embargo, Fireblocks aún no muestra completamente estos errores.
Si el usuario experimenta 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 mainnet → devuelve un error
• El usuario repone el activo principal o incrementa el saldo en la wallet mapeada de Gate → reintenta la liquidación

Resumen final del proceso de extremo a extremo

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 en 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 garantía para comisiones de gas

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

Fase de liquidación

1. Gate calcula el gas principal requerido e inicia la liquidación
2. Si el gas es insuficiente → Gate devuelve un error estandarizado
3. El usuario repone el gas → reintenta la liquidación

El contenido aquí proporcionado es solo para fines de referencia y educativos, y no constituye asesoramiento financiero, de inversión, comercial ni legal, ni constituye una oferta o solicitud para comprar o vender activos digitales. Gate no realiza declaraciones ni garantías, expresas o implícitas, sobre la exactitud, integridad o actualidad de la información contenida en este documento. Las características del producto, interfaces, normas y estructuras de tarifas pueden actualizarse o modificarse en cualquier momento. Consulta los comunicados más recientes y la información que aparece en la plataforma de Gate para obtener los detalles más precisos.

Las inversiones en activos digitales implican un riesgo significativo y los precios pueden fluctuar considerablemente. Podrías perder la totalidad de tu inversión. Toma decisiones con cautela en función de tu situación financiera y tolerancia al riesgo, una vez que hayas comprendido plenamente los riesgos asociados. Si es necesario, te recomendamos consultar con un asesor financiero o legal independiente.

Para más información sobre los posibles riesgos, consulta la Divulgación de riesgos y el Acuerdo de usuario de Gate.