Blocks

Submit a block.

Submit a block. The node takes care of missing* fields and tries to build the block. On success, the block will be stored in the Tangle. This endpoint will return the identifier of the built block. *The node will try to auto-fill the following fields in case they are missing: parents, nonce. If payload is missing, the block will be built without a payload. protocolVersion is always required!

POSThttps://iota.nownodes.io/api/core/v2/blocks

Body

application/jsonapplication/vnd.iota.serializer-v1

protocolVersion*integer

Protocol version number of the block. It also tells which protocol rules apply to the block.

parentsarray of string

The identifiers of the blocks this block references. Hex-encoded with 0x prefix.

payloadone of

TransactionPayload (object)MilestonePayload (object)TaggedDataPayload (object)TreasuryTransactionPayload (object)ReceiptPayload (object)

noncestring

The nonce which lets this block fulfill the Proof-of-Work requirement. Hex-encoded with 0x prefix.

Response

201400403500503

Successful operation.

Headers

Body

application/json

blockId*string

The block identifier of the submitted block. Hex-encoded with 0x prefix.

Request

JavaScriptCurlPython

const response = await fetch('https://iota.nownodes.io/api/core/v2/blocks', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "protocolVersion": 2,
      "parents": [
        "0x222e88a63e5aca8ef48d3b8749e2fab51d1bc7c34c5604a2933ca2f180b342c9",
        "0xa22137ebe61435c6d0f3e16ad148376778d7bfb36e27329f02c221ec109525a6",
        "0xa6db9d0b3ecb274d90c21e9dde04012b2d13ad8aa0b90e82e7d3b626be67119d",
        "0xfd31d9c926b5d97ae016535d66baee511dfa3b713b61d8eba2ae5c9929e38ca7"
      ],
      "payload": {
        "type": 5,
        "tag": "0x68656c6c6f20776f726c64",
        "data": "0x5370616d6d696e6720646174612e0a436f756e743a203037323935320a54696d657374616d703a20323032312d30322d31315431303a32333a34392b30313a30300a54697073656c656374696f6e3a203934c2b573"
      },
      "nonce": "2102864"
    }),
});
const data = await response.json();

Response

201400403500503

{
  "blockId": "text"
}

Returns block data as JSON by its identifier.

Find a block by its identifier. This endpoint returns the given block as JSON.

GEThttps://iota.nownodes.io/api/core/v2/blocks/{blockId}

Path parameters

blockId*string

Identifier of the block.

Example: "0xf532a53545103276b46876c473846d98648ee418468bce76df4868648dd73e5d"

Response

200400403404500

Successful operation.

Body

application/jsonapplication/vnd.iota.serializer-v1

allOfBlock (object)

A block is the object nodes gossip around in the network. It always references two other blocks that are known as parents. It is stored as a vertex on the tangle data structure that the nodes maintain. A block can have a maximum size of 32Kb.

Request

JavaScriptCurlPython

const response = await fetch('https://iota.nownodes.io/api/core/v2/blocks/{blockId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400403404500

{
  "allOf": {
    "protocolVersion": 0,
    "parents": [
      "text"
    ],
    "payload": {
      "type": 0,
      "essence": {
        "type": 0,
        "networkId": "text",
        "inputsCommitment": "text",
        "inputs": [
          {
            "type": 0,
            "transactionId": "text",
            "transactionOutputIndex": 0
          }
        ],
        "outputs": [
          {
            "type": 0,
            "amount": "text",
            "nativeTokens": [
              {
                "id": "text",
                "amount": "text"
              }
            ],
            "unlockConditions": [
              {
                "type": 0,
                "address": {
                  "type": 0,
                  "pubKeyHash": "text"
                }
              }
            ],
            "features": [
              {
                "type": 0,
                "address": {
                  "type": 0,
                  "pubKeyHash": "text"
                }
              }
            ]
          }
        ],
        "payload": {
          "type": 0,
          "tag": "text",
          "data": "text"
        }
      },
      "unlocks": [
        {
          "type": 0,
          "signature": {
            "type": 0,
            "publicKey": "text",
            "signature": "text"
          }
        }
      ]
    },
    "nonce": "text"
  }
}