db

Documentation

Overview

Package db defines a persistent backend for the validator service.

Index

• func Merge(ctx context.Context, sourceStores []*Store, targetDirectory string) error
• func Split(ctx context.Context, sourceStore *Store, targetDirectory string) error
• func TempDir() string
• type Store
  • func GetKVStore(directory string) (*Store, error)
  • func NewKVStore(dirPath string, pubKeys [][48]byte) (*Store, error)
  • func SetupDB(t testing.TB, pubkeys [][48]byte) *Store
  • func (db *Store) AttestationHistoryForPubKeys(ctx context.Context, publicKeys [][48]byte) (map[[48]byte]*slashpb.AttestationHistory, error)
  • func (db *Store) ClearDB() error
  • func (db *Store) Close() error
  • func (db *Store) DatabasePath() string
  • func (db *Store) DeleteAttestationHistory(ctx context.Context, pubkey []byte) error
  • func (db *Store) DeleteProposalHistory(ctx context.Context, pubkey []byte) error
  • func (db *Store) ProposalHistoryForEpoch(ctx context.Context, publicKey []byte, epoch uint64) (bitfield.Bitlist, error)
  • func (db *Store) SaveAttestationHistoryForPubKeys(ctx context.Context, historyByPubKeys map[[48]byte]*slashpb.AttestationHistory) error
  • func (db *Store) SaveProposalHistoryForEpoch(ctx context.Context, pubKey []byte, epoch uint64, slotBits bitfield.Bitlist) error
  • func (db *Store) Size() (int64, error)

Functions

func Merge

func Merge(ctx context.Context, sourceStores []*Store, targetDirectory string) error

Merge merges data from sourceStores into a new store, which is created in targetDirectory.

func Split

func Split(ctx context.Context, sourceStore *Store, targetDirectory string) error

Split splits data from sourceStore into several stores, one for each public key in sourceStore. Each new store is created in its own subdirectory inside targetDirectory.

func TempDir

func TempDir() string

TempDir returns a directory path for temporary test storage.

Types

type Store

type Store struct {
	// contains filtered or unexported fields
}

Store defines an implementation of the Prysm Database interface using BoltDB as the underlying persistent kv-store for eth2.

func GetKVStore

func GetKVStore(directory string) (*Store, error)

GetKVStore returns the validator boltDB key-value store from directory. Returns nil if no such store exists.

func NewKVStore

func NewKVStore(dirPath string, pubKeys [][48]byte) (*Store, error)

NewKVStore initializes a new boltDB key-value store at the directory path specified, creates the kv-buckets based on the schema, and stores an open connection db object as a property of the Store struct.

func SetupDB

func SetupDB(t testing.TB, pubkeys [][48]byte) *Store

SetupDB instantiates and returns a DB instance for the validator client.

func (*Store) AttestationHistoryForPubKeys

func (db *Store) AttestationHistoryForPubKeys(ctx context.Context, publicKeys [][48]byte) (map[[48]byte]*slashpb.AttestationHistory, error)

AttestationHistoryForPubKeys accepts an array of validator public keys and returns a mapping of corresponding attestation history.

func (*Store) ClearDB

func (db *Store) ClearDB() error

ClearDB removes any previously stored data at the configured data directory.

func (*Store) Close

func (db *Store) Close() error

Close closes the underlying boltdb database.

func (*Store) DatabasePath

func (db *Store) DatabasePath() string

DatabasePath at which this database writes files.

func (*Store) DeleteAttestationHistory

func (db *Store) DeleteAttestationHistory(ctx context.Context, pubkey []byte) error

DeleteAttestationHistory deletes the attestation history for the corresponding validator public key.

func (*Store) DeleteProposalHistory

func (db *Store) DeleteProposalHistory(ctx context.Context, pubkey []byte) error

DeleteProposalHistory deletes the proposal history for the corresponding validator public key.

func (*Store) ProposalHistoryForEpoch

func (db *Store) ProposalHistoryForEpoch(ctx context.Context, publicKey []byte, epoch uint64) (bitfield.Bitlist, error)

ProposalHistoryForEpoch accepts a validator public key and returns the corresponding proposal history. Returns nil if there is no proposal history for the validator.

func (*Store) SaveAttestationHistoryForPubKeys

func (db *Store) SaveAttestationHistoryForPubKeys(ctx context.Context, historyByPubKeys map[[48]byte]*slashpb.AttestationHistory) error

SaveAttestationHistoryForPubKeys saves the attestation histories for the requested validator public keys.

func (*Store) SaveProposalHistoryForEpoch

func (db *Store) SaveProposalHistoryForEpoch(ctx context.Context, pubKey []byte, epoch uint64, slotBits bitfield.Bitlist) error

SaveProposalHistoryForEpoch saves the proposal history for the requested validator public key.

func (*Store) Size

func (db *Store) Size() (int64, error)

Size returns the db size in bytes.