Repository  -  API  -  Source


February 4, 2019

Fix Swarm URLs to avoid unnecessary redirects.


January 14, 2019

Fix hexValue return type in Bzz upload methods.


January 11, 2019

Fixes for TypeScript definitions.


January 9, 2019

This release introduces a large refactoring of feeds interactions, notably to provide some high-level APIs. As a result, various breaking changes were needed to keep the APIs consistent and provide more security options, as detailed below.

Breaking changes

The Bzz APIs do not provide built-in feed signing anymore

  • The createFeedDigest() and createKeyPair() functions have been removed from the @erebos/api-bzz-base and @erebos/swarm packages.
  • The Bzz instance constructor now requires to be provided a BzzConfig object rather than only the HTTP gateway url.
  • The postFeedValue() method arguments have changed.

HTTP headers must be provided as options

Most Bzz methods arguments have changed, the headers that were previously passed as argument must now be provided in the options object instead.

Additional features and APIs


December 14, 2018

Fixes for TypeScript definitions.


December 12, 2018
  • Add support for PSS raw messages introduced in Swarm v0.3.8.
  • Add TypeScript definitions for packages.


November 30, 2018
  • Fix RPC instance creation.
  • Fix PSS subscription method for Swarm v0.3.7.


November 29, 2018
  • Fix feed digest signature padding.
  • Remove usage of multihash for feed following its removal in Swarm.


November 19, 2018


  • Fix defaultPath support for uploads in api-bzz-browser and swarm-client.
  • Add --default-path flag to bzz:upload CLI command.
  • Fix flow types related to fs-extra usage.
  • Add optional headers argument to Bzz class methods.
  • Expose getDownloadURL() and getUploadURL() utility methods in Bzz class.


September 19, 2018
  • Use @erebos namespace for packages.
  • Bzz APIs refactoring.
  • Add a CLI: @erebos/cli.
  • Add a documentation website:


April 27, 2018
  • Split modules into individual packages.
  • Move RPC, transport and utilities modules to MainframeHQ/js-tools.
  • Update RxJS dependency to v6.


March 2, 2018
  • Remove createPSSWebSocket().
  • Rename BZZ to BzzAPI, PSS to PssAPI and RPC to StreamRPC.
  • Add EthAPI, NetAPI, ShhAPI, Web3API and RequestRPC classes.
  • Add transports and rpc() factories.
  • Add Client class.
  • Update documentation and add Whisper example.


December 7, 2017

Breaking API change in PSS, use the pss-apimsg-hex branch of MainframeHQ/go-ethereum to build Swarm.


Update PSS APIs to use arguments as hex following ethersphere/go-ethereum#140.


November 13, 2017

First release.