Peserta

• Pengguna
• Fireblocks
• Gate (Modul OES)

1. Proses Inisialisasi Workspace

(Ditangani oleh Pengguna & Fireblocks)

Langkah 1. Pengguna menghubungi Fireblocks – Permintaan pembuatan Workspace

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

Langkah 2. Fireblocks mengonfigurasi Workspace sebagai OES Workspace

Fireblocks mengonfigurasi workspace agar kompatibel dengan mode OES Gate dan mengaktifkan kapabilitas yang diperlukan seperti Delegate, Undelegate, pembayaran Gas Fee, dan lainnya.

Langkah 3. Pengguna membuat API Key di Gate

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

• Harus dibuat oleh akun utama Gate.

• Akun utama (termasuk semua sub-akun) harus memenuhi kedua kondisi berikut:

• Tidak ada posisi terbuka

• Saldo nol

Langkah 4. Pengguna menghubungkan API Key Gate ke Workspace Fireblocks

Pengguna kembali ke Fireblocks dan menghubungkan API key Gate di pengaturan Workspace.
Setelah langkah ini, Fireblocks dapat berinteraksi dengan Gate atas nama pengguna (delegate, settlement, dll.).

Langkah 5. Pengguna mulai melakukan Delegasi untuk setiap mata uang yang didukung (memicu pembuatan wallet di Gate)

Pengguna melakukan delegasi untuk setiap mata uang settlement yang didukung oleh Fireblocks.
Aksi delegasi:

• Memicu permintaan Fireblocks → Gate
• Gate secara otomatis membuat alamat wallet yang dipetakan untuk aset tersebut

Catatan:

• Upaya delegasi pertama kemungkinan besar akan gagal (wallet belum diinisialisasi) → Error ini dapat diabaikan
• Tunggu ~10 menit, lalu lakukan delegasi ulang agar berhasil
• Setiap aset settlement yang didukung harus didelegasikan setidaknya sekali untuk mengaktifkan wallet

Deposit Pengguna & Jaminan Gas Fee (Collateral)

Dalam model OES tradisional, kedua pihak harus mendepositkan collateral bernilai jutaan dolar ke wallet masing-masing.
Pada mode OES self-custody Fireblocks:

• Gate tidak mewajibkan pengguna mendepositkan collateral besar ke Gate.

• Pengguna perlu menjaga aset main-chain senilai setara 100 USDT di dalam Workspace Fireblocks mereka sendiri. （didelegasikan ke gate）

• Gate akan membekukan sejumlah kecil ini untuk menutupi biaya Gas settlement.

• Aset sepenuhnya tetap dalam self-custody di Fireblocks dan tidak pernah keluar dari workspace.

• Pengguna perlu menjaga aset main-chain senilai setara 50 USDT di dalam Workspace Fireblocks mereka sendiri. （tanpa mendelegasikannya ke gate）

• Total collateral main chain yang dibutuhkan adalah 150 USDT

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

Rincian Aset Main-Chain

① Pengguna mendepositkan aset main-chain ke Workspace Fireblocks

Setiap chain settlement harus memiliki koin main-chain yang sesuai.
Contoh:

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

② Delegasikan jumlah koin main-chain senilai 100 USDT ke Gate

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

③ Jaga saldo wallet Gate yang dipetakan ≥ 100 USDT

Ini memastikan ketersediaan Gas Fee yang cukup.

④ Siapkan tambahan ~50 USDT koin main-chain

(Di Workspace Fireblocks)
Digunakan untuk mendukung beberapa transaksi settlement.

Mata Uang Settlement & Persyaratan Main-Chain yang Didukung

3. Prasyarat Settlement & Penanganan Kegagalan

3.1 Pelaporan Error Settlement oleh Gate

Gate dapat menyediakan data error settlement yang terstruktur:
Namun data ini diberikan kepada fireblocks, bukan langsung ke klien.
Informasi yang diberikan:

1. Mata uang settlement
2. Jumlah settlement
3. Jaringan settlement (ERC / BRC / Solana / Tron)
4. Aset main-chain yang dibutuhkan
5. Jumlah main-chain yang dibutuhkan

3.2 Ketika Settlement Gagal (misal, Gas Fee tidak cukup)

Gate akan mengembalikan struktur error standar ke Fireblocks.
Namun, Fireblocks belum sepenuhnya menampilkan error ini.
Jika pengguna mengalami kegagalan settlement:
→ Silakan hubungi perwakilan dukungan API Anda untuk mengetahui penyebab detailnya.

Contoh Respons Error

{
"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 main-chain tidak cukup → mengembalikan error
• Pengguna menambah aset main-chain atau meningkatkan saldo wallet Gate yang dipetakan → ulangi settlement

Ringkasan Proses End-to-End

Fase Inisialisasi

1. Pengguna menghubungi Fireblocks
2. Fireblocks membuat Workspace
3. Fireblocks mengonfigurasinya sebagai OES Workspace
4. Pengguna membuat API Key Gate
5. Pengguna menghubungkan 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 mendepositkan koin main-chain ke Workspace Fireblocks
2. Pengguna mendelegasikan koin main-chain senilai 100 USDT ke Gate (dibekukan)
3. Jaga saldo wallet Gate yang dipetakan ≥ 100 USDT
4. Jaga aset main-chain ~50 USDT di Workspace untuk settlement berulang

Fase Settlement

1. Gate menghitung kebutuhan gas main-chain dan memulai settlement
2. Jika gas tidak cukup → Gate mengembalikan error standar
3. Pengguna menambah gas → ulangi settlement