Netmod provides an async interface to interact with endpoints basic data frame definitions, and frame sequencing.
The interface itself makes no assumption about underlying address spacing or resend behaviour. Using netmod as a library allows you to write Ratman compatible network adapters.
Frame is a single packet that is sent over a network
connection. It corresponds (for example) to a UDP packet in other
protocols. It contains sender, recipient information, and a
sequence indicator (seqid), which is constructed over data slices,
and can be reassembled on the other side of a circuit.
When constructing a
Frame sequence, the payload is split into
appropriately sized chunks, then hashed, and those signature
hashes are entered into the sequence ID
next sequentially. The
following diagram explains the concept further.
|--------------| |--------------| |--------------| | Frame #1 | | Frame #2 | | Frame #2 | | next: f4aa | ------ | next: bb61 | ------ | next: NONE | | sig: a1a1 | | sig: f4aa | | sig: bb61 | |--------------| |--------------| |--------------|
The payload signature is used to validate transport layer integrity (resends are up to a user of this interface to implement, as well as associating sequential frames into a data set.
A sequence of data, represented by a single network packet
Utility wrapping around
Encoded signature information related to a data sequence
Error return types emitted by
Encoded recipient data
Describes an endpoint’s send target
The main trait describing a Ratman networking interface
A unique identifier to represents a sequence of frames