Class Reticulum

constructor

• new Reticulum(
      config?: {
          compressionProvider?: Object;
          discovery?: Object;
          enableDiscovery?: boolean;
          logLevel?: string | number;
          storageAdapter?: StorageAdapter;
          useImplicitProof?: boolean;
      },
  ): Reticulum

  Initializes the Reticulum engine.

  Parameters

  • config: {
        compressionProvider?: Object;
        discovery?: Object;
        enableDiscovery?: boolean;
        logLevel?: string | number;
        storageAdapter?: StorageAdapter;
        useImplicitProof?: boolean;
    } = {}

    Configuration options for the node.

    • OptionalcompressionProvider?: Object

      Engine for handling bz2 Resources (e.g., for rngit).

    • Optionaldiscovery?: Object

      Extra options forwarded to the InterfaceDiscovery constructor when enableDiscovery is true (requiredValue, discoverySources, networkIdentity, backboneSupport).

    • OptionalenableDiscovery?: boolean

      When true, start an InterfaceDiscovery listener on the transport "announce" event so a leaf can discover connectable transport-node interfaces on the rnstransport.discovery.interface aspect (Python discover_interfaces). v1 is surface-only — no auto-connect.

    • OptionallogLevel?: string | number

      Initial log threshold. Accepts a LogLevel value or a level name ("DEBUG", "NOTICE", …). Takes precedence over the RETICULUM_LOG_LEVEL environment variable. See src/utils/log.js.

    • OptionalstorageAdapter?: StorageAdapter

      Interface for persisting identities and caches.

    • OptionaluseImplicitProof?: boolean

      §6.5.2 PROOF form for opportunistic DATA: true (default, upstream) emits the 64-byte implicit body; false emits the 96-byte explicit body.

  Returns Reticulum

_stopped

compressionProvider

discovery

localDestinations

persistor

persistorLoadPromise

storage

transport

useImplicitProof

StaticMINIMUM_BITRATE

addInterface

• addInterface(rnsInterface: Interface, isDefault?: boolean): void

  Attaches a physical or virtual network interface to the router.

  Connecting to a local shared instance is now the caller's job — use the LocalClientInterface.connectToSharedInstance() static factory (from @reticulum/node/src/interfaces/local_client.js) and pass the resulting interface here. Keeping shared-instance discovery out of the core keeps Reticulum free of Node.js builtins and browser-safe.

  Parameters

  • rnsInterface: Interface

    An instantiated interface (TCP, WebSocket, RNode, shared-instance client, ...)

  • isDefault: boolean = false

    If true, unroutable packets fallback to this interface

  Returns void

broadcast

• broadcast(packet: Packet): void

  Broadcasts a packet from a specific destination to the mesh.

  Parameters

  • packet: Packet

  Returns void

deregisterDestination

• deregisterDestination(destination: Destination): void

  Removes a local destination, ceasing all incoming traffic to that application endpoint.

  Parameters

  • destination: Destination

  Returns void

registerDestination

• registerDestination(destination: Destination): void

  Binds an application-level Destination to the network. When your web components spin up and instantiate a Yjs provider, this is where they register their collaborative endpoints to receive traffic.

  Parameters

  • destination: Destination

  Returns void

removeInterface

• removeInterface(rnsInterface: Interface): void

  Removes an interface and purges its routes from the TransportCore.

  Parameters

  • rnsInterface: Interface

    An instantiated interface (TCP, WebSocket, RNode)

  Returns void

stop

• stop(): Promise<void>

  Graceful shutdown: stops interface discovery, disconnects every attached interface, and flushes the persistence layer so the final debounced batch isn't lost. A per-interface disconnect failure is logged and the rest still proceed. Idempotent.

  Links and their channels are not torn down here (they are owned by the application's destinations); they terminate when their interfaces close.

  Returns Promise<void>