lesson-4_NFTの情報を確認できるようにしよう

🫣 NFT の情報を確認できるようにしよう

まずはNFT1つ1つの情報を見るための関数をつくります。nft_core.rsに移動して下のコードを追加しましょう。

[nft_core.rs]

+ use crate::*;
+
+ pub trait NonFungibleTokenCore {
+     fn nft_token(&self, token_id: TokenId) -> Option<JsonToken>;
+ }
+
+ #[near_bindgen]
+ impl NonFungibleTokenCore for Contract {
+     // get specified token info
+     fn nft_token(&self, token_id: TokenId) -> Option<JsonToken> {
+         if let Some(token) = self.tokens_by_id.get(&token_id) {
+             let metadata = self.token_metadata_by_id.get(&token_id).unwrap();
+             Some(JsonToken {
+                 owner_id: token.owner_id,
+                 metadata,
+             })
+         } else {
+             None
+         }
+     }
+ }

ひとつずつ見ていきましょう。まずはNonFungibleTokenCoreというトレイトにnft_tokenという関数があることを宣言する。ここでは引き数と返り値だけで大丈夫です。

pub trait NonFungibleTokenCore {
    fn nft_token(&self, token_id: TokenId) -> Option<JsonToken>;
}

次の部分ではnft_token関数の中身を記述します。ここでは引数であるtokenのidに対してmetadataが存在するのかを確かめて、ある場合はそれを返すという処理をしています。

#[near_bindgen]
impl NonFungibleTokenCore for Contract {
    // get specified token info
    fn nft_token(&self, token_id: TokenId) -> Option<JsonToken> {
        if let Some(token) = self.tokens_by_id.get(&token_id) {
            let metadata = self.token_metadata_by_id.get(&token_id).unwrap();
            Some(JsonToken {
                owner_id: token.owner_id,
                metadata,
            })
        } else {
            None
        }
    }
}

これによってそれぞれのtokenのmetadataを見れるようになりましたが、walletがNFTを表示できるようにするための関数であるnft_tokens_for_owner関数がまだ実装できていないのでenumeration.rsに移動して下のコードを追加しましょう。

[enumeration.rs]

+ use crate::*;
+
+ #[near_bindgen]
+ impl Contract {
+     pub fn nft_total_supply(&self) -> U128 {
+         U128(self.token_metadata_by_id.len() as u128)
+     }
+
+     pub fn nft_tokens(&self, from_index: Option<U128>, limit: Option<u64>) -> Vec<JsonToken> {
+         let start = u128::from(from_index.unwrap_or(U128(0)));
+         self.token_metadata_by_id
+             .keys()
+             .skip(start as usize)
+             .take(limit.unwrap_or(50) as usize)
+             .map(|token_id| self.nft_token(token_id.clone()).unwrap())
+             .collect()
+     }
+
+     // get number of tokens for specified owner
+     pub fn nft_supply_for_owner(&self, account_id: AccountId) -> U128 {
+         let tokens_for_kind_set = self.tokens_per_owner.get(&account_id);
+         if let Some(tokens_for_kind_set) = tokens_for_kind_set {
+             U128(tokens_for_kind_set.len() as u128)
+         } else {
+             U128(0)
+         }
+     }
+
+     pub fn nft_tokens_for_owner(
+         &self,
+         account_id: AccountId,
+         from_index: Option<U128>,
+         limit: Option<u64>,
+     ) -> Vec<JsonToken> {
+         let tokens_for_owner_set = self.tokens_per_owner.get(&account_id);
+         let tokens = if let Some(tokens_for_owner_set) = tokens_for_owner_set {
+             tokens_for_owner_set
+         } else {
+             return vec![];
+         };
+
+         let start = u128::from(from_index.unwrap_or(U128(0)));
+         tokens
+             .iter()
+             .skip(start as usize)
+             .take(limit.unwrap_or(50) as usize)
+             .map(|token_id| self.nft_token(token_id.clone()).unwrap())
+             .collect()
+     }
+ }

最初のnft_total_supply関数ではコントラクトに保存されているNFTの数を取得できます。

次のnft_tokensではコントラクトに保管されている全てのNFTのmetadataが得られます。

pub fn nft_total_supply(&self) -> U128 {
    U128(self.token_metadata_by_id.len() as u128)
}

pub fn nft_tokens(&self, from_index: Option<U128>, limit: Option<u64>) -> Vec<JsonToken> {
    let start = u128::from(from_index.unwrap_or(U128(0)));
    self.token_metadata_by_id
        .keys()
        .skip(start as usize)
        .take(limit.unwrap_or(50) as usize)
        .map(|token_id| self.nft_token(token_id.clone()).unwrap())
        .collect()
}

この関数では特定の所有者が持つNFTの数を取得できます。これはwallet上での表示にも関わってくるので書き漏れのないように特に気をつけてください。

pub fn nft_supply_for_owner(&self, account_id: AccountId) -> U128 {
    let tokens_for_kind_set = self.tokens_per_owner.get(&account_id);
    if let Some(tokens_for_kind_set) = tokens_for_kind_set {
        U128(tokens_for_kind_set.len() as u128)
    } else {
        U128(0)
    }
}

