Hợp đồng

Mainnet Alpha

Đây là các địa chỉ hợp đồng hiện tại của Hypercall Mainnet Alpha. Phạm vi ra mắt được giới hạn có chủ đích trong khi sàn giao dịch mở rộng.

Các thành phần on-chain của Hypercall được triển khai trên Hyperliquid L1 (HyperEVM). Hệ thống sử dụng kiến trúc module với các hợp đồng riêng biệt cho quản lý tài khoản, xử lý lệnh và xử lý token quyền chọn.

Tổng quan kiến trúc

Trách nhiệm của các hợp đồng

Exchange

Exchange là điểm truy cập chính và sử dụng mô hình proxy có thể nâng cấp.

Trách nhiệm:

• Tạo Account của người dùng thông qua mô hình BeaconProxy
• Lưu ký USDC đã nạp trên HyperCore (quỹ bảo hiểm + vị thế quyền chọn)
• Điểm truy cập cho RSM Sequencer đối với các hành động/yêu cầu on-chain
• Xử lý nạp và rút option ERC20 (cầu nối giữa HyperEVM và sổ cái RSM)
• Theo dõi và giải quyết các phiên đấu giá thanh lý toàn bộ
• Phát ra các event kèm hành động ActionCaster thô

Các hàm chính:

• createAccount() - Tạo tài khoản mới với người gọi là manager
• deposit(account, token, amount) - Nạp token vào tài khoản
• addApiWallet(account, apiWallet) - Ủy quyền một API wallet để giao dịch
• hlRequestOrder(...) - Đặt lệnh perp/spot trên HyperLiquid thông qua ActionCaster
• hlRequestCancel(...) - Hủy lệnh trên HyperLiquid
• hlActionSendAsset(...) - Gửi tài sản từ Account đến người nhận
• hcActionWithdrawToken(...) - Rút token từ Exchange về Account
• hcActionWithdrawOption(...) - Rút quyền chọn về người nhận trên HyperEVM
• rsmCommandRebalance(...) - Lệnh reduce-only do RSM khởi tạo
• rsmCommandRepay(...) - Hoàn trả nợ do RSM khởi tạo

Account

Mỗi người dùng có hợp đồng Account riêng (BeaconProxy trỏ đến implementation dùng chung).

Trách nhiệm:

• Lưu ký tài sản thế chấp ở phía HyperCore cho trader/nhà tạo lập thị trường sử dụng tài sản không phải USDC
• Có một manager duy nhất, người có thể thêm nhiều agent key
• Agent key chỉ có thể ký lệnh đặt/hủy; các hành động khác yêu cầu chữ ký của manager
• Điểm truy cập cho manager đối với mọi hành động liên quan đến tài khoản

Các khái niệm chính:

• Manager: Chủ tài khoản, người có thể ủy quyền agent và ký các lệnh rút tiền
• Agent Keys: Người ký được ủy quyền chỉ để đặt/hủy lệnh
• API Wallets: Các địa chỉ được ủy quyền có thể gửi lệnh thay mặt tài khoản

Nạp tiền:

• Option ERC20 được nạp bằng cách gọi Exchange.deposit()
• Các tài sản khác được chuyển sang HyperCore bằng cầu nối HyperEVM → HyperCore của tài sản đó
• Nạp USDC vào "vị thế Option USDC" được thực hiện thông qua chuyển khoản HyperCore từ Account sang Exchange

Processor

Processor xử lý xác minh chữ ký và mã hóa hành động.

Trách nhiệm:

• Tái tạo địa chỉ người ký từ chữ ký
• Mã hóa hành động sang định dạng ActionCaster
• Chuyển đổi số tiền USD sang HYPE cho các phép tính nạp tiền

Các hàm chính:

• hlRequestOrder(...) - Xử lý yêu cầu đặt lệnh
• hlRequestCancel(...) - Xử lý yêu cầu hủy lệnh
• hlActionSendAsset(...) - Xử lý hành động gửi tài sản
• rsmCommandRebalance(...) - Xử lý lệnh cân bằng lại của RSM
• rsmCommandRepay(...) - Xử lý lệnh hoàn trả của RSM
• usdToHype(amountUsd) - Chuyển đổi USD sang HYPE dựa trên giá spot

Registry

Registry quản lý việc triển khai và xác thực token quyền chọn.

Trách nhiệm:

• Triển khai các token option ERC20
• Nguồn dữ liệu chuẩn để xác định "ERC20 này có phải là token quyền chọn được hỗ trợ hay không"
• Các địa chỉ trong whitelist có thể triển khai token quyền chọn mới

Các cơ chế bảo vệ trong tương lai:

