Skip to content

Releases: cardano-foundation/cardano-wallet

Per-component logging

18 Jan 17:09
v2020-01-14
17edc2a
Compare
Choose a tag to compare

Overview

Compatible with Jörmungandr@v0.8.5

Artifact Platform Description
cardano-wallet-jormungandr-linux64-v2020-01-14.tar.gz
Linux 64-bit
Linux executable with auto-completion script for bash shell.
cardano-wallet-jormungandr-macos64-v2020-01-14.tar.gz
MacOs 64-bit
MacOS executable with required system libraries.
cardano-wallet-jormungandr-win64-v2020-01-14.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 information
  • List available stake-pools, ordered by apparent performance
  • Generate testnet reward credentials from a given mnemonic sentence
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 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
  • 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
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
  • ![][new] Per-component log management

Known Limitations

Bug Fixes

  • --logging-config FILE.YAML more info and tests #961
  • Error in the log after deleting a wallet #1242
  • Benchmarks are failing #1252

Known Issues

  • Missing database migration for active_slot_coeff #1251
  • "Something went wrong" when listing stake pools from inside a Docker container #1256
  • Failing tests integration tests on Windows #1115
  • Log of severity "DEBUG" shows up as "INFO" #1273
  • Rolling back stake pools take ages #1281
  • persistent clear foreign tables on automatic migration due to cascading delete #1279

Installation Instructions

