# @libp2p/bootstrap

> Peer discovery via a list of bootstrap peers

Latest version **12.0.32** (published 2026-09-02) · Apache-2.0 OR MIT license · 0 weekly downloads

## Install

```sh
npm install @libp2p/bootstrap
pnpm add @libp2p/bootstrap
yarn add @libp2p/bootstrap
bun add @libp2p/bootstrap
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 12.0.32 |
| Published | 2026-09-02 |
| First published | 2022-02-05 |
| Weekly downloads | 0 |
| License | Apache-2.0 OR MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 6 |
| Unpacked size | 948.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 2579 |
| Maintainers | daviddias, alanshaw, achingbrain, vascosantos, npm-service-account-libp2p, jacobheun |
| Keywords | IPFS |

## Links

- npm: https://www.npmjs.com/package/@libp2p/bootstrap
- Repository: https://github.com/libp2p/js-libp2p
- Homepage: https://github.com/libp2p/js-libp2p/tree/main/packages/peer-discovery-bootstrap#readme
- Issues: https://github.com/libp2p/js-libp2p/issues
- npm.io page: https://npm.io/package/@libp2p/bootstrap

## Dependencies (6)

- [main-event](https://npm.io/package/main-event.md) ^1.0.1
- [@libp2p/peer-id](https://npm.io/package/@libp2p/peer-id.md) ^6.0.15
- [@libp2p/interface](https://npm.io/package/@libp2p/interface.md) ^3.3.0
- [@multiformats/multiaddr](https://npm.io/package/@multiformats/multiaddr.md) ^13.0.3
- [@libp2p/interface-internal](https://npm.io/package/@libp2p/interface-internal.md) ^3.1.13
- [@multiformats/multiaddr-matcher](https://npm.io/package/@multiformats/multiaddr-matcher.md) ^3.0.2

## Recent versions

- 12.0.32 (latest) — 2026-09-02
- 12.0.31-5cb617ae2 (next) — 2026-09-02
- 12.0.31-185d901cd — 2026-09-02
- 12.0.31 — 2026-08-31
- 12.0.30-cef4d32cf — 2026-08-31
- 12.0.30-ac7305ccf — 2026-08-31
- 12.0.30-87dca02b0 — 2026-08-27
- 12.0.30-4a6c5d11a — 2026-08-27
- 12.0.30 — 2026-08-23
- 12.0.29-947d304ed — 2026-08-22
- 12.0.29-0967e75f5 — 2026-08-22
- 12.0.29-4dae661b4 — 2026-08-22
- 12.0.29-8786aa8d0 — 2026-08-20
- 12.0.29-55d7a539a — 2026-08-20
- 12.0.29-d5534174d — 2026-08-13
- … 923 more at https://npm.io/package/@libp2p/bootstrap/versions

## README

# @libp2p/bootstrap

[![libp2p.io](https://img.shields.io/badge/project-libp2p-yellow.svg?style=flat-square)](http://libp2p.io/)
[![Discuss](https://img.shields.io/discourse/https/discuss.libp2p.io/posts.svg?style=flat-square)](https://discuss.libp2p.io)
[![codecov](https://img.shields.io/codecov/c/github/libp2p/js-libp2p.svg?style=flat-square)](https://codecov.io/gh/libp2p/js-libp2p)
[![CI](https://img.shields.io/github/actions/workflow/status/libp2p/js-libp2p/main.yml?branch=main\&style=flat-square)](https://github.com/libp2p/js-libp2p/actions/workflows/main.yml?query=branch%3Amain)

> Peer discovery via a list of bootstrap peers

# About

<!--

!IMPORTANT!

Everything in this README between "# About" and "# Install" is automatically
generated and will be overwritten the next time the doc generator is run.

To make changes to this section, please update the @packageDocumentation section
of src/index.js or src/index.ts

To experiment with formatting, please run "npm run docs" from the root of this
repo and examine the changes made.

-->

The configured bootstrap peers will be discovered after the configured timeout. This will ensure there are some peers in the peer store for the node to use to discover other peers.

They will be tagged with a tag with the name `'bootstrap'` tag, the value `50` and it will expire after two minutes which means the nodes connections may be closed if the maximum number of connections is reached.

Clients that need constant connections to bootstrap nodes (e.g. browsers) can set the TTL to `Infinity`.

## Example - Configuring a list of bootstrap nodes

```TypeScript
import { createLibp2p } from 'libp2p'
import { bootstrap } from '@libp2p/bootstrap'

const libp2p = await createLibp2p({
  peerDiscovery: [
    bootstrap({
      list: [
        // a list of bootstrap peer multiaddrs to connect to on node startup
        '/ip4/104.131.131.82/tcp/4001/ipfs/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ',
        '/dnsaddr/bootstrap.libp2p.io/ipfs/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN',
        '/dnsaddr/bootstrap.libp2p.io/ipfs/QmQCU2EcMqAqQPR2i9bChDtGNJchTbq5TbXJJ16u19uLTa'
      ]
    })
  ]
})

libp2p.addEventListener('peer:discovery', (evt) => {
  console.log('found peer: ', evt.detail.toString())
})
```

# Install

```console
$ npm i @libp2p/bootstrap
```

## Browser `<script>` tag

Loading this module through a script tag will make its exports available as `Libp2pBootstrap` in the global namespace.

```html
<script src="https://unpkg.com/@libp2p/bootstrap/dist/index.min.js"></script>
```

# API Docs

- <https://libp2p.github.io/js-libp2p/modules/_libp2p_bootstrap.html>

# License

Licensed under either of

- Apache 2.0, ([LICENSE-APACHE](https://github.com/libp2p/js-libp2p/blob/main/packages/peer-discovery-bootstrap/LICENSE-APACHE) / <http://www.apache.org/licenses/LICENSE-2.0>)
- MIT ([LICENSE-MIT](https://github.com/libp2p/js-libp2p/blob/main/packages/peer-discovery-bootstrap/LICENSE-MIT) / <http://opensource.org/licenses/MIT>)

# Contribution

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.

---
_Source: https://npm.io/package/@libp2p/bootstrap · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._