Nhảy đến nội dung chính

Marketplace

Trong hướng dẫn này, bạn sẽ tìm hiểu những điều cơ bản của một NFT marketplace contract, nơi bạn có thể mua và bán các non-fungible token bằng $NEAR. Trong những hướng dẫn trước, bạn đã đi qua và tạo một NFT contract hoàn chỉnh đầy đủ kết hợp tất cả các tiêu chuẩn có trong tiêu chuẩn NFT.

Giới thiệu​

Thông qua hướng dẫn này, bạn sẽ học cách một marketplace contract sẽ làm việc trên NEAR. Đây được xem là một ví dụ và không có triển khai chính tắc nào. Vui lòng tách branch và sửa đổi contract này để đáp ứng nhu cầu cụ thể của bạn.

Sử dụng cùng repository giống như các hướng dẫn trước, nếu bạn checkout branch 8.marketplace, bạn sẽ có những file cần thiết để hoàn thành hướng dẫn này.

git checkout 8.marketplace

Cấu trúc file​

Những thay đổi được tạo ra bao gồm một thư mục gốc mới gọi là market-contract. Nó chứa cả build script, các dependency cũng như các contract code thực tế được phác thảo bên dưới đây.

market-contract
├── Cargo.lock
├── Cargo.toml
├── README.md
├── build.sh
└── src
    ├── external.rs
    ├── internal.rs
    ├── lib.rs
    ├── nft_callbacks.rs
    ├── sale.rs
    └── sale_views.rs

Thông thường, khi làm việc trên nhiều smart contract mà tất cả điều liên quan đến cùng một repository, một ý tưởng hay là cấu trúc chúng trong các thư mục riêng giống như đã được thực hiện trong hướng dẫn này. Để giúp công việc của bạn dễ hơn khi build các smart contract, chúng tôi đã sửa file package.json của repository, do vậy build cả hai smart contract có thể dễ dàng thực hiện bằng cách chạy command bên dưới.

yarn build

Nó sẽ cài đặt các dependency cho cả hai contract và compile chúng thành các file wasm được lưu trữ trong các thư mục dưới đây.

nft-tutorial
└── out
    ├── main.wasm
    └── market.wasm

Hiểu về contract​

Lúc đầu, contract có thể khá choáng ngợp nhưng nếu bạn loại bỏ tất cả các thứ không cần thiết và đào sâu vào các function cốt lõi, nó thực sự khá đơn giản. Contract này đã được thiết kế chỉ cho một điều duy nhất - cho phép mọi người mua và bán các NFT cho NEAR. Nó bao gồm việc hỗ trợ thanh toán royalty, cập nhật giá bán của bạn, loại bỏ sale và thanh toán cho storage.

Hãy xem qua các file, ghi chú lại một số function quan trọng và chức năng của chúng là gì.

lib.rs​

File này phác thảo thông tin nào được lưu trữ trên contract cũng như một số function quan trọng khác mà bạn sẽ tìm hiểu bên dưới.

Initialization function​

Function đầu tiên bạn sẽ xem là initialization function. Nó lấy một owner_id làm tham số duy nhất và sẽ mặc định tất cả các storage collection bằng giá trị mặc định của chúng.

market-contract/src/lib.rs
loading...

Model quản lý storage​

Next, let's talk about the storage management model chosen for this contract. On the NFT contract, users attached $NEAR to the calls that needed storage paid for. For example, if someone was minting an NFT, they would need to attach x amount of NEAR to cover the cost of storing the data on the contract.

On this marketplace contract, however, the storage model is a bit different. Users will need to deposit $NEAR onto the marketplace to cover the storage costs. Whenever someone puts an NFT for sale, the marketplace needs to store that information which costs $NEAR. Users can either deposit as much NEAR as they want so that they never have to worry about storage again or they can deposit the minimum amount to cover 1 sale on an as-needed basis.

You might be thinking about the scenario when a sale is purchased. What happens to the storage that is now being released on the contract? This is why we've introduced a storage withdrawal function. This allows users to withdraw any excess storage that is not being used. Let's go through some scenarios to understand the logic. The required storage for 1 sale is 0.01 NEAR on the marketplace contract.

Scenario A

  • Benji muốn đưa NFT lên marketplace nhưng anh ấy chưa bao giờ trả tiền cho storage.
  • Anh ấy nạp chính xác 0.01 NEAR sử dụng method storage_deposit. Nó sẽ thanh toán cho 1 lần bán.
  • Anh ấy đưa NFT lên marketplace và bây giờ đang sử dụng hết 1 trong số 1 lần sale đã được thanh toán trước và không còn storage. Nếu anh ấy call storage_withdraw, sẽ không có gì xảy ra.
  • Dorian thích NFT của anh ấy và nhanh chóng mua nó trước bất cứ ai. Điều này có nghĩa rằng đơn hàng của Benji bây giờ đã bị gỡ xuống (kể từ khi nó được mua) và Benji đã sử dụng 0 trong số 1 lần sale đã thanh toán trước. Nói cách khác, anh ấy đang thừa 1 lần sale hay 0.01 NEAR.
  • Benji bây giờ có thể call storage_withdraw và sẽ được chuyển lại 0.01 NEAR cho anh ấy. Về phía contract, sau khi rút tiền, anh ấy sẽ có 0 lần sale được thanh toán sẽ cần phải nạp tiền storage trước khi niêm yết thêm NFT.

