90 lines
2.2 KiB
Nim
90 lines
2.2 KiB
Nim
## Nim-LibP2P
|
|
## Copyright (c) 2019 Status Research & Development GmbH
|
|
## Licensed under either of
|
|
## * Apache License, version 2.0, ([LICENSE-APACHE](LICENSE-APACHE))
|
|
## * MIT license ([LICENSE-MIT](LICENSE-MIT))
|
|
## at your option.
|
|
## This file may not be copied, modified, or distributed except according to
|
|
## those terms.
|
|
##
|
|
|
|
{.push raises: [Defect].}
|
|
|
|
import sequtils
|
|
import chronos, chronicles
|
|
import ../stream/connection,
|
|
../multiaddress,
|
|
../multicodec
|
|
|
|
logScope:
|
|
topics = "libp2p transport"
|
|
|
|
type
|
|
TransportClosedError* = object of CatchableError
|
|
|
|
Transport* = ref object of RootObj
|
|
ma*: Multiaddress
|
|
multicodec*: MultiCodec
|
|
running*: bool
|
|
|
|
proc newTransportClosedError*(parent: ref Exception = nil): ref CatchableError =
|
|
newException(TransportClosedError,
|
|
"Transport closed, no more connections!", parent)
|
|
|
|
method initTransport*(t: Transport) {.base, gcsafe, locks: "unknown".} =
|
|
## perform protocol initialization
|
|
##
|
|
|
|
discard
|
|
|
|
method start*(t: Transport, ma: MultiAddress) {.base, async.} =
|
|
## start the transport
|
|
##
|
|
|
|
t.ma = ma
|
|
trace "starting transport", address = $ma
|
|
|
|
method stop*(t: Transport) {.base, async.} =
|
|
## stop and cleanup the transport
|
|
## including all outstanding connections
|
|
##
|
|
|
|
discard
|
|
|
|
method accept*(t: Transport): Future[Connection]
|
|
{.base, async, gcsafe.} =
|
|
## accept incoming connections
|
|
##
|
|
|
|
discard
|
|
|
|
method dial*(t: Transport,
|
|
address: MultiAddress): Future[Connection]
|
|
{.base, async, gcsafe.} =
|
|
## dial a peer
|
|
##
|
|
|
|
discard
|
|
|
|
method upgrade*(t: Transport) {.base, async, gcsafe.} =
|
|
## base upgrade method that the transport uses to perform
|
|
## transport specific upgrades
|
|
##
|
|
|
|
discard
|
|
|
|
method handles*(t: Transport, address: MultiAddress): bool {.base, gcsafe.} =
|
|
## check if transport supports the multiaddress
|
|
##
|
|
|
|
# by default we skip circuit addresses to avoid
|
|
# having to repeat the check in every transport
|
|
if address.protocols.isOk:
|
|
return address.protocols.get().filterIt( it == multiCodec("p2p-circuit") ).len == 0
|
|
|
|
method localAddress*(t: Transport): MultiAddress {.base, gcsafe.} =
|
|
## get the local address of the transport in case started with 0.0.0.0:0
|
|
##
|
|
|
|
discard
|