header-langage
简体中文
繁體中文
English
Tiếng Việt
한국어
日本語
ภาษาไทย
Türkçe
掃碼下載APP
Partnered With:

Solidity極簡入門 | ERC721專題第二講:ERC721相關接口

閱讀本文需 1 分鐘
介紹ERC721主合約調用的4個接口合約IERC165,IERC721,IERC721Receiver和IERC721Metadata。
原文標題:《Solidity 極簡入門 ERC721 專題:2. ERC721 相關接口》
原文來源: 0xAA


我最近在重新學 solidity,鞏固一下細節,也寫一個「Solidity 極簡入門」,供小白們使用(編程大佬可以另找教程),每週更新 1-3 講。


不知不覺我已經完成了 Solidity 極簡教程的前 13 講(基礎),內容包括:Helloworld.sol,變量類型,存儲位置,函數,控制流,構造函數,修飾器,事件,繼承,抽象合約,接口,庫,異常。在進階內容之前,我決定做一個 ERC721 的專題,把之前的內容綜合運用,幫助大家更好的複習基礎知識,並且更深刻的理解 ERC721 合約。希望在學習完這個專題之後,每個人都能發行自己的 NFT。本文爲該系列第二講,第一講爲:《Solidity 極簡入門 | ERC721 專題第一講:合約概覽與相關庫》


ERC721 相關接口


ERC721 的主合約一共引用了 4 個接口合約:IERC721.sol, IERC721Receiver.sol, IERC721Metadata.sol,和間接引用的 ERC165 的 IERC165.sol。這一講我們將逐個介紹這 4 個接口合約。


IERC165 接口


首先我們介紹一下 EIP165(以太坊改進建議第 165 條),他的目的是創建一個標準方法來發布和檢測智能合約實現的接口。講一個去年年底發生的真實事件,PeopleDAO 有個朋友錯轉了 4000w 枚 PEOPLE 到 Token 合約。但合約沒有實現轉出 Token 的功能,只能進不能出,這些 Token 直接鎖死在裏面銷燬了。試想一下,如果在轉賬的時候自動判斷接收方合約是否實現了相應的接口,沒實現的話就 revert 交易,很多錯轉 Token 的悲劇都不會發生。EIP165 就是幹這個的,而 ERC165 就是 EIP165 的實現。


IERC165 是 ERC165 的接口合約,只有一個函數 supportsInterface(),輸入想查詢的接口的 interfaceId,返回一個 bool 告訴你合約是否實現了該接口。



ERC721 主合約對 supportsInterface() 的實現如下:


可以看到,ERC721 實現了 IERC721,IERC721Metadata 和 IERC165 的接口,查詢的時候會返回 true;否則返回 false。我會在進階內容中更詳細的介紹 function selector 和 interfaceId。


IERC721


IERC721 是 ERC721 的接口合約,裏面包括 3 個 event 和 9 個 function:  



其中 event 包括:


1、Transfer 事件:在轉賬時被釋放,記錄 Token 的發出地址 from,接收地址 to 和 tokenid。


2、Approval 事件:在授權時釋放,記錄 approve 的發出地址 owner,被授權地址 approved 和 tokenid。


3、ApprovalForAll 事件:在批量授權時釋放,記錄 approve 的發出地址 owner,被授權地址 operator 和是否被授權 approved。


其中 function 包括:


1、balanceOf:參數爲要查詢的地 address,返回該地址的 NFT 持有量 balance。


2、ownerOf:參數爲要查詢的 tokenId,返回這個 tokenId 的主人 owner。


3、safeTransferFrom:安全轉賬(如果接收方是合約地址,會要求實現 ERC721 的接收接口)。參數爲轉出地址 from,接收地址 to 和 tokenId。


4、transferFrom:普通轉賬(不檢查對方是否實現 ERC721 的接收接口),參數爲轉出地址 from,接收地址 to 和 tokenId。


5、approve:授權,批准另一個地址使用你的 NFT。參數爲被授權地址 approve 和 tokenId。


6、getApproved:查詢 NFT 被批准給了哪個地址,參數爲 tokenId,返回被批准的地址 approve。


7、setApprovalForAll:將自己持有的這類 NFT 批量授權給某個地址,參數爲被授權的地址 operator 和是否授權 approved。


8、isApprovedForAll:查詢某人的 NFT 是否批量授權給了某個地址,參數爲授權方 owner 和被授權地址 operator,返回 bool。


9、safeTransferFrom:安全轉賬,與 3. 不同的地方在於參數裏面包含了 data,可以做額外處理。


IERC721Receiver  



IERC721Receiver 接口包含了一個函數 onERC721Received()。這個函數會在 safeTransferFrom() 中被調用,Token 的接收合約必須實現這個接口才能轉賬成功。


IERC721Metadata  



IERC721Metadata 是 ERC721 的拓展接口,實現了 3 個查詢 metadata 的常用函數:


1、name():返回 Token 名稱;

2、symbol():返回 Token 代號;

3、tokenURI():通過 tokenId 查詢 metadata 所在 url。


總結


本文是 ERC721 專題的第二講,我們介紹了 ERC721 主合約調用的 4 個接口合約 IERC165,IERC721,IERC721Receiver 和 IERC721Metadata。下一講終於該介紹 ERC721 主合約了!LFG!


原文鏈接


歡迎加入律動 BlockBeats 官方社群:

Telegram 訂閱群:https://t.me/theblockbeats

Telegram 交流群:https://t.me/BlockBeats_App

Twitter 官方帳號:https://twitter.com/BlockBeatsAsia

举报 糾錯/舉報
選擇文庫
新增文庫
取消
完成
新增文庫
僅自己可見
公開
保存
糾錯/舉報
提交