Ethers极简入门: 12. 识别ERC721合约
我最近在重新学ethers.js
,巩固一下细节,也写一个WTF Ethers极简入门
,供小白们使用。
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
函数,并且当查询0x80ac58cd
(ERC721
接口id)时返回true
。
function supportsInterface(bytes4 interfaceId)
external
pure
override
returns (bool)
{
return
interfaceId == type(IERC721).interfaceId
}
识别ERC721
创建
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.JsonRpcProvider(ALCHEMY_MAINNET_URL);创建
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)读取合约的链上信息:名称和代号。
// 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}`)利用
ERC165
的supportsInterface()
函数,识别合约是否为ERC721标准。如果是,则返回true
;反之,则报错或返回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}`)
总结
这一讲,我们介绍如何ethers.js
来识别一个合约是否为ERC721
。由于利用了ERC165
标准,因此只有支持ERC165
标准的合约才能用这个方法识别,包括ERC721
,ERC1155
等。但是像ERC20
这种不支持ERC165
的标准,就要用别的方法识别了。你知道怎么检查一个合约是否为ERC20
吗?