package client // Validator client proposer functions. import ( "context" "fmt" "time" "github.com/pkg/errors" types "github.com/prysmaticlabs/eth2-types" "github.com/prysmaticlabs/prysm/async" "github.com/prysmaticlabs/prysm/beacon-chain/core/signing" fieldparams "github.com/prysmaticlabs/prysm/config/fieldparams" "github.com/prysmaticlabs/prysm/config/params" "github.com/prysmaticlabs/prysm/crypto/bls" "github.com/prysmaticlabs/prysm/crypto/rand" "github.com/prysmaticlabs/prysm/encoding/bytesutil" ethpb "github.com/prysmaticlabs/prysm/proto/prysm/v1alpha1" "github.com/prysmaticlabs/prysm/proto/prysm/v1alpha1/block" validatorpb "github.com/prysmaticlabs/prysm/proto/prysm/v1alpha1/validator-client" "github.com/prysmaticlabs/prysm/proto/prysm/v1alpha1/wrapper" "github.com/prysmaticlabs/prysm/runtime/version" prysmTime "github.com/prysmaticlabs/prysm/time" "github.com/prysmaticlabs/prysm/validator/client/iface" "github.com/sirupsen/logrus" "go.opencensus.io/trace" "google.golang.org/protobuf/types/known/emptypb" ) type signingFunc func(context.Context, *validatorpb.SignRequest) (bls.Signature, error) const domainDataErr = "could not get domain data" const signingRootErr = "could not get signing root" const signExitErr = "could not sign voluntary exit proposal" // ProposeBlock proposes a new beacon block for a given slot. This method collects the // previous beacon block, any pending deposits, and ETH1 data from the beacon // chain node to construct the new block. The new block is then processed with // the state root computation, and finally signed by the validator before being // sent back to the beacon node for broadcasting. func (v *validator) ProposeBlock(ctx context.Context, slot types.Slot, pubKey [fieldparams.BLSPubkeyLength]byte) { if slot == 0 { log.Debug("Assigned to genesis slot, skipping proposal") return } ctx, span := trace.StartSpan(ctx, "validator.ProposeBlock") defer span.End() lock := async.NewMultilock(fmt.Sprint(iface.RoleProposer), string(pubKey[:])) lock.Lock() defer lock.Unlock() fmtKey := fmt.Sprintf("%#x", pubKey[:]) span.AddAttributes(trace.StringAttribute("validator", fmtKey)) log := log.WithField("pubKey", fmt.Sprintf("%#x", bytesutil.Trunc(pubKey[:]))) // Sign randao reveal, it's used to request block from beacon node epoch := types.Epoch(slot / params.BeaconConfig().SlotsPerEpoch) randaoReveal, err := v.signRandaoReveal(ctx, pubKey, epoch, slot) if err != nil { log.WithError(err).Error("Failed to sign randao reveal") if v.emitAccountMetrics { ValidatorProposeFailVec.WithLabelValues(fmtKey).Inc() } return } g, err := v.getGraffiti(ctx, pubKey) if err != nil { // Graffiti is not a critical enough to fail block production and cause // validator to miss block reward. When failed, validator should continue // to produce the block. log.WithError(err).Warn("Could not get graffiti") } // Request block from beacon node b, err := v.validatorClient.GetBeaconBlock(ctx, ðpb.BlockRequest{ Slot: slot, RandaoReveal: randaoReveal, Graffiti: g, }) if err != nil { log.WithField("blockSlot", slot).WithError(err).Error("Failed to request block from beacon node") if v.emitAccountMetrics { ValidatorProposeFailVec.WithLabelValues(fmtKey).Inc() } return } // Sign returned block from beacon node wb, err := wrapper.WrappedBeaconBlock(b.Block) if err != nil { log.WithError(err).Error("Failed to wrap block") if v.emitAccountMetrics { ValidatorProposeFailVec.WithLabelValues(fmtKey).Inc() } return } sig, signingRoot, err := v.signBlock(ctx, pubKey, epoch, slot, wb) if err != nil { log.WithError(err).Error("Failed to sign block") if v.emitAccountMetrics { ValidatorProposeFailVec.WithLabelValues(fmtKey).Inc() } return } blk, err := wrapper.BuildSignedBeaconBlock(wb, sig) if err != nil { log.WithError(err).Error("Failed to build signed beacon block") return } if err := v.slashableProposalCheck(ctx, pubKey, blk, signingRoot); err != nil { log.WithFields( blockLogFields(pubKey, wb, nil), ).WithError(err).Error("Failed block slashing protection check") if v.emitAccountMetrics { ValidatorProposeFailVec.WithLabelValues(fmtKey).Inc() } return } // Propose and broadcast block via beacon node proposal, err := blk.PbGenericBlock() if err != nil { log.WithError(err).Error("Failed to create proposal request") if v.emitAccountMetrics { ValidatorProposeFailVec.WithLabelValues(fmtKey).Inc() } return } blkResp, err := v.validatorClient.ProposeBeaconBlock(ctx, proposal) if err != nil { log.WithError(err).Error("Failed to propose block") if v.emitAccountMetrics { ValidatorProposeFailVec.WithLabelValues(fmtKey).Inc() } return } span.AddAttributes( trace.StringAttribute("blockRoot", fmt.Sprintf("%#x", blkResp.BlockRoot)), trace.Int64Attribute("numDeposits", int64(len(blk.Block().Body().Deposits()))), trace.Int64Attribute("numAttestations", int64(len(blk.Block().Body().Attestations()))), ) if blk.Version() == version.Bellatrix { p, err := blk.Block().Body().ExecutionPayload() if err != nil { log.WithError(err).Error("Failed to get execution payload") return } log = log.WithField("payloadHash", fmt.Sprintf("%#x", bytesutil.Trunc(p.BlockHash))) log = log.WithField("txCount", len(p.Transactions)) } blkRoot := fmt.Sprintf("%#x", bytesutil.Trunc(blkResp.BlockRoot)) log.WithFields(logrus.Fields{ "slot": blk.Block().Slot(), "blockRoot": blkRoot, "numAttestations": len(blk.Block().Body().Attestations()), "numDeposits": len(blk.Block().Body().Deposits()), "graffiti": string(blk.Block().Body().Graffiti()), "fork": version.String(blk.Block().Version()), }).Info("Submitted new block") if v.emitAccountMetrics { ValidatorProposeSuccessVec.WithLabelValues(fmtKey).Inc() } } // ProposeExit performs a voluntary exit on a validator. // The exit is signed by the validator before being sent to the beacon node for broadcasting. func ProposeExit( ctx context.Context, validatorClient ethpb.BeaconNodeValidatorClient, nodeClient ethpb.NodeClient, signer signingFunc, pubKey []byte, ) error { ctx, span := trace.StartSpan(ctx, "validator.ProposeExit") defer span.End() indexResponse, err := validatorClient.ValidatorIndex(ctx, ðpb.ValidatorIndexRequest{PublicKey: pubKey}) if err != nil { return errors.Wrap(err, "gRPC call to get validator index failed") } genesisResponse, err := nodeClient.GetGenesis(ctx, &emptypb.Empty{}) if err != nil { return errors.Wrap(err, "gRPC call to get genesis time failed") } totalSecondsPassed := prysmTime.Now().Unix() - genesisResponse.GenesisTime.Seconds currentEpoch := types.Epoch(uint64(totalSecondsPassed) / uint64(params.BeaconConfig().SlotsPerEpoch.Mul(params.BeaconConfig().SecondsPerSlot))) exit := ðpb.VoluntaryExit{Epoch: currentEpoch, ValidatorIndex: indexResponse.Index} sig, err := signVoluntaryExit(ctx, validatorClient, signer, pubKey, exit) if err != nil { return errors.Wrap(err, "failed to sign voluntary exit") } signedExit := ðpb.SignedVoluntaryExit{Exit: exit, Signature: sig} exitResp, err := validatorClient.ProposeExit(ctx, signedExit) if err != nil { return errors.Wrap(err, "failed to propose voluntary exit") } span.AddAttributes( trace.StringAttribute("exitRoot", fmt.Sprintf("%#x", exitResp.ExitRoot)), ) return nil } // Sign randao reveal with randao domain and private key. func (v *validator) signRandaoReveal(ctx context.Context, pubKey [fieldparams.BLSPubkeyLength]byte, epoch types.Epoch, slot types.Slot) ([]byte, error) { domain, err := v.domainData(ctx, epoch, params.BeaconConfig().DomainRandao[:]) if err != nil { return nil, errors.Wrap(err, domainDataErr) } if domain == nil { return nil, errors.New(domainDataErr) } var randaoReveal bls.Signature sszUint := types.SSZUint64(epoch) root, err := signing.ComputeSigningRoot(&sszUint, domain.SignatureDomain) if err != nil { return nil, err } randaoReveal, err = v.keyManager.Sign(ctx, &validatorpb.SignRequest{ PublicKey: pubKey[:], SigningRoot: root[:], SignatureDomain: domain.SignatureDomain, Object: &validatorpb.SignRequest_Epoch{Epoch: epoch}, SigningSlot: slot, }) if err != nil { return nil, err } return randaoReveal.Marshal(), nil } // Sign block with proposer domain and private key. // Returns the signature, block signing root, and any error. func (v *validator) signBlock(ctx context.Context, pubKey [fieldparams.BLSPubkeyLength]byte, epoch types.Epoch, slot types.Slot, b block.BeaconBlock) ([]byte, [32]byte, error) { domain, err := v.domainData(ctx, epoch, params.BeaconConfig().DomainBeaconProposer[:]) if err != nil { return nil, [32]byte{}, errors.Wrap(err, domainDataErr) } if domain == nil { return nil, [32]byte{}, errors.New(domainDataErr) } blockRoot, err := signing.ComputeSigningRoot(b, domain.SignatureDomain) if err != nil { return nil, [32]byte{}, errors.Wrap(err, signingRootErr) } sig, err := v.keyManager.Sign(ctx, &validatorpb.SignRequest{ PublicKey: pubKey[:], SigningRoot: blockRoot[:], SignatureDomain: domain.SignatureDomain, Object: b.AsSignRequestObject(), SigningSlot: slot, }) if err != nil { return nil, [32]byte{}, errors.Wrap(err, "could not sign block proposal") } return sig.Marshal(), blockRoot, nil } // Sign voluntary exit with proposer domain and private key. func signVoluntaryExit( ctx context.Context, validatorClient ethpb.BeaconNodeValidatorClient, signer signingFunc, pubKey []byte, exit *ethpb.VoluntaryExit, ) ([]byte, error) { req := ðpb.DomainRequest{ Epoch: exit.Epoch, Domain: params.BeaconConfig().DomainVoluntaryExit[:], } domain, err := validatorClient.DomainData(ctx, req) if err != nil { return nil, errors.Wrap(err, domainDataErr) } if domain == nil { return nil, errors.New(domainDataErr) } exitRoot, err := signing.ComputeSigningRoot(exit, domain.SignatureDomain) if err != nil { return nil, errors.Wrap(err, signingRootErr) } sig, err := signer(ctx, &validatorpb.SignRequest{ PublicKey: pubKey, SigningRoot: exitRoot[:], SignatureDomain: domain.SignatureDomain, Object: &validatorpb.SignRequest_Exit{Exit: exit}, }) if err != nil { return nil, errors.Wrap(err, signExitErr) } return sig.Marshal(), nil } // Gets the graffiti from cli or file for the validator public key. func (v *validator) getGraffiti(ctx context.Context, pubKey [fieldparams.BLSPubkeyLength]byte) ([]byte, error) { // When specified, default graffiti from the command line takes the first priority. if len(v.graffiti) != 0 { return v.graffiti, nil } if v.graffitiStruct == nil { return nil, errors.New("graffitiStruct can't be nil") } // When specified, individual validator specified graffiti takes the second priority. idx, err := v.validatorClient.ValidatorIndex(ctx, ðpb.ValidatorIndexRequest{PublicKey: pubKey[:]}) if err != nil { return []byte{}, err } g, ok := v.graffitiStruct.Specific[idx.Index] if ok { return []byte(g), nil } // When specified, a graffiti from the ordered list in the file take third priority. if v.graffitiOrderedIndex < uint64(len(v.graffitiStruct.Ordered)) { graffiti := v.graffitiStruct.Ordered[v.graffitiOrderedIndex] v.graffitiOrderedIndex = v.graffitiOrderedIndex + 1 err := v.db.SaveGraffitiOrderedIndex(ctx, v.graffitiOrderedIndex) if err != nil { return nil, errors.Wrap(err, "failed to update graffiti ordered index") } return []byte(graffiti), nil } // When specified, a graffiti from the random list in the file take fourth priority. if len(v.graffitiStruct.Random) != 0 { r := rand.NewGenerator() r.Seed(time.Now().Unix()) i := r.Uint64() % uint64(len(v.graffitiStruct.Random)) return []byte(v.graffitiStruct.Random[i]), nil } // Finally, default graffiti if specified in the file will be used. if v.graffitiStruct.Default != "" { return []byte(v.graffitiStruct.Default), nil } return []byte{}, nil }