장애 모드
장애 및 성능 저하 상황에서의 시스템 동작입니다.
설계 철학
Hypercall은 엄격한 일관성보다 가용성을 우선합니다. 장애 발생 시:
- 가능한 범위에서 거래가 계속됩니다
- 장애가 발생한 구성 요소는 격리됩니다
- 사용자는 오래된 데이터 대신 명시적인 오류를 받습니다
L1 다운타임
Hyperliquid L1(HyperCore)이 사용 불가 상태가 되는 경우:
| 기능 | 동작 |
|---|---|
| 주문 매칭 | 오프체인에서 계속 진행 |
| 결제 | L1 복구 시까지 대기열에 유지 |
| 입금 | L1 복구 시까지 차단 |
| 출금 | L1 복구 시까지 차단 |
| 강제청산 | 마지막으로 확인된 포지션 기준으로 계속 진행 |
L1이 다시 사용 가능해지면 복구는 자동으로 이루어집니다.
오라클 장애
가격 오라클
가격 오라클이 사용 불가 상태가 되는 경우:
| 영향 | 동작 |
|---|---|
| 신규 주문 | 거부됨 (참조 가격 없음) |
| 증거금 계산 | 오류와 함께 실패 |
| 청산 확인 | 마지막으로 확인된 가격 사용 |
오라클이 복구되면 자동으로 정상화됩니다.
IV 오라클
IV 오라클에 장애가 발생하는 경우:
| 영향 | 동작 |
|---|---|
| 신규 주문 | 증거금 모드에 따라 거부될 수 있음 |
| 옵션 가격 산정 | 내재가치로 대체 |
| 증거금 계산 | 보수적인 추정치 사용 |
결제 장애
만기 시점 오라클 다운
결제 가격은 만기 전 30분 TWAP 윈도우를 사용합니다. 오라클 데이터가 사용 불가한 경우:
- 부분 장애: 사용 가능한 샘플로 TWAP 계산
- 전체 장애: 데이터가 확보되거나 수동 개입이 있을 때까지 결제 지연
정확한 만기 시점에 확정된 TWAP을 사용할 수 없는 경우에는 장애가 없더라도 결제가 지연될 수 있습니다. 이 경우 해당 상품은 Expired Pending Price 상태로 유지되고, 거래는 비활성화 상태로 유지되며, 확정 가격이 존재할 때까지 결제가 자동으로 재시도됩니다.
TWAP 알고리즘은 조작에 저항하도록 설계되었습니다. 자세한 내용은 오라클을 참조하세요.
API 다운타임
Hypercall API가 사용 불가 상태가 되는 경우:
| 구성 요소 | 상태 |
|---|---|
| 온체인 거래 | 직접 컨트랙트 호출을 통해 정상 작동 |
| 포지션 | 온체인에서 안전하게 유지 |
| 미체결 주문 | 호가창에 유지 |
| WebSocket 구독 | 연결 해제 |
권장 사항
- 지수 백오프(exponential backoff)를 적용한 재연결 로직 구현
- 중요 데이터를 로컬에 캐시
- 거래 전
GET /health확인 - 중요 작업에 대한 폴백으로 온체인 방식 사용
헬스 엔드포인트
| 엔드포인트 | 목적 |
|---|---|
GET /health | 기본 라이브니스 확인 |
GET /ready | 종속성을 포함한 전체 준비 상태 확인 |
장애 상황 커뮤니케이션
장애 발생 시 업데이트는 다음 채널에 게시됩니다:
- Discord: #announcements 채널
- Twitter: @synapseprotocol