Scenario B

  • Dorian sở hữu một trăm NFT rất đẹp và anh ta muốn niêm yết toàn bộ.
  • Để tránh phải gọi storage_deposit mỗi khi muốn niêm yết một NFT, anh ấy sẽ gọi nó một lần. Vì Dorian là một người có tiền, anh đã đã đính kèm 10 NEAR đủ để thanh toán cho 1000 lần sale. Then he lists his 100 NFTs and now he has an excess of 9 NEAR or 900 sales.
  • Dorian cần 9 NEAR để để làm gì đó nhưng anh ấy không muốn gỡ 100 NFT đang niêm yết. Bởi vì anh ấy có thừa 9 NEAR, anh ấy có thể dễ dàng rút và vẫn có 100 NFT đang niêm yết. Sau khi call storage_withdraw và được chuyển 9 NEAR, anh ấy có 0 lần sale đang thừa.

With this behavior in mind, the following two functions outline the logic.

market-contract/src/lib.rs
loading...

Trong contract này, storage yêu cầu 0.01 NEAR cho mỗi lần sale nhưng bạn có thể truy vấn thông tin đó sử dụng function storage_minimum_balance. Ngoài ra, bạn có thể truy vấn function storage_balance_of để kiểm tra một tài khoản nào đó đã thanh toán bao nhiêu storage.

Không còn cách nào khác, đã đến lúc chuyển sang file nft_callbacks.rs, nơi bạn sẽ xem cách các NFT được bán.

nft_callbacks.rs​

File này chịu trách nhiệm về logic được sử dụng để bán các NFT. Nếu bạn nhớ phần marketplace của hướng dẫn approval, khi user gọi nft_approve và truyền vào một message, nó sẽ tiến hành một cross-contract call tới contract của receiver_id và gọi method nft_on_approve. File nft_callbacks.rs này sẽ triển khai function đó.

Logic niêm yết​

Điều quan trọng đầu tiên cần chú ý là cấu trúc SaleArgs. Đây là những gì market contract mong đợi message mà user truyền vào nft_approve trên NFT contract. Cấu trúc này phác thảo giá bán bằng yoctoNEAR cho NFT đã được niêm yết.

market-contract/src/nft_callbacks.rs
loading...

Tiếp theo, chúng ta hãy xem function nft_on_approve được gọi thông qua một cross-contract call bởi NFT contract. Việc này sẽ đảm bảo rằng người ký có đủ storage để trả thêm cho lần sale khác. Sau đó, nó sẽ cố gắng lấy SaleArgs từ message và tạo niêm yết.

market-contract/src/nft_callbacks.rs
loading...

sale.rs​

Bây giờ chúng ta đã quen với quy trình thêm storage và niêm yết các NFT trên marketplace, hãy xem những gì bạn có thể làm gì sau khi một sale đã được niêm yết. File sale.rs phác thảo các function cho việc cập nhật giá, xóa, và mua các NFT.

Sale object​

Điều quan trọng là phải hiểu contract đang lưu trữ thông tin gì của mỗi sale object. Bởi vì marketplace có nhiều NFT được niêm yết đến từ các NFT contract khác nhau, chỉ lưu trữ token ID sẽ không đủ để phân biệt giữa các NFT khác nhau. Đây là lý do bạn cần theo dõi cả token ID và contract mà NFT đến từ đó. Ngoài ra, với mỗi niêm yết, contract phải theo dõi approval ID mà nó đã được cấp để transfer NFT. Cuối cùng, chủ sở hữu và các điều kiện sale là cần thiết.

market-contract/src/sale.rs
loading...

Xóa các sale​

Để xóa một niêm yết, chủ sở hữu phải call function remove_sale và truyền vào NFT contract cùng với token ID. Phía đằng sau, hàm này call function internal_remove_sale mà bạn có thể tìm thấy trong file internal.rs. Điều này sẽ yêu cầu một yoctoNEAR vì lý do bảo mật.

market-contract/src/sale.rs
loading...

Cập nhật giá​

Để cập nhật giá niêm yết của token, chủ sở hữu phải call function update_price và truyền vào contract, token ID, và giá mong muốn. Việc này sẽ lấy sale object, thay đổi các điều kiện sale và chèn nó trở lại. Vì lý do bảo mật, function này sẽ yêu cầu một yoctoNEAR.

market-contract/src/sale.rs
loading...

Mua các NFT​

Để mua các NFT, bạn phải call function offer. Nó nhận nft_contract_id và token_id làm tham số. Bạn phải đính kèm đúng lượng NEAR vào call này để thanh toán. Phía đằng sau, việc này sẽ đảm bảo khoản tiền gửi của bạn lớn hơn giá niêm yết và call một private method process_purchase sẽ thực hiện một cross-contract call tới NFT contract để gọi function nft_transfer_payout. This will transfer the NFT using the approval management standard that you learned about and it will return the Payout object which includes royalties.

