wasm

The `wasm` module allows you to manage CosmWasm smart contract.

Query:

Name	Description
build-address	Build contract address
code	Downloads wasm bytecode for given code id
code-info	Prints out metadata of a code id
contract	Prints out metadata of a contract given its address
contract-history	Prints out the code history for a contract given its address
contract-state	Querying commands for the wasm module
libwasmvm-version	Get libwasmvm version
list-code	List all wasm bytecode on the chain
list-contract-by-code	List wasm all bytecode on the chain for given code id
list-contracts-by-creator	List all contracts by creator
params	Query the current wasm parameters
pinned	List all pinned code ids

Tx:

Name	Description
clear-contract-admin	Clears admin for a contract to prevent further migrations
execute	Execute a command on a wasm contract
grant	Grant authorization to an address
instantiate	Instantiate a wasm contract
instantiate2	Instantiate a wasm contract with predictable address
migrate	Migrate a wasm contract to a new code version
set-contract-admin	Set new admin for a contract
store	Upload a wasm binary
update-instantiate-config	Update instantiate config for a codeID

Common flags in wasm query

Common flags for the wasm query command are summarized.

Flags:

Name, shorthand	Type	Required	Default	Description
--grpc-addr	string			the gRPC endpoint to use for this chain
--grpc-insecure				allow gRPC over insecure channels, if not TLS the server must use TLS
--height	int			Use a specific height to query state at (this can error if the node is pruning state)
-h, --help				Help for <module name>
--node	string		tcp://localhost:26657	<host>:<port> to Tendermint RPC interface for this chain
-o, --output	string		text	Output format (text | json)

Global Flags:

Name, shorthand	Type	Required	Default	Description
--chain-id	string			The network chain ID
--home	string		$HOME/.ununifi	directory for config and data
--log_format	string			The logging format (json | plain) (default "plain")
--log_level	string		info	The logging level (trace | debug | info | warn | error | fatal | panic)
--trace				print out full stack trace on errors

Encode Flags

Flags:

Name, shorthand	Type	Required	Default	Description
--ascii				ascii encoded salt
--b64				base64 encoded salt
--hex				hex encoded salt

Pagination Flags

Flags:

Name, shorthand	Type	Required	Default	Description
--count-total				a count total number of records in contract history to query for
--limit	uint			pagination limit of contract history to query for (default 100)
--offset	uint			pagination offset of contract history to query for
--page	uint			pagination page of contract history to query for. This sets offset to a multiple of limit (default 1)
--page-key	string			pagination page-key of contract history to query for
--reverse				results are sorted in descending order

Query

ununifid query wasm build-address

Build contract address

ununifid query wasm build-address [code-hash] [creator-address] [salt-hex-encoded] [json_encoded_init_args (required when set as fixed)] [flags]

Flags:

Please refer to Common flags & Encode flags for details of flags.

ununifid query wasm code

Downloads wasm bytecode for given code id

ununifid query wasm code [code_id] [output filename] [flags]

Flags:

Please refer to Common flags for details of flags.

ununifid query wasm code-info

Prints out metadata of a code id

ununifid query wasm code-info [code_id] [flags]

Flags:

Please refer to Common flags for details of flags.

ununifid query wasm contract

Prints out metadata of a contract given its address

ununifid query wasm contract [bech32_address] [flags]

Flags:

Please refer to Common flags for details of flags.

ununifid query wasm contract-history

Prints out the code history for a contract given its address

ununifid query wasm contract-history [bech32_address] [flags]

Flags:

Please refer to Common flags & Pagination flags for details of flags.

ununifid query wasm contract-state

Querying commands for the wasm module

ununifid query wasm contract-state [flags]
ununifid query wasm contract-state [command]

Command:

Name, shorthand	Type	Required	Default	Description
all				Prints out all internal state of a contract given its address
raw				Prints out internal state for key of a contract given its address
smart				Calls contract with given address with query data and prints the returned result

