Sign in
latestOpenAPI 3.0.02026-08-138371125.7 KB

707a88e0b355

Fee Recipient

Fetch partial fee recipient registrations

Returns builder registration status for validators in a cluster. For each validator, returns at most two registrations: the latest one that reached quorum (quorum: true) and the latest one still collecting signatures (quorum: false). Validators with no registration data are omitted. Optionally pass an array of pubkeys in the request body to filter results.

post/v1/fee_recipient/{lockHash}

Path parameters

lockHashstring required
Example:0x1234abcd...

The cluster lock hash.

Request body

pubkeysstring[]

Optional list of validator pubkeys to filter by. If omitted or empty, returns all validators with registrations.

Example request

{
  "pubkeys": [
    "0xdeadbeef...",
    "0xcafebabe..."
  ]
}

Response

Per validator: at most 2 builder registrations (latest with quorum: true, latest with quorum: false). Each registration includes the signed message, partial signatures, and a quorum boolean. Pubkeys returned without 0x prefix.