kubo/peer/peer.go
2014-09-22 04:06:12 -07:00

106 lines
2.2 KiB
Go

package peer
import (
"sync"
"time"
b58 "github.com/jbenet/go-ipfs/Godeps/_workspace/src/github.com/jbenet/go-base58"
ma "github.com/jbenet/go-ipfs/Godeps/_workspace/src/github.com/jbenet/go-multiaddr"
mh "github.com/jbenet/go-ipfs/Godeps/_workspace/src/github.com/jbenet/go-multihash"
ic "github.com/jbenet/go-ipfs/crypto"
u "github.com/jbenet/go-ipfs/util"
"bytes"
)
// ID is a byte slice representing the identity of a peer.
type ID mh.Multihash
// Equal is utililty function for comparing two peer ID's
func (id ID) Equal(other ID) bool {
return bytes.Equal(id, other)
}
// Pretty returns a b58-encoded string of the ID
func (id ID) Pretty() string {
return b58.Encode(id)
}
// DecodePrettyID returns a b58-encoded string of the ID
func DecodePrettyID(s string) ID {
return b58.Decode(s)
}
// Map maps Key (string) : *Peer (slices are not comparable).
type Map map[u.Key]*Peer
// Peer represents the identity information of an IPFS Node, including
// ID, and relevant Addresses.
type Peer struct {
ID ID
Addresses []*ma.Multiaddr
PrivKey ic.PrivKey
PubKey ic.PubKey
latency time.Duration
sync.RWMutex
}
// Key returns the ID as a Key (string) for maps.
func (p *Peer) Key() u.Key {
return u.Key(p.ID)
}
// AddAddress adds the given Multiaddr address to Peer's addresses.
func (p *Peer) AddAddress(a *ma.Multiaddr) {
p.Lock()
defer p.Unlock()
for _, addr := range p.Addresses {
if addr.Equal(a) {
return
}
}
p.Addresses = append(p.Addresses, a)
}
// NetAddress returns the first Multiaddr found for a given network.
func (p *Peer) NetAddress(n string) *ma.Multiaddr {
p.RLock()
defer p.RUnlock()
for _, a := range p.Addresses {
ps, err := a.Protocols()
if err != nil {
continue // invalid addr
}
for _, p := range ps {
if p.Name == n {
return a
}
}
}
return nil
}
// GetLatency retrieves the current latency measurement.
func (p *Peer) GetLatency() (out time.Duration) {
p.RLock()
out = p.latency
p.RUnlock()
return
}
// SetLatency sets the latency measurement.
// TODO: Instead of just keeping a single number,
// keep a running average over the last hour or so
// Yep, should be EWMA or something. (-jbenet)
func (p *Peer) SetLatency(laten time.Duration) {
p.Lock()
p.latency = laten
p.Unlock()
}