• Tập hợp các tài sản cơ sở được phép
• Các mốc thời gian đáo hạn được phép
• Độ chi tiết giá thực hiện được phép

Các loại hành động

Yêu cầu HyperLiquid

Các yêu cầu tương tác với sổ lệnh của HyperLiquid:

Hành động	Người ký	Mô tả
hlRequestOrder	Agent/API Wallet	Đặt lệnh perp/spot
hlRequestCancel	Agent/API Wallet	Hủy lệnh theo OID
hlRequestCancelByCloid	Agent/API Wallet	Hủy lệnh theo CLOID

Hành động của Manager

Các hành động yêu cầu chữ ký của manager tài khoản:

Hành động	Mô tả
hlActionSendAsset	Gửi tài sản từ Account đến người nhận
hcActionWithdrawToken	Rút token từ Exchange về Account
hcActionWithdrawOption	Rút quyền chọn về địa chỉ HyperEVM

Lệnh RSM

Các lệnh được ký bởi RSM signer (không cần sự đồng ý của manager):

Lệnh	Mô tả
rsmCommandRebalance	Đặt lệnh reduce-only để tăng số dư USDC
rsmCommandRepay	Buộc chuyển USDC từ Account sang Exchange

Xác minh chữ ký

• Exchange xác minh chữ ký của RSM signer
• Account xác minh chữ ký của manager và agent
• Các lệnh RSM được chuyển đi mà không cần chữ ký của manager (RSM signer được tin cậy)

Đấu giá thanh lý

Khi một tài khoản bị thiếu tài sản thế chấp:

1. RSM Sequencer kích hoạt phiên đấu giá thanh lý toàn bộ
2. Bất kỳ ai cũng có thể đặt giá bằng cách cung cấp số lượng USDC được yêu cầu
3. Người thắng trở thành manager mới của Account
4. RSM Sequencer có thể dừng các phiên đấu giá đang diễn ra nếu điều kiện thay đổi

Địa chỉ đã triển khai

Mainnet Alpha

Hợp đồng	Địa chỉ	Mô tả
Exchange	0xE6b7FaA216cabb2b38B392f577C9c826378b2240	Hợp đồng sàn giao dịch chính
Exchange Implementation	0xeEf31f6c8F2EFABba61C99d9efBEf4e6429024Cf	Implementation của Exchange phía sau proxy
Account Implementation	0xa8E861eAE5Bc47beDcF4896C7c5c676f563F5f1C	Implementation của Account
Account Beacon	0x1b96D6a48d1fB34dC45953697414656D2851Ca93	Beacon của Account
Fetcher	0x8654912Eae1554662665C13EeD4f1D8A4b028aDB	Hợp đồng hỗ trợ đọc dữ liệu
Option Token Implementation	0x6D0C7a116f9561A8De692c23c4C11682738ed206	Implementation của token quyền chọn
Option Token Beacon	0xfb320352B25Dba7f139EA9Bf8966891CCa12dC35	Beacon của token quyền chọn
Factory	0x2CeeAC2E032e4cCb05FF744619BfAb8cC75efE1b	Factory tạo Account
Router	0xF41FF41B6F007dE851ACc9F43Bd2f597Da741E2D	Hợp đồng hỗ trợ cấp vốn và định tuyến
Option Registry	0x8C8efdd5F78C25215d03c8BbD5D1f6f0F1BB0598	Registry của token quyền chọn
Option Registry Implementation	0xF222421a93df1086E329503723b3cC4c30546C46	Implementation của Option Registry phía sau proxy

Cấu hình Mainnet

Tham số	Địa chỉ hoặc giá trị	Mô tả
USDC	0xb88339CB7199b77E23DB6E890353E22632Ba630f	USDC trên HyperEVM được Hypercall sử dụng
Core Deposit	0x6B9E773128f453f5c2C60935Ee2DE2CBc5390A24	Hợp đồng hỗ trợ nạp tiền vào HyperCore
RSM Signer	0x502E7fAbF34E84EeB115C34FE947b79A94dF886E	RSM signer hiện tại do đơn vị vận hành kiểm soát
Sequencer	0x56a2924217C91EB4d6989Cf4C7b4dF03020E8944	Sequencer hiện tại
Legacy Sequencer	0x8640A393730Fa671CF1C71CF5fcD2F8E299C44f7	Sequencer cũ

Mã nguồn

Mã nguồn hợp đồng sẽ được công bố sau khi hoàn tất kiểm toán.

Liên quan

• Ký EIP-712 - Định dạng thông điệp và cách ký
• Ủy quyền Agent - Thiết lập API wallet
• Onboarding - Tạo tài khoản và nạp tiền
• Xác thực API - Ký các yêu cầu