multi

package
v0.16.3-pacth Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 3, 2023 License: Apache-2.0 Imports: 19 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func New 

func New(ctx context.Context, params ...Parameter) (consensusclient.Service, error)

New creates a new Ethereum 2 client with multiple endpoints. The endpoints are periodiclaly checked to see if they are active, and requests will retry a different client if the currently active client fails to respond.

Types

type Parameter 

type Parameter interface {
	// contains filtered or unexported methods
}

Parameter is the interface for service parameters.

func WithAddresses 

func WithAddresses(addresses []string) Parameter

WithAddresses sets the addresses of clients to add to the multi list.

func WithClients 

func WithClients(clients []consensusclient.Service) Parameter

WithClients sets the pre-existing clients to add to the multi list.

func WithLogLevel 

func WithLogLevel(logLevel zerolog.Level) Parameter

WithLogLevel sets the log level for the module.

func WithMonitor 

func WithMonitor(monitor metrics.Service) Parameter

WithMonitor sets the monitor for the service.

func WithTimeout 

func WithTimeout(timeout time.Duration) Parameter

WithTimeout sets the timeout for client requests.

type Service 

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

Service handles multiple Ethereum 2 clients.

func (*Service) Address 

func (s *Service) Address() string

Address returns the address of the client.

func (*Service) AggregateAttestation 

func (s *Service) AggregateAttestation(ctx context.Context,
	slot phase0.Slot,
	attestationDataRoot phase0.Root,
) (
	*phase0.Attestation,
	error,
)

AggregateAttestation fetches the aggregate attestation given an attestation.

func (*Service) AttestationData 

func (s *Service) AttestationData(ctx context.Context,
	slot phase0.Slot,
	committeeIndex phase0.CommitteeIndex,
) (
	*phase0.AttestationData,
	error,
)

AttestationData fetches the attestation data for the given slot and committee index.

func (*Service) AttestationPool 

func (s *Service) AttestationPool(ctx context.Context, slot phase0.Slot) ([]*phase0.Attestation, error)

AttestationPool obtains the attestation pool for a given slot.

func (*Service) AttesterDuties 

func (s *Service) AttesterDuties(ctx context.Context,
	epoch phase0.Epoch,
	validatorIndices []phase0.ValidatorIndex,
) (
	[]*api.AttesterDuty,
	error,
)

AttesterDuties obtains attester duties. If validatorIndicess is nil it will return all duties for the given epoch.

func (*Service) BeaconBlockHeader 

func (s *Service) BeaconBlockHeader(ctx context.Context, blockID string) (*api.BeaconBlockHeader, error)

BeaconBlockHeader provides the block header of a given block ID.

func (*Service) BeaconBlockProposal 

func (s *Service) BeaconBlockProposal(ctx context.Context,
	slot phase0.Slot,
	randaoReveal phase0.BLSSignature,
	graffiti []byte,
) (
	*spec.VersionedBeaconBlock,
	error,
)

BeaconBlockProposal fetches a proposed beacon block for signing.

func (*Service) BeaconBlockRoot 

func (s *Service) BeaconBlockRoot(ctx context.Context, blockID string) (*phase0.Root, error)

BeaconBlockRoot fetches a block's root given a block ID.

func (*Service) BeaconCommittees 

func (s *Service) BeaconCommittees(ctx context.Context, stateID string) ([]*api.BeaconCommittee, error)

BeaconCommittees fetches all beacon committees for the epoch at the given state.

func (*Service) BeaconCommitteesAtEpoch 

func (s *Service) BeaconCommitteesAtEpoch(ctx context.Context, stateID string, epoch phase0.Epoch) ([]*api.BeaconCommittee, error)

BeaconCommitteesAtEpoch fetches all beacon committees for the given epoch at the given state.

func (*Service) BeaconState 

func (s *Service) BeaconState(ctx context.Context, stateID string) (*spec.VersionedBeaconState, error)

BeaconState fetches a beacon state. N.B if the requested beacon state is not available this will return nil without an error.

func (*Service) BeaconStateRoot 

func (s *Service) BeaconStateRoot(ctx context.Context, stateID string) (*phase0.Root, error)

BeaconStateRoot fetches a beacon state root given a state ID.

func (*Service) BlindedBeaconBlockProposal 

func (s *Service) BlindedBeaconBlockProposal(ctx context.Context,
	slot phase0.Slot,
	randaoReveal phase0.BLSSignature,
	graffiti []byte,
) (
	*api.VersionedBlindedBeaconBlock,
	error,
)

BlindedBeaconBlockProposal fetches a proposed blinded beacon block for signing.

func (*Service) DepositContract 

