Esta página fue traducida automáticamente. El original en inglés es la versión canónica. Leer en inglés →
Saltar al contenido principal

Runbooks

Checklist completo de preparación de la mesa y pruebas de certificación de integración.

Checklist de preparación de la mesa​

Antes de comenzar a operar en vivo, verifique:

Conectividad de la API​

  • Endpoints de producción configurados
  • Endpoint de health check respondiendo
  • Conexión WebSocket estable

Autenticación​

  • Firma EIP-712 funcionando
  • Autorización de agentes configurada (si aplica)
  • Gestión de nonces implementada
  • Verificación de firmas probada

Sistema de cotización​

  • Colocación masiva de órdenes probada
  • Reconciliación del ciclo de vida de órdenes verificada
  • Seguimiento de ejecuciones implementado
  • Funcionalidad de cancelación probada

Controles de riesgo​

  • MMP configurado y probado
  • Modelo de margen comprendido
  • Restricciones de nivel verificadas
  • Monitoreo del portafolio implementado

Monitoreo​

  • Suscripción a los feeds de WebSocket
  • Reconciliación de órdenes/ejecuciones automatizada
  • Health checks configurados
  • Alertas configuradas

Kill switch​

  • Capacidad de cancelar todas las órdenes
  • Capacidad de desconectarse de inmediato
  • Procedimientos de emergencia documentados

Cobertura​

  • Integración con perpetuos de Hyperliquid verificada
  • Estrategia de cobertura delta implementada
  • Cálculo de margen de perpetuos comprendido

Liquidación al vencimiento​

  • Gestión del vencimiento probada
  • Settlement de posiciones verificado
  • Fuente del precio de referencia comprendida

Pruebas de certificación de integración​

Prueba 1: Colocación de órdenes​

Pasos:

  1. Coloque una orden individual mediante POST /order
  2. Verifique que el estado en la respuesta de la orden sea ACKED u OPEN
  3. Compruebe que la orden aparece en GET /orders?wallet=...
  4. Verifique que se reciben order_updates por WebSocket

Resultado esperado: Orden colocada correctamente, actualizaciones de estado recibidas

Prueba 2: Colocación masiva de órdenes​

Pasos:

  1. Coloque 10 órdenes mediante POST /bulk_order
  2. Verifique que todas las órdenes fueron aceptadas
  3. Compruebe los estados de las órdenes vía REST y WS
  4. Verifique que no haya errores de firma/autenticación

Resultado esperado: Todas las órdenes colocadas correctamente

Prueba 3: Seguimiento de ejecuciones​

Pasos:

  1. Coloque una orden que se ejecutará
  2. Monitoree el canal fills de WebSocket
  3. Verifique que la ejecución se recibe con el order_id correcto
  4. Compruebe que la ejecución aparece en GET /fills?wallet=...
  5. Verifique que el estado de la orden se actualiza a FILLED

Resultado esperado: Ejecuciones registradas correctamente, estado de la orden actualizado

Prueba 4: Seguimiento de ejecuciones parciales​

Pasos:

  1. Coloque una orden que se ejecutará parcialmente
  2. Monitoree los canales fills y order_updates de WebSocket
  3. Verifique que la ejecución parcial llega por fills
  4. Verifique que order_updates informa PARTIALLY_FILLED con un filled_size acumulado
  5. Agregue las ejecuciones por order_id y compruebe que el total es igual a filled_size

Resultado esperado: Cantidades por ejecución en fills, tamaño ejecutado acumulado en order_updates

Prueba 5: Cancelación de órdenes​

Pasos:

  1. Coloque una orden mediante POST /order
  2. Cancele la orden mediante DELETE /order
  3. Verifique el estado de la orden: CANCELED
  4. Compruebe que se reciben order_updates por WebSocket

Resultado esperado: Orden cancelada correctamente, actualizaciones de estado recibidas

Prueba 6: Activación del MMP​

Pasos:

  1. Configure el MMP mediante un POST /mmp-config firmado. Envíe X-Hypercall-Fence-Wait: 1 cuando el cliente vaya a leer la proyección de inmediato, y conserve el valor de X-Hypercall-Fence devuelto.
  2. Coloque órdenes con MMP habilitado
  3. Active el MMP superando los límites
  4. Verifique que las órdenes se cancelan con motivo MMP
  5. Compruebe que las demás órdenes con MMP habilitado también se cancelan

Resultado esperado: El MMP se activa correctamente, órdenes canceladas

Las lecturas de la configuración del MMP también requieren autenticación. Firme GetMmpConfig y envíe su vencimiento y su firma en los encabezados X-Hypercall-Expires-At-Ms y X-Hypercall-Signature. Reenvíe en este GET el valor de X-Hypercall-Fence de la respuesta de escritura para esperar exactamente esa configuración confirmada. Las escrituras sin X-Hypercall-Fence-Wait: 1 intencionalmente no devuelven un encabezado de fence.

Prueba 7: Rechazo por margen​

Pasos:

  1. Coloque una orden que exceda el margen
  2. Verifique que la orden se rechaza con el motivo "Insufficient margin"
  3. Compruebe que el motivo del rechazo incluye los valores requerido, equity y déficit
  4. Verifique el estado de la orden: REJECTED

Resultado esperado: Orden rechazada con un motivo claro

Prueba 8: Restricción de nivel​

Pasos:

  1. Use una wallet cuyo nivel solo permita ventas cubiertas (consulte GET /risk/limits?wallet=...)
  2. Intente colocar una orden de venta sin una posición larga
  3. Verifique que la orden se rechaza con un motivo de nivel
  4. Coloque una orden de compra (debería tener éxito)
  5. Coloque una orden de venta para cerrar (debería tener éxito)

Resultado esperado: Restricciones de nivel aplicadas correctamente

Prueba 9: Reconexión de WebSocket​

Pasos:

  1. Conéctese al WebSocket
  2. Suscríbase a los canales
  3. Desconecte el WebSocket
  4. Reconéctese con backoff exponencial
  5. Vuelva a suscribirse a los canales
  6. Consulte REST para recuperar las actualizaciones perdidas

Resultado esperado: La reconexión funciona, el estado se recupera

Prueba 10: Reconciliación del portafolio​

Pasos:

  1. Coloque y ejecute órdenes
  2. Consulte el portafolio mediante GET /portfolio?wallet=...
  3. Verifique que las posiciones coinciden con las ejecuciones
  4. Compruebe que el uso de margen es correcto
  5. Reconcilie con las actualizaciones portfolio de WebSocket

Resultado esperado: Estado del portafolio preciso, reconciliación exitosa

Preparación para producción​

Checklist previo a producción​

  • Todas las pruebas de integración superadas
  • Monitoreo y alertas configurados
  • Kill switch probado
  • Procedimientos de emergencia documentados
  • Equipo capacitado en respuesta a incidentes
  • Contactos de soporte identificados

Checklist de salida en vivo​

  • Pruebas de certificación superadas con tamaño pequeño en producción
  • Endpoints de producción verificados
  • Dashboards de monitoreo listos
  • Alertas configuradas
  • Calendario de guardias del equipo establecido
  • Documentación revisada

Referencias​

Última actualización el