Release v0.8.0

v0.8.0 (2025-09-13)

This is the first release which contains arm binaries for MacOS, Ubuntu-22 and Ubuntu-24. Furthermore, the docker image is now a multi-arch image, also supporting arm.

This release also changes the general release workflow and how release notes are generated. The notes for this release were adapted manually since some merges to main happened before the new github workflows were active.

🚀 Features

• Optimize logic how to connect to healthy beacon nodes (PR 95)
• cli: Add version flag and extend help for current version (5fb7560)

🐛 Bug Fixes

• Fix major bug on MacOS preventing eth-duties even to start (PR 101)

🔧 Other

• setup: Add claude-code ignores (64577fc)
• workflows: Update and extend cicd workflows (247b986)

Docker

Docker images can be found here

v0.7.1

IMPORTANT: Windows executable

This release does not contain a Windows executable as I currently have some issues with the build process (see this issue). Please comment in the respective issue if you are a Windows user. This way I can better prioritize upcoming tasks.

What's Changed

Note: This release does not contain any features or bugfixes but only fixes the naming of the resulting compressed binary file which is easier to digest for ansible based deployments.

Other Changes

• Cleanup validator identifier documentation by @TobiWo in #94
• fix ubuntu distribution version by @LuisNaldo7 in #96
• Fix release pipeline by @TobiWo in #97

Full Changelog: v0.7.0...v0.7.1

Docker

Docker images can be found here

v0.7.0

IMPORTANT: Windows executable

This release does not contain a Windows executable as I currently have some issues with the build process (see this issue). Please comment in the respective issue if you are a Windows user. This way I can better prioritize upcoming tasks.

What's Changed

This release introduces a major new feature: eth-duties now supports fetching validator identifiers via the Keymanager API. With this update, you can connect eth-duties to your validator nodes to retrieve all managed validators directly from the respective node. Additionally, any changes, such as exiting or adding a validator, will be reflected by eth-duties automatically. For more information, check out the detailed feature documentation.

Alongside this feature, several minor bugs have been fixed, including an improvement allowing multiple eth-duties instances to run concurrently on the same machine — a limitation in previous versions.

Lastly, a binary is now available for the latest Ubuntu LTS release (24.04).

New Features 🎉

• Add usage of validator manager api for index retrieval by @TobiWo in #79

Other Changes

• Fix deprecated datetime function calls by @TobiWo in #92

Full Changelog: v0.6.1...v0.7.0

Docker

Docker images can be found here

v0.6.1

IMPORTANT: Windows executable

This release does not contain a Windows executable as I currently have some issues with the build process (see this issue). Please comment in the respective issue if you are a Windows user. This way I can better prioritize upcoming tasks.

What's Changed

This release does not contain any new features hence it is only a patch version. It fixes some small bugs and small parts of the documentation, updates the ci/cd pipeline dependencies and adds integration tests leveraging the ethereum-package for kurtosis.

Other Changes

• Add integration tests by @TobiWo in #75
• Improve logging for cli validation errors by @TobiWo in #82
• Update format for time to next sync committee by @TobiWo in #83
• Update documentation by @TobiWo in #80
• Update poetry setup and rest api version tag by @TobiWo in #81
• Fix sync committee rest response object by @TobiWo in #89
• Fix and update workflows by @TobiWo in #91

Full Changelog: v0.6.0...v0.6.1

Docker

Docker images can be found here

v0.6.0

IMPORTANT: Windows executable

This release does not contain a Windows executable as I currently have some issues with the build process (see this issue). Please comment in the respective issue if you are a Windows user. This way I can better prioritize upcoming tasks.

What's Changed

This release does not contain any new features. Instead it optimizes some things and most importantly updates to Python 3.12 which was released a couple of months ago.

Other Changes

• Fix pre-commit errors for yaml files by @TobiWo in #61
• Transfer documentation to GitHub pages by @TobiWo in #62
• Update python setup by @TobiWo in #64
• Update logging verbosity by @TobiWo in #65
• Implement concurrent api calls by @TobiWo in #66
• Fix actions by @TobiWo in #69

Full Changelog: v0.5.0...v0.6.0

Docker

Docker image can be found here

v0.5.0

ATTENTION

The binary/executable of v0.5.0 does not work correctly. On Linux and MacOS eth-duties logs upcoming duties correctly but it is also throwing errors all the time. The Windows executable doesn't work at all currently.

