Block

All block commands are below and detailed on related sections.

Get blocks

post

/getBlocks

This endpoint lists the blocks created on the PIRI network, based on the skip and limit parameters provided to it.

Body

skipnumberOptional

Page count for skip according to limit value.

Default: 0

limitnumber · max: 100Optional

Record count for per page

Default: 10

Responses

200

application/json; charset=utf-8

countinteger · int32Required

Total count of blocks

post/getBlocks

POST /getBlocks HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 21

"skip=0&limit=10"

200

{
  "data": [
    {
      "confirmed": true,
      "_id": "632c4c52dfdaed5ef81c03a9",
      "validators": [
        {
          "_id": "632c4c53dfdaed5ef81c03b0",
          "dateTime": "2022-09-22T11:51:47.123Z",
          "nodeName": "CELEBI",
          "nodeAddress": "PRTMQiQLHuZQvtzgp89yf6U7UjXu8eNDMddLztYGzq8",
          "result": 1
        }
      ],
      "producerAddress": "PRTMQYA88SNPwNjZVegDNE1PKi1ijxRLXWfZ6xMQSx6",
      "totalFee": 0,
      "blockHeight": 1,
      "previousHash": "0000000000000000000000000000000000000000000000000000000000000000",
      "hash": "ed74d06294ad76bf1420a433e5b2b06903785f42f7c55a4e77485cb389c41a7e",
      "checkSum": "daf417057bdafa89b25cea9d6d197c01e8b039565415c3b1fcecba0105f120ef",
      "timeStamp": 1663847506859,
      "__v": 3,
      "confirmCount": 3
    }
  ],
  "count": 3391000
}

Get blocks with transaction count

post

/getBlocksWithTransactionCount

This endpoint lists the blocks created in the PIRI network, similar to the getBlocks endpoint, but the resulting schema also includes the trxCount information for each block.

Body

skipnumberOptional

Page count for skip according to limit value.

Default: 0

limitnumber · max: 100Optional

Record count for per page

Default: 10

Responses

200

application/json; charset=utf-8

countinteger · int32Required

Total number of blocks in the network

post/getBlocksWithTransactionCount

POST /getBlocksWithTransactionCount HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 21

"skip=0&limit=10"

200

{
  "data": [
    {
      "confirmed": true,
      "_id": "632c4d24dfdaed5ef81c0624",
      "validators": [
        {
          "_id": "632c4d25dfdaed5ef81c062b",
          "dateTime": "2022-09-22T11:55:17.041Z",
          "nodeName": "BIRUNI",
          "nodeAddress": "PRTMRfynW6oXR1VuY8hsdpazd7nVR49X1NhGHyrnUxi",
          "result": 1
        }
      ],
      "producerAddress": "PRTMQYA88SNPwNjZVegDNE1PKi1ijxRLXWfZ6xMQSx6",
      "totalFee": 0,
      "blockHeight": 22,
      "previousHash": "318b11bca1bf894c09af91618264944d2e43aedb869813f7b5c05040459f8dcb",
      "hash": "c27b29e00c160637dc0fa3a5b101287cc8abd5b6a9a0e7e9ddaf0b72277879a7",
      "checkSum": "741ae211965a59dd39a5e6a0608201785c61bdc056091b2318d5a029d26d6ae0",
      "timeStamp": 1663847716864,
      "__v": 4,
      "confirmCount": 4,
      "trxCount": 0
    }
  ],
  "count": 3488380
}

Get last blocks with block height

post

/getLastBlocksWithBlockHeight

This endpoint uses the limit & blockHeight parameters instead of the skip & limit parameters to list blocks created on the PIRI network. The purpose here is to achieve faster results when page control is provided by the application.

Body

limitnumber · max: 100Optional

Record count for per page

Default: 10

blockHeightnumber · max: 100Optional

Block Height (Block Count) to start.

Default: 5

Responses

200

application/json; charset=utf-8

countinteger · int32Required

Total number of blocks in the network

post/getLastBlocksWithBlockHeight

POST /getLastBlocksWithBlockHeight HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 28

"limit=10&blockHeight=5"

200

{
  "data": [
    {
      "confirmed": false,
      "_id": "633cc4c0b3e6e20fe85c819d",
      "validators": [],
      "producerAddress": "PRTMQYA88SNPwNjZVegDNE1PKi1ijxRLXWfZ6xMQSx6",
      "totalFee": 0,
      "blockHeight": 10,
      "previousHash": "2b150fbeaba43792c113ebbba53ea2494d6dc80064ce362ad8d7f8b35b880aef",
      "hash": "a983aff0bc072dd13c8d553f041c630cfba71dc295584245ecaf95bce99f7672",
      "checkSum": "fd8efb84cbf46a93945b6dc3b2858fa10727c7b224c46871f0278ea323db18c2",
      "timeStamp": 1664926912761,
      "__v": 0
    }
  ],
  "count": 3346216
}

