slasher

command

v1.0.0-alpha.9 Latest Latest Go to latest Published: May 28, 2020 License: GPL-3.0 Imports: 17 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

README ¶

Hash Slinging Slasher Server Implementation

This is the main project folder for a slasher server implementation for Ethereum Serenity in Golang by Prysmatic Labs. A slasher listens for all broadcasted messages using a running beacon node in order to detect slashable attestations and block proposals. It uses the min-max-surround method by Protolambda.

The slasher requires a connection to a synced beacon node in order to listen for attestations and block proposals. To run the slasher, type:

bazel run //slasher -- \
    --datadir PATH/FOR/DB \
    --span-map-cache \
    --beacon-rpc-provider localhost:4000

The beacon node entered in beacon-rpc-provider will then receive slashings from the slasher client and send them to any requesting proposer to be put into a block.

Documentation ¶

Overview ¶

Package main defines slasher server implementation for eth2. A slasher listens for all broadcasted messages using a running beacon node in order to detect malicious attestations and block proposals.

This code was adapted from https://github.com/ethereum/go-ethereum/blob/master/cmd/geth/usage.go

Source Files ¶

View all Source files

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
beaconclient Package beaconclient defines a service that interacts with a beacon node via a gRPC client to listen for streamed blocks, attestations, and to submit proposer/attester slashings to the node in case they are detected.	Package beaconclient defines a service that interacts with a beacon node via a gRPC client to listen for streamed blocks, attestations, and to submit proposer/attester slashings to the node in case they are detected.
cache Package cache contains critical caches necessary for the runtime of the slasher service, being able to keep attestation spans by epoch for the validators active in the beacon chain.	Package cache contains critical caches necessary for the runtime of the slasher service, being able to keep attestation spans by epoch for the validators active in the beacon chain.
db Package db defines a persistent backend for the slasher service.	Package db defines a persistent backend for the slasher service.
iface Package iface defines an interface for the slasher database, providing more advanced interfaces such as a ReadOnlyDatabase.	Package iface defines an interface for the slasher database, providing more advanced interfaces such as a ReadOnlyDatabase.
kv Package kv defines a bolt-db, key-value store implementation of the slasher database interface.	Package kv defines a bolt-db, key-value store implementation of the slasher database interface.
testing Package testing defines useful helper functions for unit tests with the slasher database.	Package testing defines useful helper functions for unit tests with the slasher database.
types Package types includes important database-related types for slasher-specific logic.	Package types includes important database-related types for slasher-specific logic.
detection Package detection defines a service that reacts to incoming blocks/attestations by running slashing detection for double proposals, double votes, and surround votes according to the eth2 specification.	Package detection defines a service that reacts to incoming blocks/attestations by running slashing detection for double proposals, double votes, and surround votes according to the eth2 specification.
attestations Package attestations defines an implementation of a slashable attestation detector using min-max surround vote checking.	Package attestations defines an implementation of a slashable attestation detector using min-max surround vote checking.
attestations/iface Package iface defines an interface for a slashable attestation detector struct.	Package iface defines an interface for a slashable attestation detector struct.
attestations/types Package types includes important type definitions for slashable objects detected by slasher.	Package types includes important type definitions for slashable objects detected by slasher.
proposals Package proposals defines an implementation of a double-propose detector in the slasher runtime.	Package proposals defines an implementation of a double-propose detector in the slasher runtime.
proposals/iface Package iface defines an interface for a double-proposal detector struct.	Package iface defines an interface for a double-proposal detector struct.
testing Package testing includes useful helpers for slasher-related unit tests.	Package testing includes useful helpers for slasher-related unit tests.
flags Package flags contains all configuration runtime flags for the slasher service.	Package flags contains all configuration runtime flags for the slasher service.
node Package node is the main process which handles the lifecycle of the runtime services in a slasher process, gracefully shutting everything down upon close.	Package node is the main process which handles the lifecycle of the runtime services in a slasher process, gracefully shutting everything down upon close.
rpc Package rpc defines an implementation of a gRPC slasher service, providing endpoints for determining whether or not a block/attestation is slashable based on slasher's evidence.	Package rpc defines an implementation of a gRPC slasher service, providing endpoints for determining whether or not a block/attestation is slashable based on slasher's evidence.