hyperspace协议文档

hyperspace 是什么

hyperspace 是 Hyperliquid 生态中的链上合成永续交易协议。交易逻辑运行在 HyperEVM，交易者直接与 LP 结算，不在 Hyperliquid 上实际买卖永续合约。定价采用 HyperCore 订单簿最优买卖报价的中间价。文档列出的特点包括最高 1000 倍杠杆、一键买卖、无订单撮合、无资金费率和无传统买卖价差。

LP 从零启动，以交易者累计亏损积累资金；兑付不足时，未付利润进入队列。合格亏损会铸造 SPACE，质押后可分享 USDC 收入。协议通过盈利折减和盈利手续费获得收入。SPACE 初始供应为零，没有预铸、团队或 VC 份额；上线阶段限制钱包间转账。

常见问题

链上分工：合约在 HyperEVM 记录账户、仓位和队列，USDC 资金账本位于 HyperCore，通过 CoreWriter 转移。

文档列出的交易市场为 BTC、ETH，最高 1000 倍杠杆，单仓名义价值上限 1000 万美元；新增市场由合约所有者决定，支持范围可包括 Hyperliquid 的 HIP-3 市场。

盈利依次经过 0.2 bps 微幅盈利扣减、非对称盈利折减、2% 盈利手续费。亏损不向用户额外收费；适用时，费用从 LP 收入中扣取。

仓位开立后不可追加保证金；强平触发后损失整笔隔离保证金。亏损平仓和强平均可能获得 SPACE。

不能直接向 LP 存款。第三方前端可以构造签名意图，但交易仍必须经过官方中继服务；提现必须由真实钱包签名。

快速开始

准备兼容 EVM 的钱包，例如 MetaMask、Rabby、Frame、Rainbow 或支持 WalletConnect 的钱包。

连接前端并签名注册会话密钥，之后普通开平仓由会话密钥代签。

充值可选择 Hyperliquid、HyperEVM、Ethereum、Arbitrum、Solana 上的 USDC，或 Robinhood Chain 上的 USDG。扣费后至少需到账 10 USDC；界面展示各路径的最低发送量。

选择市场、多空方向、保证金和杠杆后下单；结算采用合约执行时读取的 BBO 中间价。中继服务支付交易 gas。

平仓后，与 LP 结算收益或亏损。理解实际到账还需结合盈利折减、兑付队列和 SPACE 排放章节。

交易与定价

每笔交易都直接与流动性池（LP）结算。用户选择 BTC 或 ETH、多空方向、保证金与杠杆；开仓和平仓分别读取所在执行区块的 Hyperliquid BBO 中间价。hyperspace 自身没有订单簿或撮合引擎，也不另外依赖价格签名者。

用户不支付资金费率、传统价差或交易 gas；盈利结算仍存在盈利折减和 2% 盈利手续费。单仓名义价值等于保证金乘杠杆，文档上限为 1000 万美元，并受方向 OI 上限约束。

每个仓位采用独立保证金，开仓后不能增减保证金、调整杠杆或部分平仓。增加敞口可另开新仓；缩小原仓需要全平后重新开立。

盈利与亏损

盈利：价格变化乘仓位名义价值形成原始收益；经过非对称盈利折减后，再扣除剩余收益的 2%。较大价格波动保留的收益比例通常较高。微幅盈利扣减的先行处理见技术章节。

使用可用 USDC 开仓并亏损时：队列为空时，从 LP 得到的亏损收入中扣取 2% 费用；有队列时免除此费用，亏损现金进入 sideBucket 优先偿付队列。

使用待兑付债权开仓并亏损时：亏损部分对应债权被注销，没有新现金流入。剩余债权继续按兑付规则处理；只有队列为空且 LP 现金足够时才支付 LP 侧费用。

合格已实现亏损触发 SPACE 铸造。排队期间的亏损仍计入 tracked LP，并不因进入 sideBucket 就停止排放。

强制平仓

界面显示的强平价格是清算触发点，触发后将损失整笔保证金；它并不等于主动平仓时剩余权益恰好为零的价格。文档描述的价格缓冲约为 5 bps；100 倍多头的示例中，入场价 100 的零权益参考价为 99，强平约在 99.05 触发。文档另称 1000 倍下约 0.052% 的不利变动就可能触发，主动平仓此时仍可能保留接近一半保证金。

