routing

Documentation

Index

• type ErrMultipleNodesFound
  • func NewErrMultipleNodesFound(nodeIDPrefix string, matchingNodeIDs []string) ErrMultipleNodesFound
  • func (e ErrMultipleNodesFound) Error() string
• type ErrNodeNotFound
  • func NewErrNodeNotFound(nodeID string) ErrNodeNotFound
  • func (e ErrNodeNotFound) Error() string
• type NodeInfoFilter
• type NodeInfoProvider
  • func NewNodeInfoProvider(params NodeInfoProviderParams) *NodeInfoProvider
  • func (n *NodeInfoProvider) GetNodeInfo(ctx context.Context) models.NodeInfo
  • func (n *NodeInfoProvider) RegisterNodeInfoDecorator(decorator models.NodeInfoDecorator)
• type NodeInfoProviderParams
• type NodeInfoPublisher
  • func NewNodeInfoPublisher(params NodeInfoPublisherParams) *NodeInfoPublisher
  • func (n *NodeInfoPublisher) Publish(ctx context.Context) error
  • func (n *NodeInfoPublisher) Stop(ctx context.Context)
• type NodeInfoPublisherIntervalConfig
  • func (n NodeInfoPublisherIntervalConfig) IsEagerPublishEnabled() bool
  • func (n NodeInfoPublisherIntervalConfig) IsZero() bool
• type NodeInfoPublisherParams
• type NodeInfoStore

Types

type ErrMultipleNodesFound

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

ErrMultipleNodesFound is returned when multiple nodes were found for a requested node id prefix

func NewErrMultipleNodesFound

func NewErrMultipleNodesFound(nodeIDPrefix string, matchingNodeIDs []string) ErrMultipleNodesFound

func (ErrMultipleNodesFound) Error

func (e ErrMultipleNodesFound) Error() string

type ErrNodeNotFound

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

ErrNodeNotFound is returned when nodeInfo was not found for a requested node id

func NewErrNodeNotFound

func NewErrNodeNotFound(nodeID string) ErrNodeNotFound

func (ErrNodeNotFound) Error

func (e ErrNodeNotFound) Error() string

type NodeInfoFilter

type NodeInfoFilter func(models.NodeInfo) bool

NodeInfoFilter is a function that filters node info when listing nodes. It returns true if the node info should be returned, and false if the node info should be ignored.

type NodeInfoProvider

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

func NewNodeInfoProvider

func NewNodeInfoProvider(params NodeInfoProviderParams) *NodeInfoProvider

func (*NodeInfoProvider) GetNodeInfo

func (n *NodeInfoProvider) GetNodeInfo(ctx context.Context) models.NodeInfo

func (*NodeInfoProvider) RegisterNodeInfoDecorator

func (n *NodeInfoProvider) RegisterNodeInfoDecorator(decorator models.NodeInfoDecorator)

RegisterNodeInfoDecorator registers a node info decorator with the node info provider.

type NodeInfoProviderParams

type NodeInfoProviderParams struct {
	NodeID              string
	LabelsProvider      models.LabelsProvider
	BacalhauVersion     models.BuildVersionInfo
	DefaultNodeApproval models.NodeApproval
}

type NodeInfoPublisher

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

func NewNodeInfoPublisher

func NewNodeInfoPublisher(params NodeInfoPublisherParams) *NodeInfoPublisher

func (*NodeInfoPublisher) Publish

func (n *NodeInfoPublisher) Publish(ctx context.Context) error

Publish publishes the node info to the pubsub topic manually and won't wait for the background task to do it.

func (*NodeInfoPublisher) Stop

func (n *NodeInfoPublisher) Stop(ctx context.Context)

Stop stops the background task that publishes the node info periodically

type NodeInfoPublisherIntervalConfig

type NodeInfoPublisherIntervalConfig struct {
	// Interval is the interval between publishing node info
	Interval time.Duration

	// During node startup, we can publish node info more frequently to speed up the discovery process.
	// EagerPublishInterval is the interval between publishing node info during startup.
	EagerPublishInterval time.Duration
	// EagerPublishDuration is the duration of the eager publish period. After this period, the node will publish node info
	// with the standard interval.
	EagerPublishDuration time.Duration
}

func (NodeInfoPublisherIntervalConfig) IsEagerPublishEnabled

func (n NodeInfoPublisherIntervalConfig) IsEagerPublishEnabled() bool

IsEagerPublishEnabled returns true if eager publish is enabled

func (NodeInfoPublisherIntervalConfig) IsZero

func (n NodeInfoPublisherIntervalConfig) IsZero() bool

IsZero returns true if the interval config is zero

type NodeInfoPublisherParams

type NodeInfoPublisherParams struct {
	PubSub           pubsub.Publisher[models.NodeInfo]
	NodeInfoProvider models.NodeInfoProvider
	IntervalConfig   NodeInfoPublisherIntervalConfig
}

type NodeInfoStore

type NodeInfoStore interface {
	// TODO: Remove this interface once we switch to nats
	libp2p_routing.PeerRouting

	// Add adds a node info to the repo.
	Add(ctx context.Context, nodeInfo models.NodeInfo) error

	// Get returns the node info for the given node ID.
	Get(ctx context.Context, nodeID string) (models.NodeInfo, error)

	// GetByPrefix returns the node info for the given node ID.
	// Supports both full and short node IDs.
	GetByPrefix(ctx context.Context, prefix string) (models.NodeInfo, error)

	// List returns a list of nodes
	List(ctx context.Context, filters ...NodeInfoFilter) ([]models.NodeInfo, error)

	// Delete deletes a node info from the repo.
	Delete(ctx context.Context, nodeID string) error
}