Release v2.5.0

Keep Core v2.5.0

Built from commit: 7825c53

Downloads

• Linux AMD64: keep-client-mainnet-v2.5.0-linux-amd64.tar.gz
• macOS AMD64: keep-client-mainnet-v2.5.0-darwin-amd64.tar.gz

Verification

All binaries include MD5 and SHA256 checksums for verification.

Changes since v2.4.4

50181dd feat(tbtc): set activation block to 24559289 (~March 1st 2026)
6ad7484 feat(tbtc): add activation-gated every-window deposit and moved-funds sweeps
a07df43 feat(tbtcpg): group deposit sweep candidates by vault address
c535a07 feat(tbtcpg): add bounded lookback window for deposit sweep event queries

Release v2.4.4

Keep Core v2.4.4

Built from commit: 7fd2319

Downloads

• Linux AMD64: keep-client-mainnet-v2.4.4-linux-amd64.tar.gz
• macOS AMD64: keep-client-mainnet-v2.4.4-darwin-amd64.tar.gz

Verification

All binaries include MD5 and SHA256 checksums for verification.

Changes since v2.4.3

ab7ee23 Increase MovedFundsSweepLookBackBlocks from 30 to 50 days
178dbab Fix NPM ECDSA CI: use committed yarn.lock instead of upgrading deps
aac5e7e Apply prettier formatting to test files
4b2221d Fix CI test failures: proxy deployment, smock corruption, revert assertions, gas values
3fe9696 Fix CI failures: restore stake() test util, fix V2 storage layout, update Dockerfile to Node 18, fix deploy data paths, fix Allowlist tests
29f56c2 Move allowlist weight data files out of deploy/ directory
72b76b8 fix(ecdsa): revert threshold-network and random-beacon to main versions
2ac15ef fix(ecdsa): resolve all 57 eslint errors
2cf3490 fix(ecdsa): fix CI failures in yarn install, eslint, slither, and formatting
461b264 feat(deploy): add deployment guards to prevent contract redeployment
4e82415 feat(ecdsa): add allowlist weights configuration for mainnet
b95a4c3 chore(ecdsa): migrate to hardhat-verify and add Sepolia network support
03b8763 feat(ecdsa): add deployment infrastructure for beta staker consolidation
896d640 fix(ci): exclude solidity/ from client workflow and upgrade artifact actions
ae12ef3 refactor(WalletRegistry): optimize bytecode and improve error observability
f5edfba test(ecdsa): migrate WalletRegistry tests to use custom error assertions
ac79c08 fix(ecdsa): add onlyGovernance protection to initializeV2 and implement authorization routing
546fb32 docs: add WalletRegistry optimization audit preparation document
357328b test(WalletRegistry): update error assertions for custom error migration
04ebe63 refactor(WalletRegistry): replace require statements with custom errors

Release v2.4.3

Keep Core v2.4.3

Built from commit: 138c970

Downloads

• Linux AMD64: keep-client-mainnet-v2.4.3-linux-amd64.tar.gz
• macOS AMD64: keep-client-mainnet-v2.4.3-darwin-amd64.tar.gz

Verification

All binaries include MD5 and SHA256 checksums for verification.

Changes since v2.4.2

d930d64 Update dependencies and improve test stability
7025b90 enhance proposal task error reporting
829879b Enhance proposal task error handling in tbtcpg

Release v2.4.2

Keep Core v2.4.2

Built from commit: d04ce46

Downloads

• Linux AMD64: keep-client-mainnet-v2.4.2-linux-amd64.tar.gz
• macOS AMD64: keep-client-mainnet-v2.4.2-darwin-amd64.tar.gz

Verification

All binaries include MD5 and SHA256 checksums for verification.

Changes since v2.4.1

d8323e0 - Increased the system metrics update interval from 10 seconds to 60 seconds for improved performance tracking. - Added detailed comments to clarify the behavior of CPU utilization sampling and the prevention of double-recording in coordination window metrics.
00c1554 Enhance error handling in coordination procedures
4dca652 Update performance metrics to use constants from clientinfo package
0a5ca29 Refactor performance metric constants for improved readability
40e8a62 Implement unique peer ping tracking in libp2p
b0810b1 Enhance coordination window metrics and error handling
f645465 Add redemption metrics and improve performance tracking
2ffd1c4 Enhance coordination window metrics tracking
84ab467 Enhance performance metrics and tests

Release v2.4.1

Keep Core v2.4.1

Built from commit: e0d801f

Downloads

• Linux AMD64: keep-client-mainnet-v2.4.1-linux-amd64.tar.gz
• macOS AMD64: keep-client-mainnet-v2.4.1-darwin-amd64.tar.gz

Verification

All binaries include MD5 and SHA256 checksums for verification.

Changes since v2.4.0

