Blocks

Fetch a sequence of Nakamoto blocks in a tenure

Changed on

Fetch a sequence of Nakamoto blocks in a tenure. The blocks will be served in order from highest to lowest. The blocks will be encoded in their SIP-003 wire format, and concatenated together.

get/v3/tenures/{block_id}

Request

  • Base URL
    http://localhost:20443
  • URL
    http://localhost:20443/v3/tenures/{block_id}
  • Auth
    none required

Path parameters

block_idstring required
Example:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

The tenure-start block ID of the tenure to query (64-character hex string)

Query parameters

stopstring

The block ID hash of the highest block in this tenure that is already known to the caller. Neither the corresponding block nor any of its ancestors will be served. This is used to fetch tenure blocks that the caller does not have.

Response

SIP-003-encoded Nakamoto blocks, concatenated together

Changes

  • 30468ca2533fRevision changes
    • breaking

      for the path request parameter block_id, the minLength was increased from 0 to 64

    • breaking

      for the query request parameter stop, the minLength was increased from 0 to 64

    • breaking

      added the pattern ^[0-9a-f]{64}$ to the path request parameter block_id

    • breaking

      added the pattern ^[0-9a-f]{64}$ to the query request parameter stop

    • warning

      for the path request parameter block_id, the maxLength was set to 64

    • warning

      for the query request parameter stop, the maxLength was set to 64

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • f7f733b4a1fcRevision changes
    • info

      for the path request parameter block_id, the minLength was decreased from 64 to 0

    • info

      for the query request parameter stop, the minLength was decreased from 64 to 0

    • info

      removed the pattern ^[0-9a-f]{64}$ from the path request parameter block_id

    • info

      removed the pattern ^[0-9a-f]{64}$ from the query request parameter stop

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status