Overview

Compatible with `Jörmungandr@v0.8.9`

Artifact	Platform	Description
`cardano-wallet-jormungandr-linux64-v2020-02-17.tar.gz`	Linux 64-bit	Linux executable with auto-completion script for bash shell.
`cardano-wallet-jormungandr-macos64-v2020-02-17.tar.gz`	MacOs 64-bit	MacOS executable with required system libraries.
`cardano-wallet-jormungandr-win64-v2020-02-17.zip`	Windows 64-bit	Windows executable with required DLLs.

Main Features

cardano-wallet

command-line

Create and Delete wallet
Get details of a particular wallet
List all known wallets
Generate BIP-39 mnemonic sentence (English) of various sizes
Update wallet metadata
Create and submit transactions from a single wallet
List known (used or unused) addresses of a wallet
Estimate transaction fee
Visualize wallet's UTxO distribution
Update wallet encryption passphrase
List transaction history
Submit already signed transactions
Serve wallet against Jörmungandr
- --sync-tolerance option for tweaking server tolerance regarding network syncing.
Launch wallet against Jörmungandr
- --sync-tolerance option passed down to the server.
Get network syncing status
List available stake-pools
Generate testnet reward credentials from a given mnemonic sentence
Get network parameters

web server

Create and delete wallet
Get details of a particular wallet
List all known wallets
Update wallet metadata & wallet encryption passphrase
Create and submit transactions from a single wallet
List known (used or unused) addresses of a wallet
API and server logs
Estimate transaction fee
Visualize wallet's UTxO distribution
List transaction history
Submit already signed transactions
Get network syncing status
Create Byron wallets
Delete Byron wallets
Get and List Byron wallets
Forget pending transaction of Shelley wallets
List transaction history of Byron wallets
Forget pending transaction of a Byron wallet
Migrate Byron wallets to Shelley wallets
List available stake-pools
Delegate all funds from a wallet to a stake-pool
Fetch total reward balance earned from delegation
Stop delegating funds from a wallet
Support stake pool off-chain metadata
Get network parameters

miscellaneous

Node.js-compatible IPC server with custom protocol
Data-persistence to disk via SQLite
Support for Ouroboros Genesis/Praos and proper chain following in the events of chain switches
Per-component log management

Known Limitations

⚠️ Only Jörmungandr Genesis/Praos node is supported.
🎉 Early experimental support for cardano-node is now available but not considered stable yet.

Bug Fixes

persistent library clears foreign tables on automatic migration due to cascading delete #1279

Known Issues

Cannot list wallets when using same state directory but different genesis #1292
Windows tests are failing on hydra #1283

Installation Instructions

Linux 64-bit

Install jormungandr@0.8.9 from the official repository.
Download cardano-wallet-jormungandr-linux64-v2020-02-17.tar.gz and uncompress it in a directory that is on your $PATH, e.g. /usr/local/bin.

$ curl -L https://github.com/input-output-hk/cardano-wallet/releases/download/v2020-02-17/cardano-wallet-jormungandr-linux64-v2019-12-16.tar.gz | tar xz -C $HOME/.local/bin

(optional) Install the bash/zsh auto-completion script:

$ mv $HOME/.local/bin/cardano-wallet.sh > /etc/bash_completion.d/cardano-wallet.sh
$ source /etc/bash_completion.d/cardano-wallet.sh

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

Mac OS 64-bit

Install jormungandr@0.8.9 from the official repository.
Download cardano-wallet-jormungandr-macos64-v2020-02-17.tar.gz and uncompress it in a directory that is on your $PATH, e.g. /usr/local/bin.

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

Windows 64-bit

Install jormungandr@0.8.9 from the official repository.
Download cardano-wallet-jormungandr-win64-v2020-02-17.zip and uncompress it in a directory that is on your %PATH%.

Docker

Pull from DockerHub.

$ docker pull inputoutput/cardano-wallet:2020.2.17-jormungandr

Verify the image using the command-line.

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

Documentation

Link	Audience
API Documentation	Users of the Cardano Wallet API
CLI Manual	Users of the Cardano Wallet API
Docker Manual	Users of the Cardano Wallet API
Haddock Documentation	Haskell Developers using the `cardano-wallet` as a library

Weekly Reports

Changelog

Miscellaneous

PR	Description
#1352	bump versions to v2020-02-17
#1340	Disable foreign key constraints during automatic database migration.
#1319	Jörmungandr 0.8.9 bump
#1310	Correct link label
#1309	Update compat matrix in Readme.
#1301	Simplify worker registration lifecycle.

(ADP-111) Better reporting of delays in delegation status

PR	Description
#1322	Better delegation reporiting - impl
#1318	Better delegation status impl - swagger and types

(ADP-141) Multiple next's support in delegation reporting

PR	Description
#1349	Remove pool id path parameter from the quit delegation endpoint
#1337	Correct the delegation certificates DB retrieval logic and move the logic downstream

(ADP-159) Local Tx Submission Integration

PR	Description
#1348	LocalTxSubmission real implementation (remove 'localTxSubmissionNull' placeholder)

(ADP-81) Wallet: Command-line utils for key derivation

PR	Description
#1343	Introduce SomeMnemonic as source of root keys (instead of entropy)

(ADP-94) Bech32 Library Extraction

PR	Description
#1336	Remove local copy of `bech32` library.
#1326	Check Bech32 human-readable prefix literals at compile time.

(WB-47) Expose blockchain parameters via new endpoint

PR	Description
#1341	Few new cases in network params cli tests
#1330	CLI support for getting network parameters
#1313	NETWORK_PARAMS - refactor tests and add test for maxBound epoch boundary value
#1306	Blockchain params endpoint impl

(WB-53) Integrate cardano-wallet with Haskell Byron-rewrite

PR	Description
#1303	Byron-Rewrite node's integration

(WB-??) Clean up integration tests

PR	Description
#1339	Rename `greaterThan` to `(.>)`
#1317	Revise test expectations

Signatures

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

cardano-foundation/cardano-wallet v2020-02-17 Experimental cardano-node on GitHub