Skip to content

Off-Chain Metadata

Compare
Choose a tag to compare
@WilliamKingNoel-Bot WilliamKingNoel-Bot released this 13 Dec 17:24
v2019-12-13
f3576be

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
  • 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 Stachyra @piotr-iohk QA Engineer ✔️
Tatyana Valkevych @tatyanavych Release Manager ✔️