Transactions

Retrieve a transaction by ID

This endpoint allows you to retrieve a transaction identified by its ID. If the pending parameter is set to true, the response may include a pending transaction with a null meta field. Use this option when you want to retrieve pending transactions, providing flexibility in accessing real-time transaction data.

If no transaction is found, the response will be be a 200 with a null body.

get

/transactions/{id}

Path parameters

idstringrequired

The transaction ID

Example: 0xb6b5b47a5eee8b14e5222ac1bb957c0bbdc3d489850b033e3e544d9ca0cef934

Query parameters

rawboolean

Whether the response should include a raw transaction represented in hexadecimal format.

Example: false

headstring

Explicitly define the ID of the head block. Best block is assumed if omitted.

pendingboolean

Allows you to indicate whether the response should include transactions that are still pending

Example: false

Responses

application/json

text/plain

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://vet.nownodes.io/transactions/{id}'

200

400

{
  "id": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8",
  "chainTag": 1,
  "blockRef": "0x00000001511fc0be",
  "expiration": 30,
  "clauses": [],
  "gasPriceCoef": 128,
  "gas": 21000,
  "origin": "0x7567d83b7b8d80addcb281a71d54fc7b3364ffed",
  "delegator": null,
  "nonce": "0xd92966da424d9939",
  "dependsOn": null,
  "size": 180,
  "meta": {
    "blockID": "0x00000001c458949985a6d86b7139690b8811dd3b4647c02d4f41cdefb7d32327",
    "blockNumber": 1,
    "blockTimestamp": 1523156271
  }
}

Send a transaction

This endpoint allows you to send a transaction to the blockchain. The transaction must be signed and RLP encoded.

The below is a TypeScript example of how to sign and RLP encode a transaction using the thor-devkit library:

import { Transaction, secp256k1 } from 'thor-devkit'

const clauses = [{
    to: '0x7567d83b7b8d80addcb281a71d54fc7b3364ffed',
    value: 10000,
    data: '0x'
}]

let body: Transaction.Body = {
    chainTag: '0x4a',
    blockRef: '0x0000000000000000',
    expiration: 32,
    clauses: clauses,
    gasPriceCoef: 128,
    gas: Transaction.intrinsicGas(clauses),
    dependsOn: null,
    nonce: 12345678
}

const tx = new Transaction(body)
const signingHash = tx.signingHash()
tx.signature = secp256k1.sign(signingHash, Buffer.from("99f0500549792796c14fed62011a51081dc5b5e68fe8bd8a13b86be829c4fd36", "hex"))

const raw = tx.encode()
const decoded = Transaction.decode(raw)

axios.post('http://localhost:8669/transactions', {
  raw: '0x' + raw.toString('hex')
})

post

/transactions

Body

rawstring hex

The raw RLP encoded transaction.

Example:

0xf901854a880104c9cf34b0f5701ef8e7f8e594058d4c951aa24ca012cef3408b259ac1c69d1258890254beb02d1dcc0000b8c469ff936b00000000000000000000000000000000000000000000000000000000ee6c7f95000000000000000000000000167f6cc1e67a615b51b5a2deaba6b9feca7069df000000000000000000000000000000000000000000000000000000000000136a00000000000000000000000000000000000000000000000254beb02d1dcc00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080830469978084cb6b32c5c101b88272da83429a49a354f566dd8c85ba288a7c86d1d3161c0aad6a276a7c9f8e69c14df3d76f0d3442a4f4a2a13d016c32c45e82d5010f27386eeb384dee3d8390c0006adead8b8ce8823c583e1ac15facef8f1cc665a707ade82b3c956a53a2b24e0c03d80504bc4b276b5d067b72636d8e88d2ffc65528f868df2cadc716962978a000

Pattern: ^0x[0-9a-f]*$