Skip to main content

Archwayd CLI

The full scope of archwayd commands can be viewed using command archwayd --help:

archwayd --help
# Outputs:
Archway Daemon (server)

archwayd [command]

Available Commands:
add-genesis-account Add a genesis account to genesis.json
add-wasm-genesis-message Wasm genesis subcommands
collect-gentxs Collect genesis txs and output a genesis.json file
config Create or query an application CLI configuration file
debug Tool for helping with debugging your application
export Export state to JSON
gentx Generate a genesis tx carrying a self delegation
help Help about any command
init Initialize private validator, p2p, genesis, and application configuration files
keys Manage your application's keys
query Querying subcommands
start Run the full node
status Query remote node for status
tendermint Tendermint subcommands
tx Transactions subcommands
unsafe-reset-all Resets the blockchain database, removes address book files, and resets data/priv_validator_state.json to the genesis state
validate-genesis validates the genesis file at the default location or at the location passed as an arg
version Print the application binary version information

-h, --help help for archwayd
--home string directory for config and data (default "/home/user/.archway")
--log_format string The logging format (json|plain) (default "plain")
--log_level string The logging level (trace|debug|info|warn|error|fatal|panic) (default "info")
--trace print out full stack trace on errors

Use "archwayd [command] --help" for more information about a command.

Archwayd for Developers

If you require functionality not available in the Developer CLI, you may need to rely on archwayd to complete your task. Below are some examples of common queries and commands that can help guide you.

Query account balance

For querying an account balance, use the bank module.


archwayd query bank balances ${ACCOUNT_ADDRESS} --node ""

Replace ${ACCOUNT_ADDRESS} with your own value.

Deploy a contract

Transactions use the tx module. Ideally, deployments will include 3 transactions: 1) Storing the wasm on-chain, 2) Instantiating the stored wasm, and 3) Setting the contract metadata.

Upload and store the wasm on-chain:

archwayd tx wasm store path_to_wasm/my_wasm_file.wasm --gas auto --gas-prices 0.05uconst --gas-adjustment 1.4 --from ${WALLET_LABEL} --chain-id "constantine-1" --node "" --broadcast-mode sync --output json -y

Replace ${WALLET_LABEL} with your own value

The response from storing wasm will give you the Code ID required for instantiating the contract.

Then instantiate it:

archwayd tx wasm instantiate ${CODE_ID} '{"entrypoint":"value"}' --from ${WALLET_LABEL} --label "A human readable label for this deployment" --gas auto --gas-prices 0.05uconst --gas-adjustment 1.4 --chain-id "constantine-1" --node "" --broadcast-mode sync --output json -y

Replace ${CODE_ID}, '{"entrypoint":"value"}', ${WALLET_LABEL} and "A human readable label for this deployment with your own values.

The response from instantiating the contract will give you the Contract Address required for setting metadata on the contract instance.

Setting metadata on the contract instance:

archwayd tx gastracker set-contract-metadata ${CONTRACT_ADDRESS} '{ "developer_address": ${ADMINISTRATOR_ADDRESS}, "reward_address": ${ADDRESS_TO_RECEIVE_REWARDS}, "collect_premium": false, "premium_percentage_charged": 0, "gas_rebate_to_user": false }' --gas auto --gas-prices 0.05uconst --gas-adjustment 1.4 --from ${WALLET_LABEL} --chain-id "constantine-1" --node "" --broadcast-mode sync --output json -y

Replace ${CONTRACT_ADDRESS}, ${WALLET_LABEL}, and ${ADMINISTRATOR_ADDRESS}, ${ADDRESS_TO_RECEIVE_REWARDS} and the other JSON values with your own values.

Transaction filtering

Searching transactions with custom filters is a powerful feature, to do this we use the tx module with the --events filter. See below for common filtered queries that are helpful.

View all transactions to a specific contract:

Use filter key wasm._contract_address


archwayd query txs --events 'wasm._contract_address=${CONTRACT_ADDRESS}' --node ""

Replace ${CONTRACT_ADDRESS} with your own value.

View all contracts deployed by a specific developer:

User filter keys message.sender and message.action


archwayd query txs --events 'message.sender=${DEVELOPER_WALLET_ADDRESS}&message.action=/cosmwasm.wasm.v1.MsgInstantiateContract' --node ""

Replace ${DEVELOPER_WALLET_ADDRESS} with your own value.

Code IDs and contract metadata:

Contract data and metadata queries use the wasm query module.

Find the Code ID of a specific contract:

archwayd query wasm contract ${CONTRACT_ADDRESS} --node ""

Replace ${CONTRACT_ADDRESS} with your own value.

Check if a contract's code was ever updated:

archwayd query wasm contract-history ${CONTRACT_ADDRESS} --node""

Replace ${CONTRACT_ADDRESS} with your own value.

Find the contract address of a specific Code ID:

archwayd query wasm list-contract-by-code ${CODE_ID} --node ""

Replace ${CODE_ID} with your own value.