Skip to main content

get_block

Returns an object containing various details about a specific block on the blockchain.

Request Body
block_num_or_id string REQUIRED

Provide a block number or a block id

Responses
200

OK

Schema
timestamp DateTimeSeconds REQUIRED

Possible values: Value must match regular expression ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}.[0-9]{3}$

Date/time string in the format YYYY-MM-DDTHH:MM:SS.sss

producer REQUIRED
confirmed integer REQUIRED

number of prior blocks confirmed by this block producer in current schedule

previous Sha256 REQUIRED

Possible values: Value must match regular expression ^[0-9A-Fa-f]{64}$

transaction_mroot Sha256 REQUIRED

Possible values: Value must match regular expression ^[0-9A-Fa-f]{64}$

action_mroot Sha256 REQUIRED

Possible values: Value must match regular expression ^[0-9A-Fa-f]{64}$

schedule_version integer REQUIRED

number of times producer schedule has changed since genesis

new_producers object REQUIRED
version integer REQUIRED
producers object[] REQUIRED
producer_name Name REQUIRED

Possible values: Value must match regular expression ^[a-z]{1}[a-z1-5.]{1,10}[a-z1-5]{1}$

String representation of basic Inery name type, must be between 3 and 12 characters and contain only a-z and 1-5 and dot(.), but not at the end of the string.

block_signing_key PublicKey REQUIRED

Possible values: Value must match regular expression ^(INE|PUB_([RK]1|WA)_)[1-9A-HJ-NP-Za-km-z]+$

Base58 encoded Inery public key

header_extensions undefined[]
new_protocol_features object[]

list of new protocol features

producer_signature Signature REQUIRED

Possible values: Value must match regular expression ^SIG_([RK]1|WA)_[1-9A-HJ-NP-Za-km-z]+$

Base58 encoded Inery cryptographic signature

transactions object[]

list of valid transaction receipts included in block

status string REQUIRED

Possible values: [executed, soft_fail, hard_fail, delayed, expired]

status:

  • executed - Succeed, no error handler executed
  • soft_fail - Objectively failed (not executed), error handler executed
  • hard_fail - Objectively failed and error handler objectively failed thus no state change
  • delayed - Used by delayed-user transactions for timer-based executions
  • expired - Transaction expired and storage space refunded to user
cpu_usage_us integer REQUIRED
net_usage_words integer REQUIRED
trx TransactionVariant REQUIRED
block_extensions undefined[]
id Sha256

Possible values: Value must match regular expression ^[0-9A-Fa-f]{64}$

block_num integer

height of this block in the chain

ref_block_prefix integer

32-bit portion of block ID