触发后，维护程序执行整笔保证金清算，扣除全部隔离保证金。现金仓在无队列时从该保证金中划出 2% 费用；有队列时免除费用并将现金留给队列。债权仓强平销毁全部抵押债权，不收强平费。所有强平按损失的完整保证金计算 SPACE 铸造基础。文档称团队运行维护程序，并给强平交易较高优先费。

LP 与兑付队列

LP 没有种子资金或外部直接存款，主要来自交易者累计亏损。盈利平仓遇到 LP 现金不足时，未支付部分进入先进先出队列，等待后续亏损提供兑付资金；SPACE 是参与 LP 收入的代币路径。

现金余额开仓后，盈利平仓的原保证金直接回到可用余额，可能排队的是利润；亏损平仓则返还扣除亏损后的余额。排队债权开仓不同：其保证金原本就是未兑付债权，平仓后的全部剩余债权都可能再次排队。

界面分别显示可用余额（available）和待兑付余额（queued）。队列记录链上欠款，并非取消该笔收益；但实际支付依赖后续偿付资金，文档没有给出固定到账期限。LP 较小时的较高 SPACE 排放用于激励早期交易。

SPACE 排放

SPACE 是质押后参与协议未来收入的权益代币，供应从零开始。文档声明无预铸、团队分配、VC 分配、空投和解锁计划；只有合格亏损平仓或强平才能触发铸造。上线阶段可质押、解押，但不能在钱包之间自由转账。

当 tracked LP 低于 200 万美元时，包括负值区间，每 1 美元合格亏损基础对应 100 SPACE；进入阈值以上的尾部区间后，铸造率随累计进度下降。这里的基础是合格亏损金额，因此，不能直接用总亏损乘以 100 来计算所有交易的铸币数量。

机制意图是让承担早期 LP 波动风险的人获得较高排放；具体费用扣除、强平差异与单向衰减规则见铸币曲线章节。

质押分红

SPACE 质押和解押均需钱包签名，没有锁仓期、冷却期或归属期，分配按质押比例计算。

收入之一为交易费用的一半：适用的 2% 费用由质押者与开发费用接收方平分。费用支付受队列为空及 LP 支付能力约束；队列债权优先。债权仓强平不产生此费用。

收入之二为 LP 超额部分：tracked LP 超过 500 万美元奖励上限后，新增的超额收益可划给质押者；低于该值时主要依靠费用分成。

已累积奖励保存在质押系统中，可通过钱包签名领取到交易账户余额，再进行提现。

充值与提现

充值由应用引导至个人专属地址。文档支持从 Hyperliquid、HyperEVM、Ethereum、Arbitrum、Solana 使用 USDC，或从 Robinhood Chain 使用 USDG。Hyperliquid 路径通常较快，其他链还需等待桥完成。扣费后至少到账 10 USDC，首次充值另有一次性 1 USDC 账户激活费，跨链路径还涉及桥费。

提现额度以可用余额为限，不包括开仓占用的保证金或尚未兑付的队列债权，最低提现 10 USDC。使用真实钱包签名，可提至 Hyperliquid 钱包，或按界面路径转往 HyperEVM、Ethereum、Arbitrum、Solana；路径费用在签名前展示。充值代理底层只认 HyperCore 侧资金，具体见技术章节。

会话密钥

首次连接时，钱包签名授权一组限权密钥；它可以使用账户的可用余额或排队债权开仓，并关闭该账户仓位，随后由中继服务提交签名意图。

会话密钥不能提现，也不能代替真实钱包签名执行质押、解押或领奖。泄露仍可能造成恶意交易和余额亏损。

用户可从真实钱包直接调用 SessionKeyManager.revokeSessionKey 撤销授权；这是一笔 HyperEVM 交易，需要少量 HYPE gas，待提交的相关签名交易将失效。

会话密钥有效期 30 天；每个交易签名有效 1 小时，所以当前密钥剩余不足 1 小时时，应用会要求更新授权。

架构总览

Exchange：维护账户、仓位、盈亏、LP 和队列。BatchExecutor：只接收配置中继服务的批量请求，再逐项分发与结算。

hyperspace 的代币、质押和排放模块分别负责 SPACE 管理、USDC 奖励分配和铸币计算；SessionKeyManager 负责会话密钥登记与验证。

PriceOracle 包装 HyperCore 预编译读取；DepositProxyFactory 与 Create2DepositProxy 负责个人充值地址和资金归集。

BBO（尾号 080e）用于执行价，Mark（0806）与 Oracle（0807）用于分析或兼容；CoreWriter 承担 Core 侧资金转移。

