Kiến trúc

Hypercall sử dụng mô hình thực thi lai: khớp lệnh ngoài chuỗi để đạt tốc độ, còn thanh toán và quản lý tài khoản diễn ra trên chuỗi để đảm bảo an toàn.

Ranh giới tin cậy

Ngoài chuỗi (Backend Hypercall)

Trách nhiệm:

• Khớp và thực thi lệnh
• Quản lý sổ lệnh
• Kiểm tra ký quỹ trước giao dịch, bao gồm kiểm tra danh mục trước mỗi lệnh perp
• Điều phối thanh lý
• Dữ liệu thị trường và định giá
• Luồng WebSocket

Giả định tin cậy: bạn tin tưởng nhà vận hành đối với tất cả các mục trên. Xem Mô hình tin cậy.

Trên chuỗi (Hợp đồng thông minh)

Trách nhiệm:

• Quyền sở hữu tài khoản và quyền kiểm soát của manager
• Nạp và rút tiền
• Lệnh RSM (các thao tác quản lý rủi ro)
• Token quyền chọn (hợp đồng OptionRegistry và OptionToken)
• Phê duyệt builder cho lệnh perp (gọi approveZeroFeeBuilder một lần từ Account của bạn)

Giả định tin cậy: các hoạt động trên chuỗi được ghi lại trên Hyperliquid và nhà vận hành không thể tự mình thay đổi. Ai có thể nâng cấp các hợp đồng được trình bày trong Mô hình tin cậy.

Luồng thực thi lệnh

1. Gửi lệnh

Thao tác của người dùng: Gửi lệnh qua POST /order kèm chữ ký EIP-712.

Xác thực ở backend:

• Xác minh chữ ký (EIP-712)
• Kiểm tra ký quỹ trước giao dịch (dựa trên kịch bản)
• Chấp nhận lệnh (tier, ngày đáo hạn, giới hạn tần suất)

Kết quả: Lệnh được chấp nhận (ACKED) và đưa vào hàng đợi khớp lệnh, hoặc bị từ chối kèm lý do.

2. Khớp lệnh

Quy trình: Lệnh được khớp trên sổ lệnh theo nguyên tắc ưu tiên giá, sau đó đến thời gian.

Thực thi: Khi lệnh khớp, các fill được tạo ra và vị thế được cập nhật trong trạng thái engine. Mọi thay đổi trạng thái đều được ghi vào journal bền vững của engine trước khi được xác nhận, và các bảng cơ sở dữ liệu được dẫn xuất từ journal đó.

Không ghi trên chuỗi: Từng lần khớp quyền chọn riêng lẻ không được ghi lại trên chuỗi.

3. Cập nhật vị thế

Quy trình: Vị thế quyền chọn và tiền mặt được theo dõi trong trạng thái engine và cập nhật theo thời gian thực. Vị thế perp nằm trên sổ cái HyperCore của tài khoản bạn trên Hyperliquid.

Truy cập của người dùng: Truy vấn vị thế qua GET /portfolio hoặc kênh WebSocket portfolio.

4. Thanh toán

Thanh toán khi đáo hạn: Quyền chọn được thanh toán bằng tiền mặt vào ngày đáo hạn theo giá thanh toán lấy từ oracle của Hyperliquid. Engine ghi giá thanh toán vào journal, tính giá trị nội tại của từng vị thế, cập nhật số dư tiền mặt và đóng các vị thế.

Về thời điểm đáo hạn của từng tài sản cơ sở, cách tính giá thanh toán và cách xử lý khi dữ liệu thưa thớt, xem Thanh toán và Oracle.

Quản lý tài khoản

Tạo tài khoản

Quy trình: Ví manager gọi createAccount trên Factory kèm một khoản tiền gửi HYPE nhỏ để tạo tài khoản. Ứng dụng sẽ làm việc này thay bạn khi bạn bật perp hoặc Portfolio Margin. Xem Onboarding (hợp đồng).

Manager: Mỗi Account có một manager (một EOA) kiểm soát tài khoản và có thể ủy quyền cho các ví API ký lệnh và hủy lệnh.

Nạp và rút tiền

Nạp tiền:

• USDC: gửi trên HyperEVM tới hợp đồng Exchange (depositUsdcFor), hợp đồng này chuyển (bridge) USDC sang số dư HyperCore của Exchange. Hypercall ghi có khi ghi nhận được khoản nạp trên HyperCore.
• ERC20 quyền chọn: nạp qua hợp đồng Exchange, hợp đồng này đốt token và ghi có vị thế tương ứng.

Rút tiền:

• Phải vượt qua kiểm tra ký quỹ của Hypercall (đủ ký quỹ sau khi rút)
• Được ký bằng ví của bạn. Lệnh rút USDC tiêu chuẩn được chi trả trên HyperCore từ số dư của Exchange thông qua một directive RSM. Lệnh rút của Portfolio Margin là một giao dịch chuyển do manager ký từ Account của bạn trên HyperCore.

Ranh giới tin cậy: Nạp và rút tiền diễn ra trên chuỗi và có thể kiểm chứng.

Thanh lý

Khi vốn chủ sở hữu của tài khoản giảm xuống dưới mức ký quỹ duy trì, tài khoản chuyển sang trạng thái tiền thanh lý:

• Các lệnh làm tăng rủi ro bị chặn; lệnh đóng vị thế vẫn được phép.
• Bộ thanh lý thực hiện các lệnh thanh lý một phần để khôi phục ký quỹ, với khoản thưởng cho bên thanh lý tăng dần theo thời gian.
• Nếu tài khoản chưa phục hồi trong khoảng thời gian leo thang, tài khoản chuyển sang thanh lý toàn bộ, do engine Hypercall thực hiện.

