network

Documentation

Index

• Variables
• type BitSwapNetwork
  • func NewFromIpfsHost(host host.Host, r routing.IpfsRouting) BitSwapNetwork
• type Receiver
• type Routing

Variables

var ProtocolBitswap protocol.ID = "/ipfs/bitswap"

Types

type BitSwapNetwork

type BitSwapNetwork interface {

	// SendMessage sends a BitSwap message to a peer.
	SendMessage(
		context.Context,
		peer.ID,
		bsmsg.BitSwapMessage) error

	// SendRequest sends a BitSwap message to a peer and waits for a response.
	SendRequest(
		context.Context,
		peer.ID,
		bsmsg.BitSwapMessage) (incoming bsmsg.BitSwapMessage, err error)

	// SetDelegate registers the Reciver to handle messages received from the
	// network.
	SetDelegate(Receiver)

	Routing
}

BitSwapNetwork provides network connectivity for BitSwap sessions

func NewFromIpfsHost

func NewFromIpfsHost(host host.Host, r routing.IpfsRouting) BitSwapNetwork

NewFromIpfsHost returns a BitSwapNetwork supported by underlying IPFS host

type Receiver

type Receiver interface {
	ReceiveMessage(
		ctx context.Context, sender peer.ID, incoming bsmsg.BitSwapMessage) (
		destination peer.ID, outgoing bsmsg.BitSwapMessage)

	ReceiveError(error)

	// Connected/Disconnected warns bitswap about peer connections
	PeerConnected(peer.ID)
	PeerDisconnected(peer.ID)
}

Implement Receiver to receive messages from the BitSwapNetwork

type Routing

type Routing interface {
	// FindProvidersAsync returns a channel of providers for the given key
	FindProvidersAsync(context.Context, u.Key, int) <-chan peer.ID

	// Provide provides the key to the network
	Provide(context.Context, u.Key) error
}