Core
In this tutorial you'll learn how to implement the core standards into your smart contract. Nếu bạn tham gia với chúng tôi lần đầu, đừng ngại clone repo này và checkout branch 3.enumeration để theo dõi.
git checkout 3.enumeration
4.core branch. :::Giới thiệu
Up until this point, you've created a simple NFT smart contract that allows users to mint tokens and view information using the enumeration standards. Hôm nay, bạn sẽ mở rộng smart contract của mình để cho phép các user không chỉ mint token mà còn transfer chúng.
Như chúng ta đã thực hiện trong hướng dẫn mint, hãy chia nhỏ vấn đề thành nhiều các subtask để dễ giải quyết hơn. Khi một token được mint, thông tin được lưu trữ ở 3 nơi:
- tokens_per_owner: tập các token cho mỗi account.
- tokens_by_id: map một token ID với một
Tokenobject. - token_metadata_by_id: map một token ID với metadata của nó.
Bây giờ hãy xem xét tình huống sau đây. Nếu Benji là người sở hữu token A và muốn chuyển nó cho Mike như một món quà sinh nhật, điều gì sẽ xảy ra? Đầu tiên, token A sẽ bị xóa khỏi tập các token của Benji và được thêm vào tập các token của Mike.
Nếu đó chỉ là logic bạn thực hiện, bạn sẽ gặp một số vấn đề. Nếu bạn thực hiện một view call để truy vấn thông tin về token đó sau khi nó đã được chuyển cho Mike, nó sẽ vẫn trả về kết quả rằng Benji là chủ sở hữu.
Điều này là do contract vẫn đang map token ID với Token object cũ, object đó có field owner_id là account ID của Benji. Bạn vẫn phải thay đổi cấu trúc data của tokens_by_id, vì thế token ID map với một Token object mới mà Mike sở hữu.
Với những gì đã nói, quy trình cuối cùng khi chủ sở hữu chuyển token tới người nhận sẽ như sau:
- Xóa token khỏi tập token của chủ sở hữu.
- Thêm token tới tập token của người nhận.
- Map token ID tới một
Tokenobject mới chứa chính xác thông tin chủ sở hữu.
token_metadata_by_id. Điều này là do bất kể ai sở hữu token, token ID sẽ luôn map tới cùng một metadata. Metadata sẽ không bao giờ thay đổi và vì vậy chúng ta có thể để nó một mình (không map với một token Id nào cả). :::Tại thời điểm này, bạn đã sẵn sàng để tiếp tục và tạo những sửa đổi quan trọng với smart contract của mình.
Các sửa đổi với contract
Hãy bắt đầu hành trình của chúng ta trong nft-contract/src/nft_core.rs file.
Transfer function
You'll start by implementing the nft_transfer logic. Function này sẽ chuyển token_id được chỉ định tới receiver_id với một tuỳ chọn memo ví dụ như "Happy Birthday Mike!".
loading...
There are a couple things to notice here. Firstly, we've introduced a new function called assert_one_yocto(). This method will ensure that the user has attached exactly one yoctoNEAR to the call. If a function requires a deposit, you need a full access key to sign that transaction. By adding the one yoctoNEAR deposit requirement, you're essentially forcing the user to sign the transaction with a full access key.
Since the transfer function is potentially transferring very valuable assets, you'll want to make sure that whoever is calling the function has a full access key.
Secondly, we've introduced an internal_transfer method. This will perform all the logic necessary to transfer an NFT.
Các internal helper function
Let's quickly move over to the nft-contract/src/internal.rs file so that you can implement the assert_one_yocto() and internal_transfer methods.
Let's start with the easier one, assert_one_yocto().
assert_one_yocto
You can put this function anywhere in the internal.rs file but in our case, we'll put it after the hash_account_id function:
loading...
internal_transfer
Bây giờ là lúc để tiến hành function internal_transfer, nó là cốt lõi của hướng dẫn này. Function này sẽ nhận các tham số sau:
- sender_id: account đang cố gắng chuyển token.
- receiver_id: account nhận token.
- token_id: token ID đang được chuyển.
- memo: một tùy chọn memo kèm theo.
Điều đầu tiên bạn cần làm là đảo bảo rằng người gửi được ủy quyền để chuyển token. Trong trường hợp này, bạn chỉ cần đảm bảo rằng người gửi là chủ sở hữu của token. Bạn sẽ làm điều đó bằng cách lấy Token object sử dụng token_id và đảm bảo rằng người gửi giống với owner_id của token.
Thứ hai, bạn sẽ xóa token ID từ danh sách token của người gửi và thêm token ID vào danh sách token của người nhận. Cuối cùng, bạn sẽ tạo một Token object mới với chủ sở hữu là người nhận và map lại token ID tới nó.
Bạn sẽ muốn tạo function này trong quá trình thực hiện contract (dưới internal_add_token_to_owner bạn đã tạo trong bài hướng dẫn mint).
loading...
Phía trên, bạn đã triển khai function để thêm token ID tới một tập các token của chủ sở hữu nhưng bạn chưa tạo một function để xóa một token ID từ một tập các token. Hãy làm điều đó bây giờ bằng cách tạo một function mới gọi là internal_remove_token_from_owner, chúng ta sẽ đặt ngay trên function internal_transfer và dưới internal_add_token_to_owner.
Trong remove function này, bạn sẽ lấy tập các token của một account ID và sau đó remove token ID đã truyền vào. Nếu tập token của account là rỗng sau khi xóa, bạn sẽ xóa account khỏi cấu trúc dữ liệu tokens_per_owner.
loading...
Bây giờ, file internal.rs của bạn sẽ có outline như dưới đây:
internal.rs
├── hash_account_id
├── assert_one_yocto
├── refund_deposit
└── impl Contract
├── internal_add_token_to_owner
├── internal_remove_token_from_owner
└── internal_transfer
Với việc hoàn thành những internal function này, logic cho việc transfer các NFT đã xong. Bây giờ là lúc để tiếp tục và tiến hành nft_transfer_call, một trong những hàm tích phân phức tạp nhất trong các standard function.
Transfer call function
Hãy xem xét kịch bản sau đây. Một account muốn transfer một NFT sang một smart contract để thực hiện một dịch vụ. Cách tiếp cận truyền thống là sẽ sử dụng một hệ thống approval management, trong đó contract được cấp khả năng để transfer NFT tới chính nó sau khi hoàn thành. Bạn có thể tìm hiểu về hệ thống approval management này trong phần các approval của serie hướng dẫn.
Workflow này cần nhiều transaction. Nếu chúng ta giới thiệu “transfer and call” workflow bằng một transaction duy nhất, quy trình này có thể được cải thiện rất nhiều.
Vì lý do này, chúng ta có một function là nft_transfer_call, nó sẽ transfer một NFT tới một người nhận và cũng call một method trên contract của người nhận trong cùng một transaction.
loading...
Trước tiên, function sẽ xác nhận rằng người gọi đã đính kèm chính xác 1 yocto cho mục đích bảo mật. Nó sau đó sẽ transfer NFT sử dụng internal_transfer và bắt đầu cross contract call. Nó sẽ call một method nft_on_transfer trên contract của receiver_id để trả về một promise. Sau khi promise k ết thúc, hàm nft_resolve_transfer được gọi. Đây là workflow rất phổ biến khi xử lý các cross contract call. Trước tiên, bạn bắt đầu khởi tạo call và đợi nó thực hiện xong. Sau đó bạn gọi một function xử lý kết quả của promise và hành động phù hợp.
Trong trường hợp cùa chúng ta, khi call nft_on_transfer, function đó sẽ trả về một giá trị boolean để cho biết bạn có nên trả lại NFT cho chủ sở hữu ban đầu của nó hay không. Logic này sẽ được thực thi trong hàm nft_resolve_transfer.
loading...
Nếu nft_on_transfer trả về true, bạn sẽ gửi token trở lại cho người sở hữu ban đầu của nó. Ngược lại, nếu trả về false thì không cần thêm logic nào cả. Đối với giá trị trả về của nft_resolve_transfer, hàm này phải trả về một giá trị boolean theo tiêu chuẩn quy định để cho biết người nhận có nhận thành công token hay không.
Điều này có nghĩa là nếu nft_on_transfer trả về true, bạn nên trả về false. Bởi vì nếu token đang được trả lại cho chủ sở hữu ban đầu của nó, thì cuối cùng receiver_id đã không nhận được thành công token. Ngược lại, nếu nft_on_transfer trả về false, bạn nên trả về true vì chúng ta không cần trả về token và do đó receiver_id sở hữu thành công token.
Với việc hoàn thành điều đó, bạn đã thêm thành công logic cần thiết để cho phép người dùng transfer các NFT. Bây giờ là lúc deploy và thực hiện một vài bài test.
Redeploy contract
Sử dụng build script, build và deploy contract giống như bạn đã làm trong các hướng dẫn trước:
yarn build && near deploy $NFT_CONTRACT_ID out/main.wasm
Lúc này sẽ có một cảnh báo nói rằng tài khoản đã có một contract đã được deploy và sẽ hỏi bạn có muốn tiếp tục hay không. Đơn giản hãy gõ y và ấn enter.
This account already has a deployed contract [ AKJK7sCysrWrFZ976YVBnm6yzmJuKLzdAyssfzK9yLsa ]. Do you want to proceed? (y/n)
near login. Bạn có thể export một biến môi trường export NFT_CONTRACT_ID=YOUR_ACCOUNT_ID_HERE. :::Test các thay đổi mới
Bây giờ thì bạn đã deploy một bản vá lỗi cho contract, đã đến lúc để chuyển sang giai đoạn test. Sử dụng NFT contract trước đó mà bạn đã đã mint token cho chính mình, bạn có thể test method nft_transfer. Nếu bạn transfer NFT, nó sẽ bị xoá khỏi các bộ sưu tập trong account của bạn được hiển thị ở wallet. Ngoài ra, nếu bạn truy vấn bất kỳ enumeration function nào, nó sẽ cho thấy rằng bạn không còn là chủ sở hữu nữa.
Hãy test điều này bằng cách transfer một NFT tới account benjiman.testnet và xem NFT có còn thuộc quyền sở hữu của bạn hay không.
Test transfer function
benjiman.testnet transfer nó lại cho bạn. Nếu bạn không muốn NFT của mình bị mất, tạo một account mới và transfer token tới account đó. :::Nếu bạn chạy command sau, nó sẽ transfer token "token-1" tới account benjiman.testnet với memo "Go Team :)". Hãy lưu ý rằng bạn cũng đang đính kèm chính xác 1 yoctoNEAR bằng cách sử dụng --depositYocto flag.
token-1 với token ID của bạn. :::near call $NFT_CONTRACT_ID nft_transfer '{"receiver_id": "benjiman.testnet", "token_id": "token-1", "memo": "Go Team :)"}' --accountId $NFT_CONTRACT_ID --depositYocto 1
Nếu bây giờ bạn truy vấn tất cả các token mà account bạn sở hữu, token đó sẽ bị thiếu. Tương tự, nếu bạn truy vấn danh sách các token được sở hữu bởi benjiman.testnet, account đó bây giờ sẽ sở hữu NFT của bạn.
Test transfer call function
Bây giờ thì bạn đã test nft_transfer function, đến lúc để test nft_transfer_call function. Nếu bạn cố gắng transfer một NFT tới một người nhận không tiến hành nft_on_transfer function, contract sẽ panic và NFT sẽ không được transfer. Hãy test chức năng này bên dưới.
Đầu tiên mint một NFT mới sẽ được sử dụng để test chức năng transfer call.
near call $NFT_CONTRACT_ID nft_mint '{"token_id": "token-2", "metadata": {"title": "NFT Tutorial Token", "description": "Testing the transfer call function", "media": "https://bafybeiftczwrtyr3k7a2k4vutd3amkwsmaqyhrdzlhvpt33dyjivufqusq.ipfs.dweb.link/goteam-gif.gif"}, "receiver_id": "'$NFT_CONTRACT_ID'"}' --accountId $NFT_CONTRACT_ID --amount 0.1
Bây giờ thì bạn đã mint token, bạn có thể thử transfer NFT tới account no-contract.testnet, account này không có contract nào giống như tên của nó đã cho thấy. Điều này có nghĩa rằng người nhận không tiến hành nft_on_transfer function và NFT sẽ vẫn là của bạn sau khi transaction hoàn thành.
near call $NFT_CONTRACT_ID nft_transfer_call '{"receiver_id": "no-contract.testnet", "token_id": "token-2", "msg": "foo"}' --accountId $NFT_CONTRACT_ID --depositYocto 1 --gas 200000000000000
Nếu bạn truy vấn các token của mình, bạn sẽ vẫn có token-2 và tại thời điểm này, bạn đã hoàn thành!
Tổng kết
Trong bài hướng dẫn này, bạn đã học cách làm thế nào để mở rộng một NFT contract thông qua mint function và bạn đã biết thêm cách để người dùng transfer các NFT. Bạn đã chia nhỏ vấn đề thành các vấn đề bé hơn, nhiều subtask dễ xử lý hơn và lấy thông tin đó để triển khai cả hai function là NFT transfer và NFT transfer call. Ngoài ra, bạn đã deploy bản vá lỗi khác tới smart contract của mình và đã test chức năng transfer.
In the next tutorial, you'll learn about the approval management system and how you can approve others to transfer tokens on your behalf.