Get blocks in descending order

post

/getBlocksDesc

This endpoint lists the blocks created in the PIRI network in reverse order, based on the skip and limit parameters provided to it. In other words, this endpoint is more convenient for listing newly created blocks.

Body

skipnumberOptional

Page count for skip according to limit value.

Default: 0

limitnumber · max: 100Optional

Record count for per page

Default: 10

Responses

200

application/json; charset=utf-8

countinteger · int32Required

Total number of blocks in the network

post/getBlocksDesc

POST /getBlocksDesc HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 21

"skip=0&limit=10"

200

{
  "data": [
    {
      "confirmed": true,
      "_id": "632b15bc1ca0c3ae24ec3039",
      "validators": [
        {
          "_id": "632b15bd1ca0c3ae24ec3040",
          "dateTime": "2022-09-21T13:46:37.079Z",
          "nodeName": "HAREZMI\n",
          "nodeAddress": "PRTMQYb6BUsVZvXgxXCAucLU4LVxomtudsnJwxfbdF8",
          "result": 1
        }
      ],
      "producerAddress": "PRTMPCMvnDqqABUpmtEBvoPZzhjC8JrLxgAfkb94skM",
      "totalFee": 0,
      "blockHeight": 708569,
      "previousHash": "0b1164cf04f08058c483a2acd5cf57a4d47d732326ad2fe0bb9a636b17483ba0",
      "hash": "9da1ed079bf14e3c48c9db779ce3cd9b818086e838f0b4d8ed6756f8197c9b62",
      "checkSum": "e3265108f41b81f0c2bc5df9612ee1287579b2767d13315246c7243f6dfeff52",
      "timeStamp": 1663767996304,
      "__v": 5,
      "confirmCount": 5
    }
  ],
  "count": 708729
}

Get last blocks

post

/getLastBlocks

This endpoint lists the blocks created in the PIRI network based on the limit parameter provided to it. The value given to the limit parameter signifies listing the last x number of blocks.

Body

limitnumber · min: 5 · max: 100Optional

Record count (descending order)

Default: 10

Responses

200

application/json; charset=utf-8

countinteger · int32Required

Total number of blocks in the network

post/getLastBlocks

POST /getLastBlocks HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 12

"limit=10"

200

{
  "data": [
    {
      "confirmed": true,
      "_id": "637362168bf56c1f461f8dc6",
      "validators": [
        {
          "_id": "637362168bf56c1f461f8dcd",
          "dateTime": "2022-11-15T09:55:34.956Z",
          "nodeName": "BIRUNI",
          "nodeAddress": "PRTMRfynW6oXR1VuY8hsdpazd7nVR49X1NhGHyrnUxi",
          "result": 1
        }
      ],
      "producerAddress": "PRTMQYA88SNPwNjZVegDNE1PKi1ijxRLXWfZ6xMQSx6",
      "totalFee": 0,
      "blockHeight": 464319,
      "previousHash": "fe9c3e1c1bcc7356c34695704e7cbaf1a30e4dda65dd4c43661ade4faabf8353",
      "hash": "c51ac3ac1203c33a9f558fa7031ef649d1471f5b906d201adda7e8d37fea4142",
      "checkSum": "99f807203ad7b9c38515f629de0873848da77aada85ee92cd4b8cb5e6ba2c1ca",
      "timeStamp": 1668506134478,
      "__v": 4,
      "confirmCount": 4
    }
  ],
  "count": 464321
}

Get only blocks

post

/getOnlyBlocks

This endpoint lists the blocks created on the PIRI network, based on the skip and limit parameters provided. However, the returned result does not include validatorNodes and transaction information. This makes it suitable for quickly browsing the block list.

Body

skipnumberOptional

Page count for skip according to limit value.

Default: 0

limitnumber · max: 100Optional

Record count for per page

Default: 10

Responses

200

application/json; charset=utf-8

countinteger · int32Required

Total number of blocks in the network

post/getOnlyBlocks

POST /getOnlyBlocks HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 21

"skip=0&limit=10"

200

