Modos de fallo
Comportamiento del sistema durante caídas y condiciones degradadas.
Filosofía de diseño
Hypercall mantiene el trading activo donde puede y falla de forma cerrada cuando falta un dato de precio o de margen. Durante los fallos:
- El trading continúa donde los datos requeridos son válidos
- Los componentes que fallan quedan aislados
- Los usuarios reciben errores explícitos en lugar de datos desactualizados o precios inventados
Caída de L1
Si la L1 de Hyperliquid (HyperCore) deja de estar disponible:
| Función | Comportamiento |
|---|---|
| Matching de opciones | Continúa en el libro de órdenes de Hypercall mientras los datos de precio y volatilidad sigan siendo válidos |
| Órdenes de perpetuos | No disponibles. Los perpetuos se ejecutan en Hyperliquid. |
| Liquidaciones al vencimiento | Se retrasan hasta que existan suficientes muestras del oráculo (ver más abajo) |
| Depósitos | Bloqueados hasta que la L1 se recupere |
| Retiros | Bloqueados hasta que la L1 se recupere |
La recuperación es automática una vez que la L1 vuelve a estar disponible.
Fallos del oráculo
Oráculo de precios
Si el oráculo de precios deja de estar disponible:
| Impacto | Comportamiento |
|---|---|
| Órdenes que aumentan el riesgo | Se rechazan cuando el último precio spot registrado tiene más de 30 segundos de antigüedad |
| Órdenes que reducen el riesgo | Se aceptan, valoradas al último precio registrado |
| Valoración de margen y liquidación | Continúa al último precio registrado. No se genera ningún precio sustituto. |
| Precio de settlement al vencimiento | Nunca se toma del último precio registrado. Consulte Oráculo caído al vencimiento. |
Un feed en buen estado vuelve a registrar un precio sin cambios al menos cada 10 segundos, de modo que un mercado plano no activa el límite de 30 segundos. La recuperación es automática cuando el oráculo vuelve a funcionar.
Oráculo de IV
Si el oráculo de IV falla:
| Impacto | Comportamiento |
|---|---|
| Nuevas órdenes | Se rechazan las órdenes que aumentan el riesgo sobre el activo subyacente afectado |
| Valoración de opciones | Sin precio de respaldo. Los cálculos que requieren la IV faltante fallan. |
| Cálculos de margen | Fallan de forma cerrada en lugar de usar una volatilidad sustituta |
Consulte Oráculo de volatilidad para ver las condiciones exactas.
Fallos en el settlement
Oráculo caído al vencimiento
Los precios de liquidación al vencimiento usan una ventana TWAP de 30 minutos antes del vencimiento. Las reglas de caída para la valoración descritas arriba no se aplican al precio de settlement. Si los datos del oráculo no están disponibles:
- Caída parcial: el TWAP solo se calcula si la ventana contiene al menos 500 muestras. Hypercall puede reconstruir una ventana corta a partir del historial archivado del oráculo de Hyperliquid, con el mismo mínimo.
- Caída total: el settlement espera hasta que haya una ventana con al menos 500 muestras. No se liquida con el último precio registrado, con una ventana parcial ni con un precio sustituto.
El settlement también puede retrasarse sin que haya una caída si el TWAP finalizado no está disponible en el tick exacto del vencimiento. En ese caso, el instrumento permanece en Expired Pending Price, el trading sigue deshabilitado y el settlement se reintenta automáticamente hasta que exista el precio finalizado.
El algoritmo TWAP está diseñado para resistir la manipulación. Consulte Oráculos para más detalles.
Caída de la API
Si la API de Hypercall deja de estar disponible:
| Componente | Estado |
|---|---|
| Trading | No disponible. Las órdenes de opciones, las cancelaciones y las órdenes de perpetuos pasan todas por la API de Hypercall. |
| Posiciones y saldos | Se conservan en el journal duradero del motor y se restauran al reiniciar |
| Órdenes abiertas | Forman parte del estado del motor y se restauran al reiniciar. No puede cancelarlas hasta que la API vuelva a funcionar. |
| Posiciones en perpetuos | Permanecen en su cuenta de Hyperliquid |
| Suscripciones WebSocket | Desconectadas |
Recomendaciones
- Implemente lógica de reconexión con backoff exponencial
- Guarde en caché local los datos críticos
- Verifique
GET /healthantes de operar - Asuma que las órdenes en reposo siguen activas durante una caída de la API, y dimensione sus cotizaciones en reposo en consecuencia
Endpoint de salud
| Endpoint | Propósito |
|---|---|
GET /health | Verificación básica de actividad |
GET /ready | Disponibilidad completa, incluidas las dependencias |
Comunicación de incidentes
Durante los incidentes, consulte:
- Página de estado: status.hypercall.xyz
- X: @SynapseProtocol
- Telegram: t.me/hypercall_trollbox
- Discord: discord.gg/4rMzuEnKqe