Помощь
Руководство
Функциональные рекомендации

Руководство интеграции пользователей Fireblocks

21 Минуты 57 сек назад
5 981 Прочли
3

Участники

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

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

(Обработано пользователем и fireblocks)

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

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

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

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

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

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

  • Должно быть создано основным аккаунтом Gate.

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

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

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

2

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

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

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

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

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

Примечания:

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

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

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

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

  • Пользователь должен поддерживать в своем собственном Fireblocks Workspace основной актив основной сети на сумму, эквивалентную 100 USDT. (делегировать Gate)

  • Gate заморозит эту небольшую сумму, чтобы покрыть комиссии за урегулирование газа.

  • Активы остаются полностью самоохраняемыми внутри Fireblocks и никогда не покидают рабочее пространство.

  • Пользователь должен поддерживать эквивалент 50 USDT основных активов в своей собственной Fireblocks Workspace. (не делегируя это Gate)

  • В общей сложности 150 USDT требуется в качестве залога основного блокчейна

Преимущество: Требование к залогу снизилось с миллионов → ~сотен USDT .

Детали активов основного блокчейна

① Пользователь вносит активы основного блокчейна в Fireblocks Workspace

Каждый блокчейн расчетов должен иметь соответствующую основную монету.
Примеры:

  • 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 может предоставлять структурированные данные об ошибках расчетов:
Предварительные условия расчетов и обработка сбоев.
Информация предоставлена:

  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’s Logic

  • Обнаруживает недостаток баланса главного блокчейна → возвращает ошибку
  • Пользователь восстанавливает актив основного блокчейна или увеличивает баланс кошелька с картой Gate → повторяет расчеты

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

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

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

Фаза обеспечения в виде газа

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

Фаза расчета

  1. Gate рассчитывает необходимый газ в главном блокчейне и начинает расчет
  2. Если газа недостаточно → Gate возвращает стандартизированную ошибку
  3. Пользователь пополняет газ → повторяется расчет
Зарегистрируйтесь сейчас и получите шанс выиграть до $10,000!
signup-tips