NFT智能合约Burn函数写法规范探讨及标准实现示例请求

关于你提供的_burn实现的正确性 #

你贴的这个_burn实现只能算部分正确，并非NFT Burn的标准最佳实践。

OpenZeppelin的ERC721基类中，super._burn(tokenId)已经完成了核心销毁逻辑：

• 将该tokenId的所有者地址设为address(0)
• 扣除对应所有者的NFT余额
• 如果合约继承了ERC721Enumerable，还会把该tokenId从全局代币列表和所有者的代币列表中移除

你观察到“代币仍在交易平台显示”，原因通常是：

1. 合约未继承ERC721Enumerable，部分平台通过遍历tokenId的方式检测NFT存在性，当ownerOf(tokenId)返回address(0)时，仍会标记为“已销毁但存在”
2. 交易平台的元数据缓存机制，未及时同步tokenURI的删除结果

你的实现仅处理了URI的清理，但未覆盖自定义状态的完整清理，也没针对平台显示做优化。

不同场景的Burn函数实现示例 #

1. 标准ERC721（含Enumerable）的完整Burn实现

这是最常用的实现，覆盖核心销毁逻辑+自定义状态清理：

// 继承ERC721和ERC721Enumerable以支持枚举查询
contract MyNFT is ERC721, ERC721Enumerable {
    mapping(uint256 => string) private _tokenURIs;
    // 示例：自定义NFT属性映射
    mapping(uint256 => uint256) public tokenRarity;

    constructor() ERC721("MyNFT Collection", "MNFT") {}

    function _burn(uint256 tokenId) internal virtual override(ERC721, ERC721Enumerable) {
        // 优先调用父类_burn，执行核心销毁逻辑
        super._burn(tokenId);

        // 清理自定义URI存储
        if (bytes(_tokenURIs[tokenId]).length != 0) {
            delete _tokenURIs[tokenId];
        }

        // 清理自定义属性（如果有）
        delete tokenRarity[tokenId];
    }

    // 重写tokenURI以使用自定义存储
    function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
        require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
        return _tokenURIs[tokenId];
    }

    // 必须重写的Enumerable兼容函数
    function _beforeTokenTransfer(address from, address to, uint256 tokenId, uint256 batchSize)
        internal
        override(ERC721, ERC721Enumerable)
    {
        super._beforeTokenTransfer(from, to, tokenId, batchSize);
    }

    function supportsInterface(bytes4 interfaceId)
        public
        view
        override(ERC721, ERC721Enumerable)
        returns (bool)
    {
        return super.supportsInterface(interfaceId);
    }
}

2. 优化交易平台识别的Burn实现

如果想让平台更明确识别代币已销毁，可以添加辅助函数，并优化tokenURI返回：

// 在上述合约基础上添加：
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
    require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
    // 如果代币已销毁（所有者为0），返回特定的已销毁标识
    if (ownerOf(tokenId) == address(0)) {
        return "ipfs://Qm...（已销毁NFT的元数据URI）";
    }
    return _tokenURIs[tokenId];
}

// 公开函数供平台查询代币是否已销毁
function isBurned(uint256 tokenId) public view returns (bool) {
    return ownerOf(tokenId) == address(0);
}

3. ERC1155多代币的Burn实现

如果是ERC1155类型的NFT集合，Burn实现更简洁，支持单/批量销毁：

contract MyERC1155Collection is ERC1155 {
    constructor() ERC1155("https://your-api.com/tokens/{id}.json") {}

    // 单代币销毁
    function burn(address account, uint256 id, uint256 amount) public {
        // 校验调用者权限：必须是所有者或授权操作者
        require(msg.sender == account || isApprovedForAll(account, msg.sender), "ERC1155: caller not authorized");
        _burn(account, id, amount);
    }

    // 批量销毁
    function burnBatch(address account, uint256[] memory ids, uint256[] memory amounts) public {
        require(msg.sender == account || isApprovedForAll(account, msg.sender), "ERC1155: caller not authorized");
        _burnBatch(account, ids, amounts);
    }
}

核心总结 #

• 标准Burn必须优先调用父类的_burn方法，确保核心的所有者、余额、枚举逻辑被正确处理
• 额外需要清理所有与该tokenId关联的自定义状态（如URI、属性、角色映射等）
• 继承ERC721Enumerable能让交易平台更准确地识别已销毁的代币，避免显示残留

内容的提问来源于stack exchange，提问作者Terry Windwalker