参加者
- ユーザー
- Fireblocks
- Gate（OESモジュール）
1. ワークスペース初期化プロセス
（ユーザー＆Fireblocksが対応）
ステップ 1. ユーザーがFireblocksに連絡 — ワークスペース作成リクエスト
ユーザーはFireblocksに申請を提出し、Fireblocksがユーザー用の新しいワークスペースを作成します。
ステップ 2. FireblocksがワークスペースをOESワークスペースとして設定
FireblocksはワークスペースをGateのOESモードと互換性のあるように設定し、委任、委任解除、ガス手数料支払いなどの必要な機能を有効化します。
ステップ 3. ユーザーがGateでAPIキーを生成
ユーザーはGateプラットフォームにログインし、Fireblocks専用のAPIキーを生成します。
参加資格：
-
*Gateメインカウント**によって作成される必要があります。
-
メインアカウント（すべてのサブアカウントを含む）は、以下の両方の条件を満たす必要があります。
-
未決済ポジションがないこと
-
残高がゼロであること
ステップ 4. ユーザーがGate APIキーをFireblocksワークスペースにバインド
ユーザーはFireblocksに戻り、ワークスペース設定でGate APIキーをバインドします。
このステップの後、Fireblocksはユーザーに代わってGateと連携できるようになります（委任、決済など）。
ステップ 5. ユーザーが対応通貨ごとに委任を開始（Gateでウォレット作成をトリガー）
ユーザーはFireblocksが対応している各決済通貨を委任します。
委任の動作：
- Fireblocks → Gate リクエストをトリガー
- Gateがその資産に対応するウォレットアドレスを自動生成
注意事項：
- 最初の委任試行は失敗する可能性が高い（ウォレットがまだ初期化されていない）→ このエラーは無視できます
- 約10分待ってから再度委任すると成功します
- 各対応決済資産はウォレットを有効化するために少なくとも1回委任する必要があります
ユーザー入金＆ガス手数料担保（保証）
従来のOESモデルでは、双方が互いのウォレットに数百万ドル規模の担保を預ける必要があります。
FireblocksセルフカストディOESモードの場合：
-
Gateはユーザーに対してGateへ大量の担保を預けることを要求しません。
-
ユーザーは自身のFireblocksワークスペース内に、100 USDT相当のメインチェーン資産を維持する必要があります。（Gateへ委任する場合）
-
Gateは決済Gas手数料をカバーするため、この少額を凍結します。
-
資産はFireblocks内で完全にセルフカストディされた状態で保持され、ワークスペース外へ出ることはありません。
-
ユーザーは自身のFireblocksワークスペース内に、50 USDT相当のメインチェーン資産を維持する必要があります。（Gateへ委任しない場合）
-
合計で 150 USDT のメインチェーン担保が必要です。
利点： 必要担保は 数百万ドル → 数百USDT まで大幅に削減されます。
メインチェーン資産の詳細
① ユーザーがメインチェーン資産をFireblocksワークスペースへ入金
各決済チェーンには、それに対応するメインチェーンコインが必要です。
例：
- ERC → ETH
- BRC → BTC
- Solana → SOL
- Tron → TRX
② 100 USDT相当のメインチェーンコインをGateへ委任
Gateはこの金額を ガス手数料担保 として自動的に凍結します。
③ Gateのマッピングウォレット残高を ≥ 100 USDT に維持
これにより、十分なガス手数料を確保できます。
④ 追加で約50 USDT分のメインチェーンコインを準備
（Fireblocksワークスペース内）
複数の決済トランザクションのガス手数料をカバーするために使用されます。
対応決済通貨 & メインチェーン要件
| 決済通貨 | チェーン | ガス手数料トークン |
|---|---|---|
| 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. 決済前提条件 & 失敗処理
3.1 Gateによる決済エラー報告
Gateは構造化された決済エラーデータを提供できます。
ただし、このデータはクライアントへ直接ではなく、Fireblocksへ提供されます。
提供される情報：
- 決済通貨
- 決済金額
- 決済ネットワーク（ERC / BRC / Solana / Tron）
- 必要なメインチェーン資産
- 必要なメインチェーン金額
3.2**決済が失敗した場合（例：ガス手数料不足）**
GateはFireblocksへ標準化されたエラー構造を返します。
ただし、Fireblocksは現時点ではこれらのエラーを完全には表示していません。
ユーザーが決済失敗に遭遇した場合：
→ 詳細な原因についてはAPIサポート担当者へお問い合わせください。
エラー応答例
{
"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のマッピングウォレット残高を増加 → 決済を再試行
エンドツーエンド最終プロセス概要
初期化フェーズ
- ユーザーがFireblocksに連絡
- Fireblocksがワークスペースを作成
- FireblocksがそれをOESワークスペースとして設定
- ユーザーがGate APIキーを生成
- ユーザーがFireblocksでAPIキーをバインド
- ユーザーが対応する各通貨を委任（最初の試行は失敗 → 10分待機 → 再試行）
ガス手数料担保フェーズ
- ユーザーがメインチェーンコインをFireblocksワークスペースへ入金
- ユーザーが100 USDT相当のメインチェーンコインをGateへ委任（凍結）
- Gateのマッピングウォレット残高を ≥ 100 USDT に維持
- 繰り返し決済のため、ワークスペース内に約50 USDT相当のメインチェーン資産を維持
決済フェーズ
- Gateが必要なメインチェーンガスを計算し、決済を開始
- ガスが不足している場合 → Gateが標準化されたエラーを返す
- ユーザーがガスを補充 → 決済を再試行