Xem Thanh lý để biết đầy đủ chi tiết.

Tích hợp Hyperliquid

Perp

Hypercall định tuyến lệnh perp tới Hyperliquid, bao gồm các thị trường HIP-3 trên dex xyz. Mỗi lệnh perp trước tiên được kiểm tra dựa trên toàn bộ tài khoản portfolio margin của bạn. Sau đó có hai tuyến. Ứng dụng mặc định dùng TEE, còn tuyến hợp đồng thông minh là một tùy chọn nâng cao; client API chọn tuyến thông qua endpoint mà họ gọi:

Tuyến hợp đồng thông minh (tùy chọn nâng cao trong ứng dụng): bạn ký lệnh → engine của Hypercall kiểm tra lệnh dựa trên toàn bộ tài khoản portfolio margin của bạn → lệnh được đưa lên chuỗi qua hợp đồng tài khoản của bạn tới HyperCore → Hyperliquid khớp lệnh

Tuyến TEE (mặc định trong ứng dụng, chọn tham gia qua API): bạn ký lệnh → engine kiểm tra lệnh → một enclave bảo mật (TEE) giữ khóa giao dịch Hyperliquid của tài khoản bạn ký lệnh gốc → Hyperliquid khớp lệnh

Chỉ các lệnh trên tuyến TEE mới đi qua enclave. Các lệnh này mang địa chỉ builder của Hypercall, vì vậy tài khoản cần phê duyệt builder một lần (Enable trading), và enclave chỉ ký các lệnh, lệnh hủy và thay đổi đòn bẩy đã được engine phê duyệt. Xem Perp trên Hypercall.

Trường hợp sử dụng:

• Phòng hộ delta cho vị thế quyền chọn
• Cross-margin: vị thế perp được tính vào portfolio margin

Cross-Margin

Vị thế perp trên HyperCore được đưa vào tính toán portfolio margin, và yêu cầu ký quỹ là giá trị lớn hơn giữa kết quả portfolio margin và ký quỹ riêng của Hyperliquid. Portfolio Margin mở cho mọi tài khoản; xem Onboarding vào Portfolio Margin.

Lệnh RSM

RSM: máy trạng thái nhân bản (replicated state machine) của engine. Khi trạng thái engine yêu cầu một hành động trên chuỗi (ghi có, rút tiền, một bước thanh lý hoặc một lệnh phục hồi), người ký RSM ký một directive và sequencer của Hypercall gửi directive đó. Thanh toán đáo hạn quyền chọn không phải là directive RSM: nó được áp dụng vào tiền mặt trong trạng thái engine. Phạm vi của từng directive được liệt kê tại Directive RSM.

Những gì bạn có thể kiểm chứng

Trên chuỗi (Có thể kiểm chứng)

• Quyền sở hữu tài khoản (địa chỉ manager)
• Nạp và rút tiền
• Lệnh Hyperliquid và vị thế perp (trên Hyperliquid)
• Lệnh RSM (thực thi trên chuỗi)

Ngoài chuỗi (Cần tin cậy)

• Tính công bằng của việc khớp lệnh
• Tính toán ký quỹ
• Tính toán giá thanh toán (dữ liệu đầu vào từ oracle Hyperliquid là công khai)
• Độ chính xác của việc theo dõi vị thế
• Độ chính xác của dữ liệu thị trường
• Thời điểm kích hoạt thanh lý

Mô hình tin cậy

Mainnet Alpha do nhà vận hành điều hành. Bạn tin tưởng Hypercall khớp lệnh công bằng (ưu tiên giá-thời gian), thu nhận dữ liệu thị trường chính xác, tính đúng ký quỹ và giá thanh toán, kích hoạt thanh lý đúng lúc, chỉ phát các directive RSM đúng và xử lý sự cố. Chưa có phần nào trong số này kiểm chứng được bằng mật mã; khớp lệnh ngoài chuỗi đổi sự tin cậy đó lấy tốc độ. Phần còn lại do chuỗi thực thi: quyền sở hữu tài khoản, nạp và rút tiền diễn ra trên chuỗi, một Account chỉ thực thi directive được ký bởi manager, một trong các ví API của nó hoặc người ký RSM đã đăng ký, và các hợp đồng giới hạn directive RSM ở ghi có, rút tiền, trạng thái thanh lý và các hành động phục hồi bị ràng buộc. Lệnh perp trên tuyến TEE (mặc định của ứng dụng) được ký bên trong một enclave đã được chứng thực (attested), enclave này chỉ chấp nhận các lệnh đã được engine phê duyệt. Người ký RSM, sequencer và các khóa quản trị và nâng cấp hợp đồng do nhà vận hành kiểm soát, và một lần nâng cấp Account áp dụng cho mọi Account. Quyền hạn, vai trò và địa chỉ chi tiết nằm ở Tin cậy và phân quyền. Lộ trình phi tập trung hóa RSM sẽ nêu rõ cách các cam kết trạng thái, vai trò người ký, cơ chế khiếu nại và quyền kiểm soát của nhà vận hành trở nên kiểm chứng được; Mainnet Alpha là giai đoạn đầu có giới hạn, không phải mô hình tin cậy cuối cùng.

---

Xem thêm:

• Thanh toán & Đáo hạn - Quy trình và vòng đời thanh toán
• Thanh lý - Máy trạng thái và cơ chế thanh lý
• Hợp đồng - Tài liệu hợp đồng thông minh