合约
主网 Alpha
以下是当前 Hypercall 主网 Alpha 的合约地址。在平台逐步扩展期间,上线范围有意受到限制。
Hypercall 的链上组件部署在 Hyperliquid L1(HyperEVM)上。系统采用模块化架构,由独立的合约分别负责账户管理、订单处理和期权代币处理。
架构概览
合约职责
Exchange
Exchange 是主入口点,采用可升级代理模式。
职责:
- 通过 BeaconProxy 模式创建用户 Account
- 托管 HyperCore 上存入的 USDC(保险基金 + 期权头寸)
- 作为 RSM Sequencer 执行链上操作/请求的入口点
- 处理期权 ERC20 的存入与提取(在 HyperEVM 与 RSM 账本之间桥接)
- 跟踪并处理完整的强制平仓拍卖
- 发出包含原始 ActionCaster 操作的事件
关键函数:
createAccount()- 创建新账户,调用者为管理者deposit(account, token, amount)- 向账户存入代币addApiWallet(account, apiWallet)- 授权用于交易的 API 钱包hlRequestOrder(...)- 通过 ActionCaster 下达 HyperLiquid 永续合约/现货订单hlRequestCancel(...)- 取消 HyperLiquid 订单hlActionSendAsset(...)- 从 Account 向接收方发送资产hcActionWithdrawToken(...)- 将代币从 Exchange 提取到 AccounthcActionWithdrawOption(...)- 将期权提取到 HyperEVM 接收方rsmCommandRebalance(...)- 由 RSM 发起的只减仓订单rsmCommandRepay(...)- 由 RSM 发起的债务偿还
Account
每位用户拥有自己的 Account 合约(指向共享实现的 BeaconProxy)。
职责:
- 为使用非 USDC 资产的交易者/做市商托管 HyperCore 侧的抵押品
- 拥有单一管理者,管理者可添加多个代理密钥
- 代理密钥仅能签署下单/撤单;其他操作需要管理者签名
- 作为管理者执行所有与账户相关操作的入口点
关键概念:
- 管理者(Manager):账户所有者,可授权代理并签署提款
- 代理密钥(Agent Keys):仅限下单/撤单的授权签名者
- API 钱包:可代表账户提交订单的授权地址
存入:
- 期权 ERC20 通过调用
Exchange.deposit()存入 - 其他资产通过该资产的 HyperEVM → HyperCore 桥桥接至 HyperCore
- USDC 存入"期权 USDC 头寸"通过 HyperCore 从 Account 向 Exchange 转账完成
Processor
Processor 负责签名验证和操作编码。
职责:
- 从签名中重构签名者地址
- 将操作编码为 ActionCaster 格式
- 将美元金额转换为 HYPE 以进行存款计算
关键函数:
hlRequestOrder(...)- 处理订单请求hlRequestCancel(...)- 处理撤单请求hlActionSendAsset(...)- 处理发送资产操作rsmCommandRebalance(...)- 处理 RSM 再平衡命令rsmCommandRepay(...)- 处理 RSM 偿还命令usdToHype(amountUsd)- 基于现货价格将美元转换为 HYPE
Registry
Registry 管理期权代币的部署和验证。
职责:
- 部署期权 ERC20 代币
- 作为"该 ERC20 是否为受支持的期权代币"的权威数据来源
- 白名单地址可部署新的期权代币
未来的防护机制:
- 允许的标的资产集合
- 允许的到期时间戳
- 允许的行权价粒度
操作类型
HyperLiquid 请求
与 HyperLiquid 订单簿交互的请求:
| 操作 | 签名者 | 描述 |
|---|---|---|
hlRequestOrder | 代理/API 钱包 | 下达永续合约/现货订单 |
hlRequestCancel | 代理/API 钱包 | 按 OID 取消订单 |
hlRequestCancelByCloid | 代理/API 钱包 | 按 CLOID 取消订单 |
管理者操作
需要账户管理者签名的操作:
| 操作 | 描述 |
|---|---|
hlActionSendAsset | 从 Account 向接收方发送资产 |
hcActionWithdrawToken | 将代币从 Exchange 提取到 Account |
hcActionWithdrawOption | 将期权提取到 HyperEVM 地址 |
RSM 命令
由 RSM 签名者签署的命令(无需管理者同意):
| 命令 | 描述 |
|---|---|
rsmCommandRebalance | 提交只减仓订单以增加 USDC 余额 |
rsmCommandRepay | 强制将 USDC 从 Account 转账至 Exchange |
签名验证
- Exchange 验证 RSM 签名者的签名
- Account 验证管理者和代理的签名
- RSM 命令无需管理者签名即可传递(RSM 签名者是受信任的)
强制平仓拍卖
当账户抵押不足时:
- RSM Sequencer 触发完整的强制平仓拍卖
- 任何人都可以通过提供所需的 USDC 金额进行竞拍
- 竞拍获胜者成为新的 Account 管理者
- 如果条件发生变化,RSM Sequencer 可以停止正在进行的拍卖
已部署地址
主网 Alpha
| 合约 | 地址 | 描述 |
|---|---|---|
| Exchange | 0xE6b7FaA216cabb2b38B392f577C9c826378b2240 | 主交易所合约 |
| Exchange Implementation | 0xeEf31f6c8F2EFABba61C99d9efBEf4e6429024Cf | 代理背后的 Exchange 实现合约 |
| Account Implementation | 0xa8E861eAE5Bc47beDcF4896C7c5c676f563F5f1C | Account 实现合约 |
| Account Beacon | 0x1b96D6a48d1fB34dC45953697414656D2851Ca93 | Account 信标合约 |
| Fetcher | 0x8654912Eae1554662665C13EeD4f1D8A4b028aDB | 读取辅助合约 |
| Option Token Implementation | 0x6D0C7a116f9561A8De692c23c4C11682738ed206 | 期权代币实现合约 |
| Option Token Beacon | 0xfb320352B25Dba7f139EA9Bf8966891CCa12dC35 | 期权代币信标合约 |
| Factory | 0x2CeeAC2E032e4cCb05FF744619BfAb8cC75efE1b | 账户工厂合约 |
| Router | 0xF41FF41B6F007dE851ACc9F43Bd2f597Da741E2D | 资金与路由辅助合约 |
| Option Registry | 0x8C8efdd5F78C25215d03c8BbD5D1f6f0F1BB0598 | 期权代币注册合约 |
| Option Registry Implementation | 0xF222421a93df1086E329503723b3cC4c30546C46 | 代理背后的期权注册实现合约 |
主网配置
| 参数 | 地址或值 | 描述 |
|---|---|---|
| USDC | 0xb88339CB7199b77E23DB6E890353E22632Ba630f | Hypercall 使用的 HyperEVM USDC |
| Core Deposit | 0x6B9E773128f453f5c2C60935Ee2DE2CBc5390A24 | HyperCore 存款辅助合约 |
| RSM Signer | 0x502E7fAbF34E84EeB115C34FE947b79A94dF886E | 当前由运营方控制的 RSM 签名者 |
| Sequencer | 0x56a2924217C91EB4d6989Cf4C7b4dF03020E8944 | 当前排序器 |
| Legacy Sequencer | 0x8640A393730Fa671CF1C71CF5fcD2F8E299C44f7 | 旧版排序器 |
源代码
合约源代码将在审计完成后公开。
相关内容
- EIP-712 签名 - 消息格式与签名
- 代理授权 - API 钱包设置
- 入门引导 - 账户创建与存款
- API 身份验证 - 请求签名