解锁欧艺合约开发,从入门到实践的全流程教程

欧艺合约开发前的准备工作

在动手编写代码之前,你需要做好以下准备工作：

1. 基础知识储备：

   • Solidity：以太坊智能合约的核心编程语言，你需要掌握其基本语法、数据类型、控制结构、函数修饰符、合约继承等。
   • 区块链概念：理解去中心化、钱包（如MetaMask）、Gas费、交易、区块等基本区块链概念。
   • 以太坊与ERC标准：熟悉以太坊网络的工作原理，以及ERC-721（唯一代币）和ERC-1155（多代币/半同质化代币）标准的区别与应用场景。
   • 前端开发（可选）：如果你想开发一个更完整的NFT项目，了解HTML, CSS, JavaScript以及Web3.js或ethers.js等库将有助于你构建与智能合约交互的前端界面。

2. 开发环境搭建：

   • 代码编辑器：推荐使用Visual Studio Code，并安装Solidity相关插件（如Solidity by Juan Blanco）。
   • 开发框架：Hardhat 或 Truffle 是目前最流行的以太坊开发框架，它们提供了编译、测试、部署等一站式解决方案，本教程将以Hardhat为例进行介绍。
   • 钱包插件：浏览器中安装MetaMask，用于管理账户、与测试网和主网交互，以及支付部署合约所需的Gas费。
   • 测试网ETH：从以太坊水龙头（如Goerli水龙头）获取测试网ETH，用于在测试网上部署和测试合约，避免消耗真实资产。

欧艺合约开发实战步骤

创建Hardhat项目

1. 打开终端,运行以下命令初始化一个新的Hardhat项目：

   npx hardhat

2. 按照提示选择 "Create a JavaScript project"（或TypeScript，根据你的偏好），输入项目名称，选择不添加.gitignore文件（可选），选择不添加sample测试合约。
3. 进入项目目录：

   cd your-project-name

安装必要的依赖

我们需要安装OpenZeppelin合约库,它提供了经过审计和测试的标准实现（如ERC721, ERC1155），极大简化了开发过程。

npm install @openzeppelin/contracts

编写智能合约

1. 在 contracts 目录下创建一个新的Solidity文件，MyNFT.sol。
2. 编写你的NFT合约,以下是一个简单的ERC-721 NFT合约示例：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
import "@openzeppelin/contracts/utils/Counters.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
contract MyNFT is ERC721, Ownable {
    using Counters for Counters.Counter;
    Counters.Counter private _tokenIdCounter;
    constructor(string memory baseTokenURI) ERC721("My Awesome NFT", "MANFT") {
        _setBaseURI(baseTokenURI); // 设置基础URI，用于元数据
    }
    function safeMint(address to) public onlyOwner {
        uint256 tokenId = _tokenIdCounter.current();
        _safeMint(to, tokenId);
        _tokenIdCounter.increment();
    }
    // 可选：实现baseURI函数，符合ERC-721标准
    function _baseURI() internal view override returns (string memory) {
        return super._baseURI();
    }
}

说明：

• import 导入了OpenZeppelin的ERC721合约、计数器和所有权管理合约。
• constructor 是合约的构造函数，这里我们设置了NFT的名称（"My Awesome NFT"）和代号（"MANFT"），并初始化了基础URI。
• safeMint 函数用于铸造NFT，只有合约所有者（onlyOwner）可以调用，它会生成一个新的唯一tokenId，并将其铸造到指定地址。
• _baseURI 用于指向包含NFT元数据（如图片描述、属性等）的JSON文件所在的根目录。

配置Hardhat脚本

1. 在 scripts 目录下创建一个部署脚本，deploy.js：

async function main() {
  // 这里替换为你自己的基础URI，指向存放元数据JSON文件的文件夹
  // 如果你的JSON文件在 https://myapi.com/nft-metadata/ 下，则这里填 "https://myapi.com/nft-metadata/"
  const baseTokenURI = "https://your-metadata-base-uri.com/";
  // 获取合约工厂
  const MyNFT = await hre.ethers.getContractFactory("MyNFT");
  // 部署合约
  const myNFT = await MyNFT.deploy(baseTokenURI);
  await myNFT.deployed();
  console.log("MyNFT deployed to:", myNFT.address);
}
main()
  .then(() => process.exit(0))
  .catch((error) => {
    console.error(error);
    process.exit(1);
  });

编译与测试合约

1. 在终端运行编译命令：

   npx hardhat compile

   如果成功,你会在 artifacts 目录下看到编译后的合约文件。

2. （可选）编写测试用例并运行测试，确保合约逻辑正确。

部署合约到测试网/主网

1. 确保你的MetaMask已连接到目标网络（如Goerli测试网），并且有足够的测试ETH。
2. 在 hardhat.config.js 中配置你需要的网络信息（包括测试网RPC URL和私钥，注意：私钥不要泄露）。
3. 运行部署脚本：

   npx hardhat run scripts/deploy.js --network goerli

   部署成功后,终端会输出你合约的地址。请务必保存好这个地址！

准备元数据

欧艺通过读取合约中的 _baseURI 和NFT的tokenId来拼接元数据的JSON URL，如果 _baseURI 是 https://myapi.com/nft-metadata/，tokenId为 1，则元数据URL为 https://myapi.com/nft-metadata/1。

你需要为每个NFT创建一个JSON文件,包含以下字段（示例）：

{
  "name": "My Awesome NFT #1",
  "description": "This is my first awesome NFT!",
  "image": "https://myapi.com/nft-images/1.png",
  "attributes": [
    {
      "trait_type": "Rarity",
      "value": "Rare"
    }
  ]
}

将所有JSON文件上传到支持HTTP(S)访问的服务器（如IPFS、Arweave、传统云存储等），确保 _baseURI 能正确指向这些文件的根目录。

在欧艺上展示你的NFT

1. 连接钱包：访问欧艺官网（https://opensea.io/），并连接你的MetaMask钱包。
2. 导入合约：
   • 点击右上角你的钱包图标,选择“我的资产”（My Assets）。
   • 点击“导入从其他账户”（Import from another account）。
   • 输入你刚刚部署的合约地址。
   • 欧艺会自动检测合约类型并尝试加载你的NFT。
3. 查看与编辑：导入