Shelley Hard-Fork

Compatible with [email protected] and [email protected].

New Features

• Support for the hard-fork combinator #1875 #1887 #1890 #1898 #1899 #1901 #1909 #1922 #1924 #1931
• Support for transaction withdrawals in Shelley (new query parameter ?withdrawReward) #1865 #1892
• Support for a minimum UTxO threshold in Shelley #1894 #1916 #1927 #1947
• Support of bootstrap Byron witnesses in Shelley Transactions #1849
• Support for the Shelley hard-fork countdown #1932
• Processing of stake pool retirement certificates #1847 #1913 #1945 #1957 #1968
• Enabled latency benchmark for the byron;shelley server #1829 #1845

Improvements

• Added more debug-level logs in the chain-sync client #1826
• Configured log rotation in docker-compose #1797
• Reduce verbosity of the pools engine (in particular, when fetching non-myopic member rewards) #1864
• docker: Make latest point to latest shelley image #1938

Resolved Issues

• #1708 [MAJOR] cardano-wallet-shelley workers crash
• #1713 [MAJOR] Performance issues /v2/byron-wallets/{walletId}/addresses API
• #1733 [MINOR] cardano-wallet-shelley address CLI has commands which are not supported for Shelley wallets
• #1823 [MAJOR] Trying to join pool returns 500 when there's no next delegation
• #1833 [MAJOR] There are un-joinable pools on shelley_testnet

Known Issues

• #1572 [MINOR] Recovery from chain-following exceptions may cause node to crash
• #1743 [MINOR] Required wallet DB fields do not get persistently added
• #1867 [MINOR] Wallet doesn't show meta data re-registered (in case of changing metadata url without changing metadata hash)
• #1905 [MINOR] Fee estimation on shelley wallet when takes very long when: transaction's amount > available balance
• #1963 [MINOR] Stake pool DB worker doesn't save sync progress in Byron

---

⚠️ IMPORTANT ⚠️

While in the Byron era, cardano-wallet will be unable to emit transactions. Once the hard-fork has occurred, the entire interface will become fully functioning.

---

Documentation

Link	Audience
API Documentation	Users of the Cardano Wallet API
CLI Manual / CLI Manual (ITN)	Users of the Cardano Wallet API
Docker Manual / Docker Manual (ITN)	Users of the Cardano Wallet API

Installation Instructions

Cardano (cardano-node)

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

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

ITN (jormungandr)

1. Install [email protected].

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

3. (optional) Install the bash/zsh auto-completion script according to the jormungandr cli manual

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

Docker

Pull from DockerHub and verify the version matches 2020.7.28

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

Additional notes

• On macOS: Make sure all *.dylib files are in the same directory as cardano-wallet binary.

Signatures

Name	Role	Approval
Matthias Benkort @KtorZ	Technical Team Lead	✔️
Piotr Stachyra @piotr-iohk	QA Engineer	✔️
Tatyana Valkevych @tatyanavych	Release Manager	✔️