func (s *Service) DepositContract(ctx context.Context) (*api.DepositContract, error)

DepositContract provides details of the Ethereum 1 deposit contract for the chain.

func (*Service) Domain 

func (s *Service) Domain(ctx context.Context,
	domainType phase0.DomainType,
	epoch phase0.Epoch,
) (
	phase0.Domain,
	error,
)

Domain provides a domain for a given domain type at a given epoch.

func (*Service) Events 

func (s *Service) Events(ctx context.Context,
	topics []string,
	handler consensusclient.EventHandlerFunc,
) error

Events feeds requested events with the given topics to the supplied handler.

func (*Service) FarFutureEpoch 

func (s *Service) FarFutureEpoch(ctx context.Context) (phase0.Epoch, error)

FarFutureEpoch provides the far future epoch of the chain.

func (*Service) Finality 

func (s *Service) Finality(ctx context.Context, stateID string) (*api.Finality, error)

Finality provides the finality given a state ID.

func (*Service) Fork 

func (s *Service) Fork(ctx context.Context, stateID string) (*phase0.Fork, error)

Fork fetches fork information for the given state.

func (*Service) ForkSchedule 

func (s *Service) ForkSchedule(ctx context.Context) ([]*phase0.Fork, error)

ForkSchedule provides details of past and future changes in the chain's fork version.

func (*Service) Genesis 

func (s *Service) Genesis(ctx context.Context) (*api.Genesis, error)

Genesis provides the genesis for the chain.

func (*Service) GenesisDomain 

func (s *Service) GenesisDomain(ctx context.Context,
	domainType phase0.DomainType,
) (
	phase0.Domain,
	error,
)

GenesisDomain provides a domain for a given domain type.

func (*Service) GenesisTime 

func (s *Service) GenesisTime(ctx context.Context) (time.Time, error)

GenesisTime provides the genesis time of the chain.

func (*Service) Name 

func (s *Service) Name() string

Name returns the name of the client implementation.

func (*Service) NodeSyncing 

func (s *Service) NodeSyncing(ctx context.Context) (*api.SyncState, error)

NodeSyncing provides the syncing information for the node.

func (*Service) NodeVersion 

func (s *Service) NodeVersion(ctx context.Context) (string, error)

NodeVersion provides the version information of the node.

func (*Service) ProposerDuties 

func (s *Service) ProposerDuties(ctx context.Context,
	epoch phase0.Epoch,
	validatorIndices []phase0.ValidatorIndex,
) (
	[]*api.ProposerDuty,
	error,
)

ProposerDuties obtains proposer duties for the given epoch. If validatorIndices is empty all duties are returned, otherwise only matching duties are returned.

func (*Service) SignedBeaconBlock 

func (s *Service) SignedBeaconBlock(ctx context.Context,
	blockID string,
) (
	*spec.VersionedSignedBeaconBlock,
	error,
)

SignedBeaconBlock fetches a signed beacon block given a block ID. N.B if a signed beacon block for the block ID is not available this will return nil without an error.

func (*Service) SlotDuration 

func (s *Service) SlotDuration(ctx context.Context) (time.Duration, error)

SlotDuration provides the duration of a slot of the chain.

func (*Service) SlotsPerEpoch 

func (s *Service) SlotsPerEpoch(ctx context.Context) (uint64, error)

SlotsPerEpoch provides the slots per epoch of the chain.

func (*Service) Spec 

func (s *Service) Spec(ctx context.Context) (map[string]interface{}, error)

Spec provides the spec information of the chain.

func (*Service) SubmitAggregateAttestations 

func (s *Service) SubmitAggregateAttestations(ctx context.Context,
	aggregateAndProofs []*phase0.SignedAggregateAndProof,
) error

SubmitAggregateAttestations submits aggregate attestations.

func (*Service) SubmitAttestations 

func (s *Service) SubmitAttestations(ctx context.Context,
	attestations []*phase0.Attestation,
) error

SubmitAttestations submits attestations.

func (*Service) SubmitBeaconBlock 

func (s *Service) SubmitBeaconBlock(ctx context.Context, block *spec.VersionedSignedBeaconBlock) error

SubmitBeaconBlock submits a beacon block.

func (*Service) SubmitBeaconCommitteeSubscriptions 

func (s *Service) SubmitBeaconCommitteeSubscriptions(ctx context.Context,
	subscriptions []*api.BeaconCommitteeSubscription,
) error

SubmitBeaconCommitteeSubscriptions subscribes to beacon committees.

func (*Service) SubmitBlindedBeaconBlock 

func (s *Service) SubmitBlindedBeaconBlock(ctx context.Context, block *api.VersionedSignedBlindedBeaconBlock) error

