# beacon_chain # Copyright (c) 2018-2021 Status Research & Development GmbH # Licensed and distributed under either of # * MIT license (license terms in the root directory or at https://opensource.org/licenses/MIT). # * Apache v2 license (license terms in the root directory or at https://www.apache.org/licenses/LICENSE-2.0). # at your option. This file may not be copied, modified, or distributed except according to those terms. import std/[typetraits, sequtils, strutils, sets], stew/[results, base10], chronicles, json_serialization, json_serialization/std/[options, net], nimcrypto/utils as ncrutils, ../beacon_node_common, ../networking/eth2_network, ../consensus_object_pools/[blockchain_dag, exit_pool, spec_cache], ../validators/validator_duties, ../spec/[eth2_merkleization, forks, network], ../spec/datatypes/[phase0, altair], ./rest_utils logScope: topics = "rest_beaconapi" proc validateFilter(filters: seq[ValidatorFilter]): Result[ValidatorFilter, cstring] = var res: ValidatorFilter for item in filters: if res * item != {}: return err("Validator status must be unique") res.incl(item) if res == {}: res = {ValidatorFilterKind.PendingInitialized, ValidatorFilterKind.PendingQueued, ValidatorFilterKind.ActiveOngoing, ValidatorFilterKind.ActiveExiting, ValidatorFilterKind.ActiveSlashed, ValidatorFilterKind.ExitedUnslashed, ValidatorFilterKind.ExitedSlashed, ValidatorFilterKind.WithdrawalPossible, ValidatorFilterKind.WithdrawalDone} ok(res) proc getStatus(validator: Validator, current_epoch: Epoch): Result[ValidatorFilterKind, cstring] = if validator.activation_epoch > current_epoch: # pending if validator.activation_eligibility_epoch == FAR_FUTURE_EPOCH: ok(ValidatorFilterKind.PendingInitialized) else: # validator.activation_eligibility_epoch < FAR_FUTURE_EPOCH: ok(ValidatorFilterKind.PendingQueued) elif (validator.activation_epoch <= current_epoch) and (current_epoch < validator.exit_epoch): # active if validator.exit_epoch == FAR_FUTURE_EPOCH: ok(ValidatorFilterKind.ActiveOngoing) elif not validator.slashed: # validator.exit_epoch < FAR_FUTURE_EPOCH ok(ValidatorFilterKind.ActiveExiting) else: # validator.exit_epoch < FAR_FUTURE_EPOCH and validator.slashed: ok(ValidatorFilterKind.ActiveSlashed) elif (validator.exit_epoch <= current_epoch) and (current_epoch < validator.withdrawable_epoch): # exited if not validator.slashed: ok(ValidatorFilterKind.ExitedUnslashed) else: # validator.slashed ok(ValidatorFilterKind.ExitedSlashed) elif validator.withdrawable_epoch <= current_epoch: # withdrawal if validator.effective_balance != 0: ok(ValidatorFilterKind.WithdrawalPossible) else: # validator.effective_balance == 0 ok(ValidatorFilterKind.WithdrawalDone) else: err("Invalid validator status") proc toString*(kind: ValidatorFilterKind): string = case kind of ValidatorFilterKind.PendingInitialized: "pending_initialized" of ValidatorFilterKind.PendingQueued: "pending_queued" of ValidatorFilterKind.ActiveOngoing: "active_ongoing" of ValidatorFilterKind.ActiveExiting: "active_exiting" of ValidatorFilterKind.ActiveSlashed: "active_slashed" of ValidatorFilterKind.ExitedUnslashed: "exited_unslashed" of ValidatorFilterKind.ExitedSlashed: "exited_slashed" of ValidatorFilterKind.WithdrawalPossible: "withdrawal_possible" of ValidatorFilterKind.WithdrawalDone: "withdrawal_done" proc installBeaconApiHandlers*(router: var RestRouter, node: BeaconNode) = # https://ethereum.github.io/beacon-APIs/#/Beacon/getGenesis router.api(MethodGet, "/api/eth/v1/beacon/genesis") do () -> RestApiResponse: return RestApiResponse.jsonResponse( ( genesis_time: getStateField(node.dag.headState.data, genesis_time), genesis_validators_root: getStateField(node.dag.headState.data, genesis_validators_root), genesis_fork_version: node.dag.cfg.GENESIS_FORK_VERSION ) ) # https://ethereum.github.io/beacon-APIs/#/Beacon/getStateRoot router.api(MethodGet, "/api/eth/v1/beacon/states/{state_id}/root") do ( state_id: StateIdent) -> RestApiResponse: let bslot = block: if state_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidStateIdValueError, $state_id.error()) # TODO (cheatfate): Its impossible to retrieve state by `state_root` # in current version of database. let sid = state_id.get() if sid.kind == StateQueryKind.Root: return RestApiResponse.jsonError(Http500, NoImplementationError) let bres = node.getBlockSlot(sid) if bres.isErr(): return RestApiResponse.jsonError(Http404, StateNotFoundError, $bres.error()) bres.get() node.withStateForBlockSlot(bslot): return RestApiResponse.jsonResponse((root: stateRoot)) return RestApiResponse.jsonError(Http404, StateNotFoundError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getStateFork router.api(MethodGet, "/api/eth/v1/beacon/states/{state_id}/fork") do ( state_id: StateIdent) -> RestApiResponse: let bslot = block: if state_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidStateIdValueError, $state_id.error()) # TODO (cheatfate): Its impossible to retrieve state by `state_root` # in current version of database. let sid = state_id.get() if sid.kind == StateQueryKind.Root: return RestApiResponse.jsonError(Http500, NoImplementationError) let bres = node.getBlockSlot(sid) if bres.isErr(): return RestApiResponse.jsonError(Http404, StateNotFoundError, $bres.error()) bres.get() node.withStateForBlockSlot(bslot): return RestApiResponse.jsonResponse( ( previous_version: getStateField(stateData.data, fork).previous_version, current_version: getStateField(stateData.data, fork).current_version, epoch: getStateField(stateData.data, fork).epoch ) ) return RestApiResponse.jsonError(Http404, StateNotFoundError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getStateFinalityCheckpoints router.api(MethodGet, "/api/eth/v1/beacon/states/{state_id}/finality_checkpoints") do ( state_id: StateIdent) -> RestApiResponse: let bslot = block: if state_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidStateIdValueError, $state_id.error()) # TODO (cheatfate): Its impossible to retrieve state by `state_root` # in current version of database. let sid = state_id.get() if sid.kind == StateQueryKind.Root: return RestApiResponse.jsonError(Http500, NoImplementationError) let bres = node.getBlockSlot(sid) if bres.isErr(): return RestApiResponse.jsonError(Http404, StateNotFoundError, $bres.error()) bres.get() node.withStateForBlockSlot(bslot): return RestApiResponse.jsonResponse( ( previous_justified: getStateField(stateData.data, previous_justified_checkpoint), current_justified: getStateField(stateData.data, current_justified_checkpoint), finalized: getStateField(stateData.data, finalized_checkpoint) ) ) return RestApiResponse.jsonError(Http404, StateNotFoundError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getStateValidators router.api(MethodGet, "/api/eth/v1/beacon/states/{state_id}/validators") do ( state_id: StateIdent, id: seq[ValidatorIdent], status: seq[ValidatorFilter]) -> RestApiResponse: let bslot = block: if state_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidStateIdValueError, $state_id.error()) # TODO (cheatfate): Its impossible to retrieve state by `state_root` # in current version of database. let sid = state_id.get() if sid.kind == StateQueryKind.Root: return RestApiResponse.jsonError(Http500, NoImplementationError) let bres = node.getBlockSlot(sid) if bres.isErr(): return RestApiResponse.jsonError(Http404, StateNotFoundError, $bres.error()) bres.get() let validatorIds = block: if id.isErr(): return RestApiResponse.jsonError(Http400, InvalidValidatorIdValueError) let ires = id.get() if len(ires) > MaximumValidatorIds: return RestApiResponse.jsonError(Http400, MaximumNumberOfValidatorIdsError) ires let validatorsMask = block: if status.isErr(): return RestApiResponse.jsonError(Http400, InvalidValidatorStatusValueError) let res = validateFilter(status.get()) if res.isErr(): return RestApiResponse.jsonError(Http400, InvalidValidatorStatusValueError, $res.error()) res.get() node.withStateForBlockSlot(bslot): let current_epoch = getStateField(stateData.data, slot).epoch() validatorsCount = lenu64(getStateField(stateData.data, validators)) let indices = block: var keyset: HashSet[ValidatorPubKey] var indexset: HashSet[ValidatorIndex] for item in validatorIds: case item.kind of ValidatorQueryKind.Key: keyset.incl(item.key) of ValidatorQueryKind.Index: let vindex = block: let vres = item.index.toValidatorIndex() if vres.isErr(): case vres.error() of ValidatorIndexError.TooHighValue: return RestApiResponse.jsonError(Http400, TooHighValidatorIndexValueError) of ValidatorIndexError.UnsupportedValue: return RestApiResponse.jsonError(Http500, UnsupportedValidatorIndexValueError) let index = vres.get() index if uint64(vindex) < validatorsCount: # We only adding validator indices which are present in # validators list at this moment. indexset.incl(vindex) if len(keyset) > 0: let optIndices = keysToIndices(node.restKeysCache, stateData.data, keyset.toSeq()) # Remove all the duplicates. for item in optIndices: # We ignore missing keys. if item.isSome(): indexset.incl(item.get()) indexset.toSeq() let response = block: var res: seq[RestValidator] if len(indices) == 0: # There is no indices, so we going to filter all the validators. for index, validator in getStateField(stateData.data, validators).pairs(): let balance = getStateField(stateData.data, balances)[index] status = block: let sres = validator.getStatus(current_epoch) if sres.isErr(): return RestApiResponse.jsonError(Http400, ValidatorStatusNotFoundError, $sres.get()) sres.get() if status in validatorsMask: res.add(RestValidator.init(ValidatorIndex(index), balance, toString(status), validator)) else: for index in indices: let validator = getStateField(stateData.data, validators)[index] balance = getStateField(stateData.data, balances)[index] status = block: let sres = validator.getStatus(current_epoch) if sres.isErr(): return RestApiResponse.jsonError(Http400, ValidatorStatusNotFoundError, $sres.get()) sres.get() if status in validatorsMask: res.add(RestValidator.init(index, balance, toString(status), validator)) res return RestApiResponse.jsonResponse(response) return RestApiResponse.jsonError(Http404, StateNotFoundError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getStateValidator router.api(MethodGet, "/api/eth/v1/beacon/states/{state_id}/validators/{validator_id}") do ( state_id: StateIdent, validator_id: ValidatorIdent) -> RestApiResponse: let bslot = block: if state_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidStateIdValueError, $state_id.error()) # TODO (cheatfate): Its impossible to retrieve state by `state_root` # in current version of database. let sid = state_id.get() if sid.kind == StateQueryKind.Root: return RestApiResponse.jsonError(Http500, NoImplementationError) let bres = node.getBlockSlot(sid) if bres.isErr(): return RestApiResponse.jsonError(Http404, StateNotFoundError, $bres.error()) bres.get() if validator_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidValidatorIdValueError, $validator_id.error()) node.withStateForBlockSlot(bslot): let current_epoch = getStateField(stateData.data, slot).epoch() validatorsCount = lenu64(getStateField(stateData.data, validators)) let vindex = block: let vid = validator_id.get() case vid.kind of ValidatorQueryKind.Key: let optIndices = keysToIndices(node.restKeysCache, stateData.data, [vid.key]) if optIndices[0].isNone(): return RestApiResponse.jsonError(Http404, ValidatorNotFoundError) optIndices[0].get() of ValidatorQueryKind.Index: let vres = vid.index.toValidatorIndex() if vres.isErr(): case vres.error() of ValidatorIndexError.TooHighValue: return RestApiResponse.jsonError(Http400, TooHighValidatorIndexValueError) of ValidatorIndexError.UnsupportedValue: return RestApiResponse.jsonError(Http500, UnsupportedValidatorIndexValueError) let index = vres.get() if uint64(index) >= validatorsCount: return RestApiResponse.jsonError(Http404, ValidatorNotFoundError) index let validator = getStateField(stateData.data, validators)[vindex] balance = getStateField(stateData.data, balances)[vindex] status = block: let sres = validator.getStatus(current_epoch) if sres.isErr(): return RestApiResponse.jsonError(Http400, ValidatorStatusNotFoundError, $sres.get()) toString(sres.get()) return RestApiResponse.jsonResponse( RestValidator.init(vindex, balance, status, validator) ) return RestApiResponse.jsonError(Http404, StateNotFoundError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getStateValidatorBalances router.api(MethodGet, "/api/eth/v1/beacon/states/{state_id}/validator_balances") do ( state_id: StateIdent, id: seq[ValidatorIdent]) -> RestApiResponse: let bslot = block: if state_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidStateIdValueError, $state_id.error()) # TODO (cheatfate): Its impossible to retrieve state by `state_root` # in current version of database. let sid = state_id.get() if sid.kind == StateQueryKind.Root: return RestApiResponse.jsonError(Http500, NoImplementationError) let bres = node.getBlockSlot(sid) if bres.isErr(): return RestApiResponse.jsonError(Http404, StateNotFoundError, $bres.error()) bres.get() let validatorIds = block: if id.isErr(): return RestApiResponse.jsonError(Http400, InvalidValidatorIdValueError) let ires = id.get() if len(ires) > MaximumValidatorIds: return RestApiResponse.jsonError(Http400, MaximumNumberOfValidatorIdsError) ires node.withStateForBlockSlot(bslot): let current_epoch = getStateField(stateData.data, slot).epoch() validatorsCount = lenu64(getStateField(stateData.data, validators)) let indices = block: var keyset: HashSet[ValidatorPubKey] var indexset: HashSet[ValidatorIndex] for item in validatorIds: case item.kind of ValidatorQueryKind.Key: keyset.incl(item.key) of ValidatorQueryKind.Index: let vindex = block: let vres = item.index.toValidatorIndex() if vres.isErr(): case vres.error() of ValidatorIndexError.TooHighValue: return RestApiResponse.jsonError(Http400, TooHighValidatorIndexValueError) of ValidatorIndexError.UnsupportedValue: return RestApiResponse.jsonError(Http500, UnsupportedValidatorIndexValueError) vres.get() # We only adding validator indices which are present in # validators list at this moment. if uint64(vindex) < validatorsCount: indexset.incl(vindex) if len(keyset) > 0: let optIndices = keysToIndices(node.restKeysCache, stateData.data, keyset.toSeq()) # Remove all the duplicates. for item in optIndices: # We ignore missing keys. if item.isSome(): indexset.incl(item.get()) indexset.toSeq() let response = block: var res: seq[RestValidatorBalance] if len(indices) == 0: # There is no indices, so we going to filter all the validators. for index, validator in getStateField(stateData.data, validators).pairs(): let balance = getStateField(stateData.data, balances)[index] res.add(RestValidatorBalance.init(ValidatorIndex(index), balance)) else: for index in indices: let balance = getStateField(stateData.data, balances)[index] res.add(RestValidatorBalance.init(index, balance)) res return RestApiResponse.jsonResponse(response) return RestApiResponse.jsonError(Http404, StateNotFoundError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getEpochCommittees router.api(MethodGet, "/api/eth/v1/beacon/states/{state_id}/committees") do ( state_id: StateIdent, epoch: Option[Epoch], index: Option[CommitteeIndex], slot: Option[Slot]) -> RestApiResponse: let bslot = block: if state_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidStateIdValueError, $state_id.error()) # TODO (cheatfate): Its impossible to retrieve state by `state_root` # in current version of database. let sid = state_id.get() if sid.kind == StateQueryKind.Root: return RestApiResponse.jsonError(Http500, NoImplementationError) let bres = node.getBlockSlot(sid) if bres.isErr(): return RestApiResponse.jsonError(Http404, StateNotFoundError, $bres.error()) bres.get() let vepoch = if epoch.isSome(): let repoch = epoch.get() if repoch.isErr(): return RestApiResponse.jsonError(Http400, InvalidEpochValueError, $repoch.error()) let res = repoch.get() if res > MaxEpoch: return RestApiResponse.jsonError(Http400, EpochOverflowValueError) some(res) else: none[Epoch]() let vindex = if index.isSome(): let rindex = index.get() if rindex.isErr(): return RestApiResponse.jsonError(Http400, InvalidCommitteeIndexValueError, $rindex.error()) some(rindex.get()) else: none[CommitteeIndex]() let vslot = if slot.isSome(): let rslot = slot.get() if rslot.isErr(): return RestApiResponse.jsonError(Http400, InvalidSlotValueError, $rslot.error()) some(rslot.get()) else: none[Slot]() node.withStateForBlockSlot(bslot): proc getCommittee(slot: Slot, index: CommitteeIndex): RestBeaconStatesCommittees = let validators = get_beacon_committee(stateData.data, slot, index, cache).mapIt(it) RestBeaconStatesCommittees(index: index, slot: slot, validators: validators) proc forSlot(slot: Slot, cindex: Option[CommitteeIndex], res: var seq[RestBeaconStatesCommittees]) = let committees_per_slot = get_committee_count_per_slot(stateData.data, Epoch(slot), cache) if cindex.isNone: for committee_index in 0'u64 ..< committees_per_slot: res.add(getCommittee(slot, CommitteeIndex(committee_index))) else: let idx = cindex.get() if uint64(idx) < committees_per_slot: res.add(getCommittee(slot, idx)) var res: seq[RestBeaconStatesCommittees] let qepoch = if vepoch.isNone: compute_epoch_at_slot(getStateField(stateData.data, slot)) else: vepoch.get() if vslot.isNone(): for i in 0 ..< SLOTS_PER_EPOCH: forSlot(compute_start_slot_at_epoch(qepoch) + i, vindex, res) else: forSlot(vslot.get(), vindex, res) return RestApiResponse.jsonResponse(res) return RestApiResponse.jsonError(Http404, StateNotFoundError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getEpochSyncCommittees router.api(MethodGet, "/api/eth/v1/beacon/states/{state_id}/sync_committees") do ( state_id: StateIdent, epoch: Option[Epoch]) -> RestApiResponse: let bslot = block: if state_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidStateIdValueError, $state_id.error()) # TODO (cheatfate): Its impossible to retrieve state by `state_root` # in current version of database. let sid = state_id.get() if sid.kind == StateQueryKind.Root: return RestApiResponse.jsonError(Http500, NoImplementationError) let bres = node.getBlockSlot(sid) bres.get() let qepoch = if epoch.isSome(): let repoch = epoch.get() if repoch.isErr(): return RestApiResponse.jsonError(Http400, InvalidEpochValueError, $repoch.error()) let res = repoch.get() if res > MaxEpoch: return RestApiResponse.jsonError(Http400, EpochOverflowValueError) if res < node.dag.cfg.ALTAIR_FORK_EPOCH: return RestApiResponse.jsonError(Http400, EpochFromTheIncorrectForkError) res else: # If ``epoch`` not present then the sync committees for the epoch of # the state will be obtained. bslot.slot.epoch() node.withStateForBlockSlot(bslot): let keys = block: let res = syncCommitteeParticipants(stateData().data, qepoch) if res.isErr(): return RestApiResponse.jsonError(Http400, $res.error()) let kres = res.get() if len(kres) == 0: return RestApiResponse.jsonError(Http500, InternalServerError, "List of sync committee participants is empty") kres let indices = block: var res: seq[ValidatorIndex] let optIndices = keysToIndices(node.restKeysCache, stateData().data, keys) # Remove all the duplicates. for item in optIndices: if item.isNone(): # This should not be happened, because keys are from state. return RestApiResponse.jsonError(Http500, InternalServerError, "Could not get validator indices") res.add(item.get()) res let aggregates = block: var res: seq[seq[ValidatorIndex]] offset = 0 while true: let length = min(SYNC_SUBCOMMITTEE_SIZE, len(indices) - offset) if length == 0: break res.add(@(indices.toOpenArray(offset, offset + length - 1))) offset.inc(length) res return RestApiResponse.jsonResponse(RestEpochSyncCommittee( validators: indices, validator_aggregates: aggregates) ) return RestApiResponse.jsonError(Http404, StateNotFoundError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getBlockHeaders router.api(MethodGet, "/api/eth/v1/beacon/headers") do ( slot: Option[Slot], parent_root: Option[Eth2Digest]) -> RestApiResponse: # TODO (cheatfate): This call is incomplete, because structure # of database do not allow to query blocks by `parent_root`. let qslot = if slot.isSome(): let rslot = slot.get() if rslot.isErr(): return RestApiResponse.jsonError(Http400, InvalidSlotValueError, $rslot.error()) rslot.get() else: node.dag.head.slot if parent_root.isSome(): let rroot = parent_root.get() if rroot.isErr(): return RestApiResponse.jsonError(Http400, InvalidParentRootValueError, $rroot.error()) return RestApiResponse.jsonError(Http500, NoImplementationError) let bdata = block: let head = block: let res = node.getCurrentHead(qslot) if res.isErr(): return RestApiResponse.jsonError(Http404, SlotNotFoundError, $res.error()) res.get() let blockSlot = head.atSlot(qslot) if isNil(blockSlot.blck): return RestApiResponse.jsonError(Http404, BlockNotFoundError) node.dag.get(blockSlot.blck) return withBlck(bdata.data): RestApiResponse.jsonResponse( [ ( root: blck.root, canonical: bdata.refs.isAncestorOf(node.dag.head), header: ( message: ( slot: blck.message.slot, proposer_index: blck.message.proposer_index, parent_root: blck.message.parent_root, state_root: blck.message.state_root, body_root: blck.message.body.hash_tree_root() ), signature: blck.signature ) ) ] ) # https://ethereum.github.io/beacon-APIs/#/Beacon/getBlockHeader router.api(MethodGet, "/api/eth/v1/beacon/headers/{block_id}") do ( block_id: BlockIdent) -> RestApiResponse: let bdata = block: if block_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidBlockIdValueError, $block_id.error()) let res = node.getBlockDataFromBlockIdent(block_id.get()) if res.isErr(): return RestApiResponse.jsonError(Http404, BlockNotFoundError) res.get() return withBlck(bdata.data): RestApiResponse.jsonResponse( ( root: blck.root, canonical: bdata.refs.isAncestorOf(node.dag.head), header: ( message: ( slot: blck.message.slot, proposer_index: blck.message.proposer_index, parent_root: blck.message.parent_root, state_root: blck.message.state_root, body_root: blck.message.body.hash_tree_root() ), signature: blck.signature ) ) ) # https://ethereum.github.io/beacon-APIs/#/Beacon/publishBlock router.api(MethodPost, "/api/eth/v1/beacon/blocks") do ( contentBody: Option[ContentBody]) -> RestApiResponse: let forked = block: if contentBody.isNone(): return RestApiResponse.jsonError(Http400, EmptyRequestBodyError) let body = contentBody.get() let altairRes = decodeBody(altair.SignedBeaconBlock, body) if altairRes.isOk(): var res = altairRes.get() if res.message.slot.epoch < node.dag.cfg.ALTAIR_FORK_EPOCH: # This message deserialized successfully as altair but should # actually be a phase0 block - try again with phase0 let phase0res = decodeBody(phase0.SignedBeaconBlock, body) if phase0res.isOk(): var res = phase0res.get() # `SignedBeaconBlock` deserialization do not update `root` field, # so we need to calculate it. res.root = hash_tree_root(res.message) ForkedSignedBeaconBlock.init(res) else: return RestApiResponse.jsonError(Http400, InvalidBlockObjectError, $phase0res.error()) else: # `SignedBeaconBlock` deserialization do not update `root` field, # so we need to calculate it. res.root = hash_tree_root(res.message) ForkedSignedBeaconBlock.init(res) else: let phase0res = decodeBody(phase0.SignedBeaconBlock, body) if phase0res.isOk(): var res = phase0res.get() # `SignedBeaconBlock` deserialization do not update `root` field, # so we need to calculate it. res.root = hash_tree_root(res.message) ForkedSignedBeaconBlock.init(res) else: return RestApiResponse.jsonError(Http400, InvalidBlockObjectError, $phase0res.error()) let res = await node.sendBeaconBlock(forked) if res.isErr(): return RestApiResponse.jsonError(Http503, BeaconNodeInSyncError) if not(res.get()): return RestApiResponse.jsonError(Http202, BlockValidationError) return RestApiResponse.jsonMsgResponse(BlockValidationSuccess) # https://ethereum.github.io/beacon-APIs/#/Beacon/getBlock router.api(MethodGet, "/api/eth/v1/beacon/blocks/{block_id}") do ( block_id: BlockIdent) -> RestApiResponse: let bdata = block: if block_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidBlockIdValueError, $block_id.error()) let res = node.getBlockDataFromBlockIdent(block_id.get()) if res.isErr(): return RestApiResponse.jsonError(Http404, BlockNotFoundError) res.get() let contentType = block: let res = preferredContentType("application/octet-stream", "application/json") if res.isErr(): return RestApiResponse.jsonError(Http406, ContentNotAcceptableError) res.get() return case bdata.data.kind of BeaconBlockFork.Phase0: case contentType of "application/octet-stream": RestApiResponse.sszResponse(bdata.data.phase0Data) of "application/json": RestApiResponse.jsonResponse(bdata.data.phase0Data) else: RestApiResponse.jsonError(Http500, InvalidAcceptError) of BeaconBlockFork.Altair, BeaconBlockFork.Merge: RestApiResponse.jsonError(Http404, BlockNotFoundError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getBlockV2 router.api(MethodGet, "/api/eth/v2/beacon/blocks/{block_id}") do ( block_id: BlockIdent) -> RestApiResponse: let bdata = block: if block_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidBlockIdValueError, $block_id.error()) let res = node.getBlockDataFromBlockIdent(block_id.get()) if res.isErr(): return RestApiResponse.jsonError(Http404, BlockNotFoundError) res.get() let contentType = block: let res = preferredContentType("application/octet-stream", "application/json") if res.isErr(): return RestApiResponse.jsonError(Http406, ContentNotAcceptableError) res.get() return case contentType of "application/octet-stream": case bdata.data.kind of BeaconBlockFork.Phase0: RestApiResponse.sszResponse(bdata.data.phase0Data) of BeaconBlockFork.Altair: RestApiResponse.sszResponse(bdata.data.altairData) of BeaconBlockFork.Merge: RestApiResponse.sszResponse(bdata.data.mergeData) of "application/json": RestApiResponse.jsonResponsePlain(bdata.data.asSigned()) else: RestApiResponse.jsonError(Http500, InvalidAcceptError) # https://ethereum.github.io/beacon-APIs/#/Beacon/getBlockRoot router.api(MethodGet, "/api/eth/v1/beacon/blocks/{block_id}/root") do ( block_id: BlockIdent) -> RestApiResponse: let bdata = block: if block_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidBlockIdValueError, $block_id.error()) let res = node.getBlockDataFromBlockIdent(block_id.get()) if res.isErr(): return RestApiResponse.jsonError(Http404, BlockNotFoundError) res.get() return withBlck(bdata.data): RestApiResponse.jsonResponse((root: blck.root)) # https://ethereum.github.io/beacon-APIs/#/Beacon/getBlockAttestations router.api(MethodGet, "/api/eth/v1/beacon/blocks/{block_id}/attestations") do ( block_id: BlockIdent) -> RestApiResponse: let bdata = block: if block_id.isErr(): return RestApiResponse.jsonError(Http400, InvalidBlockIdValueError, $block_id.error()) let res = node.getBlockDataFromBlockIdent(block_id.get()) if res.isErr(): return RestApiResponse.jsonError(Http404, BlockNotFoundError) res.get() return withBlck(bdata.data): RestApiResponse.jsonResponse(blck.message.body.attestations.asSeq()) # https://ethereum.github.io/beacon-APIs/#/Beacon/getPoolAttestations router.api(MethodGet, "/api/eth/v1/beacon/pool/attestations") do ( slot: Option[Slot], committee_index: Option[CommitteeIndex]) -> RestApiResponse: let vindex = if committee_index.isSome(): let rindex = committee_index.get() if rindex.isErr(): return RestApiResponse.jsonError(Http400, InvalidCommitteeIndexValueError, $rindex.error()) some(rindex.get()) else: none[CommitteeIndex]() let vslot = if slot.isSome(): let rslot = slot.get() if rslot.isErr(): return RestApiResponse.jsonError(Http400, InvalidSlotValueError, $rslot.error()) some(rslot.get()) else: none[Slot]() var res: seq[Attestation] for item in node.attestationPool[].attestations(vslot, vindex): res.add(item) return RestApiResponse.jsonResponse(res) # https://ethereum.github.io/beacon-APIs/#/Beacon/submitPoolAttestations router.api(MethodPost, "/api/eth/v1/beacon/pool/attestations") do ( contentBody: Option[ContentBody]) -> RestApiResponse: let attestations = block: if contentBody.isNone(): return RestApiResponse.jsonError(Http400, EmptyRequestBodyError) let dres = decodeBody(seq[Attestation], contentBody.get()) if dres.isErr(): return RestApiResponse.jsonError(Http400, InvalidAttestationObjectError, $dres.error()) dres.get() proc processAttestation(a: Attestation): Future[SendResult] {.async.} = let res = await node.sendAttestation(a) if res.isErr(): return res let wallTime = node.processor.getCurrentBeaconTime() deadline = a.data.slot.toBeaconTime() + seconds(int(SECONDS_PER_SLOT div 3)) (delayStr, delaySecs) = if wallTime < deadline: ("-" & $(deadline - wallTime), -toFloatSeconds(deadline - wallTime)) else: ($(wallTime - deadline), toFloatSeconds(wallTime - deadline)) notice "Attestation sent", attestation = shortLog(a), delay = delayStr return res # Since our validation logic supports batch processing, we will submit all # attestations for validation. let pending = block: var res: seq[Future[SendResult]] for attestation in attestations: res.add(processAttestation(attestation)) res let failures = block: var res: seq[RestAttestationsFailure] await allFutures(pending) for index, future in pending.pairs(): if future.done(): let fres = future.read() if fres.isErr(): let failure = RestAttestationsFailure(index: uint64(index), message: $fres.error()) res.add(failure) elif future.failed() or future.cancelled(): # This is unexpected failure, so we log the error message. let exc = future.readError() let failure = RestAttestationsFailure(index: uint64(index), message: $exc.msg) res.add(failure) res if len(failures) > 0: return RestApiResponse.jsonErrorList(Http400, AttestationValidationError, failures) else: return RestApiResponse.jsonMsgResponse(AttestationValidationSuccess) # https://ethereum.github.io/beacon-APIs/#/Beacon/getPoolAttesterSlashings router.api(MethodGet, "/api/eth/v1/beacon/pool/attester_slashings") do ( ) -> RestApiResponse: var res: seq[AttesterSlashing] if isNil(node.exitPool): return RestApiResponse.jsonResponse(res) let length = len(node.exitPool.attester_slashings) res = newSeqOfCap[AttesterSlashing](length) for item in node.exitPool.attester_slashings.items(): res.add(item) return RestApiResponse.jsonResponse(res) # https://ethereum.github.io/beacon-APIs/#/Beacon/submitPoolAttesterSlashings router.api(MethodPost, "/api/eth/v1/beacon/pool/attester_slashings") do ( contentBody: Option[ContentBody]) -> RestApiResponse: let slashing = block: if contentBody.isNone(): return RestApiResponse.jsonError(Http400, EmptyRequestBodyError) let dres = decodeBody(AttesterSlashing, contentBody.get()) if dres.isErr(): return RestApiResponse.jsonError(Http400, InvalidAttesterSlashingObjectError, $dres.error()) dres.get() let res = node.sendAttesterSlashing(slashing) if res.isErr(): return RestApiResponse.jsonError(Http400, AttesterSlashingValidationError, $res.error()) return RestApiResponse.jsonMsgResponse(AttesterSlashingValidationSuccess) # https://ethereum.github.io/beacon-APIs/#/Beacon/getPoolProposerSlashings router.api(MethodGet, "/api/eth/v1/beacon/pool/proposer_slashings") do ( ) -> RestApiResponse: var res: seq[ProposerSlashing] if isNil(node.exitPool): return RestApiResponse.jsonResponse(res) let length = len(node.exitPool.proposer_slashings) res = newSeqOfCap[ProposerSlashing](length) for item in node.exitPool.proposer_slashings.items(): res.add(item) return RestApiResponse.jsonResponse(res) # https://ethereum.github.io/beacon-APIs/#/Beacon/submitPoolProposerSlashings router.api(MethodPost, "/api/eth/v1/beacon/pool/proposer_slashings") do ( contentBody: Option[ContentBody]) -> RestApiResponse: let slashing = block: if contentBody.isNone(): return RestApiResponse.jsonError(Http400, EmptyRequestBodyError) let dres = decodeBody(ProposerSlashing, contentBody.get()) if dres.isErr(): return RestApiResponse.jsonError(Http400, InvalidProposerSlashingObjectError, $dres.error()) dres.get() let res = node.sendProposerSlashing(slashing) if res.isErr(): return RestApiResponse.jsonError(Http400, ProposerSlashingValidationError, $res.error()) return RestApiResponse.jsonMsgResponse(ProposerSlashingValidationSuccess) # https://ethereum.github.io/beacon-APIs/#/Beacon/submitPoolSyncCommitteeSignatures router.api(MethodPost, "/api/eth/v1/beacon/pool/sync_committees") do ( contentBody: Option[ContentBody]) -> RestApiResponse: let messages = block: if contentBody.isNone(): return RestApiResponse.jsonError(Http400, EmptyRequestBodyError) let dres = decodeBody(seq[SyncCommitteeMessage], contentBody.get()) if dres.isErr(): return RestApiResponse.jsonError(Http400, InvalidSyncCommitteeSignatureMessageError) dres.get() let results = await node.sendSyncCommitteeMessages(messages) let failures = block: var res: seq[RestAttestationsFailure] for index, item in results.pairs(): if item.isErr(): res.add(RestAttestationsFailure(index: uint64(index), message: $item.error())) res if len(failures) > 0: return RestApiResponse.jsonErrorList(Http400, SyncCommitteeMessageValidationError, failures) else: return RestApiResponse.jsonMsgResponse( SyncCommitteeMessageValidationSuccess) # https://ethereum.github.io/beacon-APIs/#/Beacon/getPoolVoluntaryExits router.api(MethodGet, "/api/eth/v1/beacon/pool/voluntary_exits") do ( ) -> RestApiResponse: var res: seq[SignedVoluntaryExit] if isNil(node.exitPool): return RestApiResponse.jsonResponse(res) let length = len(node.exitPool.voluntary_exits) res = newSeqOfCap[SignedVoluntaryExit](length) for item in node.exitPool.voluntary_exits.items(): res.add(item) return RestApiResponse.jsonResponse(res) # https://ethereum.github.io/beacon-APIs/#/Beacon/submitPoolVoluntaryExit router.api(MethodPost, "/api/eth/v1/beacon/pool/voluntary_exits") do ( contentBody: Option[ContentBody]) -> RestApiResponse: let exit = block: if contentBody.isNone(): return RestApiResponse.jsonError(Http400, EmptyRequestBodyError) let dres = decodeBody(SignedVoluntaryExit, contentBody.get()) if dres.isErr(): return RestApiResponse.jsonError(Http400, InvalidVoluntaryExitObjectError, $dres.error()) dres.get() let res = node.sendVoluntaryExit(exit) if res.isErr(): return RestApiResponse.jsonError(Http400, VoluntaryExitValidationError, $res.error()) return RestApiResponse.jsonMsgResponse(VoluntaryExitValidationSuccess) router.redirect( MethodGet, "/eth/v1/beacon/genesis", "/api/eth/v1/beacon/genesis" ) router.redirect( MethodGet, "/eth/v1/beacon/states/{state_id}/root", "/api/eth/v1/beacon/states/{state_id}/root" ) router.redirect( MethodGet, "/eth/v1/beacon/states/{state_id}/fork", "/api/eth/v1/beacon/states/{state_id}/fork" ) router.redirect( MethodGet, "/eth/v1/beacon/states/{state_id}/finality_checkpoints", "/api/eth/v1/beacon/states/{state_id}/finality_checkpoints" ) router.redirect( MethodGet, "/eth/v1/beacon/states/{state_id}/validators", "/api/eth/v1/beacon/states/{state_id}/validators" ) router.redirect( MethodGet, "/eth/v1/beacon/states/{state_id}/validators/{validator_id}", "/api/eth/v1/beacon/states/{state_id}/validators/{validator_id}" ) router.redirect( MethodGet, "/eth/v1/beacon/states/{state_id}/validator_balances", "/api/eth/v1/beacon/states/{state_id}/validator_balances" ) router.redirect( MethodGet, "/eth/v1/beacon/states/{state_id}/committees", "/api/eth/v1/beacon/states/{state_id}/committees" ) router.redirect( MethodGet, "/eth/v1/beacon/states/{state_id}/sync_committees", "/api/eth/v1/beacon/states/{state_id}/sync_committees" ) router.redirect( MethodGet, "/eth/v1/beacon/headers", "/api/eth/v1/beacon/headers" ) router.redirect( MethodGet, "/eth/v1/beacon/headers/{block_id}", "/api/eth/v1/beacon/headers/{block_id}" ) router.redirect( MethodPost, "/eth/v1/beacon/blocks", "/api/eth/v1/beacon/blocks" ) router.redirect( MethodGet, "/eth/v1/beacon/blocks/{block_id}", "/api/eth/v1/beacon/blocks/{block_id}" ) router.redirect( MethodGet, "/eth/v2/beacon/blocks/{block_id}", "/api/eth/v2/beacon/blocks/{block_id}" ) router.redirect( MethodGet, "/eth/v1/beacon/blocks/{block_id}/root", "/api/eth/v1/beacon/blocks/{block_id}/root" ) router.redirect( MethodGet, "/eth/v1/beacon/blocks/{block_id}/attestations", "/api/eth/v1/beacon/blocks/{block_id}/attestations" ) router.redirect( MethodGet, "/eth/v1/beacon/pool/attestations", "/api/eth/v1/beacon/pool/attestations" ) router.redirect( MethodPost, "/eth/v1/beacon/pool/attestations", "/api/eth/v1/beacon/pool/attestations" ) router.redirect( MethodPost, "/eth/v1/beacon/pool/attester_slashings", "/api/eth/v1/beacon/pool/attester_slashings" ) router.redirect( MethodGet, "/eth/v1/beacon/pool/attester_slashings", "/api/eth/v1/beacon/pool/attester_slashings" ) router.redirect( MethodPost, "/eth/v1/beacon/pool/proposer_slashings", "/api/eth/v1/beacon/pool/proposer_slashings" ) router.redirect( MethodGet, "/eth/v1/beacon/pool/proposer_slashings", "/api/eth/v1/beacon/pool/proposer_slashings" ) router.redirect( MethodPost, "/eth/v1/beacon/pool/sync_committees", "/api/eth/v1/beacon/pool/sync_committees" ) router.redirect( MethodPost, "/eth/v1/beacon/pool/voluntary_exits", "/api/eth/v1/beacon/pool/voluntary_exits" ) router.redirect( MethodGet, "/eth/v1/beacon/pool/voluntary_exits", "/api/eth/v1/beacon/pool/voluntary_exits" )