Home > Engineering > Third Party Software > P2P building blocks > blind-peering

blind-peering

blind-peering is the peer-side client for keeping your data available when you are offline: it registers your Hypercores and Autobases (via RPC) with always-on blind peers that replicate and serve them in your absence. It is the requester side — you supply the blind peers’ keys; it does not run a blind peer itself. Built with a Corestore + HyperDHT.

Upstream now frames it as one of three: blind-peer (the server, a library), blind-peering (this client) and blind-peer-cli; since Pear 3.4.0, pear blind-peer start runs a blind peer too. The documented availability picture is pear seed plus blind peering. seeders is an older, separate helper that the current docs do not mention.


Core API

See the README and the docs reference for exhaustive detail.

Mirror selection is by XOR distance to a target key (opts.target lets you pin / load-balance). It interplays with a Wakeup object — addAutobase defaults its target to the autobase’s wakeupCapability.key.


Gotchas

It is the requester side, not the server. You provide the blind peers’ keys (the always-on hosts); this module talks to them, it does not host data for others. The server side is the blind-peer package.

2.12.0 is breaking against older servers. Registrations and notifications are now requests the blind peer answers; a blind peer older than 3.16.0 “may leave cores unregistered”. Keep client and server in step.

The blind peer receives the core key. The client sends each core’s full key (and length) on registration. The docs state the blind property — blind peering lets peers “replicate and store Hypercores without being able to read them” — and what makes it hold is block encryption: the blind peer has the core key, not the encryption key. (See the key model and the security model.)


Version

blind-peering@2 (2.13.1 in November 2026; very active). The server, blind-peer, is at 3.18.1. Package name matches the repo — no trap. Check the npm registry before pinning.

See Also