Execution roadmap

Where Swarm is headed — and what has already shipped.


The core development team is focused on three areas: improving UX and accessibility, optimising performance and scalability, and fortifying the economic-incentives model. The roadmap below groups work under these themes; the timeline at the bottom tracks what has been released.

Performance & Scalability

Keep the network fast and reliable as it grows.

Pullsync improvements

Now

More performant chunk synchronization between full nodes.

Scalability & hardening

Now

Hardening and maintenance of core components to optimise the network.

Peer verification & networking hardening

Done

Signed peer records and tighter handshakes — shipped in Bee v2.8.

UX & Accessibility

Make running and building on Swarm work from anywhere, for anyone.

AI-agent readiness

Now

Client-side primitives and Swarm MCP so AI agents can store and retrieve on Swarm.

Identity management

Now

Client-side primitives for decoupling the Ethereum identity from the node.

Messaging reliability (PSS / GSOC)

Next

Fix the case of missed messages when a node is not listening.

WebSocket transport — in-browser node support

Done

Architectural and network changes to support connections from various environments.

Feed Wrapping

Done

Wrap entire content-addressed chunks directly within feeds, eliminating the separate JSON structure with CAC references and timestamps; streamlines retrieval.

SWIP-22

Access Control Trie (ACT)

Done

A data structure storing access control information for Swarm nodes, to ensure confidentiality, integrity and availability of data spread across nodes.

SWIP-23

Incentives & Economics

Strengthen the economic model that keeps data available.

Done shipped Now in progress Next up soon Later planned · Cards marked SWIP-N are accepted community proposals — all SWIPs on GitHub →

Shipped

Every release since mainnet launch (June 2021). 211 in total.

2026 24 releases
swarm-cli v3.4.0 Jul 8, 2026
  • Trigger release of bee-js update
Read the release notes →
bee-js v12.3.1 Jul 7, 2026
  • Update openapi and bee version
Read the release notes →
bee-js v12.3.0 Jul 7, 2026
  • Add function for getting a specific global batch
  • Add minimumValidityBlocks to chainstate response
  • Add postage batch label update endpoint
Read the release notes →
bee v2.8.1 Jul 7, 2026

