Zenn
🚬

【Solana 開発】Solana のスマートコントラクト開発環境を作ろう②【Web3 アプリ】

2022/08/24に公開
ブロックチェーン
Rust
Web3
anchor
Solana
tech

【Solana 開発】Solana のスマートコントラクト開発環境を作ろう①【Web3 アプリ】

に続いて、Solana スマートコントラクト開発のために Anchor をインストールします。

Web3, 特に dApp の世界ではデータの扱い方が大きく変わります。
もちろん、Web2 で得たスキルや知識はそのまま Web3 でも輝きます☺

ざっくりですが、これまでのデータの捉え方は、
それぞれの中央管理サーバーにデータの所有があるのに対し、
Web3 ではデータをユーザーが所有します。

このような新たな概念でデータ構造を考えていくように筆者も日々脳内転生に励んでいます。

それでは Anchor の開発環境を整えてみます。

avm のインストール

$ cargo install --git https://github.com/project-serum/anchor avm --locked --force

Linuxなどの場合以下のライブラリのインストールが必要になることがあります。
cargo install が失敗した場合、以下のコマンドを試してみて下さい。

$ sudo apt-get update && sudo apt-get upgrade && sudo apt-get install -y pkg-config build-essential libudev-dev

Anchor のインストールとバージョン管理

$ avm install latest
$ avm use latest

バージョンの確認

$ anchor --version

Anchor プロジェクトを作る

anchor init {プロジェクト名} で新規 Anchor プロジェクトを作成します。
ここでは first_contract というプロジェクト名を使います。

$ anchor init first_contract
yarn install v1.22.19
warning package.json: No license field
info No lockfile found.
warning No license field
[1/4] Resolving packages...
[2/4] Fetching packages...
[3/4] Linking dependencies...
warning "@project-serum/anchor > @solana/web3.js > react-native-url-polyfill@1.3.0" has unmet peer dependency "react-native@*".
[4/4] Building fresh packages...
success Saved lockfile.
Done in 14.26s.
Initialized empty Git repository in /home/fumi/dev/rust/first_contract/.git/
first_contract initialized

anchor init が失敗する場合は node と yarn がインストールされていることを確認してください。

Node バージョン確認

$ node -v
v18.7.0

Yarn バージョン確認

$ yarn -v
1.22.19

Anchor フレームワークの構造

anchor init で生成されたプロジェクトのディレクトリ構造は以下のようになっています。

├── Anchor.toml
├── Cargo.lock
├── Cargo.toml
├── app
├── migrations
│   └── deploy.ts
├── package.json
├── programs
│   └── first_contract
│       ├── Cargo.toml
│       ├── Xargo.toml
│       └── src
│           └── lib.rs
├── tests
│   └── first_contract.ts
├── tsconfig.json
└── yarn.lock

スマートコントラクトを実際に書き込む部分は programs ディレクトリになります。

スマートコントラクトのテンプレート

デフォルトで以下のコントラクトが生成されます。
Achor フレームワークでは基本的に、
コントラクトのロジック部分のみを書けば動作するようにしてくれています。

programs/first_contract/src/lib.rs

use anchor_lang::prelude::*;

declare_id!("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");

#[program]
pub mod first_contract {
    use super::*;

    pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
        Ok(())
    }
}

#[derive(Accounts)]
pub struct Initialize {}

このままビルドしてテストをすることができるので、
まずは動作確認をしてみます。

Anchor Test の実行

anchor test コマンドで、
ビルド、デプロイ、テストが実行されます。

$ anchor test
  first_contract
Your transaction signature 3xFXGqebu8qNSD8jM1iuxfe81fr4CvpVE9d3DTAmpDCjHTNgQpnv2DgqYj4EEDJHMSZuLku7anpNad3P7r7vrzmT
    ✔ Is initialized! (429ms)

  1 passing (431ms)

Done in 5.58s.

テストが起動しない場合には以下のパッケージをインストールしてみてください。

yarn add ts-mocha

Solana のネットワークは主に以下の4つがあります。

環境 url
ローカル環境 localhost
テスト環境 testnet
DEV環境 devnet
本番環境 mainnet-beta

その他にも GenesysGo などが提供するネットワークもあります。

solana config get で現在接続しているネットワークを確認してみます

$ solana config get
Config File: ~/.config/solana/cli/config.yml
RPC URL: http://localhost:8899 
WebSocket URL: ws://localhost:8900/ (computed)
Keypair Path: ~/.config/solana/id.json 
Commitment: confirmed

ローカルネットワークを使う場合

Solana Test Validator の起動

別のターミナルでSolana のローカルテスト環境を用意します。

$ solana-test-validator

Solana ネットワークを変更する

$ solana config set --url localhost

Anchor ビルド＆デプロイ

$ anchor build
$ anchor deploy

これで Solana スマートコントラクト開発を行う準備が整いました🎉

Discussion