はじめに

全体の流れ

必要な開発環境

Rust：最新バージョン  v1.46.0 (2020/9/30 現在)

$ rustc --version
rustc 1.46.0 (04488afe3 2020-08-24)

$ rustup default stable
$ rustup target add wasm32-unknown-unknown

$ cargo install cargo-generate --features vendored-openssl

Go：v1.13.1以上が必要

Docker Compose

必要なツール

LocalTerra

$ git clone https://github.com/terra-project/localterra
$ cd localterra
$ docker-compose up

// 以下のようなログが出力されるはず。
...
terrad_1         | I[2020-09-30|08:16:27.566] Executed block                               module=state height=387 validTxs=0 invalidTxs=0
terrad_1         | I[2020-09-30|08:16:27.570] Committed state                              module=state height=387 txs=0 appHash=AE3048319FA8FDCB2B7341A696024EB6E3907B318E87843D290026B374017E3E
...

terracli

$ git clone https://github.com/terra-project/core/
$ cd core
$ git checkout -b v0.4.0 v0.4.0

$ git branch
develop
* v0.4.0

// クローンしたリポジトリ以下で
$ make install

$ terracli version --long
name: terra
server_name: terrad
client_name: terracli
version: 0.4.0
commit: 0ccb97e4427007f940b611fb0b5fb67d6a7d69f5
build_tags: netgo,ledger
go: go version go1.15.1 darwin/amd64

コントラクトを書いてみる

cargo generate --git https://github.com/CosmWasm/cosmwasm-template.git --branch 0.10 --name my-first-contract
cd my-first-contract

どういったコントラクトを用意するのか

• コントラクト作成時に渡した引数をcountとし、countの値を初期化する機能
• countの値をインクリメントする機能
• countの値を渡した引数で更新する機能(オーナーのみ利用可能)
• 現在のcountの値を参照する機能

実際のコントラクト

• init() : コントラクトをインスタンス化する際に呼び出されるコンストラクタ
• handle() : ユーザーがコントラクト上でメソッドを呼び出したい場合に実行される関数
• query() : ユーザーがコントラクトからデータを取得したい場合に実行される関数

use schemars::JsonSchema;
use serde::{Deserialize, Serialize};

use cosmwasm_std::{CanonicalAddr, Storage};
use cosmwasm_storage::{singleton, singleton_read, ReadonlySingleton, Singleton};

pub static CONFIG_KEY: &[u8] = b"config";

#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct State {
    pub count: i32,
    pub owner: CanonicalAddr,
}

pub fn config<S: Storage>(storage: &mut S) -> Singleton<S, State> {
    singleton(storage, CONFIG_KEY)
}

pub fn config_read<S: Storage>(storage: &S) -> ReadonlySingleton<S, State> {
    singleton_read(storage, CONFIG_KEY)
}

{
  "count": 100
}

use schemars::JsonSchema;
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct InitMsg {
    pub count: i32,
}

use cosmwasm_std::{
    to_binary, Api, Binary, Env, Extern, HandleResponse, InitResponse, Querier, StdError,
    StdResult, Storage,
};

use crate::msg::{CountResponse, HandleMsg, InitMsg, QueryMsg};
use crate::state::{config, config_read, State};

pub fn init<S: Storage, A: Api, Q: Querier>(
    deps: &mut Extern<S, A, Q>,
    env: Env,
    msg: InitMsg,
) -> StdResult<InitResponse> {
    let state = State {
        count: msg.count,
        owner: deps.api.canonical_address(&env.message.sender)?,
    };

    config(&mut deps.storage).save(&state)?;

    Ok(InitResponse::default())
}

{
  "increment": {}
}

{
  "reset": {
    "count": 5
  }
}

#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum HandleMsg {
    Increment {},
    Reset { count: i32 },
}

pub fn handle<S: Storage, A: Api, Q: Querier>(
    deps: &mut Extern<S, A, Q>,
    env: Env,
    msg: HandleMsg,
) -> StdResult<HandleResponse> {
    match msg {
        HandleMsg::Increment {} => try_increment(deps, env),
        HandleMsg::Reset { count } => try_reset(deps, env, count),
    }
}

