参加者

ユーザー
Fireblocks
Gate（OESモジュール）

1. ワークスペース初期化プロセス

（ユーザー & Fireblocksによって対応）

ステップ1. ユーザーがFireblocksに連絡し、ワークスペース作成を依頼

ユーザーがFireblocksに申請し、Fireblocksが新しいワークスペースを作成します。

ステップ2. FireblocksがワークスペースをOESワークスペースとして設定

Fireblocksは、ワークスペースをGateのOESモードに対応させ、Delegate、Undelegate、Gas Fee支払いなどの必要な機能を有効化します。

ステップ3. ユーザーがGateでAPIキーを生成

ユーザーはGateプラットフォームにログインし、Fireblocks専用のAPIキーを生成します。
要件：

Gateメインアカウントによって作成されている必要があります。
メインアカウント（および全てのサブアカウント）が以下の条件を満たしている必要があります：
未決済ポジションがないこと
残高がゼロであること

ステップ4. ユーザーがGate APIキーをFireblocksワークスペースに紐付け

ユーザーはFireblocksに戻り、ワークスペース設定でGateのAPIキーを紐付けます。
このステップ以降、Fireblocksはユーザーに代わってGateとやり取り（デリゲート、決済など）が可能になります。

ステップ5. ユーザーが各対応通貨をデリゲート（Gate内ウォレット作成をトリガー）

ユーザーはFireblocksがサポートする各決済通貨をデリゲートします。
デリゲート時の動作：

Fireblocks → Gateへのリクエストをトリガー
Gateがその資産用のマッピング済みウォレットアドレスを自動生成

注意点：

最初のデリゲートは失敗する可能性が高い（ウォレットがまだ初期化されていないため）→ このエラーは無視してOK
約10分待ってから再度デリゲートすると成功
サポートされている各決済資産ごとに少なくとも1回デリゲートしてウォレットを有効化する必要あり

ユーザーの入金 & ガス料金担保（保証金）

従来のOESモデルでは、双方が相手のウォレットに数百万ドル規模の担保を預ける必要がありました。
FireblocksセルフカストディOESモードでは：

Gateはユーザーに多額の担保をGateへ預けることを要求しません。
ユーザーは自身のFireblocksワークスペース内に100 USDT相当のメインチェーン資産を維持する必要があります（gateにデリゲート）。
Gateはこの少額を決済のガス料金分として凍結します。
資産は完全にFireblocks内でセルフカストディされ、ワークスペースから出ることはありません。
ユーザーはさらに50 USDT相当のメインチェーン資産を自身のFireblocksワークスペース内に維持する必要があります（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が標準化エラーを返す
ユーザーがガスを補充 → 決済を再試行

Fireblocksユーザー統合ガイド

参加者