v2022-07-01

This release captures a first compatible version of cardano-wallet ready to be deployed, tested, and implemented in your products on the newly forked Babbage Era of the Cardano Testnet. While cardano-wallet’s feature set will continue performing as expected in most cases, we do know of some exceptions (see ⚠️ below).

This release will be followed by a release(s) addressing these known issues. If you find there are other issues please create a GitHub Issue in this repository.

Compatible with cardano-node@1.35.0.

Changes

Added

• Support for cardano-node 1.35.0 (#3293 #3280 #3340 #3349 #3357, #3347, #3354)
• 🏗 Partial support for Babbage era / Vasil HF (#3308, #3311, #3362, #3360, #3326)
  • The wallet should continue working in Babbage, with some exceptions:
    1. ⚠️ The minimum UTxO calculation could be incorrect for Babbage in some cases. This calculation is used:
       • within postTransaction:
         • to provide minimum ada quantities for user-specified outputs without ada;
         • to compute minimum ada quantities for auto-generated change outputs;
       • within createWalletMigrationPlan and migrateWallet, to compute minimum ada quantities for auto-generated outputs.
       • when validating requests to balanceTransaction.
    2. ⚠️ New transaction workflow endpoints are currently biased towards deserialising and submitting transactions binaries as Alonzo transactions even in Babbage. The implications of this should be minor, as these transactions are still acceptable by the node.
  • balanceTransaction does not yet support balancing transactions with total collateral or collateral return set, but will fail gracefully. #3343
  • Wallets are able to discover collateral return outputs in transactions. #3251 #3346 #3367

Fixed

• For Babbage (and possibly Alonzo) era transactions, the API does not correctly reflect the script validity (ADP-1970, #3365)

API Changes

https://bump.sh/doc/cardano-wallet-diff/changes/f1ff267d-448f-4d65-b988-eb4df3f6356f

Show API changes

Modified: GET /network/parameters

• 200 response was modified
  • eras body attribute was modified

Known Issues

• Potential regression in wallet restoration (ADP-1371)
• Occasional invalid transaction error (MaxTxSizeUTxO) on wallets with big amounts of assets (ADP-1052)
• High memory usage observed in SPO testnet wallet (ADP-776)
• Rare SQLite3 constraint errors when making transactions (ADP-773)
• On really large wallets, postTransaction is slow and sometimes returns transaction_is_too_big (ADP-772)
• Fee estimation slowness (up to 4x slower when there are many wallets, comparing with old selection algorithm) (ADP-702)
• Listing transaction time deteriorated (even up to 3x) (ADP-691)
• Wallet restoration time deteriorated 2x in v2021-01-28 (ADP-690)
• Wallet disappears after migration from v2021-09-09 to v2021-09-29 when there are pending transaction (ADP-1224)
• Error "restoreBlocks: given chain isn't a valid continuation" when quickly creating new wallets after startup (ADP-1148)
• Icarus wallets restoration is ~3x slower than random/shelley (ADP-785)
• Multi-addresses transactions sometimes result in an internal server error. (ADP-571)

Documentation

📕	💻	🐳
API Documentation	CLI Manual	Docker Manual

Installation Instructions

1. Install cardano-node@1.35.0.

2. Download the provided cardano-wallet for your platform, and uncompress it in a directory that is on your $PATH, e.g. /usr/local/bin. Or %PATH% on Windows.

3. Start cardano-wallet --help and see available parameters.

Docker

Pull from DockerHub and verify the version matches 2022.7.1.

$ docker pull inputoutput/cardano-wallet:2022.7.1
$ docker run --rm inputoutput/cardano-wallet:2022.7.1 version

Signatures

Name	Role	Approval
Heinrich Apfelmus @HeinrichApfelmus	Haskell Engineering Lead	✔️
Piotr Stachyra @piotr-iohk	QA Engineer	✔️
Laurence Jenkins @LaurenceIO	Release Manager	✔️