Центр допомоги
Керівництво
Функціональні рекомендації

Посібник з інтеграції користувачів Fireblocks

25 Хвилини 52 сек тому
5 876 Прочитайте
1

Учасники

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

1. Процес ініціалізації робочого простору

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

Крок 1. Користувач звертається до Fireblocks – запит на створення робочого простору

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

Крок 2. Fireblocks налаштовує робочий простір як робочий простір OES

Fireblocks налаштовує робочий простір для сумісності з режимом OES Gate та вмикає необхідні можливості, такі як Делегування, Скасувати делегування, Оплата комісії за газ тощо.

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

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

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

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

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

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

2

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

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

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

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

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

Примітки:

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

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

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

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

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

  • Gate заморозить цю невелику суму для покриття розрахункових зборів за газ.

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

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

  • Загалом 150 USDT необхідних коштів на забезпечення основного ланцюжка

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

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

① Користувач розміщує активи основного ланцюжка в робочому просторі Fireblocks

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

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

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

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, а не клієнтам безпосередньо.
Надана інформація:

  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
  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. Користувач поповнює газ → повторна спроба розрахунку
Зареєструйтесь зараз, щоб отримати шанс виграти до $10,000!
signup-tips