Skip to main content
glnc

GETTING STARTED

Quickstart: five commands in five minutes

This page walks you from install to first useful output across the three core commands. Every example is copy-pasteable; the only thing you need to swap in is a wallet address you actually want to inspect.

1. Install

One line on macOS or Linux:

brew install aryarahimi1/glnc/glnc
glnc 1.0.9 → /opt/homebrew/bin/glnc

No Homebrew? Use the curl installer, which verifies SHA256 before writing the binary. Full install detail lives on the install page.

2. Check a balance

Pass an ENS name or an address. glnc auto-detects the address format and picks the right chain. ENS names resolve via standard mainnet contracts.

glnc balance vitalik.eth
resolved: vitalik.eth → 0xd8dA…6045
⬢ ETHEREUM (59 tokens)
ETH 1,394.21 $4,529,883
USDC 233,408.00 $233,408
─────────────────────────
TOTAL $5,901,512

3. Decode a transaction

Paste any EVM transaction hash. glnc reads calldata, walks nested call frames, and decodes token movements from receipt logs.

glnc tx 0x02d15281c5514a447192cc8d6140216050f8d3bf92efccd420b635274764fb94
✓ Multi-command swap
via Uniswap Universal Router on ⬢ ETHEREUM
Token movements:
− 40,000.000000 wXTM you → 0x5ADe…34F5
+ 77.797032 USDT 0x4C82…2cCA → you
gas: 542,564 × 0.32 gwei · $0.41

4. Check gas

A live snapshot across all 9 chains, with EVM percentile fee tiers, BTC mempool sat/vB, and Solana priority fees. Add --watch to update in place.

glnc gas
Chain base p50 p90
ethereum 12.4 1.2 3.1 gwei
base 0.04 0.001 0.001 gwei
bitcoin — 1 4 sat/vB
solana — 3000 5000 μlmp

5. Pipe JSON into jq

Every command emits a stable, versioned envelope on stdout under --json. Pipe directly into jq for scripting.

glnc balance vitalik.eth --json | jq '.data.totalUsd'
5901512.42

That's the loop. Next, pick a command and go deep on its flags, or browse the full envelope schema.