# Hyperliquid机器人余额为空或签名被拒：核账户、agent权限与nonce 整理：链小知（AI 辅助） 资料核对日期：2026-10-14 引用地址：https://lianxiaozhi.com/tools/guides/hyperliquid-agent-account-nonce-expiry-review 难度：进阶 核验方式：官方文档整理，未执行真实账户操作 将真正账户和签名者分开，检查委托替换、过期、内部划转及nonce冲突。 ## 使用工具 - [Hyperliquid](https://lianxiaozhi.com/tools/hyperliquid) · [官方入口](https://hyperliquid.xyz/) ## 前置条件 - 准备原账户/子账户地址、Mainnet/Testnet、agent地址与名称、批准/过期记录，以及脱敏action、nonce、错误和当时仓位；不要提供密钥、助记词或可重放签名。 - 适用2026-10-14读取的官方静态文档；只核本人已有脱敏记录，不登录、请求账户、运行SDK、签名或操作资金。当前文档不反推旧版本行为。 ## 1. 把账户地址和签名者分别列出 API wallet又叫agent wallet，主账户可批准其替主账户或子账户签名。Info读取对象应是实际主/子账户，agent地址不是资金账户；原userRole返回agent时data.user才指向所属用户。子账户/金库没有独立私钥，原动作的vaultAddress指定被操作账户。 核对结果：资金账户、签名者、目标子账户和网络分别可追溯，空结果未当账户为零。 依据：[Hyperliquid：API钱包、nonce及注销后重放边界](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets.md) 依据：[Hyperliquid：账户地址、userRole和fills字段](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint.md) 依据：[Hyperliquid：agent动作、approveAgent与子账户签名](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint.md) ## 2. 按原action核权限，不用一个标签概括 对原order等交易动作和资金动作逐项辨认。当前Exchange明确允许agentSendAsset由agent签名，但destination必须等于source地址，并按sourceDex/destinationDex在Spot或Perp DEX间划转；Perp DEX仅支持其抵押token。这不代表可向任意外部地址转出，也不能说agent绝无内部余额移动能力。 核对结果：原action、源/目标地址与DEX匹配，未把内部划转许可扩大到外部提现。 依据：[Hyperliquid：agent动作、approveAgent与子账户签名](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint.md) 依据：[Hyperliquid：API钱包、nonce及注销后重放边界](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets.md) ## 3. 从签名者定位nonce冲突 Hyperliquid按signer保留最高100个nonce；新nonce须未用过且大于集合最小值，处在区块时间T的(T−2天,T+1天)内，时间单位毫秒。这与Ethereum严格nonce+1不同。同一agent签多个子账户仍共用nonce集合，多进程原日志应按signer比较，不能仅按子账户查重。 核对结果：nonce完整值、毫秒时间和同signer调用顺序可比较；重复/越窗与余额不足分开。 依据：[Hyperliquid：API钱包、nonce及注销后重放边界](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets.md) ## 4. 区分委托期限和单次动作deadline approveAgent可在名称附valid_until {timestamp}设置期限，当前正文上限180天；expiresAfter是部分action的单次毫秒截止时间，Core USDC transfer等user-signed动作不支持它。某次动作过期不等agent整体被注销，批准回执也不等后续动作成功。 核对结果：委托过期与action截止分别有字段依据；未知期限未补猜。 依据：[Hyperliquid：agent动作、approveAgent与子账户签名](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint.md) 依据：[Hyperliquid：API钱包、nonce及注销后重放边界](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets.md) ## 5. 核替换或注销后的权限与遗留材料 新建同名agent会注销原同名agent，新建unnamed会替换旧unnamed；到期或注册账户无资金也可能触发nonce状态清理。官方警告不要复用旧agent地址：nonce清理后旧已签动作可能重放。用已有批准/替换记录定位生效期间，并另核开放订单/仓位；从委托注销记录不能推出它们已取消或关闭。 核对结果：旧agent生命周期、旧签名风险及订单/仓位结论分开，未导出或重放签名。 依据：[Hyperliquid：API钱包、nonce及注销后重放边界](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets.md) 依据：[Hyperliquid：agent动作、approveAgent与子账户签名](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint.md) ## 常见错误 - 单次action截止时间与agent整体期限不同；替换旧agent也不等取消所有开放订单。 - 受限内部划转、交易权限和外部资金控制需要逐action看，保留原批准记录。 ## 完成检查 - 能将原记录中的权限、阶段或资产变化定位，并列明缺失材料。 - documentation：步骤与来源已核，个人账户状态、执行和接收未实测。 ## 相关知识 - [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data) ## 官方依据 - [Hyperliquid：API钱包、nonce及注销后重放边界](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets.md) - [Hyperliquid：账户地址、userRole和fills字段](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint.md) - [Hyperliquid：agent动作、approveAgent与子账户签名](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint.md)