跳到主要内容

Ethers极简入门: 12. 识别ERC721合约

我最近在重新学ethers.js,巩固一下细节,也写一个WTF Ethers极简入门,供小白们使用。

推特@0xAA_Science

WTF Academy社群: 官网 wtf.academy | WTF Solidity教程 | discord | 微信群申请

所有代码和教程开源在github: github.com/WTFAcademy/WTFEthers


这一讲,我们介绍如何用ether.js识别一个合约是否为ERC721标准。

ERC721

ERC721是以太坊上流行的非同质化代币(NFT)标准,如果对这个标准不熟悉,可以阅读WTF Solidity第34讲 ERC721。在做NFT相关产品时,我们需要筛选出符合ERC721标准的合约。例如Opensea,他会自动识别ERC721,并爬下它的名称、代号、metadata等数据用于展示。要识别ERC721,我们先要理解ERC165

ERC165

通过ERC165标准,智能合约可以声明它支持的接口,供其他合约检查。因此,我们可以通过ERC165来检查一个智能合约是不是支持了ERC721的接口。

IERC165接口合约只声明了一个supportsInterface函数,输入要查询的interfaceId接口id(类型为bytes4),若合约实现了该接口id,则返回true;反之,则返回false

interface IERC165 {
/**
* @dev 如果合约实现了查询的`interfaceId`,则返回true
* 规则详见:https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
*
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

ERC721合约中会实现IERC165接口合约的supportsInterface函数,并且当查询0x80ac58cdERC721接口id)时返回true

   function supportsInterface(bytes4 interfaceId)
external
pure
override
returns (bool)
{
return
interfaceId == type(IERC721).interfaceId
}

识别ERC721

  1. 创建provider,连接以太坊主网。

    //准备 alchemy API 可以参考https://github.com/AmazingAng/WTFSolidity/blob/main/Topics/Tools/TOOL04_Alchemy/readme.md 
    const ALCHEMY_MAINNET_URL = 'https://eth-mainnet.g.alchemy.com/v2/oKmOQKbneVkxgHZfibs-iFhIlIAl6HDN';
    const provider = new ethers.providers.JsonRpcProvider(ALCHEMY_MAINNET_URL);
  2. 创建ERC721合约实例,在abi接口中,我们声明要使用的name()symbol(),和supportsInterface()函数即可。这里我们用的BAYC的合约地址。

    // 合约abi
    const abiERC721 = [
    "function name() view returns (string)",
    "function symbol() view returns (string)",
    "function supportsInterface(bytes4) public view returns(bool)",
    ];
    // ERC721的合约地址,这里用的BAYC
    const addressBAYC = "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
    // 创建ERC721合约实例
    const contractERC721 = new ethers.Contract(addressBAYC, abiERC721, provider)
  3. 读取合约的链上信息:名称和代号。

    // 1. 读取ERC721合约的链上信息
    const nameERC721 = await contractERC721.name()
    const symbolERC721 = await contractERC721.symbol()
    console.log("\n1. 读取ERC721合约信息")
    console.log(`合约地址: ${addressBAYC}`)
    console.log(`名称: ${nameERC721}`)
    console.log(`代号: ${symbolERC721}`)

    读取合约名称和代好

  4. 利用ERC165supportsInterface()函数,识别合约是否为ERC721标准。如果是,则返回ture;反之,则报错或返回false

    注意此处的代码中的selectorERC721常量被提取出main函数

    // 2. 利用ERC165的supportsInterface,确定合约是否为ERC721标准
    // ERC721接口的ERC165 identifier
    const selectorERC721 = "0x80ac58cd"
    const isERC721 = await contractERC721.supportsInterface(selectorERC721)
    console.log("\n2. 利用ERC165的supportsInterface,确定合约是否为ERC721标准")
    console.log(`合约是否为ERC721标准: ${isERC721}`)

    识别ERC721

总结

这一讲,我们介绍如何ethers.js来识别一个合约是否为ERC721。由于利用了ERC165标准,因此只有支持ERC165标准的合约才能用这个方法识别,包括ERC721ERC1155等。但是像ERC20这种不支持ERC165的标准,就要用别的方法识别了。你知道怎么检查一个合约是否为ERC20吗?