Module transport

Expand description

Saorsa transport primitives re-exported from saorsa_core.

Use ant_protocol::transport::… in downstream crates instead of a direct saorsa-core dependency.

Modules§

client_routing: Portable client routing report and witnessed-close-group policy. Client-side peer report selection and witness normalization. Transport I/O, node admission, and routing maintenance remain outside this module.
signed_address: Portable signed address publications and locally verified provenance. Portable owner-signed address publications. Forward the original signed record; filtering and reachability normalization belong to derived views.

CoreNodeConfig: Configuration for a P2P node
DHTNode: DHT node representation for network operations.
IPDiversityConfig: Configuration for IP diversity enforcement at two tiers: exact IP and subnet.
IterativeLookup: Pull-based, transport-independent Kademlia lookup state machine.
LookupConfig: Iterative lookup limits shared by all transports.
MlDsa65: ML-DSA-65 implementation using FIPS-certified algorithm
MultiAddr: Composable, self-describing network address with an optional PeerId suffix.
NodeIdentity: Core node identity with cryptographic keys
P2PNode: Main P2P network node that manages connections, routing, and communication
PeerId: Peer ID derived from public key (256-bit).
ResponderView: One responder’s self-inclusive closest-K view.
TransportAddressRecord: One address in the extensible V2 address plane.
WitnessedCloseGroup: Witnessed close-group selection result for a target key.

AddressType: Address classification for priority ordering and staleness eviction.
KnownReachability: A reachability class understood by this implementation.
LookupQueryOutcome: Result of one transport query in an iterative lookup batch.
LookupRunError: Failure produced while the shared engine is driving a transport adapter.
LookupTermination: Final reason an iterative lookup stopped.
NodeMode: Operating mode of a P2P node.
P2PEvent: Network events that can occur in the P2P system
PeerRouteKind: Coarse classification of the route by which a peer’s traffic reached us.

ADDRESS_V2_CAPABILITY: Browser RPC capability requiring owner-signed V2 address records. This does not select native DHT protocols; native peers send both versions.
DEFAULT_ALPHA_VALUE: Default concurrent queries in one lookup round.
DEFAULT_K_VALUE: Default Kademlia bucket and lookup result count.
ITERATION_GRACE_TIMEOUT_SECS: Additional wait for remaining queries after the first response in a round. Bounds slow dial cascades while allowing already-connected peers to reply.
LOOKUP_TIMEOUT_SECS: Overall lookup budget shared by native and browser clients, in seconds. Request and round grace timeouts still apply inside this ceiling.

LookupNode: A lookup candidate with a stable 256-bit peer identity.
LookupQuery: Transport and response-validation boundary used by the shared DHT walk.

collect_after_first_with_grace: Collect a concurrent query batch without letting slow stragglers hold an iterative lookup round open indefinitely.
run_iterative_lookup: Run an iterative lookup to completion through a transport/query adapter.
xor_distance: Compute the unsigned 256-bit XOR distance used for Kademlia ordering.