Bee v2.8.1 is a non-disruptive release focused on performance, data durability, and developer experience, with some operational cleanup. There are no breaking P2P protocol changes. Nodes on v2.8.0 can upgrade at any time without network-wide coordination. H…

  • SIMD-accelerated chunk hashing — Opt-in hardware-accelerated BMT hashing on Linux x86-64 (--use-simd-hashin…
  • Client-side stamping over WebSocket — The /chunks/stream endpoint now accepts pre-stamped chunks: omit the…
  • Reduced blockchain RPC traffic — The node now estimates progress from the average block time between syncs…
Read the release notes →
bee-js v12.2.2 Jun 10, 2026
  • Remove BeeDev class, use bee-factory instead
Read the release notes →
swarm-cli v3.3.0 Jun 5, 2026
  • Improve access control user experience
  • Modify access list command and introduce access show
  • Prompt for stamp, when not provided for access init
Read the release notes →
swarm-cli v3.2.0 Jun 2, 2026
  • Add neighborhood doubling related info warnings
  • Add qr option for upload command
  • Allow to omit stamp when bee url is a gateway
Read the release notes →
bee v2.8.0 May 26, 2026

Bee v2.8.0 is a feature release that strengthens how nodes verify each other. The headline change extends a peer's signed address record so that the overlay nonce and a timestamp are now part of the signature, and adds an optional on-chain chequebook check…

  • Stronger peer address records — A peer's address record (BzzAddress) now also carries a signed timestamp an…
  • Optional on-chain chequebook check — When --chequebook-verification is enabled, a peer is only trusted afte…
  • Caps on peer address lists — Peer underlay addresses are now sorted by preferred transport and trimmed to a…
Read the release notes →
bee-js v12.2.1 May 19, 2026
  • ExtendStorage should throw sensible error when it is no-op
Read the release notes →
bee-js v12.2.0 May 18, 2026
  • Handle long filenames in tar
Read the release notes →
swarm-cli v3.1.0 May 14, 2026
  • Show time data at stamp expiration
  • Show warning when new swarm-cli version is available
  • Use amount argument and unit option for stake deposit
Read the release notes →
swarm-cli v3.0.0 May 4, 2026
  • Add unit flag for cheque deposit and withraw
  • Add upload history enable, disable and status commands
  • Implement upload history
Read the release notes →
bee-js v12.1.0 Apr 27, 2026
  • Add toFloat and fromFloat to BZZ and DAI classes
  • Use depth over postageBatchId in calculateTopUpForBzz
Read the release notes →
bee-js v12.0.0 Apr 20, 2026
  • Update axios to v1.15.x to receive security fixes
Read the release notes →
bee-js v11.2.0 Apr 20, 2026
  • Add utility method to calculate topup amount based on bzz input
Read the release notes →
bee v2.7.1 Mar 23, 2026

Bee v2.7.1 is a stability-focused patch release that hardens the P2P networking layer for safe WSS (AutoTLS) adoption at scale. With v2.7.0 introducing AutoTLS and WSS support, enabling it across many nodes exposed connectivity issues — timeout starvation,…

  • P2P: Fresh connection timeout per underlay address — Each underlay address now gets its own dedicated 15-se…
  • P2P: Transport-aware address selection and filtering — Introduced a new TransportType classification system…
  • P2P: Update peer address on reconnect and optimize reacher — Replaced the reacher's internal map[string]pee…
Read the release notes →
bee-js v11.1.1 Feb 20, 2026
  • Replace uint8array body
Read the release notes →
bee-js v11.1.0 Feb 16, 2026
  • Add AbortController support for cancelling uploads
Read the release notes →
bee-js v11.0.0 Feb 10, 2026
  • Update to bee v2.7.0 api
  • Expose convertEnvelopeToMarshaledStamp and UploadProgress type
Read the release notes →
bee v2.7.0 Feb 10, 2026

The Bee team is pleased to announce the v2.7.0 release! 🎉

  • Nodes can now advertise multiple underlay addresses, enabling better connectivity for diverse network confi…
  • Added AutoTLS support for secure WebSocket connections, allowing nodes to automatically obtain and use TLS…
  • Both feed versions (legacy and wrapped) now race together automatically, removing the need for manual versi…
Read the release notes →
bee-js v10.4.0 Jan 16, 2026
  • Add utils function to map postage batch
Read the release notes →
bee-js v10.3.0 Jan 15, 2026
  • Improve soc developer api
  • Retain existing amount in extendStorage
Read the release notes →
bee-js v10.2.0 Jan 6, 2026
  • Add recursive ACT support for mantaray structures
Read the release notes →
bee-js v10.1.2 Jan 5, 2026
  • Do not allow decreasing depth in getExtensionCost
  • Release 10.1.2
  • [ci] Refactor npm publish workflow
Read the release notes →
2025 44 releases
swarm-cli v2.37.0 Dec 17, 2025
  • Rename utility get-bee command to quickstart
Read the release notes →
swarm-cli v2.36.1 Nov 7, 2025
  • Stream manifest download
Read the release notes →
bee-js v10.1.1 Oct 8, 2025
  • Allow fetching stamps with custom effective size calculations
Read the release notes →
bee-js v10.1.0 Oct 2, 2025
  • Add helpers to parse Size and Duration from string
Read the release notes →
swarm-cli v2.36.0 Oct 1, 2025
  • Add price to status
  • Do not error out in status when swap is disabled
Read the release notes →
bee-js v10.0.1 Sep 30, 2025
  • Add fallback in bytes ctor when class information is lost
Read the release notes →
bee-js v10.0.0 Aug 25, 2025
  • Add required onClose handler for pss and gsoc
  • Add erasure code and encryption parameters to storage methods
  • Add generic extend storage method
Read the release notes →
bee-js v9.8.1 Aug 11, 2025
  • Fix reference length bug in manifest unmarshalling
Read the release notes →
bee-js v9.8.0 Aug 11, 2025
  • Add debug package
Read the release notes →
bee-js v9.7.1 Aug 11, 2025
  • Allow setting index and error document in streamDirectory
Read the release notes →
swarm-cli v2.35.0 Aug 11, 2025
  • Display manifest root metadata
Read the release notes →
bee-js v9.7.0 Aug 4, 2025
  • Add isWarmingUp flag to getStatus
Read the release notes →
swarm-cli v2.34.0 Jul 31, 2025
  • Bump get-bee to download bee v2.6.0
  • Allow buying stamps in dev mode
  • Decrypt encrypted file during download
Read the release notes →
bee-js v9.6.1 Jul 30, 2025
  • Allow unmarshaling encrypted manifests
Read the release notes →
bee v2.6.0 Jul 22, 2025

The Bee team is pleased to announce the v2.6.0 release! 🎉

  • Handshake protocol bumped to v14.0.0 — nodes must upgrade to peer with v2.6 nodes (5120).
  • Import batches from postage events snapshot file. This bootstraps the node startup time and skips postage s…
  • Instead of waiting a fixed duration, nodes will now rely on kademlia peer stabilization to dynamically dete…
Read the release notes →
swarm-cli v2.33.0 Jul 3, 2025
  • Improve gateway checks
Read the release notes →
bee-js v9.6.0 Jul 3, 2025
  • Add isGateway method
Read the release notes →
swarm-cli v2.32.0 Jul 2, 2025
  • Add stake command group
  • Add wallet command group
  • Handle out of balance during postage batch creation
Read the release notes →
bee-js v9.5.0 Jun 25, 2025
  • Add withdrawable stake related methods
  • Add withdrawal to external wallets
Read the release notes →
bee-js v9.4.1 Jun 24, 2025
  • Fix property merging when request body is a large buffer
Read the release notes →
swarm-cli v2.31.0 Jun 23, 2025
  • Add rchash command
  • Add reserve information to status
  • Allow specifying bzz as staking unit
Read the release notes →
swarm-cli v2.30.0 Jun 14, 2025
  • Use wrapped feed
Read the release notes →
swarm-cli v2.29.0 Jun 5, 2025
  • Print current path for upload and timeout
  • Handle epipe on stdout and stderr silently
Read the release notes →
swarm-cli v2.28.1 Jun 2, 2025
  • Change order of status checks so chainsync comes earlier
Read the release notes →
bee-js v9.4.0 May 29, 2025
  • Add represent convenience function to data classes
Read the release notes →
bee-js v9.3.0 May 12, 2025
  • Add rchash method
Read the release notes →
bee-js v9.2.1 May 8, 2025
  • Rename get batch methods
Read the release notes →
swarm-cli v2.28.0 May 7, 2025
  • Update to new batch effective utilization table
Read the release notes →
bee-js v9.2.0 May 7, 2025
  • Update effective batch thresholds
Read the release notes →
bee-js v9.1.2 May 7, 2025
  • Fix minimum postage batch amount being off by one
Read the release notes →
swarm-cli v2.27.0 Apr 24, 2025
  • Add command to create external batch
Read the release notes →
bee-js v9.1.1 Apr 17, 2025
  • Handle case when manifest fork fully contains the new path
Read the release notes →
swarm-cli v2.26.1 Apr 1, 2025
  • Apply axios vulnerability fix
Read the release notes →
bee-js v9.1.0 Apr 1, 2025
  • Add network option, require explicit block time
  • Apply axios vulnerability fix
Read the release notes →
swarm-cli v2.26.0 Mar 25, 2025
  • Add cid command
Read the release notes →
swarm-cli v2.25.0 Mar 18, 2025
  • Upgrade bee-js to 9.0.3
  • Act download
Read the release notes →
bee-js v9.0.3 Mar 17, 2025
  • Add missing feedIndexNext fields
  • Update return type of Span.fromBigInt
Read the release notes →
swarm-cli v2.24.0 Mar 12, 2025
  • Add act commands
Read the release notes →
bee-js v9.0.2 Mar 11, 2025
  • Do not discard actHistoryAddress header for uploads
Read the release notes →
bee v2.5.0 Mar 11, 2025

The Bee team is elated to announce the v2.5.0 release! 🎉

  • Added a new profiling tool method under /debug/fgprof that profiles both CPU and I/O operations ( 4984 ).
  • Fixed an issue with the chunk streams API where the tag stats were not being updated ( 4920 ).
  • Fixed a stewardship iterator bug with respect to file references uploaded using the /bytes endpoint and era…
Read the release notes →
swarm-cli v2.23.0 Mar 10, 2025
  • Add stamp extend command
  • Update get-bee to fetch bee 2.4.0
Read the release notes →
bee-js v9.0.1 Mar 10, 2025
  • Fail Reference.isValid for odd-length hex strings
Read the release notes →
bee-js v9.0.0 Mar 10, 2025
  • Rework library for better developer experience
  • Wrong JSDoc links
Read the release notes →
bee v2.4.0 Jan 22, 2025

This release is dedicated to the memory of ldeffenb, who recently passed away.

  • Fixed a bug where pushsync requests would get stuck due to connectivity problems with the storer neighborho…
Read the release notes →
2024 46 releases
bee v2.3.2 Dec 24, 2024

This is patch release that fixes a bug where ultra-light nodes where unable to start due to some chequebook related rule changes during initialization (https://github.com/ethersphere/bee/pull/4938).

Read the release notes →
bee v2.3.1 Dec 13, 2024

This is patch release that fixes a bug where feeds uploaded prior to v2.3.0 were not retrievable from nodes running the latest release (https://github.com/ethersphere/bee/pull/4929).

Read the release notes →
swarm-cli v2.22.0 Dec 9, 2024
  • Add chainsync info to status command
Read the release notes →
swarm-cli v2.21.0 Dec 9, 2024
  • Improve onboarding flow
Read the release notes →
swarm-cli v2.20.0 Dec 8, 2024
  • Optionally deploy config in get-bee command
Read the release notes →
swarm-cli v2.19.0 Dec 5, 2024
  • Add stamp create, utility get-bee and utility redeem commands
Read the release notes →
bee v2.3.0 Dec 4, 2024
  • Allow user to specify the retrieval redundancy level in the download headers ( 4814 ).
  • Reserve size doubling allows for doubling of the reserve capacity to be able to participate in multiple sis…
  • Added a new status endpoint path, status/neighborhoods that returns the different neighborhoods the nodes i…
Read the release notes →
bee-js v8.3.1 Nov 6, 2024
  • Set tar header size
Read the release notes →
swarm-cli v2.18.0 Nov 2, 2024
  • Upgrade to bee-js 8.3
Read the release notes →
bee-js v8.3.0 Oct 24, 2024
  • Add gateway constant
  • Add support for custom http and https agents
  • Do not wrap array in data object
Read the release notes →
bee-js v8.2.0 Oct 24, 2024
  • Add envelope endpoint
  • Add head bytes endpoint
  • Add nulltopic and nullstamp
Read the release notes →
swarm-cli v2.17.0 Oct 3, 2024
  • Update to bee-js 8.1.0
Read the release notes →
bee-js v8.1.0 Oct 3, 2024
  • Harden internals
  • Handle null pinnings as empty list
Read the release notes →
swarm-cli v2.16.0 Sep 17, 2024
  • Add verbose hint to stamp list command
Read the release notes →
swarm-cli v2.15.0 Sep 17, 2024
  • Upgrade to bee-js 8
  • Handle missing chequebook in addresses command
Read the release notes →
bee-js v8.0.2 Sep 16, 2024
  • Handle bad request in feed index lookup
Read the release notes →
bee-js v8.0.1 Sep 16, 2024
  • Allow collection items with zero size
Read the release notes →
bee-js v8.0.0 Sep 13, 2024
bee v2.2.0 Sep 12, 2024
  • Added the last synced block to the status endpoint response ( 4710 ).
  • ACT feature ( 4692 ).
  • Added the ability to carry the stake to new neighborhoods and withdraw part of the stake ( 4718 4685 4720 ).
Read the release notes →
swarm-cli v2.14.0 Sep 11, 2024
  • Allow setting default stamp with stamp env
  • Update to bee-js 7.1.2
Read the release notes →
bee-js v7.1.2 Sep 10, 2024
  • Fix tar padding
Read the release notes →
bee-js v7.1.1 Aug 8, 2024
  • Correct jsdocs links
Read the release notes →
swarm-cli v2.13.1 Aug 8, 2024
  • Support identity in feed print
Read the release notes →
bee-js v7.1.0 Jul 17, 2024
  • Add capitalizeAddressERC55 function
Read the release notes →
bee-js v7.0.4 Jul 17, 2024
  • Add chaintip field
Read the release notes →
swarm-cli v2.13.0 Jun 26, 2024
  • Print feed update references
  • Do not require stamp for feed print
Read the release notes →
swarm-cli v2.12.0 Jun 26, 2024
  • Add cheque withdraw-all command
  • Disambiguate xdai and xbzz values
  • Improve stamp capacity listing
Read the release notes →
swarm-cli v2.11.0 Jun 18, 2024
  • Upgrade bee-js to 7.0.3
Read the release notes →
bee-js v7.0.3 Jun 18, 2024
  • Ignore errors while waiting for stamp
Read the release notes →
bee-js v7.0.2 Jun 17, 2024
  • Allow falsy feed index
Read the release notes →
bee-js v7.0.1 Jun 17, 2024
  • Floor update feed timestamp
Read the release notes →
swarm-cli v2.10.0 Jun 3, 2024
bee-js v7.0.0 Jun 2, 2024
bee v2.1.0 May 28, 2024
  • A new redistribution contract has been released that controls the freezing limit. 240
  • Fixed an error when uploading the same file with pinning multiple times.
  • Fixed a data race in the reserve sampler which may resolve inclusion proof related errors in the redistribu…
Read the release notes →
bee v2.0.1 Apr 25, 2024
bee-js v6.9.1 Apr 24, 2024
  • Add index param to feed writer
Read the release notes →
swarm-cli v2.9.0 Apr 15, 2024
  • Add redundancy options
Read the release notes →
bee-js v6.9.0 Mar 27, 2024
  • Add redundancy options and utils
Read the release notes →
bee v2.0.0 Mar 26, 2024
  • /dnsaddr/sepolia.testnet.ethswarm.org
  • Uploads may now be equipped with erasure coding which brings a new level of data redundancy to Swarm. ( 449…
  • Added a new API endpoint to obtain the content type and length of uploads using the /bzz endpoint with the…
Read the release notes →
bee-js v6.8.1 Mar 13, 2024
  • Add types under exports
Read the release notes →
bee-js v6.8.0 Mar 12, 2024
bee-js v6.7.4 Feb 27, 2024
  • Do not dispose arraybuffer in browser
Read the release notes →
swarm-cli v2.8.0 Feb 8, 2024
  • Speed up manifest sync
  • Upgrade to bee-js 6.7.2
Read the release notes →
bee-js v6.7.3 Feb 8, 2024
  • Increase wait for usable time
Read the release notes →
bee-js v6.7.2 Jan 17, 2024
  • Change feed index type to index
Read the release notes →
bee-js v6.7.1 Jan 17, 2024
  • Allow feed index to be 0 when downloading
  • Wait for stamp in edge cases
Read the release notes →
2023 42 releases
bee v1.18.2 Dec 14, 2023

Building upon the previous release, the sync intervals are re-synced so that nodes may collect any potentially missing chunks from the network.

  • Fixed a panic when running compact with an empty db. ( 4488 )
  • Puller historical syncing is now rate limited to not exceed 500 chunks/second. ( 4504 )
  • Puller sync intervals are reset to sync missing chunks. ( 4499 )
Read the release notes →
bee v1.18.1 Dec 7, 2023

This is a patch release that properly resets the batchstore so that batches can be resynced from the new postage stamp contract.

Read the release notes →
bee v1.18.0 Dec 6, 2023

The main theme of this release is the delivery of the last phase of storage incentives, the fourth phase, and thus the end of the storage incentive saga. For this reason, this is a breaking release, as the handshake version has been bumped. The release also…

  • The handshake protocol has been bumped as there is a new redistribution contract release
  • Introduction of a command that lists all chunk hashes for a given file
  • Swarm cache header has been added to several API endpoints (4457, 4486)
Read the release notes →
bee-js v6.7.0 Dec 4, 2023
  • Add stamp effective byte util
  • Expose stamp effective volume util
Read the release notes →
swarm-cli v2.7.0 Nov 30, 2023
  • Add all manifest commands
Read the release notes →
bee-js v6.6.0 Nov 28, 2023
  • Add reverse functions for depth and amount
  • Re-introduce BeeResponseError
Read the release notes →
swarm-cli v2.6.0 Nov 13, 2023
  • Upgrade to bee-js 6.5.1
Read the release notes →
bee-js v6.5.1 Nov 13, 2023
  • Enable unlimited uploads
Read the release notes →
bee v1.17.6 Nov 9, 2023
  • Fixed a bug where parallel uploads can cause a race condition in the uploadstore. ( 4434 )
  • Added a new DB cmd that performs a validation check of the chunks in the chunkstore. ( 4435 )
  • Added multiplexing to the retrieval protocol where a forwarding peer that can reach in to the neighborhood…
Read the release notes →
bee-js v6.5.0 Nov 5, 2023
  • Add global batches endpoint
Read the release notes →
bee-js v6.4.1 Oct 31, 2023
  • Use compatible axios
Read the release notes →
bee v1.17.5 Oct 16, 2023
  • Fixed a bug where a node can get stuck syncing the same interval if the upstream peer is unable to send the…
  • Added a new localstore compaction command that resizes sharky to the smallest size possible. ( 4329 )
  • Added a new logging guideline for contributors ( 4352)
Read the release notes →
bee v1.17.4 Sep 21, 2023

For the past few weeks, the Bee team's focus has been on improving network health, observability, and user experience.

  • Pullsync intervals are now reset when the peer's localstore epoch timestamp changes. ( 4290)
  • Fixed the issue of not being able to pass a "0" parameter in the API. ( 4301)
  • Fixed a bug where the context used for cachestore operations is canceled before a chunk can be cached. ( 43…
Read the release notes →
swarm-cli v2.5.1 Aug 31, 2023
  • Track sync progress on uploads
Read the release notes →
bee v1.17.3 Aug 31, 2023
  • Fixed a mutex bug in the localstore migration step. ( 4267)
  • Fixed a light node bug where a panic is avoided when querying ReserveLastBinIDs on ultra-light node with no…
  • Fixed a localstore leak where sharky slots of evicted chunks were not marked as free for future chunks to b…
Read the release notes →
bee-js v6.4.0 Aug 31, 2023
  • Add debug status endpoint
  • Update to new tag type
Read the release notes →
swarm-cli v2.5.0 Aug 30, 2023
  • Add hash command
  • Estimate stamp cost, capacity and ttl
  • Print less in dev mode in status command
Read the release notes →
bee-js v6.3.0 Aug 30, 2023
  • Add stamp utils
Read the release notes →
swarm-cli v2.4.1 Aug 30, 2023
  • Remove duplicate property from status command
Read the release notes →
swarm-cli v2.4.0 Aug 14, 2023
  • Add utility lock and unlock commands
  • Show stamp mutability
Read the release notes →
swarm-cli v2.3.0 Aug 12, 2023
  • Add redistribution state to status
  • Add staking support
  • Add stamp capacity
Read the release notes →
bee v1.17.2 Aug 10, 2023

With the last release we upgraded the mainnet to use the new storage layer. However, seeing the results from the redistribution game, we found some issues in it that were previously missed. The main problem we saw was that some of the pullsync indexes were…

  • Added isHealthy to redistributionstate (4243).
  • Simplify batch expiration and unreserve interaction.
  • Simplify cache handling.
Read the release notes →
bee v1.17.1 Aug 4, 2023

This is a patch release on top of the 1.17.0 release.

Read the release notes →
bee v1.17.0 Aug 4, 2023

Bee v1.17.0 is finally here. This release will be the most significant update to the bee client in a long time and will be a breaking release due to protocol and API changes. The Bee team has been working on the new storage layer for quite some time now. Th…

  • Support multiple stamps on chunks. Chunks uploaded with different stamps will be tracked separately in the…
  • Stewardship PUT endpoint now allows users to configure a stamp to use for re-upload. This would allow users…
  • /tags endpoint is now consolidated on the main API. The debug API tags endpoint is deprecated. Also, the ta…
Read the release notes →
bee-js v6.2.0 Aug 3, 2023
  • Add new redistribution state properties
Read the release notes →
bee-js v6.1.0 Aug 1, 2023
  • Add http adapter option to bee and bee debug
Read the release notes →
bee-js v6.0.0 May 22, 2023
  • Adds streaming upload support for single files
  • Fixes a segmentation fault when running tests in a project where bee-js is a dependency
  • Fixes incompatibilities between Node versions 16, 18 and 19
Read the release notes →
bee v1.16.1 May 19, 2023

This one is a patch release to address a bug found in the new salud service.

  • Fixed a panic in the salud service when the response to the status request is terminated early by the peer.…
Read the release notes →
bee v1.16.0 May 17, 2023
  • The status protocol now includes the reachability of a peer and the total batch commitment of the network r…
  • Fixed the last played round field in the redistribution state endpoint to report the corrent round instead…
  • Loosed the requirements of the pushsync protocol so that in the case a neighborhood is down or does not exi…
Read the release notes →
swarm-cli v2.2.0 May 11, 2023
  • Upgrade to latest bee-js
Read the release notes →
bee v1.15.0 May 1, 2023
  • Pushync forwarding nodes one hop from the neighborhood multiplexes the chunk to multiple storer nodes in th…
  • Blocklist endpoint now correctly display the mode and reason of the blocklisting of the peer.
  • Storage radius decreasing based on reserve size increased back to 50% threshold.
Read the release notes →
bee v1.14.1 Apr 19, 2023
bee v1.14.0 Apr 11, 2023
  • The handshake protocol has been bumped as there is a new redistribution contract release.
  • Added a new global "sticky" skiplist to the retrieval protocol, similar to the pushsync, so that different…
  • Added a new debugging "status" protocol which acquires all connected peers' storage radius, reserve size, a…
Read the release notes →
swarm-cli v2.1.0 Mar 29, 2023
  • Add streaming upload for single files
Read the release notes →
swarm-cli v2.0.1 Mar 28, 2023
  • Fix stamp invalid date error
Read the release notes →
swarm-cli v2.0.0 Mar 16, 2023
  • Drop node 12 support
  • Upgrade bee-js to support bee 1.13
  • Change "supported version" to "tested with"
Read the release notes →
bee v1.13.0 Mar 6, 2023

Bee v1.13.0 is here!

  • Skip the redistribution game on insufficient funds
  • Redistribution endpoint panic
  • Disallow unknown parameters in config
Read the release notes →
bee-js v5.2.0 Feb 20, 2023
  • Add redistribution state endpoint
Read the release notes →
bee v1.12.0 Feb 16, 2023

The Bee team is excited to announce the latest release!

  • The puller also does syncing of proximity order bin with peers outside of the neighborhood and the pushync…
  • Rewrote the retrieval protocol to improve readability and maintainability.
  • Increased the size of the batch of chunks pulled per a single pullsync request.
Read the release notes →
bee-js v5.1.2 Feb 3, 2023
bee v1.11.1 Jan 20, 2023

This release is a patch release to fix an issue seen during the latest migration done on upgrade to v1.11.0. This causes the node to fail on boot up and hence node operators are advised to update to v1.11.1 directly if they haven't updated to v1.11.0.

  • Ignore errors that are not fatal on the residual migration.
Read the release notes →
bee v1.11.0 Jan 19, 2023

The Bee team is excited to announce the latest release which mostly consists of minor fixes to chunk syncing and improved uploading experience.

  • The node is interruptible while it's waiting for the NAT initialization.
  • Batch synchronization can now be gracefully suspended on interrupt signal.
  • Removed old overlay mining logic from the codebase.
Read the release notes →
2022 29 releases
bee-js v5.1.1 Dec 21, 2022
  • Backward compatibility for wallet ep
  • Staking ep url change
Read the release notes →
bee v1.10.0 Dec 20, 2022

The last release was one of the most substantial upgrades to the Swarm network since the mainnet launch. With the storage incentives, nodes could stake BZZ and take part in the schelling game. This was disabled by default as we were testing the entire syste…

  • Rewrite of the puller and pullsync package. This was done to make syncing more resilient to errors and also…
  • The localstore package was heavily refactored. This includes some changes to how the node stores indexes re…
  • For the wallet endpoint, fields now have better names, and features a new wallet address field.
Read the release notes →
bee-js v5.1.0 Nov 11, 2022
  • Add readiness endpoint
  • Staking endpoint support
Read the release notes →
bee v1.9.0 Oct 17, 2022

The Bee team is excited to announce the latest release which includes the second phase of the storage incentives! The release also includes a myriad of hardenings and bug fixes that can be found below.

  • Deprecated the gateway mode. 3265
  • Mined or new overlays are preserved on db nuke. 3384
  • Enabled more linting rules on the codebase. (3304, 3305, 3299)
Read the release notes →
bee v1.8.2 Sep 23, 2022

This small release includes a new accurate reserve size calculation method for the depthmonitor which helps the storage/eviction radius decrease to a more accurate value. The depthmonitor change affects the neighborhood size of the pullsync protocol so it i…

  • Reserve size to only consider chunks with promixity order greater than or equal to storage radius for the d…
Read the release notes →
bee v1.8.1 Sep 15, 2022

This release is a patch release to fix the postage stamp smart contract issues observed on the mainnet. Node operators will need to upgrade as soon as possible.

  • Postage stamp contract address update and batchstore reset.
  • Set the stamp expired field to false if batch exists in batchstore.
Read the release notes →
bee v1.8.0 Sep 13, 2022

The Bee team is excited to announce the latest release which brings the storage incentives a step closer. The first phase of the implementation brings the need to upgrade the postage stamp contract. This is going to be a breaking release, meaning that the p…

  • Postage contract update. The new postage contract will make the postage batches redistributable.
  • Overlay address calculation change.
  • Depth Monitor service to dynamically adjust storage depth of node based on utilization.
Read the release notes →
swarm-cli v1.12.0 Aug 31, 2022
  • Add top level balance command
  • Calculate and show stamp cost
  • Display stamp expiration date
Read the release notes →
bee-js v5.0.0 Jul 28, 2022
  • We have removed interfaces DebugPostageBatch (for PostageBatch) and NodesInfo (for NodeInfo).
  • We have changed the cid property of the UploadResultWithCid interface to be a function instead of getter as…
  • We have enabled by default waiting for the newly created postage batches to be usable (originally the waitF…
Read the release notes →
bee v1.7.0 Jul 24, 2022

Due to an unanticipated behavior of library updates that were done in the last release, we are rolling back some of the changes, alongside some significant bug fixes for the retrieval protocol which has resulted in a protocol logic change that has necessita…

  • Improve postage snapshot bootstrapper reliability.
  • Add support for OPTIONS method on the API endpoints.
  • Revert the go1.18 and libp2p updates.
Read the release notes →
bee v1.6.3 Jul 20, 2022

This release is mostly a patch release to fix some issues observed on the mainnet related to high CPU consumption of Bee nodes. Bee client now uses go1.18. There are a couple of other fixes also included, please go through the changelog for more information.

  • Update to go 1.18 (2941, 3102)
  • Bump geth to v1.10.18.
  • Retry push sync when overdraft peer might be closest one.
Read the release notes →
bee v1.6.2 Jun 29, 2022

With the summer solstice behind us, the Bee team is excited to announce the latest release v1.6.2. This release consists of some new features, performance recalibrations and also some bug fixes.

  • Improve kademlia saturation peers count calculation.
  • Increase kademlia bit suffix length to improve bin population. This should improve overall connectivity of…
  • Make postage snapshot bootstrapper more resilient with retries on failure.
Read the release notes →
bee v1.6.1 Jun 1, 2022

The Bee team is happy to announce the latest release v1.6.1. The release contains a myriad of bug fixes, codebase hardenings, and a few new features. A particular highlight is the segment inclusion Merkle proofs we've now added that paves the ground for mor…

  • Logging is reduced on startup during bootstrapping
  • Peer connection attempt from kademlia is skipped if peer is already block-listed
  • Added new reservestate total batch commitment metric
Read the release notes →
bee-js v4.1.1 May 26, 2022
  • Move sleep to have all code in src
Read the release notes →
bee-js v4.1.0 May 26, 2022
  • Cids support
  • Expose underlying undici error messages
  • Support for waiting on stamp to be usable
Read the release notes →
bee-js v4.0.0 May 19, 2022
  • Updated interface returned by BeeDebug.getReserveState() based on Bee 1.6.0
  • Ens support for download methods
  • Fetch specific feed index update
Read the release notes →
bee v1.6.0 May 13, 2022

This latest release is an accumulation of a lot of work done in the last couple of months by the team. We've improved and refactored substantial amount of components and areas of the codebase as well as fixed a few critical bugs. After deploying this versio…

  • Global pinning has been discontinued from bee. We're looking for ways to enable this sort of solution as an…
  • Nodes will now try to connect to the mainnet by default. In order to connect to the testnet you must specif…
  • Chain syncing errors will again result in 24h blocking
Read the release notes →
swarm-cli v1.11.0 Apr 14, 2022
  • Add top level --yes option
  • Display stamp label
  • Update to bee-js 3.3.4 version
Read the release notes →
bee-js v3.3.4 Apr 12, 2022

This is a small patch release that brings mainly support for the new Bee 1.5.1 and two small bug fixes.

  • Nodeinfo interface
  • Remove browser blob polyfill for service workers support
Read the release notes →
bee v1.5.1 Apr 7, 2022

This is a hotfix release over v1.5.0 version, which was released a few weeks back. While testing the release we fixed a few critical issues. A combination of these fixes, the sharky changes and the way we run some of our automated tests, we found an interes…

Read the release notes →
bee-js v3.3.3 Mar 25, 2022
  • Relax es version requirements
Read the release notes →
bee-js v3.3.2 Mar 21, 2022

This is another small release that brings support for Bee 1.5.0 and a few small improvements.

  • Add cross-env to devDeps
  • Add ultra light bee mode
  • Replace deprecated type DebugPostageBatch with PostageBatch
Read the release notes →
bee v1.5.0 Mar 21, 2022

The Bee team is happy to announce the latest release v1.5.0. This release comes with major changes to the way the bee node stores data locally.

  • Cc80f74c Allow duplicate handshakes
  • E46af6cc Use testing.TempDir to create temporary test directories
  • 4ce3f7df Stamps endpoint amount value OpenAPI specification
Read the release notes →
bee-js v3.3.1 Feb 16, 2022

This is a patching release that targets especially issues discovered thanks to the introduction of the ESM hybrid build. The main change is that if you want to use the function Utils.readableWebToNode() in browser then you have to polyfill stream package wi…

  • BeeDebug.isSupportedExactVersion() - renamed isSupportedVersion which is now deprecated
  • BeeDebug.isSupportedMainApiVersion() which checks compatibility only for the main Bee endpoint
  • BeeDebug.isSupportedDebugApiVersion() which checks compatibility only for the Bee Debug endpoint
Read the release notes →
bee-js v3.3.0 Feb 10, 2022

This is a smaller update with two main changes.

  • BeeDebug.isSupportedExactVersion() - renamed isSupportedVersion which is now deprecated
  • BeeDebug.isSupportedMainApiVersion() which checks compatibility only for the main Bee endpoint
  • BeeDebug.isSupportedDebugApiVersion() which checks compatibility only for the Bee Debug endpoint
Read the release notes →
bee v1.4.3 Feb 8, 2022

This is a hotfix release over the last v1.4.2 release. We've identified certain issues relating to libp2p configuration in addition to a protocol stream leak and have therefore deployed a quick fix to alleviate the issues. You are strongly advised to update…

  • Dc65b535 fix(chainsync): stream leak
  • 5d1bcf21 fix: revert libp2p update and increase config limits
Read the release notes →
bee v1.4.2 Feb 8, 2022

This latest release is our first release for this year. We've been working on solving problems observed on the mainnet and we've shipped plenty of bugfixes with this version. Stay tuned for our upcoming releases as we pick up the pace of regular updates.

  • Increase kademlia minimum neighborhood size
  • Avoid peer pruning while peer is blocklisted. this caused peers to disappear from the known peers list prem…
  • Refine chainsyncer logic to be less aggressive
Read the release notes →
swarm-cli v1.10.0 Feb 4, 2022
  • Add identity show command
  • Add identity rename command
  • Improve identity command workflows
Read the release notes →
bee-js v3.2.0 Jan 25, 2022

This is after some time a bigger update that brings some new goodies from Bee 1.4.1 version and improved error handling and support.

  • Interface DebugPostageBatch was renamed to PostageBatch
  • Interface NodesInfo was renamed to NodeInfo
  • Direct upload support
Read the release notes →
2021 26 releases
swarm-cli v1.9.0 Dec 21, 2021
  • Add feed download
  • Add node info to status command
  • Bzz.link support
Read the release notes →
bee-js v3.1.0 Dec 10, 2021

This is another small release that brings support for Bee 1.4.1 and a few small improvements

  • Exposing chunk functionality
  • Node endpoint support
  • Stamp usage utility function
Read the release notes →
bee v1.4.1 Dec 8, 2021

Dear community and friends, the Bee team is proud to announce the latest release v1.4.1.

  • Time-based settlements now enforce 10% of the observed mainnet performance for light nodes. This means that…
  • The Bee node will now create an Eth V3 compatible key by default (applies to new keys only!)
  • Kademlia balancing has been improved
Read the release notes →
swarm-cli v1.8.0 Nov 26, 2021
  • Add bee 1.4.0 compatibility and upgrade to bee-js 3.0.0
Read the release notes →
bee-js v3.0.0 Nov 25, 2021

This is a small release in size, but big on impact. It is a breaking release thanks to breaking changes introduced in Bee 1.4.

  • Dropping postage stamps methods from Bee class
  • Dropping bee class postage stamps methods
  • Openapi versions in /health endpoint and methods
Read the release notes →
bee v1.4.0 Nov 24, 2021

Bee v1.4.0 is finally here and it includes a major change to protocol behavior that will significantly improve the network resilience. From now on, your nodes will have to be accessible from public CIDRs for them to participate in our core protocols. We've…

  • Starting from v1.4.0, only nodes which are reachable from the public CIDRs are used for core protocols. Old…
  • The /stamps endpoints on the normal API which have been deprecated three months ago have been finally remov…
  • The bee node will now wait up to ten minutes before forcing a restart due to a stalled blockchain backend
Read the release notes →
swarm-cli v1.7.0 Nov 18, 2021
  • Add --stdin option to upload command
  • Add --hide-usage option to stamp list command
  • Add --header global option to set additional headers
Read the release notes →
bee-js v2.1.1 Nov 8, 2021

This is small release that fixes few small issues and mainly brings compatibility with the Bee 1.3.

  • Sourcemap
  • Readable-stream should be dependency
  • Limit the scope of files that are published to npm
Read the release notes →
swarm-cli v1.6.0 Nov 4, 2021
  • Add top level download command
  • Display number of updates in feed print command
  • Print curl commands in distinct color
Read the release notes →
bee v1.3.0 Oct 27, 2021
  • The chainsync protocol will now block peers that don't agree on the same block hash of a certain block heig…
  • Removed support for QUIC protocol. We will reinstate this feature in a future point where we can fully supp…
  • Removed dead code from the bitvector package
Read the release notes →
swarm-cli v1.5.0 Oct 15, 2021
  • Add bee 1.2.0 and bee-js 2.1.0 compatibility
  • Add content-type flag and mime detection
  • Add dilute and topup stamp commands
Read the release notes →
bee-js v2.1.0 Oct 13, 2021

This release is a compatibility release with Bee 1.2.0 release, which brings few new features.

  • Increased max pss target limit
  • Is reference retrievable support
  • Topup and dilute batch methods
Read the release notes →
bee v1.2.0 Oct 7, 2021
  • Avoid advertising private CIDR underlays to the public network
  • Kademlia will now periodically ping all connected peers and will blocklist peers that consistently don't an…
  • Pushsync will continue forwarding if replication fails
Read the release notes →
swarm-cli v1.4.0 Sep 29, 2021
  • Add manifest commands
  • Improve error logging and troubleshooting
  • Print bee api urls in status command
Read the release notes →
bee-js v2.0.0 Sep 23, 2021

This is our first major version bump as we did a big revamp of bee-js internals and fixed a few things and shortcomings that required breaking changes.

  • Requests made by bee-js are now reported with User-Agent: bee-js/<<bee-js's version
  • Utils.setDefaultHeaders() was removed in favor of Bee/BeeDebug instance's option defaultHeaders
  • Hooks
Read the release notes →
bee-js v1.2.1 Aug 27, 2021

This is a small patch release that fixes wrongly reporting incompatible version with Bee 1.1.0 builds for Mac and Windows. Related to https://github.com/ethersphere/bee/pull/2451

  • Bee 1.1.0 version reporting workaround
Read the release notes →
swarm-cli v1.3.0 Aug 25, 2021
  • Add bee 1.1.0 compatibility
  • Add immutable flag to stamp buy command
  • Enforce explicit debug api when normal api is provided
Read the release notes →
bee-js v1.2.0 Aug 24, 2021

This is mainly a compatibility release with Bee 1.1.0 release.

  • List pending transactions
  • Rebroadcast already created (pending) transaction
  • Cancel a pending transaction
Read the release notes →
bee v1.1.0 Aug 23, 2021
  • We renamed log field traceid to traceID
  • Standalone mode has been phased out (in favor of dev mode, see below)
  • PATCH under the /bzz endpoint has been moved to the stewardship endpoint. Please use that instead
Read the release notes →
swarm-cli v1.2.0 Jul 21, 2021
  • Add --curl global option
  • Add auto-completion system
  • Add spinner to feed operations
Read the release notes →
bee-js v1.1.1 Jul 21, 2021

This is a small patch release that fixes missing headers in requests/responses returned using the hooks system.

  • Provide all request headers
Read the release notes →
bee-js v1.1.0 Jul 20, 2021

This is a small incremental release that brings two new features.

  • Hooks system
  • New tags endpoints
Read the release notes →
swarm-cli v1.1.0 Jul 5, 2021
  • Switch to streaming upload in case of single files
  • Add --encrypt to upload
  • Add --drop-name to upload
Read the release notes →
swarm-cli v1.0.0 Jun 22, 2021
  • Add addresses command
  • Add new stamp properties
  • Add filter, sort and limit to stamp list
Read the release notes →
bee-js v1.0.0 Jun 22, 2021

This release bumps the supported Bee version to 1.0.0, which marks the mainnet launch of the project.

  • Release 1.0.0
Read the release notes →
bee v1.0.0 Jun 21, 2021
  • The mainnet will become operational soon. Please follow Swarm's twitter (@ethswarm) to be among the first B…
  • The Goerli testnet (network id 10) will be reset today - June 21, 2359 CET.
  • The BZZ token addresses are:
Read the release notes →

Missing something?

Suggest on Discord or propose a SWIP

Disclaimer:

The themes and timeframes outlined in this roadmap are subject to change.