API 钱包安全边界持续退化,原生权限控制成关键短板。
撰文:DevenMat,Valantis Labs 联合创始人
编译:AididiaoJP,Foresight News
注释:文中对 Hyperliquid 状态模型的假设主要基于测试网交易。HyperCore 状态机目前是黑盒——节点运行签名二进制文件,代码未公开。API 钱包引入权限策略的实际成本,只能通过测试网交易及 Hyperliquid 公开的架构决策进行估算。在节点源代码公开之前,社区提出有依据的改进建议仍受限制。
Hyperliquid 作为流动性后端,能让个人代理在统一底座上为用户构建完整金融体验。它本身具备深度流动性、可组合、可编程且中立的特质,因此被定位为代理时代不可替代的金融基础设施。
但 HyperCore 目前缺少代理所依赖的核心安全能力——范围受限的权限策略。权限策略本质上是范围受限的权限,例如只允许在指定市场交易、开仓前必须获得批准、禁止向未知地址转账等。正是这类限定权限,才让今天的非金融个人代理能够安全操作邮件、日历、联系人等数据。而 Hyperliquid 在过去一年里,恰恰取消了对这种范围限定 API 访问的支持。
API 钱包(此前称为代理钱包)的安全边界持续退化,已到了不适合再向代理开放用户账户权限的地步。这里需要强调的是 AI 代理需要通过 API 钱包来操作 Hyperliquid 上的账户,但目前的 API 钱包权限过大、缺乏限制,导致直接把 API 钱包交给 AI 代理风险很高。
本文试图找到一条路径,重新把 Hyperliquid 打造成为个人代理可靠的金融后端。
钱包里的 AI 代理
AI 代理是实现 Hyperliquid「流动性 AWS」愿景的关键分发渠道,它能让 Hyperliquid 真正成为数十亿人日常金融生活的底层。
未来的个人金融形态,将是代理直接接入你的投资组合,在获得明确授权后代表你行动,调用资金、凭证与数据。若想让 Hyperliquid 成为这些代理的金融层,就必须提供账户级权限控制:允许代理只接触账户中特定部分,而非全部。
目前唯一可行的方式是通过 CoreWriter,但延迟问题让该方案并不完整,必须在 HyperCore 原生层面再加一层控制。API 钱包本身也必须守住最低安全边界,才能支撑代理所需的使用体验。
现在直接把 API 钱包交给 AI 代理,风险既大且还在持续扩大。
AI 代理支持已中断
API 钱包最初设计的安全边界已大幅退化。
如今,只要用户账户资产超过约 4000 万美元,一旦 API 钱包被恶意使用,攻击者就可以用账户资金买入 50 万枚 HYPE 并质押,再以这些质押资产启动一个由自己控制的 HIP-3 市场。这样一来,用户的相关资产将被锁定 183 天,并面临被惩罚的风险。而且这一系列操作不可逆,即使用户事后撤销 API 钱包,也无法挽回。
情况并非一直如此。我们来回顾一下历史上的边界。
最初设计中,API 钱包不能从账户提现或转账。
但系统从未限制 API 钱包可调用的保证金规模。一旦被攻破,攻击者可通过在流动性差的市场下恶意订单(自己作为对手方),把资金转走。2022 年,交易机器人服务 3Commas 泄露的 API 密钥,就被用来在用户 Binance 账户中下单,专门挑流动性最差、最容易被操纵的时段下手。
除上述攻击外,后续一系列升级还引入了最初安全架构完全未考虑的新风险敞口。

