Central de Ajuda
Guia
Diretrizes funcionais

Guia de integração do utilizador da Fireblocks

5 minuto 22 há x seg.
5 905 Lido
3

Participantes

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

1. Processo de inicialização do espaço de trabalho

(Gerido pelo utilizador e pela Fireblocks)

Passo 1. O utilizador entra em contacto com a Fireblocks – Solicita para criar um Espaço de Trabalho

O utilizador envia um pedido à Fireblocks, e a Fireblocks cria um novo espaço de trabalho para o utilizador.

Passo 2. A Fireblocks configura o espaço de trabalho como um espaço de trabalho OES

A Fireblocks configura o espaço de trabalho para ser compatível com o modo OES do Gate e habilita os recursos necessários, como Delegar, Cancelar delegação, Pagamento de taxa de gas, etc.

Passo 3. O utilizador gera uma chave API na Gate

O utilizador inicia sessão na plataforma Gate e gera uma chave API específica para a Fireblocks.
Requisitos:

  • Deve ser criado pela conta principal da Gate.

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

  • Sem posições abertas

  • Saldo zero

2

Passo 4. O utilizador vincula a chave API da Gate ao espaço de trabalho Fireblocks

O utilizador realiza o retorno ao Fireblocks e vincula a chave API Gate nas definições do Espaço de trabalho.
Após esta etapa, a Fireblocks pode interagir com a Gate em nome do utilizador (delegação, liquidação, etc.).

Passo 5. O utilizador começa a delegar cada moeda suportada (desencadeia a criação de carteira no Gate)

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

  • Aciona Fireblocks → Pedido da 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 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 do utilizador e garantia (caução) da taxa de gas

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

  • A Gate não exige que o utilizador deposite grandes garantias na Gate.

  • O utilizador precisa manter o equivalente a 100 USDT em ativos da cadeia principal dentro do seu próprio espaço de trabalho Fireblocks. (delegado à Gate)

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

  • Os ativos permanecem totalmente sob custódia própria dentro do Fireblocks e nunca saem do espaço de trabalho.

  • O utilizador precisa manter o equivalente a 50 USDT em ativos da cadeia principal dentro do seu próprio espaço de trabalho Fireblocks. (sem delegar à Gate)

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

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

Detalhes dos ativos da cadeia principal

① O utilizador deposita os ativos da cadeia principal no espaço de trabalho Fireblocks

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

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

② Delegue à Gate o montante de moedas da cadeia principal equivalente a 100 USDT

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

③ Manter saldo da carteira mapeada na Gate ≥ 100 USDT

Isso garante disponibilidade suficiente da taxa de Gas.

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

(No espaço de trabalho Fireblocks)
Utilizado para cobrir múltiplas transações de liquidação.

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

Moeda de liquidação Cadeia Token de taxa de gas
BTC BRC BTC
ETH ERC ETH
OXT ERC ETH
FET ERC ETH
BOBA ERC ETH
ACX ERC ETH
SAFE ERC ETH
USDT(ERC) ERC ETH
SOL Solana SOL
TRX Tron TRX

3. Pré-requisitos para liquidação e tratamento de falhas

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

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

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

3.2 Quando uma liquidação falha (por exemplo, taxa de gas insuficiente)

A Gate realiza o retorno de uma estrutura de erro padronizada para a Fireblocks.
No entanto, a Fireblocks ainda não expõe totalmente esses erros.
Se o utilizador encontrar uma falha na liquidação:
→ Entre em contacto com o seu representante de suporte API para obter informações detalhadas sobre a causa.

Exemplo de resposta de erro

{
"sucesso": falso,
"erros": [
{
"tipo": "gas_fee_insufficient",
"moeda": "USDT",
"rede": "ETH",
"mensagem": "Taxa de gas em falta",
"detalhes": {
"disponível": "0",
"mainCoin": "ETH",
"necessário": "0.01"
},
"severidade": erro ""
}
],
"mensagem": "Taxa de gas insuficiente para liquidação/levantamento",
"dados": {
"montante": "100,0",
"collateralId": "fb_test_2001",
"moeda": "USDT",
"userId": 2001
}
}

A Lógica da Gate

  • Deteta saldo insuficiente na cadeia principal → há um retorno de erro
  • O utilizador reabastece o ativo da cadeia principal ou aumenta o saldo da carteira mapeada pela Gate → tenta novamente a liquidação

Resumo final do processo completo

Fase de inicialização

  1. O utilizador contacta a Fireblocks
  2. A Fireblocks cria um espaço de trabalho
  3. A Fireblocks configura-o como um Espaço de trabalho OES
  4. O utilizador gera uma chave API da Gate
  5. O utilizador vincula a chave API na Fireblocks
  6. O utilizador delega cada moeda suportada (primeira tentativa falhada → aguardar 10 minutos → tentar novamente)

Fase de garantia da taxa de gas

  1. O utilizador deposita moedas da cadeia principal no espaço de trabalho Fireblocks
  2. O utilizador delega 100 USDT equivalentes em moedas da cadeia principal à Gate (congeladas)
  3. Mantém o saldo da carteira mapeada no Gate ≥ 100 USDT
  4. Mantém cerca de 50 USDT em ativos da cadeia principal no espaço de trabalho para liquidações repetidas

Fase de liquidação

  1. A Gate calcula o gas necessário para a cadeia principal e inicia a liquidação.
  2. Se o gas for insuficiente → A Gate realiza o retorno de um erro padronizado
  3. O utilizador reabastece o gas → nova tentativa de liquidação
Inscreva-se agora para ter a oportunidade de ganhar até $10,000!
signup-tips