{
  "data": [
    {
      "confirmed": true,
      "_id": "653289c6b92ae195e9336027",
      "validators": [
        {
          "_id": "653289c8b92ae195e933607b",
          "dateTime": "2023-10-20T14:08:08.186Z",
          "nodeName": "FARABI\n",
          "nodeAddress": "PRTMQtUGEN59a3ahBj8W8CSMrRwGkZH8MqpTGZJTqAA",
          "result": 1
        }
      ],
      "producerAddress": "PRTMQYA88SNPwNjZVegDNE1PKi1ijxRLXWfZ6xMQSx6",
      "totalFee": 0,
      "blockHeight": 3391019,
      "previousHash": "31ef240341d11064760343000b44f5beab855c1023e4bebe374b86a22b482b70",
      "hash": "db5165b0e855fde109ade034edfd5e24ebdeb11c7ea08d642cd8294ed7b7a617",
      "checkSum": "57fea802d41fbf02f2209b1a916205d35f3046c883bc222fda5375e4da7365bb",
      "timeStamp": 1697810886177,
      "__v": 11,
      "confirmCount": 11
    }
  ],
  "count": 3391020
}

Get block

post

/getBlock

This endpoint returns the most detailed information related to a block created on the PIRI network. The returned object may include validator nodes, transactions, and custom data information.

Body

blockNumbernumberRequired

Block Number

Responses

200

application/json; charset=utf-8

confirmedbooleanRequired

Block confirmation status

_idstringRequired

Block ID

producerAddressstringRequired

Block producer address

totalFeenumberRequired

Total transaction fees

blockHeightinteger · int32Required

Block height

previousHashstringRequired

Previous block hash

hashstringRequired

Block hash

checkSumstringRequired

Block checksum

timeStampinteger · int64Required

Block timestamp

__vinteger · int32Required

Version key

confirmCountinteger · int32Required

Confirmation count

lastBlockinteger · int32Required

Last block height

post/getBlock

POST /getBlock HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 17

"blockNumber=1"

200

{
  "confirmed": true,
  "_id": "6328fcd1f79196bb9585a731",
  "validators": [
    {
      "_id": "6328fcd2f79196bb9585a742",
      "dateTime": "2022-09-19T23:35:46.337Z",
      "nodeName": "CELEBI",
      "nodeAddress": "PRTMQiQLHuZQvtzgp89yf6U7UjXu8eNDMddLztYGzq8",
      "result": 1
    }
  ],
  "producerAddress": "PRTMPCMvnDqqABUpmtEBvoPZzhjC8JrLxgAfkb94skM",
  "totalFee": 0.187,
  "blockHeight": 694837,
  "previousHash": "ee6763d4570f8cfb870b6a0132315594dea5d5d39203a2f91642c97662d9e9b1",
  "hash": "8003d78f5d2b9edc1804a20c860370742cd285eb8d1796e864be3d8f0536538a",
  "checkSum": "9587b3987bbbd649d4f2b06b20f4b0a1a21c5295ea5ff7001d923765e7db69b3",
  "timeStamp": 1663630545430,
  "__v": 4,
  "confirmCount": 4,
  "lastBlock": 708769,
  "trxs": [
    {
      "type": -1,
      "confirmed": true,
      "confirmationCount": 4,
      "_id": "6328fcd1d12279f0098f883a",
      "transactionHash": "0785f48b3c881951cf784c194a264bd31fb94919c978e9f4cec7f2499541f3e2",
      "__v": 4,
      "amount": 0,
      "assetID": -1,
      "blockHeight": 694837,
      "fee": 0.187,
      "from": "PRTMPUAV2mTGq6Dpu9ZBYmJyXWdt9RYiiouvRaZ8xUR",
      "pub": "0413e62afdf947f3d6035ab6afce222e7e5bab394549d6c10b74118578971a264b",
      "signature": "3045022100e4516f2b10bd1858cac3e0f8f56ed26eb7ed23698361e36ae1120ddb82f1f5a3",
      "symbol": "PIRI",
      "timeStamp": 1663630509881,
      "validatorNodes": [
        {
          "_id": "6328fcaef79196bb95859947",
          "nodeName": "BIRUNI",
          "message": "Success",
          "dateTime": "2022-09-19T23:35:10.028Z",
          "result": 1
        }
      ],
      "customDocs": [
        {
          "_id": "6328fcadf79196bb9585992c",
          "txID": "0785f48b3c881951cf784c194a264bd31fb94919c978e9f4cec7f2499541f3e2",
          "key": "courseGrade",
          "value": "98",
          "timeStamp": 1663630509881,
          "from": "PRTMPUAV2mTGq6Dpu9ZBYmJyXWdt9RYiiouvRaZ8xUR",
          "enc": 0,
          "__v": 0,
          "blockHeight": 694837
        }
      ]
    }
  ]
}

PreviousTransaction NextData

Last updated 11 months ago