Modos de Falha
Comportamento do sistema durante interrupções e condições degradadas.
Filosofia de Design
A Hypercall mantém a negociação ativa onde for possível e falha de forma segura (fail closed) quando falta um dado de preço ou de margem. Durante falhas:
- A negociação continua onde os dados necessários são válidos
- Componentes com falha são isolados
- Os usuários recebem erros explícitos em vez de dados desatualizados ou preços inventados
Indisponibilidade da L1
Se a L1 da Hyperliquid (HyperCore) ficar indisponível:
| Função | Comportamento |
|---|---|
| Matching de opções | Continua no livro da Hypercall enquanto os dados de preço e volatilidade permanecerem válidos |
| Ordens de perpétuos | Indisponíveis. Os perpétuos são executados na Hyperliquid. |
| Liquidações | Adiadas até que existam amostras suficientes do oráculo (veja abaixo) |
| Depósitos | Bloqueados até a L1 se recuperar |
| Saques | Bloqueados até a L1 se recuperar |
A recuperação é automática assim que a L1 volta a ficar disponível.
Falhas de Oráculo
Oráculo de Preço
Se o oráculo de preço ficar indisponível:
| Impacto | Comportamento |
|---|---|
| Ordens que aumentam o risco | Rejeitadas quando o último preço spot registrado tiver mais de 30 segundos |
| Ordens que reduzem o risco | Aceitas, avaliadas pelo último preço registrado |
| Avaliação de margem e de liquidação de contas | Continua pelo último preço registrado. Nenhum preço substituto é gerado. |
| Preço de liquidação no vencimento | Nunca é tirado do último preço registrado. Veja Oráculo Fora do Ar no Vencimento. |
Um feed saudável registra novamente um preço inalterado pelo menos a cada 10 segundos, então um mercado lateral não aciona o limite de 30 segundos. A recuperação é automática quando o oráculo volta.
Oráculo de IV
Se o oráculo de IV falhar:
| Impacto | Comportamento |
|---|---|
| Novas ordens | Ordens que aumentam o risco no ativo subjacente afetado são rejeitadas |
| Precificação de opções | Sem preço de fallback. Cálculos que dependem da IV ausente falham. |
| Cálculos de margem | Falham de forma segura em vez de usar uma volatilidade substituta |
Veja Oráculo de Volatilidade para as condições exatas.
Falhas de Liquidação
Oráculo Fora do Ar no Vencimento
Os preços de liquidação usam uma janela de TWAP de 30 minutos antes do vencimento. As regras de marcação durante interrupções descritas acima não se aplicam ao preço de liquidação. Se os dados do oráculo estiverem indisponíveis:
- Interrupção parcial: o TWAP só é calculado se a janela contiver pelo menos 500 amostras. A Hypercall pode reconstruir uma janela curta a partir do histórico arquivado do oráculo da Hyperliquid, sob o mesmo mínimo.
- Interrupção total: a liquidação aguarda até que exista uma janela com pelo menos 500 amostras. Ela não é feita com base no último preço registrado, em uma janela parcial nem em um preço substituto.
A liquidação também pode ser adiada sem uma interrupção se o TWAP finalizado não estiver disponível no instante exato do vencimento. Nesse caso, o instrumento permanece em Expired Pending Price, a negociação continua desabilitada e a liquidação é tentada novamente de forma automática até que o preço finalizado exista.
O algoritmo de TWAP foi projetado para resistir a manipulação. Veja Oráculos para mais detalhes.
Indisponibilidade da API
Se a API da Hypercall ficar indisponível:
| Componente | Status |
|---|---|
| Negociação | Indisponível. Ordens de opções, cancelamentos e ordens de perpétuos passam todos pela API da Hypercall. |
| Posições e saldos | Mantidos no journal durável do motor e restaurados na reinicialização |
| Ordens abertas | Fazem parte do estado do motor e são restauradas na reinicialização. Você não consegue cancelá-las até a API voltar. |
| Posições em perpétuos | Permanecem na sua conta da Hyperliquid |
| Assinaturas WebSocket | Desconectadas |
Recomendações
- Implemente lógica de reconexão com backoff exponencial
- Mantenha dados críticos em cache localmente
- Verifique
GET /healthantes de negociar - Considere que ordens em aberto continuam ativas durante uma interrupção da API e dimensione suas cotações em aberto levando isso em conta
Endpoint de Saúde
| Endpoint | Finalidade |
|---|---|
GET /health | Verificação básica de liveness |
GET /ready | Prontidão completa, incluindo dependências |
Comunicação de Incidentes
Durante incidentes, verifique:
- Página de status: status.hypercall.xyz
- X: @SynapseProtocol
- Telegram: t.me/hypercall_trollbox
- Discord: discord.gg/4rMzuEnKqe