github.com/prysmaticlabs/prysm@v1.4.4/proto/prysm/v2/sync_committee.proto (about)

     1  // Copyright 2021 Prysmatic Labs.
     2  //
     3  // Licensed under the Apache License, Version 2.0 (the "License");
     4  // you may not use this file except in compliance with the License.
     5  // You may obtain a copy of the License at
     6  //
     7  //     http://www.apache.org/licenses/LICENSE-2.0
     8  //
     9  // Unless required by applicable law or agreed to in writing, software
    10  // distributed under the License is distributed on an "AS IS" BASIS,
    11  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    12  // See the License for the specific language governing permissions and
    13  // limitations under the License.
    14  syntax = "proto3";
    15  
    16  package ethereum.prysm.v2;
    17  
    18  import "proto/eth/ext/options.proto";
    19  
    20  option csharp_namespace = "Ethereum.Prysm.V2";
    21  option go_package = "github.com/prysmaticlabs/prysm/proto/prysm/v2;v2";
    22  option java_multiple_files = true;
    23  option java_outer_classname = "SyncCommitteeProto";
    24  option java_package = "org.ethereum.prysm.v2";
    25  option php_namespace = "Ethereum\\Prysm\\v2";
    26  
    27  // Sync committee object to support light client.
    28  message SyncCommitteeMessage {
    29    // Slot to which this contribution pertains.
    30    uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.Slot"];
    31  
    32    // 32 byte block root for this signature.
    33    bytes block_root = 2 [(ethereum.eth.ext.ssz_size) = "32"];
    34  
    35    // Index of the validator that produced this signature.
    36    uint64 validator_index = 3 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.ValidatorIndex"];
    37  
    38    // Signature by the validator over the block root of `slot`.
    39    bytes signature = 4 [(ethereum.eth.ext.ssz_size) = "96"];
    40  }
    41  
    42  // Aggregated sync committee object to support light client.
    43  message SyncCommitteeContribution {
    44    // Slot to which this contribution pertains.
    45    uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.Slot"];
    46  
    47    // 32 byte block root for this signature.
    48    bytes block_root = 2 [(ethereum.eth.ext.ssz_size) = "32"];
    49  
    50    // The subcommittee this contribution pertains to out of the broader sync committee.
    51    uint64 subcommittee_index = 3;
    52  
    53    // A bit is set if a signature from the validator at the corresponding
    54    // index in the subcommittee is present in the aggregate `signature`.
    55    bytes aggregation_bits = 4 [(ethereum.eth.ext.ssz_size) = "sync_committee_aggregate_bytes.size", (ethereum.eth.ext.cast_type) = "sync_committee_aggregate_bits.type"];
    56    // Signature by the validator(s) over the block root of `slot`.
    57    bytes signature = 5 [(ethereum.eth.ext.ssz_size) = "96"];
    58  }
    59  
    60  // Aggregated sync committee signature object with selection proof to support light client.
    61  message ContributionAndProof {
    62    // Index of the aggregator that produced this proof.
    63    uint64 aggregator_index = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/eth2-types.ValidatorIndex"];
    64  
    65    SyncCommitteeContribution contribution = 2;
    66  
    67    // The selection proof itself.
    68    bytes selection_proof = 3 [(ethereum.eth.ext.ssz_size) = "96"];
    69  }
    70  
    71  // Signed aggregated sync committee signature object with selection proof to support light client.
    72  message SignedContributionAndProof {
    73    ContributionAndProof message = 1;
    74  
    75    // Signature of the aggregator that produced `message`.
    76    bytes signature = 4 [(ethereum.eth.ext.ssz_size) = "96"];
    77  }