장애 모드
장애 및 성능 저하 상황에서의 시스템 동작입니다.
설계 철학
Hypercall은 가능한 범위에서는 거래를 계속 유지하고, 가격 또는 증거금 입력값이 누락된 경우에는 안전하게 차단(fail closed)합니다. 장애 발생 시:
- 필요한 입력값이 유효한 범위에서는 거래가 계속됩니다
- 장애가 발생한 구성 요소는 격리됩니다
- 사용자는 오래된 데이터나 임의로 만들어진 가격 대신 명시적인 오류를 받습니다
L1 다운타임
Hyperliquid L1(HyperCore)을 사용할 수 없게 되는 경우:
| 기능 | 동작 |
|---|---|
| 옵션 매칭 | 가격 및 변동성 입력값이 유효한 동안 Hypercall 호가창에서 계속됩니다 |
| 퍼프 주문 | 사용할 수 없습니다. 퍼프는 Hyperliquid에서 체결됩니다. |
| 결제 | 충분한 오라클 샘플이 확보될 때까지 지연됩니다(아래 참조) |
| 입금 | L1이 복구될 때까지 차단됩니다 |
| 출금 | L1이 복구될 때까지 차단됩니다 |
L1이 다시 사용 가능해지면 자동으로 복구됩니다.
오라클 장애
가격 오라클
가격 오라클을 사용할 수 없게 되는 경우:
| 영향 | 동작 |
|---|---|
| 위험 증가 주문 | 마지막으로 기록된 현물 가격이 30초보다 오래되면 거부됩니다 |
| 위험 감소 주문 | 마지막으로 기록된 가격으로 평가되어 접수됩니다 |
| 증거금 및 청산 평가 | 마지막으로 기록된 가격으로 계속됩니다. 대체 가격은 생성되지 않습니다. |
| 만기 결제 가격 | 마지막으로 기록된 가격을 쓰지 않습니다. 만기 시점의 오라클 다운을 참고하십시오. |
정상적인 피드는 가격이 변하지 않더라도 최소 10초마다 가격을 다시 기록하므로, 횡보 장세에서도 30초 한도에 걸리지 않습니다. 오라클이 복구되면 자동으로 정상화됩니다.
IV 오라클
IV 오라클에 장애가 발생하는 경우:
| 영향 | 동작 |
|---|---|
| 신규 주문 | 해당 기초자산의 위험 증가 주문은 거부됩니다 |
| 옵션 가격 산정 | 대체 가격이 없습니다. 누락된 IV가 필요한 계산은 실패합니다. |
| 증거금 계산 | 대체 변동성을 사용하지 않고 안전하게 차단(fail closed)됩니다 |
정확한 조건은 변동성 오라클을 참조하십시오.
결제 장애
만기 시점의 오라클 다운
결제 가격은 만기 전 30분 TWAP 구간을 사용합니다. 위의 평가용 장애 규칙은 결제 가격에 적용되지 않습니다. 오라클 데이터를 사용할 수 없는 경우:
- 부분 장애: 구간 내 샘플이 최소 500개 이상일 때만 TWAP을 계산합니다. Hypercall은 동일한 최소 기준 하에서 보관된 Hyperliquid 오라클 이력으로 짧은 구간을 재구성할 수 있습니다.
- 전체 장애: 샘플이 최소 500개인 구간을 확보할 때까지 결제는 대기합니다. 마지막으로 기록된 가격, 일부 구간, 대체 가격으로 결제하지 않습니다.
장애가 없더라도 정확한 만기 시점에 확정된 TWAP을 사용할 수 없으면 결제가 지연될 수 있습니다. 이 경우 해당 상품은 Expired Pending Price 상태로 유지되고, 거래는 비활성화된 상태로 남으며, 확정 가격이 생성될 때까지 결제가 자동으로 재시도됩니다.
TWAP 알고리즘은 시세 조작에 저항하도록 설계되어 있습니다. 자세한 내용은 오라클을 참조하십시오.
API 다운타임
Hypercall API를 사용할 수 없게 되는 경우:
| 구성 요소 | 상태 |
|---|---|
| 거래 | 사용할 수 없습니다. 옵션 주문, 취소 및 퍼프 주문은 모두 Hypercall API를 거칩니다. |
| 포지션 및 잔고 | 엔진의 영구 저널에 보관되며 재시작 시 복원됩니다 |
| 미체결 주문 | 엔진 상태의 일부이며 재시작 시 복원됩니다. API가 복구될 때까지 취소할 수 없습니다. |
| 퍼프 포지션 | 사용자의 Hyperliquid 계정에 그대로 유지됩니다 |
| WebSocket 구독 | 연결이 끊어집니다 |
권장 사항
- 지수 백오프(exponential backoff)를 적용한 재연결 로직을 구현하십시오
- 중요한 데이터를 로컬에 캐시하십시오
- 거래 전에
GET /health를 확인하십시오 - 대기 주문은 API 장애 중에도 유효한 상태로 남는다고 가정하고, 이에 맞춰 대기 호가의 규모를 설정하십시오
헬스 엔드포인트
| 엔드포인트 | 용도 |
|---|---|
GET /health | 기본 활성 상태(liveness) 확인 |
GET /ready | 의존성을 포함한 전체 준비 상태(readiness) 확인 |
장애 공지
장애 발생 시 다음 채널을 확인하십시오:
- 상태 페이지: status.hypercall.xyz
- X: @SynapseProtocol
- Telegram: t.me/hypercall_trollbox
- Discord: discord.gg/4rMzuEnKqe