pub fn try_increment<S: Storage, A: Api, Q: Querier>(
    deps: &mut Extern<S, A, Q>,
    _env: Env,
) -> StdResult<HandleResponse> {
    config(&mut deps.storage).update(|mut state| {
        state.count += 1;
        Ok(state)
    })?;

    Ok(HandleResponse::default())
}

• message: MsgSend, MsgSwapなどのメッセージのリスト。これを使用してスマートコントラクトから、スマートコントラクト以外のTerraブロックチェーン上のモジュールに対して作用することができるようになります。
• log: クライアントが購読できる形にイベントを定義するためのキーバリューペアのリスト。これを定義することで、ブロックエクスプローラやアプリケーションがコントラクトの動きを解析し、実行中に発生した重要なイベントやステートの状態を報告することができるようになります。
• data: コントラクトに記録する追加のデータです。

pub fn try_reset<S: Storage, A: Api, Q: Querier>(
    deps: &mut Extern<S, A, Q>,
    env: Env,
    count: i32,
) -> StdResult<HandleResponse> {
    let api = &deps.api;
    config(&mut deps.storage).update(|mut state| {
        if api.canonical_address(&env.message.sender)? != state.owner {
            return Err(StdError::unauthorized());
        }
        state.count = count;
        Ok(state)
    })?;
    Ok(HandleResponse::default())
}

{
  "get_count": {}
}

{
  "count": 5
}

#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum QueryMsg {
    // GetCount returns the current count as a json-encoded number
    GetCount {},
}

// We define a custom struct for each query response
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct CountResponse {
    pub count: i32,
}

pub fn query<S: Storage, A: Api, Q: Querier>(
    deps: &Extern<S, A, Q>,
    msg: QueryMsg,
) -> StdResult<Binary> {
    match msg {
        QueryMsg::GetCount {} => to_binary(&query_count(deps)?),
    }
}

fn query_count<S: Storage, A: Api, Q: Querier>(deps: &Extern<S, A, Q>) -> StdResult<CountResponse> {
    let state = config_read(&deps.storage).load()?;
    Ok(CountResponse { count: state.count })
}

コントラクトのビルド

$ cargo wasm

ビルドを最適化する

$ docker run --rm -v "$(pwd)":/code \
  --mount type=volume,source="$(basename "$(pwd)")_cache",target=/code/target \
  --mount type=volume,source=registry_cache,target=/usr/local/cargo/registry \
  cosmwasm/rust-optimizer:0.10.3

Schemasを設定する

use std::env::current_dir;
use std::fs::create_dir_all;

use cosmwasm_schema::{export_schema, remove_schemas, schema_for};

use mtt::msg::{CountResponse, HandleMsg, InitMsg, QueryMsg};
use mtt::state::State;

fn main() {
    let mut out_dir = current_dir().unwrap();
    out_dir.push("schema");
    create_dir_all(&out_dir).unwrap();
    remove_schemas(&out_dir).unwrap();

    export_schema(&schema_for!(InitMsg), &out_dir);
    export_schema(&schema_for!(HandleMsg), &out_dir);
    export_schema(&schema_for!(QueryMsg), &out_dir);
    export_schema(&schema_for!(State), &out_dir);
    export_schema(&schema_for!(CountResponse), &out_dir);
}

// テンプレが用意してくれているので今回は実行する必要なし
$ cargo schema

コントラクトの実行

$ cd localterra
$ docker-compose up

// test1は好きな名前で大丈夫です。
$ terracli keys add test1 --recover

> Enter your bip39 mnemonic
satisfy adjust timber high purchase tuition stool faith fine install that you unaware feed domain license impose boss human eager hat rent enjoy dawn

$ terracli query account $(terracli keys show test1 -a)
|
  address: terra1dcegyrekltswvyy0xy69ydgxn9x8x32zdtapd8
  coins:
  - denom: ukrw
    amount: "1000000000000000000"
  - denom: uluna
    amount: "999998989418598"
  - denom: umnt
    amount: "1000000000000000000"
  - denom: usdr
    amount: "1000000000000000"
  - denom: uusd
    amount: "10000000000000000"
  public_key: terrapub1addwnpepqflqjs2z2l52fku85zh65cxt8ctm4yn4nk5l9xyv80jq5hvszddpck20sd0
  account_number: 0
  sequence: 525