ununifid query wasm contract-state all [bech32_address] [flags]

Flags:

Please refer to Common flags & Pagination flags for details of flags.

ununifid query wasm contract-state raw [bech32_address] [key] [flags]
ununifid query wasm contract-state smart [bech32_address] [query] [flags]

Flags:

Please refer to Common flags & Encode flags for details of flags.

ununifid query wasm libwasmvm-version

Get libwasmvm version

ununifid query wasm libwasmvm-version [flags]

Flags:

Please refer to Common flags for details of flags.

ununifid query wasm list-code

List all wasm bytecode on the chain

ununifid query wasm list-code [flags]

Flags:

Please refer to Common flags & Pagination flags for details of flags.

ununifid query wasm list-contract-by-code

List wasm all bytecode on the chain for given code id

ununifid query wasm list-contract-by-code [code_id] [flags]

Flags:

Please refer to Common flags & Pagination flags for details of flags.

ununifid query wasm list-contracts-by-creator

List all contracts by creator

ununifid query wasm list-contracts-by-creator [creator] [flags]

Flags:

Please refer to Common flags & Pagination flags for details of flags.

ununifid query wasm params

Query the current wasm parameters

ununifid query wasm params [flags]

Flags:

Please refer to Common flags for details of flags.

ununifid query wasm pinned

List all pinned code ids

ununifid query wasm pinned [flags]

Flags:

Please refer to Common flags & Pagination flags for details of flags.

Common flags in nftmint tx

Common flags for the nftmint tx command are summarized.

Flags:

Name, shorthand	Type	Required	Default	Description
-a, --account-number	uint			The account number of the signing account (offline mode only)
--aux				Generate aux signer data instead of sending a tx
-b, --broadcast-mode	string		sync	Transaction broadcasting mode (sync | async | block)
--dry-run				ignore the --gas flag and perform a simulation of a transaction, but don't broadcast it (when enabled, the local Keybase is not accessible)
--fee-granter	string			Fee granter grants fees for the transaction
--fee-payer	string			Fee payer pays fees for the transaction instead of deducting from the signer
--fees	string			Fees to pay along with transaction; eg: 10uatom
--from	string			Name or address of private key with which to sign
--gas	string		200000	gas limit to set per-transaction; set to "auto" to calculate sufficient gas automatically
--gas-adjustment	float		1	adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored
--gas-prices	string			Gas prices in decimal format to determine the transaction fee (e.g. 0.1uatom)
--generate-only				Build an unsigned transaction and write it to STDOUT (when enabled, the local Keybase only accessed when providing a key name)
-h, --help				help for <module name>
--keyring-backend	string		test	Select keyring's backend (os | file | kwallet | pass | test | memory)
--keyring-dir	string			The client Keyring directory; if omitted, the default 'home' directory will be used
--ledger				Use a connected Ledger device
--node	string		tcp://localhost:26657	<host>:<port> to tendermint rpc interface for this chain
--note	string			Note to add a description to the transaction (previously --memo)
--offline				Offline mode (does not allow any online functionality)
-o, --output	string		json	Output format (text | json)
-s, --sequence	uint			The sequence number of the signing account (offline mode only)
--sign-mode	string			Choose sign mode (direct | amino-json | direct-aux), this is an advanced feature
--timeout-height	uint			Set a block timeout height to prevent the tx from being committed past a certain height
--tip	string			Tip is the amount that is going to be transferred to the fee payer on the target chain. This flag is only valid when used with --aux, and is ignored if the target chain didn't enable the TipDecorator
-y, --yes				Skip tx broadcasting prompt confirmation

Global Flags:

Name, shorthand	Type	Required	Default	Description
--chain-id	string			The network chain ID
--home	string		$HOME/.ununifi	directory for config and data
--log_format	string			The logging format (json | plain) (default "plain")
--log_level	string		info	The logging level (trace | debug | info | warn | error | fatal | panic)
--trace				print out full stack trace on errors

