Adds experimental-base helpers, richer gossip modules across all 16 experimental primitives, and bumps versions to 0.3.2. Co-authored-by: Cursor <[email protected]>
hyper-p2p-pheromone-trail
Pheromone trail routing — deposit, sniff, evaporate, and bestPath(dest) over gossiped trails.
Category: Experimental
Composes with: hyper-p2p-whisper-mesh, hyper-p2p-entropy-beacon
Protocol: pheromone-trail/v1
When to use
Multi-peer apps that need experimental 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 { HyperP2PPheromoneTrail } = require('hyper-p2p-pheromone-trail')
const topic = process.argv[2] // 64-char hex or string
const mod = new HyperP2PPheromoneTrail({ topic, enableBackgroundTimers: false })
await mod.ready() // joins swarm when topic set
// ... application logic ...
await mod.close()
Docs
-
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/—pheromone-trail-two-node.js
Test
npm install && npm test