コントラクトをアップロード

// my-first-contract/artifacts で実行
$ terracli tx wasm store my_first_contract.wasm --from test1 --chain-id=localterra --gas=auto --fees=200000uluna --broadcast-mode=block

confirm transaction before signing and broadcasting [y/N]: y

height: 6
txhash: 
83BB9C6FDBA1D2291E068D5CF7DDF7E0BE459C6AF547EC82652C52507CED8A9F
codespace: ""
code: 0
data: ""
rawlog: '[{"msg_index":0,"log":"","events":[{"type":"message","attributes":[{"key":"action","value":"store_code"},{"key":"module","value":"wasm"}]},{"type":"store_code","attributes":[{"key":"sender","value":"terra1dcegyrekltswvyy0xy69ydgxn9x8x32zdtapd8"},{"key":"code_id","value":"1"}]}]}]'
logs:
- msgindex: 0
  log: ""
  events:
  - type: message
    attributes:
    - key: action
      value: store_code
    - key: module
      value: wasm
  - type: store_code
    attributes:
    - key: sender
      value: terra1dcegyrekltswvyy0xy69ydgxn9x8x32zdtapd8
    - key: code_id
      value: "1"
info: ""
gaswanted: 681907
gasused: 680262
tx: nulltimestamp: ""

$ terracli query wasm code 1
codeid: 1
codehash: KVR4SWuieLxuZaStlvFoUY9YXlcLLMTHYVpkubdjHEI=
creator: terra1dcegyrekltswvyy0xy69ydgxn9x8x32zdtapd8

コントラクトを作成

$ terracli tx wasm instantiate 1 '{"count":0}' --from test1 --chain-id=localterra --fees=20000uluna --gas=auto --broadcast-mode=block

height: 41
txhash: AEF6F2FA570029A5D4C0DA5ACFA4A2B614D5811E29EEE10FF59F821AFECCD399
codespace: ""
code: 0
data: ""
rawlog: '[{"msg_index":0,"log":"","events":[{"type":"instantiate_contract","attributes":[{"key":"owner","value":"terra1dcegyrekltswvyy0xy69ydgxn9x8x32zdtapd8"},{"key":"code_id","value":"1"},{"key":"contract_address","value":"terra18vd8fpwxzck93qlwghaj6arh4p7c5n896xzem5"}]},{"type":"message","attributes":[{"key":"action","value":"instantiate_contract"},{"key":"module","value":"wasm"}]}]}]'
logs:
- msgindex: 0
  log: ""
  events:
  - type: instantiate_contract
    attributes:
    - key: owner
      value: terra1dcegyrekltswvyy0xy69ydgxn9x8x32zdtapd8
    - key: code_id
      value: "1"
    - key: contract_address
      value: terra18vd8fpwxzck93qlwghaj6arh4p7c5n896xzem5
  - type: message
    attributes:
    - key: action
      value: instantiate_contract
    - key: module
      value: wasm
info: ""
gaswanted: 120751
gasused: 120170
tx: null
timestamp: ""

// contract_addressは自分の環境で出力されたものを渡す。
$ terracli query wasm contract terra18vd8fpwxzck93qlwghaj6arh4p7c5n896xzem5

コントラクトを実行

1. countの値を5にリセット
2. 二回インクリメントを行う

$ terracli query wasm contract-store terra18vd8fpwxzck93qlwghaj6arh4p7c5n896xzem5 '{"get_count":{}}'
{"count":0}

$ terracli tx wasm execute terra18vd8fpwxzck93qlwghaj6arh4p7c5n896xzem5 '{"reset":{"count":5}}' --from test1 --chain-id=localterra --fees=2000000uluna --gas=auto --broadcast-mode=block

$ terracli tx wasm execute terra18vd8fpwxzck93qlwghaj6arh4p7c5n896xzem5 '{"increment":{}}' --from test1 --chain-id=localterra --gas=auto --fees=2000000uluna --broadcast-mode=block

おわりに

参考資料