This guide is for those interested in getting Namada up and running as quickly as possible. It will guide you through installing Namada, joining a testnet network, running a node, and grabbing some tokens.
See the installation guide for details on installing the Namada binaries. Commands in this guide will assume you have the Namada binaries (
namadac) on your
If the binaries are stored somewhere, but are not on your path (perhaps you downloaded the binaries), you can add the binaries to your $PATH with:
If you build from source, and run
make install, the binaries will be installed to your
$PATH by default.
See the networks page for details on how to join a network. The rest of this guide will assume you have joined a network using the
namadac utils join-network --chain-id <some-chain-id> command.
We recommend this step with tmux (opens in a new tab), which allows the node to keep running without needing the terminal to be open indefinitely. If not, skip to the subsequent step.
tmux # inside the tmux/or not namadan ledger run # can detach the tmux (Ctrl-B then D)
For a more verbose output, one can run
NAMADA_LOG=info CMT_LOG_LEVEL=p2p:none,pex:error NAMADA_CMT_STDOUT=true namada ledger
This should sync your node to the ledger and will take a while (depending on your machine's hardware as well as the time between genesis and the start of sync). Subsequent commands (generating an account, etc.) are unlikely to work until your node is fully synced. Enquire the current block height with other participants to make sure you are synced in order to proceed.
First you will need an implicit account in order to receive tokens. You can generate one with:
namadaw address gen --alias <your-go-to-alias>
For the remainder of this introduction, let's assume your go-to alias is
This will generate a new account and store it in the default keychain. You can see the account with:
namadaw address list
The "faucet" is a native established account on Namada that is willing to give a maximum of 1000 tokens to any user at request. Let's transfer ourselves
1000 NAM from the faucet with the same alias using:
namadac transfer \ --source faucet \ --target stanley \ --token NAM \ --amount 1000 \ --signing-keys stanley
To query the balance of
namadac balance \ --owner stanley