Учасники

• Користувач
• Fireblocks
• Gate (модуль OES)

1. Процес ініціалізації Workspace

(Виконується користувачем і Fireblocks)

Крок 1. Користувач звертається до Fireblocks — Запит на створення Workspace

Користувач подає заявку у Fireblocks, після чого Fireblocks створює для нього новий workspace.

Крок 2. Fireblocks налаштовує Workspace як OES Workspace

Fireblocks налаштовує workspace для сумісності з OES-режимом Gate та активує необхідні можливості, такі як Delegate, Undelegate, Оплата Gas Fee тощо.

Крок 3. Користувач генерує API-ключ на Gate

Користувач входить на платформу Gate та генерує API-ключ спеціально для Fireblocks.
Вимоги:

• Має бути створений основним акаунтом Gate.

• Основний акаунт (разом із усіма субакаунтами) повинен відповідати обом умовам:

• Відсутність відкритих позицій

• Нульовий баланс

Крок 4. Користувач прив’язує API-ключ Gate до Workspace Fireblocks

Користувач повертається у Fireblocks та додає API-ключ Gate у налаштуваннях Workspace.
Після цього Fireblocks може взаємодіяти з Gate від імені користувача (делегування, розрахунки тощо).

Крок 5. Користувач починає делегувати кожну підтримувану валюту (ініціює створення гаманця на Gate)

Користувач делегує кожну валюту для розрахунків, яку підтримує Fireblocks.
Дії при делегуванні:

• Ініціює запит Fireblocks → Gate
• Gate автоматично створює відображену адресу гаманця для цього активу

Примітки:

• Перша спроба делегування, ймовірно, зазнає невдачі (гаманець ще не ініціалізовано) → цю помилку можна ігнорувати
• Зачекайте ~10 хвилин, потім повторіть делегування для успіху
• Кожен підтримуваний актив для розрахунків має бути делегований хоча б один раз для активації гаманця

Депозит користувача та Gas Fee-застава (гарантія)

У традиційній OES-моделі обидві сторони мають внести багатомільйонну заставу у гаманці одна одної.
У режимі самостійного зберігання Fireblocks OES:

• Gate не вимагає від користувача вносити велику заставу на Gate.

• Користувач має підтримувати у своєму Workspace Fireblocks активи основного ланцюга на суму, еквівалентну 100 USDT. (делегувати на Gate)

• Gate заморожує цю невелику суму для покриття Gas Fee розрахунків.

• Активи залишаються повністю під самостійним зберіганням у Fireblocks і ніколи не залишають workspace.

• Користувач має підтримувати у своєму Workspace Fireblocks активи основного ланцюга на суму, еквівалентну 50 USDT. (без делегування на Gate)

• Загалом потрібно 150 USDT застави в основному ланцюзі

Перевага: Вимога до застави зменшується з мільйонів → ~сотень USDT.

Деталі активів основного ланцюга

① Користувач вносить активи основного ланцюга у Workspace Fireblocks

Кожен ланцюг розрахунків має мати відповідну монету основного ланцюга.
Приклади:

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

② Делегування суми монет основного ланцюга, еквівалентної 100 USDT, на Gate

Gate автоматично заморожує цю суму як заставу Gas Fee.

③ Підтримуйте баланс відображеного гаманця Gate ≥ 100 USDT

Це гарантує достатню наявність Gas Fee.

④ Підготуйте додатково ~50 USDT у монетах основного ланцюга

(У Workspace Fireblocks)
Використовується для покриття кількох розрахункових транзакцій.

Підтримувані валюти розрахунків та вимоги до основного ланцюга

3. Передумови розрахунків та обробка збоїв

3.1 Звітність про помилки розрахунків від Gate

Gate може надавати структуровані дані про помилки розрахунків:
Але ці дані передаються у fireblocks, а не безпосередньо клієнтам.
Надається така інформація:

1. Валюта розрахунку
2. Сума розрахунку
3. Мережа розрахунку (ERC / BRC / Solana / Tron)
4. Необхідний актив основного ланцюга
5. Необхідна сума основного ланцюга

3.2 Якщо розрахунок не вдається (наприклад, недостатньо Gas Fee)

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 → повторює розрахунок

Підсумок фінального процесу end-to-end

Фаза ініціалізації

1. Користувач звертається до Fireblocks
2. Fireblocks створює Workspace
3. Fireblocks налаштовує його як OES Workspace
4. Користувач генерує API-ключ Gate
5. Користувач прив’язує API-ключ у Fireblocks
6. Користувач делегує кожну підтримувану валюту (перша спроба неуспішна → зачекати 10 хв → повторити)

Фаза Gas Fee-застави

1. Користувач вносить монети основного ланцюга у Workspace Fireblocks
2. Користувач делегує еквівалент 100 USDT у монетах основного ланцюга на Gate (заморожується)
3. Підтримуйте баланс відображеного гаманця Gate ≥ 100 USDT
4. Підтримуйте ~50 USDT в активах основного ланцюга у Workspace для повторних розрахунків

Фаза розрахунків

1. Gate розраховує необхідний Gas основного ланцюга та ініціює розрахунок
2. Якщо Gas недостатньо → Gate повертає стандартизовану помилку
3. Користувач поповнює Gas → повторює розрахунок