Motoko プログラミング入門: CYCLE ウォレットとキャニスター
Jan 03, 2022このページは、DFINITY のチュートリアルを日本語で解説しています。
実際に使ったソースコードはGitHubからダウンロードできます。
実行環境
- dfx: 0.8.4
- macOS: 11.5.2
- npm version: 8.1.3
- 任意のターミナル
- 任意のテキストエディタ
dfx について知りたい方はこちらをどうぞ
ターミナルは、なんでもよいので Mac 標準のターミナルで大丈夫です。 テキストエディタは Visual Studio Code を筆者は使っています。
手順
プロジェクトの作成
新しいプロジェクトを作ります。
dfx new cycles_hello
cd cycles_helloコーディング
src/cycles_hello/main.mo
import Nat64 "mo:base/Nat64";
import Cycles "mo:base/ExperimentalCycles";
shared(msg) actor class HelloCycles (
capacity: Nat
) {
var balance = 0;
// Return the current cycle balance
public shared(msg) func wallet_balance() : async Nat {
return balance;
};
// Return the cycles received up to the capacity allowed
public func wallet_receive() : async { accepted: Nat64 } {
let amount = Cycles.available();
let limit : Nat = capacity - balance;
let accepted =
if (amount <= limit) amount
else limit;
let deposit = Cycles.accept(accepted);
assert (deposit == accepted);
balance += accepted;
{ accepted = Nat64.fromNat(accepted) };
};
// Return the greeting
public func greet(name : Text) : async Text {
return "Hello, " # name # "!";
};
// Return the principal of the caller/user identity
public shared(msg) func owner() : async Principal {
let currentOwner = msg.caller;
return currentOwner;
};
};起動＆デプロイ
ローカル実行環境を起動
dfx start --clean --backgroundキャニスターのビルド＆デプロイ
dfx deploy --argument '(360000000000)'出力
cycles_hello % dfx deploy --argument '(360000000000)'
Creating a wallet canister on the local network.
The wallet canister on the "local" network for user "default" is "rwlgt-iiaaa-aaaaa-aaaaa-cai"
Deploying all canisters.
Creating canisters...
Creating canister "cycles_hello"...
"cycles_hello" canister created with canister id: "rrkah-fqaaa-aaaaa-aaaaq-cai"
Creating canister "cycles_hello_assets"...
"cycles_hello_assets" canister created with canister id: "ryjl3-tyaaa-aaaaa-aaaba-cai"
Building canisters...
（中略）
Committing batch.
Deployed canisters.キャニスターの owner の Principal ID を表示させます
dfx canister call cycles_hello owner出力
(principal "zr2yi-7hrww-jgne7-j4gbs-2xu5a-ms3wg-ixp3t-4azyp-ifmeb-yxym6-sqe")この Principal ID はデプロイした Identity の Principal ID で以下のコマンドの結果と一致します。
dfx identity get-principal動作確認
CYCLES の確認
CYCLE は Wallet キャニスターが管理しています。 このプロジェクトに登場するウォレットは 2 つあります。
- dfx の実行ユーザー用のウォレット
- cycles_hello キャニスター用のウォレット
cycles_hello キャニスターのウォレットの初期残高を表示
dfx canister call cycles_hello wallet_balance
(0 : nat)dfx の実行ユーザーのウォレットから cycles_hello キャニスターのウォレットに 256,000,000,000CYCLE を移動
dfx canister call rwlgt-iiaaa-aaaaa-aaaaa-cai wallet_send '(record { canister = principal "rrkah-fqaaa-aaaaa-aaaaq-cai"; amount = (256000000000:nat64); } )'出力
(variant { 17_724 })cycles_hello キャニスターのウォレットの残高を表示
dfx canister call cycles_hello wallet_balance
(256_000_000_000 : nat)dfx 実行ユーザーの wallet 残高を表示
dfx canister call rwlgt-iiaaa-aaaaa-aaaaa-cai wallet_balance出力
(record { 3_573_748_184 = 91_744_000_000_000 : nat64 })キャニスターを実行したらどのウォレットから CYCLE が消費されるか
dfx canister call cycles_hello greet '("from DFINITY")'
("Hello, from DFINITY!")dfx canister call rwlgt-iiaaa-aaaaa-aaaaa-cai wallet_balance出力
(record { 3_573_748_184 = 91_744_000_000_000 : nat64 })DFINITY の Document では、このときに dfx 実行ユーザーの wallet の CYCLE 残高が減少してますが 筆者の環境では、どちらのウォレットの CYCLE も減りませんでした。
詳しく調べて、また後日、更新したいと思います。
停止
dfx.json があるディレクトリで以下のコマンドを実行して、実行環境を停止します。
dfx stop2023-05-14 追記
当記事の内容は古くなっている可能性があります。 記事の趣旨は少し変わりますが、新しいキャニスターの記事がこちらにあります。