[{"data":1,"prerenderedAt":615},["ShallowReactive",2],{"navigation_docs":3,"-guide-cli":120,"-guide-cli-surround":610},[4,56,116],{"title":5,"path":6,"stem":7,"children":8,"icon":55},"Guide","\u002Fguide","1.guide\u002F01.index",[9,11,15,19,23,27,31,35,39,43,47,51],{"title":10,"path":6,"stem":7},"Getting Started",{"title":12,"path":13,"stem":14},"CLI","\u002Fguide\u002Fcli","1.guide\u002F02.cli",{"title":16,"path":17,"stem":18},"Provider selection","\u002Fguide\u002Fselection","1.guide\u002F03.selection",{"title":20,"path":21,"stem":22},"Balances","\u002Fguide\u002Fbalances","1.guide\u002F04.balances",{"title":24,"path":25,"stem":26},"Transactions","\u002Fguide\u002Ftransactions","1.guide\u002F05.transactions",{"title":28,"path":29,"stem":30},"Tokens","\u002Fguide\u002Ftokens","1.guide\u002F06.tokens",{"title":32,"path":33,"stem":34},"Contracts","\u002Fguide\u002Fcontracts","1.guide\u002F07.contracts",{"title":36,"path":37,"stem":38},"Gas and blocks","\u002Fguide\u002Fgas-and-blocks","1.guide\u002F08.gas-and-blocks",{"title":40,"path":41,"stem":42},"Errors","\u002Fguide\u002Ferrors","1.guide\u002F09.errors",{"title":44,"path":45,"stem":46},"Agents","\u002Fguide\u002Fagents","1.guide\u002F10.agents",{"title":48,"path":49,"stem":50},"Custom providers","\u002Fguide\u002Fcustom","1.guide\u002F11.custom",{"title":52,"path":53,"stem":54},"Explorer","\u002Fguide\u002Fexplorer","1.guide\u002F12.explorer","i-solar-book-2-linear",{"title":57,"path":58,"stem":59,"children":60,"icon":115},"Providers","\u002Fproviders","2.providers\u002F0.index",[61,63,67,71,75,79,83,87,91,95,99,103,107,111],{"title":62,"path":58,"stem":59},"Overview",{"title":64,"path":65,"stem":66},"Etherscan","\u002Fproviders\u002Fetherscan","2.providers\u002F01.etherscan",{"title":68,"path":69,"stem":70},"Blockscout","\u002Fproviders\u002Fblockscout","2.providers\u002F02.blockscout",{"title":72,"path":73,"stem":74},"Blockchair","\u002Fproviders\u002Fblockchair","2.providers\u002F03.blockchair",{"title":76,"path":77,"stem":78},"Mempool","\u002Fproviders\u002Fmempool","2.providers\u002F04.mempool",{"title":80,"path":81,"stem":82},"Blockstream","\u002Fproviders\u002Fblockstream","2.providers\u002F05.blockstream",{"title":84,"path":85,"stem":86},"Solscan","\u002Fproviders\u002Fsolscan","2.providers\u002F06.solscan",{"title":88,"path":89,"stem":90},"Helius","\u002Fproviders\u002Fhelius","2.providers\u002F07.helius",{"title":92,"path":93,"stem":94},"TONAPI","\u002Fproviders\u002Fton","2.providers\u002F08.ton",{"title":96,"path":97,"stem":98},"TRONSCAN","\u002Fproviders\u002Ftronscan","2.providers\u002F09.tronscan",{"title":100,"path":101,"stem":102},"Aptos Explorer","\u002Fproviders\u002Faptos","2.providers\u002F10.aptos",{"title":104,"path":105,"stem":106},"Blockberry","\u002Fproviders\u002Fblockberry","2.providers\u002F11.blockberry",{"title":108,"path":109,"stem":110},"Koios","\u002Fproviders\u002Fkoios","2.providers\u002F12.koios",{"title":112,"path":113,"stem":114},"Arweave gateway","\u002Fproviders\u002Farweave","2.providers\u002F13.arweave","i-solar-library-linear",{"title":117,"path":118,"stem":119},"Chains","\u002Fchains","3.chains",{"id":121,"title":12,"body":122,"description":602,"extension":603,"links":604,"meta":605,"navigation":607,"path":13,"seo":608,"stem":14,"__hash__":609},"docs\u002F1.guide\u002F02.cli.md",{"type":123,"value":124,"toc":593},"minimark",[125,130,187,207,211,368,372,472,479,484,530,541,545,575,579,589],[126,127,129],"h2",{"id":128},"the-short-path","The short path",[131,132,137],"pre",{"className":133,"code":134,"language":135,"meta":136,"style":136},"language-bash shiki shiki-themes github-light github-light poimandres","npx @agntn\u002Fexplorers vitalik.eth\nnpx @agntn\u002Fexplorers tx vitalik.eth -n 5\nnpx @agntn\u002Fexplorers providers\n","bash","",[138,139,140,156,177],"code",{"__ignoreMap":136},[141,142,145,149,153],"span",{"class":143,"line":144},"line",1,[141,146,148],{"class":147},"sseY5","npx",[141,150,152],{"class":151},"sX7Zv"," @agntn\u002Fexplorers",[141,154,155],{"class":151}," vitalik.eth\n",[141,157,159,161,163,166,169,173],{"class":143,"line":158},2,[141,160,148],{"class":147},[141,162,152],{"class":151},[141,164,165],{"class":151}," tx",[141,167,168],{"class":151}," vitalik.eth",[141,170,172],{"class":171},"sqT1Y"," -n",[141,174,176],{"class":175},"siHFe"," 5\n",[141,178,180,182,184],{"class":143,"line":179},3,[141,181,148],{"class":147},[141,183,152],{"class":151},[141,185,186],{"class":151}," providers\n",[188,189,190,191,194,195,198,199,202,203,206],"p",{},"A first argument that looks like an address defaults to ",[138,192,193],{},"balance",". When both provider and chain are omitted, balance reads start on Ethereum; an explicit ",[138,196,197],{},"--provider"," keeps that provider's default chain, so ",[138,200,201],{},"explorers balance 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa -p mempool"," reads Bitcoin without a ",[138,204,205],{},"-c",".",[126,208,210],{"id":209},"commands","Commands",[212,213,214,230],"table",{},[215,216,217],"thead",{},[218,219,220,224,227],"tr",{},[221,222,223],"th",{},"Command",[221,225,226],{},"What it does",[221,228,229],{},"Example",[231,232,233,248,263,278,293,308,323,338,353],"tbody",{},[218,234,235,240,243],{},[236,237,238],"td",{},[138,239,193],{},[236,241,242],{},"Native token balance, including ENS",[236,244,245],{},[138,246,247],{},"explorers balance vitalik.eth",[218,249,250,255,258],{},[236,251,252],{},[138,253,254],{},"tx",[236,256,257],{},"Transaction history or one transaction",[236,259,260],{},[138,261,262],{},"explorers tx vitalik.eth -n 5",[218,264,265,270,273],{},[236,266,267],{},[138,268,269],{},"contract",[236,271,272],{},"ABI, source and verification status",[236,274,275],{},[138,276,277],{},"explorers contract 0x1f984...",[218,279,280,285,288],{},[236,281,282],{},[138,283,284],{},"tokens",[236,286,287],{},"ERC-20, SPL and Cardano native holdings",[236,289,290],{},[138,291,292],{},"explorers tokens vitalik.eth",[218,294,295,300,303],{},[236,296,297],{},[138,298,299],{},"transfers",[236,301,302],{},"ERC-20 transfer history for an address",[236,304,305],{},[138,306,307],{},"explorers transfers vitalik.eth",[218,309,310,315,318],{},[236,311,312],{},[138,313,314],{},"gas",[236,316,317],{},"Current gas prices",[236,319,320],{},[138,321,322],{},"explorers gas -c base",[218,324,325,330,333],{},[236,326,327],{},[138,328,329],{},"block",[236,331,332],{},"Block data by number",[236,334,335],{},[138,336,337],{},"explorers block 18000000",[218,339,340,345,348],{},[236,341,342],{},[138,343,344],{},"providers",[236,346,347],{},"Registered providers and their capabilities",[236,349,350],{},[138,351,352],{},"explorers providers",[218,354,355,360,363],{},[236,356,357],{},[138,358,359],{},"mcp",[236,361,362],{},"The MCP server over stdio",[236,364,365],{},[138,366,367],{},"explorers mcp",[126,369,371],{"id":370},"options","Options",[212,373,374,384],{},[215,375,376],{},[218,377,378,381],{},[221,379,380],{},"Option",[221,382,383],{},"Meaning",[231,385,386,410,429,439,459],{},[218,387,388,393],{},[236,389,390],{},[138,391,392],{},"-c, --chain",[236,394,395,396,399,400,399,403,406,407],{},"Chain name or alias, for example ",[138,397,398],{},"eth",", ",[138,401,402],{},"mainnet",[138,404,405],{},"btc"," or ",[138,408,409],{},"arbitrum",[218,411,412,417],{},[236,413,414],{},[138,415,416],{},"-p, --provider",[236,418,419,420,399,423,406,426],{},"Explorer backend, for example ",[138,421,422],{},"etherscan",[138,424,425],{},"blockscout",[138,427,428],{},"mempool",[218,430,431,436],{},[236,432,433],{},[138,434,435],{},"-n, --limit",[236,437,438],{},"Maximum number of transactions",[218,440,441,446],{},[236,442,443],{},[138,444,445],{},"-m, --mode",[236,447,448,449,451,452,406,455,458],{},"Force ",[138,450,254],{}," into ",[138,453,454],{},"history",[138,456,457],{},"detail"," mode when the input is ambiguous",[218,460,461,466],{},[236,462,463],{},[138,464,465],{},"-t, --token",[236,467,468,469,471],{},"Limit ",[138,470,299],{}," to one token contract",[126,473,475,476,478],{"id":474},"when-tx-cannot-tell","When ",[138,477,254],{}," cannot tell",[188,480,481,483],{},[138,482,254],{}," classifies its argument: a 64-hex string is a hash on Ethereum, a hash on Bitcoin, TRON and Cardano too, and a base58 string of the right length is a hash on Solana and Sui. Everything else is treated as an address. Arweave breaks that rule, because a transaction id and a wallet address have the same shape there, so say what you mean:",[131,485,487],{"className":133,"code":486,"language":135,"meta":136,"style":136},"explorers tx FPjbN_btYKzcf8QASjs30v5C0FPv7XpwKXENBW8dqVw -c arweave -n 3\nexplorers tx 2Bg8S0GcQmbC-FeT5dDKcj0WOK2YmH7Y4mlW-mO8_yE -p arweave -m detail\n",[138,488,489,510],{"__ignoreMap":136},[141,490,491,494,496,499,502,505,507],{"class":143,"line":144},[141,492,493],{"class":147},"explorers",[141,495,165],{"class":151},[141,497,498],{"class":151}," FPjbN_btYKzcf8QASjs30v5C0FPv7XpwKXENBW8dqVw",[141,500,501],{"class":171}," -c",[141,503,504],{"class":151}," arweave",[141,506,172],{"class":171},[141,508,509],{"class":175}," 3\n",[141,511,512,514,516,519,522,524,527],{"class":143,"line":158},[141,513,493],{"class":147},[141,515,165],{"class":151},[141,517,518],{"class":151}," 2Bg8S0GcQmbC-FeT5dDKcj0WOK2YmH7Y4mlW-mO8_yE",[141,520,521],{"class":171}," -p",[141,523,504],{"class":151},[141,525,526],{"class":171}," -m",[141,528,529],{"class":151}," detail\n",[188,531,532,535,536,406,538,540],{},[138,533,534],{},"--mode"," accepts ",[138,537,454],{},[138,539,457],{}," and nothing else. A typo is an error, not a guess.",[126,542,544],{"id":543},"keys","Keys",[188,546,547,548,399,551,399,554,399,557,399,560,563,564,567,568,571,572,574],{},"Keys come from the environment and only from there. ",[138,549,550],{},"ETHERSCAN_API_KEY",[138,552,553],{},"SOLSCAN_API_KEY",[138,555,556],{},"HELIUS_API_KEY",[138,558,559],{},"TRONSCAN_API_KEY",[138,561,562],{},"BLOCKBERRY_API_KEY",", and ",[138,565,566],{},"BLOCKCHAIR_API_KEY"," for a higher Blockchair tier. Set one and the matching provider moves to the front of the queue for every chain it serves; the ranking is in ",[569,570,16],"a",{"href":17},". ",[138,573,352],{}," prints which ones are active on this machine.",[126,576,578],{"id":577},"exit-codes","Exit codes",[188,580,581,582,585,586,588],{},"A failed read prints the error and exits 1. An invalid ",[138,583,584],{},"--limit",", a ",[138,587,534],{}," outside the two values, or a provider that cannot serve the operation all fail the same way, before any request goes out.",[590,591,592],"style",{},"html pre.shiki code .sseY5, html code.shiki .sseY5{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#91B4D5}html pre.shiki code .sX7Zv, html code.shiki .sX7Zv{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#ADD7FF}html pre.shiki code .sqT1Y, html code.shiki .sqT1Y{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#ADD7FF}html pre.shiki code .siHFe, html code.shiki .siHFe{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#5DE4C7}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":136,"searchDepth":158,"depth":158,"links":594},[595,596,597,598,600,601],{"id":128,"depth":158,"text":129},{"id":209,"depth":158,"text":210},{"id":370,"depth":158,"text":371},{"id":474,"depth":158,"text":599},"When tx cannot tell",{"id":543,"depth":158,"text":544},{"id":577,"depth":158,"text":578},"One binary, eight reads and an MCP server. An address as the first argument means balance, no ceremony.","md",null,{"icon":606},"i-solar-code-square-linear",true,{"title":12,"description":602},"I91yUec-1PdVuYBTF-eUbF-4jdJvJBPtbjDZD-Vgor8",[611,613],{"title":10,"path":6,"stem":7,"description":612,"children":-1},"Install the package, read one balance, and get the same shape back from Etherscan, Blockscout, Mempool, Koios or an Arweave gateway.",{"title":16,"path":17,"stem":18,"description":614,"children":-1},"How resolveProvider ranks candidates, when withProvider retries, and why an explicit provider is never second guessed.",1788626962638]