Архитектура
Hypercall использует гибридную модель исполнения: сведение заявок вне блокчейна ради скорости, а расчёты и управление аккаунтами в блокчейне ради безопасности.
Границы доверия
Вне блокчейна (бэкенд Hypercall)
Зона ответственности:
- Сведение и исполнение заявок
- Ведение книги заявок
- Предторговые проверки маржи, включая портфельную проверку перед каждой заявкой по перпам
- Управление ликвидациями
- Рыночные данные и ценообразование
- Потоки WebSocket
Допущение о доверии: во всём перечисленном выше вы доверяете оператору. См. Модель доверия.
В блокчейне (смарт-контракты)
Зона ответственности:
- Владение аккаунтом и контроль менеджера
- Депозиты и вывод средств
- Команды RSM (операции управления рисками)
- Токены опционов (контракты OptionRegistry и OptionToken)
- Одобрение билдера для заявок по перпам (однократный вызов
approveZeroFeeBuilderс вашего Account)
Допущение о доверии: операции в блокчейне записываются в Hyperliquid, и оператор не может изменить их в одиночку. Кто может обновлять контракты, описано в разделе Модель доверия.
Процесс исполнения заявки
1. Подача заявки
Действие пользователя: отправка заявки через POST /order с подписью EIP-712.
Проверка на бэкенде:
- Проверка подписи (EIP-712)
- Предторговые проверки маржи (на основе сценариев)
- Допуск заявки (уровень, экспирация, лимиты частоты запросов)
Результат: заявка принимается (ACKED) и ставится в очередь на сведение либо отклоняется с указанием причины.
2. Сведение заявок
Процесс: заявки сводятся в книге заявок по приоритету цены и времени.
Исполнение: при совпадении заявок создаются сделки (fills), а позиции обновляются в состоянии движка. Каждое изменение состояния записывается в надёжный журнал движка до подтверждения, а таблицы базы данных строятся на основе этого журнала.
Не в блокчейне: отдельные сделки по опционам в блокчейне не записываются.
3. Обновление позиций
Процесс: позиции по опционам и денежные средства учитываются в состоянии движка и обновляются в реальном времени. Позиции по перпам находятся в реестре HyperCore вашего аккаунта в Hyperliquid.
Доступ пользователя: запрос позиций через GET /portfolio или канал WebSocket portfolio.
4. Расчёт
Расчёт при экспирации: опционы рассчитываются деньгами при экспирации по расчётной цене, полученной из оракула Hyperliquid. Движок записывает расчётную цену в свой журнал, вычисляет внутреннюю стоимость каждой позиции, обновляет денежные балансы и закрывает позиции.
Время экспирации для каждого базового актива, порядок вычисления расчётной цены и действия при недостатке данных описаны в разделах Расчёт и Оракулы.
Управление аккаунтом
Создание аккаунта
Процесс: кошелёк менеджера вызывает createAccount в контракте Factory с небольшим депозитом в HYPE за создание. Приложение делает это за вас, когда вы включаете перпы или Portfolio Margin. См. Онбординг (контракты).
Менеджер: у каждого Account есть менеджер (EOA), который управляет им и может авторизовать API-кошельки для подписи заявок и отмен.
Депозиты и вывод средств
Депозиты:
- USDC: отправляется в HyperEVM на контракт Exchange (
depositUsdcFor), который переводит его через мост на баланс Exchange в HyperCore. Hypercall зачисляет средства, как только депозит в HyperCore зафиксирован. - ERC20-токены опционов: вносятся через контракт Exchange, который сжигает их и зачисляет позицию.
Вывод средств:
- Должен пройти проверку маржи Hypercall (после вывода маржи должно быть достаточно)
- Подписывается вашим кошельком. Стандартный вывод USDC выплачивается в HyperCore с баланса Exchange через директиву RSM. Вывод в режиме Portfolio Margin выполняется как перевод с вашего Account в HyperCore, подписанный менеджером.
Граница доверия: депозиты и вывод средств проходят в блокчейне и поддаются проверке.
Ликвидация
Когда капитал аккаунта опускается ниже требования поддерживающей маржи, аккаунт переходит в состояние предликвидации:
- Заявки, увеличивающие риск, блокируются; закрывающие заявки по-прежнему разрешены.
- Ликвидатор выставляет заявки частичной ликвидации, чтобы восстановить маржу, с бонусом ликвидатора, который со временем растёт.
- Если аккаунт не восстановился в пределах окна эскалации, он переходит к полной ликвидации, которую проводит движок Hypercall.
Подробности см. в разделе Ликвидация.
Интеграция с Hyperliquid
Перпы
Hypercall направляет заявки по перпам в Hyperliquid, включая рынки HIP-3 на dex xyz. Каждая заявка по перпам сначала проверяется по всему вашему портфельному маржинальному счёту. Дальше есть два маршрута. Приложение по умолчанию использует TEE, а маршрут через смарт-контракт доступен как расширенная настройка; API-клиенты выбирают маршрут через вызываемый эндпоинт:
Маршрут через смарт-контракт (расширенная настройка в приложении): вы подписываете заявку → движок Hypercall проверяет её по всему вашему портфельному маржинальному счёту → заявка уходит в блокчейн через контракт вашего аккаунта в HyperCore → Hyperliquid сводит её
Маршрут через TEE (по умолчанию в приложении, через API по явному выбору): вы подписываете заявку → движок проверяет её → защищённый анклав (TEE), в котором хранится торговый ключ Hyperliquid вашего аккаунта, подписывает нативную заявку → Hyperliquid сводит её
Через анклав проходят только заявки маршрута TEE. Такие заявки несут адрес билдера Hypercall, поэтому аккаунт один раз одобряет билдера (Enable trading), а анклав подписывает только одобренные движком заявки, отмены и изменения кредитного плеча. См. Перпы в Hypercall.
Сценарии использования:
- Дельта-хеджирование опционных позиций
- Кросс-маржа: позиции по перпам учитываются в портфельной марже
Кросс-маржа
Позиции по перпам в HyperCore включаются в расчёт портфельной маржи, а требование равно большему из двух значений: результата портфельной маржи и собственной маржи Hyperliquid. Portfolio Margin доступен для всех аккаунтов; см. Подключение к Portfolio Margin.
Команды RSM
RSM: реплицируемый конечный автомат (replicated state machine) движка. Когда состояние движка требует действия в блокчейне (зачисление, вывод, шаг ликвидации или восстановительный ордер), подписант RSM подписывает директиву, а секвенсор Hypercall её отправляет. Расчёт опционов на экспирации не является директивой RSM: он применяется к денежному балансу в состоянии движка. Что может каждая директива, перечислено в разделе Директивы RSM.
Что можно проверить
В блокчейне (проверяемо)
- Владение аккаунтом (адрес менеджера)
- Депозиты и вывод средств
- Заявки и позиции по перпам в Hyperliquid (в Hyperliquid)
- Команды RSM (исполнение в блокчейне)
Вне блокчейна (требуется доверие)
- Честность сведения заявок
- Расчёты маржи
- Вычисление расчётной цены (входные данные оракула Hyperliquid публичны)
- Точность учёта позиций
- Точность рыночных данных
- Момент срабатывания ликвидации
Модель доверия
Mainnet Alpha управляется оператором. Вы доверяете Hypercall в том, что он честно сводит заявки (приоритет по цене и времени), принимает точные рыночные данные, корректно считает маржу и расчётные цены, вовремя запускает ликвидации, выдаёт только корректные директивы RSM и реагирует на инциденты. Ничто из этого пока не проверяемо криптографически; сведение заявок вне блокчейна даёт скорость ценой этого доверия. Остальное обеспечивает блокчейн: владение аккаунтом, депозиты и выводы проходят в блокчейне, Account исполняет только директивы, подписанные его менеджером, одним из его API-кошельков или зарегистрированным подписантом RSM, а контракты ограничивают директивы RSM зачислениями, выводами, состоянием ликвидации и ограниченными восстановительными действиями. Заявки по перпам на маршруте TEE (по умолчанию в приложении) подписываются внутри аттестованного анклава, который принимает только одобренные движком заявки. Подписант RSM, секвенсор и ключи администрирования и обновления контрактов находятся под контролем оператора, а одно обновление Account применяется ко всем аккаунтам. Точные полномочия, роли и адреса приведены в разделе Доверие и права доступа. Дорожная карта децентрализации RSM опишет, как обязательства по состоянию (state commitments), роли подписантов, механизмы оспаривания и операторский контроль станут проверяемыми; Mainnet Alpha это ограниченная первая фаза, а не итоговая модель доверия.
См. также:
- Расчёт и экспирация - Процесс расчёта и жизненный цикл
- Ликвидация - Конечный автомат ликвидации и её механика
- Контракты - Документация по смарт-контрактам