Deploying A CosmWasm Contract

The following is detailed guide that shows the basics of manually deploying a contract to a Terp Network local environment.

Deploy contract

In the Compile Contract page, we generated a wasm binary executable. You can upload the code to the blockchain, and once the process is complete, you can download the bytecode for verification purposes.

Deploy using terpd

Now you will store the wasm bytecode of the cw_counter contract on chain and obtain the code id. This code id will be used later to create an instance of the cw_counter contract.

terpd tx wasm store contract.wasm --from testnet-key --gas-prices 0.025uthiolx --gas-adjustment 1.7 --gas auto

The following is an easier way to get the Code Id from the response:

terpd q tx [hash] | jq 
# or use sed to return just the code_id
terpd q tx [hash] | sed -n 's/.*"key":"code_id","value":"\([^"]*\)".*/\1/p'
# or check the block explorer
https://testnet-ping.pub/terp/tx/[hash]

You can see the list of contracts instantiated using the CODE_ID generated above by executing the following command:

terpd q wasm list-contract-by-code $CODE_ID

The response should be an empty list since no contracts have been instantiated yet.

{"contracts":[],"pagination":{"next_key":null,"total":"0"}}

Before you instantiate a contract using the Code Id and interact with it, let's verify if the code stored on the blockchain is indeed the cw_namespace.wasm binary you uploaded.

Download the wasm binary from the chain and compare it to the original one:

terpd q wasm code $CODE_ID download.wasm

The two binaries shoud be identical:

diff artifacts/cw_nameservice.wasm download.wasm

If the diff command yields an empty output, this indicates that the two files being compared are identical.

Instantiating the contract

You can now create an instance of the wasm contract. After instantiation, you can make queries and execute transactions.

terpd tx wasm i <code_id_here> '{"msg_name_here":{}}' --from testnet-key

Contract Interaction

Now that the contract is instantiated, you can register a name and transfer it to another address by paying the transfer fee.

to get the contract address from the code-id tx:

terpd q tx <tx_hash> -o json | jq -r '.logs[].events[] | select(.type == "instantiate") | .attributes[] | select(.key == "_contract_address") | .value)'

title: Testnet

Deploy to Mainnet

How do I deploy to Terp Network mainnet?

Terp Network is a permissioned chain, meaning there is a governance process to adhere to. After familiarizing yourslef with the governance process, here's a template to follow for submitting an on-chain proposal.

To submit a governance proposal via the terpd CLI, you may follow the exmaple below

Create Draft Proposal & Metadata

terpd tx gov draft-proposal

Format WASM Binary for proposal

Submit New Proposal

terpd tx gov submit-proposal draft-proposal.json --from test-key --chain-id morocco-1

terpd keys add testnet-key

2. Request funds through the `faucet`

https://faucet.terp.network/90u-4/<address>

3. Configure RPC endpoint & Chain ID

terpd config node https:://testnet-rpc.terp.network:443
terpd config chain-id 90u-4

4. Check your account has balance

terpd q bank balances [address]

5. Deploy a contract

terpd tx wasm store contract.wasm --from testnet-key --gas auto --gas-adjustment 1.5 --fees 5000000uthiol

6. Collect the new Code ID

After executing the transaction you will have a code id that you can use to instantiate the contract

terpd q tx [hash] | jq 

# or use sed to return just the code_id

terpd q tx [hash] | sed -n 's/.*"key":"code_id","value":"\([^"]*\)".*/\1/p'

a. deploy a contract to a network