Adds snapshot() and batch helpers across network discovery/stack/transport, encoding-wire, observability, routing-advanced, supercomputer, state-crdts, scheduling-queues, and session-bridge modules. Co-authored-by: Cursor <[email protected]>
hyper-p2p-overlay-topology
Explicit overlay neighbor graph — weighted addNeighbor / removeNeighbor, getNeighbors, and suggestReplacement when a peer fails.
Category: Network stack
Composes with: hyper-p2p-protocol-handshake, hyper-p2p-connection-pool
Protocol: overlay-topology/v1
When to use
Multi-peer apps that need network stack over a shared Hyperswarm topic.
When not to use
Single-process tools with no P2P topic (use local APIs only or skip ready()).
Quick start
const { HyperP2POverlayTopology } = require('hyper-p2p-overlay-topology')
const topic = process.argv[2] // 64-char hex or string
const mod = new HyperP2POverlayTopology({ topic, enableBackgroundTimers: false })
await mod.ready() // joins swarm when topic set
// ... application logic ...
await mod.close()
Docs
-
Category hub — network stack index
-
docs/api.md — constructor, methods, events, errors
-
docs/architecture.md — wire types, state, composition
-
../_shared/PRODUCTION.md — production checklist
-
../_shared/DOC_STANDARDS.md — documentation standards
-
Integration:
../../real_tests/integration/—overlay-topology-two-node.js
Test
npm install && npm test