第1步：创建你的加密世界门户（安装MetaMask钱包）#

想象MetaMask就是你进入Web3世界的护照。没有它，你只能隔着玻璃看别人玩区块链。

1. 打开浏览器，访问MetaMask官网
2. 点击”Download”按钮安装浏览器扩展
3. 点击”创建钱包”，设置一个强密码
4. 当看到”备份助记词”时，一定要认真记录这些单词！这就像是你加密世界的家门钥匙，丢了就真进不去了。

⚠️ 警告：千万不要把你的助记词发给任何人，即使对方自称是”MetaMask创始人的表弟的朋友”！

第2步：连接EDU测试网（你的区块链游乐场）#

在正式的区块链上犯错就像在奢侈品店打喷嚏——代价高昂。所以我们先在测试网练习。

1. 打开MetaMask，点击顶部的网络选择器
2. 选择”添加网络”
3. 访问Chainlist
4. 搜索”EDU”，找到EDU Testnet
5. 点击”Add to MetaMask”按钮将EDU测试网络添加到你的钱包
6. MetaMask会弹出确认窗口，点击”批准”
7. 确认已切换到EDU Testnet，恭喜你，已进入Web3游乐场！

第3步：获取测试币（免费的区块链”玩具钱”）#

1. 访问HackQuest水龙头 连接你的MetaMask钱包
2. 在页面上请求EDU测试代币
3. 点击”请求资金”，几秒钟后你就会收到一些测试用的EDU币

💡 小贴士：如果水龙头暂时没反应，别着急，有时候它就像上班的周一早晨，需要一点时间才能醒过来。

第4步：打开Atlas ZK IDE（你的智能合约厨房）#

1. 打开浏览器，访问Atlas ZK IDE
2. 连接你的MetaMask钱包
3. 创建一个新项目，命名为”MyNFT”
4. 在IDE中创建新文件，命名为MyNFT.sol
5. 把下面这段代码粘贴进去（别担心，接下来会解释它是什么）：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.9;

// 导入OpenZeppelin的ERC721URIStorage合约，它扩展了基本ERC721标准，添加了存储元数据URI的功能
import "@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol";
// 导入可拥有权合约，允许我们设置合约所有者并限制某些功能只能由所有者调用
import "@openzeppelin/contracts/access/Ownable.sol";

// 创建名为IdeaPulseNFT的合约，它继承自ERC721URIStorage和Ownable
// ERC721URIStorage已经包含了ERC721的所有功能，所以不需要单独继承ERC721
contract IdeaPulseNFT is ERC721URIStorage, Ownable {
    // 私有变量，用于跟踪下一个要铸造的NFT的ID
    uint256 private _nextTokenId;

    // 公开变量，存储NFT元数据的基本URI地址
    // 这里使用的是IPFS地址，确保元数据永久可用且不可变
    string public baseTokenURI = "ipfs://QmaqSmnjQCQKncdZFfmT4Nizii2So2zFZrM1ZVSMYn8PSD";

    // 构造函数，在部署合约时执行一次
    // 设置NFT集合名称为"LumivoltWhisper"，代号为"LVWH"
    // 同时将合约部署者设为合约所有者
    constructor() ERC721("LumivoltWhisper", "LVWH") Ownable(msg.sender) {}

    // 铸造NFT的函数，只有合约所有者可以调用(onlyOwner)
    // recipient参数指定了NFT的接收者地址
    // 函数返回新铸造的NFT的ID
    function mintNFT(address recipient)
        public
        onlyOwner
        returns (uint256)
    {
        // 增加令牌ID计数器
        _nextTokenId++;
        // 保存当前令牌ID
        uint256 newItemId = _nextTokenId;

        // 安全铸造NFT并分配给接收者地址
        // 使用_safeMint而不是_mint可以确保接收地址能够接收NFT
        _safeMint(recipient, newItemId);

        // 为新NFT设置元数据URI
        // 这将允许市场和钱包获取NFT的图像和属性
        _setTokenURI(newItemId, baseTokenURI);

        // 返回新铸造的NFT的ID，方便前端或调用者跟踪
        return newItemId;
    }

    // 重写supportsInterface函数，实现ERC165标准
    // 这个函数告诉其他合约和应用程序这个合约支持哪些接口标准
    // 这对于NFT市场和钱包与合约交互非常重要
    function supportsInterface(bytes4 interfaceId)
        public
        view
        override(ERC721URIStorage)
        returns (bool)
    {
        return super.supportsInterface(interfaceId);
    }
}

这段代码就像一个NFT蛋糕的配方：引入原料（OpenZeppelin库），定义形状（ERC721标准），添加特殊功能（铸造和查看NFT）。

第6步：编译你的合约（烘焙NFT蛋糕）#

1. 在Atlas ZK IDE中，确保已选中MyNFT.sol文件
2. 选择适当的Solidity编译器版本（0.8.9或更高）
3. 点击”编译”按钮
4. 如果出现绿色成功提示，恭喜你，蛋糕烤好了！如果出现红色错误，检查是否漏了分号或括号

第7步：部署合约（把蛋糕上架到区块链商店）#

1. 在Atlas ZK IDE的部署面板中，确保环境已连接到你的MetaMask并选择了EDU Testnet
2. 选择刚才编译好的”MyNFT”合约
3. 点击”部署”按钮
4. MetaMask会弹出确认窗口，确认交易详情并点击”确认”
5. 等待几秒钟，直到交易被确认，合约就会被部署到区块链上
6. 记录下部署成功后显示的合约地址，我们后面会用到

