115 lines
2.8 KiB
Nim
115 lines
2.8 KiB
Nim
# Nim-LibP2P
|
|
# Copyright (c) 2023 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.
|
|
##
|
|
|
|
when (NimMajor, NimMinor) < (1, 4):
|
|
{.push raises: [Defect].}
|
|
else:
|
|
{.push raises: [].}
|
|
|
|
import sequtils
|
|
import chronos, chronicles
|
|
import ../stream/connection,
|
|
../multiaddress,
|
|
../multicodec,
|
|
../muxers/muxer,
|
|
../upgrademngrs/upgrade
|
|
|
|
logScope:
|
|
topics = "libp2p transport"
|
|
|
|
type
|
|
TransportError* = object of LPError
|
|
TransportInvalidAddrError* = object of TransportError
|
|
TransportClosedError* = object of TransportError
|
|
|
|
Transport* = ref object of RootObj
|
|
addrs*: seq[MultiAddress]
|
|
running*: bool
|
|
upgrader*: Upgrade
|
|
|
|
proc newTransportClosedError*(parent: ref Exception = nil): ref LPError =
|
|
newException(TransportClosedError,
|
|
"Transport closed, no more connections!", parent)
|
|
|
|
method start*(
|
|
self: Transport,
|
|
addrs: seq[MultiAddress]) {.base, async.} =
|
|
## start the transport
|
|
##
|
|
|
|
trace "starting transport on addrs", address = $addrs
|
|
self.addrs = addrs
|
|
self.running = true
|
|
|
|
method stop*(self: Transport) {.base, async.} =
|
|
## stop and cleanup the transport
|
|
## including all outstanding connections
|
|
##
|
|
|
|
trace "stopping transport", address = $self.addrs
|
|
self.running = false
|
|
|
|
method accept*(self: Transport): Future[Connection]
|
|
{.base, gcsafe.} =
|
|
## accept incoming connections
|
|
##
|
|
|
|
doAssert(false, "Not implemented!")
|
|
|
|
method dial*(
|
|
self: Transport,
|
|
hostname: string,
|
|
address: MultiAddress,
|
|
peerId: Opt[PeerId] = Opt.none(PeerId)): Future[Connection] {.base, gcsafe.} =
|
|
## dial a peer
|
|
##
|
|
|
|
doAssert(false, "Not implemented!")
|
|
|
|
proc dial*(
|
|
self: Transport,
|
|
address: MultiAddress,
|
|
peerId: Opt[PeerId] = Opt.none(PeerId)): Future[Connection] {.gcsafe.} =
|
|
self.dial("", address)
|
|
|
|
method upgradeIncoming*(
|
|
self: Transport,
|
|
conn: Connection): Future[Muxer] {.base, gcsafe.} =
|
|
## base upgrade method that the transport uses to perform
|
|
## transport specific upgrades
|
|
##
|
|
|
|
self.upgrader.upgradeIncoming(conn)
|
|
|
|
method upgradeOutgoing*(
|
|
self: Transport,
|
|
conn: Connection,
|
|
peerId: Opt[PeerId]): Future[Muxer] {.base, gcsafe.} =
|
|
## base upgrade method that the transport uses to perform
|
|
## transport specific upgrades
|
|
##
|
|
|
|
self.upgrader.upgradeOutgoing(conn, peerId)
|
|
|
|
method handles*(
|
|
self: 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
|