Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

@libp2p/kad-dht Discuss codecov CI

JavaScript implementation of the Kad-DHT for libp2p

Table of contents


$ npm i @libp2p/kad-dht
> npm i @libp2p/kad-dht

Use in Node.js

import { create } from '@libp2p/kad-dht'


See for the auto generated docs.

The libp2p-kad-dht module offers 3 APIs: Peer Routing, Content Routing and Peer Discovery.

Custom secondary DHT in libp2p

import { createLibp2pNode } from 'libp2p'
import { kadDHT } from '@libp2p/kad-dht'

const node = await createLibp2pNode({
  dht: kadDHT()
  //... other config
await node.start()

for await (const event of node.dht.findPeer(node.peerId)) {

Note that you may want to supply your own peer discovery function and datastore

Peer Routing

Content Routing

Peer Discovery


js-libp2p-kad-dht follows the libp2p/kad-dht spec and implements the algorithms described in the IPFS DHT documentation.


Feel free to join in. All welcome. Open an issue!

This repository falls under the IPFS Code of Conduct.


Licensed under either of


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.