mirror of
https://gitlab.com/pulsechaincom/prysm-pulse.git
synced 2025-01-12 12:40:05 +00:00
e477fdfd6d
* Update rules_go and fix proto conflicts * gaz * Update generated code * First pass inclusion of using baked states * more emptypb fixes * remove testnet genesis files, only embed mainnet * Refactoring for SaveGenesisData, fix tests that use mainnet config but do not support mainnet genesis values * a bit more refactoring, load genesis from a file. Needs tests still * Add method to ensure an embedded genesis file also has the appropriate genesis block * gofmt * more clear error * Check genesis fork version to ensure testnet config matches genesis file * viz * test for SaveGenesisData * More genesis db method tests * Merge * Minor tweaks, lint, fmt, etc * Add more test to genesis db methods * Revert beacon-chain/state/stateV0/BUILD.bazel * Update beacon-chain/db/iface/errors.go Co-authored-by: Raul Jordan <raul@prysmaticlabs.com> * PR feedback * Update beacon-chain/db/kv/genesis.go Co-authored-by: terence tsao <terence@prysmaticlabs.com> * fmt.Errorf works better for nil errors Co-authored-by: Raul Jordan <raul@prysmaticlabs.com> Co-authored-by: terence tsao <terence@prysmaticlabs.com>
118 lines
5.5 KiB
Go
118 lines
5.5 KiB
Go
// Package iface defines the actual database interface used
|
|
// by a Prysm beacon node, also containing useful, scoped interfaces such as
|
|
// a ReadOnlyDatabase.
|
|
package iface
|
|
|
|
import (
|
|
"context"
|
|
"io"
|
|
|
|
"github.com/ethereum/go-ethereum/common"
|
|
types "github.com/prysmaticlabs/eth2-types"
|
|
eth "github.com/prysmaticlabs/ethereumapis/eth/v1alpha1"
|
|
"github.com/prysmaticlabs/prysm/beacon-chain/db/filters"
|
|
iface "github.com/prysmaticlabs/prysm/beacon-chain/state/interface"
|
|
"github.com/prysmaticlabs/prysm/proto/beacon/db"
|
|
ethereum_beacon_p2p_v1 "github.com/prysmaticlabs/prysm/proto/beacon/p2p/v1"
|
|
"github.com/prysmaticlabs/prysm/shared/backuputil"
|
|
)
|
|
|
|
// ReadOnlyDatabase defines a struct which only has read access to database methods.
|
|
type ReadOnlyDatabase interface {
|
|
// Block related methods.
|
|
Block(ctx context.Context, blockRoot [32]byte) (*eth.SignedBeaconBlock, error)
|
|
Blocks(ctx context.Context, f *filters.QueryFilter) ([]*eth.SignedBeaconBlock, [][32]byte, error)
|
|
BlockRoots(ctx context.Context, f *filters.QueryFilter) ([][32]byte, error)
|
|
BlocksBySlot(ctx context.Context, slot types.Slot) (bool, []*eth.SignedBeaconBlock, error)
|
|
BlockRootsBySlot(ctx context.Context, slot types.Slot) (bool, [][32]byte, error)
|
|
HasBlock(ctx context.Context, blockRoot [32]byte) bool
|
|
GenesisBlock(ctx context.Context) (*eth.SignedBeaconBlock, error)
|
|
IsFinalizedBlock(ctx context.Context, blockRoot [32]byte) bool
|
|
FinalizedChildBlock(ctx context.Context, blockRoot [32]byte) (*eth.SignedBeaconBlock, error)
|
|
HighestSlotBlocksBelow(ctx context.Context, slot types.Slot) ([]*eth.SignedBeaconBlock, error)
|
|
// State related methods.
|
|
State(ctx context.Context, blockRoot [32]byte) (iface.BeaconState, error)
|
|
GenesisState(ctx context.Context) (iface.BeaconState, error)
|
|
HasState(ctx context.Context, blockRoot [32]byte) bool
|
|
StateSummary(ctx context.Context, blockRoot [32]byte) (*ethereum_beacon_p2p_v1.StateSummary, error)
|
|
HasStateSummary(ctx context.Context, blockRoot [32]byte) bool
|
|
HighestSlotStatesBelow(ctx context.Context, slot types.Slot) ([]iface.ReadOnlyBeaconState, error)
|
|
// Slashing operations.
|
|
ProposerSlashing(ctx context.Context, slashingRoot [32]byte) (*eth.ProposerSlashing, error)
|
|
AttesterSlashing(ctx context.Context, slashingRoot [32]byte) (*eth.AttesterSlashing, error)
|
|
HasProposerSlashing(ctx context.Context, slashingRoot [32]byte) bool
|
|
HasAttesterSlashing(ctx context.Context, slashingRoot [32]byte) bool
|
|
// Block operations.
|
|
VoluntaryExit(ctx context.Context, exitRoot [32]byte) (*eth.VoluntaryExit, error)
|
|
HasVoluntaryExit(ctx context.Context, exitRoot [32]byte) bool
|
|
// Checkpoint operations.
|
|
JustifiedCheckpoint(ctx context.Context) (*eth.Checkpoint, error)
|
|
FinalizedCheckpoint(ctx context.Context) (*eth.Checkpoint, error)
|
|
ArchivedPointRoot(ctx context.Context, slot types.Slot) [32]byte
|
|
HasArchivedPoint(ctx context.Context, slot types.Slot) bool
|
|
LastArchivedRoot(ctx context.Context) [32]byte
|
|
LastArchivedSlot(ctx context.Context) (types.Slot, error)
|
|
// Deposit contract related handlers.
|
|
DepositContractAddress(ctx context.Context) ([]byte, error)
|
|
// Powchain operations.
|
|
PowchainData(ctx context.Context) (*db.ETH1ChainData, error)
|
|
}
|
|
|
|
// NoHeadAccessDatabase defines a struct without access to chain head data.
|
|
type NoHeadAccessDatabase interface {
|
|
ReadOnlyDatabase
|
|
|
|
// Block related methods.
|
|
SaveBlock(ctx context.Context, block *eth.SignedBeaconBlock) error
|
|
SaveBlocks(ctx context.Context, blocks []*eth.SignedBeaconBlock) error
|
|
SaveGenesisBlockRoot(ctx context.Context, blockRoot [32]byte) error
|
|
// State related methods.
|
|
SaveState(ctx context.Context, state iface.ReadOnlyBeaconState, blockRoot [32]byte) error
|
|
SaveStates(ctx context.Context, states []iface.ReadOnlyBeaconState, blockRoots [][32]byte) error
|
|
DeleteState(ctx context.Context, blockRoot [32]byte) error
|
|
DeleteStates(ctx context.Context, blockRoots [][32]byte) error
|
|
SaveStateSummary(ctx context.Context, summary *ethereum_beacon_p2p_v1.StateSummary) error
|
|
SaveStateSummaries(ctx context.Context, summaries []*ethereum_beacon_p2p_v1.StateSummary) error
|
|
// Slashing operations.
|
|
SaveProposerSlashing(ctx context.Context, slashing *eth.ProposerSlashing) error
|
|
SaveAttesterSlashing(ctx context.Context, slashing *eth.AttesterSlashing) error
|
|
// Block operations.
|
|
SaveVoluntaryExit(ctx context.Context, exit *eth.VoluntaryExit) error
|
|
// Checkpoint operations.
|
|
SaveJustifiedCheckpoint(ctx context.Context, checkpoint *eth.Checkpoint) error
|
|
SaveFinalizedCheckpoint(ctx context.Context, checkpoint *eth.Checkpoint) error
|
|
// Deposit contract related handlers.
|
|
SaveDepositContractAddress(ctx context.Context, addr common.Address) error
|
|
// Powchain operations.
|
|
SavePowchainData(ctx context.Context, data *db.ETH1ChainData) error
|
|
|
|
// Run any required database migrations.
|
|
RunMigrations(ctx context.Context) error
|
|
|
|
CleanUpDirtyStates(ctx context.Context, slotsPerArchivedPoint types.Slot) error
|
|
}
|
|
|
|
// HeadAccessDatabase defines a struct with access to reading chain head data.
|
|
type HeadAccessDatabase interface {
|
|
NoHeadAccessDatabase
|
|
|
|
// Block related methods.
|
|
HeadBlock(ctx context.Context) (*eth.SignedBeaconBlock, error)
|
|
SaveHeadBlockRoot(ctx context.Context, blockRoot [32]byte) error
|
|
|
|
// Genesis operations.
|
|
LoadGenesis(ctx context.Context, r io.Reader) error
|
|
SaveGenesisData(ctx context.Context, state iface.BeaconState) error
|
|
EnsureEmbeddedGenesis(ctx context.Context) error
|
|
}
|
|
|
|
// Database interface with full access.
|
|
type Database interface {
|
|
io.Closer
|
|
backuputil.BackupExporter
|
|
HeadAccessDatabase
|
|
|
|
DatabasePath() string
|
|
ClearDB() error
|
|
}
|