dab0b08 Update go.mod and go.sum to replace keep-common with threshold-network version

Release v2.4.0

Keep Core v2.4.0

Built from commit: e22493d

Downloads

• Linux AMD64: keep-client-mainnet-v2.4.0-linux-amd64.tar.gz
• macOS AMD64: keep-client-mainnet-v2.4.0-darwin-amd64.tar.gz

Verification

All binaries include MD5 and SHA256 checksums for verification.

Changes since v2.2.0

81456d0 feat: add per-action type metrics for wallet actions
92b5b57 refactor: standardize metric string formatting and improve test clarity
613c068 fix: resolve code quality and test stability issues from review
15c4900 fix: resolve performance metrics issues from deep review
541b79e fix: resolve data races, resource leaks, and metrics issues from review
6e06b5f Remove commented-out code related to performance metrics initialization in tbtc.go for improved clarity and maintainability.
881da25 Remove commented-out code regarding failure metrics in signingExecutor's sign function for clarity and maintainability.
f03c4cf Remove unnecessary blank line in Connect function of libp2p.go
db79a05 Refactor performance metrics registration and remove unused gauge observer
78f0ae7 Add system metrics observation to performance monitoring
b3adc08 Refactor performance metrics handling in coordination procedures
3e94fe4 Enhance performance metrics handling
a277e6b fixes after review
e212abd Add deposit and redemption metrics tracking and update .gitignore
86a62e8 remove redundant docs
f8eec80 eth and btc connectivity metrics
09ef70f Add performance metrics tracking for key operations
a42aa58 recfresh ci
676b1dc recfresh ci
1f2652e ci(contracts): run workflows on prs

Release v2.3.1

Keep Core v2.3.1

Built from commit: 3b02bb1

Downloads

• Linux AMD64: keep-client-mainnet-v2.3.1-linux-amd64.tar.gz
• macOS AMD64: keep-client-mainnet-v2.3.1-darwin-amd64.tar.gz

Verification

All binaries include MD5 and SHA256 checksums for verification.

Changes since v2.2.0

3b02bb1 chore(deps): bump keep-common to v1.7.1-tlabs.0
42166bf chore(deps): bump keep-common to header fix
37f3d8b fix(ethereum): avoid tx decoding in block lookup
8a978aa ci: pass ETHEREUM_MAINNET_RPC_URL into integration job
5e7d4bd test(tbtcpg): fix expected error unmarshaling
48f7d44 test(ethereum): require mainnet rpc env
46d76c2 test(ethereum): use env RPC for block timestamp integration
998b836 test(electrum): extend retry window for public electrs
8e4aee8 test(electrum): guard testnet wss host #3843
018007a test(config): refresh sepolia peers
127db76 test(electrum): skip offline wss endpoint #3843
e49fef4 chore(deps): use threshold keep-common pr head

Release v2.2.0

Keep Core v2.2.0

Built from commit: f85846f

Downloads

• Linux AMD64: keep-client-mainnet-v2.2.0-linux-amd64.tar.gz
• macOS AMD64: keep-client-mainnet-v2.2.0-darwin-amd64.tar.gz

Verification

All binaries include MD5 and SHA256 checksums for verification.

Changes since v2.1.0

fc9e0f6 Trigger contract CI checks
9faf25b Fix nested quote issue in release workflow
807d467 ci: trigger run on squashed commit
6ab2585 fix: eliminate Docker dependency anti-pattern and implement proper Go module management
289f797 fix: restore accidentally deleted generated TokenStaking files
73488a4 docs: add comments explaining _address placeholder files
1fb8eb1 fix: restore missing _address/TokenStaking placeholder file
733d657 Fix YAML formatting in release workflow
3b9cac5 Add automated GitHub releases workflow
a9c6435 fix: revert CI to use existing generated files instead of regenerating
b9cbd02 fix: add code generation to vet and lint CI jobs
ba7a578 fix: add -checklinkname=0 flag to resolve Go 1.24 build failures
9a800a8 chore: bump go version to 1.24
c2f03c1 chore(ci): use consistent go version on ci
06611f3 feat: remove bootstrap nodes from embedded peer lists
b71642b extend test module timeout to 15m
4918528 ci: exclude SA1019 deprecation warnings from staticcheck with -checks=
d43d456 ci: exclude SA1019 deprecation warnings from staticcheck
59b012e explicit go version on staticcheck for client-lint
53f0f89 ci: exclude G115 integer overflow warnings from gosec scan

Client: v2.1.0 (Mainnet)

v2.1.0 is a new release of the client software. This client version introduces:

