4、ERC-721合约开发：OpenZeppelin库集成、铸造函数、元数据URI、合约部署脚本

好，咱们今天来聊聊ERC-721合约开发。说实话，这是整个NFT平台最核心的一环。你想想看，没有合约，你的NFT就是一张图片，没有任何价值锚定。我个人习惯把合约开发比作「给数字资产上户口」——你得先有一套标准流程，才能让每个NFT都有合法身份。

4.1 为什么选OpenZeppelin？

我记得刚入行那会儿，有个前辈跟我说：「写合约别自己造轮子，除非你想被黑客教做人。」这话我记到现在。OpenZeppelin就是那个帮你造好轮子的库。它把ERC-721标准里那些繁琐的接口、事件、安全校验都封装好了。

说白了，你只需要继承它的合约，然后填上自己的业务逻辑就行。我在项目中遇到过好几次，有人非要自己手写transferFrom函数，结果漏了授权检查，直接导致资产被盗。嗯，这种坑我踩过一次就再也不敢了。

4.2 集成OpenZeppelin库

怎么集成？其实就两步。第一步，安装依赖包。第二步，在合约里import。

// 安装
npm install @openzeppelin/contracts

// 合约中引入
import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/utils/Counters.sol";

这里有个小细节要注意：版本一定要匹配。我曾经因为用了OpenZeppelin 4.x的库，但Solidity编译器是0.8.0以下，结果编译直接报错。你想想看，排查了半天才发现是版本问题，多冤啊。

4.3 铸造函数怎么写？

铸造函数，说白了就是「造NFT」的函数。它的核心逻辑是：给一个地址，生成一个唯一的tokenId，然后把这个tokenId和地址绑定。

我个人习惯用Counters库来管理tokenId，这样能保证每个NFT的ID都是递增且唯一的。

contract MyNFT is ERC721, Ownable {
    using Counters for Counters.Counter;
    Counters.Counter private _tokenIdCounter;

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

    function safeMint(address to) public onlyOwner {
        uint256 tokenId = _tokenIdCounter.current();
        _tokenIdCounter.increment();
        _safeMint(to, tokenId);
    }
}

看到没？这里用了_safeMint而不是_mint。为什么？因为_safeMint会检查接收地址是不是合约，如果是合约，它会调用合约的onERC721Received方法，确保对方能正确处理NFT。我有个朋友就是用了_mint，结果NFT打到了一个不支持ERC-721的合约里，直接锁死了。嗯，这种教训太深刻了。

4.4 元数据URI

元数据URI，说白了就是NFT的「身份证信息」。它指向一个JSON文件，里面包含了NFT的名称、描述、图片链接等。

ERC-721标准里有个tokenURI函数，你需要重写它。我个人习惯把URI分成两部分：基础URI + tokenId。这样管理起来方便。

function tokenURI(uint256 tokenId) public view override returns (string memory) {
    require(_exists(tokenId), "URI query for nonexistent token");
    string memory baseURI = _baseURI();
    return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
}

function _baseURI() internal pure override returns (string memory) {
    return "https://my-nft-api.com/metadata/";
}

这里有个坑：tokenId.toString()。Solidity 0.8.0以上才支持这个函数，如果你用的是旧版本，得自己写一个toString函数。我记得有一次部署合约，因为版本问题，这个函数一直报错，排查了整整一下午。

4.5 合约部署脚本

合约写好了，怎么部署到链上？我一般用Hardhat写部署脚本。为什么选Hardhat？因为它调试方便，还能模拟主网环境。

// scripts/deploy.js
const hre = require("hardhat");

async function main() {
    const MyNFT = await hre.ethers.getContractFactory("MyNFT");
    const myNFT = await MyNFT.deploy();
    await myNFT.deployed();

    console.log("MyNFT deployed to:", myNFT.address);
}

main().catch((error) => {
    console.error(error);
    process.exitCode = 1;
});

部署的时候，记得配置好网络。我个人习惯在hardhat.config.js里配置多个网络，比如本地测试网、Goerli测试网、主网。

module.exports = {
    solidity: "0.8.9",
    networks: {
        goerli: {
            url: process.env.GOERLI_URL,
            accounts: [process.env.PRIVATE_KEY]
        }
    }
};

这里有个关键点：私钥千万别硬编码。我见过有人直接把私钥写在配置文件里，然后上传到GitHub。嗯，那画面太美我不敢看。一定要用环境变量，或者用Hardhat的@nomiclabs/hardhat-wallet插件来管理。

4.6 部署流程总结

步骤	操作	注意事项
1	编写合约	继承OpenZeppelin，重写必要函数
2	编译合约	npx hardhat compile，检查版本兼容性
3	编写部署脚本	使用ethers.js，配置网络参数
4	测试部署	先在本地网络测试，再上测试网
5	正式部署	确认gas费，检查合约地址

好了，这一章的内容就这些。你想想看，从集成OpenZeppelin到写铸造函数，再到配置元数据URI，最后部署合约，其实每一步都有坑。但只要你按照我说的来，基本不会出大问题。下一章咱们聊聊前端怎么跟合约交互，那才是真正好玩的地方。