Participantes

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

1. Processo de Inicialização do Workspace

(Tratado pelo Utilizador & Fireblocks)

Passo 1. Utilizador contacta a Fireblocks – Pedido para criar um Workspace

O utilizador submete um pedido à Fireblocks, e a Fireblocks cria um novo workspace para o utilizador.

Passo 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 ativa as capacidades necessárias, como Delegar, Desdelegar, Pagamento de Taxas de Gas, etc.

Passo 3. Utilizador gera uma Chave API na Gate

O utilizador entra na plataforma Gate e gera uma chave API especificamente para a Fireblocks.
Requisitos:

• Deve ser criada pela conta principal da Gate.

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

• Sem posições abertas

• Saldo zero

Passo 4. Utilizador associa a Chave API da Gate ao Workspace da Fireblocks

O utilizador regressa à Fireblocks e associa a chave API da Gate nas definições do Workspace.
Após este passo, a Fireblocks pode interagir com a Gate em nome do utilizador (delegar, liquidação, etc.).

Passo 5. Utilizador começa a Delegar cada moeda suportada (inicia a criação da carteira na Gate)

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

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

Notas:

• A primeira tentativa de delegação irá provavelmente 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 pelo menos uma vez para ativar a carteira

Depósitos do Utilizador & Colateral de Taxas de Gas (Garantia)

No modelo tradicional OES, ambas as partes devem depositar colaterais de vários milhões de dólares nas carteiras uma da outra.
No modo OES de autocustódia Fireblocks:

• A Gate não exige que o utilizador deposite um grande colateral na Gate.

• O utilizador precisa de manter o equivalente a 100 USDT em ativos de mainnet dentro do seu próprio Workspace Fireblocks. (delegado para a gate)

• A Gate irá congelar este pequeno montante para cobrir as taxas de Gas de liquidação.

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

• O utilizador precisa de manter o equivalente a 50 USDT em ativos de mainnet dentro do seu próprio Workspace Fireblocks. (sem delegar para a gate)

• No total, são necessários 150 USDT de colateral em mainnet

Vantagem: O requisito de colateral desce de milhões → ~centenas de USDT.

Detalhes dos Ativos de Mainnet

① Utilizador deposita ativos de mainnet no Workspace da Fireblocks

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

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

② Delegar o montante de moedas de mainnet equivalente a 100 USDT para a Gate

A Gate irá congelar automaticamente este montante como colateral para taxas de Gas.

③ Manter saldo da carteira mapeada da Gate ≥ 100 USDT

Isto garante disponibilidade suficiente de taxas de Gas.

④ Preparar um adicional de ~50 USDT em moedas de mainnet

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

Moedas de Liquidação Suportadas & Requisitos de Mainnet

3. Pré-condições de Liquidação & Gestão de Falhas

3.1 Relato de Erros de Liquidação pela Gate

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

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

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

A Gate devolve uma estrutura de erro padronizada à Fireblocks.
No entanto, a Fireblocks ainda não apresenta totalmente estes erros.
Se o utilizador encontrar uma falha na liquidação:
→ Por favor, contacte o 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

• Deteta saldo insuficiente de mainnet → devolve erro
• Utilizador repõe o ativo de mainnet ou aumenta o saldo da carteira mapeada da Gate → tenta a liquidação novamente

Resumo Final do Processo End-to-End

Fase de Inicialização

1. Utilizador contacta a Fireblocks
2. Fireblocks cria um Workspace
3. Fireblocks configura-o como um Workspace OES
4. Utilizador gera uma Chave API da Gate
5. Utilizador associa a Chave API na Fireblocks
6. Utilizador delega cada moeda suportada (primeira tentativa falha → aguardar 10 min → tentar novamente)

Fase de Colateral para Taxas de Gas

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

Fase de Liquidação

1. A Gate calcula o gas de mainnet necessário e inicia a liquidação
2. Se o gas for insuficiente → a Gate devolve erro padronizado
3. Utilizador repõe o gas → tenta a liquidação novamente