# @libp2p/floodsub

> libp2p-floodsub, also known as pubsub-flood or just dumbsub, this implementation of pubsub focused on delivering an API for Publish/Subscribe, but with no CastTree Forming (it just floods the network).

Latest version **11.0.30** (published 2026-08-31) · Apache-2.0 OR MIT license · 0 weekly downloads

## Install

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

## 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 | 11.0.30 |
| Published | 2026-08-31 |
| First published | 2022-02-18 |
| Weekly downloads | 0 |
| License | Apache-2.0 OR MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 13 |
| Unpacked size | 1.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 2580 |
| Maintainers | daviddias, alanshaw, achingbrain, vascosantos, npm-service-account-libp2p, jacobheun |
| Keywords | IPFS, flood, flooding, gossip, libp2p, pubsub |

## Links

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

## Dependencies (13)

- [p-queue](https://npm.io/package/p-queue.md) ^9.0.0
- [main-event](https://npm.io/package/main-event.md) ^1.0.1
- [uint8arrays](https://npm.io/package/uint8arrays.md) ^6.1.1
- [multiformats](https://npm.io/package/multiformats.md) ^14.0.0
- [@libp2p/utils](https://npm.io/package/@libp2p/utils.md) ^7.4.1
- [@libp2p/crypto](https://npm.io/package/@libp2p/crypto.md) ^5.1.23
- [uint8arraylist](https://npm.io/package/uint8arraylist.md) ^3.0.2
- [@libp2p/peer-id](https://npm.io/package/@libp2p/peer-id.md) ^6.0.15
- [protons-runtime](https://npm.io/package/protons-runtime.md) ^7.0.0
- [@libp2p/interface](https://npm.io/package/@libp2p/interface.md) ^3.3.0
- [it-length-prefixed](https://npm.io/package/it-length-prefixed.md) ^11.0.1
- [@libp2p/peer-collections](https://npm.io/package/@libp2p/peer-collections.md) ^7.0.28
- [@libp2p/interface-internal](https://npm.io/package/@libp2p/interface-internal.md) ^3.1.13

## Alternatives

- [async-exit-hook](https://npm.io/package/async-exit-hook.md) — 3.7M weekly downloads
- [evnty](https://npm.io/package/evnty.md) — 7.2K weekly downloads
- [eleventy-plugin-asciidoc](https://npm.io/package/eleventy-plugin-asciidoc.md) — 3.5K weekly downloads
- [@jswork/next-get2get](https://npm.io/package/@jswork/next-get2get.md) — 945 weekly downloads
- [@dashersw/axon](https://npm.io/package/@dashersw/axon.md) — 934 weekly downloads

## Recent versions

- 11.0.30 (latest) — 2026-08-31
- 11.0.30-5cb617ae2 (next) — 2026-09-02
- 11.0.30-185d901cd — 2026-09-02
- 11.0.29-cef4d32cf — 2026-08-31
- 11.0.29-ac7305ccf — 2026-08-31
- 11.0.29-87dca02b0 — 2026-08-27
- 11.0.29-4a6c5d11a — 2026-08-27
- 11.0.29 — 2026-08-23
- 11.0.28-947d304ed — 2026-08-22
- 11.0.28-0967e75f5 — 2026-08-22
- 11.0.28-4dae661b4 — 2026-08-22
- 11.0.28-8786aa8d0 — 2026-08-20
- 11.0.28-55d7a539a — 2026-08-20
- 11.0.28-d5534174d — 2026-08-13
- 11.0.28-47cf9cdc1 — 2026-08-10
- … 922 more at https://npm.io/package/@libp2p/floodsub/versions

## README

# @libp2p/floodsub

[![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)

> libp2p-floodsub, also known as pubsub-flood or just dumbsub, this implementation of pubsub focused on delivering an API for Publish/Subscribe, but with no CastTree Forming (it just floods the network).

# 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.

-->

> Don't use this module

This module is a naive implementation of pubsub. It broadcasts all messages to all network peers, cannot provide older messages and has no protection against bad actors.

It exists for academic purposes only, you should not use it in production.

Instead please use [gossipsub](https://www.npmjs.com/package/@libp2p/gossipsub) - a more complete implementation which is also compatible with floodsub.

## Example - Configuring libp2p to use floodsub

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

const node = await createLibp2p({
  services: {
    pubsub: floodsub()
  }
  //... other options
})
await node.start()

node.services.pubsub.subscribe('fruit')
node.services.pubsub.addEventListener('message', (evt) => {
  console.log(evt)
})

node.services.pubsub.publish('fruit', new TextEncoder().encode('banana'))
```

# Install

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

## Browser `<script>` tag

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

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

# API Docs

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

# License

Licensed under either of

- Apache 2.0, ([LICENSE-APACHE](https://github.com/libp2p/js-libp2p/blob/main/packages/floodsub/LICENSE-APACHE) / <http://www.apache.org/licenses/LICENSE-2.0>)
- MIT ([LICENSE-MIT](https://github.com/libp2p/js-libp2p/blob/main/packages/floodsub/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/floodsub · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._