OpenScan Crypto Network Skill
Navigate and query crypto networks using OpenScan's infrastructure. Data comes from @openscan/metadata (CDN) and @openscan/network-connectors (RPC).
CLI Location
CODEBLOCK0
Run with: INLINECODE2
Metadata Commands
List networks
CODEBLOCK1
List RPC endpoints
CODEBLOCK2
Look up token
CODEBLOCK3
Event signatures
CODEBLOCK4
Labeled addresses & profiles
CODEBLOCK5
RPC Management Commands
RPCs are persisted in ~/.config/openscan-crypto/rpc-config.json. On first use, the skill auto-fetches from @openscan/metadata and selects privacy-first RPCs. All subsequent commands use the persisted config.
Fetch/sync RPCs from metadata
crypto-cli.mjs rpc-fetch # Sync all networks from @openscan/metadata
crypto-cli.mjs rpc-fetch ethereum # Sync a specific network
Resolves the latest metadata version dynamically from npm. Auto-selects RPCs (privacy-first, open-source preferred).
List RPCs
CODEBLOCK7
Configure RPCs
CODEBLOCK8
Reorder RPCs
CODEBLOCK9
Test/benchmark RPCs
crypto-cli.mjs rpc-test ethereum # Test all configured RPCs
crypto-cli.mjs rpc-test ethereum --all # Test ALL available from metadata
crypto-cli.mjs rpc-test ethereum <url> # Test a specific URL
Tests latency, block number, client version. Detects out-of-sync nodes via block delta.
View/set default strategy
CODEBLOCK11
Address Info Command
Aggregate address information
CODEBLOCK12
Returns in a single call:
- - type:
EOA or contract (with codeSize if contract) - balance: native balance (ETH/MATIC/BNB, etc.)
- txCount: total transaction count (nonce)
- ensName: primary ENS name via reverse lookup (Ethereum mainnet only)
- label: metadata label if the address is a known entity (name, tags, description, website)
- explorerLink: direct link to the OpenScan explorer
This command fires balance, code, and nonce in parallel, then enriches the result with ENS reverse resolution and metadata label lookup.
Price Commands
On-chain token price (100% on-chain, no CoinGecko)
crypto-cli.mjs price # ETH price (default)
crypto-cli.mjs price BTC # BTC price (via WBTC pools on mainnet)
crypto-cli.mjs price --chain polygon # MATIC price
crypto-cli.mjs price --chain bnb # BNB price
crypto-cli.mjs price --chain arbitrum # ETH price (fetched from mainnet for L2s)
Fetches prices from Uniswap V2-style DEX pools. Uses median of multiple pools for manipulation resistance. Returns per-pool breakdown.
Decode transaction (function call + events)
crypto-cli.mjs decode-tx <0xhash> # Decode function + events
crypto-cli.mjs decode-tx <0xhash> --chain arbitrum # On another chain
Decodes transaction input data into human-readable function name + parameters. Also decodes all event logs in the receipt. Uses local database of known selectors + 4byte.directory fallback. Identifies tx type: transfer, contract
call, or contractcreation.
Strategies:
- -
fallback — Try RPCs in order, move to next on failure. Default. Most conservative. - INLINECODE12 — Fire all RPCs simultaneously, use fastest response. Best for latency.
- INLINECODE13 — Fire all, compare results, detect inconsistencies. Trustless verification.
EVM Query Commands
All EVM commands accept --chain <chain> (default: ethereum) and --private (use tracking:none RPCs only).
Check balance
crypto-cli.mjs balance <address> # Native balance (ETH)
crypto-cli.mjs balance vitalik.eth # ENS name supported
crypto-cli.mjs balance <address> --token USDC # + ERC20 balance
crypto-cli.mjs balance <address> --chain arbitrum # On Arbitrum
crypto-cli.mjs balance <address> --token USDC --chain base # USDC on Base
Returns native balance in human-readable format (e.g., "32.12 ETH") plus raw wei. Token balance includes symbol, decimals, and formatted amount.
Multi-chain balance
crypto-cli.mjs multi-balance <address> # All mainnet chains
crypto-cli.mjs multi-balance vitalik.eth # ENS supported
crypto-cli.mjs multi-balance <address> --private # Privacy RPCs only
Queries the same address across ALL mainnet EVM chains in parallel. Shows balances sorted by chains with funds first.
Get block info
crypto-cli.mjs block # Latest block
crypto-cli.mjs block latest # Same
crypto-cli.mjs block 19000000 # By number
crypto-cli.mjs block 0xabcdef... # By hash (66 chars)
Returns: number, hash, timestamp, gasUsed, gasLimit, baseFee, txCount, miner.
Transaction details
crypto-cli.mjs tx <0xhash>
crypto-cli.mjs tx <0xhash> --chain arbitrum
Returns: hash, blockNumber, from, to, value (in ETH), gasPrice, nonce, input data.
Transaction receipt
crypto-cli.mjs receipt <0xhash>
Returns: status (success/reverted), gasUsed, effectiveGasPrice, contract address (if deploy), logs with decoded event names from metadata.
Gas prices
crypto-cli.mjs gas # Ethereum gas
crypto-cli.mjs gas --chain base # Base gas
crypto-cli.mjs gas --chain arbitrum # Arbitrum gas
Returns: gasPrice, maxPriorityFeePerGas, baseFee — all in gwei.
Read contract (eth_call)
crypto-cli.mjs call <to_address> <calldata_hex> [--block <tag>]
For raw contract reads. Use for custom ABI calls.
Event logs
crypto-cli.mjs logs --address <contract> --topic <topic_hash> [--from <block>] [--to <block>]
Returns up to 50 logs. Default range: latest block only.
Check if address is contract
crypto-cli.mjs code <address>
Returns: isContract (bool), codeSize, truncated bytecode.
Transaction count (nonce)
CODEBLOCK24
Bitcoin Commands
Bitcoin queries use the mempool.space REST API (no JSON-RPC needed).
Blockchain overview
crypto-cli.mjs btc-info
Returns: block height, best hash, difficulty, mempool stats, recommended fees — all in one call.
Block details
CODEBLOCK26
Transaction details
crypto-cli.mjs btc-tx <txid>
Returns: confirmation status, fee (sats + BTC), fee rate (sat/vB), inputs/outputs with addresses and values.
Mempool state
crypto-cli.mjs btc-mempool
Returns: tx count, vsize, total fees, recommended fee rates, 5 most recent txs.
Fee estimates
crypto-cli.mjs btc-fee
Returns: fastest, halfHour, hour, economy, minimum — all in sat/vB.
Address balance
crypto-cli.mjs btc-address <address>
Returns: balance (BTC + sats), total received/sent, tx count, UTXO count.
Chain Aliases
| Alias | Chain ID | Network |
|---|
| ethereum, eth, mainnet | 1 | Ethereum |
| optimism, op |
10 | Optimism |
| bnb, bsc | 56 | BNB Smart Chain |
| polygon, matic, pol | 137 | Polygon |
| base | 8453 | Base |
| arbitrum, arb | 42161 | Arbitrum One |
| sepolia | 11155111 | Sepolia Testnet |
| bitcoin, btc | bip122:... | Bitcoin Mainnet |
Numeric chain IDs also work (e.g., 1, 42161).
Output
All commands output JSON to stdout. The agent can parse and format as needed.
Numeric values are pre-formatted:
- - Balances: human-readable (e.g., "32.12 ETH") + raw wei
- Gas: in gwei
- Timestamps: ISO 8601
- Hex numbers: converted to decimal strings
Explorer Links
EVM commands that return on-chain entities include an explorerLink field with a direct URL to openscan.eth.link:
| Command | explorerLink points to |
|---|
| INLINECODE19 | address page |
| INLINECODE20 |
address page per chain |
|
block | block page |
|
tx | transaction page |
|
receipt | transaction page |
|
code | address page |
|
nonce | address page |
|
token | token contract address page |
|
logs | transaction page per log |
|
btc-block | Bitcoin block page |
|
btc-tx | Bitcoin transaction page |
|
btc-address | Bitcoin address page |
|
address-info | address page |
URL patterns:
- - EVM: INLINECODE32
- Bitcoin mainnet: INLINECODE33
- Bitcoin testnet4: INLINECODE34
Always show this link to the user so they can explore the data further in the UI.
Caching
Metadata cached in ~/.cache/openscan-crypto/ (6h TTL). RPC responses are NOT cached.
ENS Support
All EVM address commands accept .eth names (e.g., vitalik.eth). ENS is resolved on Ethereum mainnet automatically. Works with: balance, multi-balance, code, nonce.
Security
- - READ-ONLY — no transaction signing, no private key handling
- Public RPCs — no API keys needed
- INLINECODE42 flag restricts to tracking:none RPCs
- Dangerous methods (sendTransaction, etc.) are NOT exposed
Natural Language Mapping
| User says | Command |
|---|
| "What's Vitalik's ETH balance?" | INLINECODE43 |
| "How much USDC does 0x... have on Base?" |
balance 0x... --token USDC --chain base |
| "Show the latest Ethereum block" |
block latest |
| "What's gas like on Arbitrum?" |
gas --chain arbitrum |
| "Look up this transaction" |
tx 0x... |
| "Did this tx succeed?" |
receipt 0x... |
| "Is 0x... a contract?" |
code 0x... |
| "What networks does OpenScan support?" |
networks |
| "What's the USDC contract address?" |
token USDC |
| "Show privacy-friendly Polygon RPCs" |
rpcs polygon --private |
| "Show vitalik.eth balance on all chains" |
multi-balance vitalik.eth |
| "What's the latest Bitcoin block?" |
btc-info or
btc-block |
| "Tell me everything about this address" |
address-info 0x... |
| "Is 0x... a wallet or a contract?" |
address-info 0x... |
| "What's the ENS name for 0x...?" |
address-info 0x... (reverse ENS) |
| "Show me info for vitalik.eth" |
address-info vitalik.eth |
| "How full is the Bitcoin mempool?" |
btc-mempool |
| "What are Bitcoin fees right now?" |
btc-fee |
| "Look up this Bitcoin transaction" |
btc-tx <txid> |
| "Check Satoshi's balance" |
btc-address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa |
| "Show Bitcoin block 800000" |
btc-block 800000 |
