Skip to content
LogoLogo

Wasm

BuildAddress

GET/cosmwasm/wasm/v1/build_address

BuildAddress builds a contract address

Query Parameters

code_hash
string

CodeHash is the hash of the code.

creator_address
string

CreatorAddress is the address of the contract instantiator.

salt
string

Salt is a hex encoded salt.

init_args
string <byte>

InitArgs are optional json encoded init args to be used in contract address building if provided.

Responses

CircuitInfo

GET/cosmwasm/wasm/v1/circuit-info/{zk_id}

CircuitInfo gets the circuit meta data

Path Parameters

zk_idRequired
string <uint64>

Responses

Circuit

GET/cosmwasm/wasm/v1/circuit/{zk_id}

Circuit gets reconstructed circuit metadata and binary for a zk_id. Does not expose raw standalone param files.

Path Parameters

zk_idRequired
string <uint64>

Responses

PinnedCircuits

GET/cosmwasm/wasm/v1/circuits/pinned

PinnedCircuits gets the pinned code ids

Query Parameters

pagination.key
string <byte>

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
string <uint64>

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
string <uint64>

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_total
boolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

Codes

GET/cosmwasm/wasm/v1/code

Codes gets the metadata for all stored wasm codes

Query Parameters

pagination.key
string <byte>

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
string <uint64>

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
string <uint64>

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_total
boolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

CodeInfo

GET/cosmwasm/wasm/v1/code-info/{code_id}

CodeInfo gets the metadata for a single wasm code

Path Parameters

code_idRequired
string <uint64>

Responses

Code

GET/cosmwasm/wasm/v1/code/{code_id}

Code gets the binary code and metadata for a single wasm code

Path Parameters

code_idRequired
string <uint64>

Responses

ContractsByCode

GET/cosmwasm/wasm/v1/code/{code_id}/contracts

ContractsByCode lists all smart contracts for a code id

Path Parameters

code_idRequired
string <uint64>

Query Parameters

pagination.key
string <byte>

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
string <uint64>

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
string <uint64>

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_total
boolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

Params

GET/cosmwasm/wasm/v1/codes/params

Params gets the module params

Responses

PinnedCodes

GET/cosmwasm/wasm/v1/codes/pinned

PinnedCodes gets the pinned code ids

Query Parameters

pagination.key
string <byte>

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
string <uint64>

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
string <uint64>

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_total
boolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

ContractInfo

GET/cosmwasm/wasm/v1/contract/{address}

ContractInfo gets the contract meta data

Path Parameters

addressRequired
string

address is the address of the contract to query

Responses

ContractHistory

GET/cosmwasm/wasm/v1/contract/{address}/history

ContractHistory gets the contract code history

Path Parameters

addressRequired
string

address is the address of the contract to query

Query Parameters

pagination.key
string <byte>

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
string <uint64>

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
string <uint64>

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_total
boolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

RawContractState

GET/cosmwasm/wasm/v1/contract/{address}/raw/{query_data}

RawContractState gets single key from the raw store data of a contract

Path Parameters

addressRequired
string

address is the address of the contract

query_dataRequired
string <byte>

Responses

SmartContractState

GET/cosmwasm/wasm/v1/contract/{address}/smart/{query_data}

SmartContractState get smart query result from the contract

Path Parameters

addressRequired
string

address is the address of the contract

query_dataRequired
string <byte>

QueryData contains the query data passed to the contract

Responses

AllContractState

GET/cosmwasm/wasm/v1/contract/{address}/state

AllContractState gets all raw store data for a single contract

Path Parameters

addressRequired
string

address is the address of the contract

Query Parameters

pagination.key
string <byte>

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
string <uint64>

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
string <uint64>

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_total
boolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

ContractsByCreator

GET/cosmwasm/wasm/v1/contracts/creator/{creator_address}

ContractsByCreator gets the contracts by creator

Path Parameters

creator_addressRequired
string

CreatorAddress is the address of contract creator

Query Parameters

pagination.key
string <byte>

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
string <uint64>

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
string <uint64>

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_total
boolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

Vk

GET/cosmwasm/wasm/v1/vk/{vk_id}

Vk gets circuit/vk binary for a vk/zk id (reconstructed via wasmvm). Raw commitment params are never returned.

Path Parameters

vk_idRequired
string <uint64>

Responses

VkInfo

GET/cosmwasm/wasm/v1/vk_info/{vk_id}

VkInfo gets verifying-key / circuit metadata (checksums, creator).

Path Parameters

vk_idRequired
string <uint64>

Responses

VkParam

GET/cosmwasm/wasm/v1/vk_param/{param_id}

VkParam returns param metadata only (checksum + creator). Raw param bytes are intentionally not queryable.

Path Parameters

param_idRequired
string <uint64>

Responses

VkParamInfo

GET/cosmwasm/wasm/v1/vk_param_info/{param_id}

VkParamInfo returns the same metadata as VkParam (checksums / creator / ids).

Path Parameters

param_idRequired
string <uint64>

Responses

WasmLimitsConfig

GET/cosmwasm/wasm/v1/wasm-limits-config

WasmLimitsConfig gets the configured limits for static validation of Wasm files, encoded in JSON.

Responses