Participantes

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

1. Processo de inicialização do Workspace

(Gerenciado pelo usuário e Fireblocks)

Passo 1. O usuário entra em contato com a Fireblocks – Solicitação para criar um Workspace

O usuário envia uma solicitação para o Fireblocks, e o Fireblocks cria um novo Workspace para o usuário.

Passo 2. O Fireblocks configura o Workspace como um Workspace OES

O Fireblocks configura o Workspace para ser compatível com o modo OES da Gate e habilita os recursos necessários, como Delegar, Remover delegação, Pagamento da taxa de gas, etc.

Passo 3. O usuário gera uma chave API na Gate

O usuário acessa a plataforma Gate e gera uma chave API específica para o Fireblocks.
Requisitos:

• Deve ser criada por uma conta principal da Gate.

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

• Sem posições em aberto

• Saldo zero

Passo 4. O usuário vincula a chave API da Gate ao Workspace do Fireblocks

O usuário retorna ao Fireblocks e vincula a chave API da Gate nas configurações do Workspace.
Após este passo, o Fireblocks pode interagir com a Gate em nome do usuário (delegação, liquidação, etc.).

Passo 5. O usuário inicia a delegação de cada moeda suportada (aciona a criação de uma carteira na Gate)

O usuário delega cada moeda de liquidação suportada pelo Fireblocks.
Delegar ações:

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

Observações:

• A primeira tentativa de delegação provavelmente falhará (carteira ainda não inicializada) → Este erro pode ser ignorado
• Aguarde aproximadamente 10 minutos e, em seguida, delegue novamente para obter sucesso
• Cada ativo de liquidação suportado deve ser delegado pelo menos uma vez para ativar a carteira

Depósitos de usuários e garantia de taxa de gas (garantia)

No modelo OES tradicional, ambas as partes devem depositar garantias multimilionárias nas carteiras uma da outra.
No modo OES de autocustódia do Fireblocks:

• A Gate não exige que o usuário deposite grandes quantias como garantia.

• O usuário precisa manter o equivalente a 100 USDT em ativos da cadeia principal dentro do seu próprio Workspace do Fireblocks. （delegando à Gate）

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

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

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

• No total, 150 USDT de garantia na cadeia principal são necessários

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

Informações dos ativos da cadeia principal

① O usuário deposita ativos da cadeia principal no Workspace do Fireblocks

Cada cadeia de liquidação deve ter sua moeda correspondente na cadeia principal.
Exemplos:

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

② Delegar à Gate a quantidade de moedas da cadeia principal equivalente a 100 USDT

A Gate irá congelar automaticamente este valor como garantia de taxa de gas.

③ Manter saldo na carteira mapeada pela Gate ≥ 100 USDT

Isso garante disponibilidade suficiente de recursos para a taxa de gas.

④ Prepare cerca de 50 USDT adicionais em moedas da cadeia principal

(No Workspace do Fireblocks)
Utilizado para abranger múltiplas transações de liquidação.

Moedas de liquidação suportadas e requisitos da cadeia principal

3. Pré-condições de liquidação e tratamento de falhas

3.1 Relatório de erros de liquidação da Gate

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

1. Moeda de liquidação
2. Valor da liquidação
3. Rede de liquidação (ERC / BRC / Solana / Tron)
4. Ativo da cadeia principal necessário
5. Valor necessário na cadeia principal

3.2 Quando uma liquidação falha (ex.: taxa de gas insuficiente)

A Gate retorna uma estrutura de erro padronizada ao Fireblocks.
No entanto, o Fireblocks ainda não expõe completamente esses erros.
Caso o usuário encontre uma falha de liquidação:
→ Entre em contato com seu representante de suporte da API para obter detalhes sobre a causa.

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 na cadeia principal → retorna um erro
• O usuário repõe o saldo do ativo na cadeia principal ou aumenta o saldo da carteira mapeada na Gate → tenta novamente a liquidação

Resumo final do processo completo

Fase de inicialização

1. O usuário contata o Fireblocks
2. O Fireblocks cria um Workspace
3. O Fireblocks o configura como um Workspace OES
4. O usuário gera uma chave API da Gate
5. O usuário vincula a chave API no Fireblocks
6. O usuário delega cada moeda suportada (se a primeira tentativa falhar → aguarde 10 minutos → tente novamente)

Fase de garantia da taxa de gas

1. O usuário deposita moedas da cadeia principal no Workspace do Fireblocks.
2. O usuário delega o equivalente a 100 USDT em moedas da cadeia principal para a Gate (congeladas).
3. Mantenha o saldo da carteira mapeada na Gate de 100 USDT ou mais.
4. Mantém aproximadamente 50 USDT em ativos da cadeia principal no Workspace para liquidações recorrentes.

Fase de liquidação

1. A Gate calcula o gas necessário na cadeia principal e inicia a liquidação.
2. Se o gas for insuficiente → a gate retorna erro padronizado
3. O usuário repõe o gas → tenta novamente a liquidação