nim-libp2p/libp2p/transport.nim

58 lines
1.7 KiB
Nim
Raw Normal View History

## Nim-LibP2P
## Copyright (c) 2018 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.
import chronos
2019-08-27 21:45:21 +00:00
import peerinfo, connection, multiaddress, multicodec
type
ConnHandler* = proc (conn: Connection): Future[void] {.gcsafe.}
ConnHolder* = object
connection*: Connection
connFuture*: Future[void]
Transport* = ref object of RootObj
ma*: Multiaddress
connections*: seq[ConnHolder]
handler*: ConnHandler
multicodec*: MultiCodec
2019-08-30 15:28:07 +00:00
method init*(t: Transport) {.base, gcsafe.} =
## perform protocol initialization
discard
2019-08-30 15:28:07 +00:00
proc newTransport*(t: typedesc[Transport]): t {.gcsafe.} =
new result
result.init()
2019-08-30 15:28:07 +00:00
method close*(t: Transport) {.base, async, gcsafe.} =
2019-08-21 22:53:16 +00:00
## stop and cleanup the transport
## including all outstanding connections
for c in t.connections:
await c.connection.close()
2019-08-26 15:37:15 +00:00
method listen*(t: Transport,
ma: MultiAddress,
2019-08-30 15:28:07 +00:00
handler: ConnHandler) {.base, async, gcsafe.} =
2019-08-21 22:53:16 +00:00
## listen for incoming connections
t.ma = ma
t.handler = handler
2019-08-26 15:37:15 +00:00
method dial*(t: Transport,
2019-08-30 15:28:07 +00:00
address: MultiAddress):
Future[Connection] {.base, async, gcsafe.} =
## dial a peer
discard
2019-08-30 15:28:07 +00:00
method handles*(t: Transport, address: MultiAddress): bool {.base, gcsafe.} =
## check if transport supportes the multiaddress
# TODO: this should implement generic logic that would use the multicodec
# declared in the multicodec field and set by each individual transport
discard