498 lines
19 KiB
Nim
498 lines
19 KiB
Nim
# Copyright (c) 2021-2022 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/[tables, os, strutils, uri]
|
|
import chronos, chronicles, confutils,
|
|
stew/[base10, results, io2], blscurve
|
|
import ".."/validators/slashing_protection
|
|
import ".."/[conf, filepath, beacon_node]
|
|
import ".."/spec/[keystore, crypto]
|
|
import ".."/rpc/rest_utils
|
|
import ".."/validators/[keystore_management, validator_pool, validator_duties]
|
|
import ".."/spec/eth2_apis/rest_keymanager_types
|
|
|
|
export rest_utils, results
|
|
|
|
proc listLocalValidators*(node: BeaconNode): seq[KeystoreInfo]
|
|
{.raises: [Defect].} =
|
|
var validators: seq[KeystoreInfo]
|
|
for item in node.attachedValidators[].items():
|
|
if item.kind == ValidatorKind.Local:
|
|
validators.add KeystoreInfo(
|
|
validating_pubkey: item.pubkey,
|
|
derivation_path: string(item.data.path),
|
|
readonly: false
|
|
)
|
|
validators
|
|
|
|
proc listRemoteValidators*(node: BeaconNode): seq[RemoteKeystoreInfo]
|
|
{.raises: [Defect].} =
|
|
var validators: seq[RemoteKeystoreInfo]
|
|
for item in node.attachedValidators[].items():
|
|
if item.kind == ValidatorKind.Remote and item.data.remotes.len == 1:
|
|
validators.add RemoteKeystoreInfo(
|
|
pubkey: item.pubkey,
|
|
url: HttpHostUri(item.data.remotes[0].url)
|
|
)
|
|
validators
|
|
|
|
proc listRemoteDistributedValidators*(node: BeaconNode): seq[DistributedKeystoreInfo]
|
|
{.raises: [Defect].} =
|
|
var validators: seq[DistributedKeystoreInfo]
|
|
for item in node.attachedValidators[].items():
|
|
if item.kind == ValidatorKind.Remote and item.data.remotes.len > 1:
|
|
validators.add DistributedKeystoreInfo(
|
|
pubkey: item.pubkey,
|
|
remotes: item.data.remotes
|
|
)
|
|
validators
|
|
|
|
proc keymanagerApiError(status: HttpCode, msg: string): RestApiResponse =
|
|
let data =
|
|
block:
|
|
var default: string
|
|
try:
|
|
var defstrings: seq[string]
|
|
var stream = memoryOutput()
|
|
var writer = JsonWriter[RestJson].init(stream)
|
|
writer.beginRecord()
|
|
writer.writeField("message", msg)
|
|
writer.endRecord()
|
|
stream.getOutput(string)
|
|
except SerializationError:
|
|
default
|
|
except IOError:
|
|
default
|
|
RestApiResponse.error(status, data, "application/json")
|
|
|
|
proc checkAuthorization*(request: HttpRequestRef,
|
|
node: BeaconNode): Result[void, AuthorizationError] =
|
|
let authorizations = request.headers.getList("authorization")
|
|
if authorizations.len > 0:
|
|
for authHeader in authorizations:
|
|
let parts = authHeader.split(' ', maxsplit = 1)
|
|
if parts.len == 2 and parts[0] == "Bearer":
|
|
if parts[1] == node.keymanagerToken.get:
|
|
return ok()
|
|
else:
|
|
return err incorrectToken
|
|
return err missingBearerScheme
|
|
else:
|
|
return err noAuthorizationHeader
|
|
|
|
proc authErrorResponse(error: AuthorizationError): RestApiResponse =
|
|
let status = case error:
|
|
of missingBearerScheme, noAuthorizationHeader:
|
|
Http401
|
|
of incorrectToken:
|
|
Http403
|
|
|
|
keymanagerApiError(status, InvalidAuthorizationError)
|
|
|
|
proc validateUri*(url: string): Result[Uri, cstring] =
|
|
let surl = parseUri(url)
|
|
if surl.scheme notin ["http", "https"]:
|
|
return err("Incorrect URL scheme")
|
|
if len(surl.hostname) == 0:
|
|
return err("Empty URL hostname")
|
|
ok(surl)
|
|
|
|
proc removeValidator(node: BeaconNode,
|
|
key: ValidatorPubKey): RemoteKeystoreStatus =
|
|
let res = removeValidator(node.attachedValidators[], node.config,
|
|
key, KeystoreKind.Remote)
|
|
if res.isOk:
|
|
case res.value()
|
|
of RemoveValidatorStatus.deleted:
|
|
return RemoteKeystoreStatus(status: KeystoreStatus.deleted)
|
|
of RemoveValidatorStatus.notFound:
|
|
return RemoteKeystoreStatus(status: KeystoreStatus.notFound)
|
|
else:
|
|
return RemoteKeystoreStatus(status: KeystoreStatus.error,
|
|
message: some($res.error()))
|
|
|
|
proc addRemoteValidator(node: BeaconNode,
|
|
keystore: RemoteKeystore): RequestItemStatus =
|
|
let res = importKeystore(node.attachedValidators[], node.config, keystore)
|
|
if res.isErr():
|
|
case res.error().status
|
|
of AddValidatorStatus.failed:
|
|
return RequestItemStatus(status: $KeystoreStatus.error,
|
|
message: $res.error().message)
|
|
of AddValidatorStatus.existingArtifacts:
|
|
return RequestItemStatus(status: $KeystoreStatus.duplicate)
|
|
else:
|
|
node.addRemoteValidators([res.get()])
|
|
return RequestItemStatus(status: $KeystoreStatus.imported)
|
|
|
|
proc installKeymanagerHandlers*(router: var RestRouter, node: BeaconNode) =
|
|
# https://ethereum.github.io/keymanager-APIs/#/Keymanager/ListKeys
|
|
router.api(MethodGet, "/api/eth/v1/keystores") do () -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let response = GetKeystoresResponse(data: listLocalValidators(node))
|
|
return RestApiResponse.jsonResponsePlain(response)
|
|
|
|
# https://ethereum.github.io/keymanager-APIs/#/Keymanager/ImportKeystores
|
|
router.api(MethodPost, "/api/eth/v1/keystores") do (
|
|
contentBody: Option[ContentBody]) -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let request =
|
|
block:
|
|
if contentBody.isNone():
|
|
return keymanagerApiError(Http404, EmptyRequestBodyError)
|
|
let dres = decodeBody(KeystoresAndSlashingProtection, contentBody.get())
|
|
if dres.isErr():
|
|
return keymanagerApiError(Http400, InvalidKeystoreObjects)
|
|
dres.get()
|
|
|
|
if request.slashing_protection.isSome():
|
|
let slashing_protection = request.slashing_protection.get()
|
|
let nodeSPDIR = toSPDIR(node.attachedValidators.slashingProtection)
|
|
if nodeSPDIR.metadata.genesis_validators_root.Eth2Digest !=
|
|
slashing_protection.metadata.genesis_validators_root.Eth2Digest:
|
|
return keymanagerApiError(Http400,
|
|
"The slashing protection database and imported file refer to " &
|
|
"different blockchains.")
|
|
let res = inclSPDIR(node.attachedValidators.slashingProtection,
|
|
slashing_protection)
|
|
if res == siFailure:
|
|
return keymanagerApiError(Http500,
|
|
"Internal server error; Failed to import slashing protection data")
|
|
|
|
var response: PostKeystoresResponse
|
|
|
|
for index, item in request.keystores:
|
|
let res = importKeystore(node.attachedValidators[], node.network.rng[],
|
|
node.config, item, request.passwords[index])
|
|
if res.isErr():
|
|
let failure = res.error()
|
|
case failure.status
|
|
of AddValidatorStatus.failed:
|
|
response.data.add(
|
|
RequestItemStatus(status: $KeystoreStatus.error,
|
|
message: failure.message))
|
|
of AddValidatorStatus.existingArtifacts:
|
|
response.data.add(
|
|
RequestItemStatus(status: $KeystoreStatus.duplicate))
|
|
else:
|
|
node.addLocalValidators([res.get()])
|
|
response.data.add(
|
|
RequestItemStatus(status: $KeystoreStatus.imported))
|
|
|
|
return RestApiResponse.jsonResponsePlain(response)
|
|
|
|
# https://ethereum.github.io/keymanager-APIs/#/Keymanager/DeleteKeys
|
|
router.api(MethodDelete, "/api/eth/v1/keystores") do (
|
|
contentBody: Option[ContentBody]) -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let keys =
|
|
block:
|
|
if contentBody.isNone():
|
|
return keymanagerApiError(Http404, EmptyRequestBodyError)
|
|
let dres = decodeBody(DeleteKeystoresBody, contentBody.get())
|
|
if dres.isErr():
|
|
return keymanagerApiError(Http400, InvalidValidatorPublicKey)
|
|
dres.get().pubkeys
|
|
|
|
var
|
|
response: DeleteKeystoresResponse
|
|
nodeSPDIR = toSPDIR(node.attachedValidators.slashingProtection)
|
|
# Hash table to keep the removal status of all keys form request
|
|
keysAndDeleteStatus = initTable[PubKeyBytes, RequestItemStatus]()
|
|
|
|
response.slashing_protection.metadata = nodeSPDIR.metadata
|
|
|
|
for index, key in keys:
|
|
let
|
|
res = removeValidator(node.attachedValidators[], node.config, key,
|
|
KeystoreKind.Local)
|
|
pubkey = key.blob.PubKey0x.PubKeyBytes
|
|
|
|
if res.isOk:
|
|
case res.value()
|
|
of RemoveValidatorStatus.deleted:
|
|
keysAndDeleteStatus[pubkey] =
|
|
RequestItemStatus(status: $KeystoreStatus.deleted)
|
|
|
|
# At first all keys with status missing directory after removal receive
|
|
# status 'not_found'
|
|
of RemoveValidatorStatus.notFound:
|
|
keysAndDeleteStatus[pubkey] =
|
|
RequestItemStatus(status: $KeystoreStatus.notFound)
|
|
else:
|
|
keysAndDeleteStatus[pubkey] =
|
|
RequestItemStatus(status: $KeystoreStatus.error,
|
|
message: $res.error())
|
|
|
|
# If we discover slashing protection data for a validator that was not
|
|
# found, this means the validator was active in the past, so we must
|
|
# respond with `not_active`:
|
|
for validator in nodeSPDIR.data:
|
|
keysAndDeleteStatus.withValue(validator.pubkey.PubKeyBytes, value) do:
|
|
response.slashing_protection.data.add(validator)
|
|
|
|
if value.status == $KeystoreStatus.notFound:
|
|
value.status = $KeystoreStatus.notActive
|
|
|
|
for index, key in keys:
|
|
response.data.add(keysAndDeleteStatus[key.blob.PubKey0x.PubKeyBytes])
|
|
|
|
return RestApiResponse.jsonResponsePlain(response)
|
|
|
|
# https://ethereum.github.io/keymanager-APIs/#/Remote%20Key%20Manager/ListRemoteKeys
|
|
router.api(MethodGet, "/api/eth/v1/remotekeys") do () -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let response = GetRemoteKeystoresResponse(data: listRemoteValidators(node))
|
|
return RestApiResponse.jsonResponsePlain(response)
|
|
|
|
# https://ethereum.github.io/keymanager-APIs/#/Remote%20Key%20Manager/ImportRemoteKeys
|
|
router.api(MethodPost, "/api/eth/v1/remotekeys") do (
|
|
contentBody: Option[ContentBody]) -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let keys =
|
|
block:
|
|
if contentBody.isNone():
|
|
return keymanagerApiError(Http404, EmptyRequestBodyError)
|
|
let dres = decodeBody(ImportRemoteKeystoresBody, contentBody.get())
|
|
if dres.isErr():
|
|
return keymanagerApiError(Http400, InvalidKeystoreObjects)
|
|
dres.get().remote_keys
|
|
|
|
var response: PostKeystoresResponse
|
|
|
|
for index, key in keys:
|
|
let
|
|
remoteInfo = RemoteSignerInfo(
|
|
url: key.url,
|
|
pubkey: key.pubkey,
|
|
id: 0)
|
|
keystore = RemoteKeystore(
|
|
version: 1'u64, remoteType: RemoteSignerType.Web3Signer,
|
|
pubkey: key.pubkey, remotes: @[remoteInfo])
|
|
status = node.addRemoteValidator(keystore)
|
|
|
|
response.data.add(status)
|
|
|
|
return RestApiResponse.jsonResponsePlain(response)
|
|
|
|
# https://ethereum.github.io/keymanager-APIs/#/Remote%20Key%20Manager/DeleteRemoteKeys
|
|
router.api(MethodDelete, "/api/eth/v1/remotekeys") do (
|
|
contentBody: Option[ContentBody]) -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let keys =
|
|
block:
|
|
if contentBody.isNone():
|
|
return keymanagerApiError(Http404, EmptyRequestBodyError)
|
|
let dres = decodeBody(DeleteKeystoresBody, contentBody.get())
|
|
if dres.isErr():
|
|
return keymanagerApiError(Http400, InvalidValidatorPublicKey)
|
|
dres.get().pubkeys
|
|
|
|
var response: DeleteRemoteKeystoresResponse
|
|
for index, key in keys:
|
|
let status = node.removeValidator(key)
|
|
response.data.add(status)
|
|
return RestApiResponse.jsonResponsePlain(response)
|
|
|
|
# https://ethereum.github.io/keymanager-APIs/#/Fee%20Recipient/ListFeeRecipient
|
|
router.api(MethodGet, "/api/eth/v1/validator/{pubkey}/feerecipient") do (
|
|
pubkey: ValidatorPubKey) -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let
|
|
pubkey = pubkey.valueOr:
|
|
return keymanagerApiError(Http400, InvalidValidatorPublicKey)
|
|
ethaddress = node.config.getSuggestedFeeRecipient(pubkey)
|
|
|
|
return if ethaddress.isOk:
|
|
RestApiResponse.jsonResponse(ListFeeRecipientResponse(
|
|
pubkey: pubkey,
|
|
ethaddress: ethaddress.get))
|
|
else:
|
|
case ethaddress.error
|
|
of noSuchValidator:
|
|
keymanagerApiError(Http404, "No matching validator found")
|
|
of invalidFeeRecipientFile:
|
|
keymanagerApiError(Http500, "Error reading fee recipient file")
|
|
|
|
# https://ethereum.github.io/keymanager-APIs/#/Fee%20Recipient/SetFeeRecipient
|
|
router.api(MethodPost, "/api/eth/v1/validator/{pubkey}/feerecipient") do (
|
|
pubkey: ValidatorPubKey,
|
|
contentBody: Option[ContentBody]) -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let
|
|
pubkey= pubkey.valueOr:
|
|
return keymanagerApiError(Http400, InvalidValidatorPublicKey)
|
|
feeRecipientReq =
|
|
block:
|
|
if contentBody.isNone():
|
|
return keymanagerApiError(Http400, InvalidFeeRecipientRequestError)
|
|
let dres = decodeBody(SetFeeRecipientRequest, contentBody.get())
|
|
if dres.isErr():
|
|
return keymanagerApiError(Http400, InvalidFeeRecipientRequestError)
|
|
dres.get()
|
|
|
|
status = node.config.setFeeRecipient(pubkey, feeRecipientReq.ethaddress)
|
|
|
|
return if status.isOk:
|
|
RestApiResponse.response("", Http202, "text/plain")
|
|
else:
|
|
keymanagerApiError(
|
|
Http500, "Failed to set fee recipient: " & status.error)
|
|
|
|
# https://ethereum.github.io/keymanager-APIs/#/Fee%20Recipient/DeleteFeeRecipient
|
|
router.api(MethodDelete, "/api/eth/v1/validator/{pubkey}/feerecipient") do (
|
|
pubkey: ValidatorPubKey) -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let
|
|
pubkey = pubkey.valueOr:
|
|
return keymanagerApiError(Http400, InvalidValidatorPublicKey)
|
|
res = removeFeeRecipientFile(node.config, pubkey)
|
|
|
|
return if res.isOk:
|
|
RestApiResponse.response("", Http204, "text/plain")
|
|
else:
|
|
keymanagerApiError(
|
|
Http500, "Failed to remove fee recipient file: " & res.error)
|
|
|
|
# TODO: These URLs will be changed once we submit a proposal for
|
|
# /api/eth/v2/remotekeys that supports distributed keys.
|
|
router.api(MethodGet, "/api/eth/v1/remotekeys/distributed") do () -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let response = GetDistributedKeystoresResponse(data: listRemoteDistributedValidators(node))
|
|
return RestApiResponse.jsonResponsePlain(response)
|
|
|
|
# TODO: These URLs will be changed once we submit a proposal for
|
|
# /api/eth/v2/remotekeys that supports distributed keys.
|
|
router.api(MethodPost, "/api/eth/v1/remotekeys/distributed") do (
|
|
contentBody: Option[ContentBody]) -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let keys =
|
|
block:
|
|
if contentBody.isNone():
|
|
return keymanagerApiError(Http404, EmptyRequestBodyError)
|
|
let dres = decodeBody(ImportDistributedKeystoresBody, contentBody.get())
|
|
if dres.isErr():
|
|
return keymanagerApiError(Http400, InvalidKeystoreObjects)
|
|
dres.get.remote_keys
|
|
|
|
var response: PostKeystoresResponse
|
|
|
|
for index, key in keys:
|
|
let keystore = RemoteKeystore(
|
|
version: 2'u64,
|
|
remoteType: RemoteSignerType.Web3Signer,
|
|
pubkey: key.pubkey,
|
|
remotes: key.remotes,
|
|
threshold: uint32 key.threshold
|
|
)
|
|
let status = node.addRemoteValidator(keystore)
|
|
response.data.add(status)
|
|
|
|
return RestApiResponse.jsonResponsePlain(response)
|
|
|
|
router.api(MethodDelete, "/api/eth/v1/remotekeys/distributed") do (
|
|
contentBody: Option[ContentBody]) -> RestApiResponse:
|
|
let authStatus = checkAuthorization(request, node)
|
|
if authStatus.isErr():
|
|
return authErrorResponse authStatus.error
|
|
let keys =
|
|
block:
|
|
if contentBody.isNone():
|
|
return keymanagerApiError(Http404, EmptyRequestBodyError)
|
|
let dres = decodeBody(DeleteKeystoresBody, contentBody.get())
|
|
if dres.isErr():
|
|
return keymanagerApiError(Http400, InvalidValidatorPublicKey)
|
|
dres.get.pubkeys
|
|
|
|
var response: DeleteRemoteKeystoresResponse
|
|
for index, key in keys:
|
|
let status = node.removeValidator(key)
|
|
response.data.add(status)
|
|
|
|
return RestApiResponse.jsonResponsePlain(response)
|
|
|
|
router.redirect(
|
|
MethodGet,
|
|
"/eth/v1/keystores",
|
|
"/api/eth/v1/keystores")
|
|
|
|
router.redirect(
|
|
MethodPost,
|
|
"/eth/v1/keystores",
|
|
"/api/eth/v1/keystores")
|
|
|
|
router.redirect(
|
|
MethodDelete,
|
|
"/eth/v1/keystores",
|
|
"/api/eth/v1/keystores")
|
|
|
|
router.redirect(
|
|
MethodGet,
|
|
"/eth/v1/remotekeys",
|
|
"/api/eth/v1/remotekeys")
|
|
|
|
router.redirect(
|
|
MethodPost,
|
|
"/eth/v1/remotekeys",
|
|
"/api/eth/v1/remotekeys")
|
|
|
|
router.redirect(
|
|
MethodDelete,
|
|
"/eth/v1/remotekeys",
|
|
"/api/eth/v1/remotekeys")
|
|
|
|
router.redirect(
|
|
MethodGet,
|
|
"/eth/v1/validator/{pubkey}/feerecipient",
|
|
"/api/eth/v1/validator/{pubkey}/feerecipient")
|
|
|
|
router.redirect(
|
|
MethodPost,
|
|
"/eth/v1/validator/{pubkey}/feerecipient",
|
|
"/api/eth/v1/validator/{pubkey}/feerecipient")
|
|
|
|
router.redirect(
|
|
MethodDelete,
|
|
"/eth/v1/validator/{pubkey}/feerecipient",
|
|
"/api/eth/v1/validator/{pubkey}/feerecipient")
|
|
|
|
router.redirect(
|
|
MethodGet,
|
|
"/eth/v1/remotekeys/distributed",
|
|
"/api/eth/v1/remotekeys/distributed")
|
|
|
|
router.redirect(
|
|
MethodPost,
|
|
"/eth/v1/remotekeys/distributed",
|
|
"/api/eth/v1/remotekeys/distributed")
|
|
|
|
router.redirect(
|
|
MethodDelete,
|
|
"/eth/v1/remotekeys/distributed",
|
|
"/api/eth/v1/remotekeys/distributed")
|