v2023-04-14
·
5064 commits
to master
since this release
Compatible with [email protected]
.
Changes
Fixed
- The listStakePools endpoint no longer returns null values for the
metadata
andretirement
fields if no data is available. Instead, if no data is available, these fields are simply omitted from the JSON response. This fixes a regression introduced in the v2022-12-14 release. (ADP-2523, PR 3675) - When the wallet decodes a transaction that includes native scripts (that act as witnesses and contain key hashes):
- If the key hash belongs to the wallet (i.e., it is an "internal" hash), the wallet will mark these as belonging to the wallet and use an appropriate bech32 prefix in the JSON representation:
policy_vkh
addr_shared_vkh
stake_shared_vkh
- If the key hash does not belong to the wallet (i.e., it is an "external" hash), the wallet will represent these hashes with hexadecimal values, and not include a bech32 prefix in the JSON representation.
- If the key hash belongs to the wallet (i.e., it is an "internal" hash), the wallet will mark these as belonging to the wallet and use an appropriate bech32 prefix in the JSON representation:
This brings the wallet into compliance with CIP-0005 and CIP-1855.
The following endpoints are affected:
- Incomplete shared wallet is no longer silently syncing in background (ADP-2432, PR 3676)
- Tx history not available after receiving token from minting transaction made using reference script (ADP-2666)
- Unexpected "balance_tx_underestimated_fee" on the preprod Shelley/Shared wallet (ADP-2646)
Changed
⚠️ When starting an updatedcardano-wallet
with an old database file, all transactions that hadPending
orExpired
status will be forgotten about, so that the wallet will not attempt to re-submit these transactions. (Note that these transactions can still reappear withInLedger
status). This is due to an internal database migration. While inconvenient, user impact should be small, as:- this database migration will be performed only once (during the first startup of the updated wallet); and
- most
Pending
transactions will have expired naturally before the user opens their wallet again.
⚠️ When starting an updatedcardano-wallet
with an old database file, this database file will be migrated and can no longer be used with old versions ofcardano-wallet
. If you wish to revert to an old version of the software, please make a backup of the database file, or you will have to restore your wallets from scratch. (ADP-2367, PR 3717)- The transaction history is now stored on-disk again, reducing RAM usage at the expense of query time. (ADP-2780, PR 3763; ADP-2871, PR 3828)
- Fees are now reported for all transactions, both incoming and outgoing, in the transaction history. Previously, fees were only reported on outgoing transactions. However, please note that for transactions made during the Byron era, the fee will still be reported as 0. (ADP-2840)
Added
- User documentation for shared wallets. (ADP-2457)
- New endpoints for shared wallets (ADP-2636):
- Add an optional limit
max_count
to the number of transactions returned byGET /transactions
endpoint. This is useful to limit the resource consumption of this endpoint for large wallets. (ADP-2788, PR 3772)
Removed
- Removed all references to the stack build tool from user documentation, replacing these references with equivalent instructions to build with cabal (and nix) instead. (ADP-2102, PR 3671)
- Removed Blockfrost-related CLI options from the
cardano-wallet
executable, and all support for Blockfrost from Cardano Wallet. (ADP-2272, PR 3668)
API Changes
https://bump.sh/doc/cardano-wallet-diff/changes#event-change-95213dc1-6199-451f-80d8-b9898e7bb0d7
Known Issues
- error "restoreBlocks: given chain isn't a valid continuation" when quickly creating new wallets after startup (ADP-1148)
- 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)
- Multi-addresses transactions sometimes result in an internal server error. (ADP-571)
Documentation
📕 | 💻 | 🐳 |
---|---|---|
API Documentation | CLI Manual | Docker Manual |
Installation Instructions
-
Install
[email protected]
. -
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. -
Start
cardano-wallet --help
and see available parameters.
Docker
Pull from DockerHub and verify the version matches 2023.4.14.
$ docker pull inputoutput/cardano-wallet:2023.4.14
$ docker run --rm inputoutput/cardano-wallet:2023.4.14 version
Signatures
Name | Role | Approval |
---|---|---|
Yura Lazarev @Unisay | Software Engineer | ✔️ |
Piotr Stachyra @piotr-iohk | QA Engineer | ✔️ |
Laurence Jenkins @LaurenceIO | Release Manager | ✔️ |