Arweave gateway

provider

create("arweave")

auth

none

chains

Arweave

capabilities

balance, history, tx detail, block

endpoint

arweave.net

default chain

arweave

Address it

const arweave = await create("arweave"); // or new Arweave({ baseUrl: "https://ar-io.dev" })
await arweave.getBalance("FPjbN_btYKzcf8QASjs30v5C0FPv7XpwKXENBW8dqVw", "arweave");

baseUrl is the gateway root for both APIs and defaults to https://arweave.net. Every request stays on that gateway; there is no fallback to another node.

What it reads

/wallet/:address/balance and /block/height/:n over REST, transaction history and details through the gateway's GraphQL index.

Gotchas

• History merges owner and recipient queries, drops the duplicate rows a transfer to yourself produces, honours sort, inclusive startBlock and endBlock, limit from 1 to 100 and page from 1, and caps each read at page * limit <= 1000. Use block bounds for older history. Index coverage depends on the gateway, particularly for bundled data items.
• Winstons, twelve decimals. A data item's fee is omitted because its parent bundle pays the network fee; bundle membership, data metadata and tags stay in raw.
• An empty recipient stays "", a data upload, not contract creation. A missing block means pending, with block number 0 and no timestamp.
• Balance answers carry no height or hash, so both snapshot fields are null. There is no gas: block gas fields hold "0", and /price/{bytes} quotes a storage cost, not a price per gas unit, so getGasData stays unsupported.
• Addresses and transaction ids share a shape. The CLI needs -m detail for a transaction id, and the explorer's address page offers the transaction reading as a link.
• SmartWeave and AO execution status is not inferred from inclusion in a block.

Where it lives

src/providers/arweave.ts.