# @helia/fallback-router

> A Helia router that yields hard coded providers

Latest version **1.1.1** (published 2026-07-28) · Apache-2.0 OR MIT license · 0 weekly downloads

## Install

```sh
npm install @helia/fallback-router
pnpm add @helia/fallback-router
yarn add @helia/fallback-router
bun add @helia/fallback-router
```

## 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 | 1.1.1 |
| Published | 2026-07-28 |
| First published | 2026-06-15 |
| Weekly downloads | 0 |
| License | Apache-2.0 OR MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 4 |
| Unpacked size | 226.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1346 |
| Maintainers | npm-service-account-ipfs, achingbrain |
| Keywords | IPFS |

## Links

- npm: https://www.npmjs.com/package/@helia/fallback-router
- Repository: https://github.com/ipfs/helia
- Homepage: https://github.com/ipfs/helia/tree/main/packages/fallback-router#readme
- Issues: https://github.com/ipfs/helia/issues
- npm.io page: https://npm.io/package/@helia/fallback-router

## Dependencies (4)

- [uint8arrays](https://npm.io/package/uint8arrays.md) ^6.1.1
- [multiformats](https://npm.io/package/multiformats.md) ^14.0.0
- [@helia/interface](https://npm.io/package/@helia/interface.md) ^7.1.1
- [@multiformats/uri-to-multiaddr](https://npm.io/package/@multiformats/uri-to-multiaddr.md) ^10.0.0

## Recent versions

- 1.1.1 (latest) — 2026-07-28
- 1.1.1-16fc74d3 (next) — 2026-09-10
- 1.1.1-6c96dd38 — 2026-08-22
- 1.1.1-91ed35a4 — 2026-08-21
- 1.1.1-dc9e15bc — 2026-08-21
- 1.1.1-ae012cf9 — 2026-08-21
- 1.1.1-cd1c4a76 — 2026-08-20
- 1.1.1-c9f35dab — 2026-08-19
- 1.1.1-ca4dee6f — 2026-08-15
- 1.1.1-3aeb3977 — 2026-08-15
- 1.1.1-56f87f03 — 2026-08-15
- 1.1.1-e1cc85b9 — 2026-08-14
- 1.1.1-0873bb5f — 2026-08-14
- 1.1.1-0b5ca22f — 2026-08-13
- 1.1.1-7167f9f1 — 2026-08-13
- … 29 more at https://npm.io/package/@helia/fallback-router/versions

## README

<p align="center">
  <a href="https://github.com/ipfs/helia" title="Helia">
    <img src="https://raw.githubusercontent.com/ipfs/helia/main/assets/helia.png" alt="Helia logo" width="300" />
  </a>
</p>

# @helia/fallback-router

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

> A Helia router that yields hard coded providers

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

-->

A fallback router yields preconfigured providers to enable Helia to fallback
to using a trustless gateway to fetch content from peers that support
transports that may not be available in Helia's environment

For example this allows browser peers to fetch content from network nodes
that only support TCP or QUIC connections.

# Install

```console
$ npm i @helia/fallback-router
```

## Browser `<script>` tag

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

```html
<script src="https://unpkg.com/@helia/fallback-router/dist/index.min.js"></script>
```

# API Docs

- <https://ipfs.github.io/helia/modules/_helia_fallback-router.html>

# License

Licensed under either of

- Apache 2.0, ([LICENSE-APACHE](https://github.com/ipfs/helia/blob/main/packages/fallback-router/LICENSE-APACHE) / <http://www.apache.org/licenses/LICENSE-2.0>)
- MIT ([LICENSE-MIT](https://github.com/ipfs/helia/blob/main/packages/fallback-router/LICENSE-MIT) / <http://opensource.org/licenses/MIT>)

# Contribute

Contributions welcome! Please check out [the issues](https://github.com/ipfs/helia/issues).

Also see our [contributing document](https://github.com/ipfs/community/blob/master/CONTRIBUTING_JS.md) for more information on how we work, and about contributing in general.

Please be aware that all interactions related to this repo are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).

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.

[![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md)

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