The issue will be fixed in the next version (v0.6.0) for Linux/MacOS.

There are even more issues on Windows. Therefore this will be fixed in a later version.

Sorry for the inconvenience.

What's Changed

Beside some smaller changes and optimizations this release comes with three major features.

New Features 🎉

• Add rest api endpoints for external applications by @TobiWo in #51
• Add logic for using backup beacon nodes by @TobiWo in #56
• Customize logging colors by @TobiWo in #59

Other Changes

• Add better handling of bad formatted indices/pubkeys
• Add human readable timer for sync committee duties
• Fix bug where duties did not get updated while sync-committee duty ended
• Add validation of beacon-node url
• Update documentation by @TobiWo in #57

Full Changelog: v0.4.0...v0.5.0

Docker

Docker image can be found here

Thank you

Thanks so much @LuisNaldo7 for continuously reviewing my PRs 🙏. This is extremely valuable.

v0.4.0

What's Changed

This release has a nice feature for home stakers who want to really optimize their maintenance while only missing the absolute minimum of attestation duties (or none at all). I recommend to checkout the documentation and the newly created docker-compose examples.

Breaking Changes

• mode exit was renamed to cicd-force-graceful-exit to be more precise what it actually does

New Features and Fixes 🎉

• Improve graceful termination by @TobiWo in #45
• Improve cicd modes for home stakers by @TobiWo in #47

Other Changes

• Add Ubuntu 20.04 build pipeline by @TobiWo in #50
• Fix artifact paths for multiple ubuntu versions by @TobiWo in #52

Docker

Docker image can be found here

Thank you

Thanks @LuisNaldo7 for continuously reviewing my PRs 🙏. Furthermore I want to thank @ForceConstant who gave me the idea for the cicd mode rework which makes these modes now useful for home stakers.

Changelog

Full Changelog: v0.3.1...v0.4.0

v0.3.1

What's Changed

This release fixes the issue how validator identifiers are parsed while using infrastructure tools like docker-composeor helm. It furhtermore brings back comma separation. Check out the README for further documentation.

Beside that I'm happy to announce that eth-duties now support all 5 beacon-clients 🚀.

New Features 🎉

• Add comma separation for provided validators by @TobiWo in #40
• Improve client compatibility by @TobiWo in #41

Docker

Docker image can be found here

Thank you

Thanks to @ladidan , @nflaig , @jabbink and @LuisNaldo7 for help and giving constant feedback.

Changelog

Full Changelog: v0.3.0...v0.3.1

v0.3.0

What's Changed

Compatibility note

I added a compatibility table to the README so that you can easily check which client works with eth-duties.

Breaking Changes

• Flag --validator-file was renamed to --validators-file
• Shortcut flags like -v or -f were removed
• Comma separated validator indices/pubkeys for the flag --validators does not work anymore
  • Please use a space for separation
  • This has some side effects on a used docker compose (see compose example)
    • TL;DR: If you have many validators and rely on a compose it is recommended to use a validators file

New Features and Fixes 🎉

• The restriction to only get sync committee duties for 300 validators got fixed
• At start eth-duties filters out validators which are not labelled as active on chain
• You can now pass validator pubkeys
• You can also pass one or many indices/pubkeys with an alias which will be used for logging instead of the index/pubkey
• The logging behavior is now more customizable:
  • Replace indices with pubkeys in logging messages with --log-pubkeys
  • Customize colorful logging thresholds for warning (--log-time-warning) and critical messages (--log-time-critical)
  • Define the max. number of logged attestation duties with --max-attestation-duty-logs
• Use --mode to define running mode
  • Default will be the correct one for most users
  • The other modes are mostly for professional node operators (see here for a more detailed explanation)

Other Changes

• Update documentation by @TobiWo in #23
• minor typo by @ladidan in #37

Relevant feature and fix related PRs

• #25
• #31
• #33
• #34

New Contributors

• @ladidan made their first contribution in #37

Docker

Docker image can be found here

Full Changelog: v0.2.1...v0.3.0

v0.2.1

What's Changed

Other Changes

• Fix github workflows by @TobiWo in #11
• Add dependency management with poetry by @TobiWo in #12
• Update semantic versioning workflow by @TobiWo in #14
• Add github workflow for building and releasing artefacts by @TobiWo in #13

Docker

Docker image can be found here

Full Changelog: v0.2.0...v0.2.1