@hieco/mirror-cli
v1.0.0
Published
CLI tool for Hedera Mirror Node REST API - query accounts, tokens, transactions, blocks, contracts, schedules, topics, and network state
Downloads
51
Maintainers
Readme
@hieco/mirror-cli
@hieco/mirror-cli is the command-line companion to Hieco’s Mirror client.
It lets you inspect Hedera data from a terminal as quickly as you can think of the question.
Why This Package Exists
Sometimes the fastest way to understand chain data is not a script or an app. It is a terminal command you can run right now.
@hieco/mirror-cli exists for that moment. It gives you:
- one
hiecobinary - read-only commands across the main Mirror domains
- human-friendly output for exploration
- JSON output for shell scripts and automation
When To Use It
Choose @hieco/mirror-cli when you want to:
- inspect accounts, tokens, transactions, contracts, or topics
- verify Mirror responses without writing code
- script read-only blockchain checks in CI or local tooling
- move quickly between “what does the data look like?” and “now automate it”
If you need a programmatic client, use @hieco/mirror.
Run Without Installing
bunx @hieco/mirror-cli --helpnpx -y @hieco/mirror-cli --helppnpm dlx @hieco/mirror-cli --helpyarn dlx @hieco/mirror-cli --helpGlobal Installation
npm install --global @hieco/mirror-clipnpm add --global @hieco/mirror-cliyarn global add @hieco/mirror-clibun add --global @hieco/mirror-cliThe installed binary name is hieco.
Quick Start
bunx @hieco/mirror-cli account 0.0.1001
bunx @hieco/mirror-cli balance 0.0.1001
bunx @hieco/mirror-cli token 0.0.2001
bunx @hieco/mirror-cli transactions:list --account 0.0.1001 --limit 10
bunx @hieco/mirror-cli network:exchange-rateCommand Model
The CLI follows a consistent pattern:
- single-resource lookups such as
account,token, andtransaction - filtered collection commands such as
balances,blocks, andcontract:results - broad list commands such as
accounts:list,tokens:list, andtopics:list
Global flags available on every command:
-n, --network <network>-u, --mirror-url <url>
Most commands also accept -j, --json.
Common Workflows
Explore data interactively
bunx @hieco/mirror-cli contract 0.0.3001
bunx @hieco/mirror-cli topic:messages 0.0.5005 --limit 20Use JSON in a shell pipeline
bunx @hieco/mirror-cli transactions:list --account 0.0.1001 --limit 25 --json > transactions.jsonPoint at a different network
bunx @hieco/mirror-cli accounts:list --network testnet --limit 5