mirror of
https://github.com/ipfs/kubo.git
synced 2026-02-23 03:17:43 +08:00
2c93eeffc6
Switch _back_ to the 0.4.18 style of peer IDs while we figure things out. See https://github.com/libp2p/specs/issues/138. License: MIT Signed-off-by: Steven Allen <steven@stebalien.com>
58 lines
1.7 KiB
Go
58 lines
1.7 KiB
Go
package iface
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"time"
|
|
|
|
ma "gx/ipfs/QmNTCey11oxhb1AxDnQBRHtdhap6Ctud872NjAYPYYXPuc/go-multiaddr"
|
|
"gx/ipfs/QmPJxxDsX2UbchSHobbYuvz7qnyJTFKvaKMzE2rZWJ4x5B/go-libp2p-peer"
|
|
pstore "gx/ipfs/QmQFFp4ntkd4C14sP3FaH9WJyBuetuGUVo6dShNHvnoEvC/go-libp2p-peerstore"
|
|
net "gx/ipfs/QmZ7cBWUXkyWTMN4qH6NGoyMVs7JugyFChBNP4ZUp5rJHH/go-libp2p-net"
|
|
"gx/ipfs/QmZNkThpqfVXs9GNbexPrfBbXSLNYeKrE7jwFM2oqHbyqN/go-libp2p-protocol"
|
|
)
|
|
|
|
var (
|
|
ErrNotConnected = errors.New("not connected")
|
|
ErrConnNotFound = errors.New("conn not found")
|
|
)
|
|
|
|
// ConnectionInfo contains information about a peer
|
|
type ConnectionInfo interface {
|
|
// ID returns PeerID
|
|
ID() peer.ID
|
|
|
|
// Address returns the multiaddress via which we are connected with the peer
|
|
Address() ma.Multiaddr
|
|
|
|
// Direction returns which way the connection was established
|
|
Direction() net.Direction
|
|
|
|
// Latency returns last known round trip time to the peer
|
|
Latency() (time.Duration, error)
|
|
|
|
// Streams returns list of streams established with the peer
|
|
Streams() ([]protocol.ID, error)
|
|
}
|
|
|
|
// SwarmAPI specifies the interface to libp2p swarm
|
|
type SwarmAPI interface {
|
|
// Connect to a given peer
|
|
Connect(context.Context, pstore.PeerInfo) error
|
|
|
|
// Disconnect from a given address
|
|
Disconnect(context.Context, ma.Multiaddr) error
|
|
|
|
// Peers returns the list of peers we are connected to
|
|
Peers(context.Context) ([]ConnectionInfo, error)
|
|
|
|
// KnownAddrs returns the list of all addresses this node is aware of
|
|
KnownAddrs(context.Context) (map[peer.ID][]ma.Multiaddr, error)
|
|
|
|
// LocalAddrs returns the list of announced listening addresses
|
|
LocalAddrs(context.Context) ([]ma.Multiaddr, error)
|
|
|
|
// ListenAddrs returns the list of all listening addresses
|
|
ListenAddrs(context.Context) ([]ma.Multiaddr, error)
|
|
}
|