@erebos/keccak256 - npm Package Versions

v0.13.1 (2020-01-16)

• Fix type signature of the write() method of TimelineWriter.
• Bump dependency version of @erebos/hex in @erebos/keccak256.

v0.13.0 (2020-01-16)

Breaking changes

• The bzz-related packages have been refactored, the @erebos/api-bzz-base, @erebos/api-bzz-browser and @erebos/api-bzz-node packages are discontinued and should be replaced by @erebos/bzz, @erebos/bzz-browser, @erebos/bzz-node, @erebos/bzz-feed and @erebos/bzz-fs depending on the use cases, see below.
• The @erebos/api-pss package has been renamed to @erebos/pss for consistency with the bzz-related packages.
• In the @erebos/timeline package, the decode option has been removed from TimelineReaderConfig and the encode option from TimelineWriterConfig, instead the read() and write() methods could be overwritten to cover the use case.
• The createHex() function has been removed from @erebos/hex, Hex.from() should be used instead.
• The @erebos/feed-list and @erebos/timeline packages classes now need to be injected a BzzFeed instance.

Bzz packages changes

One goal for Erebos has been to stay quite low-level, at least for the core packages interacting with Swarm. As the bzz-related packages have been growing over the past releases, it's been time to reconsider how to best organize them:

• Support for Swarm feeds requires additional dependencies such as @erebos/hex, @erebos/keccak256 and rxjs that can be an additional burden for apps that don't need feeds, so all the feed-related methods have been extracted to the @erebos/bzz-feed package.
• @erebos/api-bzz-node provided additional methods to interact with the file system. These methods are now provided by the dedicated @erebos/bzz-fs package.
• The @erebos/bzz package can now be used directly in browsers. However, it does not provide the downloadDirectory() and uploadDirectory() methods added in the @erebos/bzz-browser and @erebos/bzz-node packages.

So what package should you use?

• If you use node: @erebos/bzz-node
• Target a browser environment?
  • If you need to use the downloadDirectory() or uploadDirectory() method: @erebos/bzz-browser
  • Otherwise: @erebos/bzz
• Use React Native?
  • Try the experimental @erebos/bzz-react-native
  • Extend @erebos/bzz as needed
• For any other environment, try extending @erebos/bzz

If you need to interact with feeds, use @erebos/bzz-feed.

If you want to interact with the file sytem when using node, the @erebos/bzz-fs package provides the utility methods previously implemented in @erebos/api-bzz-node.

New package

The @erebos/doc-sync package has been added, allowing to synchronize JSON documents.

v0.11.0 (2019-11-28)

This release adds support for Readable streams in @erebos/api-bzz-base, thanks to Adam Uhlíř's pull request.

Breaking change

The uploadFileStream() method of @erebos/api-bzz-node has been removed, uploadFile() now supporting streams.

Additional features

• The downloadObservable() and downloadDirectoryData() methods have been added to @erebos/api-bzz-base and are therefore also available in @erebos/api-bzz-browser. Until now they were only available in @erebos/api-bzz-node.
• The downloadStream() method has been added.
• The uploadFile() and upload() methods now support a Readable stream input.

Other change

The code base and type definitions have been updated to TypeScript 3.7 thanks to Adam Uhlíř's pull request.

v0.10.0 (2019-10-01)

Breaking changes

• The PollOptions interface of the Bzz API has been changed and is now used by the Timeline API. The PollFeedOptions interface is now used for polling feeds.
• The PollOptions interface of the Timeline API has been removed, now using the interface exported by the Bzz API.

Swarm v0.5 support

Erebos v0.10 adds support for 2 new features added to the Swarm v0.5 release:

v0.9.0 (2019-08-12)

Breaking changes

TypeScript rewrite

The main change in this release is the code base being rewritten in TypeScript. As part of these changes, the library no longer uses ES modules default exports but only named exports, such as:

• import { Bzz } from '@erebos/api-bzz-node'
• import { Pss } from '@erebos/api-pss'
• import { createHex } from '@erebos/hex'

Pss module changes

• The EMPTY_HEX constant has been renamed to EMPTY_ADDRESS.
• The sendRaw(), setPeerPublicKey() and setSymmetricKey() methods of the Pss class no longer set a default address value, use EMPTY_ADDRESS if needed.

Browser module namespacing

The @erebos/swarm-browser package now exports its contents in the Erebos.swarm namespace instead of Erebos. For example Erebos.swarm.SwarmClient() should be used instead of Erebos.SwarmClient().
The browser builds (in the dist folder) have been renamed from erebos.development.js and erebos.production.js to erebos.swarm.development.js and erebos.swarm.production.js to better reflect this change.

Additional features

• The downloadTarTo() method has been added to @erebos/api-bzz-node.
• The experimental @erebos/api-bzz-react-native has been added by Mark Vujevits in PR #98.

Other changes

• The sign() and verify() functions exported by the @erebos/secp256k1 package now accept a BNInput input value as exported by the elliptic package.
• The addChapter() method of the Timeline class now calls createChapter(), so default values for the chapter will be injected.
• Fixed links to Swarm install & run (by thecryptofruit in PR #108).
• Docs have been updated to expose TypeScript interfaces rather than Flow types.

v0.7.0 (2019-03-18)

Breaking changes

• The feed parameters object has been changed to include the required user field and remove the signature one. The added feed update parameters object should be used for feed updates.
• The feed-related Bzz methods arguments have changed as the result of the feed parameters object change: rather than having a mandatory "user or hash" argument and a separate feed parameters argument, a single "hash or feed parameters" argument is now used. This change affects the getFeedURL(), createFeedManifest(), getFeedMetadata(), getFeedValue(), pollFeedValue(), postSignedFeedValue(), postFeedValue(), updateFeedValue() and uploadFeedValue() methods.
• The feed digest signing function in the Bzz class configuration has been renamed from signFeedDigest to signBytes, to reflect the fact it could be used in other contexts.
• The second argument of the createKeyPair() function in @erebos/secp256k1 has been removed, as hex is the only supported value it is set by default.

Additional features

• The @erebos/hex module now supports bytes array (Array<number>) as an input type and output using the .toBytesArray() method.
• The createPublic() and verify() functions have been added to the @erebos/secp256k1 package.
• The @erebos/timeline package has been added, providing an implementation of the Timeline protocol. Its API is available in the documentation website.

Other changes

The website has been redesigned and additional examples have been added: erebos.js.org

v0.6.0 (2019-01-09)

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

• The @erebos/keccak256 and @erebos/secp256k1 packages have been added.
• Bzz requests now support a timeout option, and a default timeout can optionally be set in the BzzConfig object when creating the instance.
• Various feed-related APIs and options have been added. Check the updated Bzz API documentation for more details.