Các Chế Độ Lỗi
Hành vi của hệ thống trong thời gian gián đoạn và điều kiện suy giảm.
Triết Lý Thiết Kế
Hypercall ưu tiên tính khả dụng hơn tính nhất quán nghiêm ngặt. Trong quá trình xảy ra lỗi:
- Giao dịch tiếp tục ở những nơi có thể
- Các thành phần bị lỗi được cô lập
- Người dùng nhận được thông báo lỗi rõ ràng thay vì dữ liệu cũ
L1 Ngừng Hoạt Động
Nếu Hyperliquid L1 (HyperCore) không khả dụng:
| Chức năng | Hành vi |
|---|---|
| Khớp lệnh | Tiếp tục off-chain |
| Thanh toán | Được đưa vào hàng đợi cho đến khi L1 khôi phục |
| Nạp tiền | Bị chặn cho đến khi L1 khôi phục |
| Rút tiền | Bị chặn cho đến khi L1 khôi phục |
| Thanh lý | Tiếp tục dựa trên các vị thế được biết gần nhất |
Việc khôi phục diễn ra tự động khi L1 khả dụng trở lại.
Lỗi Oracle
Oracle Giá
Nếu oracle giá không khả dụng:
| Tác động | Hành vi |
|---|---|
| Lệnh mới | Bị từ chối (không có giá tham chiếu) |
| Tính toán ký quỹ | Thất bại kèm thông báo lỗi |
| Kiểm tra thanh lý | Sử dụng giá được biết gần nhất |
Việc khôi phục diễn ra tự động khi oracle hoạt động trở lại.
Oracle IV
Nếu oracle IV gặp lỗi:
| Tác động | Hành vi |
|---|---|
| Lệnh mới | Có thể bị từ chối tùy thuộc vào chế độ ký quỹ |
| Định giá quyền chọn | Chuyển về sử dụng giá trị nội tại |
| Tính toán ký quỹ | Sử dụng các ước tính thận trọng |
Lỗi Thanh Toán
Oracle Ngừng Hoạt Động Tại Thời Điểm Đáo Hạn
Giá thanh toán sử dụng cửa sổ TWAP 30 phút trước ngày đáo hạn. Nếu dữ liệu oracle không khả dụng:
- Gián đoạn một phần: TWAP được tính từ các mẫu dữ liệu có sẵn
- Gián đoạn hoàn toàn: Thanh toán bị trì hoãn cho đến khi có dữ liệu hoặc có can thiệp thủ công
Thanh toán cũng có thể bị trì hoãn ngay cả khi không có gián đoạn nếu TWAP hoàn tất chưa khả dụng tại đúng thời điểm đáo hạn. Trong trường hợp đó, công cụ giao dịch vẫn ở trạng thái Expired Pending Price, giao dịch vẫn bị vô hiệu hóa, và việc thanh toán sẽ tự động thử lại cho đến khi có giá hoàn tất.
Thuật toán TWAP được thiết kế để chống lại thao túng. Xem Oracles để biết chi tiết.
API Ngừng Hoạt Động
Nếu API của Hypercall không khả dụng:
| Thành phần | Trạng thái |
|---|---|
| Giao dịch on-chain | Hoạt động thông qua gọi hợp đồng trực tiếp |
| Vị thế | An toàn trên chuỗi |
| Lệnh đang mở | Vẫn nằm trong sổ lệnh |
| Đăng ký WebSocket | Bị ngắt kết nối |
Khuyến Nghị
- Triển khai logic kết nối lại với exponential backoff
- Lưu trữ cục bộ (cache) dữ liệu quan trọng
- Kiểm tra
GET /healthtrước khi giao dịch - Sử dụng các phương thức on-chain làm phương án dự phòng cho các thao tác quan trọng
Endpoint Health
| Endpoint | Mục đích |
|---|---|
GET /health | Kiểm tra hoạt động cơ bản |
GET /ready | Kiểm tra mức độ sẵn sàng đầy đủ bao gồm các thành phần phụ thuộc |
Thông Báo Sự Cố
Trong thời gian xảy ra sự cố, các cập nhật được đăng tại:
- Discord: kênh #announcements
- Twitter: @synapseprotocol