交易路径为用户签名 → 中继服务 → BatchExecutor → Exchange → 读取 BBO → 更新结算与余额，亏损时按规则铸币。不同前端仍依赖配置中继服务；提现和部分维护入口另有公开路径。

BBO 预编译定价

PriceOracle 通过 BBO 预编译读取资产的最优买价和卖价，并解码为 uint64 bid 与 ask。文档主网为 chain 999，BTC 索引 0、ETH 索引 1。

零价格或 ask 小于 bid 会回退，但不存在最大偏离、时间加权或历史回看熔断；因此非零且未交叉的被操纵 BBO 仍可能成交。市场也限于 Hyperliquid 已有订单簿的资产。

pauseMarket 永久退市指定 instrument ID，并冻结当时 bid/ask：禁止新仓，旧仓只能按冻结报价平仓或强平。恢复产品需使用新的 ID。全局 setTradingPaused 则只暂停开仓，平仓和强平继续采用实时 BBO；解除全局暂停需合约所有者。

price = (bid + ask) / 2

非对称盈利折减

盈利按顺序先减去对应入场价 0.2 bps 的微幅盈利扣减，再应用盈利折减，最后扣 2% 盈利费。下式中的 move 使用微幅盈利扣减调整后的离场价格，rawPnl 应与该处理口径一致。折减比例取决于价格波幅和市场参数，不随该笔仓位大小改变。亏损不额外加收用户费用。

文档上线参数：baseRate 10%，rateMultiplier 15000，referenceNotional 10 万美元；positionMultiplier 为 BTC 814.598、ETH 483.979。较大波幅下 scale 趋近 90%，之后仍扣盈利费。

hyperspace 使用固定的参考名义仓位计算盈利折减比例，避免该比例随实际仓位大小变化，从而减少拆成小仓的激励。该曲线降低部分小波幅套利收益，但不能保证 BBO 操纵无利可图。

adjustedPnl = rawPnl × scale
scale = (1 − baseRate) / (1 + term1 + term2)
term1 = 1 / (move × rateMultiplier)
term2 = referenceNotional / (10⁶ × move × positionMultiplier)
move = |exitPrice − entryPrice| / entryPrice
用户获得盈利 = adjustedPnl × 98%

偿付能力与队列记账

LP cash 是扣除用户可用余额、锁仓保证金和应计费用后的现金；sideBucket 在其中标记优先偿债的现金，不能再次相加；queue 记录待付债权。现金不能为负，现金减待付债权的净权益可以为负。

无队列时，新盈利可先支付现金能覆盖的部分；不足部分入队。有队列时，新债权排到队尾。现金仓只将净利润排队，债权仓可能将全部剩余权益排队。盈利费仍从用户利润中扣除，但缺乏条件时不向费用接收者支付。

现金仓亏损：空队列时净额成为 LP 现金；有队列时免亏损费并进入 sideBucket，结算即计入 tracked LP。债权仓亏损只消灭债权，不产生现金；债权仓强平不收费。

任何人可调用 harvest(maxEntries)，按队首兑付并先消耗 sideBucket；团队维护程序通常按新区块调用 harvest(32)。队列清空后残余标记解除，harvest 不再改变 tracked LP。排队债权可用于新仓抵押。

SPACE 铸币曲线

曲线分平坦区和尾部区：trackedLpUsd 低于 200 万美元时，含负值，每美元合格铸币基础为 100 SPACE；阈值以上的速率由累计尾部进度高水位 H 与衰减尺度 S 决定，S 默认 1.2 亿美元。H 只增不减，向质押者划出收益不会重置它；但 tracked LP 再低于阈值仍属于平坦区。

现金仓亏损平仓：空队列时按亏损减 LP 侧费用铸币，有队列免该费用并按完整亏损铸币；tracked LP 对应增加。强平无论是否收费都按完整保证金铸币，但 tracked LP 增量需扣适用费用。债权仓亏损平仓按被销毁债权减适用费用计算；债权仓强平免手续费并按整笔债权铸币。

tailRate(H) = 100 × (S / (S + H))²
S = 120,000,000 USD
H = tailProgressUsd (只增不减)
H = 100,000,000 USD → 尾部边际速率约 29.75 SPACE/USD

CREATE2 充值代理

个人地址由钱包地址、工厂、salt 与固定 init code 通过 CREATE2 确定，可预先推算；到达至少 10 USDC 后由中继服务部署代理。应用先登记地址，再引导转账或桥接至其 HyperCore 侧。

sweeper 检测到现货及可提现永续余额达到阈值后，requestSweep 记录余额并由 CoreWriter 归集；Core 转移完成后，finalizeSweep 才增加 Exchange 内部余额。低于 10 USDC 的余额等待后续补足。

