Pusat Bantuan
Panduan
Panduan Fungsi

Panduan Integrasi Pengguna Fireblocks

22 menit 14 s lalu
6.030 Baca
4

Peserta

  • Pengguna
  • Fireblocks
  • Gate (Modul OES)

1. Proses Inisialisasi Workspace

(Ditangani oleh Pengguna & Fireblocks)

Langkah 1. Pengguna menghubungi Fireblocks – Permintaan untuk membuat Workspace

Pengguna mengajukan aplikasi ke Fireblocks, dan Fireblocks membuat workspace baru untuk pengguna.

Langkah 2. Fireblocks mengonfigurasi Workspace sebagai Workspace OES

Fireblocks mengonfigurasikan workspace agar kompatibel dengan mode OES Gate dan memungkinkan kemampuan yang diperlukan seperti Delegasi, Membatalkan delegasi, Pembayaran Gas Fee, dll.

Langkah 3. Pengguna membuat API Key di Gate

Pengguna masuk ke platform Gate dan menghasilkan API key khusus untuk Fireblocks.
Persyaratan:

  • Harus dibuat oleh akun utama Gate.

  • Akun utama (termasuk semua sub-akun) harus memenuhi kedua syarat tersebut:

  • Tidak ada posisi terbuka

  • Saldo nol

2

Langkah 4. Pengguna menautkan API Key Gate ke Workspace Fireblocks

User kembali ke Fireblocks dan menautkan API Key Gate di pengaturan Workspace.
Setelah langkah ini, Fireblocks dapat berinteraksi dengan Gate atas nama pengguna (delegasi, penyelesaian, dll.).

Langkah 5. Pengguna mulai mendelegasikan setiap mata uang yang didukung (memicu pembuatan dompet di Gate)

User mendelegasikan setiap mata uang penyelesaian yang didukung oleh Fireblocks.
Tindakan delegasi:

  • Memicu Fireblocks → Permintaan Gate
  • Gate secara otomatis menghasilkan alamat dompet yang dipetakan untuk aset tersebut

Catatan:

  • Upaya delegasi pertama kemungkinan akan gagal (dompet belum diinisialisasi) → Kesalahan ini dapat diabaikan
  • Tunggu ~10 menit, lalu delegasikan kembali agar berhasil
  • Setiap aset penyelesaian yang didukung harus didelegasikan setidaknya satu kali untuk mengaktifkan dompet

Setoran Pengguna & Jaminan Gas Fee (Jaminan)

Dalam model OES tradisional, kedua belah pihak harus menyetor jaminan bernilai jutaan dolar di dompet masing-masing.
Dalam model self-custody Fireblocks:

  • Gate tidak mengharuskan pengguna untuk menyetor jaminan dalam jumlah besar ke Gate.

  • Pengguna harus mempertahankan aset chain utama senilai setara dengan 100 USDT di dalam Fireblocks Workspace mereka sendiri. (delegasi ke Gate)

  • Gate akan membekukan jumlah kecil ini untuk menutupi Gas fee penyelesaian.

  • Aset tetap terjaga sepenuhnya di dalam Fireblocks dan tidak pernah meninggalkan workspace.

  • Pengguna harus mempertahankan aset chain utama senilai setara dengan 50 USDT di dalam Fireblocks Workspace mereka sendiri. (tanpa mendelegasikannya ke Gate)

  • Total 150 USDT jaminan chain utama yang dibutuhkan

Keuntungan: Persyaratan jaminan turun dari jutaan → ~ ratusan USDT.

Detail Aset Chain Utama

① Pengguna menyetorkan aset chain utama ke dalam Workspace Fireblocks

Setiap chain penyelesaian harus memiliki koin chain utama yang sesuai.
Contoh:

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

② Mendelegasikan jumlah koin chain utama yang setara dengan 100 USDT ke Gate

Gate akan secara otomatis membekukan jumlah ini sebagai jaminan Gas Fee.

③ Pertahankan saldo dompet yang dipetakan Gate ≥ 100 USDT

Hal ini memastikan ketersediaan Gas Fee yang memadai.

④ Siapkan tambahan ~50 USDT koin chain utama

(Di Workspace Fireblocks)
Digunakan untuk mencakup beberapa transaksi penyelesaian.

Mata Uang Penyelesaian yang Didukung & Persyaratan Chain Utama

Mata Uang Penyelesaian Chain Token gas fee
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. Prasyarat Penyelesaian & Penanganan Kegagalan

3.1 Pelaporan Kesalahan Penyelesaian oleh Gate

Gate dapat memberikan data kesalahan penyelesaian yang terstruktur:
Tetapi data ini diberikan kepada fireblocks, bukan kepada klien secara langsung.
Informasi yang diberikan:

  1. Mata uang penyelesaian
  2. Jumlah penyelesaian
  3. Jaringan penyelesaian (ERC / BRC / Solana / Tron)
  4. Aset chain utama yang diperlukan
  5. Jumlah chain utama yang diperlukan

3.2 Ketika Penyelesaian Gagal (mis. Gas Fee tidak mencukupi)

Gate mengembalikan struktur kesalahan standar ke Fireblocks.
Namun, Fireblocks belum sepenuhnya menampilkan kesalahan ini.
Jika pengguna mengalami kegagalan penyelesaian:
→ Silakan hubungi perwakilan dukungan API Anda untuk mengetahui penyebabnya secara mendetail.

Contoh Tanggapan Kesalahan

{
"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
}
}

Logika Gate

  • Mendeteksi saldo chain utama yang tidak mencukupi → mengembalikan kesalahan
  • Pengguna mengisi ulang aset chain utama atau meningkatkan saldo dompet yang dipetakan Gate → mencoba kembali penyelesaian

Ringkasan Proses Akhir End-to-End

Fase Inisialisasi

  1. Pengguna menghubungi Fireblocks
  2. Fireblocks menciptakan Workspace
  3. Fireblocks mengonfigurasinya sebagai Workspace OES
  4. Pengguna membuat API Key Gate
  5. Pengguna menautkan API Key di Fireblocks
  6. Pengguna mendelegasikan setiap mata uang yang didukung (percobaan pertama gagal → tunggu 10 menit → coba lagi)

Fase Jaminan Gas Fee

  1. Pengguna menyetorkan koin chain utama ke dalam Workspace Fireblocks
  2. Pengguna mendelegasikan koin chain utama setara 100 USDT ke Gate (dibekukan)
  3. Pertahankan saldo dompet yang dipetakan Gate ≥ 100 USDT
  4. Pertahankan aset chain utama ~50 USDT di Workspace untuk penyelesaian berulang

Fase Penyelesaian

  1. Gate menghitung gas chain utama yang dibutuhkan dan memulai penyelesaian
  2. Jika gas tidak mencukupi → Gate mengembalikan kesalahan standar
  3. Pengguna mengisi ulang gas → coba lagi penyelesaian
Daftar sekarang untuk mendapatkan kesempatan memenangkan hingga $10,000!
signup-tips