Official docs: https://docs.namada.net/users/transparent-accounts
Faucet: https://faucet.heliax.click/
Wallet operations
create a new keypair:
namadaw gen --alias $WALLET
restore existing wallet:
namada wallet derive --alias $WALLET --hd-path default
find your wallet address:
namadaw find --alias $WALLET
add some tokens using faucet:
https://faucet.heliax.click/
check balance:
namadac balance --owner $WALLET
check all known keys and addresses in the wallet:
send payment from one address to another:
namadac transfer --source $WALLET --target ${WALLET}1 --token NAAN --amount 1 --signing-keys $WALLET --memo $MEMO
remove keys:
namadaw remove --alias $WALLET --do-it
Staking
If you find this guide helpful, you can stake to our validator.
We would really appreciate it! 🚀
add a variable with the validator address:
VAL_ADDRESS="tnam1q8vhe85yc5ttt7mveds58gyqzavfwnn9eqhfxpgc" # address of validator you want to stake to
export the variable:
echo "export VAL_ADDRESS="$VAL_ADDRESS"" >> $HOME/.bash_profile \
source $HOME/.bash_profile
delegate tokens:
namadac bond --source $WALLET --validator $VAL_ADDRESS --amount 500 --node tcp://namada-testnet-tcprpc.itrocket.net:33657 --memo $MEMO
check your user bonds:
namadac bonds --owner $WALLET --node tcp://namada-testnet-tcprpc.itrocket.net:33657
check all bonded nodes:
namadac bonded-stake --node tcp://namada-testnet-tcprpc.itrocket.net:33657
add stake:
namadac bond --source $WALLET --validator $VAL_ADDRESS --amount 500 --node tcp://namada-testnet-tcprpc.itrocket.net:33657 --memo $MEMO
unbond the tokens:
namadac unbond --source $WALLET --validator $VAL_ADDRESS --amount 15 --node tcp://namada-testnet-tcprpc.itrocket.net:33657 --memo $MEMO
wait for 6 epochs, then check when the unbonded tokens can be withdrawed:
namadac bonds --owner $WALLET --node tcp://namada-testnet-tcprpc.itrocket.net:33657
withdraw unbonded tokens:
namadac withdraw --source $WALLET --validator $VAL_ADDRESS --node tcp://namada-testnet-tcprpc.itrocket.net:33657 --memo $MEMO
redelegate:
namadac redelegate --owner $WALLET --source-validator $VAL_ADDRESS --destination-validator <destination-validator-address> --amount 10 --node tcp://namada-testnet-tcprpc.itrocket.net:33657 --memo $MEMO
claim rewards:
namadac claim-rewards --source $WALLET --validator $VAL_ADDRESS --node tcp://namada-testnet-tcprpc.itrocket.net:33657 --memo $MEMO
query the pending reward tokens without claiming:
namadac rewards --source $WALLET --validator $VAL_ADDRESS --node tcp://namada-testnet-tcprpc.itrocket.net:33657
Multisign
generate key_1:
namadaw gen --alias $WALLET
generate key_2 and etc:
namadaw gen --alias ${WALLET}1
chech your public key:
namadaw find --alias $WALLET | awk '/Public key:/ {print $3}'
init non-multisig account (single signer):
namadac init-account --alias ${WALLET}-multisig --public-keys $WALLET --signing-keys $WALLET --memo $MEMO
init multisig account (at least 2 signers):
namadac init-account --alias ${WALLET}1-multisig --public-keys $WALLET,${WALLET}1 --signing-keys $WALLET,${WALLET}1 --threshold 2 --memo $MEMO
create a folder for a transaction:
create transaction:
namadac transfer --source ${WALLET}1-multisig --target ${WALLET}1 --token NAAN --amount 10 --signing-keys $WALLET,${WALLET}1 --dump-tx --output-folder-path tx_dumps --memo $MEMO
sign the transaction:
namadac sign-tx --tx-path "<path-to-.tx-file>" --signing-keys $WALLET,${WALLET}1 --owner ${WALLET}1-multisig --memo $MEMO
save as a variable offline_signature 1:
export SIGNATURE_ONE="<signature-file-name>"
save as a variable offline_signature 2:
export SIGNATURE_TWO="<signature-2-file-name>"
submit transaction:
namadac tx --tx-path "<path-to-.tx-file>" --signatures $SIGNATURE_ONE,$SIGNATURE_TWO --owner ${WALLET}1-multisig --gas-payer $WALLET --memo $MEMO
changing the multisig threshold:
namadac update-account --address ${WALLET}1-multisig --threshold 1 --signing-keys $WALLET,${WALLET}1 --memo $MEMO
check that the threshold has been updated correctly by running:
namadac query-account --owner ${WALLET}1-multisig
changing the public keys of a multisig account:
namadac update-account --address ${WALLET}1-multisig --public-keys ${WALLET}2,${WALLET}3,${WALLET}4 --signing-keys $WALLET,${WALLET}1 --memo $MEMO
initialize an established account:
namadac init-account --alias ${WALLET}1-multisig --public-keys ${WALLET}2,${WALLET}3,${WALLET}4 --signing-keys $WALLET,${WALLET}1 --threshold 1 --memo $MEMO
MASP
randomly generate a new spending key:
namadaw gen --shielded --alias ${WALLET}-shielded
create a new payment address:
namadaw gen-payment-addr --key ${WALLET}-shielded --alias ${WALLET}-shielded-addr
send a shielding transfer:
namadac transfer --source $WALLET --target ${WALLET}-shielded-addr --token NAAN --amount 10 --memo $MEMO
view balance:
namadac balance --owner ${WALLET}-shielded
generate another spending key:
namadaw gen --shielded --alias ${WALLET}1-shielded
create a payment address:
namadaw gen-payment-addr --key ${WALLET}1-shielded --alias ${WALLET}1-shielded-addr
shielded transfers (once the user has a shielded balance, it can be transferred to another shielded address):
namadac transfer --source ${WALLET}-shielded --target ${WALLET}1-shielded-addr --token NAAN --amount 4 --signing-keys <your-implicit-account-alias> --memo $MEMO
unshielding transfers (from a shielded to a transparent account):
namadac transfer --source ${WALLET}-shielded --target $WALLET --token NAAN --amount 4 --signing-keys <your-implicit-account-alias> --memo $MEMO
Validator operations
check sync status and node info:
curl http://127.0.0.1:26657/status | jq
check balance:
namadac balance --owner $ALIAS
check keys:
find your validator address:
namadac find-validator --tm-address=$(curl -s localhost:26657/status | jq -r .result.validator_info.address) --node localhost:26657
stake funds:
namadac bond --source $WALLET --validator $VALIDATOR_ADDRESS --amount 10 --memo $MEMO
self-bonding:
namadac bond --validator $VALIDATOR_ADDRESS --amount 10 --memo $MEMO
check your validator bond status:
namadac bonds --validator $VALIDATOR_ADDRESS
check your user bonds:
namadac bonds --owner $WALLET
check all bonded nodes:
find all the slashes:
non-self unbonding (validator alias can be used instead of address):
namadac unbond --source $WALLET --validator $VALIDATOR_ADDRESS --amount 1.5 --memo $MEMO
self-unbonding:
namadac unbond --validator $VALIDATOR_ADDRESS --amount 1.5 --memo $MEMO
withdrawing unbonded tokens (available 6 epochs after unbonding):
namadac withdraw --source $WALLET --validator $VALIDATOR_ADDRESS --memo $MEMO
find your validator status:
namadac validator-state --validator $VALIDATOR_ADDRESS
check epoch:
unjail, you need to wait 2 epochs:
namada client unjail-validator --validator $VALIDATOR_ADDRESS --node http://127.0.0.1:26657 --memo $MEMO
deactivate validator:
namadac deactivate-validator --validator $VALIDATOR_ADDRESS --memo $MEMO
reactivate validator:
namadac reactivate-validator --validator $VALIDATOR_ADDRESS --memo $MEMO
Change consensus key:
namadac change-consensus-key --validator $VALIDATOR_ADDRESS --memo $MEMO --signing-keys $WALLET --node http://127.0.0.1:26657
Generate priv_validator_key:
namadaw convert --alias <consensus_key_name>
change validator commission rate:
namadac change-commission-rate --validator $VALIDATOR_ADDRESS --commission-rate <commission-rate> --memo $MEMO
change validator metadata:
namadac change-metadata --validator $VALIDATOR_ADDRESS --memo $MEMO
Governance
all proposals list:
namadac query-proposal
edit proposal:
namadac query-proposal --proposal-id <PROPOSAL_ID>
save wallet address:
WALLET_ADDRESS=$(namadaw find --alias $WALLET | grep "Implicit" | awk '{print $3}')
import the variable into system:
echo "export WALLET_ADDRESS="$WALLET_ADDRESS"" >> $HOME/.bash_profile
source $HOME/.bash_profile
vote:
namadac vote-proposal --proposal-id <proposal-id> --vote yay --address $WALLET_ADDRESS --signing-keys $WALLET --memo $MEMO
Sync and Consensus
check logs:
sudo journalctl -u namadad -f
check sync status and node info:
curl http://127.0.0.1:26657/status | jq
check consensus state:
curl -s localhost:26657/consensus_state | jq .result.round_state.height_vote_set[0].prevotes_bit_array
full consensus state:
curl -s localhost:12657/dump_consensus_state
your validator votes (prevote):
curl -s http://localhost:26657/dump_consensus_state | jq '.result.round_state.votes[0].prevotes' | grep $(curl -s ht
