Files
modules/storage-hyperdrive/hyper-p2p-drive-entry-catalog
Raven ScottandCursor faf152a8ac Add exportState and moduleSnapshot helpers across all module categories.
Fifth pass: complete measurement modules (sla-budget, histogram-gossip) with moduleSnapshot/toJSON; stats-exporter exportSnapshot; exportState() alias on modules with standard snapshot serialization.

Co-authored-by: Cursor <[email protected]>
2026-05-21 04:29:50 -04:00
..
2026-05-21 02:00:00 -04:00
2026-05-21 02:00:00 -04:00

hyper-p2p-drive-entry-catalog

Gossip-replicated path catalog with metadata for Hyperdrive entries; merge remote catalogs via hyper-p2p-merge-registry policies. Hyperswarm gossip when topic is set.

Category: Storage (Hyperdrive)

Composes with: hyper-p2p-merge-registry

Protocol: drive-entry-catalog/v1

When to use

Peers need a searchable index of drive paths without full directory walks.

When not to use

Single-writer drives with no shared topic.

Quick start

const { HyperP2PDriveEntryCatalog } = require('hyper-p2p-drive-entry-catalog')
const topic = process.argv[2] // 64-char hex or string
const mod = new HyperP2PDriveEntryCatalog({ topic })
await mod.ready()   // joins swarm when topic set
// ... application logic ...
await mod.close()

Docs

Test

npm install && npm test