Add svm balances command with SimClient wiring

[ivpusic]

Add dune sim svm balances <address> for querying SVM token balances across Solana/Eclipse chains with USD valuations. Supports --chains, --limit, --offset flags, text table and JSON output.

[ivpusic]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Add svm transactions command with signature extraction and block time formatting #39
• Add svm balances command with SimClient wiring #38 👈 (View in Graphite)
• Add evm defi-positions command for DeFi portfolio positions #37
• Add evm token-holders command with token address as positional arg #36
• Add evm token-info command for token metadata and pricing #35
• Add evm collectibles command for NFT listings with spam filtering #34
• Add evm transactions command and fix OpenAPI spec gaps across all EVM commands #33
• EVM activity #31
• Sim evm stablecoins #30
• Get balance #29
• Sim evm balances #28
• Supported chains #27
• Sim auth #26
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[cursor]

PR Summary

Low Risk
Low risk and mostly additive: introduces a new CLI subcommand plus e2e-style tests, with no changes to existing auth or data mutation paths beyond reusing the existing Sim client context wiring.

Overview
Adds dune sim svm balances <address> to query the Sim API GET /beta/svm/balances/{address} with optional --chains, --limit, and --offset parameters, supporting both table (text) output and passthrough -o json output.

Wires SVM subcommands to a small SimClient interface extracted from command context (requireSimClient) and adds authenticated e2e tests covering text/JSON output, chain filtering, limit, and pagination behavior (skipped if DUNE_SIM_API_KEY is unset).

^{Written by Cursor Bugbot for commit 1b64179. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is ON. A cloud agent has been kicked off to fix the reported issues.}

Comment @cursor review or bugbot run to trigger another review on this PR

[cursor]

Duplicated formatUSD utility across EVM and SVM packages

Low Severity

The formatUSD function in cmd/sim/svm/balances.go is an exact copy of the one in cmd/sim/evm/balances.go. This utility has no package-specific type dependencies and could live in the shared output package to avoid duplicated logic and the risk of the two copies diverging over time.

 

[cursor]

Display uses optional Balance field instead of required Amount

Low Severity

The text table displays b.Balance (tagged json:"balance,omitempty") in the BALANCE column, but this field is optional per its struct definition. The required Amount field (no omitempty) is never displayed. If the API omits balance for any entry, that table cell will be blank with no fallback to Amount.