Esta página foi traduzida automaticamente. O original em inglês é a versão canônica. Ler em inglês →
Pular para o conteúdo principal

Runbooks

Checklist completo de prontidão da mesa e testes de certificação de integração.

Checklist de Prontidão da Mesa​

Antes de entrar em produção, verifique:

Conectividade da API​

  • Endpoints de staging testados
  • Endpoints de produção configurados (quando disponíveis)
  • Endpoint de health check respondendo
  • Conexão WebSocket estável

Autenticação​

  • Assinatura EIP-712 funcionando
  • Autorização de agente configurada (se aplicável)
  • Gerenciamento de nonce implementado
  • Verificação de assinatura testada

Sistema de Cotação​

  • Envio de ordens em lote testado
  • Reconciliação do ciclo de vida das ordens verificada
  • Rastreamento de execuções implementado
  • Funcionalidade de cancelamento testada

Controles de Risco​

  • MMP configurado e testado
  • Modelo de margem compreendido
  • Restrições de tier verificadas
  • Monitoramento de portfólio implementado

Monitoramento​

  • Feeds de WebSocket inscritos
  • Reconciliação de ordens/execuções automatizada
  • Health checks configurados
  • Alertas configurados

Kill Switch​

  • Capacidade de cancelar todas as ordens
  • Capacidade de desconectar imediatamente
  • Procedimentos de emergência documentados

Hedge​

  • Integração com os perpétuos da Hyperliquid verificada
  • Estratégia de hedge de delta implementada
  • Cálculo de margem dos perpétuos compreendido

Liquidação (Settlement)​

  • Tratamento de vencimento testado
  • Liquidação de posições verificada
  • Fonte do preço de referência compreendida

Testes de Certificação de Integração​

Teste 1: Envio de Ordem​

Passos:

  1. Envie uma ordem única via POST /order
  2. Verifique o status da ordem: ACKED → OPEN
  3. Confira se a ordem aparece em GET /orders?wallet=...
  4. Verifique se o order_updates do WebSocket foi recebido

Esperado: Ordem enviada com sucesso, atualizações de status recebidas

Teste 2: Envio de Ordens em Lote​

Passos:

  1. Envie 10 ordens via POST /bulk_order
  2. Verifique se todas as ordens foram aceitas
  3. Confira os status das ordens via REST e WS
  4. Verifique que não há erros de assinatura/autenticação

Esperado: Todas as ordens enviadas com sucesso

Teste 3: Rastreamento de Execuções​

Passos:

  1. Envie uma ordem que será executada
  2. Monitore o canal fills do WebSocket
  3. Verifique se a execução foi recebida com o order_id correto
  4. Confira se a execução aparece em GET /fills?wallet=...
  5. Verifique se o status da ordem foi atualizado para FILLED

Esperado: Execuções rastreadas corretamente, status da ordem atualizado

Teste 4: Rastreamento de Execuções Parciais​

Passos:

  1. Envie uma ordem que será executada parcialmente
  2. Monitore o canal fills do WebSocket (não o order_updates)
  3. Verifique se a execução parcial foi recebida
  4. Agregue as execuções por order_id para calcular o tamanho executado
  5. Verifique se o status da ordem permanece OPEN (não PARTIALLY_FILLED no WS)

Esperado: Execuções parciais rastreadas via canal fills, status da ordem correto

Teste 5: Cancelamento de Ordem​

Passos:

  1. Envie uma ordem via POST /order
  2. Cancele a ordem via DELETE /order
  3. Verifique o status da ordem: CANCELED
  4. Confira se o order_updates do WebSocket foi recebido

Esperado: Ordem cancelada com sucesso, atualizações de status recebidas

Teste 6: Acionamento do MMP​

Passos:

  1. Configure o MMP via POST /mmp-config
  2. Envie ordens com MMP habilitado
  3. Acione o MMP excedendo os limites
  4. Verifique se as ordens foram canceladas com motivo relacionado ao MMP
  5. Confira se as outras ordens com MMP habilitado também foram canceladas

Esperado: MMP aciona corretamente, ordens canceladas

Teste 7: Rejeição por Margem​

Passos:

  1. Envie uma ordem que exceda a margem
  2. Verifique se a ordem foi rejeitada com o motivo "Insufficient margin"
  3. Confira se o motivo da rejeição inclui os valores requerido, disponível e faltante
  4. Verifique o status da ordem: REJECTED

Esperado: Ordem rejeitada com motivo claro

Teste 8: Restrição de Tier​

Passos:

  1. Use uma carteira configurada com acesso apenas long
  2. Tente enviar uma ordem de venda sem posição comprada
  3. Verifique se a ordem foi rejeitada com motivo relacionado ao tier
  4. Envie uma ordem de compra (deve ter sucesso)
  5. Envie uma ordem de venda para fechar (deve ter sucesso)

Esperado: Restrições de tier aplicadas corretamente

Teste 9: Reconexão de WebSocket​

Passos:

  1. Conecte-se ao WebSocket
  2. Inscreva-se nos canais
  3. Desconecte o WebSocket
  4. Reconecte com backoff exponencial
  5. Reinscreva-se nos canais
  6. Consulte a REST para recuperar as atualizações perdidas

Esperado: Reconexão funciona, estado recuperado

Teste 10: Reconciliação de Portfólio​

Passos:

  1. Envie e execute ordens
  2. Confira o portfólio via GET /portfolio?wallet=...
  3. Verifique se as posições correspondem às execuções
  4. Confira se o uso de margem está correto
  5. Reconcilie com as atualizações do canal portfolio do WebSocket

Esperado: Estado do portfólio preciso, reconciliação bem-sucedida

Prontidão para Produção​

Checklist Pré-Produção​

  • Todos os testes de integração aprovados
  • Monitoramento e alertas configurados
  • Kill switch testado
  • Procedimentos de emergência documentados
  • Equipe treinada em resposta a incidentes
  • Contatos de suporte identificados

Checklist de Go-Live​

  • Ambiente de staging totalmente testado
  • Endpoints de produção verificados
  • Dashboards de monitoramento prontos
  • Alertas configurados
  • Escala de plantão da equipe estabelecida
  • Documentação revisada

Referências​

Última atualização em