mirror of
https://github.com/libp2p/go-libp2p-core.git
synced 2024-12-27 23:40:11 +08:00
114 lines
4.2 KiB
Go
114 lines
4.2 KiB
Go
// Package transport provides the Transport interface, which represents
|
|
// the devices and network protocols used to send and recieve data.
|
|
package transport
|
|
|
|
import (
|
|
"context"
|
|
"net"
|
|
"time"
|
|
|
|
"github.com/libp2p/go-libp2p-core/mux"
|
|
"github.com/libp2p/go-libp2p-core/network"
|
|
"github.com/libp2p/go-libp2p-core/peer"
|
|
|
|
ma "github.com/multiformats/go-multiaddr"
|
|
)
|
|
|
|
// DialTimeout is the maximum duration a Dial is allowed to take.
|
|
// This includes the time between dialing the raw network connection,
|
|
// protocol selection as well the handshake, if applicable.
|
|
var DialTimeout = 60 * time.Second
|
|
|
|
// AcceptTimeout is the maximum duration an Accept is allowed to take.
|
|
// This includes the time between accepting the raw network connection,
|
|
// protocol selection as well as the handshake, if applicable.
|
|
var AcceptTimeout = 60 * time.Second
|
|
|
|
// A CapableConn represents a connection that has offers the basic
|
|
// capabilities required by libp2p: stream multiplexing, encryption and
|
|
// peer authentication.
|
|
//
|
|
// These capabilities may be natively provided by the transport, or they
|
|
// may be shimmed via the "connection upgrade" process, which converts a
|
|
// "raw" network connection into one that supports such capabilities by
|
|
// layering an encryption channel and a stream multiplexer.
|
|
//
|
|
// CapableConn provides accessors for the local and remote multiaddrs used to
|
|
// establish the connection and an accessor for the underlying Transport.
|
|
type CapableConn interface {
|
|
mux.MuxedConn
|
|
network.ConnSecurity
|
|
network.ConnMultiaddrs
|
|
|
|
// Transport returns the transport to which this connection belongs.
|
|
Transport() Transport
|
|
}
|
|
|
|
// Transport represents any device by which you can connect to and accept
|
|
// connections from other peers.
|
|
//
|
|
// The Transport interface allows you to open connections to other peers
|
|
// by dialing them, and also lets you listen for incoming connections.
|
|
//
|
|
// Connections returned by Dial and passed into Listeners are of type
|
|
// CapableConn, which means that they have been upgraded to support
|
|
// stream multiplexing and connection security (encryption and authentication).
|
|
//
|
|
// For a conceptual overview, see https://docs.libp2p.io/concepts/transport/
|
|
type Transport interface {
|
|
// Dial dials a remote peer. It should try to reuse local listener
|
|
// addresses if possible but it may choose not to.
|
|
Dial(ctx context.Context, raddr ma.Multiaddr, p peer.ID) (CapableConn, error)
|
|
|
|
// CanDial returns true if this transport knows how to dial the given
|
|
// multiaddr.
|
|
//
|
|
// Returning true does not guarantee that dialing this multiaddr will
|
|
// succeed. This function should *only* be used to preemptively filter
|
|
// out addresses that we can't dial.
|
|
CanDial(addr ma.Multiaddr) bool
|
|
|
|
// Listen listens on the passed multiaddr.
|
|
Listen(laddr ma.Multiaddr) (Listener, error)
|
|
|
|
// Protocol returns the set of protocols handled by this transport.
|
|
//
|
|
// See the Network interface for an explanation of how this is used.
|
|
Protocols() []int
|
|
|
|
// Proxy returns true if this is a proxy transport.
|
|
//
|
|
// See the Network interface for an explanation of how this is used.
|
|
// TODO: Make this a part of the go-multiaddr protocol instead?
|
|
Proxy() bool
|
|
}
|
|
|
|
// Listener is an interface closely resembling the net.Listener interface. The
|
|
// only real difference is that Accept() returns Conn's of the type in this
|
|
// package, and also exposes a Multiaddr method as opposed to a regular Addr
|
|
// method
|
|
type Listener interface {
|
|
Accept() (CapableConn, error)
|
|
Close() error
|
|
Addr() net.Addr
|
|
Multiaddr() ma.Multiaddr
|
|
}
|
|
|
|
// Network is an inet.Network with methods for managing transports.
|
|
type TransportNetwork interface {
|
|
network.Network
|
|
|
|
// AddTransport adds a transport to this Network.
|
|
//
|
|
// When dialing, this Network will iterate over the protocols in the
|
|
// remote multiaddr and pick the first protocol registered with a proxy
|
|
// transport, if any. Otherwise, it'll pick the transport registered to
|
|
// handle the last protocol in the multiaddr.
|
|
//
|
|
// When listening, this Network will iterate over the protocols in the
|
|
// local multiaddr and pick the *last* protocol registered with a proxy
|
|
// transport, if any. Otherwise, it'll pick the transport registered to
|
|
// handle the last protocol in the multiaddr.
|
|
AddTransport(t Transport) error
|
|
}
|