Incentivized Testnet Phase 1: Balance Check

Overview

Compatible with Jö[email protected]

Artifact	Platform	Description
[email protected]	Linux 64-bit	Checksum for the Linux executable.
[email protected]	Linux 64-bit	Linux executable with auto-completion script for bash shell.
[email protected]	MacOs 64-bit	Checksum for the MacOS executable.
[email protected]	MacOs 64-bit	MacOS executable with necessary system libraries.
[email protected]	Windows 64-bit	Checksum for Windows executable.
[email protected]	Windows 64-bit	Windows executable with necessary DLLs.

Main Features

cardano-wallet

• A command-line interface which exposes the following features (see CLI manual):

  • 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 information
  • List available stake pools, ordered by apparent performance

• A web server which exposes the following features (see API Documentation below):

  • 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 information
  • 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, ordered by apparent performance

• 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

Known Limitations

• ⚠️ Only Jörmungandr Genesis/Praos node is supported.

Bug Fixes

• Calculating migration cost of the wallet that cannot be migrated should return 403 #1007
• Incorrect transaction amount reported on pending transactions #1004
• Chain follower does not backoff on errors #1027
• Word16 Overflow in Jörmungandr binary (SlotId) #1025
• Race condition in DaedalusIPC: not receiving 'Started' msg #1036

Known Issues

• CentOS, RHEL 6+ and SuSe Linux defect for libcrypto.so.1.0.0 #923
• --logging-config FILE.YAML more info and tests #961

Installation Instructions

Linux 64-bit

1. Install [email protected] from the official repository.

2. Download [email protected] 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/v2019-11-14/[email protected] | tar xz -C $HOME/.local/bin

3. (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

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

Mac OS 64-bit

1. Install [email protected] from the official repository.

2. Download [email protected] 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

1. Install [email protected] from the official repository.

2. Download [email protected] and uncompress it in a directory that is on your %PATH%.

Documentation

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

Weekly Reports

• Week 46 - 2019-11-15

Changelog

Miscellanous

PR	Description
#1038	reduce network exponential backoff maximum cap to 10s
#1037	Fix DaedalusIPC race-condition when sending 'Started' too quickly
#1035	Fix underflow in performance calculation
#1034	bump version to 2019-11-14
#1033	remove race condition from TRANS_DELETE_01
#1031	Test that follow doesn't retry too often
#1030	Make sure application exits when Daedalus IPC channel closes
#1029	Additional fixes for integration tests on Windows
#1028	Fix the initial sleep delay in the chain following
#1023	add roundtrip tests for mkPaymentKeyFingerprint ~ liftPaymentFingerprint
#1020	revise db bench setup to demand lazy pattern-match on environment
#1017	Update stylish-haskell to latest (v0.9.4.4)
#1016	Unit tests passing on both Windows and Wine
#1015	nix: Make a separate testing bundle for windows
#1014	Versions bump to v2019.11.12
#1011	Can run Windows integration tests under Wine
#1010	Refactor test for 1004 regression
#1006	Fix apparent performance calculation
#1005	Fix pending meta amount calculation when some outputs are ours
#1003	Attempt to fix intermittent startup issues with Jörmungandr
#1002	Review option parsing order in Jörmungandr executable
#1000	Consistent Address prefix with other services (Jörmungandr, Explorer)
#991	--sync-tolerance to control the tolerance in the sync progress calculation
#987	Produce appropriate error on failure to parse JSON within API call payload.
#985	Produce more appropriate error message on failing to decode a Shelley address.

Byron Wallet Support

PR	Description
#1008	Additional tests for migrating and calculating migration cost for wallets containing only dust
#989	re-organize and add few new integration tests for byron calculate/migrate

Create Delegation Certificate

PR	Description
#1019	change adjustForFee to account for empty coin selection

Support Delegated Addresses

PR	Description
#997	revise SQL Primary Key on delegation certificate table
#980	Move delegation certificate declaration in a separate table

Usability & Compatibility

PR	Description
#1022	Update manual tests and some testing scripts
#1012	Jörmungandr 0.7.0 rc7 -> 0.7.0
#1009	Start IPC channel as soon as the wallet BE socket is available
#998	jormungandr-win64: v0.7.0-rc6 -> 0.7.0-rc7
#994	add windows to required jobset
#992	bump haskell.nix; add Cabal patch
#988	Jormungandr 0.7.0-rc7
#986	LauncherSpec: Check that all launched processes do exit
#983	Jörmungandr v0.7.0-rc4 → v0.7.0-rc5
#981	Make API Golden tests filenames compatible with Windows
#979	Support atomic and isolated executions of the database layers
#975	Fix bench-db on windows
#974	tests: Fix Network.Wai.Middleware.LoggingSpec on Windows
#964	Add macOS tarball download to Hydra

Signatures

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