91 lines
2.8 KiB
Python
91 lines
2.8 KiB
Python
import multiaddr
|
|
|
|
from .host_interface import IHost
|
|
|
|
# Upon host creation, host takes in options,
|
|
# including the list of addresses on which to listen.
|
|
# Host then parses these options and delegates to its Network instance,
|
|
# telling it to listen on the given listen addresses.
|
|
|
|
|
|
class BasicHost(IHost):
|
|
|
|
# default options constructor
|
|
def __init__(self, _network):
|
|
self.network = _network
|
|
self.peerstore = self.network.peerstore
|
|
|
|
def get_id(self):
|
|
"""
|
|
:return: peer_id of host
|
|
"""
|
|
return self.network.get_peer_id()
|
|
|
|
def get_network(self):
|
|
"""
|
|
:return: network instance of host
|
|
"""
|
|
return self.network
|
|
|
|
def get_peerstore(self):
|
|
"""
|
|
:return: peerstore of the host (same one as in its network instance)
|
|
"""
|
|
return self.peerstore
|
|
|
|
def get_mux(self):
|
|
"""
|
|
:return: mux instance of host
|
|
"""
|
|
|
|
def get_addrs(self):
|
|
"""
|
|
:return: all the multiaddr addresses this host is listening too
|
|
"""
|
|
p2p_part = multiaddr.Multiaddr('/p2p/{}'.format(self.get_id().pretty()))
|
|
|
|
addrs = []
|
|
for transport in self.network.listeners.values():
|
|
for addr in transport.get_addrs():
|
|
addrs.append(addr.encapsulate(p2p_part))
|
|
return addrs
|
|
|
|
def set_stream_handler(self, protocol_id, stream_handler):
|
|
"""
|
|
set stream handler for host
|
|
:param protocol_id: protocol id used on stream
|
|
:param stream_handler: a stream handler function
|
|
:return: true if successful
|
|
"""
|
|
return self.network.set_stream_handler(protocol_id, stream_handler)
|
|
|
|
# protocol_id can be a list of protocol_ids
|
|
# stream will decide which protocol_id to run on
|
|
async def new_stream(self, peer_id, protocol_ids):
|
|
"""
|
|
:param peer_id: peer_id that host is connecting
|
|
:param protocol_id: protocol id that stream runs on
|
|
:return: true if successful
|
|
"""
|
|
stream = await self.network.new_stream(peer_id, protocol_ids)
|
|
return stream
|
|
|
|
async def connect(self, peer_info):
|
|
"""
|
|
connect ensures there is a connection between this host and the peer with
|
|
given peer_info.peer_id. connect will absorb the addresses in peer_info into its internal
|
|
peerstore. If there is not an active connection, connect will issue a
|
|
dial, and block until a connection is open, or an error is
|
|
returned.
|
|
|
|
:param peer_info: peer_info of the host we want to connect to
|
|
:type peer_info: peer.peerinfo.PeerInfo
|
|
"""
|
|
self.peerstore.add_addrs(peer_info.peer_id, peer_info.addrs, 10)
|
|
|
|
# there is already a connection to this peer
|
|
if peer_info.peer_id in self.network.connections:
|
|
return
|
|
|
|
await self.network.dial_peer(peer_info.peer_id)
|