This release is compatible with the Babbage Era of the Cardano network. It is ready to be deployed, tested, and implemented in your products.
However, some features that are specific to the Babbage Era are still under construction, see 🏗 below.
Compatible with cardano-node@1.35.3.
Changes
Fixed
-
Creating a Byron address no longer fails intermittently. If an address was not created explicitly by the user, the wallet would sometimes create it implicitly as a change address, leading to misattribution of funds in some exchange use cases. (ADP-2211, ADP-2283, PR 3528)
-
Fee calculation performance deterioration. (ADP-2144 / PR 3456)
-
Patched shared wallets have the correct address gap and address pool.
(ADP-2219, PR-3500).
Changed
-
All REST API endpoints involving transaction construction now have additional documentation to explain how the wallet handles minimum UTxO values for user-specified transaction outputs. (ADP-2250 / PR 3524)
-
Improved validation and resolution of user-provided inputs in POST /wallet/{wid}/transactions-balance. Two new errors were added:
unresolved_inputsandinput_resolution_conflicts. These replace behaviour that was previously undefined. (ADP-1662 / PR 3475) -
Reintroduced database blocking in light-mode, preventing concurrent API calls. (PR 3528)
Added
-
Preliminary sign, decode, and submit endpoints for shared wallets. (ADP-1850, PR-2425, PR-3499).
-
Support for new transaction workflow that makes it possible for construction, signing and submission to be performed in separate steps. This process also includes support for balancing and decoding.
(ADP-2083, PR-3449). -
Support for using scripts and non-extended keys when constructing addresses. This is in addition to the existing support for script hashes, extended keys and key hashes.
(ADP-2114, PR-3435).
Removed
API Changes
https://bump.sh/doc/cardano-wallet-diff/changes/a36a1baa-66a6-42df-a4e3-c6627d6b7a57 ⚠️ Breaking ⚠️
Show API changes
GET /blocks/latest/header
POST /shared-wallets/{walletId}/transactions-sign
POST /shared-wallets/{walletId}/transactions-submit
GET /network/parameters
200 response was modified
minimum_utxo_value attribute was removed ⚠️ Breaking ⚠️
POST /byron-wallets/{walletId}/transactions
425 response was added
POST /shared-wallets/{walletId}/transactions-construct
encoding attribute was added
POST /wallets/{walletId}/transactions
425 response was added
POST /wallets/{walletId}/transactions-balance
encoding attribute was added
400 response was modified
POST /wallets/{walletId}/transactions-construct
encoding attribute was added
POST /wallets/{walletId}/transactions-sign
encoding attribute was added
Known Issues
- Light-mode currently does not work. (ADP-2285)
- Database benchmarks are failing. (ADP-2202)
FeeTooSmallUTxOerror when submitting transaction from shared wallet. (ADP-2221)- Problem with
stake-pool.sqlite/pools-enginesync after upgrading tocardano-walletv2022-08-16and large memory usage. (ADP-2227) - 🏗
balanceTransactiondoes not yet support balancing transactions with total collateral or collateral return set, but will fail gracefully. (ADP-1684, ADP-1685) - 🏗
balanceTransactiondoes not yet fully support balancing transactions with reference inputs or inline datums. (ADP-1655) - 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,
postTransactionis slow and sometimes returnstransaction_is_too_big. (ADP-772) - Fee estimation slowness (up to 4x slower when there are many wallets, comparing with old selection algorithm). (ADP-702)
- Wallet restoration time deteriorated 2x in
v2021-01-28. (ADP-690) - Wallet disappears after migration from
v2021-09-09tov2021-09-29when there are pending transactions. (ADP-1224) - Error "restoreBlocks: given chain isn't a valid continuation" when quickly creating new wallets after startup. (ADP-1148)
- Icarus wallet restoration is ~3x slower than Random/Shelley. (ADP-785)
- Multi-address transactions sometimes result in an internal server error. (ADP-571)
New Contributors
Documentation
| 📕 | 💻 | 🐳 |
|---|---|---|
| API Documentation | CLI Manual | Docker Manual |
Installation Instructions
-
Install
cardano-node@1.35.3. -
Download the provided
cardano-walletfor your platform, and uncompress it in a directory that is on your$PATH, e.g./usr/local/bin. Or%PATH%on Windows. -
Start
cardano-wallet --helpand see available parameters.
Docker
Pull from DockerHub and verify the version matches 2022.10.6.
$ docker pull inputoutput/cardano-wallet:2022.10.6
$ docker run --rm inputoutput/cardano-wallet:2022.10.6 version
Signatures
| Name | Role | Approval |
|---|---|---|
| Jonathan Knowles @jonathanknowles | Release Lead | ✔️ |
| Heinrich Apfelmus @HeinrichApfelmus | Haskell Engineering Lead | ✔️ |
| Piotr Stachyra @piotr-iohk | QA Engineer | ✔️ |
| Laurence Jenkins @LaurenceIO | Release Manager | ✔️ |