Trang này được dịch tự động. Bản gốc tiếng Anh là phiên bản chính thức. Đọc bằng tiếng Anh →
Chuyển đến nội dung chính

Hợp đồng

Mainnet Alpha

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

Các thành phần on-chain của Hypercall được triển khai trên HyperEVM (chain ID 999). Mỗi người dùng có một hợp đồng Account. Exchange nắm giữ USDC của sàn và lưu ký quyền chọn, đồng thời thực thi các directive đã ký trên các Account. Factory tạo Account. Option Registry triển khai và nhận diện các token quyền chọn.

Vai trò của các hợp đồng​

Exchange​

Proxy có thể nâng cấp. Phiên bản 0.6.1 trên mạng chính.

  • Nắm giữ USDC được nạp trên HyperCore cho sàn (depositUsdcFor, depositPmLiquidityFor).
  • Đốt các token ERC20 quyền chọn khi nạp và phát sự kiện Deposit để engine ghi có (depositOption).
  • Đăng ký các Account do Factory tạo và theo dõi manager của từng Account (getAccounts, getAccount, managers).
  • Thực thi các directive đã ký. executeUserDirective chuyển tiếp directive do manager hoặc ví API ký tới Account. executeRsmDirective chạy directive hệ thống do RSM ký (ghi có, rút tiền, trạng thái thanh lý). Cả hai chỉ có thể được gọi bởi sequencer của Hypercall: người dùng ký, Hypercall gửi giao dịch.
  • Theo dõi các nonce đã dùng theo từng người ký (isNonceUsed).

Account​

Mỗi người dùng một hợp đồng, được triển khai dưới dạng BeaconProxy. Phiên bản 0.2.4 trên mạng chính.

  • Sở hữu số dư và vị thế HyperCore của người dùng. Perp và spot nằm trên sổ cái HyperCore của Account.
  • Có một manager (EOA đã tạo Account) và số lượng tùy ý các ví API được đặt tên.
  • Xác minh chữ ký directive. Ví API có thể ký lệnh và hủy lệnh. Mọi thao tác khác đều cần manager. Xem Ký EIP-712.
  • Các lệnh gọi trực tiếp chỉ dành cho manager: transferTo(recipient, token, amount) chuyển token HyperEVM ra khỏi Account, và approveZeroFeeBuilder(builder) phê duyệt một builder Hyperliquid với mức phí tối đa 0%. Các lệnh perp của Hypercall mang mã builder của Hypercall, vì vậy cần phê duyệt này một lần trước lệnh perp đầu tiên.
  • depositSpot chuyển HYPE hoặc một token spot được hỗ trợ từ HyperEVM sang Account trên HyperCore.

Factory​

Tạo Account bằng createAccount(uint96 salt). Địa chỉ được xác định trước theo manager và salt. predictAccount(manager, salt) trả về địa chỉ đó trước khi tạo. Xem Bắt đầu sử dụng.

Router​

Hợp đồng hỗ trợ nạp tiền. deposit(account, token, amount, isPerp) chuyển USDC tới HyperCore qua CoreDepositWallet của Circle, token spot qua Account và token quyền chọn qua Exchange. depositHype(account) chuyển HYPE gốc.

Option Registry​

Triển khai các token ERC20 quyền chọn và là nguồn xác thực duy nhất để biết một token có phải là quyền chọn được hỗ trợ hay không (isSupportedOption).

Các loại directive​

DirectiveNgười kýMô tả
hl_limit_orderVí APILệnh giới hạn Hyperliquid
hl_cancel_by_oidVí APIHủy theo ID lệnh Hyperliquid
hl_cancel_by_cloidVí APIHủy theo ID lệnh của client
hc_update_api_walletManagerThêm, thay thế hoặc xóa một ví API được đặt tên trên Account
hl_add_api_walletManagerPhê duyệt một ví API Hyperliquid cho Account trên HyperCore
hl_send_assetManagerGửi tài sản từ Account trên HyperCore
hl_set_abstractionManagerĐặt chế độ tài khoản HyperCore của Account (chỉ unified)

Các directive RSM (ghi có, rút tiền, bắt đầu và dừng thanh lý, lệnh phục hồi chỉ giảm vị thế) được ký bởi người ký RSM và gửi bởi sequencer. Người dùng không bao giờ ký các directive này. Xem Directive RSM.

Thanh lý​

Quá trình thanh lý chạy trong engine của Hypercall. Xem Thanh lý. Exchange có các hook cho phép một hợp đồng đấu giá on-chain chuyển manager của Account cho người trả giá thắng cuộc, nhưng hiện chưa có auctioneer nào được cấu hình trên mạng chính.

Tin cậy và phân quyền​

Phần này là tài liệu tham chiếu về việc ai được làm gì trên chuỗi. Bản tóm tắt nằm ở Mô hình tin cậy.

Gửi giao dịch​

Chỉ sequencer của Hypercall nắm SEQUENCER_ROLE trên Exchange, nên đây là bên duy nhất gọi executeUserDirective và executeRsmDirective. Bạn ký; Hypercall gửi. Sequencer không thể giả mạo directive của người dùng: Account tự khôi phục người ký và chỉ chấp nhận manager của nó hoặc một ví API đang hoạt động.

Directive RSM​

