Skip to content

Basic Shelley Testnet Support
Compare
Choose a tag to compare
@WilliamKingNoel-Bot WilliamKingNoel-Bot released this 10 Jun 12:19
v2020-06-05
This tag was signed with the committer’s verified signature.
KtorZ Matthias Benkort
GPG key ID: 33173CB6F77F4277
Learn about vigilant mode.
5290acf
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

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

New Features

  • New cardano-wallet-shelley executable targeting the first Shelley-only testnet that contains wallet, address and transaction support #1626 #1669 #1673 #1677 (Delegation features will be added in a further release)
  • Live reporting of the decentralization parameter d for the mainnet Byron-to-Shelley transition #1725
  • Support for restoring sequential Byron wallets from account public keys (previously only supported for Shelley) #1721
  • New migration endpoints which support migrating funds from any wallet to any set of addresses. Previously migration only allowed migration from a Byron wallet to a known new wallet #1664, #1645, #1678, #1687, #1684

Improvements

  • Up to 40% faster wallet restoration using pipelined chain sync #1615 #1665
  • Reduced randomness when estimating transaction fees from running multiple selections #1679 #1653
  • Usability and documentation improvements
    • Exemplary docker-compose.yaml for cardano-wallet and cardano-node #1634
    • API and CLI documentation improvements
      • Clarified the description of getNetworkParameters in the API and CLI. #1698
    • Code and Haddock documentation improvements #1728 #1715
    • Reduced / adjusted logging for NetworkLayer and NTP client #1630 #1636
    • Better rendering of bech32 error messages in key derivation CLI #1625 #1654

Removed

  • #1694 Breaking ⚠️ Removed epochId argument from getNetworkParameters.

Resolved Issues

  • #1701 Wallet "passphrase" info gets lost after updating cardano-wallet (#1704, #1717)
  • #1647 cardano-wallet-jormungandr: Blockchain tip not set in REST context (#1681)
  • #1670 Different behavior regarding resolved inputs when listing transactions with and without query parameters (#1685, #1696, #1697)
  • #1683 Incorrectly documented HTTP response code for fee-estimation (should be 202 instead of 200)
  • #1659 Race condition between byron addresses creation and wallet restoration
  • #1660 The latest docker tag is now available as latest, instead of separate tags for each revisions, to avoid cluttering
  • #1638 Modifed docker-compose.yml example so it is possible to run mainnet and testnet interchangeably

Known issues

  • #1733 cardano-wallet-shelley address CLI has import and create commands which are not supported for Shelley wallets
  • #1708 cardano-wallet-shelley workers crash
  • #1572 Recovery from chain-following exceptions may cause node to crash

Documentation

Link Audience
API Documentation Users of the Cardano Wallet API
CLI Manual: ITN / Byron Users of the Cardano Wallet API
Docker Manual Users of the Cardano Wallet API

Supported Operating Systems

  • Windows 64 bit
  • Linux 64 bit
  • MacOS 64 bit

Installation Instructions

Shelley testnet (cardano-node)

  1. Install [email protected]

  2. Download the provided cardano-wallet-shelley 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.6.5:

$ docker pull inputoutput/cardano-wallet:2020.6.5-shelley
$ docker run --rm inputoutput/cardano-wallet:2020.6.5-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.6.5:

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

Byron (cardano-node)

  1. Install [email protected]

  2. Download the provided cardano-wallet-byron 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 byron cli manual

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

Docker

Pull from DockerHub and verify the version matches 2020.6.5:

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

Additional notes

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

Troubleshooting

cardano-wallet: error while loading shared libraries: libcrypto.so.1.0.0: cannot open shared object file: No such file or directory

libcrypto 1.0.0 is no longer shipped with RHEL for a while (since ver. 6) and
SuSE. On these distributions, it is impossible to install it using native
package manager (e.g. yum).

One possible work-around is to create an artificial symbolic link from a newer version of libcrypto:

sudo ln -s /usr/lib64/libcrypto.so.1.1.1 /usr/lib64/libcrypto.so.1.0.0

Alternatively, one may also try using the docker image instead.

Signatures

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