Participantes

• Usuário
• Fireblocks
• Gate (Módulo OES)

1. Processo de Inicialização do Workspace

(Realizado pelo Usuário & Fireblocks)

Etapa 1. Usuário entra em contato com a Fireblocks – Solicitação de criação de Workspace

O usuário envia uma solicitação para a Fireblocks, que cria um novo workspace para o usuário.

Etapa 2. Fireblocks configura o Workspace como um Workspace OES

A Fireblocks configura o workspace para ser compatível com o modo OES da Gate e habilita as capacidades necessárias, como Delegar, Desfazer Delegação, Pagamento de Taxas de Gas, etc.

Etapa 3. Usuário gera uma Chave de API na Gate

O usuário acessa a plataforma Gate e gera uma chave de API especificamente para a Fireblocks.
Requisitos:

• Deve ser criada pela conta principal da Gate.

• A conta principal (incluindo todas as subcontas) deve atender a ambas as condições:

• Nenhuma posição aberta

• Saldo zero

Etapa 4. Usuário vincula a Chave de API da Gate ao Workspace da Fireblocks

O usuário retorna à Fireblocks e vincula a chave de API da Gate nas configurações do Workspace.
Após esta etapa, a Fireblocks pode interagir com a Gate em nome do usuário (delegar, liquidar, etc.).

Etapa 5. Usuário começa a Delegar cada moeda suportada (aciona a criação de carteira na Gate)

O usuário delega cada moeda de liquidação suportada pela Fireblocks.
Ações de delegação:

• Aciona uma solicitação Fireblocks → Gate
• A Gate gera automaticamente um endereço de carteira mapeado para esse ativo

Observações:

• A primeira tentativa de delegação provavelmente irá falhar (carteira ainda não inicializada) → Este erro pode ser ignorado
• Aguarde ~10 minutos, depois delegue novamente para ter sucesso
• Cada ativo de liquidação suportado deve ser delegado ao menos uma vez para ativar a carteira

Depósitos do Usuário & Colateral de Taxa de Gas (Garantia)

No modelo OES tradicional, ambos os lados precisam depositar garantias de vários milhões de dólares nas carteiras um do outro.
No modo OES de autocustódia da Fireblocks:

• A Gate não exige que o usuário deposite grandes garantias na Gate.

• O usuário precisa manter o equivalente a 100 USDT em ativos da mainnet dentro do próprio Workspace Fireblocks. (delegar para a Gate)

• A Gate irá congelar esse pequeno valor para cobrir taxas de Gas de liquidação.

• Os ativos permanecem totalmente sob autocustódia dentro da Fireblocks e nunca saem do workspace.

• O usuário precisa manter o equivalente a 50 USDT em ativos da mainnet dentro do próprio Workspace Fireblocks. (sem delegar para a Gate)

• No total, são necessários 150 USDT de garantia em ativos da mainnet

Vantagem: A exigência de garantia cai de milhões → ~centenas de USDT.

Detalhes dos Ativos da Mainnet

① Usuário deposita ativos da mainnet no Workspace Fireblocks

Cada rede de liquidação deve ter sua respectiva moeda da mainnet.
Exemplos:

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

② Delegue o valor em moedas da mainnet equivalente a 100 USDT para a Gate

A Gate irá congelar automaticamente esse valor como colateral de Taxa de Gas.

③ Mantenha o saldo da carteira mapeada da Gate ≥ 100 USDT

Isso garante disponibilidade suficiente para taxas de Gas.

④ Prepare um adicional de ~50 USDT em moedas da mainnet

(No Workspace Fireblocks)
Usado para cobrir múltiplas transações de liquidação.

Moedas de Liquidação Suportadas & Requisitos de Mainnet

3. Pré-requisitos de Liquidação & Tratamento de Falhas

3.1 Relatório de Erros de Liquidação pela Gate

A Gate pode fornecer dados estruturados de erro de liquidação:
Mas esses dados são fornecidos à Fireblocks, não diretamente aos clientes.
Informações fornecidas:

1. Moeda de liquidação
2. Quantidade de liquidação
3. Rede de liquidação (ERC / BRC / Solana / Tron)
4. Ativo de mainnet necessário
5. Quantidade de mainnet necessária

3.2 Quando uma Liquidação Falha (ex: taxa de gas insuficiente)

A Gate retorna uma estrutura de erro padronizada para a Fireblocks.
No entanto, a Fireblocks ainda não exibe totalmente esses erros.
Se o usuário encontrar uma falha na liquidação:
→ Por favor, entre em contato com seu representante de suporte à API para obter a causa detalhada.

Exemplo de Resposta de Erro

{
"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 da Gate

• Detecta saldo insuficiente de mainnet → retorna um erro
• Usuário repõe o ativo de mainnet ou aumenta o saldo da carteira mapeada da Gate → tenta liquidar novamente

Resumo Final do Processo End-to-End

Fase de Inicialização

1. Usuário entra em contato com a Fireblocks
2. Fireblocks cria um Workspace
3. Fireblocks o configura como um Workspace OES
4. Usuário gera uma Chave de API na Gate
5. Usuário vincula a Chave de API na Fireblocks
6. Usuário delega cada moeda suportada (primeira tentativa falha → aguarde 10 min → tente novamente)

Fase de Colateral de Taxa de Gas

1. Usuário deposita moedas da mainnet no Workspace Fireblocks
2. Usuário delega o equivalente a 100 USDT em moedas da mainnet para a Gate (congelado)
3. Manter saldo da carteira mapeada da Gate ≥ 100 USDT
4. Manter ~50 USDT em ativos da mainnet no Workspace para liquidações repetidas

Fase de Liquidação

1. Gate calcula o gas necessário na mainnet e inicia a liquidação
2. Se o gas for insuficiente → Gate retorna erro padronizado
3. Usuário repõe o gas → tenta liquidar novamente