第8步：铸造你的第一个NFT（制作专属数字收藏品）#

1. 在Atlas ZK IDE的已部署合约界面中，找到你刚才部署的合约
2. 展开”mintNFT”函数
3. 输入参数： recipient：你的钱包地址（在MetaMask中复制）
4. 点击”执行”按钮，并在MetaMask中确认交易
5. 等待交易确认，瞧！你刚刚创建了你人生中的第一个NFT！

第9步：将NFT导入钱包（展示你的数字艺术品）#

1. 打开MetaMask，点击底部的”NFTs”标签
2. 点击”导入NFTs”按钮
3. 输入以下信息：
   • 合约地址：填入你在第7步记录的NFT合约地址
   • Token ID：输入”1”（因为这是你铸造的第一个NFT）
4. 点击”导入”按钮
5. 导入成功后，你应该能看到你的NFT显示在MetaMask的NFTs标签下，可能需要一点时间来加载图片
6. 如果图片没有立即显示，不要担心，这是因为IPFS加载可能需要一些时间

🎉 恭喜！ 你现在不仅成功部署了一个NFT合约，还铸造了你的第一个NFT并将其导入到了你的钱包中。你可以通过区块浏览器查看更多关于你的NFT的信息。

第10步：在区块浏览器上查看你的NFT（公开展示你的作品）#

1. 访问EDU Chain的区块浏览器：EDU Chain Testnet Blockscout
2. 在搜索框中粘贴你的合约地址
3. 在合约页面上，你可以看到以下信息：
   • 合约基本信息（创建时间、交易数量等）
   • “Tokens”选项卡下可以看到你铸造的所有NFT
   • 点击特定的Token ID可以查看该NFT的详细信息

例如，可以通过这样的链接查看特定NFT：https://edu-chain-testnet.blockscout.com/token/你的合约地址/instance/1

如果你想让其他人也能欣赏到你的NFT，只需要分享这个链接即可！

第11步：验证你的智能合约（让代码公开透明）#

为了增加你合约的可信度和透明度，你可以在区块浏览器上验证你的合约代码：

1. 在区块浏览器中找到你的合约页面
2. 点击”Code”选项卡
3. 选择”Verify & Publish”选项
4. 填写以下信息：
   • 合约名称：IdeaPulseNFT
   • 编译器版本：选择与你相同的Solidity版本（0.8.9）
   • 开源许可证类型：选择MIT
5. 上传完整的合约代码或直接粘贴代码
6. 点击”Verify & Publish”按钮
7. 验证成功后，任何人都可以查看你的合约源代码，这有助于建立信任

验证后的合约会显示一个绿色的对勾标记，表明它的代码是公开透明的。这对于NFT项目来说非常重要，因为它让收藏者可以确认合约的功能符合项目描述。

上传NFT图片到IPFS#

1. 选择IPFS服务提供商：两个流行的选择是Pinata和NFT.Storage，都提供免费账户

2. 创建账户：在你选择的平台上注册一个账户

3. 上传图片：

   • 登录后，找到”上传”或”Upload”按钮
   • 选择你想要作为NFT的图片文件
   • 点击上传按钮，等待上传完成

4. 获取IPFS CID：

   • 上传成功后，平台会提供一个CID（内容标识符），格式如Qm...
   • 这就是你的图片在IPFS网络上的唯一标识符
   • 完整的IPFS地址格式为：ipfs://{你的CID}，例如：ipfs://QmVXcVBEJrwayPJdRG5seNXTshg3Draf84igzCTVUZ2oNu

创建和上传NFT元数据#

1. 创建元数据文件：
   • 使用文本编辑器创建一个名为metadata.json的文件
   • 填入以下内容，并根据你的NFT进行修改：

{
  "name": "你的NFT名称",
  "description": "对NFT的详细描述",
  "image": "ipfs://你的图片CID",
  "attributes": [
    {
      "trait_type": "创作者",
      "value": "你的名字"
    },
    {
      "trait_type": "类别",
      "value": "艺术/音乐/游戏物品等"
    }
    // 可以添加更多属性
  ]
}

2. 替换图片CID：

   • 将上一步获取的图片CID替换到"image"字段中
   • 确保使用完整格式：ipfs://你的图片CID

3. 上传元数据文件：

   • 回到IPFS服务提供商平台
   • 上传这个metadata.json文件
   • 获取元数据文件的CID

4. 使用元数据地址：

   • 完整的元数据IPFS地址是：ipfs://元数据文件的CID
   • 这个地址就是你铸造NFT时需要的tokenURI参数

铸造NFT时使用生成的地址#

当你执行合约的mintNFT函数时，tokenURI参数应该是你的元数据文件的IPFS地址，而不是图片地址。智能合约会通过这个元数据文件找到图片和其他属性。

可视化NFT预览#

铸造NFT后，区块链浏览器和NFT市场会读取你的元数据，并显示图片和属性。确保你的元数据格式正确且图片地址可访问，这样你的NFT才能在各平台正确显示。

故障排除#

• 图片不显示：确认IPFS CID正确，并且在metadata.json中使用了完整的ipfs://前缀
• 元数据不加载：验证JSON格式是否有效，可以使用在线JSON验证工具
• 属性未显示：检查元数据中的attributes数组格式是否正确

通过以上步骤，你可以完全自定义你的NFT图片和元数据，而不需要依赖预设的内容。这使你能够创建真正独特和个性化的NFT作品！