modules/routing-paths/hyper-p2p-merge-registry/docs/architecture.md

Architecture: hyper-p2p-merge-registry

Category: Routing & paths

flowchart LR
  App[Application] --> Mod[HyperP2PMergeRegistry]
  Mod --> Mux[Protomux merge-registry/v1]
  Mux --> Swarm[Hyperswarm]

Sequence (P2P)

sequenceDiagram
  participant App
  participant Mod as Module
  participant SW as Hyperswarm
  participant Peer
  App->>Mod: ready(topic)
  Mod->>SW: join(topic)
  SW->>Peer: connection
  Mod->>Peer: gossip / Protomux
  Peer-->>Mod: onmessage
  Mod-->>App: emit(event)

Wire messages

type	fields	direction	behavior
register	entry	gossip	Handled in onmessage / gossipSend

State model

• In-memory Map / Set structures for hot path
• Optional Hyperbee/Hypercore persistence when storageDir or memoryOnly is configured
• close() tears down swarm, timers, and clears ephemeral state

Composition

Composes with: hyper-p2p-intent-router, hyper-p2p-relay-tunnel.