Участники

• Пользователь
• Fireblocks
• Gate (модуль OES)

1. Процесс инициализации рабочего пространства

(Выполняется пользователем и Fireblocks)

Шаг 1. Пользователь обращается в Fireblocks — Запрос на создание рабочего пространства

Пользователь отправляет заявку в Fireblocks, и Fireblocks создает для него новое рабочее пространство.

Шаг 2. Fireblocks настраивает рабочее пространство как OES Workspace

Fireblocks настраивает рабочее пространство для совместимости с режимом OES от Gate и активирует необходимые функции, такие как делегирование , отмена делегирования , оплата комиссий за газ и др.

Шаг 3. Пользователь генерирует API-ключ на Gate

Пользователь входит на платформу Gate и создает API-ключ специально для Fireblocks.
Требования:

• Ключ должен быть создан основным аккаунтом Gate .

• Основной аккаунт (включая все субаккаунты) должен соответствовать двум условиям:

• Нет открытых позиций

• Нулевой баланс

Шаг 4. Пользователь привязывает API-ключ Gate к рабочему пространству Fireblocks

Пользователь возвращается в Fireblocks и привязывает API-ключ Gate в настройках рабочего пространства.
После этого шага Fireblocks может взаимодействовать с Gate от имени пользователя (делегирование, расчеты и др.).

Шаг 5. Пользователь начинает делегировать каждую поддерживаемую валюту (инициирует создание кошелька в Gate)

Пользователь делегирует каждую расчетную валюту, поддерживаемую Fireblocks.
Действия при делегировании:

• Запускает запрос Fireblocks → Gate
• Gate автоматически создает сопоставленный адрес кошелька для этого актива

Примечания:

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

Депозиты пользователя и обеспечение комиссии за газ (гарантия)

В традиционной модели OES обе стороны должны размещать многомиллионное обеспечение в кошельках друг друга.
В режиме самокастоди Fireblocks OES:

• Gate не требует от пользователя размещения крупного обеспечения на Gate.

• Пользователь должен поддерживать эквивалент 100 USDT в основных активах блокчейна в своем рабочем пространстве Fireblocks. (делегировать на 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)
Используется для совершения нескольких расчетных транзакций.

Поддерживаемые расчетные валюты и требования к основным активам

3. Условия расчетов и обработка сбоев

3.1 Сообщения об ошибках расчетов от Gate

Gate может предоставлять структурированные данные об ошибках расчетов:
Однако эти данные передаются fireblocks, а не напрямую клиентам.
Предоставляемая информация:

1. Расчетная валюта
2. Сумма расчета
3. Сеть расчета (ERC / BRC / Solana / Tron)
4. Необходимый основной актив
5. Необходимое количество основного актива

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 — повторяет расчет

Итоговое описание сквозного процесса

Фаза инициализации

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

Фаза обеспечения комиссии за газ

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

Фаза расчетов

1. Gate рассчитывает необходимую комиссию за газ и инициирует расчет
2. Если комиссия недостаточна → Gate возвращает стандартизированную ошибку
3. Пользователь пополняет газ → повторяет расчет