Skip to content

Releases: cardano-foundation/cardano-wallet

Release v2026-04-03

03 Apr 10:48

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@10.6.3.

Docker Image

Image

Highlights

This release bumps cardano-node to 10.6.3 and includes CI/CD infrastructure improvements: a new Windows build gate, fixed release asset uploads, and GitHub Actions bumped to Node.js 24.

Changes

Changed

  • Bump cardano-node to 10.6.3
  • Update flake inputs: haskell.nix, hackage.nix, iohk-nix (unpin from personal branch), mithril (2543.1-hotfix → 2603.1)
  • Bump ruby 3.1 → 3.3 (ruby 3.1 removed in newer nixpkgs)

Fixed

  • Release asset upload: tarballs were not uploaded due to broken shell glob expansion
  • Release script: handle idempotent re-runs (no failure when running twice on same day)
  • Pin mdbook-mermaid 0.16 for mdbook 0.4.52 compatibility
  • Attic cache now waits for musl build gate before pushing (no redundant rebuilds anymore)
  • HLint warnings from updated HLint version

CI/CD

  • Add Build Gate (Windows) for cross-compiled artifacts
  • Bump actions/checkout v4 → v6 and actions/upload-artifact v4 → v7 (Node.js 24)

Known Issues

  • (ADP-2635) Database connections do not seem to gracefully terminate on stopping the wallet.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).

Signatures

Name Role Approval
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer ✔️

Release v2026-03-31

02 Apr 15:55

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@10.6.2.

Docker Image

Image

Highlights

This release delivers a major infrastructure overhaul: full CI/CD migration from Buildkite to GitHub Actions, a GHC compiler upgrade to 9.12.2, and extraction of several internal libraries into standalone packages. A new wallet-key-export CLI tool is also included.

Changes

