// Copyright 2021 Prysmatic Labs. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. syntax = "proto3"; package ethereum.eth.v2; import "proto/eth/ext/options.proto"; import "proto/prysm/v1alpha1/beacon_block.proto"; option csharp_namespace = "Ethereum.Eth.V2"; option go_package = "github.com/prysmaticlabs/prysm/proto/eth/v2;eth"; option java_multiple_files = true; option java_outer_classname = "ValidatorProto"; option java_package = "org.ethereum.eth.v2"; option php_namespace = "Ethereum\\Eth\\v2"; message SyncCommitteeDutiesRequest { // Must fulfill: epoch // EPOCHS_PER_SYNC_COMMITTEE_PERIOD <= current_epoch // EPOCHS_PER_SYNC_COMMITTEE_PERIOD + 1 uint64 epoch = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.Epoch"]; // Validator indices to request duties for. repeated uint64 index = 2 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.ValidatorIndex"]; } message SyncCommitteeDutiesResponse { repeated SyncCommitteeDuty data = 1; } message SyncCommitteeDuty { // The validator's BLS public key, uniquely identifying them. bytes pubkey = 1 [(ethereum.eth.ext.ssz_size) = "48"]; // Index of validator in validator registry. uint64 validator_index = 2 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.ValidatorIndex"]; // The indices of the validator in the sync committee. repeated uint64 sync_committee_indices = 3 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.ValidatorIndex"]; } message ProduceBlockRequest { // The slot to request a block for. uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.Slot"]; // The validators RANDAO reveal 96 byte value. bytes randao_reveal = 2 [(ethereum.eth.ext.ssz_size) = "96"]; // 32 byte field of arbitrary data. This field may contain any data and // is not used for anything other than a fun message. optional bytes graffiti = 3 [(ethereum.eth.ext.ssz_size) = "32"]; } message ProduceBlockResponse { v1alpha1.BeaconBlockAltair data = 1; } message SubmitSyncCommitteeSubscriptionsRequest { repeated SyncCommitteeSubscription data = 1; } message SyncCommitteeSubscription { // The validator index to subscribe for. uint64 validator_index = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.ValidatorIndex"]; // The sync committee indices to be subscribed to. repeated uint64 sync_committee_indices = 2 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.CommitteeIndex"]; // The final epoch that the specified validator requires the subscription for. uint64 until_epoch = 3 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.Epoch"]; } message ProduceSyncCommitteeContributionRequest { // The slot for which a sync committee contribution should be created. uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.Slot"]; // The subcommittee index for which to produce the contribution. uint64 subcommittee_index = 2; // The block root for which to produce the contribution. bytes beacon_block_root = 3 [(ethereum.eth.ext.ssz_size) = "32"]; } message ProduceSyncCommitteeContributionResponse { SyncCommitteeContribution data = 1; } // Aggregated sync committee object to support light client. message SyncCommitteeContribution { // Slot to which this contribution pertains. uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.Slot"]; // 32 byte block root for this signature. bytes beacon_block_root = 2 [(ethereum.eth.ext.ssz_size) = "32"]; // The subcommittee this contribution pertains to out of the broader sync committee. uint64 subcommittee_index = 3; // A bit is set if a signature from the validator at the corresponding // index in the subcommittee is present in the aggregate `signature`. bytes aggregation_bits = 4 [(ethereum.eth.ext.ssz_size) = "16", (ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/go-bitfield.Bitvector128"]; // Signature by the validator(s) over the block root of `slot`. bytes signature = 5 [(ethereum.eth.ext.ssz_size) = "96"]; } message SubmitContributionAndProofsRequest { SignedContributionAndProof message = 1; } // Aggregated sync committee signature object with selection proof to support light client. message ContributionAndProof { // Index of the aggregator that produced this proof. uint64 aggregator_index = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.ValidatorIndex"]; SyncCommitteeContribution contribution = 2; // The selection proof itself. bytes selection_proof = 3 [(ethereum.eth.ext.ssz_size) = "96"]; } // Signed aggregated sync committee signature object with selection proof to support light client. message SignedContributionAndProof { ContributionAndProof message = 1; // Signature of the aggregator that produced `message`. bytes signature = 4 [(ethereum.eth.ext.ssz_size) = "96"]; }