IrohEndpointSettings interface

Configuration for the shared per-instance iroh endpoint (key-addressed QUIC: peers dial the endpoint’s public key — its NodeId — rather than an ip:port). All fields optional; unset fields fall back to the NORSK_IROH_* environment, then defaults (fresh unpersisted identity; inbound rejected until an allow-list is set).

Signature:

export interface IrohEndpointSettings

Properties

Property Type Description

allowAnyPeer?

boolean

(Optional) Explicit opt-in to accept ANY peer (never the default).

allowedPeers?

string[]

(Optional) Verified remote NodeIds (64-char hex) allowed to connect inbound.

allowedPeersFile?

string

(Optional) Path to an allow-list file (one hex NodeId per line, # comments).

relayMode?

'default' | 'disabled'

(Optional) 'default' (relays + discovery) or 'disabled' (direct paths only).

relayUrls?

string[]

(Optional) Self-hosted relay server URLs (https). Setting these uses YOUR relays and disables n0’s discovery services entirely — peers are then reached via addr hints (iroh://<nodeId>?addr=<relayUrl>). Mutually exclusive with relayMode 'disabled'.

secretKeyFile?

string

(Optional) Path to the identity key file. Load-or-generate: created (mode 0600) if absent, so the NodeId survives restarts.