Description

This issue tracks the implementation of the standard Eth2 API at https://github.com/ethereum/eth2.0-APIs.

Note: this issue is assuming that #1569 has already been merged into master.

Overall status

The standard is mostly implemented in #1569, however there are still some endpoints missing. Most notably, SSE endpoints have not been implemented.

Per-Endpoint

This section documents the progress of each API endpoint. An endpoint should only be marked as complete if it is 100% complete, with nothing else to do.

Beacon

• /eth/v1/beacon/genesis
• /eth/v1/beacon/states/{state_id}/root
• /eth/v1/beacon/states/{state_id}/fork
• /eth/v1/beacon/states/{state_id}/finality_checkpoints
• /eth/v1/beacon/states/{state_id}/validators
  • Implemented, but returning non-standard status field.
  • Here is my not-yet-submitted proposal to change the field: https://hackmd.io/bQxMDRt1RbS1TLno8K4NPg
• /eth/v1/beacon/states/{state_id}/validators/{validator_id}
  • As above.
• /eth/v1/beacon/states/{state_id}/validator_balances
• /eth/v1/beacon/states/{state_id}/committees/{epoch}
• /eth/v1/beacon/headers
  • Only returns canonical blocks
• /eth/v1/beacon/headers/{block_id}
• /eth/v1/beacon/blocks
• /eth/v1/beacon/blocks/{block_id}
• /eth/v1/beacon/blocks/{block_id}/root
• /eth/v1/beacon/blocks/{block_id}/attestations
• /eth/v1/beacon/pool/attestations
• /eth/v1/beacon/pool/attester_slashings
• /eth/v1/beacon/pool/proposer_slashings
• /eth/v1/beacon/pool/voluntary_exits

Debug

• /eth/v1/debug/beacon/states/{state_id}
• /eth/v1/debug/beacon/heads

Node

• /eth/v1/node/identity
  • Partially implemented, missing fields.
  • [Merged by Bors] - Shift metadata to the global network variables #1631 adds one of the required fields.
• /eth/v1/node/peers
• /eth/v1/node/peers/{peer_id}
• /eth/v1/node/version
• /eth/v1/node/syncing
• /eth/v1/node/health

Config

• /eth/v1/config/fork_schedule
• /eth/v1/config/spec
• /eth/v1/config/deposit_contract

Validator

• /eth/v1/validator/duties/attester/{epoch}
• /eth/v1/validator/duties/proposer/{epoch}
  • Only returns duties for the current epoch to make caching easier. It would be nice to add a non-cached path for historical requests, too.
• eth/v1/validator/blocks/{slot}
• /eth/v1/validator/attestation_data
• /eth/v1/validator/aggregate_attestation
• /eth/v1/validator/aggregate_and_proofs
• /eth/v1/validator/beacon_committee_subscriptions

Events

• /eth/v1/events

Known Issues

• [Merged by Bors] - Implement standard eth2.0 API #1569 (comment) (thanks @guybrush)
• Standard HTTP API validator response values unquoted #1717 (thanks @mcdee)