參與方說明
- 用戶
- Fireblocks
- Gate（OES 模組）
1. Workspace 初始化流程（由用戶 & Fireblocks 完成）
Step 1. 用戶聯繫 Fireblocks – 申請開啟 Workspace
用戶向 Fireblocks 提交申請，Fireblocks 為其建立一個新的 workspace。
Step 2. Fireblocks 配置 Workspace 為 OES Workspace
Fireblocks 將該 workspace 配置為適用於 Gate OES 模式的 OES Workspace，並啟用相關功能（Delegate、Undelegate、Gas Fee 支付等）。
Step 3. 用戶在 Gate 生成 API Key
用戶登入 Gate 平台，生成專用於 Fireblocks 的 API Key
-
必須為 Gate 主帳戶
-
該主帳戶（包含下方所有子帳戶）需符合以下條件
-
無持倉
-
完全 0 餘額
Step 4. 用戶將 Gate API Key 綁定到 Fireblocks Workspace
用戶返回 Fireblocks，在 Workspace 設定中將 Gate 提供的 API Key 綁定。
此步完成後，Fireblocks 即可代表用戶與 Gate 進行互動（delegate、結算等操作）。
Step 5. 用戶開始 Delegate 各幣種（觸發 Gate 生成錢包）
用戶根據 Fireblocks 當前支持的結算幣種，逐一嘗試 Delegate。
Delegate 的作用
- 觸發 Fireblocks → Gate 的請求
- Gate 自動為對應幣種生成映射錢包地址
注意事項：
- 第一次 Delegate 很可能失敗（錢包尚未初始化）→ 報錯可忽略
- 等待約 10 分鐘 後再次 Delegate 即可成功
- 所有結算幣種都需至少 delegate 一次（才能啟動錢包）
2. 用戶充值與 Gas Fee 保證金（押金）
在傳統 OES 模式下，雙方需在對方錢包中存放可覆蓋盈虧的 百萬美元級保證金。
但在 Fireblocks 自託管模式下：
Gate 不需要用戶在 Gate 存入大量保證金。僅要求用戶在自己的 Fireblocks Workspace 中維持 等值 100 USDT 的主鏈幣。（詳見 主鏈幣詳情部分）Gate 會凍結這部分資產，用於支付鏈上結算所需的 Gas Fee。資產仍由用戶自託管，未離開 Fireblocks。
優勢： 保證金成本從百萬級 → 降至數百 USDT（取決於用戶希望結算的幣種數量）。
主鏈幣詳情
① 用戶向 Fireblocks Workspace 充值主鏈幣
確保每條結算鏈都有主鏈幣可用。
舉例：
- ERC → 需要 ETH
- BRC → 需要 BTC
- Solana → 需要 SOL
- Tron → 需要 TRX
② Delegate 等值 100 USDT 的 Gas Fee 主鏈幣給 Gate
Gate 將自動凍結此部分資產作為 Gas Fee 保證金。
③ 保持 Gate 映射錢包餘額 ≥ 100 USDT
用於保障 Gas Fee 支付能力。
④ 額外準備約 50 USDT 的主鏈幣
（Fireblocks Workspace 內）用於覆蓋多次 Settlement 的鏈上手續費。
支持的結算幣種與對應主鏈幣
| 結算幣種 | 結算鏈 | 所需主鏈幣 |
|---|---|---|
| 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. 結算（Settlement）前置條件 & 失敗處理
3.1 Settlement Gate 會提供報錯解決資訊
資訊包含：
- 結算幣種
- 結算金額
- 結算鏈（ERC / BRC / Solana / Tron）
- 所需主鏈幣
- 主鏈幣所需金額
3.2 Settlement 失敗時（如 Gas Fee 不足）
Gate 會返回標準化錯誤結構給 Fireblocks，但 fireblocks 尚未對該內容進行穿透展示。
用戶如遇結算失敗：可聯繫您對應的 api support 詢問錯誤原因
報錯範例
{
"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
}
}
Gate 的處理邏輯：
- 發現主鏈幣不足 → 返回錯誤
- 用戶補充主鏈幣或提高 Gate 映射餘額 → 重新 Settlement
最終流程
初始化階段
- 用戶聯繫 Fireblocks
- Fireblocks 建立 Workspace
- Fireblocks 設定為 OES Workspace
- 用戶到 Gate 生成 API Key
- 用戶將 API Key 綁定到 Fireblocks
- 用戶按支持幣種逐一 Delegate（首次失敗屬正常 → 10 分鐘後成功）
Gas Fee 保證金階段
- 用戶向 Fireblocks Workspace 充值主鏈幣
- 用戶 Delegate 等值 100 USDT 主鏈幣至 Gate（凍結）
- 保持 Gate 映射餘額 ≥ 100 USDT
- Workspace 內保持約 50 USDT 主鏈幣用於 Gas fee
Settlement 階段
- Gate 計算所需主鏈幣 → 發起鏈上結算
- 若 Gas 不足 → 返回錯誤結構
- 用戶補 Gas → 再次 Settlement
