Цю сторінку перекладено автоматично. Оригінал англійською мовою є канонічним. Читати англійською →
Перейти к основному содержимому

Ранбуки

Повний чекліст готовності деску та сертифікаційні тести інтеграції.

Чекліст готовності деску​

Перед запуском перевірте:

Підключення до API​

  • Налаштовано продакшн-ендпоінти
  • Ендпоінт перевірки стану відповідає
  • З'єднання WebSocket стабільне

Автентифікація​

  • Підписання EIP-712 працює
  • Налаштовано авторизацію агента (за потреби)
  • Реалізовано керування nonce
  • Протестовано перевірку підпису

Система котирування​

  • Протестовано пакетне розміщення ордерів
  • Перевірено звірку життєвого циклу ордерів
  • Реалізовано відстеження виконань
  • Протестовано функцію скасування

Контроль ризиків​

  • MMP налаштовано й протестовано
  • Модель маржі зрозуміла
  • Перевірено обмеження рівнів
  • Реалізовано моніторинг портфеля

Моніторинг​

  • Оформлено підписки на фіди WebSocket
  • Автоматизовано звірку ордерів і виконань
  • Налаштовано перевірки стану
  • Налаштовано сповіщення

Аварійний вимикач​

  • Можливість скасувати всі ордери
  • Можливість негайно від'єднатися
  • Задокументовано аварійні процедури

Хеджування​

  • Перевірено інтеграцію з перпами Hyperliquid
  • Реалізовано стратегію дельта-хеджування
  • Розрахунок маржі для перпів зрозумілий

Розрахунок​

  • Протестовано обробку експірації
  • Перевірено розрахунок за позиціями
  • Джерело референсної ціни зрозуміле

Сертифікаційні тести інтеграції​

Тест 1: Розміщення ордера​

Кроки:

  1. Розмістіть один ордер через POST /order
  2. Перевірте, що статус у відповіді на ордер ACKED або OPEN
  3. Переконайтеся, що ордер з'являється в GET /orders?wallet=...
  4. Перевірте, що отримано повідомлення WebSocket order_updates

Очікуваний результат: ордер успішно розміщено, оновлення статусу отримано

Тест 2: Пакетне розміщення ордерів​

Кроки:

  1. Розмістіть 10 ордерів через POST /bulk_order
  2. Перевірте, що всі ордери прийнято
  3. Перевірте статуси ордерів через REST і WS
  4. Переконайтеся, що немає помилок підпису чи автентифікації

Очікуваний результат: усі ордери успішно розміщено

Тест 3: Відстеження виконань​

Кроки:

  1. Розмістіть ордер, який буде виконано
  2. Відстежуйте канал WebSocket fills
  3. Перевірте, що отримано виконання з правильним order_id
  4. Переконайтеся, що виконання з'являється в GET /fills?wallet=...
  5. Перевірте, що статус ордера оновився до FILLED

Очікуваний результат: виконання відстежуються коректно, статус ордера оновлено

Тест 4: Відстеження часткових виконань​

Кроки:

  1. Розмістіть ордер, який буде виконано частково
  2. Відстежуйте канали WebSocket fills і order_updates
  3. Перевірте, що часткове виконання надходить у fills
  4. Перевірте, що order_updates повідомляє PARTIALLY_FILLED з накопиченим filled_size
  5. Згрупуйте виконання за order_id і перевірте, що загальна сума дорівнює filled_size

Очікуваний результат: обсяги окремих виконань у fills, накопичений виконаний обсяг у order_updates

Тест 5: Скасування ордера​

Кроки:

  1. Розмістіть ордер через POST /order
  2. Скасуйте ордер через DELETE /order
  3. Перевірте статус ордера: CANCELED
  4. Переконайтеся, що отримано повідомлення WebSocket order_updates

Очікуваний результат: ордер успішно скасовано, оновлення статусу отримано

Тест 6: Спрацювання MMP​

Кроки:

  1. Налаштуйте MMP через підписаний POST /mmp-config. Надсилайте X-Hypercall-Fence-Wait: 1, якщо клієнт одразу читатиме проєкцію, і збережіть повернуте значення X-Hypercall-Fence.
  2. Розмістіть ордери з увімкненим MMP
  3. Ініціюйте спрацювання MMP, перевищивши ліміти
  4. Перевірте, що ордери скасовано з причиною MMP
  5. Переконайтеся, що інші ордери з увімкненим MMP також скасовано

Очікуваний результат: MMP спрацьовує коректно, ордери скасовано

Читання конфігурації MMP також потребує автентифікації. Підпишіть GetMmpConfig і надішліть його термін дії та підпис у заголовках X-Hypercall-Expires-At-Ms і X-Hypercall-Signature. Передайте в цьому GET значення X-Hypercall-Fence з відповіді на запис, щоб дочекатися саме цієї зафіксованої конфігурації. Записи без X-Hypercall-Fence-Wait: 1 навмисно не повертають заголовок fence.

Тест 7: Відхилення через маржу​

Кроки:

  1. Розмістіть ордер, що перевищує доступну маржу
  2. Перевірте, що ордер відхилено з причиною "Insufficient margin"
  3. Переконайтеся, що причина відхилення містить значення вимоги, капіталу та дефіциту
  4. Перевірте статус ордера: REJECTED

Очікуваний результат: ордер відхилено із зрозумілою причиною

Тест 8: Обмеження рівня​

Кроки:

  1. Використайте гаманець, рівень якого дозволяє лише покриті продажі (перевірте GET /risk/limits?wallet=...)
  2. Спробуйте розмістити ордер на продаж без довгої позиції
  3. Перевірте, що ордер відхилено з причиною, пов'язаною з рівнем
  4. Розмістіть ордер на купівлю (має бути успішним)
  5. Розмістіть ордер на продаж для закриття позиції (має бути успішним)

Очікуваний результат: обмеження рівня застосовуються коректно

Тест 9: Повторне підключення WebSocket​

Кроки:

  1. Підключіться до WebSocket
  2. Підпишіться на канали
  3. Від'єднайте WebSocket
  4. Підключіться повторно з експоненційною затримкою
  5. Повторно підпишіться на канали
  6. Опитайте REST, щоб отримати пропущені оновлення

Очікуваний результат: повторне підключення працює, стан відновлено

Тест 10: Звірка портфеля​

Кроки:

  1. Розмістіть ордери та дочекайтеся їх виконання
  2. Перевірте портфель через GET /portfolio?wallet=...
  3. Переконайтеся, що позиції відповідають виконанням
  4. Перевірте коректність використання маржі
  5. Звірте з оновленнями WebSocket portfolio

Очікуваний результат: стан портфеля точний, звірка успішна

Готовність до продакшну​

Чекліст перед продакшном​

  • Усі інтеграційні тести пройдено
  • Налаштовано моніторинг і сповіщення
  • Аварійний вимикач протестовано
  • Задокументовано аварійні процедури
  • Команду навчено реагуванню на інциденти
  • Визначено контакти підтримки

Чекліст запуску​

  • Сертифікаційні тести пройдено з малим обсягом у продакшні
  • Продакшн-ендпоінти перевірено
  • Дашборди моніторингу готові
  • Налаштовано сповіщення
  • Складено графік чергувань команди
  • Документацію переглянуто

Посилання​

Останнє оновлення