Mining

Validate a proposed Stacks block

Changed on

Used by stackers to validate a proposed Stacks block from a miner. This API endpoint requires a basic Authorization header.

post/v3/block_proposal

Request

  • Base URL
    http://localhost:20443
  • URL
    http://localhost:20443/v3/block_proposal
  • Auth
    API key in header authorization

Request body

blockstring required

Hex-encoded block data (must be valid SIP-003 serialized block, typically 200+ bytes)

chain_idinteger required

Chain ID for the block

Response

Block proposal has been accepted for processing. The result will be returned via the event observer.

BlockProposalResponse required(unresolved $ref)

Changes

  • 30468ca2533fRevision changes
    • breaking

      the request property's minLength was increased from 0 to 400

    • breaking

      added the pattern ^([0-9a-fA-F]{2})+$ to the request property

    • warning

      the request property's min was set to 0.00

  • f7f733b4a1fcRevision changes
    • info

      the request property's minLength was decreased from 400 to 0

    • info

      removed the pattern ^([0-9a-fA-F]{2})+$ from the request property