# Copyright (c) 2018-2020 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/[parseutils, sequtils, strutils, deques, sets], stew/results, json_rpc/[rpcserver, jsonmarshal], chronicles, nimcrypto/utils as ncrutils, ../beacon_node_common, ../eth2_json_rpc_serialization, ../eth2_network, ../validators/validator_duties, ../consensus_object_pools/[blockchain_dag, exit_pool], ../spec/[crypto, digest, datatypes, validator, network], ../spec/eth2_apis/callsigs_types, ../ssz/merkleization, ./rpc_utils logScope: topics = "beaconapi" type RpcServer = RpcHttpServer ValidatorQuery = object keyset: HashSet[ValidatorPubKey] ids: seq[uint64] StatusQuery = object statset: HashSet[string] template unimplemented() = raise (ref CatchableError)(msg: "Unimplemented") proc parsePubkey(str: string): ValidatorPubKey = const expectedLen = RawPubKeySize * 2 + 2 if str.len != expectedLen: # +2 because of the `0x` prefix raise newException(ValueError, "A hex public key should be exactly " & $expectedLen & " characters. " & $str.len & " provided") let pubkeyRes = fromHex(ValidatorPubKey, str) if pubkeyRes.isErr: raise newException(CatchableError, "Not a valid public key") return pubkeyRes[] proc createIdQuery(ids: openArray[string]): Result[ValidatorQuery, string] = # validatorIds array should have maximum 30 items, and all items should be # unique. if len(ids) > 30: return err("The number of ids exceeds the limit") # All ids in validatorIds must be unique. if len(ids) != len(toHashSet(ids)): return err("ids array must have unique item") var res = ValidatorQuery( keyset: initHashSet[ValidatorPubKey](), ids: newSeq[uint64]() ) for item in ids: if item.startsWith("0x"): if len(item) != RawPubKeySize * 2 + 2: return err("Incorrect hexadecimal key") let pubkeyRes = ValidatorPubKey.fromHex(item) if pubkeyRes.isErr: return err("Incorrect public key") res.keyset.incl(pubkeyRes.get()) else: var tmp: uint64 if parseBiggestUInt(item, tmp) != len(item): return err("Incorrect index value") res.ids.add(tmp) ok(res) proc createStatusQuery(status: openArray[string]): Result[StatusQuery, string] = const AllowedStatuses = [ "pending", "pending_initialized", "pending_queued", "active", "active_ongoing", "active_exiting", "active_slashed", "exited", "exited_unslashed", "exited_slashed", "withdrawal", "withdrawal_possible", "withdrawal_done" ] if len(status) > len(AllowedStatuses): return err("The number of statuses exceeds the limit") var res = StatusQuery(statset: initHashSet[string]()) # All ids in validatorIds must be unique. if len(status) != len(toHashSet(status)): return err("Status array must have unique items") for item in status: if item notin AllowedStatuses: return err("Invalid status requested") case item of "pending": res.statset.incl("pending_initialized") res.statset.incl("pending_queued") of "active": res.statset.incl("active_ongoing") res.statset.incl("active_exiting") res.statset.incl("active_slashed") of "exited": res.statset.incl("exited_unslashed") res.statset.incl("exited_slashed") of "withdrawal": res.statset.incl("withdrawal_possible") res.statset.incl("withdrawal_done") else: res.statset.incl(item) proc getStatus(validator: Validator, current_epoch: Epoch): Result[string, string] = if validator.activation_epoch > current_epoch: # pending if validator.activation_eligibility_epoch == FAR_FUTURE_EPOCH: ok("pending_initialized") else: # validator.activation_eligibility_epoch < FAR_FUTURE_EPOCH: ok("pending_queued") elif (validator.activation_epoch <= current_epoch) and (current_epoch < validator.exit_epoch): # active if validator.exit_epoch == FAR_FUTURE_EPOCH: ok("active_ongoing") elif not validator.slashed: # validator.exit_epoch < FAR_FUTURE_EPOCH ok("active_exiting") else: # validator.exit_epoch < FAR_FUTURE_EPOCH and validator.slashed: ok("active_slashed") elif (validator.exit_epoch <= current_epoch) and (current_epoch < validator.withdrawable_epoch): # exited if not validator.slashed: ok("exited_unslashed") else: # validator.slashed ok("exited_slashed") elif validator.withdrawable_epoch <= current_epoch: # withdrawal if validator.effective_balance != 0: ok("withdrawal_possible") else: # validator.effective_balance == 0 ok("withdrawal_done") else: err("Invalid validator status") proc getBlockDataFromBlockId(node: BeaconNode, blockId: string): BlockData = result = case blockId: of "head": node.chainDag.get(node.chainDag.head) of "genesis": node.chainDag.getGenesisBlockData() of "finalized": node.chainDag.get(node.chainDag.finalizedHead.blck) else: if blockId.startsWith("0x"): let blckRoot = parseRoot(blockId) let blockData = node.chainDag.get(blckRoot) if blockData.isNone: raise newException(CatchableError, "Block not found") blockData.get() else: let blockSlot = node.getBlockSlotFromString(blockId) if blockSlot.blck.isNil: raise newException(CatchableError, "Block not found") node.chainDag.get(blockSlot.blck) proc installBeaconApiHandlers*(rpcServer: RpcServer, node: BeaconNode) = rpcServer.rpc("get_v1_beacon_genesis") do () -> BeaconGenesisTuple: return ( genesis_time: node.chainDag.headState.data.data.genesis_time, genesis_validators_root: node.chainDag.headState.data.data.genesis_validators_root, genesis_fork_version: node.runtimePreset.GENESIS_FORK_VERSION ) rpcServer.rpc("get_v1_beacon_states_root") do (stateId: string) -> Eth2Digest: withStateForStateId(stateId): return hashedState.root rpcServer.rpc("get_v1_beacon_states_fork") do (stateId: string) -> Fork: withStateForStateId(stateId): return state.fork rpcServer.rpc("get_v1_beacon_states_finality_checkpoints") do ( stateId: string) -> BeaconStatesFinalityCheckpointsTuple: withStateForStateId(stateId): return (previous_justified: state.previous_justified_checkpoint, current_justified: state.current_justified_checkpoint, finalized: state.finalized_checkpoint) rpcServer.rpc("get_v1_beacon_states_stateId_validators") do ( stateId: string, validatorIds: Option[seq[string]], status: Option[seq[string]]) -> seq[BeaconStatesValidatorsTuple]: var vquery: ValidatorQuery var squery: StatusQuery let current_epoch = get_current_epoch(node.chainDag.headState.data.data) template statusCheck(status, statusQuery, vstatus, current_epoch): bool = if status.isNone(): true else: if vstatus in squery.statset: true else: false var res: seq[BeaconStatesValidatorsTuple] withStateForStateId(stateId): if status.isSome: let sqres = createStatusQuery(status.get()) if sqres.isErr: raise newException(CatchableError, sqres.error) squery = sqres.get() if validatorIds.isSome: let vqres = createIdQuery(validatorIds.get()) if vqres.isErr: raise newException(CatchableError, vqres.error) vquery = vqres.get() if validatorIds.isNone(): for index, validator in state.validators.pairs(): let sres = validator.getStatus(current_epoch) if sres.isOk: let vstatus = sres.get() let includeFlag = statusCheck(status, squery, vstatus, current_epoch) if includeFlag: res.add((validator: validator, index: uint64(index), status: vstatus, balance: validator.effective_balance)) else: for index in vquery.ids: if index < lenu64(state.validators): let validator = state.validators[index] let sres = validator.getStatus(current_epoch) if sres.isOk: let vstatus = sres.get() let includeFlag = statusCheck(status, squery, vstatus, current_epoch) if includeFlag: vquery.keyset.excl(validator.pubkey) res.add((validator: validator, index: uint64(index), status: vstatus, balance: validator.effective_balance)) for index, validator in state.validators.pairs(): if validator.pubkey in vquery.keyset: let sres = validator.getStatus(current_epoch) if sres.isOk: let vstatus = sres.get() let includeFlag = statusCheck(status, squery, vstatus, current_epoch) if includeFlag: res.add((validator: validator, index: uint64(index), status: vstatus, balance: validator.effective_balance)) return res rpcServer.rpc("get_v1_beacon_states_stateId_validators_validatorId") do ( stateId: string, validatorId: string) -> BeaconStatesValidatorsTuple: let current_epoch = get_current_epoch(node.chainDag.headState.data.data) let vqres = createIdQuery([validatorId]) if vqres.isErr: raise newException(CatchableError, vqres.error) let vquery = vqres.get() withStateForStateId(stateId): if len(vquery.ids) > 0: let index = vquery.ids[0] if index < lenu64(state.validators): let validator = state.validators[index] let sres = validator.getStatus(current_epoch) if sres.isOk: return (validator: validator, index: uint64(index), status: sres.get(), balance: validator.effective_balance) else: raise newException(CatchableError, "Incorrect validator's state") else: for index, validator in state.validators.pairs(): if validator.pubkey in vquery.keyset: let sres = validator.getStatus(current_epoch) if sres.isOk: return (validator: validator, index: uint64(index), status: sres.get(), balance: validator.effective_balance) else: raise newException(CatchableError, "Incorrect validator's state") rpcServer.rpc("get_v1_beacon_states_stateId_validator_balances") do ( stateId: string, validatorsId: Option[seq[string]]) -> seq[BalanceTuple]: var res: seq[BalanceTuple] withStateForStateId(stateId): if validatorsId.isNone(): for index, value in state.balances.pairs(): let balance = (index: uint64(index), balance: value) res.add(balance) else: let vqres = createIdQuery(validatorsId.get()) if vqres.isErr: raise newException(CatchableError, vqres.error) var vquery = vqres.get() for index in vquery.ids: if index < lenu64(state.validators): let validator = state.validators[index] vquery.keyset.excl(validator.pubkey) let balance = (index: uint64(index), balance: validator.effective_balance) res.add(balance) for index, validator in state.validators.pairs(): if validator.pubkey in vquery.keyset: let balance = (index: uint64(index), balance: validator.effective_balance) res.add(balance) return res rpcServer.rpc("get_v1_beacon_states_stateId_committees_epoch") do ( stateId: string, epoch: Option[uint64], index: Option[uint64], slot: Option[uint64]) -> seq[BeaconStatesCommitteesTuple]: withStateForStateId(stateId): proc getCommittee(slot: Slot, index: CommitteeIndex): BeaconStatesCommitteesTuple = let vals = get_beacon_committee(state, slot, index, cache).mapIt(it.uint64) return (index: index.uint64, slot: slot.uint64, validators: vals) proc forSlot(slot: Slot, res: var seq[BeaconStatesCommitteesTuple]) = let committees_per_slot = get_committee_count_per_slot(state, slot.epoch, cache) if index.isNone: for committee_index in 0'u64.. seq[BeaconHeadersTuple]: unimplemented() rpcServer.rpc("get_v1_beacon_headers_blockId") do ( blockId: string) -> tuple[canonical: bool, header: SignedBeaconBlockHeader]: let bd = node.getBlockDataFromBlockId(blockId) let tsbb = bd.data static: doAssert tsbb.signature is TrustedSig and sizeof(ValidatorSig) == sizeof(tsbb.signature) result.header.signature = cast[ValidatorSig](tsbb.signature) result.header.message.slot = tsbb.message.slot result.header.message.proposer_index = tsbb.message.proposer_index result.header.message.parent_root = tsbb.message.parent_root result.header.message.state_root = tsbb.message.state_root result.header.message.body_root = tsbb.message.body.hash_tree_root() result.canonical = bd.refs.isAncestorOf(node.chainDag.head) rpcServer.rpc("post_v1_beacon_blocks") do (blck: SignedBeaconBlock) -> int: if not(node.syncManager.inProgress): raise newException(CatchableError, "Beacon node is currently syncing, try again later.") let head = node.chainDag.head if head.slot >= blck.message.slot: node.network.broadcast(getBeaconBlocksTopic(node.forkDigest), blck) # The block failed validation, but was successfully broadcast anyway. # It was not integrated into the beacon node's database. return 202 else: let res = proposeSignedBlock(node, head, AttachedValidator(), blck) if res == head: node.network.broadcast(getBeaconBlocksTopic(node.forkDigest), blck) # The block failed validation, but was successfully broadcast anyway. # It was not integrated into the beacon node''s database. return 202 else: # The block was validated successfully and has been broadcast. # It has also been integrated into the beacon node's database. return 200 rpcServer.rpc("get_v1_beacon_blocks_blockId") do ( blockId: string) -> TrustedSignedBeaconBlock: return node.getBlockDataFromBlockId(blockId).data rpcServer.rpc("get_v1_beacon_blocks_blockId_root") do ( blockId: string) -> Eth2Digest: return node.getBlockDataFromBlockId(blockId).data.message.state_root rpcServer.rpc("get_v1_beacon_blocks_blockId_attestations") do ( blockId: string) -> seq[TrustedAttestation]: return node.getBlockDataFromBlockId(blockId).data.message.body.attestations.asSeq rpcServer.rpc("get_v1_beacon_pool_attestations") do ( slot: Option[uint64], committee_index: Option[uint64]) -> seq[AttestationTuple]: var res: seq[AttestationTuple] let qslot = if slot.isSome(): some(Slot(slot.get())) else: none[Slot]() let qindex = if committee_index.isSome(): some(CommitteeIndex(committee_index.get())) else: none[CommitteeIndex]() for item in node.attestationPool[].attestations(qslot, qindex): let atuple = ( aggregation_bits: "0x" & ncrutils.toHex(item.aggregation_bits.bytes), data: item.data, signature: item.signature ) res.add(atuple) return res rpcServer.rpc("post_v1_beacon_pool_attestations") do ( attestation: Attestation) -> bool: node.sendAttestation(attestation) return true rpcServer.rpc("get_v1_beacon_pool_attester_slashings") do ( ) -> seq[AttesterSlashing]: var res: seq[AttesterSlashing] if isNil(node.exitPool): return res let length = len(node.exitPool.attester_slashings) res = newSeqOfCap[AttesterSlashing](length) for item in node.exitPool.attester_slashings.items(): res.add(item) return res rpcServer.rpc("post_v1_beacon_pool_attester_slashings") do ( slashing: AttesterSlashing) -> bool: if isNil(node.exitPool): raise newException(CatchableError, "Exit pool is not yet available!") let validity = node.exitPool[].validateAttesterSlashing(slashing) if validity.isOk: node.sendAttesterSlashing(slashing) else: raise newException(CatchableError, $(validity.error[1])) return true rpcServer.rpc("get_v1_beacon_pool_proposer_slashings") do ( ) -> seq[ProposerSlashing]: var res: seq[ProposerSlashing] if isNil(node.exitPool): return res let length = len(node.exitPool.proposer_slashings) res = newSeqOfCap[ProposerSlashing](length) for item in node.exitPool.proposer_slashings.items(): res.add(item) return res rpcServer.rpc("post_v1_beacon_pool_proposer_slashings") do ( slashing: ProposerSlashing) -> bool: if isNil(node.exitPool): raise newException(CatchableError, "Exit pool is not yet available!") let validity = node.exitPool[].validateProposerSlashing(slashing) if validity.isOk: node.sendProposerSlashing(slashing) else: raise newException(CatchableError, $(validity.error[1])) return true rpcServer.rpc("get_v1_beacon_pool_voluntary_exits") do ( ) -> seq[SignedVoluntaryExit]: var res: seq[SignedVoluntaryExit] if isNil(node.exitPool): return res let length = len(node.exitPool.voluntary_exits) res = newSeqOfCap[SignedVoluntaryExit](length) for item in node.exitPool.voluntary_exits.items(): res.add(item) return res rpcServer.rpc("post_v1_beacon_pool_voluntary_exits") do ( exit: SignedVoluntaryExit) -> bool: if isNil(node.exitPool): raise newException(CatchableError, "Exit pool is not yet available!") let validity = node.exitPool[].validateVoluntaryExit(exit) if validity.isOk: node.sendVoluntaryExit(exit) else: raise newException(CatchableError, $(validity.error[1])) return true