{"skill":{"slug":"openscan-crypto","displayName":"OpenScan Crypto","summary":"Navigate and query crypto networks via OpenScan infrastructure. Use when the user asks about blockchain data — balances (ETH, ERC20, BTC), blocks, transactio...","description":"---\nname: openscan-crypto\ndescription: Navigate and query crypto networks via OpenScan infrastructure. Use when the user asks about blockchain data — balances (ETH, ERC20, BTC), blocks, transactions, gas prices, mempool, fee estimates, token lookups, event decoding, RPC endpoints, or ENS resolution. Supports Ethereum, Bitcoin, Arbitrum, Optimism, Base, Polygon, BNB and Sepolia. Powered by @openscan/network-connectors and @openscan/metadata.\n---\n\n# OpenScan Crypto Network Skill\n\nNavigate and query crypto networks using OpenScan's infrastructure. Data comes from `@openscan/metadata` (CDN) and `@openscan/network-connectors` (RPC).\n\n## CLI Location\n\n```\nskills/openscan-crypto/scripts/crypto-cli.mjs\n```\n\nRun with: `node <skill_dir>/scripts/crypto-cli.mjs <command> [args]`\n\n## Metadata Commands\n\n### List networks\n```bash\ncrypto-cli.mjs networks\n```\n\n### List RPC endpoints\n```bash\ncrypto-cli.mjs rpcs <chain>              # All public RPCs\ncrypto-cli.mjs rpcs <chain> --private    # Only tracking:none RPCs\n```\n\n### Look up token\n```bash\ncrypto-cli.mjs token <symbol|address>                # Search all mainnets\ncrypto-cli.mjs token <symbol|address> --chain <chain> # Specific chain\n```\n\n### Event signatures\n```bash\ncrypto-cli.mjs events [--chain <chain>]     # List known events\ncrypto-cli.mjs decode-event <topic_hash>    # Decode one topic\n```\n\n### Labeled addresses & profiles\n```bash\ncrypto-cli.mjs addresses [--chain <chain>]\ncrypto-cli.mjs profile networks ethereum\ncrypto-cli.mjs profile apps openscan\n```\n\n## RPC Management Commands\n\nRPCs 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.\n\n### Fetch/sync RPCs from metadata\n```bash\ncrypto-cli.mjs rpc-fetch                # Sync all networks from @openscan/metadata\ncrypto-cli.mjs rpc-fetch ethereum       # Sync a specific network\n```\nResolves the latest metadata version dynamically from npm. Auto-selects RPCs (privacy-first, open-source preferred).\n\n### List RPCs\n```bash\ncrypto-cli.mjs rpc-list ethereum              # Show active (configured) RPCs\ncrypto-cli.mjs rpc-list ethereum --all        # Show ALL available RPCs from metadata\ncrypto-cli.mjs rpc-list ethereum --all --private  # Only privacy (tracking:none)\n```\n\n### Configure RPCs\n```bash\ncrypto-cli.mjs rpc-set ethereum --strategy race         # Set strategy: fallback|race|parallel\ncrypto-cli.mjs rpc-set ethereum --add https://my-rpc.com  # Add custom RPC\ncrypto-cli.mjs rpc-set ethereum --remove https://rpc.com  # Remove an RPC\ncrypto-cli.mjs rpc-set ethereum --rpcs url1 url2 url3   # Replace all RPCs\ncrypto-cli.mjs rpc-set ethereum --private-only           # Keep only tracking:none\ncrypto-cli.mjs rpc-set ethereum --reset                  # Reset to metadata defaults\ncrypto-cli.mjs rpc-set --default-strategy parallel       # Set global default strategy\ncrypto-cli.mjs rpc-set --max-rpcs 3                      # Set global max RPCs per network\n```\n\n### Reorder RPCs\n```bash\ncrypto-cli.mjs rpc-order ethereum --benchmark            # Auto-sort by latency (fastest first)\ncrypto-cli.mjs rpc-order ethereum --swap 1 3             # Swap positions 1 and 3\ncrypto-cli.mjs rpc-order ethereum <url> --position 1     # Move URL to position 1\n```\n\n### Test/benchmark RPCs\n```bash\ncrypto-cli.mjs rpc-test ethereum              # Test all configured RPCs\ncrypto-cli.mjs rpc-test ethereum --all        # Test ALL available from metadata\ncrypto-cli.mjs rpc-test ethereum <url>        # Test a specific URL\n```\nTests latency, block number, client version. Detects out-of-sync nodes via block delta.\n\n### View/set default strategy\n```bash\ncrypto-cli.mjs rpc-strategy                   # View defaults + per-network overrides\ncrypto-cli.mjs rpc-strategy parallel           # Set global default to parallel\n```\n\n## Address Info Command\n\n### Aggregate address information\n```bash\ncrypto-cli.mjs address-info <address>              # Full address info\ncrypto-cli.mjs address-info vitalik.eth            # ENS name supported\ncrypto-cli.mjs address-info <address> --chain base # On another chain\ncrypto-cli.mjs address-info <address> --private    # Privacy RPCs only\n```\n\nReturns in a single call:\n- **type**: `EOA` or `contract` (with `codeSize` if contract)\n- **balance**: native balance (ETH/MATIC/BNB, etc.)\n- **txCount**: total transaction count (nonce)\n- **ensName**: primary ENS name via reverse lookup (Ethereum mainnet only)\n- **label**: metadata label if the address is a known entity (name, tags, description, website)\n- **explorerLink**: direct link to the OpenScan explorer\n\nThis command fires `balance`, `code`, and `nonce` in parallel, then enriches the result with ENS reverse resolution and metadata label lookup.\n\n## Price Commands\n\n### On-chain token price (100% on-chain, no CoinGecko)\n```bash\ncrypto-cli.mjs price                    # ETH price (default)\ncrypto-cli.mjs price BTC                # BTC price (via WBTC pools on mainnet)\ncrypto-cli.mjs price --chain polygon    # MATIC price\ncrypto-cli.mjs price --chain bnb        # BNB price\ncrypto-cli.mjs price --chain arbitrum   # ETH price (fetched from mainnet for L2s)\n```\nFetches prices from Uniswap V2-style DEX pools. Uses median of multiple pools for manipulation resistance. Returns per-pool breakdown.\n\n### Decode transaction (function call + events)\n```bash\ncrypto-cli.mjs decode-tx <0xhash>                  # Decode function + events\ncrypto-cli.mjs decode-tx <0xhash> --chain arbitrum  # On another chain\n```\nDecodes 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 contract_creation.\n\n**Strategies:**\n- `fallback` — Try RPCs in order, move to next on failure. Default. Most conservative.\n- `race` — Fire all RPCs simultaneously, use fastest response. Best for latency.\n- `parallel` — Fire all, compare results, detect inconsistencies. Trustless verification.\n\n## EVM Query Commands\n\nAll EVM commands accept `--chain <chain>` (default: ethereum) and `--private` (use tracking:none RPCs only).\n\n### Check balance\n```bash\ncrypto-cli.mjs balance <address>                           # Native balance (ETH)\ncrypto-cli.mjs balance vitalik.eth                          # ENS name supported\ncrypto-cli.mjs balance <address> --token USDC              # + ERC20 balance\ncrypto-cli.mjs balance <address> --chain arbitrum           # On Arbitrum\ncrypto-cli.mjs balance <address> --token USDC --chain base  # USDC on Base\n```\nReturns native balance in human-readable format (e.g., \"32.12 ETH\") plus raw wei. Token balance includes symbol, decimals, and formatted amount.\n\n### Multi-chain balance\n```bash\ncrypto-cli.mjs multi-balance <address>                     # All mainnet chains\ncrypto-cli.mjs multi-balance vitalik.eth                    # ENS supported\ncrypto-cli.mjs multi-balance <address> --private           # Privacy RPCs only\n```\nQueries the same address across ALL mainnet EVM chains in parallel. Shows balances sorted by chains with funds first.\n\n### Get block info\n```bash\ncrypto-cli.mjs block                    # Latest block\ncrypto-cli.mjs block latest             # Same\ncrypto-cli.mjs block 19000000           # By number\ncrypto-cli.mjs block 0xabcdef...        # By hash (66 chars)\n```\nReturns: number, hash, timestamp, gasUsed, gasLimit, baseFee, txCount, miner.\n\n### Transaction details\n```bash\ncrypto-cli.mjs tx <0xhash>\ncrypto-cli.mjs tx <0xhash> --chain arbitrum\n```\nReturns: hash, blockNumber, from, to, value (in ETH), gasPrice, nonce, input data.\n\n### Transaction receipt\n```bash\ncrypto-cli.mjs receipt <0xhash>\n```\nReturns: status (success/reverted), gasUsed, effectiveGasPrice, contract address (if deploy), logs with decoded event names from metadata.\n\n### Gas prices\n```bash\ncrypto-cli.mjs gas                      # Ethereum gas\ncrypto-cli.mjs gas --chain base         # Base gas\ncrypto-cli.mjs gas --chain arbitrum     # Arbitrum gas\n```\nReturns: gasPrice, maxPriorityFeePerGas, baseFee — all in gwei.\n\n### Read contract (eth_call)\n```bash\ncrypto-cli.mjs call <to_address> <calldata_hex> [--block <tag>]\n```\nFor raw contract reads. Use for custom ABI calls.\n\n### Event logs\n```bash\ncrypto-cli.mjs logs --address <contract> --topic <topic_hash> [--from <block>] [--to <block>]\n```\nReturns up to 50 logs. Default range: latest block only.\n\n### Check if address is contract\n```bash\ncrypto-cli.mjs code <address>\n```\nReturns: isContract (bool), codeSize, truncated bytecode.\n\n### Transaction count (nonce)\n```bash\ncrypto-cli.mjs nonce <address>\n```\n\n## Bitcoin Commands\n\nBitcoin queries use the mempool.space REST API (no JSON-RPC needed).\n\n### Blockchain overview\n```bash\ncrypto-cli.mjs btc-info\n```\nReturns: block height, best hash, difficulty, mempool stats, recommended fees — all in one call.\n\n### Block details\n```bash\ncrypto-cli.mjs btc-block                # Latest block\ncrypto-cli.mjs btc-block 800000         # By height\ncrypto-cli.mjs btc-block 0000000...     # By hash (64 chars)\n```\n\n### Transaction details\n```bash\ncrypto-cli.mjs btc-tx <txid>\n```\nReturns: confirmation status, fee (sats + BTC), fee rate (sat/vB), inputs/outputs with addresses and values.\n\n### Mempool state\n```bash\ncrypto-cli.mjs btc-mempool\n```\nReturns: tx count, vsize, total fees, recommended fee rates, 5 most recent txs.\n\n### Fee estimates\n```bash\ncrypto-cli.mjs btc-fee\n```\nReturns: fastest, halfHour, hour, economy, minimum — all in sat/vB.\n\n### Address balance\n```bash\ncrypto-cli.mjs btc-address <address>\n```\nReturns: balance (BTC + sats), total received/sent, tx count, UTXO count.\n\n## Chain Aliases\n\n| Alias | Chain ID | Network |\n|-------|----------|---------|\n| ethereum, eth, mainnet | 1 | Ethereum |\n| optimism, op | 10 | Optimism |\n| bnb, bsc | 56 | BNB Smart Chain |\n| polygon, matic, pol | 137 | Polygon |\n| base | 8453 | Base |\n| arbitrum, arb | 42161 | Arbitrum One |\n| sepolia | 11155111 | Sepolia Testnet |\n| bitcoin, btc | bip122:... | Bitcoin Mainnet |\n\nNumeric chain IDs also work (e.g., `1`, `42161`).\n\n## Output\n\nAll commands output JSON to stdout. The agent can parse and format as needed.\n\nNumeric values are pre-formatted:\n- Balances: human-readable (e.g., \"32.12 ETH\") + raw wei\n- Gas: in gwei\n- Timestamps: ISO 8601\n- Hex numbers: converted to decimal strings\n\n### Explorer Links\n\nEVM commands that return on-chain entities include an `explorerLink` field with a direct URL to [openscan.eth.link](https://openscan.eth.link):\n\n| Command | explorerLink points to |\n|---------|------------------------|\n| `balance` | address page |\n| `multi-balance` | address page per chain |\n| `block` | block page |\n| `tx` | transaction page |\n| `receipt` | transaction page |\n| `code` | address page |\n| `nonce` | address page |\n| `token` | token contract address page |\n| `logs` | transaction page per log |\n| `btc-block` | Bitcoin block page |\n| `btc-tx` | Bitcoin transaction page |\n| `btc-address` | Bitcoin address page |\n| `address-info` | address page |\n\nURL patterns:\n- EVM: `https://openscan.eth.link/#/{chainId}/{type}/{id}`\n- Bitcoin mainnet: `https://openscan.eth.link/#/btc/{type}/{id}`\n- Bitcoin testnet4: `https://openscan.eth.link/#/tbtc/{type}/{id}`\n\nAlways show this link to the user so they can explore the data further in the UI.\n\n## Caching\n\nMetadata cached in `~/.cache/openscan-crypto/` (6h TTL). RPC responses are NOT cached.\n\n## ENS Support\n\nAll EVM address commands accept `.eth` names (e.g., `vitalik.eth`). ENS is resolved on Ethereum mainnet automatically. Works with: `balance`, `multi-balance`, `code`, `nonce`.\n\n## Security\n\n- **READ-ONLY** — no transaction signing, no private key handling\n- **Public RPCs** — no API keys needed\n- `--private` flag restricts to tracking:none RPCs\n- Dangerous methods (sendTransaction, etc.) are NOT exposed\n\n## Natural Language Mapping\n\n| User says | Command |\n|-----------|---------|\n| \"What's Vitalik's ETH balance?\" | `balance 0xd8dA...96045` |\n| \"How much USDC does 0x... have on Base?\" | `balance 0x... --token USDC --chain base` |\n| \"Show the latest Ethereum block\" | `block latest` |\n| \"What's gas like on Arbitrum?\" | `gas --chain arbitrum` |\n| \"Look up this transaction\" | `tx 0x...` |\n| \"Did this tx succeed?\" | `receipt 0x...` |\n| \"Is 0x... a contract?\" | `code 0x...` |\n| \"What networks does OpenScan support?\" | `networks` |\n| \"What's the USDC contract address?\" | `token USDC` |\n| \"Show privacy-friendly Polygon RPCs\" | `rpcs polygon --private` |\n| \"Show vitalik.eth balance on all chains\" | `multi-balance vitalik.eth` |\n| \"What's the latest Bitcoin block?\" | `btc-info` or `btc-block` |\n| \"Tell me everything about this address\" | `address-info 0x...` |\n| \"Is 0x... a wallet or a contract?\" | `address-info 0x...` |\n| \"What's the ENS name for 0x...?\" | `address-info 0x...` (reverse ENS) |\n| \"Show me info for vitalik.eth\" | `address-info vitalik.eth` |\n| \"How full is the Bitcoin mempool?\" | `btc-mempool` |\n| \"What are Bitcoin fees right now?\" | `btc-fee` |\n| \"Look up this Bitcoin transaction\" | `btc-tx <txid>` |\n| \"Check Satoshi's balance\" | `btc-address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa` |\n| \"Show Bitcoin block 800000\" | `btc-block 800000` |\n","topics":["Crypto"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":690,"installsAllTime":26,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772204509591,"updatedAt":1778491660149},"latestVersion":{"version":"1.0.0","createdAt":1772204509591,"changelog":"Full EVM + Bitcoin + ENS + price + decode-tx + address-info + RPC management","license":null},"metadata":null,"owner":{"handle":"josealoha666","userId":"s17b67v0fzvaa0698b3jwks49s885xay","displayName":"Jose Aloha","image":"https://avatars.githubusercontent.com/u/259579913?v=4"},"moderation":null}