Minting
This is the first of many tutorials in a series where you'll be creating a complete NFT smart contract from scratch that conforms with all the NEAR NFT standards.
Today you'll learn how to create the logic needed to mint NFTs and have them show up in your NEAR wallet. You will be filling a bare-bones skeleton smart contract to add minting functionalities.
A completed version of this tutorial can be found in the Basic NFT folder :::
Giới thiệu
To get started, go to the nft-contract-skeleton folder in our repo. If you haven't cloned the repository, refer to the Contract Architecture to get started.
cd nft-contract-skeleton/
If you wish to see the finished code of this step-by-step basic NFT contract tutorial, that can be found on the nft-contract-basic folder.
Các sửa đổi đối với skeleton contract
Để implement logic cần thiết cho việc mint, chúng ta nên chia nó thành các nhiệm vụ nhỏ hơn và xử lý từng việc một. Hãy lùi lại và suy nghĩ về cách tốt nhất để làm điều này, bằng cách tự hỏi bản thân một câu hỏi đơn giản: mint NFT nghĩa là gì?
Để mint ra một non-fungible token, theo cách đơn giản nhất có thể, một contract cần có khả năng liên kết token với một owner trên blockchain. Có nghĩa là bạn sẽ cần:
- Một cách để theo dõi các token và thông tin khác trên contract.
- Một cách để lưu trữ thông tin cho từng token, chẳng hạn như
metadata(sẽ tìm hiểu thêm ở phần sau). - Một cách để liên kết một token với một owner.
Chỉ vậy thôi! Vậy là chúng ta đã chia nhỏ vấn đề lớn thành một vài nhiệm vụ nhỏ hơn, ít khó khăn hơn. Hãy bắt đầu bằng cách giải quyết phần đầu tiên và thực hiện theo cách chúng tôi đến các phần còn lại.
Lưu thông tin trên contract
Start by navigating to nft-contract-skeleton/src/lib.rs and filling in some of the code blocks. Bạn cần có thể lưu trữ thông tin quan trọng trên contract, chẳng hạn như danh sách các token mà account sở hữu.
Contract Struct
Việc đầu tiên cần làm là modify contract struct như sau:
Loading...
This allows you to get the information stored in these data structures from anywhere in the contract. The code above has created 3 token specific storages:
- tokens_per_owner: cho phép bạn theo dõi các token thuộc sở hữu của bất kỳ account nào
- tokens_by_id: trả về tất cả thông tin của một token xác định
- token_metadata_by_id: trả về metadata của một token xác định
In addition, you'll keep track of the owner of the contract as well as the metadata for the contract.
You might be confused as to some of the types that are being used. In order to make the code more readable, we've introduced custom data types which we'll briefly outline below:
- AccountId: một string đảm bảo không có ký tự đặc biệt hoặc không được hỗ trợ.
- TokenId: đơn giản chỉ là một string.
As for the Token, TokenMetadata, and NFTContractMetadata data types, those are structs that we'll define later in this tutorial.
Các Initialization Function
Next, create what's called an initialization function; we will name it new, but you can choose any name you prefer.
This function needs to be invoked when you first deploy the contract. It will initialize all the contract's fields that you've defined above with default values. Don't forget to add the owner_id and metadata fields as parameters to the function, so only those can be customized.
This function will default all the collections to be empty and set the owner and metadata equal to what you pass in.
Loading...
Thường thì khi develop, bạn sẽ cần deploy các contract một vài lần. Bạn có thể tưởng tượng được sự tẻ nhạt khi phải pass metadata mỗi khi init contract. Vì lý do này, hãy tạo một function có thể init contract với một bộ metadata mặc định. Bạn có thể gọi nó là new_default_meta và nó chỉ có một parameter owner_id duy nhất.
Loading...
Function này chỉ đơn giản là gọi function new trước đó và truyền vào owner mà bạn chỉ định và cũng truyền vào một vài metadata mặc định.
Metadata và thông tin token
Bây giờ bạn đã xác định thông tin nào cần lưu trữ trên chính contract cũng như một số cách để init contract, bạn cần xác định thông tin nào sẽ có trong các data type Token, TokenMetadata, và NFTContractMetadata.
Let's switch over to the nft-contract-skeleton/src/metadata.rs file as this is where that information will go.
If you look at the standards for metadata, you'll find all the necessary information that you need to store for both TokenMetadata and NFTContractMetadata. Đơn giản chỉ cần điền vào code sau.
Loading...
Đến đây bạn sẽ có struct Token và có JsonToken. Struct Token sẽ chứa tất cả thông tin liên quan đến token, ngoại trừ metadata. The metadata, if you remember, is stored in a map on the contract in a data structure called token_metadata_by_id. Nó cho phép bạn có thể lấy nhanh metadata của bất kỳ token nào, bằng cách chỉ cần pass vào ID của token.
Đối với struct Token, bạn sẽ chỉ cần theo dõi owner từ lúc này.
Loading...
Since NEAR smart contracts receive and return data in JSON format, the purpose of the JsonToken is to act as output when the user asks information for an NFT. Nghĩa là bạn sẽ cần chứa owner, token ID, và metadata.
Loading...
Token cho đơn giản?". Lý do là, việc chỉ tạo JSON token khi bạn cần đến sẽ hiệu quả hơn là lưu trữ tất cả thông tin trong struct token. Hơn nữa, một số hoạt động có thể chỉ cần metadata của một token và do đó, việc có metadata trong một data structure riêng biệt sẽ tối ưu hơn. :::Function cho việc query contract metadata
Bây giờ bạn đã xác định một số kiểu đã được sử dụng trong phần trước, hãy tiếp tục và tạo view function đầu tiên nft_metadata. This will allow users to query for the contract's metadata as per the metadata standard.
Loading...
Function này sẽ lấy object metadata từ contract thuộc type NFTContractMetadata và trả về nó.
Như vậy, bạn đã hoàn thành hai nhiệm vụ đầu tiên và sẵn sàng chuyển sang phần cuối cùng của hướng dẫn.
Logic của việc Mint
Bây giờ tất cả các thông tin và type đã được xác định, chúng ta hãy bắt đầu động não xem logic của việc mint sẽ diễn ra như thế nào. Cuối cùng, bạn cần phải link một Token và TokenId đến một owner cụ thể. Hãy tham khảo lại file lib.rs để xem bạn có thể hoàn thành điều này như thế nào. Có một số data structure có thể hữu ích:
//theo dõi tất cả các token ID của một account nhất định
pub tokens_per_owner: LookupMap<AccountId, UnorderedSet<TokenId>>,
//theo dõi tất cả các token struct của một account nhất định
pub tokens_by_id: LookupMap<TokenId, Token>,
//theo dõi tất cả các token metadata của một account nhất định
pub token_metadata_by_id: UnorderedMap<TokenId, TokenMetadata>,
Nhìn vào các data structure này, bạn có thể làm như sau:
- Thêm token ID vào tập hợp các token mà người nhận sở hữu. Điều này sẽ được thực hiện trên trường
tokens_per_owner. - Tạo một object token và map token ID với object token đó trong trường
tokens_by_id. - Map token ID đến metadata của nó bằng
token_metadata_by_id.
Storage Implications
Với những bước đã nêu, điều quan trọng là phải tính đến chi phí lưu trữ của việc mint NFT. Vì bạn đang thêm byte vào contract bằng cách tạo các mục trong các data structure, nên contract cần chi trả chi phí lưu trữ. Nếu bạn chỉ tạo contract để bất kỳ người dùng nào cũng có thể sử dụng và mint một NFT miễn phí, hệ thống đó có thể dễ dàng bị lạm dụng và người dùng có thể "rút ruột" tất cả số tiền của contract bằng cách mint ra hàng nghìn NFT. Vì lý do này, bạn cần phải yêu cầu người dùng phải đính kèm một khoản deposit khi call để trang trải chi phí lưu trữ. Bạn sẽ đo mức sử dụng storage ban đầu trước khi mọi thứ được thêm vào và đo mức sử dụng storage cuối cùng sau khi tất cả logic hoàn tất. Sau đó, bạn cần đảm bảo rằng người dùng đã đính kèm đủ $NEAR để trang trải chi phí đó và hoàn lại tiền cho họ nếu họ đã đính kèm quá nhiều.
This is how we do it in code:
Loading...
Bạn sẽ nhận thấy rằng chúng tôi đang sử dụng một số internal method như refund_deposit và internal_add_token_to_owner. Chúng tôi đã mô tả chức năng của refund_deposit, còn đối với internal_add_token_to_owner, method này sẽ thêm một token vào tập hợp các token mà một account sở hữu, cụ thể là cho data structure tokens_per_owner của contract. Bạn có thể tạo các function này trong một file có tên internal.rs. Hãy tiếp tục và tạo file. Kiến trúc contract mới của bạn sẽ trông như sau:
nft-contract
├── Cargo.lock
├── Cargo.toml
├── README.md
├── build.sh
└── src
├── approval.rs
├── enumeration.rs
├── internal.rs
├── lib.rs
├── metadata.rs
├── mint.rs
├── nft_core.rs
├── events.rs
└── royalty.rs
Thêm code sau vào file internal.rs mà bạn vừa tạo.
Loading...
internal.rs file than we need for now. You may ignore them, we'll come back to them later. :::Bây giờ, hãy nhanh chóng di chuyển đến file lib.rs và làm cho các function chúng ta vừa tạo có thể invoke trong các file khác. Chúng ta sẽ thêm các internal crate và sửa đổi file như được hiển thị bên dưới:
Loading...
Tại thời điểm này, tất cả logic cốt lõi đã sẵn sàng để bạn có thể mint các NFT. Bạn có thể dùng function nft_mint, với các parameter sau:
- token_id: ID của token mà bạn đang mint (kiểu string).
- metadata: metadata cho token mà bạn đang mint (kiểu
TokenMetadata, có thể được tìm thấy trong filemetadata.rs). - receiver_id: chỉ định ai sẽ là owner của token.
Phía đằng sau, function này sẽ:
- Tính toán storage ban đầu trước khi thêm bất kỳ thứ gì vào contract
- Tạo một object
Tokenvới owner ID - Liên kết token ID với object token mới được tạo ra, b ằng cách chèn chúng vào trường
tokens_by_id. - Liên kết token ID với metadata được pass vào, bằng cách chèn chúng vào trường
token_metadata_by_id. - Thêm token ID vào danh sách các token mà owner sở hữu bằng cách gọi function
internal_add_token_to_owner. - Tính toán net storage cuối cùng để đảm bảo rằng người dùng đã gắn đủ NEAR vào lệnh call để trang trải các chi phí đó.
Query thông tin token
Nếu bạn tiếp tục và triển khai hợp đồng này, khởi tạo nó và mint NFT, bạn sẽ không có cách nào để biết hoặc query thông tin về token bạn vừa mint ra. Hãy nhanh chóng thêm một cách để query thông tin của một NFT cụ thể. You'll move to the nft-contract-skeleton/src/nft_core.rs file and edit the nft_token function.
Nó sẽ lấy token ID làm tham số và trả về thông tin cho token đó. JsonToken chứa token ID, owner ID, và metadata của token.
Loading...
Sau khi hoàn thành, cuối cùng cũng đã đến lúc build và deploy contract để bạn có thể mint NFT đầu tiên của mình.
Tương tác với on-chain contract
Bây giờ logic để mint đã hoàn tất và bạn đã thêm một cách để query thông tin về các token cụ thể, đã đến lúc build và deploy contract của bạn lên blockchain.
Deploy một contract
Để deploy, bạn cần một account NEAR với các key chứa sẵn trong local machine của bạn. Navigate to the NEAR wallet site and create an account.
Hãy đảm bảo rằng bạn deploy contract cho một account không có contract nào tồn tại từ trước. Cách đơn giản nhất là chỉ cần tạo một account mới hoặc tạo một account phụ cho hướng dẫn này.
Log in to your newly created account with near-cli-rs by running the following command in your terminal.
near account import-account using-web-wallet network-config testnet
Để làm cho hướng dẫn này dễ dàng hơn với copy/paste, chúng tôi đã set một biến môi trường cho account ID của bạn. Trong command dưới đây, thay YOUR_ACCOUNT_NAME với account name bạn vừa đăng nhập, bao gồm phần .testnet:
export NFT_CONTRACT_ID="YOUR_ACCOUNT_NAME"
Kiểm tra biến môi trường được cài đặt đúng hay chưa bằng cách chạy:
echo $NFT_CONTRACT_ID
Hãy xác nhận rằng account được in ra trong terminal là chính xác. Nếu mọi thứ đều đúng, thì bây giờ bạn có thể deploy contract của bạn. In the root of your NFT project run the following command to deploy your smart contract and answer questions:
cargo near deploy $NFT_CONTRACT_ID
> Select the need for initialization: with-init-call - Add an initialize
> What is the name of the function? new_default_meta
> How would you like to pass the function arguments? json-args
> Enter the arguments to this function: {"owner_id": "<YOUR_NFT_CONTRACT_ID>"}
> Enter gas for function call: 100 TeraGas
> Enter deposit for a function call (example: 10NEAR or 0.5near or 10000yoctonear): 0 NEAR
> What is the name of the network? testnet
> Select a tool for signing the transaction: sign-with-keychain
> How would you like to proceed? send
You don't need to answer these questions every time. If you look at the results you will find the message Here is the console command if you ever need to re-run it again. The next line is the command which you may use instead of answering to interactive questions:
cargo near deploy $NFT_CONTRACT_ID with-init-call new_default_meta json-args '{"owner_id": "'$NFT_CONTRACT_ID'"}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' network-config testnet sign-with-keychain send
You've just deployed and initialized the contract with some default metadata and set your account ID as the owner. Giờ đây, bạn đã sẵn sàng để gọi view function đầu tiên của mình.
Xem metadata của contract
Bây giờ contract đã được init, bạn có thể call một số function mà bạn đã viết trước đó. Cụ thể hơn, hãy test function trả về metadata của contract:
near contract call-function as-read-only $NFT_CONTRACT_ID nft_metadata json-args {} network-config testnet now
Nó sẽ trả về một output trong giống như sau:
{
spec: 'nft-1.0.0',
name: 'NFT Tutorial Contract',
symbol: 'GOTEAM',
icon: null,
base_uri: null,
reference: null,
reference_hash: null
}
Tại thời điểm này, bạn đã sẵn sàng để tiếp tục và mint NFT đầu tiên của mình.
Mint NFT đầu tiên của chúng ta
Nào hãy call function dùng để mint mà bạn đã tạo trước đó. Function này cần một token_id và metadata. Nếu bạn nhìn lại struct TokenMetadata mà bạn đã tạo trước đó, có nhiều trường có thể được lưu trữ on-chain:
Loading...
Hãy bắt đầu mint một NFT với một title, description, và media. Trường media có thể là bất kỳ URL nào trỏ đến một file media. Chúng ta có một file GIF tuyệt vời để mint nhưng nếu bạn muốn tạo một NFT tùy chỉnh, chỉ cần thay thế media link của chúng ta bằng một trong những lựa chọn của bạn. Nếu bạn chạy lệnh sau, nó sẽ mint ra một NFT với các tham số sau:
- token_id: "token-1"
- metadata:
- title: "My Non Fungible Team Token"
- description: "The Team Most Certainly Goes :)"
- media:
https://bafybeiftczwrtyr3k7a2k4vutd3amkwsmaqyhrdzlhvpt33dyjivufqusq.ipfs.dweb.link/goteam-gif.gif - receiver_id: "'$NFT_CONTRACT_ID'"
near contract call-function as-transaction $NFT_CONTRACT_ID nft_mint json-args '{"token_id": "token-1", "metadata": {"title": "My Non Fungible Team Token", "description": "The Team Most Certainly Goes :)", "media": "https://bafybeiftczwrtyr3k7a2k4vutd3amkwsmaqyhrdzlhvpt33dyjivufqusq.ipfs.dweb.link/goteam-gif.gif"}, "receiver_id": "'$NFT_CONTRACT_ID'"}' prepaid-gas '100.0 Tgas' attached-deposit '0.1 NEAR' sign-as $NFT_CONTRACT_ID network-config testnet sign-with-legacy-keychain send
amount đang chỉ định bao nhiêu NEAR để đính kèm vào call. Do bạn cần phải trả tiền cho storage, 0,1 NEAR sẽ được đính kèm và cuối cùng bạn sẽ được hoàn lại khoản tiền thừa chưa được sử dụng. :::Xem thông tin của NFT
Bây giờ NFT đã được mint, bạn có thể kiểm tra và xem mọi thứ có diễn ra chính xác hay không bằng cách gọi function nft_token. Nó sẽ trả về một JsonToken, trong đó chứa token_id, owner_id, và metadata.
near contract call-function as-read-only $NFT_CONTRACT_ID nft_token json-args '{"token_id": "token-1"}' network-config testnet now
Các kết quả cuối cùng của transaction có thể được query qua Transaction Status hoặc NEAR Explorer bằng cách sử dụng kết quả hash được trả về như ví dụ sau đây.
{
token_id: 'token-1',
owner_id: 'goteam.examples.testnet',
metadata: {
title: 'My Non Fungible Team Token',
description: 'The Team Most Certainly Goes :)',
media: 'https://bafybeiftczwrtyr3k7a2k4vutd3amkwsmaqyhrdzlhvpt33dyjivufqusq.ipfs.dweb.link/goteam-gif.gif',
media_hash: null,
copies: null,
issued_at: null,
expires_at: null,
starts_at: null,
updated_at: null,
extra: null,
reference: null,
reference_hash: null
}
}
Chúc mừng! Bây giờ bạn đã xác minh được rằng mọi thứ đã hoạt động chính xác và đã đến lúc xem NFT mới mint của bạn trong tab collectibles của NEAR wallet!
Xem NFT của bạn trong wallet
If you navigate to the collectibles tab in the NEAR wallet, this should list all the NFTs that you own. Nó sẽ trông giống như bên dưới đây.
Chúng ta có một vấn đề. Wallet đã biết chính xác rằng bạn đã mint ra một NFT, tuy nhiên, contract không implement view function cụ thể đang được call. Phía đằng sau, wallet đang cố gắng call nft_tokens_for_owner để lấy danh sách tất cả các NFT của bạn trên contract. Tuy nhiên, function duy nhất mà bạn đã tạo ra, chính là function nft_token. Sẽ không hiệu quả lắm nếu wallet call nft_token cho mỗi NFT đơn lẻ mà người dùng phải lấy thông tin và vì vậy chúng cố gắng call function nft_tokens_for_owner.
Trong hướng dẫn tiếp theo, bạn sẽ tìm hiểu về cách deploy bản sửa lỗi cho một contract đã có từ trước để bạn có thể xem NFT trong wallet.
Kết luận
Trong hướng dẫn này, bạn đã trải qua những điều cơ bản về thiết lập và hiểu logic đằng sau việc mint NFT trên blockchain bằng cách sử dụng một skeleton contract.
Đầu tiên, bạn đã xem ý nghĩa của việc mint NFT và cách chia vấn đề thành nhiều phần nhỏ khả thi hơn. Sau đó, bạn bắt đầu sửa đổi skeleton contract theo từng phân đoạn bắt đầu bằng việc giải quyết vấn đề của storing information / state trên contract. Sau đó, bạn xem những gì cần đưa vào metadata và thông tin token. Cuối cùng, bạn đã xem xét logic cần thiết để mint các NFT.
Sau khi contract được viết, đã đến lúc deploy vào blockchain. Bạn đã deploy contract và init nó. Cuối cùng, bạn đã mint NFT đầu tiên của mình và thấy rằng cần thay đổi một ít trước khi bạn có thể thấy nó trong wallet.
Các bước tiếp theo
In the next tutorial, you'll find out how to deploy a patch fix and what that means so that you can view your NFTs in the wallet.