引数としてはユーザーのWallet Idをとります。from_index、limitは対象のユーザーがたくさんNFTを持っているときにNFTのリストのどこからどこまでを取得するかを指定するために用意されています。

返り値としてmetadataとownerのidが入っているJsonToken型のベクターが返ってきます。

pub fn nft_tokens_for_owner(
    &self,
    account_id: AccountId,
    from_index: Option<U128>,
    limit: Option<u64>,
)-> Vec<JsonToken>

内容としてはまず所有者のtokenのidからtokenのidがリスト化されたベクターをとってきます。

その次の処理でtokenのidのリストの中身が無い場合は新しくインスタンス化します。

最後に先ほど作成したnft_token関数を利用してtokenのmetadataとその所有者を紐づけた情報を返します。

pub fn nft_tokens_for_owner(
    &self,
    account_id: AccountId,
    from_index: Option<U128>,
    limit: Option<u64>,
) -> Vec<JsonToken> {
    let tokens_for_owner_set = self.tokens_per_owner.get(&account_id);
    let tokens = if let Some(tokens_for_owner_set) = tokens_for_owner_set {
        tokens_for_owner_set
    } else {
        return vec![];
    };

    let start = u128::from(from_index.unwrap_or(U128(0)));
    tokens
        .iter()
        .skip(start as usize)
        .take(limit.unwrap_or(50) as usize)
        .map(|token_id| self.nft_token(token_id.clone()).unwrap())
        .collect()
}

これでやっとmint機能とそれをwalletとターミナル上で確認できるようになったので次は実際にコントラクトをdeployして、mintしてみましょう！

🤞 mint してみよう

mintをしたいところですが、mintができているかを確認するためにまずはNEARのTestnetで自分のWalletを作成する必要があります。 こちらから作成してください。

まず、packages/contractに移動します。

walletのidをコピーして下のコマンドのYOUR_WALLET_IDに入れてターミナルで実行させてください。

export NFT_CONTRACT_ID=YOUR_WALLET_ID

下のコマンドをターミナルを実行させてきちんとNFT_CONTRACT_IDという変数にあなたのWallet Idが入っているかを確認してみましょう。

echo $NFT_CONTRACT_ID

確認ができたら、下のコマンドをターミナルを実行させてログインしましょう。

near login

次にpackages/contract/package.jsonのscript部分を以下のように編集してください。

"scripts": {
    "build":"set -e && RUSTFLAGS='-C link-arg=-s' cargo build --target wasm32-unknown-unknown --release",
    "deploy":"near deploy --wasm-file target/wasm32-unknown-unknown/release/near_election_dapp_contract.wasm --accountId $NFT_CONTRACT_ID",
    "test": "cargo test"
  },

その後、ターミナル上で、下記を実行してみましょう。

yarn contract build
yarn contract deploy

ではpackages/contractへ移動して、初期化するために作ったnew_default_metaを下のコマンドをターミナルを実行させましょう。

near call $NFT_CONTRACT_ID new_default_meta '{"owner_id": "'$NFT_CONTRACT_ID'"}' --accountId $NFT_CONTRACT_ID

これでコントラクトのメタデータを更新できました。最後に下のコマンドをターミナルを実行させてmintをしてみましょう。

コードのnft_mint以下では、この関数が必要とする引数を記述しています。他にいい画像などがあればそのURLをmediaに入れてもできます！

near call $NFT_CONTRACT_ID nft_mint '{"metadata": {"title": "Vote Ticket", "description": "First Token", "media": "https://gateway.pinata.cloud/ipfs/QmUs5K3LwdvbhKA58bH9C6FX5Q7Bhsvvg9GRAhr9aVKLyx", "media_CID": "QmUs5K3LwdvbhKA58bH9C6FX5Q7Bhsvvg9GRAhr9aVKLyx","token_kind": "vote"}, "receiver_id": "'$NFT_CONTRACT_ID'"}' --accountId $NFT_CONTRACT_ID --amount 0.1

これによって投票券のNFTをmintできました！ 先ほど作成したWalletのCollectiblesを確認してみましょう！ 下のようなNFTがmintできているはずです。

🙋‍♂️ 質問する

ここまでの作業で何かわからないことがある場合は、Discordの#nearで質問をしてください。

ヘルプをするときのフローが円滑になるので、エラーレポートには下記の4点を記載してください ✨

1. 質問が関連しているセクション番号とレッスン番号
2. 何をしようとしていたか
3. エラー文をコピー&ペースト
4. エラー画面のスクリーンショット

---

おめでとうございます！ これでmint機能が完成しました！

セクション1は終了です！

ぜひ、mintした投票権NFTが表示されているWallet画面のスクリーンショットを#nearに投稿してください 😊

あなたの成功をコミュニティで祝いましょう 🎉

次のセクションではもう1つのコア機能であるtransfer機能や投票に必要な機能を実装してコントラクトのコーディングは完了になりますので頑張っていきましょう！