Blutgang 0.4.0 alpha0 Arianrhod

Blutgang 0.4.0 alpha0 Arianrhod

This is a preview release of how the next iteration of Blutgang. It's not production ready, but everyone inclined to run it is encouraged to do so to test out the new changes.

IMPORTANT: PLEASE DO NOT USE YOUR EXISTING BLUTGANG CACHE!

Breaking changes

The DB part of the config looks something like this now:

# Sled config
# Sled is the database we use for our cache, for more info check their docs
[sled]
db_path = "./blutgang-cache" # Path to db
cache_capacity = 400000 # Cache size in bytes
# Select zstd compression level, goes from 1-12 where 12 is the most.
compression = 1
flush_every_ms = 325 # Frequency of flushes in ms

Installation

Blutgang can be installed via docker, or via the prebuilt binaries below.

The docker tags for this release are 0.4.0-e16496.

Blutgang 0.3.6

Blutgang 0.3.6

This is a minor release and is recommended for anyone running previous iterations of 0.3.x. It includes performance and stability improvements!

What's Changed

• Added a buffer for WS subscriptions when there are no available nodes to resubscribe to.
• Further increased the stability of the WS module.

Full Changelog: Blutgang-0.3.5...Blutgang-0.3.6

Installation

Blutgang can be installed via cargo, docker, or via the prebuilt binaries below.

The docker tags for this release are 0.3.6 and latest.

Blutgang 0.3.5

Blutgang 0.3.4

This is a minor release and is highly recommended for anyone running previous iterations of 0.3.x. It includes performance and stability improvements!

What's Changed

• Db arc removal by @nuts-rice in #76, yields up to 20% performance improvements.

New Contributors

• @nuts-rice made their first contribution in #76

Full Changelog: Blutgang-0.3.4...Blutgang-0.3.5

Installation

Blutgang can be installed via cargo, docker, or via the prebuilt binaries below.

The docker tags for this release are 0.3.5 and latest.

Blutgang 0.3.4

Blutgang 0.3.4

This is a minor release and is highly recommended for anyone running previous iterations of 0.3.x. It includes stability improvements, minor new features, and bug fixes.

What's Changed

• Verifies the syncing status of a node during the health checks. Blutgang will now send 2 requests during the health check. Please check the docs for more info.
• Minor fixes and improvements.

Installation

Blutgang can be installed via cargo, docker, or via the prebuilt binaries below.

The docker tag for this release is 0.3.4.

Blutgang-0.3.3

Blutgang 0.3.3

This is a minor release and is highly recommended for anyone running previous iterations of 0.3.x. It includes stability improvements, minor new features, and bug fixes.

What's Changed

• Add proper k8s liveness checks by @makemake-kbo in #68
• fix(balancer): Insert content-type header if not set to json by @rarecrumb in #65
• Make some warnings less aggressive.
• Blutgang will now gracefully handle nodes dropping connection.
• RPCs that pass url validation, but fail when querried on initial startup will now be added to the poverty_list (misbehaving RPC list), and queried later to check if they're back up.
• Database corruption mitigations.
• Blutgang will now panic and terminate the process on all unrecoverable WebSockets errors and events.
• Misc Nix flake improvements.

Breaking changes

A new mandatory option(header_check) has been added. Please update your configs!

New Contributors

• @rarecrumb made their first contribution in #65

Installation

Blutgang can be installed via cargo, docker, or via the prebuilt binaries below.

The docker tag for this release is 0.3.3.

Blutgang 0.3.3 Release Candidate 1

Blutgang 0.3.3-rc1

This is a release candidate for minor Blutgang version 0.3.3. The final release will have all of the changes listed below, as well as prometheus metrics.

What's Changed

• Add proper k8s liveness checks by @makemake-kbo in #68
• fix(balancer): Insert content-type header if not set to json by @rarecrumb in #65
• Make some warnings less aggressive.
• Blutgang will now gracefully handle nodes dropping connection.
• RPCs that pass url validation, but fail when querried on initial startup will now be added to the poverty_list (misbehaving RPC list), and queried later to check if they're back up.
• Misc Nix flake improvements.

Breaking changes

A new mandatory option(header_check) has been added. Please update your configs!

New Contributors

• @rarecrumb made their first contribution in #65

Installation

Blutgang can be installed via cargo, docker, or via the prebuilt binaries below.

The docker tag for this release is 0.3.3-rc1.

