Crate fips_endpoint 

App-facing FIPS endpoint API.

Structs

Config

Root configuration structure.

EthernetConfig

Ethernet transport instance configuration.

FipsAddress

128-bit FIPS address with IPv6-compatible format.

FipsEndpoint

A running embedded FIPS endpoint.

FipsEndpointBuilder

Builder for an embedded FIPS endpoint.

FipsEndpointDirectPacketBatch

Established endpoint packet runs delivered without the endpoint-event queue.

FipsEndpointDirectPacketRun

Consecutive direct endpoint packets from one authenticated FIPS source.

FipsEndpointDirectReceiver

Blocking bounded receiver for authenticated direct endpoint packet runs.

FipsEndpointMessage

Source-attributed endpoint data delivered to an embedded application.

FipsEndpointPeer

Authenticated FIPS peer state visible to an embedded application.

FipsEndpointRelayStatus

Live Nostr relay state visible to an embedded application.

FipsEndpointServiceDatagram

Authenticated FSP DataPacket service payload delivered to an embedder.

FipsEndpointServiceReceiver

Port-scoped receiver for one registered FSP service.

Identity

A FIPS node identity consisting of a keypair and derived identifiers.

NodeAddr

16-byte node identifier derived from truncated SHA-256(pubkey).

NostrDiscoveryConfig

Nostr-mediated overlay endpoint discovery (node.discovery.nostr.*).

PeerAddress

A transport-specific address for reaching a peer.

PeerConfig

Configuration for a known peer.

PeerIdentity

A known peer’s identity (public key only, no signing capability).

RecentPeer

Authentication recency and reusable endpoints for one remote identity.

RecentPeerEndpoint

One previously authenticated, restart-safe transport endpoint.

RecentPeers

Store-agnostic version-1 recent-peer document.

RecentPeersFileStore

A caller-scoped native file store for recently authenticated FIPS peers.

TransportsConfig

Transports configuration section.

UdpConfig

UDP transport instance configuration.

UpdatePeersOutcome

Reports what changed in response to FipsEndpoint::update_peers.

WebSocketConfig

WebSocket physical transport configuration.

Enums

ConnectPolicy

Connection policy for a peer.

FipsEndpointDirectDeliveryError

Error returned by an installed direct endpoint sink.

FipsEndpointError

Errors returned by the endpoint API.

IdentityError

Errors that can occur in identity operations.

NostrDiscoveryPolicy

Nostr advert discovery policy.

NostrPeerfindingSource

Source used to publish and receive Nostr peer adverts.

PeerAddressProvenance

How a peer address became trusted for dialing.

RecentPeerTransport

Transport kinds allowed in the version-1 recent-peer schema.

RecentPeersError

Validation or JSON codec error for a recent-peer document.

RecentPeersFileError

Error loading or saving a RecentPeers file.

RoutingMode

Daemon routing mode.

TransportInstances

Transport instances - either a single config or named instances.

Constants

FIPS_ENDPOINT_DIRECT_PACKET_QUEUE_MAX_PACKETS

Maximum endpoint packets pending in an installed direct packet sink.

FIPS_ENDPOINT_DIRECT_PACKET_RUN_MAX_PACKETS

Maximum endpoint packets in one authenticated direct packet run.

RECENT_PEERS_MAX_ENDPOINTS_PER_PEER

Maximum number of restart endpoints retained for one remote identity.

RECENT_PEERS_MAX_PEERS

Maximum number of remote identities retained in one cache.

RECENT_PEERS_VERSION

Current recent-peers JSON schema version.

Traits

FipsEndpointDirectSink

Application-provided direct dataplane endpoint delivery sink.

Functions

decode_npub

Decode an npub string to an x-only public key.

decode_nsec

Decode an nsec string to a secret key.

decode_secret

Decode a secret key from either nsec (bech32) or hex format.

encode_npub

Encode an x-only public key as a bech32 npub string (NIP-19).

encode_nsec

Encode a secret key as a bech32 nsec string (NIP-19).

Type Aliases

FipsEndpointData

Endpoint data bytes delivered by FIPS.