Sau đó marketplace sẽ call resolve_purchase, nơi nó sẽ kiểm tra các payout object độc hại và sau đó nếu mọi thứ đều tốt, nó sẽ thanh toán cho đúng cho các account.

market-contract/src/sale.rs
loading...

sale_view.rs​

File cuối chúng ta sẽ xem qua là sale_view.rs. Đây là nơi một vài method enumeration được phác thảo. Nó cho phép user truy vấn các thông tin quan trọng liên quan đến sale.

Deployment​

Next, you'll deploy this contract to the network.

export MARKETPLACE_CONTRACT_ID=<accountId>
near create-account $MARKETPLACE_CONTRACT_ID --useFaucet

Using the build script, deploy the contract as you did in the previous tutorials:

near deploy $MARKETPLACE_CONTRACT_ID out/market.wasm

Initialization and minting​

Since this is a new contract, you'll need to initialize it. Use the following command to initialize the contract:

near call $MARKETPLACE_CONTRACT_ID new '{"owner_id": "'$MARKETPLACE_CONTRACT_ID'"}' --accountId $MARKETPLACE_CONTRACT_ID

Tổng lượng cung​

Để truy vấn cho tổng lượng cung của các NFT được niêm yết trên marketplace, bạn có thể call function get_supply_sales. Có thể xem ví dụ dưới đây.

near view $MARKETPLACE_CONTRACT_ID get_supply_sales

Tổng lượng cung bởi chủ sở hữu​

Để truy vấn tổng lượng cung của các NFT được niêm yết bởi một chủ sở hữu được chỉ định trên marketplace, bạn có thể call function get_supply_by_owner_id. Có thể xem ví dụ dưới đây.

near view $MARKETPLACE_CONTRACT_ID get_supply_by_owner_id '{"account_id": "benji.testnet"}'

Tổng lượng cung theo contract​

Để truy vấn tổng lượng cung các NFT thuộc về một contract chỉ định nào đó, bạn có thể call function get_supply_by_nft_contract_id. Có thể xem ví dụ dưới đây.

near view $MARKETPLACE_CONTRACT_ID get_supply_by_nft_contract_id '{"nft_contract_id": "fayyr-nft.testnet"}'

Truy vấn thông tin niêm yết​

Để truy vấn thông tin quan trọng của một niêm yết được chỉ định, bạn có thể call function get_sale. Nó yêu cầu bạn truyền vào nft_contract_token. Đây thực chất là định danh duy nhất cho việc sale trên market contract giống như đã giải thích trước đó. Định danh này bao gồm NFT contract, theo sau là một DELIMITER và sau nữa là token ID. Trong contract này, DELIMITER đơn giản là một dấu: . mà thôi. Dưới đây là một ví dụ về truy vấn này.

near view $MARKETPLACE_CONTRACT_ID get_sale '{"nft_contract_token": "fayyr-nft.testnet.token-42"}'

Ngoài ra, bạn có thể truy vấn thông tin về niêm yết được phân trang của một chủ sở hữu nhất định bằng cách gọi function get_sales_by_owner_id.

near view $MARKETPLACE_CONTRACT_ID get_sales_by_owner_id '{"account_id": "benji.testnet", "from_index": "5", "limit": 10}'

Cuối cùng, bạn có thể truy vấn thông tin về niêm yết được phân trang bắt đầu từ một NFT contract nhất định bằng cách gọi function get_sales_by_nft_contract_id.

near view $MARKETPLACE_CONTRACT_ID get_sales_by_nft_contract_id '{"nft_contract_id": "fayyr-nft.testnet", "from_index": "5", "limit": 10}'

Tổng kết​

Trong hướng dẫn này, bạn đã học về những thứ cơ bản của một marketplace contract và nó làm việc như thế nào. Bạn đã xem qua file lib.rs và đã tìm hiểu về initialization function, thêm nữa là storage management model.

Sau đó, bạn đã xem qua file nft_callbacks để hiểu cách niêm yết các NFT. Ngoài ra, bạn đã xem qua một số function quan trọng cần thiết sau khi bạn đã niêm yết một NFT. Nó bao gồm xóa sale, cập nhật giá, và mua các NFT.

Cuối cùng, bạn xem qua các enumaration method trong file sale_view. Chúng cho phép bạn truy vấn thông tin quan trọng được tìm thấy trên marketplace contract.

Bây giờ bạn đã có hiểu biết vững chắc về NFT và marketplace trên NEAR. Vui lòng tách branch và mở rộng những contract này để tạo bất kỳ ứng dụng thú vị nào bạn muốn. In the next tutorial, you'll learn how to take the existing NFT contract and optimize it to allow for:

  • Lazy Minting
  • Creating Collections
  • Allowlisting functionalities
  • Optimized Storage Models
Versioning for this article

At the time of this writing, this example works with the following versions:

  • near-cli: 4.0.4
  • NFT standard: NEP171, version 1.1.0
Was this page helpful?
Need some help? Chat with us or check our Dev Resources!
Twitter
Telegram
Discord
Zulip