Blutgang 0.3.2 Garreg Mach

Blutgang 0.3.2 Garreg Mach

Blutgang 0.3.2 Garreg Mach is a minor release containing bug fixes and performance improvements.

You can find more information about major changes in 0.3.0 here: https://github.com/rainshowerLabs/blutgang/releases/tag/Blutgang-0.3.0

Changelog:

• Fix potential DB corruption issues (#61).
• Add experimental journald feature to log blutgang output to systemd journald.
• Blutgang now sanitizes URLs from logs. API keys that are a part of the URL will not show up in logs.

Installation:

Blutgang can be installed via cargo, docker, or via the prebuilt binaries below:

Blutgang 0.3.1 Garreg Mach

Blutgang 0.3.1 Garreg Mach

Blutgang 0.3.1 Garreg Mach is a minor release containing bug fixes and performance improvements.

You can find more information about major changes in 0.2.0 here: https://github.com/rainshowerLabs/blutgang/releases/tag/Blutgang-0.3.0

Changelog:

• Fix Docker container compatibility issues (#57).
• Adds new debugging only Docker container under the 0.x.x-debug tag.
• Add a shell.nix file.
• More verbose errors and debug output.
• Fix malformed JSON output on websocket connection (#57).
• Add expected_block_time option that's independent of the ttl for use as a sanity check on receiving subscriptions. ttl can be used to check for node health more frequently, while expected_block_time can be fine tuned to adjust for your network quality and blockchain block time.
• Add supress_rpc_check option to suppress healthy health check output.
• Various bug fixes and housekeeping.

Installation:

Blutgang can be installed via cargo, docker, or via the prebuilt binaries below:

Blutgang 0.3.0 Garreg Mach

Blutgang 0.3.0 Garreg Mach

Blutgang 0.3.0 Garreg Mach is the next major release of Blutgang. It includes major changes to Blutgang, designed to improve its performance and usability in production environments. A major focus of this release has been improved health checking, WebSocket support, and subscription dispatch.

Changelog:

Proper websocket support (#46, #50)

Full websocket support. Includes fallbacks and internal subscription duplication. See the related issues for more.

Failure aware subscriptions

In addition, once a node fails, all subscriptions assigned to that node will be resubscribed to other nodes. This process is completely transparent to the end user. Subscription IDs will not change.

Rewrite named params to blocknumber (#47)

Rewrite params like latest, safe, and finalized to their respective block numbers.

Better reorg handling (#48)

Improve the reorg handling to handle more edge cases.

Kubernetes friendly operator admin methods and k8s health check endpoints (#49, #53)

Rework the admin namespace to be fully operator friendly. Blutgang can now entirely be configured by an operator!

Relicensed to FSL

As a trial, this release is licensed under the FSL, which is more liberal than AGPLv3. It explicitly allows use cases like internal use, and exposing Blutgang to end users in some cases without any additional permissions. If you are unsure if your use case is covered, feel free to contact us!

Issues, Questions, and troubleshooting (#57)

If you have trouble updating, using, getting undefined behaviour, or anything minor that does not deserve it's own issue, you can report it via the dedicated meta issue here: #57

Installation:

Blutgang can be installed via cargo, docker, or via the prebuild binaries below:

Blutgang 0.3.0-rc1 Garreg Mach

Blutgang 0.3.0 Garreg Mach

Blutgang 0.3.0 Garreg Mach is the next major release of Blutgang. It includes major changes to Blutgang, designed to improve its performance and usability in production environments. A major focus of this release has been improved health checking, WebSocket support, and subscription dispatch.

This is a release candidate. Blutgang 0.3.0 is going through a period of fuzzing and testing to prepare for release. There will be no more features added. For the full changelog, please see the related PR: #38

Changelog

• Docker images are now prebuilt by default. The blutgang-prebuilt container image is deprecated in favour of blutgang. There should be no change to how the images behave besides the obvious.
• Subscriptions now get fully migrated from non-working to working nodes.
• WebSockets are now fully optional. It is highly recommended to keep WS on.
• Better error handling.
• Improved logging.
• Performance improvements.
• As a trial, this release is licensed as FSL-Apache2.0.

Usage notes

You will need to specify WS endpoints for all RPCs in your config file, otherwise Blutgang wont run. This is a pre-release thing. See the example config for how to do this.

Docker containers

Docker containers are available here https://hub.docker.com/r/makemake1337/blutgang under the 0.3.0-rc1 tag.