这些不相关的升级陆续叠加,最终让 API 钱包的安全边界基本失效。
风险
API 钱包已成为用户通过界面在 Hyperliquid 交易的默认方式。目前不少钱包还在多个构建者代码应用中直接列出托管式 API 钱包。
对普通交易应用而言,这种风险或许尚可接受——毕竟它们只控制用户群体中的一部分。但一旦引入 AI 代理,风险就会急剧放大。
AI 代理不需要窃取你的 API 钱包私钥就能掏空账户。它只需被诱导阅读一段恶意文本即可。把 API 钱包交给代理,就等于把上述所有攻击路径,暴露给任何能在它面前放一句话的人。
API 钱包权限为何持续扩大?
HyperEVM 上的智能合约通过 CoreWriter 与 HyperCore 交互,这是 Hyperliquid 可编程应用的基础框架。智能合约改变 HyperCore 状态有两种方式:调用 CoreWriter 动作,或使用 API 钱包。
为了让智能合约具备和普通账户相同的操作能力,最简单的做法就是不断给 API 钱包增加权限。更理想的方式本应是:每当出现一种对延迟不敏感、但对安全敏感的新账户操作时,就单独为其增加一个 CoreWriter 动作。但 CoreWriter 的维护成本更高——每个新动作都需要独立的动作 ID、节点侧支持,并在 HyperCore 上作为单独的交易类型出现。相比之下,直接给 API 钱包加权限,只需极低的成本,就能同时覆盖智能合约和普通账户。
同时,HyperCore 上几乎所有交易基础设施都采用类似架构:低延迟的 API 钱包热密钥与网络就近部署,冷钱包则离线隔离。因此,所有对延迟敏感的操作都必须能由 API 钱包执行,才能满足高价值账户的使用需求。这也解释了为什么优先费的支出发生在 API 钱包上,以及为什么用于补充优先费余额的质押存款,首次被纳入 API 钱包的权限范围——很可能是应优先费用户的要求。
API 钱包权限持续扩大,是因为不同构建者出于不同需求依赖它。问题在于,每一次升级都无差别地扩大了外部应用对用户账户的控制,且用户无法选择退出。
Hyperliquid 上的权限策略
目前在 Hyperliquid 实现按动作权限控制的最佳方式,是用 HyperEVM 上的智能合约账户去控制对应的 HyperCore 地址。所有 HyperCore 动作在通过 CoreWriter 前,都会先经过自定义 Solidity 检查。我们开发的 Valantis Prime 正是为此设计:它借助 Obsidian 的 CoreWriterLib 和自定义 Guardian,让 HyperCore 交易具备权限控制和可编程性。具体能力包括:
- 为 HyperCore 多签设置不同动作的签名者和阈值;
- 对 HyperCore 转账设置白名单和金额上限。
但这套设计在交易场景下完全失效。
交易必须通过 HyperEVM 提交,经过 Solidity 检查后,再等到下一个 HyperCore 区块处理 CoreWriter 动作才能真正执行。这种方式适合质押、转账、借贷等对延迟不敏感的操作,却无法满足交易这类低延迟需求。
若要低延迟,就必须用 API 钱包直接与 HyperCore 交互,而 API 钱包目前没有任何约束或控制层。
Privy 提供托管服务,可在签名前强制执行策略。我们判断,如果没有原生原语来限制账户签名权限,托管式可信签名中间件将成为 Hyperliquid 大量用户的关键依赖。我们认为这既不理想,也非必要。
依赖可信中间件来实现代理在 Hyperliquid 上所需的安全原语,会削弱代理本应在此蓬勃发展的根本原因——直接连接可信中立的流动性基础设施。一旦 AI 代理应用必须把私钥托管在服务器上,其发展空间就会大幅缩小。对未来十年的 Hyperliquid 而言,在 HyperCore 原生实现策略层至关重要。
提案:为 API 钱包新增权限字段
为 API 钱包构建完整权限策略层(包括保证金上限和市场选择),很可能违反 HyperCore 最小状态的设计原则。因此我们建议采用最小动作级二进制权限。
实现应保持灵活且轻量——可用一个位图记录每种动作类型是否允许 API 钱包调用,或采用等效的最小结构。
Hyperliquid 已在 HIP-3 部署者上采用类似机制。通过 setSubDeployers,部署者可随时授予或撤销其他地址调用其 dex 上特定 perpDeploy 变体的权限——每个动作单独授权,且仅限该动作本身。

同样的模式可应用于 API 钱包。交易时,系统恢复签名者、定位主账户,再检查对应动作类型的权限位,判断该 API 钱包是否被授权。新增状态仅为每个 API 钱包一个位图。
核心设计原则是:网络升级时,API 钱包权限不会自动扩大。
预期效果包括:
API 权限范围可安全扩展。需要相关权限的代理可获得质押、提现、转账能力,而不会破坏整体安全架构。
新增 L1 动作或网络升级,不再自动扩大现有 API 钱包的权限范围。可更自由地为 API 钱包添加动作,而不影响整体安全。
HyperCore 账户可实现完全可编程,无需依赖托管基础设施。CoreWriter 与受约束的 API 钱包结合后,每个动作都能配置自定义安全规则,且不会给 HyperCore 带来状态膨胀。
区块链的核心优势在于可组合与可编程。Hyperliquid 早期为追求性能,主动降低了可编程性。HyperEVM 与 CoreWriter 的引入,正是为了以较低资源开销为 HyperCore 补充可编程能力。
缺少原生、最小的 API 钱包控制层,这一能力目前仍不完整。
免责声明:本文章仅代表作者个人观点,不代表本平台的立场和观点。本文章仅供信息分享,不构成对任何人的任何投资建议。用户与作者之间的任何争议,与本平台无关。如网页中刊载的文章或图片涉及侵权,请提供相关的权利证明和身份证明发送邮件到[email protected],本平台相关工作人员将会进行核查。