Off-Chain Metadata
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
⚠️ Only Jörmungandr Genesis/Praos node is supported.
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
-
Install jormungandr@0.8.1 from the official repository.
-
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
- (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.1 from the official repository.
-
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
-
Install jormungandr@0.8.1 from the official repository.
-
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 | ✔️ |