Return information that is used to attach a block in the network.

GET 
http://127.0.0.1:14265/api/core/v3/blocks/issuance

Return information that is used to attach a block in the network, which includes parents, last finalized slot index and the latest commitment the node created.

Responses

200

Successful operation.

application/json

Schema

Schema

strongParents string[]

The block identifiers that can be used to a attach a block to. Hex-encoded with 0x prefix.

weakParents string[]

The block identifiers that can be used to a attach a block to. Hex-encoded with 0x prefix.

shallowLikeParents string[]

The block identifiers that can be used to a attach a block to. Hex-encoded with 0x prefix.

latestParentBlockIssuingTime string

The latest issuing time of the returned parents.

latestFinalizedSlot integer

The latest finalized slot index.

latestCommitment Commitment

An object embedded to a block, containing a summary of a slot.

protocolVersion integerrequired

The version of the protocol running.

slot integerrequired

The slot index of the commitment.

previousCommitmentId stringrequired

The commitment identifier of the previous slot.

rootsId stringrequired

The digest of multiple merkle roots within this slot.

cumulativeWeight stringrequired

The sum of previous slot commitment cumulative weight and weight of issuers of accepted blocks within index minus Maximum Committable Age. It indicates the weight of the chain at index minus Maximum Committable Age committed at index slot.

referenceManaCost stringrequired

This field provides the Reference Mana Cost (RMC) to be used in the slot with index Index + Max Committable Age.

Example (from schema)

{
  "strongParents": [
    "string"
  ],
  "weakParents": [
    "string"
  ],
  "shallowLikeParents": [
    "string"
  ],
  "latestParentBlockIssuingTime": "string",
  "latestFinalizedSlot": 0,
  "latestCommitment": {
    "protocolVersion": 0,
    "slot": 0,
    "previousCommitmentId": "string",
    "rootsId": "string",
    "cumulativeWeight": "string",
    "referenceManaCost": "string"
  }
}

default

{
  "strongParents": [
    "0x0482f0eba39a23c9a13072c93d828b55543132c47f5f57514d9e55535e9d4f4f35000000",
    "0xae7c4f55a6db8bf4841e4a38f06d32ab9bd88b927a6ba0bc19bcb19c625ff8b63c000000"
  ],
  "weakParents": [
    "0x2e65c319e9a2c4a6ff7195f9a1ed896c43d0dded1b906979316d502b158965c23d000000",
    "0x67e57f7446b5a6f152afabb17c6077c26512278a275310a7ff2fa513f4e0b7383d000000"
  ],
  "shallowLikeParents": [
    "0xe5fe5231630afaaba609af76787ff1ec9c6088dd17e9cf922152b3facd7bd5883e000000",
    "0xed4b771b5413f5118dd80021ca07fb727e4c54eec9d28d6566c28cc81e7d267c3f000000"
  ],
  "latestParentBlockIssuingTime": "1690879505000000000",
  "latestFinalizedSlot": 1422,
  "latestCommitment": {
    "protocolVersion": 3,
    "slot": 1432,
    "previousCommitmentId": "0xc0300d55fe2cdc93191e52685da009f53d40883ae111291e550eed4e7eb7752746010000",
    "rootsId": "0x6a8f424929e1f08d87a204efc8a60499b789465aaa28178b77debe75cc2915d3",
    "cumulativeWeight": "45678",
    "referenceManaCost": "12345"
  }
}

403

Unsuccessful operation: indicates that the endpoint is not available for public use.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 403,
    "message": "not available for public use"
  }
}

500

Unsuccessful operation: indicates that an unexpected, internal server error happened which prevented the node from fulfilling the request.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 500,
    "message": "internal server error"
  }
}

503

Unsuccessful operation: indicates that there are no tips available or the node isn´t synced.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 503,
    "message": "service unavailable"
  }
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X GET 'http://127.0.0.1:14265/api/core/v3/blocks/issuance' \
-H 'Accept: application/json'

Request Collapse all

Base URL

http://127.0.0.1:14265

ResponseClear

Click the Send API Request button above and see the response here!