Module relays_openapi::apis::builder_api

Enums

• GetValidatorsError
  struct for typed errors of method get_validators
• SubmitBlockError
  struct for typed errors of method submit_block

Functions

• get_validators
  Used by builders to know when to submit bids for an upcoming proposal. * Returns an array of validator registrations for the current and next epoch. * Each entry includes a slot and the validator with assigned duty.Slots without a registered validator are omitted.
• submit_block
  Blocks can be submitted as JSON or SSZ, and optionally GZIP encoded. To be clear, there are four options: JSON, JSON+GZIP, SSZ, SSZ+GZIP. If JSON, the content type should be application/json. If SSZ, the content type should be application/octet-stream. * The relay will simulate the block to verify properties and proposer payment in the payment transaction from builder to proposer fee_recipient at the end of block. * For accountability, builder signature is over the SSZ encoded message. * The message, which does not include the transactions, will be made public via the data API, allowing anyone to verify the builder signature. * Any new submission by a builder will overwrite a previous one by the same builder_pubkey, even if it is less profitable.