参与方说明
- 用户
- 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 balance
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
