Repository navigation
Tracking issue for Beacon-APIs #9045
Description
This issue is to track the beacon HTTP APIs and the event streams that are added or removed. Any update in the ethereum/beacon-APIs repository will be updated here as well, so that the beacon-APIs related updates can be concentrated in one issue, and it is easier to track what is lacking/waiting to be implemented in Lighthouse.
This is a tracking issue, thus not assigning anyone to work on it. Sometimes a developer will implement the endpoint while working on Gloas (e.g., #9038), after the PR is merged, it will be updated here too.
Added
Beacon
| Endpoint | beacon-APIs PR | Lighthouse PR | Status |
|---|---|---|---|
POST /eth/v1/beacon/execution_payload_bid |
beacon-APIs#552 | #9347 | Done |
POST /eth/v1/beacon/pool/payload_attestations |
beacon-APIs#552 | #9178 | Done |
GET /eth/v1/beacon/pool/payload_attestations |
beacon-APIs#552 | #10038 | Pending review |
GET /eth/v1/beacon/execution_payload_envelope/{block_id} |
beacon-APIs#552 | #9038 | Done |
GET /eth/v1/validator/execution_payload_envelopes/{block_id} |
— | Implemented | Done |
POST /eth/v1/beacon/execution_payload_envelopes |
— | Implemented | Done |
POST /eth/v1/beacon/states/{state_id}/builders |
— | Implemented | Done |
SSZ response for POST /eth/v1/beacon/states/{state_id}/validator_balances |
beacon-APIs#622 | #10082 | Pending review |
Add execution_payload_value to ProduceBlockV4 |
— | Implemented | Done |
Use ProgressiveList for the SSZ response to GET /eth/v1/beacon/pool/payload_attestations |
beacon-APIs#635 | #10038 | Pending review |
Add GET /eth/v1/beacon/states/{state_id}/builder_pending_withdrawals |
beacon-APIs#655 | #10285 | Done |
Add GET /eth/v1/beacon/states/{state_id}/builder_pending_payments |
beacon-APIs#655 | #10285 | Done |
Add GET /eth/v1/beacon/proposer_preferences |
beacon-APIs#659 | #10268 | Done |
Add GET /eth/v1/beacon/states/{state_id}/ptc |
ethereum/beacon-APIs#657 | #10256 | Done |
Debug
| Endpoint | beacon-APIs PR | Lighthouse PR | Status |
|---|---|---|---|
Add GET /eth/v2/debug/fork_choice |
ethereum/beacon-APIs#615 | #10215 | Pending review |
Events
| Endpoint | beacon-APIs PR | Lighthouse PR | Status |
|---|---|---|---|
Add execution_payload_available event |
beacon-APIs#552 | #9199 | Done |
Add execution_payload_bid event |
beacon-APIs#552 | Implemented | Done |
Add payload_attestation_message event |
beacon-APIs#552 | Implemented | Done |
Remove kzg_commitments and versioned_hashes from the data_column_sidecar event |
beacon-APIs#583 | Implemented | Done |
Add execution_payload event |
beacon-APIs#588 | Implemented | Done |
Add execution_payload_gossip event |
beacon-APIs#588 | Implemented | Done |
Add head_v2 event |
beacon-APIs#590 | Implemented | Done |
Add fast_confirmation event |
— | Implemented | Done |
Remove parent_block_number from the payload_attributes event |
beacon-APIs#621 | Pending Gloas mainnet fork | lighthouse/common/eth2/src/types.rs Lines 1244 to 1246 in 6e1be33 |
Modify payload_attributes event to add safe_block_hash and finalized_block_hash |
beacon-APIs#638 | #10244 | Done |
Add builder_index and block_hash to block event |
ethereum/beacon-APIs#641 | #10333 | Done |
Validator
| Endpoint | beacon-APIs PR | Lighthouse PR | Status |
|---|---|---|---|
POST /eth/v1/validator/duties/ptc/{epoch} |
beacon-APIs#552 | Implemented | Done |
GET /eth/v1/validator/payload_attestation_data/{slot} |
beacon-APIs#552 | #8497 | Done |
GET /eth/v4/validator/blocks/{slot} |
— | Implemented | Done |
Change GET /eth/v1/validator/payload_attestation_data/{slot} to use a query parameter instead of a path parameter |
beacon-APIs#626 | #9959 | Done |
Return 204 when GET /eth/v1/validator/payload_attestation_data/{slot} has no block |
beacon-APIs#612 | #9959 | Done |
/eth/v1/validator/execution_payload_bid/{slot}/{builder_index} |
beacon-APIs#643 | Not required any more | - |
POST /eth/v4/validator/blocks/{slot} |
— | #9806 | Done |
POST /eth/v1/validator/builder_preferences |
— | #9806 | Done |
Node
| Endpoint | beacon-APIs PR | Lighthouse PR | Status |
|---|---|---|---|
GET /eth/v2/node/version |
beacon-APIs#568 | #9171 | Pending review |
Removed
- GET
/eth/v1/beacon/blob_sidecars/{block_id}ethereum/beacon-APIs#577 - blob_sidecar EVENT ethereum/beacon-APIs#577
Activity
chong-he commentedon Apr 22, 2026
I will wok on adding GET
/eth/v2/node/versionAdd `head_v2` event in beacon API and remove some fields in `data_col…
Apply Beacon API amendments to payload attestation data endpoint (#9959)
Add `safe_block_hash` and `finalized_block_hash` to Payload Attribute…
Implement `builder_pending_withdrawals` and `builder_pending_payments…
Implement `GET beacon/proposer_preferences` endpoint (#10268)