// Check token balances for each leg of a warp route. Shows collateral locked (for collateral/native legs) and total circulating supply (for synthetic legs). Use when you want to inspect the current state of a warp route's liquidity.
| name | warp-balances |
| description | Check token balances for each leg of a warp route. Shows collateral locked (for collateral/native legs) and total circulating supply (for synthetic legs). Use when you want to inspect the current state of a warp route's liquidity. |
Run hyperlane warp balances to display the token balance of each leg in a warp route.
hyperlane warp balances \
--warp-route-id <SYMBOL/chains> \
--registry <path-or-url>
| Flag | Description |
|---|---|
--warp-route-id / -w | Warp route ID (e.g. ETH/ethereum-arbitrum). Prompts interactively if omitted. |
--registry / -r | Registry path or URL. Defaults to the public Hyperlane registry. |
--chains | Filter to specific chains (space-separated). |
--out / -o | Write results to a JSON or YAML file. |
--address | User address to check balances for. Shows the user's token balance on each chain instead of collateral/supply. |
--raw | Show balances in base units (without decimal formatting). |
| Column | Description |
|---|---|
(index) | Chain name |
Symbol | Token symbol |
Standard | Token standard (e.g. EvmHypCollateral, EvmHypSynthetic) |
Address | Router contract address |
Balance | Collateral locked / circulating supply (default), or user's token balance (with --address) |
Determine the warp route ID and registry to use. If not provided, ask the user.
Run the command:
hyperlane warp balances --warp-route-id <ID> --registry <REGISTRY>
If the user wants to save the output, add --out balances.json.
If the user wants to filter to specific chains:
hyperlane warp balances --warp-route-id <ID> --registry <REGISTRY> --chains ethereum arbitrum
If the user wants to check their own token balance on each leg, add --address:
hyperlane warp balances --warp-route-id <ID> --registry <REGISTRY> --address <USER_ADDRESS>
If the user wants raw base-unit amounts (no decimal formatting), add --raw:
hyperlane warp balances --warp-route-id <ID> --registry <REGISTRY> --raw
Report the balances to the user, noting:
--address: collateral legs show locked/backing balance; synthetic legs show total circulating supply--address: every leg shows the user's token balance on that chain--raw applies to all balance values and the mismatch summary (base units, no decimals)Error in the Balance column means the RPC call failed for that leg--address: a status line is printed after the table — green if collateral == synthetic total, yellow warning with diff if they divergehyperlane warp balances --warp-route-id USDC/base-optimism --registry ~/hyperlane-registry
Warp route balances:
┌──────────┬────────┬──────────────────────┬────────────┬────────────────┐
│ (index) │ Symbol │ Standard │ Address │ Balance │
├──────────┼────────┼──────────────────────┼────────────┼────────────────┤
│ base │ USDC │ EvmHypCollateral │ 0x5244... │ 4,231,876.12 │
│ optimism │ USDC │ EvmHypSynthetic │ 0x2DBe... │ 4,231,876.12 │
└──────────┴────────┴──────────────────────┴────────────┴────────────────┘
Status: collateral matches synthetic supply (4,231,876.12)
hyperlane warp balances --warp-route-id USDC/base-optimism --registry ~/hyperlane-registry --address 0xYourAddress
Warp route balances for 0xYourAddress:
┌──────────┬────────┬──────────────────────┬────────────┬──────────┐
│ (index) │ Symbol │ Standard │ Address │ Balance │
├──────────┼────────┼──────────────────────┼────────────┼──────────┤
│ base │ USDC │ EvmHypCollateral │ 0x5244... │ 500.00 │
│ optimism │ USDC │ EvmHypSynthetic │ 0x2DBe... │ 250.00 │
└──────────┴────────┴──────────────────────┴────────────┴──────────┘
hyperlane warp balances --warp-route-id USDC/base-optimism --registry ~/hyperlane-registry --raw
Warp route balances:
┌──────────┬────────┬──────────────────────┬────────────┬───────────────┐
│ (index) │ Symbol │ Standard │ Address │ Balance │
├──────────┼────────┼──────────────────────┼────────────┼───────────────┤
│ base │ USDC │ EvmHypCollateral │ 0x5244... │ 4231876120000 │
│ optimism │ USDC │ EvmHypSynthetic │ 0x2DBe... │ 4231876120000 │
└──────────┴────────┴──────────────────────┴────────────┴───────────────┘
Status: collateral matches synthetic supply (4231876120000)
First step of deploying a new warp route (steps 1–9). Reads a Linear ticket to extract token details and chain configuration, looks up mailbox addresses from the local registry, generates the deploy.yaml, runs the deploy, and optionally runs a send test. Follow up with /warp-deploy-update-owners.
Post-deployment ownership transfer and registry PR for a warp route. Transfers ownership from the temporary deployer address to real owners, adds CoinGecko ID, commits, and opens a registry PR. Run after warp-deploy-init completes deployment.
Debug validator checkpoint inconsistencies where some validators are behind others. Use when alerts mention "checkpoint inconsistency", "validators behind", or "inconsistent latest checkpoints", or when asked to debug validator sets, investigate validator delays, or troubleshoot metadata fetch failures for a chain. Defaults to default_ism app context if not specified.
Debug RPC provider health issues for a chain. Use when alerts mention RPC failures, high latency, stale blocks, or provider errors. Diagnoses the issue and recommends fixes.
Apply RPC URL changes for a chain. Use after /debug-rpc-provider has diagnosed the issue and recommended new URLs. The user invoking this skill is the confirmation gate.
Encode and decode raw Hyperlane messages to/from packed hex bytes using the CLI. Use when you need to construct a message for testing, inspect a raw message from logs or a transaction, or decode a warp transfer body.