storage

Documentation

Index

• type EventData
• type Events
  • func NewEventsStorage(db basedb.IDb, prefix []byte) Events
• type GetOperatorData
• type Nonce
• type OperatorData
• type Operators
  • func NewOperatorsStorage(db basedb.IDb, prefix []byte) Operators
• type RecipientData
• type Recipients
  • func NewRecipientsStorage(db basedb.IDb, prefix []byte) Recipients
• type Shares
  • func NewSharesStorage(logger *zap.Logger, db basedb.IDb, prefix []byte) (Shares, error)
• type SharesFilter
  • func ByActiveValidator() SharesFilter
  • func ByClusterID(clusterID []byte) SharesFilter
  • func ByNotLiquidated() SharesFilter
  • func ByOperatorID(operatorID spectypes.OperatorID) SharesFilter
• type SharesListFunc

Types

type EventData

type EventData struct {
	TxHash common.Hash `json:"txHash"`
}

EventData the public data of an event

type Events

type Events interface {
	GetEventData(txHash common.Hash) (*EventData, bool, error)
	SaveEventData(txHash common.Hash) error
	GetEventsPrefix() []byte
}

Events is the interface for managing events data

func NewEventsStorage

func NewEventsStorage(db basedb.IDb, prefix []byte) Events

NewEventsStorage creates a new instance of Storage

type GetOperatorData

type GetOperatorData = func(index uint64) (*OperatorData, bool, error)

GetOperatorData is a function that returns the operator data

type Nonce

type Nonce uint16

type OperatorData

type OperatorData struct {
	ID           spectypes.OperatorID `json:"id"`
	PublicKey    []byte               `json:"publicKey"`
	OwnerAddress common.Address       `json:"ownerAddress"`
}

OperatorData the public data of an operator

type Operators

type Operators interface {
	GetOperatorDataByPubKey(logger *zap.Logger, operatorPubKey []byte) (*OperatorData, bool, error)
	GetOperatorData(id spectypes.OperatorID) (*OperatorData, bool, error)
	SaveOperatorData(logger *zap.Logger, operatorData *OperatorData) (bool, error)
	DeleteOperatorData(id spectypes.OperatorID) error
	ListOperators(logger *zap.Logger, from uint64, to uint64) ([]OperatorData, error)
	GetOperatorsPrefix() []byte
}

Operators is the interface for managing operators data

func NewOperatorsStorage

func NewOperatorsStorage(db basedb.IDb, prefix []byte) Operators

NewOperatorsStorage creates a new instance of Storage

type RecipientData

type RecipientData struct {
	Owner        common.Address             `json:"ownerAddress"`
	FeeRecipient bellatrix.ExecutionAddress `json:"feeRecipientAddress"`

	// Nonce: This field represents the 'ValidatorAdded Event' nonce.
	// It serves a crucial role in protecting against replay attacks.
	// Each time a new validator added event is triggered, regardless of whether the event is malformed or not,
	// we increment this nonce by 1.
	// ** The Nonce field can be nil because the 'FeeRecipientAddressUpdatedEvent'
	// might occur before the addition of a validator to the network, and this event does not increment the nonce.
	Nonce *Nonce `json:"nonce"`
}

RecipientData the public data of a recipient

type Recipients

type Recipients interface {
	GetRecipientData(owner common.Address) (*RecipientData, bool, error)
	GetRecipientDataMany(logger *zap.Logger, owners []common.Address) (map[common.Address]bellatrix.ExecutionAddress, error)
	GetNextNonce(owner common.Address) (Nonce, error)
	BumpNonce(owner common.Address) error
	SaveRecipientData(recipientData *RecipientData) (*RecipientData, error)
	DeleteRecipientData(owner common.Address) error
	GetRecipientsPrefix() []byte
}

Recipients is the interface for managing recipients data

func NewRecipientsStorage

func NewRecipientsStorage(db basedb.IDb, prefix []byte) Recipients

NewRecipientsStorage creates a new instance of Storage

type Shares

type Shares interface {
	eth1.RegistryStore

	// Get returns the share for the given public key, or nil if not found.
	Get(pubKey []byte) *types.SSVShare

	// List returns a list of shares, filtered by the given filters (if any).
	List(filters ...SharesFilter) []*types.SSVShare

	// Save saves the given shares.
	Save(shares ...*types.SSVShare) error

	// Delete deletes the share for the given public key.
	Delete(pubKey []byte) error
}

Shares is the interface for managing shares.

func NewSharesStorage

func NewSharesStorage(logger *zap.Logger, db basedb.IDb, prefix []byte) (Shares, error)

type SharesFilter

type SharesFilter func(*types.SSVShare) bool

SharesFilter is a function that filters shares.

func ByActiveValidator

func ByActiveValidator() SharesFilter

ByActiveValidator filters for active validators.

func ByClusterID

func ByClusterID(clusterID []byte) SharesFilter

ByClusterID filters by cluster id.

func ByNotLiquidated

func ByNotLiquidated() SharesFilter

ByNotLiquidated filters for not liquidated.

func ByOperatorID

func ByOperatorID(operatorID spectypes.OperatorID) SharesFilter

ByOperatorID filters by operator ID.

type SharesListFunc

type SharesListFunc = func(filters ...SharesFilter) []*types.SSVShare

SharesListFunc is a function that returns a filtered list of shares.