Tx

ununifid tx wasm clear-contract-admin

Clears admin for a contract to prevent further migrations

ununifid tx wasm clear-contract-admin [contract_addr_bech32] [flags]```

Flags:

Please refer to Common flags in cosmwasm tx for details of flags.

ununifid tx wasm execute

Execute a command on a wasm contract

ununifid tx wasm execute [contract_addr_bech32] [json_encoded_send_args] --amount [coins,optional] [flags]

Flags:

Please refer to Common flags in cosmwasm tx for details of flags.

ununifid tx wasm grant

Grant authorization to an address

ununifid tx wasm grant [grantee] [message_type="execution"|"migration"] [contract_addr_bech32] --allow-raw-msgs [msg1,msg2,...] --allow-msg-keys [key1,key2,...] --allow-all-messages [flags]

Example:

$ ununifid tx grant <grantee_addr> execution <contract_addr> --allow-all-messages --max-calls 1 --no-token-transfer --expiration 1667979596

$ ununifid tx grant <grantee_addr> execution <contract_addr> --allow-all-messages --max-funds 100000uwasm --expiration 1667979596

$ ununifid tx grant <grantee_addr> execution <contract_addr> --allow-all-messages --max-calls 5 --max-funds 100000uwasm --expiration 1667979596

Flags:

Please refer to Common flags in cosmwasm tx for details of flags.

ununifid tx wasm instantiate

Creates a new instance of an uploaded wasm code with the given 'constructor' message. Each contract instance has a unique address assigned.

ununifid tx wasm instantiate [code_id_int64] [json_encoded_init_args] --label [text] --admin [address,optional] --amount [coins,optional]  [flags]

Example:

$ ununifid tx wasm instantiate 1 '{"foo":"bar"}' --admin="$(ununifid keys show mykey -a)" \
  --from mykey --amount="100ustake" --label "local0.1.0"

Flags:

Please refer to Common flags in cosmwasm tx for details of flags.

ununifid tx wasm instantiate2

Creates a new instance of an uploaded wasm code with the given 'constructor' message. Each contract instance has a unique address assigned. They are assigned automatically but in order to have predictable addresses for special use cases, the given 'salt' argument and '--fix-msg' parameters can be used to generate a custom address.

ununifid tx wasm instantiate2 [code_id_int64] [json_encoded_init_args] [salt] --label [text] --admin [address,optional] --amount [coins,optional] --fix-msg [bool,optional] [flags]

Predictable address example (also see 'ununifid query wasm build-address -h'):

$ ununifid tx wasm instantiate2 1 '{"foo":"bar"}' $(echo -n "testing" | xxd -ps) --admin="$(ununifid keys show mykey -a)" \
  --from mykey --amount="100ustake" --label "local0.1.0" \
   --fix-msg

Flags:

Please refer to Common flags in cosmwasm tx for details of flags.

ununifid tx wasm migrate

Migrate a wasm contract to a new code version

ununifid tx wasm migrate [contract_addr_bech32] [new_code_id_int64] [json_encoded_migration_args] [flags]

Flags:

Please refer to Common flags in cosmwasm tx for details of flags.

ununifid tx wasm set-contract-admin

Set new admin for a contract

ununifid tx wasm set-contract-admin [contract_addr_bech32] [new_admin_addr_bech32] [flags]

Flags:

Please refer to Common flags in cosmwasm tx for details of flags.

ununifid tx wasm store

Upload a wasm binary

ununifid tx wasm store [wasm file] [flags]

Flags:

Please refer to Common flags in cosmwasm tx for details of flags.

ununifid tx wasm update-instantiate-config

Update instantiate config for a codeID

ununifid tx wasm update-instantiate-config [code_id_int64] [flags]

Flags:

Please refer to Common flags in cosmwasm tx for details of flags.