[{"data":1,"prerenderedAt":793},["ShallowReactive",2],{"navigation_docs":3,"-guide-transactions":120,"-guide-transactions-surround":788},[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":24,"body":122,"description":780,"extension":781,"links":782,"meta":783,"navigation":785,"path":25,"seo":786,"stem":26,"__hash__":787},"docs\u002F1.guide\u002F05.transactions.md",{"type":123,"value":124,"toc":772},"minimark",[125,130,244,256,563,573,577,675,685,689,704,708,744,747,754,758,768],[126,127,129],"h2",{"id":128},"two-reads-one-shape","Two reads, one shape",[131,132,137],"pre",{"className":133,"code":134,"language":135,"meta":136,"style":136},"language-ts shiki shiki-themes github-light github-light poimandres","const history = await provider.getTxHistory(address, \"ethereum\", { limit: 10 });\nconst one = await provider.getTxDetail?.(hash, \"ethereum\");\n","ts","",[138,139,140,208],"code",{"__ignoreMap":136},[141,142,145,149,153,156,160,164,168,172,175,178,181,185,189,191,194,198,201,205],"span",{"class":143,"line":144},"line",1,[141,146,148],{"class":147},"s1TYA","const",[141,150,152],{"class":151},"saoiD"," history",[141,154,155],{"class":147}," =",[141,157,159],{"class":158},"sZW6a"," await",[141,161,163],{"class":162},"spVlQ"," provider",[141,165,167],{"class":166},"sKlNE",".",[141,169,171],{"class":170},"sULi6","getTxHistory",[141,173,174],{"class":166},"(",[141,176,177],{"class":162},"address",[141,179,180],{"class":166},", ",[141,182,184],{"class":183},"scVjq","\"",[141,186,188],{"class":187},"sQ7BG","ethereum",[141,190,184],{"class":183},[141,192,193],{"class":166},", {",[141,195,197],{"class":196},"snHMy"," limit",[141,199,200],{"class":166},":",[141,202,204],{"class":203},"siHFe"," 10",[141,206,207],{"class":166}," });\n",[141,209,211,213,216,218,220,222,224,227,230,233,235,237,239,241],{"class":143,"line":210},2,[141,212,148],{"class":147},[141,214,215],{"class":151}," one",[141,217,155],{"class":147},[141,219,159],{"class":158},[141,221,163],{"class":162},[141,223,167],{"class":166},[141,225,226],{"class":170},"getTxDetail",[141,228,229],{"class":166},"?.(",[141,231,232],{"class":162},"hash",[141,234,180],{"class":166},[141,236,184],{"class":183},[141,238,188],{"class":187},[141,240,184],{"class":183},[141,242,243],{"class":166},");\n",[245,246,247,249,250,252,253,200],"p",{},[138,248,171],{}," is required on every provider and pages through an address. ",[138,251,226],{}," is optional and reads one hash; TONAPI, Blockberry and Aptos do not have it. Both return ",[138,254,255],{},"Transaction",[131,257,259],{"className":133,"code":258,"language":135,"meta":136,"style":136},"interface Transaction {\n  hash: string;\n  blockNumber: number;\n  timestamp?: string; \u002F\u002F ISO\n  from: string;\n  to: string | null; \u002F\u002F null for contract creation\n  value: string; \u002F\u002F smallest native unit\n  valueFormatted: string;\n  gasUsed?: string;\n  gasPrice?: string;\n  fee?: string; \u002F\u002F smallest native unit\n  status: \"success\" | \"failed\" | \"pending\";\n  methodId?: string; \u002F\u002F first four bytes of the input\n  functionName?: string; \u002F\u002F when the explorer decoded it\n  isContractInteraction: boolean;\n  tokenTransfers: TokenTransfer[]; \u002F\u002F the fungible transfers inside this transaction\n  opReturn?: OpReturnPayload[]; \u002F\u002F Bitcoin family, from mempool\n  raw?: Record\u003Cstring, unknown>; \u002F\u002F the explorer's own answer\n}\n",[138,260,261,273,288,301,319,331,352,367,379,391,403,417,453,468,483,496,513,529,557],{"__ignoreMap":136},[141,262,263,266,270],{"class":143,"line":144},[141,264,265],{"class":147},"interface",[141,267,269],{"class":268},"sCrqT"," Transaction",[141,271,272],{"class":166}," {\n",[141,274,275,279,281,285],{"class":143,"line":210},[141,276,278],{"class":277},"s0VbO","  hash",[141,280,200],{"class":147},[141,282,284],{"class":283},"s8yaW"," string",[141,286,287],{"class":166},";\n",[141,289,291,294,296,299],{"class":143,"line":290},3,[141,292,293],{"class":277},"  blockNumber",[141,295,200],{"class":147},[141,297,298],{"class":283}," number",[141,300,287],{"class":166},[141,302,304,307,310,312,315],{"class":143,"line":303},4,[141,305,306],{"class":277},"  timestamp",[141,308,309],{"class":147},"?:",[141,311,284],{"class":283},[141,313,314],{"class":166},"; ",[141,316,318],{"class":317},"sjhu3","\u002F\u002F ISO\n",[141,320,322,325,327,329],{"class":143,"line":321},5,[141,323,324],{"class":277},"  from",[141,326,200],{"class":147},[141,328,284],{"class":283},[141,330,287],{"class":166},[141,332,334,337,339,341,344,347,349],{"class":143,"line":333},6,[141,335,336],{"class":277},"  to",[141,338,200],{"class":147},[141,340,284],{"class":283},[141,342,343],{"class":147}," |",[141,345,346],{"class":283}," null",[141,348,314],{"class":166},[141,350,351],{"class":317},"\u002F\u002F null for contract creation\n",[141,353,355,358,360,362,364],{"class":143,"line":354},7,[141,356,357],{"class":277},"  value",[141,359,200],{"class":147},[141,361,284],{"class":283},[141,363,314],{"class":166},[141,365,366],{"class":317},"\u002F\u002F smallest native unit\n",[141,368,370,373,375,377],{"class":143,"line":369},8,[141,371,372],{"class":277},"  valueFormatted",[141,374,200],{"class":147},[141,376,284],{"class":283},[141,378,287],{"class":166},[141,380,382,385,387,389],{"class":143,"line":381},9,[141,383,384],{"class":277},"  gasUsed",[141,386,309],{"class":147},[141,388,284],{"class":283},[141,390,287],{"class":166},[141,392,394,397,399,401],{"class":143,"line":393},10,[141,395,396],{"class":277},"  gasPrice",[141,398,309],{"class":147},[141,400,284],{"class":283},[141,402,287],{"class":166},[141,404,406,409,411,413,415],{"class":143,"line":405},11,[141,407,408],{"class":277},"  fee",[141,410,309],{"class":147},[141,412,284],{"class":283},[141,414,314],{"class":166},[141,416,366],{"class":317},[141,418,420,423,425,428,431,433,435,437,440,442,444,446,449,451],{"class":143,"line":419},12,[141,421,422],{"class":277},"  status",[141,424,200],{"class":147},[141,426,427],{"class":183}," \"",[141,429,430],{"class":187},"success",[141,432,184],{"class":183},[141,434,343],{"class":147},[141,436,427],{"class":183},[141,438,439],{"class":187},"failed",[141,441,184],{"class":183},[141,443,343],{"class":147},[141,445,427],{"class":183},[141,447,448],{"class":187},"pending",[141,450,184],{"class":183},[141,452,287],{"class":166},[141,454,456,459,461,463,465],{"class":143,"line":455},13,[141,457,458],{"class":277},"  methodId",[141,460,309],{"class":147},[141,462,284],{"class":283},[141,464,314],{"class":166},[141,466,467],{"class":317},"\u002F\u002F first four bytes of the input\n",[141,469,471,474,476,478,480],{"class":143,"line":470},14,[141,472,473],{"class":277},"  functionName",[141,475,309],{"class":147},[141,477,284],{"class":283},[141,479,314],{"class":166},[141,481,482],{"class":317},"\u002F\u002F when the explorer decoded it\n",[141,484,486,489,491,494],{"class":143,"line":485},15,[141,487,488],{"class":277},"  isContractInteraction",[141,490,200],{"class":147},[141,492,493],{"class":283}," boolean",[141,495,287],{"class":166},[141,497,499,502,504,507,510],{"class":143,"line":498},16,[141,500,501],{"class":277},"  tokenTransfers",[141,503,200],{"class":147},[141,505,506],{"class":268}," TokenTransfer",[141,508,509],{"class":166},"[]; ",[141,511,512],{"class":317},"\u002F\u002F the fungible transfers inside this transaction\n",[141,514,516,519,521,524,526],{"class":143,"line":515},17,[141,517,518],{"class":277},"  opReturn",[141,520,309],{"class":147},[141,522,523],{"class":268}," OpReturnPayload",[141,525,509],{"class":166},[141,527,528],{"class":317},"\u002F\u002F Bitcoin family, from mempool\n",[141,530,532,535,537,540,543,546,548,551,554],{"class":143,"line":531},18,[141,533,534],{"class":277},"  raw",[141,536,309],{"class":147},[141,538,539],{"class":268}," Record",[141,541,542],{"class":166},"\u003C",[141,544,545],{"class":283},"string",[141,547,180],{"class":166},[141,549,550],{"class":283},"unknown",[141,552,553],{"class":166},">; ",[141,555,556],{"class":317},"\u002F\u002F the explorer's own answer\n",[141,558,560],{"class":143,"line":559},19,[141,561,562],{"class":166},"}\n",[245,564,565,568,569,572],{},[138,566,567],{},"to"," is ",[138,570,571],{},"null"," for contract creation and nothing else. A missing recipient on Arweave is an empty string, because there it means a data upload, not a deployment.",[126,574,576],{"id":575},"options","Options",[131,578,580],{"className":133,"code":579,"language":135,"meta":136,"style":136},"interface TxHistoryOptions {\n  startBlock?: number; \u002F\u002F inclusive\n  endBlock?: number; \u002F\u002F inclusive\n  sort?: \"asc\" | \"desc\";\n  limit?: number; \u002F\u002F provider caps apply, 100 on most\n  page?: number; \u002F\u002F 1-indexed\n}\n",[138,581,582,591,605,618,643,657,671],{"__ignoreMap":136},[141,583,584,586,589],{"class":143,"line":144},[141,585,265],{"class":147},[141,587,588],{"class":268}," TxHistoryOptions",[141,590,272],{"class":166},[141,592,593,596,598,600,602],{"class":143,"line":210},[141,594,595],{"class":277},"  startBlock",[141,597,309],{"class":147},[141,599,298],{"class":283},[141,601,314],{"class":166},[141,603,604],{"class":317},"\u002F\u002F inclusive\n",[141,606,607,610,612,614,616],{"class":143,"line":290},[141,608,609],{"class":277},"  endBlock",[141,611,309],{"class":147},[141,613,298],{"class":283},[141,615,314],{"class":166},[141,617,604],{"class":317},[141,619,620,623,625,627,630,632,634,636,639,641],{"class":143,"line":303},[141,621,622],{"class":277},"  sort",[141,624,309],{"class":147},[141,626,427],{"class":183},[141,628,629],{"class":187},"asc",[141,631,184],{"class":183},[141,633,343],{"class":147},[141,635,427],{"class":183},[141,637,638],{"class":187},"desc",[141,640,184],{"class":183},[141,642,287],{"class":166},[141,644,645,648,650,652,654],{"class":143,"line":321},[141,646,647],{"class":277},"  limit",[141,649,309],{"class":147},[141,651,298],{"class":283},[141,653,314],{"class":166},[141,655,656],{"class":317},"\u002F\u002F provider caps apply, 100 on most\n",[141,658,659,662,664,666,668],{"class":143,"line":333},[141,660,661],{"class":277},"  page",[141,663,309],{"class":147},[141,665,298],{"class":283},[141,667,314],{"class":166},[141,669,670],{"class":317},"\u002F\u002F 1-indexed\n",[141,672,673],{"class":143,"line":354},[141,674,562],{"class":166},[245,676,677,680,681,684],{},[138,678,679],{},"clampMaxResults(limit, max)"," is what every provider runs the limit through: a missing or zero limit means the provider's maximum, anything else is rounded and kept between 1 and that maximum. Which options a provider honours is on its page; the Arweave gateway, for one, caps the window at ",[138,682,683],{},"page * limit \u003C= 1000"," and wants block bounds for older history.",[126,686,688],{"id":687},"op_return","OP_RETURN",[245,690,691,692,695,696,699,700,703],{},"Bitcoin, Litecoin and Pepecoin transactions from Mempool carry their OP_RETURN outputs in ",[138,693,694],{},"opReturn",". Each payload has the pushed bytes as lowercase ",[138,697,698],{},"hex",", and ",[138,701,702],{},"text"," only when those bytes are printable UTF-8. Runes, Omni and other binary carriers keep the hex and skip the text, so you never get mojibake handed to you as a message. The CLI prints the text when there is one and the hex otherwise.",[126,705,707],{"id":706},"token-transfers-inside","Token transfers inside",[245,709,710,713,714,180,717,180,720,180,723,180,726,180,729,180,732,734,735,738,739,743],{},[138,711,712],{},"tokenTransfers"," lists the fungible transfers the explorer attributed to this transaction, each with ",[138,715,716],{},"contract",[138,718,719],{},"symbol",[138,721,722],{},"decimals",[138,724,725],{},"value",[138,727,728],{},"valueFormatted",[138,730,731],{},"from",[138,733,567],{}," and the ",[138,736,737],{},"txHash",". Etherscan and Blockscout fill it on EVM chains, TONAPI fills it with Jetton transfers and omits the failed ones, Koios with Cardano native assets. An address that only ever received tokens from third parties has an empty native history and a full ",[740,741,742],"a",{"href":29},"transfer history",", which is why that read exists on its own.",[126,745,746],{"id":746},"raw",[245,748,749,750,753],{},"The explorer's own answer, untouched, on the transaction that produced it. Not part of the contract and different on every provider, but there for the day you need a field nobody normalized. The docs worker drops it before an answer leaves, so the ",[740,751,52],{"href":752},"\u002Fexplorer"," never shows it; a script gets it in full.",[126,755,757],{"id":756},"ambiguity","Ambiguity",[245,759,760,761,763,764,767],{},"A 64-hex string is a hash on Ethereum, on the Bitcoin family, TRON and Cardano. A base58 string of 64 to 88 characters is a hash on Solana, 43 or 44 on Sui. Arweave addresses and transaction ids share a shape, so ",[138,762,226],{}," there needs you to know what you hold; the CLI's ",[138,765,766],{},"-m detail"," is that statement.",[769,770,771],"style",{},"html pre.shiki code .s1TYA, html code.shiki .s1TYA{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#91B4D5}html pre.shiki code .saoiD, html code.shiki .saoiD{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#E4F0FB}html pre.shiki code .sZW6a, html code.shiki .sZW6a{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#5DE4C7C0}html pre.shiki code .spVlQ, html code.shiki .spVlQ{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E4F0FB}html pre.shiki code .sKlNE, html code.shiki .sKlNE{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#A6ACCD}html pre.shiki code .sULi6, html code.shiki .sULi6{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#E4F0FBD0}html pre.shiki code .scVjq, html code.shiki .scVjq{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#A6ACCD}html pre.shiki code .sQ7BG, html code.shiki .sQ7BG{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#5DE4C7}html pre.shiki code .snHMy, html code.shiki .snHMy{--shiki-light:#24292E;--shiki-default:#24292E;--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);}html pre.shiki code .sCrqT, html code.shiki .sCrqT{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#A6ACCDC0}html pre.shiki code .s0VbO, html code.shiki .s0VbO{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#A6ACCD}html pre.shiki code .s8yaW, html code.shiki .s8yaW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#A6ACCDC0}html pre.shiki code .sjhu3, html code.shiki .sjhu3{--shiki-light:#6A737D;--shiki-light-font-style:inherit;--shiki-default:#6A737D;--shiki-default-font-style:inherit;--shiki-dark:#767C9DB0;--shiki-dark-font-style:italic}",{"title":136,"searchDepth":210,"depth":210,"links":773},[774,775,776,777,778,779],{"id":128,"depth":210,"text":129},{"id":575,"depth":210,"text":576},{"id":687,"depth":210,"text":688},{"id":706,"depth":210,"text":707},{"id":746,"depth":210,"text":746},{"id":756,"depth":210,"text":757},"getTxHistory and getTxDetail, the Transaction shape, paging options, OP_RETURN payloads, and what raw is for.","md",null,{"icon":784},"i-solar-bill-list-linear",true,{"title":24,"description":780},"lJvmi5j-tRWuQjQYYUIXJ520xazmE1Dc5AX-_EFcYx8",[789,791],{"title":20,"path":21,"stem":22,"description":790,"children":-1},"getBalance on every chain, the Balance shape, ENS resolution, UTXO totals, and why blockNumber is sometimes null.",{"title":28,"path":29,"stem":30,"description":792,"children":-1},"getTokenBalances and getTokenTransfers, where they exist, the nonZeroOnly flag, and the transfers that never show up in native history.",1788626961518]