Linux 64-bit

  1. Install jormungandr@0.8.5 from the official repository.

  2. Download cardano-wallet-jormungandr-linux64-v2020-01-14.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-01-14/cardano-wallet-jormungandr-linux64-v2019-12-16.tar.gz | tar xz -C $HOME/.local/bin
  1. (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
  1. Start cardano-wallet --help and see available parameters.

Mac OS 64-bit

  1. Install jormungandr@0.8.5 from the official repository.

  2. Download cardano-wallet-jormungandr-macos64-v2020-01-14.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

  1. Install jormungandr@0.8.5 from the official repository.

  2. Download cardano-wallet-jormungandr-win64-v2020-01-14.zip and uncompress it in a directory that is on your %PATH%.

Docker

  1. Pull from DockerHub.
$ docker pull inputoutput/cardano-wallet:2020.1.14-jormungandr
  1. Verify the image using the command-line.
$ docker run --rm inputoutput/cardano-wallet:2020.1.14 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
#1106 Update to latest haskell.nix
Bug Fixes
PR Description
#1262 Docker image fixes
#1261 widen 'isMigrationError' to catch constraint errors
#1258 Buildkite nightly: Fix benchmark executable paths
#1255 Fix LOGGING test on Windows
#1254 Buildkite: Only run weeder if the stack build succeeds
#1248 Fix database error that occurs during wallet deletion.
(WB-31) Allow logs to be filtered by components
PR Description
#1253 remove logging-config
#1241 Allow switching on and off individual tracers via cli
(WB-46) Hardware Ledger Auxiliary Seed Generation
PR Description
#1247 add type-safe module to ...
Read more

Hardware wallets mnemonics restoration

09 Jan 16:00
v2020-01-07
d150ed6
Compare
Choose a tag to compare

Overview

Compatible with Jörmungandr@v0.8.5

Artifact Platform Description
cardano-wallet-jormungandr-linux64-v2020-01-07.tar.gz
Linux 64-bit
Linux executable with auto-completion script for bash shell.
cardano-wallet-jormungandr-macos64-v2020-01-07.tar.gz
MacOs 64-bit
MacOS executable with required system libraries.
cardano-wallet-jormungandr-win64-v2020-01-07.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 information
  • List available stake-pools, ordered by apparent performance
  • Generate testnet reward credentials from a given mnemonic sentence
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 information
  • Create Byron wallets
    • ![][new] Allow restoration and manipulation of Byron Ledger wallets mnemonic sentences
    • ![][new] Allow restoration and manipulation of Byron Trezor wallets mnemonic sentences
  • 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
  • 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
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

Known Limitations

Bug Fixes

  • Zero balance reported on the wallet despite receiving funds from faucet #1146
  • Migration failing on Windows due to stake-pools.sqlite lock #1224
  • Unhandled Data.Binary.Get error observed in node logs #1228

Known Issues

  • --logging-config FILE.YAML more info and tests #961
  • Failing tests integration tests on Windows #1115
  • Error in the log after deleting a wallet #1242
  • Missing database migration for active_slot_coeff #1251
  • Benchmarks are failing #1252

Installation Instructions

Linux 64-bit

  1. Install jormungandr@0.8.5 from the official repository.

  2. Download cardano-wallet-jormungandr-linux64-v2020-01-07.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-01-07/cardano-wallet-jormungandr-linux64-v2019-12-16.tar.gz | tar xz -C $HOME/.local/bin
  1. (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
  1. Start cardano-wallet --help and see available parameters.

Mac OS 64-bit

  1. Install jormungandr@0.8.5 from the official repository.

  2. Download cardano-wallet-jormungandr-macos64-v2020-01-07.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

  1. Install jormungandr@0.8.5 from the official repository.

  2. Download cardano-wallet-jormungandr-win64-v2020-01-07.zip 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

Changelog

Bug Fixes
PR Description
#1248 Fix database error that occurs during wallet deletion.
#1246 Revisions of the logic handling roll backs
#1231 Fix missing test data in windows testing bundle
#1229 Define and use safe 'eitherRunGet' to avoid throwing on binary decoding
#1226 Pool.DB.Sqlite: Close the database before attempting to wipe it
(WB-46) Hardware Ledger Auxiliary Seed Generation
PR Description
#1247 Add type-safe module to construct API links
#1239 Trezor mnemonics in genesis file + README update
#1236 API hardware wallet restoration
#1234 Support Hardware Ledger Auxiliary Seed Generation Method
Miscellaneous
PR Description
#1106 Update to latest haskell.nix
#1218 Fix cabal v2-build
#1219 Buildkite: fix weeder
#1225 Update Hercules-CI build file
#1227 Update manual tests and db migration manual scenario
#1249 bump version to 2020.1.7 and licenses copy...
Read more

Byron Yoroi Support

30 Dec 13:10
v2019-12-23
398565c
Compare
Choose a tag to compare

Overview

Compatible with Jörmungandr@v0.8.5

Artifact Platform Description
cardano-wallet-jormungandr-linux64-v2019-12-23.tar.gz
Linux 64-bit
Linux executable with auto-completion script for bash shell.
cardano-wallet-jormungandr-macos64-v2019-12-23.tar.gz
MacOs 64-bit
MacOS executable with required system libraries.
cardano-wallet-jormungandr-win64-v2019-12-23.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 information
  • List available stake-pools, ordered by apparent performance
  • Generate testnet reward credentials from a given mnemonic sentence
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 information
  • Create Byron wallets
    • ![][new] Allow restoration and manipulation of Byron Yoroi 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
  • 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
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

Known Limitations

Bug Fixes

  • Rollbacks issue in stake pool worker #1200
  • Misleading Mnemonic Sentence Error message #1153
  • Non-linear sync progress from not considering active_slot_coeff #1197
  • Possible missing db migration between balance-check version and latest one #1177

Known Issues

  • --logging-config FILE.YAML more info and tests #961
  • Failing tests integration tests on Windows #1115
  • Missing database migration for active_slot_coeff #1251
  • Unhandled Data.Binary.Get error observed in node logs #1228
  • Zero balance reported on the wallet despite receiving funds from faucet #1146

Installation Instructions

Linux 64-bit

  1. Install jormungandr@0.8.5 from the official repository.

  2. Download cardano-wallet-jormungandr-linux64-v2019-12-23.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/v2019-12-23/cardano-wallet-jormungandr-linux64-v2019-12-16.tar.gz | tar xz -C $HOME/.local/bin
  1. (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
  1. Start cardano-wallet --help and see available parameters.

Mac OS 64-bit

  1. Install jormungandr@0.8.5 from the official repository.

  2. Download cardano-wallet-jormungandr-macos64-v2019-12-23.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

  1. Install jormungandr@0.8.5 from the official repository.

  2. Download cardano-wallet-jormungandr-win64-v2019-12-23.zip 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

Changelog

Bug Fixes
PR Description
#1198 Take active_slot_coeff into account for sync progress calculation
#1201 Fix pool registration rollback
#1202 Fix flaky next epoch test
#1203 Gratuitous fixes in restoration worker (wrong log line + move pruning inside same tx)
#1205 Review and clean State Machine file
#1211 Split Servant API client code into Cardano.Wallet.Api.Client
#1212 Refine mnemonic error msg
(WB-18) API latency
PR Description
#1163 add utxo benchmarks
(WB-27) Support Byron Yoroi Wallets
PR Description
#1199 API layer house-keeping in preparation of byron Yoroi support
#1206 Make api handlers more polymorphic to reduce duplication
#1209 Add support for Icarus keys derived from 15-word mnemonic sentences
#1220 Use big pool gap for Icarus wallet first scan
#1222 Fix listing interleave of legacy wallets
Miscellaneous
PR Description
#1210 Upgrade Jörmungand...
Read more

Incentivized Testnet Initial Release

19 Dec 10:41
v2019-12-16
6feffaf
Compare
Choose a tag to compare

Overview

Compatible with Jörmungandr@v0.8.1

Artifact Platform Description
cardano-wallet-jormungandr-linux64-v2019-12-16.tar.gz
Linux 64-bit
Linux executable with auto-completion script for bash shell.
cardano-wallet-jormungandr-macos64-v2019-12-16.tar.gz
MacOs 64-bit
MacOS executable with required system libraries.
cardano-wallet-jormungandr-win64-v2019-12-16.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 information
  • List available stake-pools, ordered by apparent performance
  • Generate testnet reward credentials from a given mnemonic sentence
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 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
  • 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
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

Known Limitations

Bug Fixes

  • Fee estimation for payments doesn't take fee balancing after selection into account #1150
  • Wallet not deleted properly (corrupted seq.*.sqlite file -> StatementAlreadyFinalized "BEGIN" in the log) #1071
  • Wallet initialization using blockchain data fails with unique constraint failure and ErrPointAlreadyExists #1181
  • active_slot_coeff ignored in performance calculation. #1188

Known Issues

  • --logging-config FILE.YAML more info and tests #961
  • Failing tests integration tests on Windows #1115
  • Rollbacks issue in stake pool worker #1200
  • Misleading Mnemonic Sentence Error message #1153
  • Non-linear sync progress from not considering active_slot_coeff #1197
  • Possible missing db migration between balance-check version and latest one #1177
  • Missing database migration for active_slot_coeff #1251
  • Unhandled Data.Binary.Get error observed in node logs #1228
  • Zero balance reported on the wallet despite receiving funds from faucet #1146

Installation Instructions

Linux 64-bit

  1. Install jormungandr@0.8.1 from the official repository.

  2. Download cardano-wallet-jormungandr-linux64-v2019-12-16.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/v2019-12-16/cardano-wallet-jormungandr-linux64-v2019-12-16.tar.gz | tar xz -C $HOME/.local/bin
  1. (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
  1. Start cardano-wallet --help and see available parameters.

Mac OS 64-bit

  1. Install jormungandr@0.8.1 from the official repository.

  2. Download cardano-wallet-jormungandr-macos64-v2019-12-16.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

  1. Install jormungandr@0.8.1 from the official repository.

  2. Download cardano-wallet-jormungandr-win64-v2019-12-16.zip 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

Changelog

Miscellaneous
PR Description
#1195 pick another input when dangling fees are too big
#1193 re-use 'deleteWallet' function to avoid logic duplication
#1192 make sure to close and destroy the database before removing files from disk
#1191 compute payment fee as the difference between inputs/outputs
#1189 Account for "active slot coefficient" in apparent performance calculation
#1183 Missing negative integration tests for coin selection endpoint
#1182 Enable storage of duplicate owners in regist...
Read more

Off-Chain Metadata

13 Dec 17:24
v2019-12-13
f3576be
Compare
Choose a tag to compare

Overview

Compatible with Jörmungandr@v0.8.1

Artifact Platform Description
cardano-wallet-jormungandr-linux64-v2019-12-13.tar.gz
Linux 64-bit
Linux executable with auto-completion script for bash shell.
cardano-wallet-jormungandr-macos64-v2019-12-13.tar.gz
MacOs 64-bit
MacOS executable with required system libraries.
cardano-wallet-jormungandr-win64-v2019-12-13.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 information
  • List available stake-pools, ordered by apparent performance
  • Generate testnet reward credentials from a given mnemonic sentence
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 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
  • Delegate all funds from a wallet to a stake-pool
  • Fetch total reward balance earned from delegation
  • Stop delegating funds from a wallet
  • ![][new] Support stake pool off-chain metadata
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

Known Limitations

Bug Fixes

  • Apparent performance could be wrong for brief times #1158
  • Transactions with minimal amount leave too many fees #1144

Known Issues

  • --logging-config FILE.YAML more info and tests #961
  • Fee estimation for payments doesn't take fee balancing after selection into account #1150
  • Failing tests integration tests on Windows #1115
  • Wallet not deleted properly (corrupted seq.*.sqlite file -> StatementAlreadyFinalized "BEGIN" in the log) #1071

Installation Instructions

Linux 64-bit

  1. Install jormungandr@0.8.1 from the official repository.

  2. Download cardano-wallet-jormungandr-linux64-v2019-12-13.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/v2019-12-13/cardano-wallet-jormungandr-linux64-v2019-12-13.tar.gz | tar xz -C $HOME/.local/bin
  1. (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
  1. Start cardano-wallet --help and see available parameters.

Mac OS 64-bit

  1. Install jormungandr@0.8.1 from the official repository.

  2. Download cardano-wallet-jormungandr-macos64-v2019-12-13.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

  1. Install jormungandr@0.8.1 from the official repository.

  2. Download cardano-wallet-jormungandr-win64-v2019-12-13.zip 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

Changelog

Miscellaneous
PR Description
#1172 Bump versions to v2019-12-13
#1141 Jormungandr 0.8.0 rc8 -> 0.8.0
(WB-18) API latency
PR Description
#1148 Adding more interesting benchmarks
(WB-25) Collect stake pool metadata
PR Description
#1169 use another stake pool with metadata in STAKE_POOL_LIST_04
#1166 Cache the stake pool metadata registry
#1159 listStakePools - Include metadata in API responses
#1154 Update registration ownership info in monitorStakePools
#1131 Include registration certificates in Cardano.Pool.Metrics.Block
#1168 use pool production tip to compute performance
#1130 Add registered stake pool owners to database schema
(WB-32) Estimate cost of delegation
PR Description
#1170 STAKE_POOLS_ESTIMATE_FEE negative tests for 40x responses
#1156 Expect 200 for fee-estimation
(WB-33) Next epoch available when querying network information
PR Description
#1162 additional test for next epoch num
(WB-28) Hardware Wallet Support
PR Description
#1152 Create skeleton selectCoins endpoint.

Signatures

Name Role Approval
Matthias Benkort @KtorZ Technical Team Lead ✔️
Piotr Stach...
Read more

Delegation to Stake Pools

13 Dec 15:33
v2019-12-09
eedb9d4
Compare
Choose a tag to compare

Overview

Compatible with Jörmungandr@v0.8.0-rc8

Artifact Platform Description
cardano-wallet-jormungandr-linux64-v2019-12-09.tar.gz
Linux 64-bit
Linux executable with auto-completion script for bash shell.
cardano-wallet-jormungandr-macos64-v2019-12-09.tar.gz
MacOs 64-bit
MacOS executable with required system libraries.
cardano-wallet-jormungandr-win64-v2019-12-09.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 information
  • List available stake pools, ordered by apparent performance
  • ![][new] Generate testnet reward credentials from a given mnemonic sentence
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 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
  • ![][new] Delegate all funds from a wallet to a stake pool
  • ![][new] Fetch total reward balance earned from delegation
  • ![][new] Stop delegating funds from a wallet
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

Known Limitations

Bug Fixes

  • Byron addresses have derivation indexes that are not only hardened. #1041
  • Daedalus IPC working intermittently on windows #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 jormungandr@0.8.0-rc8 from the official repository.

  2. Download cardano-wallet-jormungandr@v2019-12-09.linux64.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/v2019-12-09/cardano-wallet-jormungandr@v2019-12-09.linux64.tar.gz | tar xz -C $HOME/.local/bin
  1. (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
  1. Start cardano-wallet --help and see available parameters.

Mac OS 64-bit

  1. Install jormungandr@0.8.0-rc8 from the official repository.

  2. Download cardano-wallet-jormungandr@v2019-12-09.macos64.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

  1. Install jormungandr@0.8.0-rc8 from the official repository.

  2. Download cardano-wallet-jormungandr@v2019-12-09.win64.zip 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

Changelog

null
PR Description
#1151 update compatibility matrix in README
#1149 bump versions to v2019.12.9
#1140 release pipeline revisions
#1137 Add an extra scenario to illustrate the delegation "latency"
#1128 neat-picks on README
#1052 Review Github templates and README
(WB-18) API latency
PR Description
#1148 Adding more interesting benchmarks
#1105 Measure latencies for two fixture wallets
(WB-25) Collect stake pool metadata
PR Description
#1100 use IOHK fork for 'zip' to disable system dependency on bzlib2
#1093 Binary decoder for stake pool registrations.
#1078 Stake pool registry format updates
#1070 Additional case for too short ticker in StakePoolMetadata
#1069 Fetch stake pool metadata
#1066 Add stake pool metadata to swagger.yaml
(WB-32) Estimate cost of delegation
PR Description
#1147 fix pool id swagger schema and are extra details in description of pool endpoints
#1145 Use fee estimator instead of hard-coded fee value for stake pools joining
#1116 Estimate fees for joining a stake pool
(WB-33) Next epoch available when querying network information
PR Description
#1122 Add nextEpoch field to ApiNetworkInformation type.
#1121 Simplify property tests for epoch{Ceiling,Floor}.
#1114 Add epochCeiling function to Primitive.Types.
#1095 Add ApiEpochInfo type.
(WB-34) Deal with bootstrapping of the `apparent_performance` for stake pools
PR Description
#1112 Order pools arbitrarily in the first epoch
#1110 Seeded Random Shuffle
Read more

Incentivized Testnet Phase 1: Balance Check - Hotfix

18 Nov 22:57
Compare
Choose a tag to compare

Overview

Compatible with Jörmungandr@v0.7.0

Artifact Platform Description
cardano-wallet-jormungandr@v2019-11-18.linux64.sha256
Linux 64-bit
Checksum for the Linux executable.
cardano-wallet-jormungandr@v2019-11-18.linux64.tar.gz
Linux 64-bit
Linux executable with auto-completion script for bash shell.
cardano-wallet-jormungandr@v2019-11-18.macos64.sha256
MacOs 64-bit
Checksum for the MacOS executable.
cardano-wallet-jormungandr@v2019-11-18.macos64.tar.gz
MacOs 64-bit
MacOS executable with necessary system libraries.
cardano-wallet-jormungandr@v2019-11-18.win64.sha256
Windows 64-bit
Checksum for Windows executable.
cardano-wallet-jormungandr@v2019-11-18.win64.zip
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

Bug Fixes

  • Byron addresses have derivation indexes that are not only hardened. #1041
  • Daedalus IPC working intermittently on windows #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 jormungandr@0.7.0 from the official repository.

  2. Download cardano-wallet-jormungandr@v2019-11-18.linux64.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/v2019-11-18/cardano-wallet-jormungandr@v2019-11-18.linux64.tar.gz | tar xz -C $HOME/.local/bin
  1. (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
  1. Start cardano-wallet --help and see available parameters.

Mac OS 64-bit

  1. Install jormungandr@0.7.0 from the official repository.

  2. Download cardano-wallet-jormungandr@v2019-11-18.macos64.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

  1. Install jormungandr@0.7.0 from the official repository.

  2. Download cardano-wallet-jormungandr@v2019-11-18.win64.zip 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

Changelog

Bug fixes
PR Description
#1044 Fix DaedalusIPC startup issue on Windows
#1042 use a special 'WholeDomain' index with range going from 0 to 2^32
Usability & Compatibility
PR Description
#1045 Bump version to 2019.11.18

Signatures

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

Incentivized Testnet Phase 1: Balance Check

18 Nov 14:11
v2019-11-14
b792178
Compare
Choose a tag to compare

Overview

Compatible with Jörmungandr@v0.7.0

Artifact Platform Description
cardano-wallet-jormungandr@v2019-11-14.linux64.sha256
Linux 64-bit
Checksum for the Linux executable.
cardano-wallet-jormungandr@v2019-11-14.linux64.tar.gz
Linux 64-bit
Linux executable with auto-completion script for bash shell.
cardano-wallet-jormungandr@v2019-11-14.macos64.sha256
MacOs 64-bit
Checksum for the MacOS executable.
cardano-wallet-jormungandr@v2019-11-14.macos64.tar.gz
MacOs 64-bit
MacOS executable with necessary system libraries.
cardano-wallet-jormungandr@v2019-11-14.win64.sha256
Windows 64-bit
Checksum for Windows executable.
cardano-wallet-jormungandr@v2019-11-14.win64.zip
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
      • ![][new] --sync-tolerance option for tweaking server tolerance regarding network syncing.
    • Launch wallet against Jörmungandr
      • ![][new] --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

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 jormungandr@0.7.0 from the official repository.

  2. Download cardano-wallet-jormungandr@v2019-11-14.linux64.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/v2019-11-14/cardano-wallet-jormungandr@v2019-11-14.linux64.tar.gz | tar xz -C $HOME/.local/bin
  1. (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
  1. Start cardano-wallet --help and see available parameters.

Mac OS 64-bit

  1. Install jormungandr@0.7.0 from the official repository.

  2. Download cardano-wallet-jormungandr@v2019-11-14.macos64.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

  1. Install jormungandr@0.7.0 from the official repository.

  2. Download cardano-wallet-jormungandr@v2019-11-14.win64.zip 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

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

Read more

Cardano Wallet Backend - Jörmungandr@0.7.0-rc7

08 Nov 17:03
v2019-11-07
b84678e
Compare
Choose a tag to compare

Overview

Program Platform Description
cardano-wallet-jormungandr.tar.gz
linux-x86_64
A CLI tool to start and interact with a wallet server using Jörmungandr as a chain producer. See Main Features below.
cardano-wallet-jormungandr.sha256
N/A
Checksum for the executable in cardano-wallet-jormungandr.tar.gz
cardano-wallet.sh
linux-x86_64
Auto-completion script for cardano-wallet (works for all flavours)

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
    • Launch wallet against Jörmungandr
    • 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

Bug Fixes

  • "Invalid Address first byte": error message could be more user-friendly #953

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

Please note that currently only Unix\Linux platform is supported.

with Jörmungandr@0.7.0-rc7

  1. Install jormungandr@0.7.0-rc7 from the source.

  2. Download cardano-wallet-jormungandr.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/v2019-11-07/cardano-wallet-jormungandr.tar.gz | tar xz -C $HOME/.local/bin
  1. (optional) Download and install bash/zsh auto-completion script:
$ curl -L https://github.com/input-output-hk/cardano-wallet/releases/download/v2019-11-07/cardano-wallet.sh > /etc/bash_completion.d/cardano-wallet.sh
$ source /etc/bash_completion.d/cardano-wallet.sh
  1. Start cardano-wallet --help and see available parameters.

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

Changelog

Forget Pending Transaction
PR Description
#978 Turn on disabled 'forget tx' integration tests for Byron
List Stake Pool
PR Description
#962 Stake pools join quit stub tests
Usability & Compatibility
PR Description
#988 Jormungandr 0.7.0-rc7
#983 Jörmungandr v0.7.0-rc4 → v0.7.0-rc5
#982 bump versions to 2019.11.7
#981 Make API Golden tests filenames compatible with Windows
#972 Move the Test.Hspec.Extra module to cardano-wallet-test-utils
#971 tests: Fix ServerSpec and SqliteSpec on windows
#965 Use whileM (not <$> isEmpty) for better binary error messages
Miscellaneous
PR Description
#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.
#977 Manual test for syncProgress
#973 Make large numbers more readable.

Signatures

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

Cardano Wallet Backend - Byron Wallets & Stake Pools

06 Nov 15:11
v2019-11-06
1988f22
Compare
Choose a tag to compare

Overview

Program Platform Description
cardano-wallet-jormungandr.tar.gz
linux-x86_64
A CLI tool to start and interact with a wallet server using Jörmungandr as a chain producer. See Main Features below.
cardano-wallet-jormungandr.sha256
N/A
Checksum for the executable in cardano-wallet-jormungandr.tar.gz
cardano-wallet.sh
linux-x86_64
Auto-completion script for cardano-wallet (works for all flavours)

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
    • Launch wallet against Jörmungandr
    • Get network information
    • ![][new] 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
    • ![][new] Forget pending transaction of Shelley wallets
    • ![][new] List transaction history of Byron wallets
    • ![][new] Forget pending transaction of a Byron wallet
    • ![][new] Migrate Byron wallets to Shelley wallets
    • ![][new] 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

Bug Fixes

  • Improper shutdown of iohk-monitoring switchboard #851
  • Error reported in the log after deleting a wallet #807
  • Providing -- --config node_config.yaml on launch makes wallet exit ugly #848
  • Pending txs when listed on the wallet have inserted_at field instead of pending_since #935
  • Test failures -> Cardano.Wallet.Primitive.Types.Ranges #917

Known Issues

  • "Invalid Address first byte": error message could be more user-friendly #953
  • 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

Please note that currently only Unix\Linux platform is supported.

with Jörmungandr@eb0b7bb1

  1. Install jormungandr@eb0b7bb1 from the source.

⚠️ This pre-release requires a very specific revision (eb0b7bb14af8e573a44bf38b0a683ba2d4579c7d) which is ahead of and incompatible with 0.7.0-rc4 ⚠️

  1. Download cardano-wallet-jormungandr.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/v2019-11-06/cardano-wallet-jormungandr.tar.gz | tar xz -C $HOME/.local/bin
  1. (optional) Download and install bash/zsh auto-completion script:
$ curl -L https://github.com/input-output-hk/cardano-wallet/releases/download/v2019-11-06/cardano-wallet.sh > /etc/bash_completion.d/cardano-wallet.sh
$ source /etc/bash_completion.d/cardano-wallet.sh
  1. Start cardano-wallet --help and see available parameters.

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

Changelog

Byron Wallet Support
PR   | Description
--   | --
#966 | More tests for byron wallets migration, in particular migrating from big wallets
#960 | Test that `migrateByronWallet` appropriately deposits funds into a target wallet.
#952 | review golden tests for legacy transaction and generate witnesses using jcli
#950 | Test that `migrateByronWallet` migrates funds correctly.
#916 | Byron migration integration tests
#915 | Remove length invariant from `Cardano.Wallet.Jormungandr.Binary.putAddress`.
#911 | Fix Arithmetic Underflow in Migration Coin Selection
#890 | Add `deleteByronTransaction` endpoint.
#884 | More integration tests for Byron wallets
#882 | Add handlers for Byron migration
#878 | Support for legacy UTxO witness in Jörmungandr
#873 | Byron wallet transaction list integration tests
#871 | Special coin selection function for handling migration of legacy wallets
#849 | Enable faucet random wallets
#844 | Add and 'implement' "listByronTransactions" to the API
Create Delegation Certificate
PR   | Description
--   | --
#954 | Make `core.Tx` a concrete type and remove `DefineTx` and `PersistTx`
#946 | extend FeePolicy definition
#932 | Extend binary format for stake delegation tx
#920 | Api types for delegation endpoints
#907 | Fix `FromText` instance for `Double` (and `FeePolicy`).
#889 | Correct `ToText` and `FromText` instances for `FeePolicy`.
#634 | Remove cardano-wallet-http-bridge
Forget Pending Transaction
PR   | Description
--   | --
#939 | few more forget tx tests for CLI
#930 | Forget pending tx endpoint spec update
#912 | more '...
Read more