Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Changes before Tatum release are not documented in this file.

Unreleased

Breaking Changes

General

Added

Changed

@streamr/sdk

Added

Changed

Fixed

@streamr/node

Added

Changed

Deprecated

Removed

Fixed

Security

@streamr/cli-tools

Added

Changed

Deprecated

Removed

Fixed

Security

[103.3.2] - 2026-07-29

General

Changed

• Removed the deprecated polygon-rpc.com from the set of default RPCs for Polygon

103.3.1 - 2026-02-03

General

Added

• Add timers-browserify polyfill to @streamr/dht for standalone browser usage (#3379)

103.3.0 - 2026-01-29

Breaking Changes

• BREAKING CHANGE: The following packages no longer include all source files in dist. They now export bundled artifacts for ESM, CJS, and TypeScript declarations only:

  • @streamr/sdk
  • @streamr/utils
  • @streamr/dht
  • @streamr/proto-rpc
  • @streamr/test-utils
  • @streamr/autocertifier-client
  • @streamr/trackerless-network

  If you previously relied on importing internal files directly from dist, you must update your imports to use the package's public exports.

General

Added

• Expose cross-environment cryptographic utilities from @streamr/utils for both browser and Node.js (#3342):
  • AES cipher utilities: createCipheriv, createDecipheriv
  • Hash functions: computeMd5, computeSha1
  • RSA utilities: publicEncrypt, privateDecrypt
  • Random bytes: randomBytes (re-exported from @noble/post-quantum/utils)
  • Types: CryptoKey, Jwk
• Bundle a limited browser-compatible version of autocertifier-client (#3340)

Changed

• Internal packages now produce separate bundles for browser and Node.js environments, improving tree-shaking and reducing polyfill requirements (#3321, #3322, #3330, #3333, #3335, #3336, #3337, #3338, #3339)

@streamr/sdk

Added

• Bundle @streamr/sdk for browser (no polyfills required!) and for Node.js (#3358)

Changed

• BREAKING CHANGE: The package no longer provides a default export. Use named imports instead: import { StreamrClient } from '@streamr/sdk'. The UMD bundle remains accessible via window.StreamrClient. (#3358)
• Use named StreamrClient export and explicit type import syntax (#3369)
• Use named imports for EventEmitter from eventemitter3 (#3366)

Fixed

• Resolve circular dependencies in the SDK package (#3361, #3367)
• Clean-up tsyringe setup (#3362)
• Fix ES module compatibility for migrations URL resolution (#3373)

@streamr/browser-test-runner

Added

• Support TypeScript karma-setup files (#3368)

103.2.2 - 2026-01-19

General

Changed

• Update package lock files

103.2.1 - 2026-01-19

General

Fixed

• Fix outdated GitHub URLs referencing old network-monorepo repository instead of network (https://github.com/streamr-dev/network/pull/3348)

@streamr/sdk

Changed

• Resolve selected circular dependencies in the SDK package (https://github.com/streamr-dev/network/pull/3351)

@streamr/utils

Changed

• Make executeSafePromise work in browsers without polyfills (https://github.com/streamr-dev/network/pull/3310)
• Use explicit logger scopes instead of NodeJS-specific module (https://github.com/streamr-dev/network/pull/3309, https://github.com/streamr-dev/network/pull/3317)

Fixed

• Fix logger id type handling after minimization

@streamr/autocertifier-server

Added

• Delete unused DNS records in batches from Route53 (https://github.com/streamr-dev/network/pull/3346)

Fixed

• Wait for acme-challenge record to propagate (https://github.com/streamr-dev/network/pull/3347)
• Add error handling for delete records operation (https://github.com/streamr-dev/network/pull/3349)
• Only delete existing records from Route53 (https://github.com/streamr-dev/network/pull/3350)

103.2.0 - 2025-12-18

@streamr/sdk

Added

• Proxy connections now support bidirectionality and it is the default behavior (https://github.com/streamr-dev/network/pull/3260)
• Add StreamrClient#findProxyNodes() function for discovering proxy nodes via Operator nodes (https://github.com/streamr-dev/network/pull/3257)
• Add StreamrClient#publishRaw() for publishing raw messages (https://github.com/streamr-dev/network/pull/3280)
• Add new keys configuration to the encryption section (https://github.com/streamr-dev/network/pull/3284)
• Add new validation configuration section (https://github.com/streamr-dev/network/pull/3302)
• Add new configuration options for controlling content delivery buffering (https://github.com/streamr-dev/network/pull/3305)

Removed

• Remove StreamrClient#findOperators() function which was marked as internal (https://github.com/streamr-dev/network/pull/3257)

@streamr/node

Changed

• Bump autostaker's fixed gas limit for actions from 500k gas to 750k gas

@streamr/cli-tools

Added

• Add --partition flag to stream publish (https://github.com/streamr-dev/network/pull/3262)
• Add --with-metadata flag to stream publish (https://github.com/streamr-dev/network/pull/3265)
• Add --binary flag to stream publish and stream subcribe (https://github.com/streamr-dev/network/pull/3282)
• Add --raw flag to stream publish (https://github.com/streamr-dev/network/pull/3282)

Fixed

• Signature output in subscribe --with-metadata (https://github.com/streamr-dev/network/pull/3245)
• Error handling of --partition flag in subscribe (https://github.com/streamr-dev/network/pull/3263)

103.1.2 - 2025-11-21

@streamr/sdk

Changed

• Update default list of JSON RPC urls for Polygon (removed a dead one)

@streamr/node

Changed

Autostaker changes:

• transaction timeouts (https://github.com/streamr-dev/network/pull/3236)
• queries filter by required block number (https://github.com/streamr-dev/network/pull/3238)
• autostaker fixes and optimizations (https://github.com/streamr-dev/network/pull/3237)

103.1.1 - 2025-11-11

@streamr/sdk

Changed

• Update default list of JSON RPC urls for Polygon (replace a dead one with a working one) (https://github.com/streamr-dev/network/pull/3227)

@streamr/node

Changed

• Autostaker changes: (https://github.com/streamr-dev/network/pull/3227)
  • bump gas limit on stake/unstake calls by 20% to defend against too low estimates in case contract change rapidly changes
  • retry actions that fail in preflight check
  • guard against subgraph not being up to date when a new sponsorship event is seen on chain
  • broadcast autostaker stake/unstake transactions in parallel to speed up action execution

103.1.0 - 2025-10-14

@streamr/sdk

Added

• Add support for using the plumtree optimization in stream partitions (https://github.com/streamr-dev/network/pull/3147)
• Add listenable event sponsorshipCreated (https://github.com/streamr-dev/network/pull/3191)
• Add config option contracts.sponsorshipFactoryChainAddress (https://github.com/streamr-dev/network/pull/3191)

Changed

• Optimize StreamrClient#searchStreams() (https://github.com/streamr-dev/network/pull/3132)

103.0.0 - 2025-06-10

@streamr/sdk

Added

• Add support for quantum resistant key exchange using ML-KEM (https://github.com/streamr-dev/network/pull/3060)
• Add support for quantum resistant signatures using ML-DSA (https://github.com/streamr-dev/network/pull/3074)
• Add support for ECDSA on secp256r1 curve (https://github.com/streamr-dev/network/pull/3088)
• Add new storage node address STREAMR_STORAGE_NODE_ADDRESS (https://github.com/streamr-dev/network/pull/3020)
• Add peaq environment (https://github.com/streamr-dev/network/pull/3111)
• Add iotex environment (https://github.com/streamr-dev/network/pull/3142)

Changed

• BREAKING CHANGE: Browser exports improved, but polyfills now required
  • The package now correctly exposes a script export and maps Node-specific modules via the browser field
  • Some Node.js modules are no longer automatically polyfilled. Use tools like node-polyfill-webpack-plugin (Webpack) or vite-plugin-node-polyfills (Vite)
  • Refer to the docs for migration details
• BREAKING CHANGE: The string values in Message.signatureType now correspond with the KeyType values. This means the previously output value SECP256K1 is now ECDSA_SECP256K1_EVM.
• BREAKING CHANGE: Rename groupKeyId field encryptionKeyId in Message interface (https://github.com/streamr-dev/network/pull/3084)
• BREAKING CHANGE: Node.js v20 or higher is required (https://github.com/streamr-dev/network/pull/3138)

Deprecated

• Deprecate storage node address STREAMR_STORAGE_NODE_GERMANY (https://github.com/streamr-dev/network/pull/3020)

Removed

• BREAKING CHANGE: Remove lit protocol integration and related config options encryption.litProtocolEnabled and encryption.litProtocolLogging (https://github.com/streamr-dev/network/pull/3036)
• BREAKING CHANGE: Remove StreamrClient#generateEthereumAccount() in favour of EthereumKeyPairIdentity#generate()
• BREAKING CHANGE: Remove orderBy parameter from StreamrClient#searchStreams() (https://github.com/streamr-dev/network/pull/3131)

Fixed

• Fix memory leak in DhtNode (https://github.com/streamr-dev/network/pull/3065)

@streamr/node

Added

• Add experimental autostaker plugin that manages sponsorship staking and unstaking automatically for operators (https://github.com/streamr-dev/network/pull/3086)

Changed

• BREAKING CHANGE: Node.js v20 or higher is required (https://github.com/streamr-dev/network/pull/3138)

@streamr/cli-tools

Added

• CLI tool allows generating key pairs with streamr identity generate --key-type [...] (https://github.com/streamr-dev/network/pull/3074)

Changed

• BREAKING CHANGE: CLI tool command streamr wallet whoami is now streamr identity whoami (https://github.com/streamr-dev/network/pull/3074)
• BREAKING CHANGE: Node.js v20 or higher is required (https://github.com/streamr-dev/network/pull/3138)

102.1.1 - 2025-04-29

@streamr/sdk

Changed

• Update internal list of JSON RPC urls for Polygon

102.1.0 - 2025-02-19

@streamr/node

Fixed

• Fix false flagging issue (https://github.com/streamr-dev/network/pull/3006)

@streamr/cli-tools

Added

• Add new sub command streamr storage-node register to register a storage node (https://github.com/streamr-dev/network/pull/2982)
• Add new sub command streamr storage-node unregister to unregister a storage node (https://github.com/streamr-dev/network/pull/2982)
• Add new sub command streamr storage-node show to display the metadata of a storage node (https://github.com/streamr-dev/network/pull/2982)

102.0.0 - 2025-01-27

@streamr/sdk

Added

• Add support for arbitrary length user IDs: (https://github.com/streamr-dev/network/pull/2774, https://github.com/streamr-dev/network/pull/2780)
  • it is supported for PUBLISH and SUBSCRIBE permissions
  • new StreamrClient#getUserId() method
• Method StreamrClient#getDiagnosticInfo() provides diagnostic info about network (https://github.com/streamr-dev/network/pull/2740, https://github.com/streamr-dev/network/pull/2741)
• Add accessors for stream metadata fields: (https://github.com/streamr-dev/network/pull/2825, https://github.com/streamr-dev/network/pull/2845, https://github.com/streamr-dev/network/pull/2883)
  • Stream#getPartitionCount()
  • Stream#getDescription() and Stream#setDescription()
  • Stream#getStorageDayCount() and Stream#setStorageDayCount()
• Add method StreamrClient#getStreamMetadata() (https://github.com/streamr-dev/network/pull/2883)
• Add validation for public permissions (https://github.com/streamr-dev/network/pull/2819)
• Add opts parameter to StreamrClient#addStreamToStorageNode (https://github.com/streamr-dev/network/pull/2858)
  • controls how long to wait for storage node to pick up on assignment

Changed

• BREAKING CHANGE: Rename user to userId in these interfaces: (https://github.com/streamr-dev/network/pull/2811)
  • UserPermissionAssignment
    • used in grantPermissions(), revokePermissions(), getPermissions() and setPermissions()
  • UserPermissionQuery
    • used in hasPermission()
  • SearchStreamsPermissionFilter
    • used in searchStreams()
• BREAKING CHANGE: Type StreamMetadata is Record<string, unknown> (https://github.com/streamr-dev/network/pull/2825, https://github.com/streamr-dev/network/pull/2845)
  • some new accessors available, see above
  • no default values are injected (https://github.com/streamr-dev/network/pull/2851)
• BREAKING CHANGE: Method Stream#addToStorageNode() doesn't wait for acknowledgment by default (https://github.com/streamr-dev/network/pull/2810)
• BREAKING CHANGE: Replace methods StreamrClient#updateStream() and Stream#update(): (https://github.com/streamr-dev/network/pull/2826, https://github.com/streamr-dev/network/pull/2855, https://github.com/streamr-dev/network/pull/2859, https://github.com/streamr-dev/network/pull/2862)
  • use StreamrClient#setStreamMetadata() and Stream#setMetadata() instead
  • both methods overwrite metadata instead of merging it
• BREAKING CHANGE: Methods Stream#getMetadata() and Stream#getStreamParts() are async (https://github.com/streamr-dev/network/pull/2883)
• BREAKING CHANGE: Rename event streamRemovedFromFromStorageNode to streamRemovedFromStorageNode (https://github.com/streamr-dev/network/pull/2930)
• BREAKING CHANGE: Replace custom errors with StreamrClientError: (https://github.com/streamr-dev/network/pull/2895, https://github.com/streamr-dev/network/pull/2927)
  • StreamrClientError contains MessageID instead of StreamMessage
• Caching changes:
  • storage node addresses (https://github.com/streamr-dev/network/pull/2877, https://github.com/streamr-dev/network/pull/2878)
  • stream metadata and permissions (https://github.com/streamr-dev/network/pull/2889)
• Upgrade StreamRegistry from v4 to v5 (https://github.com/streamr-dev/network/pull/2780)
• Network-level changes:
  • avoid routing through proxy connections (https://github.com/streamr-dev/network/pull/2801)
  • internal record StreamPartitionInfo format changed (https://github.com/streamr-dev/network/pull/2738, https://github.com/streamr-dev/network/pull/2790)

Removed

• BREAKING CHANGE: Remove Stream#detectFields() method (https://github.com/streamr-dev/network/pull/2864)
• BREAKING CHANGE: Remove Stream#delete() method (https://github.com/streamr-dev/network/pull/2863)
  • use StreamrClient#deleteStream() instead
• BREAKING CHANGE: Remove StreamrClient#findOperators() method (https://github.com/streamr-dev/network/pull/2876)
• Remove support for legacy encryption keys (https://github.com/streamr-dev/network/pull/2757)
• Remove obsolete config options:
  • network.node.id (https://github.com/streamr-dev/network/pull/2777)
  • network.controlLayer.webNewrtcConnectionTimeout (https://github.com/streamr-dev/network/pull/2776)

Fixed

• Fix WebRTC connections in Firefox (https://github.com/streamr-dev/network/pull/2746)
• Fix flag expiration time in Operator#getExpiredFlags() (https://github.com/streamr-dev/network/pull/2739)
• Network-level fixes:
  • fix node discover in small topologies (e.g. ~2 nodes) (https://github.com/streamr-dev/network/pull/2786)
  • fix to time-to-data spike scenarios (https://github.com/streamr-dev/network/pull/2802)
  • make network node stop faster (https://github.com/streamr-dev/network/pull/2736)
  • reject requests after disconnection events (https://github.com/streamr-dev/network/pull/2760)
  • fix geoip database file validation (https://github.com/streamr-dev/network/pull/2783)

@streamr/node

Added

• Add new operator plugin config options (for testing purposes) (https://github.com/streamr-dev/network/pull/2742)

Changed

• The environment config option now applies additional settings if dev2 value is used (https://github.com/streamr-dev/network/pull/2813)
  • e.g. disables entryPointDiscovery and metrics

Removed

• BREAKING CHANGE: Remove deprecated bin/config-wizard script (i.e. the streamr-broker-init command) (https://github.com/streamr-dev/network/pull/2830)
  • use streamr-node-init command instead
• BREAKING CHANGE: Remove deprecated command streamr-broker (https://github.com/streamr-dev/network/pull/2881)
  • use streamr-node command instead

Fixed

• Fix operator flag voting behavior when using custom gas estimation (https://github.com/streamr-dev/network/pull/2784)
• Fix a bug causing the inspection process to freeze (https://github.com/streamr-dev/network/pull/2893)
• Fix analysis of WebRTC private address probing warning (https://github.com/streamr-dev/network/pull/3070)

@streamr/cli-tools

Added

• Add binary data support to streamr stream publish (https://github.com/streamr-dev/network/pull/2947)
• Add binary data support to streamr stream susbcribe (https://github.com/streamr-dev/network/pull/2948)
• Add binary data support to streamr mock-data generate command (https://github.com/streamr-dev/network/pull/2946)

Changed

• BREAKING CHANGE: Replace --dev flag with --env flag (https://github.com/streamr-dev/network/pull/2817, https://github.com/streamr-dev/network/pull/2834)
  • the --env flag supports multiple environments
  • if there is a value for environment in a config file, this overrides it
  • use --env dev2 for the development environment

101.1.2 - 2024-09-04

@streamr/sdk

Fixed

• Fixed gas estimation in Operator#voteOnFlag (https://github.com/streamr-dev/network/pull/2734)

101.1.1 - 2024-08-29

@streamr/sdk

Changed

• Numerous improvements to time-to-data (https://github.com/streamr-dev/network/pull/2723, https://github.com/streamr-dev/network/pull/2724, https://github.com/streamr-dev/network/pull/2726, https://github.com/streamr-dev/network/pull/2727)
• Reduce message propagation cache TTL from 30 seconds to 10 seconds (https://github.com/streamr-dev/network/pull/2732)

@streamr/node

Changed

• Optimize the "operator value breach" task to be less demanding on EVM RPCs (https://github.com/streamr-dev/network/pull/2721)

Fixed

• Add better checks to the "expired flag closing" task so that the likelihood of submitting reverting transactions to the blockchain is reduced (https://github.com/streamr-dev/network/pull/2725)

101.1.0 - 2024-08-13

@streamr/sdk

Added

• Add method findOperators to client (https://github.com/streamr-dev/network/pull/2703)

Fixed

• Fix operator review request event parsing (https://github.com/streamr-dev/network/pull/2714)

@streamr/node

Added

• Operators now register external RPC endpoints for accelerated stream entrypoint discovery (https://github.com/streamr-dev/network/pull/2702)

Fixed

• Fix propagation buffer TTL issue (https://github.com/streamr-dev/network/pull/2682)
• Fix operator review request event parsing (https://github.com/streamr-dev/network/pull/2714)

101.0.1 - 2024-07-09

@streamr/sdk

Changed

• Set default RPC timeout to 30 seconds (https://github.com/streamr-dev/network/commit/131fb456d26486c12b2facd6e78bee47319c2533)

101.0.0 - 2024-07-08

@streamr/sdk

Changed

• Update ethers.js library to v6 (https://github.com/streamr-dev/network/pull/2506)
• Restructure contracts config section (https://github.com/streamr-dev/network/pull/2581)
• Improve reliability of JSON RPC interactions by adding retry redundancy (https://github.com/streamr-dev/network/pull/2562, https://github.com/streamr-dev/network/pull/2601)
• Rename events (https://github.com/streamr-dev/network/pull/2604, https://github.com/streamr-dev/network/pull/2605) as denoted below
  • createStream => streamCreated
  • addToStorageNode => streamAddedToStorageNode
  • removeFromStorageNode => streamRemovedFromFromStorageNode
  • resendComplete => resendCompleted (on instances of Subscription)

Removed

• Remove obsolete RPC provider options (https://github.com/streamr-dev/network/pull/2583)

@streamr/node

Changed

• Improve reliability of JSON RPC interactions by adding retry redundancy (https://github.com/streamr-dev/network/pull/2562, https://github.com/streamr-dev/network/pull/2601)

Deprecated

• Deprecate command streamr-broker. Use streamr-node instead. (https://github.com/streamr-dev/network/pull/2626)
• Deprecate command streamr-broker-init. Use streamr-node-init instead. (https://github.com/streamr-dev/network/pull/2626)

Fixed

• Fix memory leak in SubscriberPlugin (https://github.com/streamr-dev/network/pull/2578)

100.2.4 - 2024-05-06

@streamr/sdk

Added

• New geolocation detection by Nodes improves start up times and the decentralization of the network (https://github.com/streamr-dev/network/pull/2465)
• Improved rejoining streams after losing internet connection (https://github.com/streamr-dev/network/pull/2502)
• Discovering stream neighbors is more efficient as offline nodes are cleaned-up by sending pings (https://github.com/streamr-dev/network/pull/2501)

Fixed

• Hanging connection issue with WebSocket clients (https://github.com/streamr-dev/network/pull/2519)

@streamr/node

Added

• Nodes provide geolocation detection for newly joining nodes (https://github.com/streamr-dev/network/pull/2465)

@streamr/cli-tools

Removed

• Removed `governance vote' command (https://github.com/streamr-dev/network/pull/2538)

100.2.3 - 2024-04-15

@streamr/sdk

Fixed

• Tweaked and improved JSON RPC handling (https://github.com/streamr-dev/network/pull/2497, https://github.com/streamr-dev/network/pull/2496, https://github.com/streamr-dev/network/pull/2495, https://github.com/streamr-dev/network/pull/2483)

100.2.2 - 2024-04-03

@streamr/sdk

Changed

• Update internal list of JSON RPC urls for Polygon

100.2.1 - 2024-04-02

@streamr/sdk

Added

• Add node ID to metrics messages (https://github.com/streamr-dev/network/pull/2464)

Changed

• Change the way in which the partition of the metrics stream is calculated (based on node ID) (https://github.com/streamr-dev/network/pull/2468)

Fixed

• Fix Node.js v18 compatibility (https://github.com/streamr-dev/network/pull/2462)

@streamr/node

Changed

• Update Docker runtime to Node.js v20 (https://github.com/streamr-dev/network/pull/2466)

100.2.0 - 2024-03-28

@streamr/sdk

Added

• Add support for subscribing to a stream on behalf of an ERC-1271 contract (https://github.com/streamr-dev/network/pull/2454)

100.1.2 - 2024-03-27

@streamr/sdk

Fixed

• Update internal list of JSON RPC urls for Mumbai testnet

100.1.1 - 2024-03-26

@streamr/sdk

Fixed

• Update internal list of JSON RPC urls for Polygon

100.1.0 - 2024-03-25

@streamr/sdk

Added

• Add support for publishing messages on behalf of an ERC-1271 contract (https://github.com/streamr-dev/network/pull/2423)
• Add fields signatureType and groupKeyId to Message interface (https://github.com/streamr-dev/network/pull/2423)
• Add ability to disable websocket server (https://github.com/streamr-dev/network/pull/2425)

Changed

• Change websocket client library implementation used in Node.js (https://github.com/streamr-dev/network/pull/2384)