github cardano-foundation/cardano-wallet v2026-09-16
Release v2026-09-16

11 hours ago

Node Compatibility

Compatible with cardano-node@11.1.1.

cardano-node 11.1.0 does not work with this release and must not be used with it.
cardano-ledger-shelley 1.19.0.0 grew the ShelleyGenesis CBOR record from 15 fields
to 16 with no version guard, so a node built on it answers GetGenesisConfig in a
format this wallet cannot decode; the wallet dies at startup with
DeserialiseFailure … Size mismatch when decoding Record ShelleyGenesis. Expected 15, but found 16 (#5416).
11.1.0 was a prerelease and was superseded by 11.1.1, which restores the 15-field
encoding (ouroboros-consensus#2251).
Nodes at 11.0.1 and earlier speak the same 15-field format and are unaffected.

Docker Image

$ docker pull cardanofoundation/cardano-wallet:v2026-09-16
$ docker run --rm cardanofoundation/cardano-wallet:v2026-09-16 version

Tags on Docker Hub

Highlights

This release moves the dependency pin set to cardano-node 11.1.1, which is what makes
it safe to run: the 11.1.0 line could not exchange genesis configuration with the wallet
at all. It continues Dijkstra era support by closing the remaining per-era conversion
stubs, and it removes iohk-monitoring in favour of contra-tracer. Two user-facing
bugs are fixed: wallet database workers now drain on shutdown, and re-delegating to a
DRep the wallet has used before no longer fails.

Changes

Fixed

  • Gracefully drain wallet database workers on shutdown, so stopping the wallet no longer leaves database connections to terminate abruptly (#5388, closes #5326)
  • Allow re-delegating to a DRep the wallet has previously delegated to (#5363)
  • Dijkstra: use one native script conversion for both transaction read sites, replacing two era-specific readers that aborted on Dijkstra (#5432)

Changed

  • Advance the dependency pin set to cardano-node 11.1.1 (#5435), via 11.1.0 (#5399)
  • Drop iohk-monitoring and use contra-tracer directly (#5402)
  • Dijkstra: close the five per-era converter stubs (#5430)
  • Dijkstra: delete the spurious era split in mkLedgerTx and sweep the other suspected sites (#5428)
  • Read transaction bodies from the ledger instead of the deprecated cardano-api surface (#5413)
  • Retire cardano-api deprecations in the Shelley transaction spec modules (#5420)

Internal

  • Enforce the Dijkstra stub census ratchet on every PR (#5407)
  • Bind the cardano-api closure ratchet's own controls to observable consequences (#5426)
  • Create the release merge-back PR automatically after publication (#5386), and merge back the v2026-08-21 version bumps (#5384)

API changes

No endpoint changes, but there are some other changes

Known Issues

  • (#5075) Byron random wallet migration using a secret.key fails with MissingVKeyWitnessesUTXOW.
  • (#5170) On GHC 9.12.2, UTxO reads are about twice as slow at 10k UTxOs and TxHistory writes are heavier.

Signatures

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

Don't miss a new cardano-wallet release

NewReleases is sending notifications on new releases.