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_inputs
andinput_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)
FeeTooSmallUTxO
error when submitting transaction from shared wallet. (ADP-2221)- Problem with
stake-pool.sqlite
/pools-engine
sync after upgrading tocardano-wallet
v2022-08-16
and large memory usage. (ADP-2227) - 🏗
balanceTransaction
does not yet support balancing transactions with total collateral or collateral return set, but will fail gracefully. (ADP-1684, ADP-1685) - 🏗
balanceTransaction
does 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,
postTransaction
is 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-09
tov2021-09-29
when 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-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 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 | ✔️ |