Skip to main content

GetBlockByHeight

GetBlockByHeight queries block for given height.

Path Parameters
    height int64 required
Responses

A successful response.


Schema
    block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    block object
    header object

    Header defines the structure of a block header.

    version object

    Consensus captures the consensus rules for processing a block in the blockchain, including all blockchain data structures and the rules of the application's state transition machine.

    block uint64
    app uint64
    chain_id string
    height int64
    time date-time
    last_block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    last_commit_hash byte
    data_hash byte
    validators_hash byte
    next_validators_hash byte
    consensus_hash byte
    app_hash byte
    last_results_hash byte
    evidence_hash byte
    proposer_address byte
    data object
    txs byte[]

    Txs that will be applied by state @ block.Height+1. NOTE: not all txs here are valid. We're just agreeing on the order first. This means that block.AppHash does not include these txs.

    evidence object
    evidence object[]
  • Array [
  • duplicate_vote_evidence object

    DuplicateVoteEvidence contains evidence of a validator signed two conflicting votes.

    vote_a object

    Vote represents a prevote, precommit, or commit vote from validators for consensus.

    type string

    Possible values: [SIGNED_MSG_TYPE_UNKNOWN, SIGNED_MSG_TYPE_PREVOTE, SIGNED_MSG_TYPE_PRECOMMIT, SIGNED_MSG_TYPE_PROPOSAL]

    Default value: SIGNED_MSG_TYPE_UNKNOWN

    SignedMsgType is a type of signed message in the consensus.

    • SIGNED_MSG_TYPE_PREVOTE: Votes
    • SIGNED_MSG_TYPE_PROPOSAL: Proposals
    height int64
    round int32
    block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    timestamp date-time
    validator_address byte
    validator_index int32
    signature byte
    vote_b object

    Vote represents a prevote, precommit, or commit vote from validators for consensus.

    type string

    Possible values: [SIGNED_MSG_TYPE_UNKNOWN, SIGNED_MSG_TYPE_PREVOTE, SIGNED_MSG_TYPE_PRECOMMIT, SIGNED_MSG_TYPE_PROPOSAL]

    Default value: SIGNED_MSG_TYPE_UNKNOWN

    SignedMsgType is a type of signed message in the consensus.

    • SIGNED_MSG_TYPE_PREVOTE: Votes
    • SIGNED_MSG_TYPE_PROPOSAL: Proposals
    height int64
    round int32
    block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    timestamp date-time
    validator_address byte
    validator_index int32
    signature byte
    total_voting_power int64
    validator_power int64
    timestamp date-time
    light_client_attack_evidence object

    LightClientAttackEvidence contains evidence of a set of validators attempting to mislead a light client.

    conflicting_block object
    signed_header object
    header object

    Header defines the structure of a block header.

    version object

    Consensus captures the consensus rules for processing a block in the blockchain, including all blockchain data structures and the rules of the application's state transition machine.

    block uint64
    app uint64
    chain_id string
    height int64
    time date-time
    last_block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    last_commit_hash byte
    data_hash byte
    validators_hash byte
    next_validators_hash byte
    consensus_hash byte
    app_hash byte
    last_results_hash byte
    evidence_hash byte
    proposer_address byte
    commit object

    Commit contains the evidence that a block was committed by a set of validators.

    height int64
    round int32
    block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    signatures object[]
  • Array [
  • block_id_flag BlockIdFlag indicates which BlcokID the signature is for

    Possible values: [BLOCK_ID_FLAG_UNKNOWN, BLOCK_ID_FLAG_ABSENT, BLOCK_ID_FLAG_COMMIT, BLOCK_ID_FLAG_NIL]

    Default value: BLOCK_ID_FLAG_UNKNOWN

    validator_address byte
    timestamp date-time
    signature byte
  • ]
  • validator_set object
    validators object[]
  • Array [
  • address byte
    pub_key object
    ed25519 byte
    secp256k1 byte
    voting_power int64
    proposer_priority int64
  • ]
  • proposer object
    address byte
    pub_key object
    ed25519 byte
    secp256k1 byte
    voting_power int64
    proposer_priority int64
    total_voting_power int64
    common_height int64
    byzantine_validators object[]
  • Array [
  • address byte
    pub_key object
    ed25519 byte
    secp256k1 byte
    voting_power int64
    proposer_priority int64
  • ]
  • total_voting_power int64
    timestamp date-time
  • ]
  • last_commit object

    Commit contains the evidence that a block was committed by a set of validators.

    height int64
    round int32
    block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    signatures object[]
  • Array [
  • block_id_flag BlockIdFlag indicates which BlcokID the signature is for

    Possible values: [BLOCK_ID_FLAG_UNKNOWN, BLOCK_ID_FLAG_ABSENT, BLOCK_ID_FLAG_COMMIT, BLOCK_ID_FLAG_NIL]

    Default value: BLOCK_ID_FLAG_UNKNOWN

    validator_address byte
    timestamp date-time
    signature byte
  • ]
  • sdk_block object

    Block is tendermint type Block, with the Header proposer address field converted to hex string.

    header object

    Header defines the structure of a Tendermint block header.

    version object

    Consensus captures the consensus rules for processing a block in the blockchain, including all blockchain data structures and the rules of the application's state transition machine.

    block uint64
    app uint64
    chain_id string
    height int64
    time date-time
    last_block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    last_commit_hash byte
    data_hash byte
    validators_hash byte
    next_validators_hash byte
    consensus_hash byte
    app_hash byte
    last_results_hash byte
    evidence_hash byte
    proposer_address string

    proposer_address is the original block proposer address, formatted as a hex string. In Tendermint, this type is bytes, but in the SDK, we convert it to a hex string for better UX.

    data object
    txs byte[]

    Txs that will be applied by state @ block.Height+1. NOTE: not all txs here are valid. We're just agreeing on the order first. This means that block.AppHash does not include these txs.

    evidence object
    evidence object[]
  • Array [
  • duplicate_vote_evidence object

    DuplicateVoteEvidence contains evidence of a validator signed two conflicting votes.

    vote_a object

    Vote represents a prevote, precommit, or commit vote from validators for consensus.

    type string

    Possible values: [SIGNED_MSG_TYPE_UNKNOWN, SIGNED_MSG_TYPE_PREVOTE, SIGNED_MSG_TYPE_PRECOMMIT, SIGNED_MSG_TYPE_PROPOSAL]

    Default value: SIGNED_MSG_TYPE_UNKNOWN

    SignedMsgType is a type of signed message in the consensus.

    • SIGNED_MSG_TYPE_PREVOTE: Votes
    • SIGNED_MSG_TYPE_PROPOSAL: Proposals
    height int64
    round int32
    block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    timestamp date-time
    validator_address byte
    validator_index int32
    signature byte
    vote_b object

    Vote represents a prevote, precommit, or commit vote from validators for consensus.

    type string

    Possible values: [SIGNED_MSG_TYPE_UNKNOWN, SIGNED_MSG_TYPE_PREVOTE, SIGNED_MSG_TYPE_PRECOMMIT, SIGNED_MSG_TYPE_PROPOSAL]

    Default value: SIGNED_MSG_TYPE_UNKNOWN

    SignedMsgType is a type of signed message in the consensus.

    • SIGNED_MSG_TYPE_PREVOTE: Votes
    • SIGNED_MSG_TYPE_PROPOSAL: Proposals
    height int64
    round int32
    block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    timestamp date-time
    validator_address byte
    validator_index int32
    signature byte
    total_voting_power int64
    validator_power int64
    timestamp date-time
    light_client_attack_evidence object

    LightClientAttackEvidence contains evidence of a set of validators attempting to mislead a light client.

    conflicting_block object
    signed_header object
    header object

    Header defines the structure of a block header.

    version object

    Consensus captures the consensus rules for processing a block in the blockchain, including all blockchain data structures and the rules of the application's state transition machine.

    block uint64
    app uint64
    chain_id string
    height int64
    time date-time
    last_block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    last_commit_hash byte
    data_hash byte
    validators_hash byte
    next_validators_hash byte
    consensus_hash byte
    app_hash byte
    last_results_hash byte
    evidence_hash byte
    proposer_address byte
    commit object

    Commit contains the evidence that a block was committed by a set of validators.

    height int64
    round int32
    block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    signatures object[]
  • Array [
  • block_id_flag BlockIdFlag indicates which BlcokID the signature is for

    Possible values: [BLOCK_ID_FLAG_UNKNOWN, BLOCK_ID_FLAG_ABSENT, BLOCK_ID_FLAG_COMMIT, BLOCK_ID_FLAG_NIL]

    Default value: BLOCK_ID_FLAG_UNKNOWN

    validator_address byte
    timestamp date-time
    signature byte
  • ]
  • validator_set object
    validators object[]
  • Array [
  • address byte
    pub_key object
    ed25519 byte
    secp256k1 byte
    voting_power int64
    proposer_priority int64
  • ]
  • proposer object
    address byte
    pub_key object
    ed25519 byte
    secp256k1 byte
    voting_power int64
    proposer_priority int64
    total_voting_power int64
    common_height int64
    byzantine_validators object[]
  • Array [
  • address byte
    pub_key object
    ed25519 byte
    secp256k1 byte
    voting_power int64
    proposer_priority int64
  • ]
  • total_voting_power int64
    timestamp date-time
  • ]
  • last_commit object

    Commit contains the evidence that a block was committed by a set of validators.

    height int64
    round int32
    block_id object
    hash byte
    part_set_header object
    total int64
    hash byte
    signatures object[]
  • Array [
  • block_id_flag BlockIdFlag indicates which BlcokID the signature is for

    Possible values: [BLOCK_ID_FLAG_UNKNOWN, BLOCK_ID_FLAG_ABSENT, BLOCK_ID_FLAG_COMMIT, BLOCK_ID_FLAG_NIL]

    Default value: BLOCK_ID_FLAG_UNKNOWN

    validator_address byte
    timestamp date-time
    signature byte
  • ]
Loading...