py-libp2p/host/basic_host.py
2018-10-15 01:52:25 -04:00

52 lines
1.4 KiB
Python

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, context, network):
self.context = context
self.network = network
def get_id(self):
"""
:return: peer_id of host
"""
pass
def get_network(self):
"""
:return: network instance of host
"""
pass
def mux(self):
"""
:return: mux instance of host
"""
pass
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
"""
pass
# protocol_id can be a list of protocol_ids
# stream will decide which protocol_id to run on
def new_stream(self, context, peer_id, protocol_id):
"""
:param context: a context instance
:param peer_id: peer_id that host is connecting
:param proto_id: protocol id that stream runs on
:return: true if successful
"""
pass