Khi trạng thái engine yêu cầu một hành động trên chuỗi, người ký RSM ký một directive và sequencer gửi directive đó. Exchange từ chối mọi directive RSM không được ký bởi người ký RSM đã đăng ký (Exchange.rsmSigner). Người ký RSM hiện tại do nhà vận hành kiểm soát; lộ trình sẽ công bố cách vai trò này được phi tập trung hóa hoặc giảm thiểu yêu cầu tin cậy.

Các directive do chính Exchange thực thi:

  • Gửi USDC hoặc token spot từ số dư HyperCore của Exchange, bao gồm rút USDC tiêu chuẩn
  • Mint ERC20 quyền chọn tới một địa chỉ khi rút quyền chọn
  • Bắt đầu và dừng thanh lý trên một Account

Các directive một Account chấp nhận từ RSM, do hợp đồng Account thực thi:

  • Lệnh IOC chỉ giảm vị thế (reduce-only), hoặc lệnh IOC bán spot sát giá thị trường để lấy USDC, trên số dư Hyperliquid của Account
  • Gửi tài sản từ Account trên HyperCore, chỉ tới Exchange (ví dụ để bù số dư âm)
  • Hủy lệnh

Directive RSM vẫn chạy khi Account đang bị thanh lý. 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. Địa chỉ người ký RSM và mọi lần thực thi directive đều hiển thị trên chuỗi.

Nâng cấp​

  • Exchange và Option Registry là proxy có thể nâng cấp.
  • Account và Option Token là BeaconProxy. Mọi Account chạy cùng một bản triển khai, nên một lần nâng cấp Account Beacon sẽ thay đổi tất cả Account cùng lúc. Điều tương tự áp dụng cho token quyền chọn và Option Token Beacon.
  • Timelock sở hữu quyền quản trị proxy Exchange và các đường nâng cấp của Account, Option Token và Option Registry, với độ trễ tối thiểu 30 giây.
  • Multisig Admin Safe nắm vai trò admin và governor của Exchange và vai trò owner của Factory.
  • Vai trò governor do Admin Safe nắm giữ có thể thay thế bên ký RSM và auctioneer, và chuyển USDC của Exchange (rescueUsdcToEvm). Vai trò này sẽ được đặt dưới timelock ở bước 1 của kế hoạch tin cậy. Với tư cách default admin của Exchange, Safe cũng có thể trực tiếp cấp hoặc thu hồi SEQUENCER_ROLE và mọi vai trò khác của Exchange mà không qua timelock.

Địa chỉ của chúng nằm trong bảng Cấu hình mạng chính bên dưới. Quyền sở hữu tài khoản chỉ thay đổi qua một giao dịch trên chuỗi.

Địa chỉ đã triển khai​

Mainnet Alpha​

Hợp đồngĐịa chỉMô tả
Exchange0xE6b7FaA216cabb2b38B392f577C9c826378b2240Hợp đồng sàn chính
Exchange Implementation0xF7F0610aC612d140bdb34DCD2872828Bc67349cDBản triển khai Exchange phía sau proxy
Account Implementation0xCD87F572bef2855c8Ffb69A6Da3D9785d6017791Bản triển khai Account
Account Beacon0x1b96D6a48d1fB34dC45953697414656D2851Ca93Beacon của Account
Fetcher0x8654912Eae1554662665C13EeD4f1D8A4b028aDBHợp đồng hỗ trợ đọc dữ liệu
Option Token Implementation0x6D0C7a116f9561A8De692c23c4C11682738ed206Bản triển khai token quyền chọn
Option Token Beacon0xfb320352B25Dba7f139EA9Bf8966891CCa12dC35Beacon của token quyền chọn
Factory0x2CeeAC2E032e4cCb05FF744619BfAb8cC75efE1bFactory tạo Account
Router0xF41FF41B6F007dE851ACc9F43Bd2f597Da741E2DHợp đồng hỗ trợ nạp tiền và định tuyến
Option Registry0x8C8efdd5F78C25215d03c8BbD5D1f6f0F1BB0598Registry token quyền chọn
Option Registry Implementation0xF222421a93df1086E329503723b3cC4c30546C46Bản triển khai Option Registry phía sau proxy
Hypercall Fee Collector0x406ceBfC7063e55761007D1C4b66B29308016602Địa chỉ builder Hyperliquid trên các lệnh perp (cũng là hl_builder_address trong GET /exchange-info)

Cấu hình mạng chính​

Tham sốĐịa chỉ hoặc giá trịMô tả
USDC0xb88339CB7199b77E23DB6E890353E22632Ba630fUSDC trên HyperEVM được Hypercall sử dụng
Core Deposit0x6B9E773128f453f5c2C60935Ee2DE2CBc5390A24Hợp đồng hỗ trợ nạp tiền vào HyperCore
RSM Signer0x502E7fAbF34E84EeB115C34FE947b79A94dF886ENgười ký RSM hiện tại do nhà vận hành kiểm soát
Sequencer0x56a2924217C91EB4d6989Cf4C7b4dF03020E8944Sequencer hiện tại
Timelock0x96f17e6f7269cA4300a391514c109eBA70661674Sở hữu quyền admin proxy của Exchange và các luồng nâng cấp của Account, Option Token và Option Registry. Độ trễ tối thiểu 30 giây.
Admin Safe0xF741246D2e0ADD4EFa7e88BE0961cccf3562b502Ví multisig nắm giữ vai trò admin và governor của Exchange cùng vai trò owner của Factory

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​

Cập nhật lần cuối vào