v0.1.1

n0-computer/irohv0.1.1Nov 22, 2022by b5

AI Summary

Adds client mode, indexer node support, Docker support (multi-arch), and fixes a critical bug in file adding.

Key Highlights

  • Bitswap client mode (read-only)
  • Indexer nodes support (e.g., cid.contact)
  • Docker support with multi-arch distroless builds
  • Fix for critical bug in file adding

New Features

  • Bitswap client mode
  • Indexer nodes
  • Docker support
  • Bug fix for file adding

Full Release Notes

## Bitswap client mode
Iroh can now run in "client mode", which can _fetch_ content from bitswap, but not _provide_ content. This is useful if you're running on a lower-powered device or have limited bandwidth. To use client mode change your `p2p.config.toml`:
```
bitswap_server = false
```

## Use indexer nodes to find content providers
Iroh can use network indexers like [cid.contact](https://cid.contact) to find providers of a given CID. To use the cid.contact indexer adjust your `gateway.config.toml` to add an `indexer_endpoint` URL:

```
indexer_endpoint = https://cid.contact/cid/
```

## Docker support
Iroh now ships with docker images! Spin iroh up locally with:
```
$ cd iroh/docker
$ docker-compose up
```
then run `iroh status` from another terminal if you already have iroh installed. Now you're backing iroh with docker! `docker-compose down` to stop. The docker compose file also includes helpful guidance on which ports to expose from each iroh service.

We're shipping multi-arch [distroless](https://github.com/GoogleContainerTools/distroless) builds for amd64 & arm64 architectures.

## Fixed a critical bug adding files
We fixed a [known bug](https://github.com/n0-computer/iroh/issues/423) in iroh v0.1.0 that would break `iroh add` if files referenced the same CID on the way in. It's now fixed, and now we can happily do roundtrip add/get of the linux kernel, which is always fun 😊.

https://user-images.githubusercontent.com/1154390/203409896-fe1e1815-3b2a-4692-9b3a-fa2a5c3ac0e8.mp4


## Benchmarks
Benchmarks for this release coming soon. We'll update here once they're up.

### Production Readiness
Is this production ready? **Maybe**. Numerous projects are now using iroh in the wild. *You'll need to judge for yourself if iroh meets your needs.* Please reach out on our [discussion forums](https://github.com/n0-computer/iroh/discussions) if you have questions. We're going to keep the status at "Maybe" until we release a v1.0. v1.0 is currently slated for Q4 2023.