SubmitBlindedBeaconBlock submits a blinded beacon block.

func (*Service) SubmitProposalPreparations 

func (s *Service) SubmitProposalPreparations(ctx context.Context,
	preparations []*apiv1.ProposalPreparation,
) error

SubmitProposalPreparations provides the beacon node with information required if a proposal for the given validators shows up in the next epoch.

func (*Service) SubmitSyncCommitteeContributions 

func (s *Service) SubmitSyncCommitteeContributions(ctx context.Context,
	contributionAndProofs []*altair.SignedContributionAndProof,
) error

SubmitSyncCommitteeContributions submits sync committee contributions.

func (*Service) SubmitSyncCommitteeMessages 

func (s *Service) SubmitSyncCommitteeMessages(ctx context.Context,
	messages []*altair.SyncCommitteeMessage,
) error

SubmitSyncCommitteeMessages submits sync committee messages.

func (*Service) SubmitSyncCommitteeSubscriptions 

func (s *Service) SubmitSyncCommitteeSubscriptions(ctx context.Context,
	subscriptions []*api.SyncCommitteeSubscription,
) error

SubmitSyncCommitteeSubscriptions subscribes to sync committees.

func (*Service) SubmitValidatorRegistrations 

func (s *Service) SubmitValidatorRegistrations(ctx context.Context, registrations []*api.VersionedSignedValidatorRegistration) error

SubmitValidatorRegistrations submits a validator registration.

func (*Service) SubmitVoluntaryExit 

func (s *Service) SubmitVoluntaryExit(ctx context.Context, voluntaryExit *phase0.SignedVoluntaryExit) error

SubmitVoluntaryExit submits a voluntary exit.

func (*Service) SyncCommittee 

func (s *Service) SyncCommittee(ctx context.Context, stateID string) (*api.SyncCommittee, error)

SyncCommittee fetches the sync committee for the given state.

func (*Service) SyncCommitteeAtEpoch 

func (s *Service) SyncCommitteeAtEpoch(ctx context.Context, stateID string, epoch phase0.Epoch) (*api.SyncCommittee, error)

SyncCommitteeAtEpoch fetches the sync committee for the given epoch at the given state.

func (*Service) SyncCommitteeContribution 

func (s *Service) SyncCommitteeContribution(ctx context.Context,
	slot phase0.Slot,
	subcommitteeIndex uint64,
	beaconBlockRoot phase0.Root,
) (
	*altair.SyncCommitteeContribution,
	error,
)

SyncCommitteeContribution provides a sync committee contribution.

func (*Service) SyncCommitteeDuties 

func (s *Service) SyncCommitteeDuties(ctx context.Context,
	epoch phase0.Epoch,
	validatorIndices []phase0.ValidatorIndex,
) (
	[]*api.SyncCommitteeDuty,
	error,
)

SyncCommitteeDuties obtains attester duties. If validatorIndicess is nil it will return all duties for the given epoch.

func (*Service) TargetAggregatorsPerCommittee 

func (s *Service) TargetAggregatorsPerCommittee(ctx context.Context) (uint64, error)

TargetAggregatorsPerCommittee provides the target number of aggregators for each attestation committee.

func (*Service) ValidatorBalances 

func (s *Service) ValidatorBalances(ctx context.Context, stateID string, validatorIndices []phase0.ValidatorIndex) (map[phase0.ValidatorIndex]phase0.Gwei, error)

ValidatorBalances provides the validator balances for a given state. stateID can be a slot number or state root, or one of the special values "genesis", "head", "justified" or "finalized". validatorIndices is a list of validator indices to restrict the returned values. If no validators are supplied no filter will be applied.

func (*Service) Validators 

func (s *Service) Validators(ctx context.Context,
	stateID string,
	validatorIndices []phase0.ValidatorIndex,
) (
	map[phase0.ValidatorIndex]*api.Validator,
	error,
)

Validators provides the validators, with their balance and status, for a given state. stateID can be a slot number or state root, or one of the special values "genesis", "head", "justified" or "finalized". validatorIndices is a list of validators to restrict the returned values. If no validators are supplied no filter will be applied.

func (*Service) ValidatorsByPubKey 

func (s *Service) ValidatorsByPubKey(ctx context.Context,
	stateID string,
	validatorPubKeys []phase0.BLSPubKey,
) (
	map[phase0.ValidatorIndex]*api.Validator,
	error,
)

ValidatorsByPubKey provides the validators, with their balance and status, for a given state. stateID can be a slot number or state root, or one of the special values "genesis", "head", "justified" or "finalized". validatorPubKeys is a list of validator public keys to restrict the returned values. If no validators public keys are supplied no filter will be applied.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.