mirror of
https://gitlab.com/pulsechaincom/prysm-pulse.git
synced 2024-12-25 12:57:18 +00:00
98557e8f5e
* highest slashing attestation RPC endpoint * slasher mock fix * Update proto/slashing/slashing.proto Co-authored-by: Shay Zluf <thezluf@gmail.com> * comments + small fixes * PR review ctx comments and fixes Co-authored-by: Shay Zluf <thezluf@gmail.com>
78 lines
3.2 KiB
Protocol Buffer
78 lines
3.2 KiB
Protocol Buffer
syntax = "proto3";
|
|
|
|
package ethereum.slashing;
|
|
|
|
import "eth/v1alpha1/beacon_block.proto";
|
|
import "github.com/gogo/protobuf/gogoproto/gogo.proto";
|
|
|
|
// Slasher service API
|
|
//
|
|
// Slasher service provides an interface for validators and beacon chain server to query
|
|
// and subscribe for slashable events on the network as well as to make sure that the
|
|
// attestation or proposal they are going to submit to the network are not going to
|
|
// produce a slashable event.
|
|
service Slasher {
|
|
// Returns any found attester slashings if the passed in attestation conflicts with a validators history.
|
|
rpc IsSlashableAttestation(ethereum.eth.v1alpha1.IndexedAttestation) returns (AttesterSlashingResponse);
|
|
|
|
// Returns any found proposer slashings if the passed in proposal conflicts with a validators history.
|
|
rpc IsSlashableBlock(ethereum.eth.v1alpha1.SignedBeaconBlockHeader) returns (ProposerSlashingResponse);
|
|
|
|
// Returns if a given indexed attestation could be slashable when compared to the slashers history for the attesters.
|
|
// This function is read-only, and does not need the indexed attestation to be signed.
|
|
rpc IsSlashableAttestationNoUpdate(ethereum.eth.v1alpha1.IndexedAttestation) returns (Slashable);
|
|
|
|
// Returns if a given beacon block header could be slashable when compared to the slashers history for the proposer.
|
|
// This function is read-only, and does not need the beacon block header to be signed.
|
|
rpc IsSlashableBlockNoUpdate(ethereum.eth.v1alpha1.BeaconBlockHeader) returns (Slashable);
|
|
|
|
// Returns the highest source and target attestation for validator indexes that have been observed by the slasher.
|
|
rpc HighestAttestations(HighestAttestationRequest) returns (HighestAttestationResponse);
|
|
|
|
}
|
|
|
|
message HighestAttestationRequest {
|
|
repeated uint64 validator_ids = 1;
|
|
}
|
|
|
|
message HighestAttestationResponse {
|
|
repeated HighestAttestation attestations = 1;
|
|
}
|
|
|
|
message HighestAttestation {
|
|
uint64 validator_id = 1;
|
|
uint64 highest_source_epoch = 2;
|
|
uint64 highest_target_epoch = 3;
|
|
}
|
|
|
|
message ProposerSlashingResponse {
|
|
repeated ethereum.eth.v1alpha1.ProposerSlashing proposer_slashing = 1;
|
|
}
|
|
|
|
message Slashable {
|
|
bool slashable = 1;
|
|
}
|
|
|
|
message AttesterSlashingResponse {
|
|
repeated ethereum.eth.v1alpha1.AttesterSlashing attester_slashing = 1;
|
|
}
|
|
|
|
// ProposalHistory defines the structure for recording a validator's historical proposals.
|
|
// Using a bitlist to represent the epochs and an uint64 to mark the latest marked
|
|
// epoch of the bitlist, we can easily store which epochs a validator has proposed
|
|
// a block for while pruning the older data.
|
|
message ProposalHistory {
|
|
bytes epoch_bits = 1 [(gogoproto.casttype) = "github.com/prysmaticlabs/go-bitfield.Bitlist"];
|
|
uint64 latest_epoch_written = 2;
|
|
}
|
|
|
|
// AttestationHistory defines the structure for recording a validator's historical attestation.
|
|
// Using a map[uint64]uint64 to map its target epoch to its source epoch, in order to detect if a
|
|
// vote being created is not a double vote and surrounded by, or surrounding any other votes.
|
|
// Using an uint64 to mark the latest written epoch, we can safely perform a rolling prune whenever
|
|
// the history is updated.
|
|
message AttestationHistory {
|
|
map<uint64, uint64> target_to_source = 1;
|
|
uint64 latest_epoch_written = 2;
|
|
}
|