Skip to main content

Terminology

Bundle

A set of Bundlr transactions joined into a single Arweave transaction.

Bundler

A bundler is a node on Bundlr that receives Bundlr transactions, handles payment channels and produces bundles.

Client

The client is a lightweight API layer that supports Bundlr transaction creation and allows applications to communicate with Bundlr via simple HTTP APIs.

Gateways

Gateways are nodes that listen to both bundlers and the Arweave L1 with the purpose of aggregating and indexing transactions. This allows you to retrieve and lookup Bundlr transactions from clusters of bundlers without maintaining your own index.

Transaction

A single item sent to a specific address, usually contains a data payload.

Transaction Receipt

A financial proof that a Bundlr transaction gets on to Arweave by an expected block. The transaction receipt format is.

FieldDescription
idTransaction id (used to download the data)
timestampTimestamp (UNIX milliseconds) of when the transaction was created
versionThe version of this JSON file, currently 1.0.0
publicPublic key of the bundler node used
signatureA signed deep hash of the JSON receipt
deadlineHeightThe block number by which the transaction must be finalized on Arweave
blockDeprecated
validatorSignaturesReserved for future use once we're decentralized
verifyAn async function called to verify the receipt is valid

Validator

A node on the network which aggregates transactions within a block period and validates that each item has reached the chain.