ar.io Logoar.io Documentation

Transactions

Submit a new Arweave transaction or get existing transaction information

Post a transaction

Submits a signed L1 transaction (JSON), as an Arweave node's POST /tx does. Envoy sends it on to Arweave nodes: the peers it discovers by default, or TRUSTED_NODE_HOST and FALLBACK_NODE_HOST with ENABLE_ARWEAVE_PEER_EDS=false. With ARWEAVE_POST_DRY_RUN=true the gateway answers it itself: with ARWEAVE_POST_DRY_RUN_SKIP_VALIDATION=true it accepts anything, otherwise it checks the required fields and the signature, and it broadcasts nothing. Reaching the gateway directly (port 4000), it forwards to TRUSTED_NODE_URL itself. The gateway's own handler accepts bodies up to 10 MB.

POST
/tx

Empty Object

Response Body

curl -X POST "https://turbo-gateway.com/tx" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
Empty

Get pending transactions.

Get list of transactions that are currently pending.

GET
/tx/pending

Response Body

curl -X GET "https://turbo-gateway.com/tx/pending"
[
  "string"
]

Get information about a transaction.

Get detailed information about a specific transaction.

GET
/tx/{txId}

Path Parameters

txIdstring
Match^[0-9a-zA-Z_-]{43}$

Response Body

curl -X GET "https://turbo-gateway.com/tx/string"
{
  "format": 0,
  "id": "string",
  "last_tx": "string",
  "owner": "string",
  "tags": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "target": "string",
  "quantity": "string",
  "data": "string",
  "data_tree": [
    "string"
  ],
  "data_root": "string",
  "reward": "string",
  "signature": "string"
}

Get transaction offset information.

Get information about the size and offset of a specified transaction.

GET
/tx/{txId}/offset

Path Parameters

txIdstring
Match^[0-9a-zA-Z_-]{43}$

Response Body

curl -X GET "https://turbo-gateway.com/tx/string/offset"
{
  "size": "string",
  "offset": "string"
}

Get transaction status.

Get the status of a specified transaction.

GET
/tx/{txId}/status

Path Parameters

txIdstring
Match^[0-9a-zA-Z_-]{43}$

Response Body

curl -X GET "https://turbo-gateway.com/tx/string/status"
{
  "block_height": 0,
  "block_indep_hash": "string",
  "number_of_confirmations": 0
}

How is this guide?