Mining

Validate a proposed Stacks block

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 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

Changed in 16 of the 53 revisions of this API.19630

Jan 28, 202630468ca2533f21See the full diff
- ▲
  the block request property's minLength was increased from 0 to 400
  request-property-min-length-increased
- ▲
  added the pattern ^([0-9a-fA-F]{2})+$ to the request property block
  request-property-pattern-added
- ●
  the chain_id request property's min was set to 0.00
  request-property-min-set
Jan 14, 2026f7f733b4a1fc2See the full diff
- ○
  the block request property's minLength was decreased from 400 to 0
  request-property-min-length-decreased
- ○
  removed the pattern ^([0-9a-fA-F]{2})+$ from the request property block
  request-property-pattern-removed
Jan 14, 2026eb2153a4a3ad21See the full diff
- ▲
  the block request property's minLength was increased from 0 to 400
  request-property-min-length-increased
- ▲
  added the pattern ^([0-9a-fA-F]{2})+$ to the request property block
  request-property-pattern-added
- ●
  the chain_id request property's min was set to 0.00
  request-property-min-set
Jan 2, 202696224b968a3e2See the full diff
- ○
  the block request property's minLength was decreased from 400 to 0
  request-property-min-length-decreased
- ○
  removed the pattern ^([0-9a-fA-F]{2})+$ from the request property block
  request-property-pattern-removed
Dec 18, 202597e7080a813021See the full diff
- ▲
  the block request property's minLength was increased from 0 to 400
  request-property-min-length-increased
- ▲
  added the pattern ^([0-9a-fA-F]{2})+$ to the request property block
  request-property-pattern-added
- ●
  the chain_id request property's min was set to 0.00
  request-property-min-set
Dec 17, 2025db8094c96a6e2See the full diff
- ○
  the block request property's minLength was decreased from 400 to 0
  request-property-min-length-decreased
- ○
  removed the pattern ^([0-9a-fA-F]{2})+$ from the request property block
  request-property-pattern-removed
Dec 16, 202568660d89e56f21See the full diff
- ▲
  the block request property's minLength was increased from 0 to 400
  request-property-min-length-increased
- ▲
  added the pattern ^([0-9a-fA-F]{2})+$ to the request property block
  request-property-pattern-added
- ●
  the chain_id request property's min was set to 0.00
  request-property-min-set
Dec 15, 2025d7bba78bfcac2See the full diff
- ○
  the block request property's minLength was decreased from 400 to 0
  request-property-min-length-decreased
- ○
  removed the pattern ^([0-9a-fA-F]{2})+$ from the request property block
  request-property-pattern-removed
Dec 15, 2025c304e36f21221See the full diff
- ●
  changed the pattern of the request property block from ^[0-9a-fA-F]+$ to ^([0-9a-fA-F]{2})+$
  request-property-pattern-changed
Dec 11, 2025f29c78384efe21See the full diff
- ▲
  the block request property's minLength was increased from 1 to 400
  request-property-min-length-increased
- ▲
  added the pattern ^[0-9a-fA-F]+$ to the request property block
  request-property-pattern-added
- ●
  the chain_id request property's min was set to 0.00
  request-property-min-set

Full history (16 revisions)