• Moving funds between wallets (#3748, #3767, #3785, #3789, #3786, #3792, #3790, #3793, #3794, #3810, #3813
• Heartbeat mechanism (#3800, #3816)
• Archiving of key material for closed wallets (#3814)
• Various optimizations around wallet proposal generator (#3809, #3811, #3815)

ℹ️ This update is required for all nodes

The documentation for the client setup: https://docs.threshold.network/guides/threshold-applications/tbtc-v2-client-setup

In addition, we're providing two pieces of information for operators and other interested parties:

• The Docker Hub image sha256 sum.
• The Linux (glibc) binary sha256 sum.

Both hashes are signed by the development team and verifiable on Keybase. Our Keybase usernames are all associated with the Keep organization and our GitHub usernames.

---

Docker image is available as docker pull keepnetwork/keep-client:v2.1.0; sha256 sum is sha256:2e6d9929b9c36b6068df9c22526ddcbe1c73f08f8f6ca1168479e472b8c99438

Signatures from the development team (verify these in the Keybase app):

• @tomaszslabon
  BEGIN KEYBASE SALTPACK SIGNED MESSAGE. kXR7VktZdyH7rvq v5weRa0zk7xdHzK Gm9BtmKb2FhcVia 1x14PuUuG7fVaLE jQhGdMxCf7dGQjv rByZe7Hgua7ApRT WmmXOlJiEf2foxC yzu0NWHi0jAao8A yIDNWcsDYRKgDa2 mkNniAYcAMgzFwn SnLrUudtZTK5nyG 6ZX6epULieMTxIP hfnW7DwvjdanV8q tGJLzHmxPIQ310j 41SuUBQoXNtPQA0 uUvKnpQZKu0MXKD kFP91S5aQS8dWvm pVJ6oRZMOY9QqMW qqZ4zqZ5DLc. END KEYBASE SALTPACK SIGNED MESSAGE.

• @lukasz-zimnoch
  BEGIN KEYBASE SALTPACK SIGNED MESSAGE. kXR7VktZdyH7rvq v5weRa0zk90sDpX wIX07Cfy2Yz31Xq 8mliRvTpoVIDeBV VZiP1JZd9aotw83 5l7wahdf5fHnsOU RRNtiIOlJ5wtgNa Z2sCzyS3FWdowJa DGJnZQmvsGZBmrP yetYZfemOX72uSc Zb05u4EHtDU6wPw 3mAl3LrqoAz6Dld ThQy5qFpYMMqhB7 cBZOVyqZOLpWrSd SfYRCBQoXNtPQA0 uUvKnpQZKu0MXKD kFP91S5aQS8dWvm pVJ6oRZMOY9QqMW qqZ4zqZ5DLc. END KEYBASE SALTPACK SIGNED MESSAGE.

---

Linux (glibc) client binary is available to download in the Assets section of the release; sha256 sum is sha256:e6ca77d35a395a3d2caa88ac0b92e552fd9f2f34de4c133a3c7b48ad4f5a4e2b

Signatures from the development team (verify these in the Keybase app):

• @tomaszslabon
  BEGIN KEYBASE SALTPACK SIGNED MESSAGE. kXR7VktZdyH7rvq v5weRa0zk7xdHzK Gm9BtmKb2FhcVia 1x14PuUuG7fVaLE jQhGdMxCf7avsWo hxLBMyaF9Z7lQlV veq8SJEtRGuWW3l uOBUQ4XVHl2FULb eNxF6O1PTyY3ExL B3sjEAQY3Xu7xMv qxLb67pYEx5I8bS dcij2lIYRiNTVAs 2TkKfqxAPtJU2XK 4ZLmWjUPHTdFKFe f4qoNNl6UgkhY4H EnKV3pz8aZcpels jV4RYRFW4WcMJap ATzCDKHPgyBGN5B yQ9jDdmgF2Q. END KEYBASE SALTPACK SIGNED MESSAGE.

• @lukasz-zimnoch
  BEGIN KEYBASE SALTPACK SIGNED MESSAGE. kXR7VktZdyH7rvq v5weRa0zk90sDpX wIX07Cfy2Yz31Xq 8mliRvTpoVIDeBV VZiP1JZd9ZkjAbT KWCE3ucc5W6eQjY Wuc8iaBY5w27ctS 7utR1lHNV8d8aBg RsrT7blPB7uJXub ycQBtoNPv691bD9 KS9cDmZW3UqVWeM fFK1Z15CIesyCCK LSAfeA4uvDNEBGq AlEu4ighdWqawvE jBqtPNl6UgkhY4H EnKV3pz8aZcpels jV4RYRFW4WcMJap ATzCDKHPgyBGN5B yQ9jDdmgF2Q. END KEYBASE SALTPACK SIGNED MESSAGE.

---

Finally, note that the full set of work that went into the 2.1.0 version can be found in the corresponding v2.1.0 milestone.

Client: v2.0.1 (Mainnet)

v2.0.1 is a patch release of the client software. This client version introduces several optimizations around deposit sweeps:

• Increase deposit sweep frequency to 12 hours (#3803)
• Retry upon coordination proposal failure (#3804)
• Optimize deposit sweep proposal generator (#3805)

ℹ️ This update is required for all nodes participating in the tBTC Beta Stakers program. For other nodes, this update is optional. Regarding staking rewards, all nodes running the latest minor version (v2.0.x) remain eligible.

The documentation for the client setup: https://docs.threshold.network/guides/threshold-applications/tbtc-v2-client-setup

In addition, we're providing two pieces of information for operators and other interested parties:

• The Docker Hub image sha256 sum.
• The Linux (glibc) binary sha256 sum.

Both hashes are signed by the development team and verifiable on Keybase. Our Keybase usernames are all associated with the Keep organization and our GitHub usernames.

---

Docker image is available as docker pull keepnetwork/keep-client:v2.0.1; sha256 sum is sha256:4657ce91e58b1f07d5b7b0c6a7918d625a053baa2f2bfd7526d71b98cf8de82a

Signatures from the development team (verify these in the Keybase app):

• @tomaszslabon
  BEGIN KEYBASE SALTPACK SIGNED MESSAGE. kXR7VktZdyH7rvq v5weRa0zk7xdHzK Gm9BtmKb2FhcVia 1x14PuUuG7fVaLE jQhGdMxCf7OXhdd 2d6Y6lo8kPr3jHH izqY8EOEROxUmOx k2HR26OpoDzwZEP HUau63ziKa2Mo1s jMSdyAvd58aeW7S 6b9uAraBwlSwLrM Wl95HnS2UAsiLw7 5KC5baxwEq5AfO1 Xe36tlWFrVq1EIQ BV2HID8N0B2wKB9 evzVQFn2N418RKh nI5xWYj9X6fNTv7 4PX6gTCMgQ7ndoF sUHjyqekH4L. END KEYBASE SALTPACK SIGNED MESSAGE.

• @lukasz-zimnoch
  BEGIN KEYBASE SALTPACK SIGNED MESSAGE. kXR7VktZdyH7rvq v5weRa0zk90sDpX wIX07Cfy2Yz31Xq 8mliRvTpoVIDeBV VZiP1JZd9ajrZlT aJyA989z1LdXGSh RsVTDD3t945dm08 KFNBAPVXIgxS0pc IQQ65jao3MlxOKj LoUAZHw8iocuSLU r4ToQ8r0csOfMaf ghxu4qaRpS32AMi GfWOezfRVRNmn1T k89GGaYstpQSJEN QiJMmD8N0B2wKB9 evzVQFn2N418RKh nI5xWYj9X6fNTv7 4PX6gTCMgQ7ndoF sUHjyqekH4L. END KEYBASE SALTPACK SIGNED MESSAGE.

---

Linux (glibc) client binary is available to download in the Assets section of the release; sha256 sum is sha256:4a1508b2c16eab3730a926ff1fd7dbe205813c66e6df4164fd9179720006db74

Signatures from the development team (verify these in the Keybase app):

• @tomaszslabon
  BEGIN KEYBASE SALTPACK SIGNED MESSAGE. kXR7VktZdyH7rvq v5weRa0zk7xdHzK Gm9BtmKb2FhcVia 1x14PuUuG7fVaLE jQhGdMxCf6maXHB usM51mxARN5pJKg ggixnuToIKawnrn 5gg8u9dP1weFX00 xervDnRkFhLTNy5 TlB1J0kHKk4xd9f FrjBHsx7fL2TXZT weMsjfDPqjnd4Ol EvQEXHIXL0P54S6 EL1stGMuREUY9s1 RJjdLD5YSYUEq2y lfuhgPJoNmNqI0h 9D4Xalq5mo5tPFT VyA6aGasKyS5REV Il7PgPRMIOy. END KEYBASE SALTPACK SIGNED MESSAGE.

• @lukasz-zimnoch
  BEGIN KEYBASE SALTPACK SIGNED MESSAGE. kXR7VktZdyH7rvq v5weRa0zk90sDpX wIX07Cfy2Yz31Xq 8mliRvTpoVIDeBV VZiP1JZd9ajLE8j 4byccGZKzaOmLnB nf1PPF6Wg6XaG6Y FRLk3fduHdjWnu4 xBdLPs3PTKkvnvo FKVwKbysaiBrKtU qnp8fiMT86NK3j2 Kr0BKR1pdAmwGwM o9wyDmMDNt84tOd 2FO0fbqtuCy5knR QQXb9D5YSYUEq2y lfuhgPJoNmNqI0h 9D4Xalq5mo5tPFT VyA6aGasKyS5REV Il7PgPRMIOy. END KEYBASE SALTPACK SIGNED MESSAGE.

---

Finally, note that the full set of work that went into the 2.0.1 version can be found in the corresponding v2.0.1 milestone.