Installing cardano-wallet
Overview
In this guide, we will show you how to compile and install cardano-wallet into your operating system of choice, directly from the source-code. This component provides a CLI (Command Line Interface) and Web API for creating multiple Cardano wallets, sending transactions, getting transaction history details, wallet balances and more!
note
If you want to avoid compiling the binaries yourself, You can download the latest pre-built binaries of cardano-wallet from the links below.
This guide assumes you have installed cardano-node and cardano-cli into your system. If not you can refer to Installing cardano-node guide for instructions on how to do that.
important
You must connect your cardano-node to the testnet network and make sure it is fully synchronized. If you are not sure how to do that, It is recommended to read Running cardano-node guide before proceeding.
Choose your Platform
MacOS / Linux
In this section, we will walk you through the process of downloading, compiling and installing cardano-wallet into your Linux / MacOS based operating system.
Downloading & Compiling
We need to install stack, if we don't have it:
curl -sSL https://get.haskellstack.org/ | sh
Check the version that has been installed:
stack --version
You should see something like this:
Version 2.7.3, Git revision 7927a3aec32e2b2e5e4fb5be76d0d50eddcc197f x86_64 hpack-0.34.4
If you have followed the Installing cardano-node guide, You should have the $HOME/cardano-src directory. If not, let's create a working directory to store the source-code and build for cardano-wallet.
mkdir -p $HOME/cardano-src
cd $HOME/cardano-src
Next we download the cardano-wallet source-code:
git clone https://github.com/input-output-hk/cardano-wallet.git
cd ./cardano-wallet/
Switch the repository to the latest tagged commit:
TAG=$(git describe --tags --abbrev=0) && echo latest tag $TAG
git checkout $TAG
important
You can check the latest available version / tag by visiting the cardano-wallet Github Release page. At the time of writing this, the current version is v2021-11-11. You can list all tags also with git tag -l command.
Building and installing the node
We can now build cardano-wallet code to produce executable binaries.
stack build --test --no-run-tests
Install the newly built cardano-wallet binary to the $HOME/.local/bin directory:
stack install
Check the version that has been installed:
cardano-wallet version
You should see something like this:
v2021-11-11 (git revision: dac16ba7e3bf64bf5474497656932fd342c3b720)
Congratulations, you have successfully installed cardano-wallet into your Linux/MacOS system! 🎉🎉🎉
Windows
important
Currently, the Windows installation guide is still in-progress. In the meantime we recommend using WSL (Windows Subsystem for Linux) to get a Linux environment on-top of Windows. Once you have that installed you can use the Linux guide to install and run cardano-node within WSL.