finalize 只有观察到代理余额下降才记账。转移失败或同时新充值掩盖余额变化时，会放弃旧快照并重新归集；已经到 Exchange 但漏记的资金由合约所有者通过 reconcileSweepCredit 补记，所以应用串行处理充值。

sweep/finalize 是公开维护入口，代理部署受中继服务限制，代理只能由 Exchange 发起归集。直接将 ERC-20 转到 HyperEVM 同地址不会入账。

Builder codes

该机制在文档中明确标为尚未上线，且没有确定日期。计划让引入交易的第三方前端在签名意图中附加 builder 标识，从 LP 收入划拨部分中获得 1% 分成。

文档称该分成不增加用户费用，目标是在上线后允许前端注册、标记交易并领取收入。注册流程、意图字段和领奖接口尚待公布，不能把这些描述当作已可调用的功能。hyperspace 的标准前端由团队维护，各前端交易仍由协议中继服务提交。

风险与管理权限

BBO 最内侧挂单即使不成交也可能改变中间价。协议未设置独立参考价或价格偏离熔断机制；微幅盈利扣减、盈利折减和 OI 限额只是摩擦与敞口约束，不能保证操纵无利可图。

上线计划是每个方向上限跟随“当前 OI 加按 BBO 折算的 10 亿美元余量”，余量离开 9 亿至 11 亿美元区间再调整。这既非总 OI 固定上限，也非最大亏损保证。

开平仓、密钥注册、部署代理和质押由配置中继服务提交，仍须有效用户签名。提现支持真实钱包直接调用或由任何人提交真实钱包签名；强平、harvest、归集及推送费用有公开维护入口。

暂停管理者可永久退市并冻结该市场报价，或开启全局开仓暂停。市场维护程序可调整方向 OI、最低保证金和最低名义价值，不能转移抵押或改盈利折减。合约所有者可改参数、角色、市场、补记充值及升级实现；合约可以升级，因此用户仍需信任相关治理权限。

hyperspace LP 机制

hyperspace LP 借助先进先出的兑付队列，让协议无需预先注资即可启动。新赢家在旧队列存在时排到尾部，资金允许就支付队首；没有旧队列时可直接支付，支付不了再创建队列。

队列用于跨时间承接盈亏波动。hyperspace 的现金亏损在空队列时扣适用费用后补充 LP；有队列时存入 sideBucket 用于优先偿债。SPACE 排放则给早期亏损参与者未来收入权益。

hyperspace 的兑付队列不会取消仓位和方向 OI 限制。排队债权需等待可用资金按顺序偿付，没有固定的到账期限。

SPACE 代币总览

SPACE 以 ERC-20 风格实现，核心用途是质押后分享协议 USDC 收入；供应来自合格交易亏损与强平。上线阶段钱包间转账受限，但铸币、质押、解押和奖励领取可用。文档声明初始零供应，没有团队、VC、预铸、空投或归属计划。

排放在 tracked LP 低于 200 万美元时为每美元合格亏损基础 100 SPACE，之后按尾部曲线衰减。质押收益来自适用 2% 交易费用的一半，以及 tracked LP 超过 500 万美元后的超额收益。费用支付必须满足空队列和偿付条件，收益以 USDC 领取。持有 SPACE 与直接持有可随时赎回的 LP 本金并不等同。

质押、解押与领奖接口

应用提交真实钱包签名的 stakeBySig、unstakeBySig、claimBySig，均经中继服务；直接 stake 入口禁用。SPACE 对质押合约自动授权，无需另发 approve。

解押立即返还 SPACE 并停止参与后续分配，已累积奖励仍可领取；无冷却、锁定或等级加成。claim 将奖励记入 Exchange 可用 USDC，之后可提至 HyperCore。

pendingReward(addr) 可无 gas 查询已分配但未领取的奖励，不包含尚未完成分配的未来收入。

Exchange 的 stakerFeeAccumulator 暂存费用；任何人可调用 pushStakerFees，将累积费用及符合条件的 LP 超额收益推送至 hyperspace 质押模块。实际分配由维护程序签名的 distributeBySig 经中继服务完成，更新 accRewardPerShare；公开 distribute 禁用。每次按分配时的质押量同比例计算。

治理与管理权限

Timelock 持有合约所有者权限，相关操作需等待 7 天后执行。

Timelock 由 2/3 多签控制，该多签负责安排、执行或取消合约所有者操作。