http

Documentation

Index

• func New(ctx context.Context, params ...Parameter) (builderclient.Service, error)
• type ContentType
  • func ParseFromMediaType(input string) (ContentType, error)
  • func (c *ContentType) MarshalJSON() ([]byte, error)
  • func (c ContentType) MediaType() string
  • func (c ContentType) String() string
  • func (c *ContentType) UnmarshalJSON(input []byte) error
• type Parameter
  • func WithAddress(address string) Parameter
  • func WithExtraHeaders(headers map[string]string) Parameter
  • func WithLogLevel(logLevel zerolog.Level) Parameter
  • func WithMonitor(monitor metrics.Service) Parameter
  • func WithName(name string) Parameter
  • func WithTimeout(timeout time.Duration) Parameter
• type Service
  • func (s *Service) Address() string
  • func (s *Service) DeliveredBidTrace(ctx context.Context, slot phase0.Slot) (*v1.BidTrace, error)
  • func (s *Service) Name() string
  • func (s *Service) Pubkey() *phase0.BLSPubKey
  • func (s *Service) QueuedProposers(ctx context.Context) ([]*v1.QueuedProposer, error)
  • func (s *Service) ReceivedBidTraces(ctx context.Context, slot phase0.Slot) ([]*v1.BidTraceWithTimestamp, error)

Functions

func New

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

New creates a new builder client service, connecting with HTTP.

Types

type ContentType

type ContentType int

ContentType defines the builder spec version.

const (
	// ContentTypeUnknown implies an unknown content type.
	ContentTypeUnknown ContentType = iota
	// ContentTypeSSZ implies an SSZ content type.
	ContentTypeSSZ
	// ContentTypeJSON implies a JSON content type.
	ContentTypeJSON
)

func ParseFromMediaType

func ParseFromMediaType(input string) (ContentType, error)

ParseFromMediaType parses a content type string as per http://www.iana.org/assignments/media-types/media-types.xhtml

func (*ContentType) MarshalJSON

func (c *ContentType) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler.

func (ContentType) MediaType

func (c ContentType) MediaType() string

MediaType returns the IANA name of the media type.

func (ContentType) String

func (c ContentType) String() string

String returns a string representation of the struct.

func (*ContentType) UnmarshalJSON

func (c *ContentType) UnmarshalJSON(input []byte) error

UnmarshalJSON implements json.Unmarshaler.

type Parameter

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

Parameter is the interface for service parameters.

func WithAddress

func WithAddress(address string) Parameter

WithAddress provides the address for the endpoint.

func WithExtraHeaders

func WithExtraHeaders(headers map[string]string) Parameter

WithExtraHeaders sets additional headers to be sent with each HTTP request.

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 module.

func WithName

func WithName(name string) Parameter

WithName provides the name for the endpoint.

func WithTimeout

func WithTimeout(timeout time.Duration) Parameter

WithTimeout sets the maximum duration for all requests to the endpoint.

type Service

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

Service is an Ethereum 2 client service.

func (*Service) Address

func (s *Service) Address() string

Address provides the address for the connection.

func (*Service) DeliveredBidTrace

func (s *Service) DeliveredBidTrace(ctx context.Context, slot phase0.Slot) (*v1.BidTrace, error)

DeliveredBidTrace provides a bid trace of a delivered payload for a given slot. Will return nil if the relay did not deliver a bid for the slot.

func (*Service) Name

func (s *Service) Name() string

Name provides the name of the service.

func (*Service) Pubkey

func (s *Service) Pubkey() *phase0.BLSPubKey

Pubkey returns the public key of the builder (if any).

func (*Service) QueuedProposers

func (s *Service) QueuedProposers(ctx context.Context) ([]*v1.QueuedProposer, error)

QueuedProposers provides information on the proposers queued to obtain a blinded block.

func (*Service) ReceivedBidTraces

func (s *Service) ReceivedBidTraces(ctx context.Context, slot phase0.Slot) ([]*v1.BidTraceWithTimestamp, error)

ReceivedBidTraces provides all bid traces received for a given slot.