Added

  • New wallet-key-export executable with musl static build (#5211)
  • flaky-tests package for improved test reliability tracking (#5144)
  • LMDB ledger backend for Mithril snapshots (#5100)
  • Exposed Windows and musl packages in CI (#5085)

Changed

Dependencies

Refactoring

  • Use standalone cardano-balance-tx library (#5201, #5212)
  • Use standalone cardano-coin-selection library (#5193)
  • Consume cardano-ledger-read from external package (#5204, #5208, #5206)
  • Centralize version bounds in cabal.project (#5199)
  • Replace stylish-haskell with fourmolu (#5169)
  • Remove redundant deriving Typeable (#5198)

CI/CD

  • Migrate all CI from Buildkite to GitHub Actions (#5105)
  • Consolidate workflows into single ci.yml with build gates (#5124)
  • Complete release automation in GitHub Actions (#5153)
  • Migrate restoration benchmarks to GitHub Actions (#5149)
  • Decouple benchmark-history from Buildkite (#5143)
  • Expand Attic cache to all CI derivations (#5158)
  • Remove Buildkite remnants and dead workflows (#5185)

Fixed

  • Pin oasdiff to v1.11.11 to fix CI (#5217)
  • TLS client cert validation on Windows via readSignedObject (#5150)
  • Split Windows unit tests into per-suite artifacts (#5142)
  • Benchmark CSV artifacts not produced in GitHub Actions (#5140)
  • Dereference symlinks when copying nix store paths in release-build (#5134)
  • Separate wallet RSS from cardano-node in restoration benchmark (#5162)
  • Run restoration benchmarks in parallel (#5183)
  • Clean up E2E temp directories on cancellation (#5195)

Removed

  • Buildkite pipeline configuration and related workflows (#5185)

API Changes

New Endpoints

None.

Deleted Endpoints

None.

Modified Endpoints

The native script key hash pattern in transaction decode responses now accepts addr_vkh and stake_vkh prefixes in addition to the existing addr_shared_vkh, stake_shared_vkh, and policy_vkh prefixes.

Affected endpoints:

  • POST /wallets/{walletId}/transactions-decode
  • POST /shared-wallets/{walletId}/transactions-decode

Pattern changed from:

^((addr_shared_vkh)|(stake_shared_vkh)|(policy_vkh))1[0-9a-z]*$

to:

^((addr_shared_vkh)|(stake_shared_vkh)|(addr_vkh)|(stake_vkh)|(policy_vkh))1[0-9a-z]*$

Known Issues

  • (ADP-2953) Revision of cardano-node is not reported within version in release bundle binary for Windows.
  • (ADP-2635) Database connections do not seem to gracefully terminate on stopping the wallet.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).
  • (ADP-1831) cardano-wallet version from docker image does not report revision.

Signatures

Name Role Approval
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer ✔️

Release v2025-12-15

16 Dec 14:06

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@10.5.3.

Docker Image

Image

Changes

  • Include cardano-node 10.5.3

Known Issues

  • (ADP-2953) Revision of cardano-node is not reported within version in release bundle binary for Windows.
  • (ADP-2635) Database connections do not seem to gracefully terminate on stopping the wallet.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).
  • (ADP-1831) cardano-wallet version from docker image does not report revision.

Signatures

Name Role Approval
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer ✔️

Release v2025-03-31

31 Mar 17:34

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@10.2.1.

Docker Image

Image

Changes

  • #5037 We fixed a corner case in the use of PBKDF2 metadata encryption, caused by 64 bytes 0x0-padding
  • #5044 Cryptonite dependency was replaced by crypton as the former is not maintained anymore
  • #5056 Git revision is now displayed along with the version on the command-line
  • #5031 Added support for and distribution of cardano node 10.2.1

API changes

Known Issues

  • (ADP-2635) Database connections do not seem to terminate when the wallet is stopped gracefully.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).

Signatures

Name Role Approval
Heinrich Apfelmus @HeinrichApfelmus Software Engineer
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer
Johannes Lund @Anviking Software Engineer
David Clark @david-a-clark Product Manager
Arnaud Bailly @abailly Software Engineer ✔️

Release v2025-03-04

05 Mar 15:28

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@10.1.4.

Docker Image

Image

Changes

Added

  • Extend the option restore_mode to restore the wallet from any point on the blockchain to Shelley-style wallets created from a public key. ⚠️ Warning: Using this feature incorrectly may result in an incorrect wallet balance; if in doubt, always restore from genesis. #4984

Changed

  • Logging: Decrease severity of wallet discovery to debug. #5022

Removed

  • Remove hidden, experimental Deposit Wallet features. #4987, #5006

API changes

Show API changes

New Endpoints: None


Deleted Endpoints: None


Modified Endpoints: 3


POST /byron-wallets

  • Request body changed
    • Content changed
      • Modified media type: application/json
        • Schema changed
          • Property 'OneOf' changed
            • Modified schema: subschema #5: icarus/trezor/ledger (from xpub)
              • Properties changed
                • New property: restoration_mode

POST /wallets

  • Request body changed
    • Content changed
      • Modified media type: application/json
        • Schema changed
          • Property 'OneOf' changed
            • Modified schema: subschema #1: shelley
              • Properties changed
                • Modified property: restoration_mode
                  • Property 'OneOf' changed
                    • Modified schema: subschema #1: Restore from genesis
                    • Description changed.
                    • Modified schema: subschema #2: Restore from tip
                    • Description changed.
                    • Modified schema: subschema #3: Restore from block
                    • Description changed.
                  • Description changed.
            • Modified schema: subschema #2: shelley (from xpub)
              • Properties changed
                • New property: restoration_mode

GET /wallets/{walletId}/keys

  • Description changed.

Known Issues

  • (ADP-2953) Revision of cardano-node is not reported within version in release bundle binary for Windows.
  • (ADP-2635) Database connections do not seem to gracefully terminate on stopping the wallet.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).
  • (ADP-1831) cardano-wallet version from docker image does not report revision.

Signatures

Name Role Approval
Heinrich Apfelmus @HeinrichApfelmus Software Engineer ✔️
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer
Johannes Lund @Anviking Software Engineer
David Clark @david-a-clark Product Manager ✔️
Arnaud Bailly @abailly Software Engineer

Release v2025-01-09

09 Jan 12:48

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@10.1.4.

Docker Image

Image

Changes

Changed

API changes

New Endpoints: None


Deleted Endpoints: None


Modified Endpoints: 1


POST /wallets/{walletId}/transactions-balance

  • Responses changed
    • Modified response: 403
      • Content changed
        • Modified media type: application/json
          • Schema changed
            • Property 'OneOf' changed
              • Modified schema: subschema #3: balance_tx_conflicting_networks
                • Deprecated changed from false to true

Known Issues

  • (ADP-2953) Revision of cardano-node is not reported within version in release bundle binary for Windows.
  • (ADP-2635) Database connections do not seem to gracefully terminate on stopping the wallet.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).
  • (ADP-1831) cardano-wallet version from docker image does not report revision.

Signatures

Name Role Approval
Heinrich Apfelmus @HeinrichApfelmus Software Engineer ✔️
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer
Johannes Lund @Anviking Software Engineer
David Clark @david-a-clark Product Manager ✔️

Release v2025-01-07

08 Jan 14:05

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@10.1.3.

Docker Image

Image

Changes

Added

Changed

  • Support DRep identifiers in the CIP-105 format for backward compatibility. #4855
  • Supports DRep identifiers in the new CIP-129 format. #4888

Fixed

  • In the constructTransaction endpoint:
    • Add certificates to the coin_selection field of the result. #4871
    • For wallets that were created using an account_public_key, always allow creation of transactions that delegate voting power. #4872
    • Add same_vote error to the 403 response. #4870, #4884
  • Fix the nixosModule of the cardano-wallet flake. #4522

Contributions

API changes

bump.hs

Known Issues

  • (ADP-2953) Revision of cardano-node is not reported within version in release bundle binary for Windows.
  • (ADP-2635) Database connections do not seem to gracefully terminate on stopping the wallet.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).
  • (ADP-1831) cardano-wallet version from docker image does not report revision.

Signatures

Name Role Approval
Heinrich Apfelmus @HeinrichApfelmus Software Engineer ✔️
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer
Johannes Lund @Anviking Software Engineer
David Clark @david-a-clark Product Manager ✔️

Release v2024-11-18

19 Nov 12:21

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@10.1.2.

Docker Image

Image

Changes

Fixed

Changed

  • Better error message when trying to withdraw from the reward account when not delegating voting power to a DRep. #4839

API changes

No API changes.

Known Issues

  • (ADP-2953) Revision of cardano-node is not reported within version in release bundle binary for Windows.
  • (ADP-2635) Database connections do not seem to gracefully terminate on stopping the wallet.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).
  • (ADP-1831) cardano-wallet version from docker image does not report revision.

Signatures

Name Role Approval
Heinrich Apfelmus @HeinrichApfelmus Software Engineer ✔️
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer
Johannes Lund @Anviking Software Engineer
David Clark @david-a-clark Product Manager ✔️

Release v2024-09-29

30 Sep 14:57

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@9.2.1.

DockerHub Image

Image

Changes

Changed

API changes

No API changes.

Known Issues

  • (ADP-2953) Revision of cardano-node is not reported within version in release bundle binary for Windows.
  • (ADP-2635) Database connections do not seem to gracefully terminate on stopping the wallet.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).
  • (ADP-1831) cardano-wallet version from docker image does not report revision.

Signatures

Name Role Approval
Heinrich Apfelmus @HeinrichApfelmus Software Engineer ✔️
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer
Johannes Lund @Anviking Software Engineer
David Clark @david-a-clark Product Manager ✔️

Release v2024-09-26

27 Sep 13:09

Choose a tag to compare

Node Compatibility

Compatible with cardano-node@9.2.0.

Docker Image

Image

Changes

Changed

API changes

No API changes

Known Issues

  • (ADP-2953) Revision of cardano-node is not reported within version in release bundle binary for Windows.
  • (ADP-2635) Database connections do not seem to gracefully terminate on stopping the wallet.
  • (ADP-2298) Deposit_returned is falsely reported on some incoming transactions (intermittently).
  • (ADP-1831) cardano-wallet version from docker image does not report revision.

Signatures

Name Role Approval
Heinrich Apfelmus @HeinrichApfelmus Software Engineer ✔️
Paolo Veronelli @paolino Software Engineer ✔️
Pawel Jakubas @paweljakubas Software Engineer
Johannes Lund @Anviking Software Engineer
David Clark @david-a-clark Product Manager