Skip to content

Per-component logging

Compare
Choose a tag to compare
@WilliamKingNoel-Bot WilliamKingNoel-Bot released this 18 Jan 17:09
v2020-01-14
17edc2a

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
  • 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 construct API links

Signatures

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