本页由机器翻译。英文原文为权威版本。 阅读英文版
跳转到主要内容

合约

主网 Alpha

以下是当前 Hypercall 主网 Alpha 的合约地址。在平台逐步扩展期间,上线范围有意受到限制。

Hypercall 的链上组件部署在 Hyperliquid L1(HyperEVM)上。系统采用模块化架构,由独立的合约分别负责账户管理、订单处理和期权代币处理。

架构概览

用户/管理员EOA或智能合约订单/操作交易所主入口点 • Upgradeable Proxy• 创建账户(BeaconProxy)• 托管USDC• RSM序列器入口• 强平拍卖账户每用户BeaconProxy• 托管抵押品• 管理员+代理密钥处理器操作编码• ActionCaster编码• USD → HYPE转换注册表期权代币管理• 部署期权ERC20• 代币验证CoreWriter向HyperCore写入操作结算层图例用户调用内部调用结算

合约职责

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 提取到 Account
  • hcActionWithdrawOption(...) - 将期权提取到 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 签名者是受信任的)

强制平仓拍卖

当账户抵押不足时:

  1. RSM Sequencer 触发完整的强制平仓拍卖
  2. 任何人都可以通过提供所需的 USDC 金额进行竞拍
  3. 竞拍获胜者成为新的 Account 管理者
  4. 如果条件发生变化,RSM Sequencer 可以停止正在进行的拍卖

已部署地址

主网 Alpha

合约地址描述
Exchange0xE6b7FaA216cabb2b38B392f577C9c826378b2240主交易所合约
Exchange Implementation0xeEf31f6c8F2EFABba61C99d9efBEf4e6429024Cf代理背后的 Exchange 实现合约
Account Implementation0xa8E861eAE5Bc47beDcF4896C7c5c676f563F5f1CAccount 实现合约
Account Beacon0x1b96D6a48d1fB34dC45953697414656D2851Ca93Account 信标合约
Fetcher0x8654912Eae1554662665C13EeD4f1D8A4b028aDB读取辅助合约
Option Token Implementation0x6D0C7a116f9561A8De692c23c4C11682738ed206期权代币实现合约
Option Token Beacon0xfb320352B25Dba7f139EA9Bf8966891CCa12dC35期权代币信标合约
Factory0x2CeeAC2E032e4cCb05FF744619BfAb8cC75efE1b账户工厂合约
Router0xF41FF41B6F007dE851ACc9F43Bd2f597Da741E2D资金与路由辅助合约
Option Registry0x8C8efdd5F78C25215d03c8BbD5D1f6f0F1BB0598期权代币注册合约
Option Registry Implementation0xF222421a93df1086E329503723b3cC4c30546C46代理背后的期权注册实现合约

主网配置

参数地址或值描述
USDC0xb88339CB7199b77E23DB6E890353E22632Ba630fHypercall 使用的 HyperEVM USDC
Core Deposit0x6B9E773128f453f5c2C60935Ee2DE2CBc5390A24HyperCore 存款辅助合约
RSM Signer0x502E7fAbF34E84EeB115C34FE947b79A94dF886E当前由运营方控制的 RSM 签名者
Sequencer0x56a2924217C91EB4d6989Cf4C7b4dF03020E8944当前排序器
Legacy Sequencer0x8640A393730Fa671CF1C71CF5fcD2F8E299C44f7旧版排序器

源代码

合约源代码将在审计完成后公开。

相关内容