Feature release

Compatible with [email protected].

API Changes

• Updated: GET /byron-wallets/{walletId}/assets
  • Response modified: 200
    • Body attribute added: metadata_error
• Updated: GET /byron-wallets/{walletId}/assets/{policyId}/{assetName}
  • Response modified: 200
    • Body attribute added: metadata_error
• Updated: GET /byron-wallets/{walletId}/assets/{policyId}
  • Response modified: 200
    • Body attribute added: metadata_error
• Removed: GET /byron-wallets/{walletId}/migrations
• Updated: POST /byron-wallets/{walletId}/migrations
  • Response added: 202
  • Response removed: 200
• Added: POST /byron-wallets/{walletId}/migrations/plan
• Added: GET /shared-wallets
• Added: POST /shared-wallets/{walletId}/keys/{index}
• Added: GET /shared-wallets/{walletId}/keys
• Added: GET /shared-wallets/{walletId}/keys/{role}/{index}
• Added: GET /shared-wallets/{walletId}/addresses
• Updated: GET /wallets/{walletId}/assets
  • Response modified: 200
    • Body attribute added: metadata_error
• Updated: GET /wallets/{walletId}/assets/{policyId}/{assetName}
  • Response modified: 200
    • Body attribute added: metadata_error
• Updated: GET /wallets/{walletId}/assets/{policyId}
  • Response modified: 200
    • Body attribute added: metadata_error
• Updated: POST /wallets/{walletId}/keys/{index}
  • Body attribute added: format
  • Body attribute removed: extended
• Added: GET /wallets/{walletId}/keys
• Removed: GET /wallets/{walletId}/migrations
• Updated: POST /wallets/{walletId}/migrations
  • Response added: 202
  • Response removed: 200
• Added: POST /wallets/{walletId}/migrations/plan

New Features

• Reinstate the API for wallet migrations, now with multi-asset support. A wallet migration sends all ada and tokens in a wallet to one or more target addresses. #2590 #2620 #2632 #2637 #2644 #2638 #2655 #2654 #2652 #2658 #2667 #2665 #2668 #2662

• Add support for the "decimals" metadata field. #2648 #2656 #2671

• Add API endpoints to create and configure shared wallets. These wallets can be created, but do not yet show a balance or transaction history. #2650 #2624 #2651 #2659 #2660 #2663 #2673

Improvements

• Optimize Hydra eval #2645

• Fix slow ApiSharedWallet unit tests #2664

• Other assorted build changes for CI and releases. #2623 #2626 #2628 #2629 #2631 #2633 #2640 #2641 #2669 #2672

Resolved Issues

• Force command-line arguments to be UTF-8 decoded. #2661

• Remove icarus genesis gap hack which was making integration tests slow. #2643

• Include error status in the getAsset and listAssets endpoints if there was an error fetching from the token metadata server. #2670 #2674

Known Issues

• Nightly restore benchmark runs out of memory (ADP-846)
• 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)
• 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 [email protected].

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 2021.5.26.

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

Signatures

Name	Role	Approval
Rodney Lorrimar @rvl	Technical Team Lead	✔️
Piotr Stachyra @piotr-iohk	QA Engineer	✔️
Laurence Jenkins @LaurenceIO	Release Manager	✔️