Using Remote CLI

To interact with the Verana blockchain remotely, you can use the CLI (veranad) to query data and send transactions to networks like vna-testnet-1 or vna-mainnet-1.

Pre-Requisites

Prerequisite: Ensure the veranad binary is installed and up-to-date.
See Install or Update Veranad Binary.

Tip: If you have not created an account yet, see Create and Fund an Account.

Environment variables to use with the documentation examples:

Local environment (isolated node from setup_primary_validator.sh)

FAUCET_ACC="cooluser"
FAUCET_ACC_LIT=verana16mzeyu9l6kua2cdg9x0jk5g6e7h0kk8q6uadu4
CHAIN_ID="vna-testnet-1"
NODE_RPC=http://localhost:26657

betanet environment (ephemeral; may be offline)

FAUCET_ACC="faucet"
FAUCET_ACC_LIT=verana167vrykn5vhp8v9rng69xf0jzvqa3v79etmr0t2
CHAIN_ID="vna-betanet-1"
NODE_RPC=https://rpc.vna-betanet-1.devnet.verana.network

Branch-based ephemeral environment (K8s)

# Namespace defaults to vna-devnet-<branch> with slashes replaced by hyphens
# Example branch: feature/foo -> vna-devnet-feature-foo
CHAIN_ID="vna-devnet-feature-foo"
NODE_RPC="https://rpc.${CHAIN_ID}.devnet.verana.network"

devnet environment

FAUCET_ACC="faucet"
FAUCET_ACC_LIT=verana167vrykn5vhp8v9rng69xf0jzvqa3v79etmr0t2
CHAIN_ID="vna-devnet-1"
NODE_RPC=http://node1.devnet.verana.network:26657

Testnet environment

FAUCET_ACC="faucet"
FAUCET_ACC_LIT=verana167vrykn5vhp8v9rng69xf0jzvqa3v79etmr0t2
CHAIN_ID="vna-testnet-1"
NODE_RPC=https://rpc.testnet.verana.network

Example Commands

Query Balances on vna-testnet-1

veranad q bank balances $FAUCET_ACC_LIT \
  --node $NODE_RPC

Send Tokens to Another Address

veranad tx bank send <from-wallet> <to-wallet> 100000uvna \
  --chain-id $CHAIN_ID --node $NODE_RPC \
  --gas auto --fees 600000uvna

Query the Ecosystem module (ec, which replaces the former Trust Registry module):

veranad q ec list-ecosystems --node $NODE_RPC

Query a single ecosystem by id:

veranad q ec get-ecosystem 1 --node $NODE_RPC

Creating ecosystems, participants, and credential schemas is done on behalf of a Corporation. See the module reference for the full transaction flow.

Query Blocks

veranad q block 100 --type=height \
  --node $NODE_RPC

Transfers & Fees

Typical Verana testnet transfer (uvna) with explicit fees:

FROM="alice"
TO="verana1..."
AMOUNT="100000uvna"

veranad tx bank send "$FROM" "$TO" "$AMOUNT" \
  --chain-id "$CHAIN_ID" \
  --node "$NODE_RPC" \
  --gas auto \
  --fees 600000uvna \
  --keyring-backend test \
  --yes

Check balance:

veranad q bank balances "$TO" --node "$NODE_RPC" -o json | jq

Refer to the Environments section for details on RPC endpoints for other networks.