server

Documentation

Index

• Constants
• func Handler(svc ContentRouter, opts ...Option) http.Handler
• type BitswapWriteProvideRequest
• type ContentRouter
• type FindProvidersAsyncResponse
• type Option
  • func WithRecordsLimit(limit int) Option
  • func WithStreamingRecordsLimit(limit int) Option
  • func WithStreamingResultsDisabled() Option
• type WriteProvideRequest

Constants

const (
	DefaultRecordsLimit          = 20
	DefaultStreamingRecordsLimit = 0
)

const (
	ProvidePath       = "/routing/v1/providers/"
	FindProvidersPath = "/routing/v1/providers/{cid}"
	IPNSPath          = "/routing/v1/ipns/{cid}"
)

Functions

func Handler

func Handler(svc ContentRouter, opts ...Option) http.Handler

Types

type BitswapWriteProvideRequest

type BitswapWriteProvideRequest struct {
	Keys        []cid.Cid
	Timestamp   time.Time
	AdvisoryTTL time.Duration
	ID          peer.ID
	Addrs       []multiaddr.Multiaddr
}

type ContentRouter

type ContentRouter interface {
	// FindProviders searches for peers who are able to provide a given key. Limit
	// indicates the maximum amount of results to return. 0 means unbounded.
	FindProviders(ctx context.Context, key cid.Cid, limit int) (iter.ResultIter[types.ProviderResponse], error)
	ProvideBitswap(ctx context.Context, req *BitswapWriteProvideRequest) (time.Duration, error)
	Provide(ctx context.Context, req *WriteProvideRequest) (types.ProviderResponse, error)

	// FindIPNSRecord searches for an [ipns.Record] for the given [ipns.Name].
	FindIPNSRecord(ctx context.Context, name ipns.Name) (*ipns.Record, error)

	// ProvideIPNSRecord stores the provided [ipns.Record] for the given [ipns.Name]. It is
	// guaranteed that the record matches the provided name.
	ProvideIPNSRecord(ctx context.Context, name ipns.Name, record *ipns.Record) error
}

type FindProvidersAsyncResponse

type FindProvidersAsyncResponse struct {
	ProviderResponse types.ProviderResponse
	Error            error
}

type Option

type Option func(s *server)

func WithRecordsLimit

func WithRecordsLimit(limit int) Option

WithRecordsLimit sets a limit that will be passed to ContentRouter.FindProviders for non-streaming requests (application/json). Default is DefaultRecordsLimit.

func WithStreamingRecordsLimit

func WithStreamingRecordsLimit(limit int) Option

WithStreamingRecordsLimit sets a limit that will be passed to ContentRouter.FindProviders for streaming requests (application/x-ndjson). Default is DefaultStreamingRecordsLimit.

func WithStreamingResultsDisabled

func WithStreamingResultsDisabled() Option

WithStreamingResultsDisabled disables ndjson responses, so that the server only supports JSON responses.

type WriteProvideRequest

type WriteProvideRequest struct {
	Protocol string
	Schema   string
	Bytes    []byte
}