🤔NFT到底是什么？

1. 字面意思：NFT 的全称是 Non-Fungible Token（非同质化代币）。
• “代币（Token）”： 可以理解为一张数字证书，一个数字凭证。
• “非同质化（Non-Fungible）”： 这是关键。意思是独一无二、不可互换的。

2. 一个对比让你秒懂：
• 同质化： 就像钱。你手里的100元和我手里的100元，价值完全相同，可以随意交换。比特币、以太坊这类加密货币也是同质化的。
• 非同质化： 就像那幅《蒙娜丽莎》，或者一套房产、一张绝版球星卡。每一件都是独特的，价值也不同，不能直接1：1交换。NFT就是这种东西的数字版本。

3. 它存在哪里？
NFT的信息记录在区块链上（你可以把区块链想象成一个全球性的、去中心化的、无法篡改的公共账本）。这意味着：
• 唯一性： 每个NFT都有独一无二的编号，无法复制。
• 可追溯： 谁在什么时候创造了它，每次被谁买走，所有交易历史都公开透明，无法伪造。
• 所有权清晰： 区块链上的记录明确显示了当前谁是它的合法所有者。

🔑NFT有什么作用？（价值与应用）

1. 数字艺术与收藏品：
• 这是最广为人知的应用。艺术家可以将自己的数字画作、音乐、视频、甚至一条推特铸造成NFT。
• 买家： 买的不是那个可以无限复制的图片文件，而是这份“独一无二的所有权证明”。这类似于收藏原画。
• 创作者： 可以在每次NFT转售时自动获得版税抽成（例如10%），这是传统艺术市场很难实现的。

2. 游戏内物品：
• 传统游戏里，你花钱买的装备、皮肤实际上属于游戏公司，你只是“租用”。
• 如果游戏物品是NFT，那它就真正属于你。你可以交易、出售，甚至未来带到其他兼容的游戏中使用，实现了资产的“玩家所有”。

3. 身份认证与会员资格：
• 某个品牌或社群可以发行NFT作为会员卡。持有特定NFT的人才能进入专属的Discord频道、参加线下活动、获得限量商品等。它成了身份和归属感的象征。

4. 实体资产数字化：
• 房子、车子、奢侈品等实物资产的所有权证明也可以用NFT来表示，让交易和验证变得更高效、透明。虽然这还处于早期阶段。

5. 数字身份：
• 学历证书、驾照、医疗记录等都可以做成NFT，由个人完全掌控并在需要时选择性出示，无需通过第三方机构验证，保护隐私且防止造假。
 

🎆 目标页面

👜 环境安装

📝 智能合约

智能合约的编写

核心函数拆解

类别 1: 核心 ERC721 标准函数 (主要继承自 OpenZeppelin)

1. constructor (构造函数)
• 作用：在合约部署时初始化 NFT 集合的基本信息。
• 详解：它设置了 NFT 的名称 (NAME)、符号 (SYMBOL)、合约的初始所有者 (initialOwner) 以及该系列 NFT 的最大供应量 (maxSupply)。maxSupply 为 0 表示无限制。

2. tokenURI(uint256 tokenId)
• 作用：获取特定 NFT 的元数据链接。这是最重要的函数之一。
• 详解：它返回一个字符串（通常是 IPFS 哈希或一个 URL），指向存储该 NFT 元数据（如名称、描述、图像属性等）的 JSON 文件。用户通过这个链接看到 NFT 的真正内容。此函数重写了父合约的函数。

3. transferFrom / safeTransferFrom
• 作用：转移 NFT 的所有权。
• 详解：这是 NFT 交易和转移的核心。safeTransferFrom 会检查接收地址是否为合约，如果是，则要求该合约能够接收 ERC721 代币，防止 NFT 被永久锁定在一个无法处理它的合约中。本合约重写了这些函数，在转移后自动更新内部记账映射（_ownedTokens 等），这是对标准功能的增强。

类别 2: NFT 生命周期管理函数 (核心业务逻辑)

1. mint(address to, string memory ipfsHash)
• 作用：铸造（创建）一个新的 NFT。
• 详解：这是最重要的功能函数。它接收一个地址和一个 IPFS 哈希值，然后：
• 检查供应量限制。
• 生成一个唯一的 tokenId。
• 调用内部的 _mint 将 NFT 分配给 to 地址。
• 调用 _setTokenURI 将 tokenId 与元数据链接（ipfsHash）绑定。
• 记录创作者信息、初始化上架状态、更新持有人列表等。
• 触发 NFTMinted 事件，通知全网。

2. burn(uint256 tokenId)
• 作用：销毁一个已存在的 NFT。
• 详解：只有 NFT 所有者或合约所有者可以调用。它会将 NFT 从调用者地址中移除，并永久销毁它（总量 totalSupply 会减少）。同时清理所有相关数据（URI、价格、上架状态等），并触发 NFTBurned 事件。

类别 3: 市场交易函数 (核心业务逻辑)

1. listNFT(uint256 tokenId, uint256 price)
• 作用：将用户拥有的 NFT 上架到市场进行销售。
• 详解：所有者调用此函数，设置一个大于 0 的价格（单位：wei）。函数会将该 NFT 标记为“已上架” (_isListed[tokenId] = true) 并记录其售价 (_prices[tokenId] = price)，然后触发 NFTListed 事件。

2. buyNFT(uint256 tokenId)
• 作用：购买一个已上架的 NFT。
• 详解：这是最复杂的函数之一。买家调用此函数并附带足够的 ETH (msg.value)。
• 检查：NFT 存在、已上架、买家不是卖家、付款足够。
• 执行：调用内部的 _transfer 将 NFT 从卖家转移给买家。
• 付款：将买家支付的 ETH 转给卖家 (payable(seller).transfer(price))。
• 更新：将 NFT 下架、更新持有人映射、记录本次交易到历史 (_tradeRecords)。
• 事件：触发 NFTSold 事件。

类别 4: 视图查询函数 (提供信息)

1. tokensOfOwner(address owner)
• 作用：查询某个地址拥有的所有 NFT 的 ID。实现了枚举功能，使得可以轻松查看一个钱包里的所有 NFT。

2. getTokenIPFSHash(uint256 tokenId)
• 作用：查询某个 NFT 对应的元数据哈希。

3. isListed / getPrice
• 作用：查询某个 NFT 是否在售以及其价格。市场前端会频繁调用这些函数来展示商品列表。

4. getTradeRecords(uint256 tokenId)
• 作用：查询某个 NFT 的所有历史交易记录。提供了 NFT 的链上溯源能力，增加了透明度和价值证明。

类别 5: 内部辅助函数

1. _addTokenToOwnerEnumeration / _removeTokenFromOwnerEnumeration
• 作用：在 NFT 被铸造、转移或销毁时，更新地址所持有 NFT 的列表。
• 详解：这是实现 tokensOfOwner 功能的关键。它维护了两个映射：_ownedTokens[owner]（某个地址拥有的所有 tokenId 列表）和 _ownedTokensIndex[tokenId]（某个 tokenId 在列表中的位置），以确保高效地增加和删除。

智能合约的编译、本地链启动与部署

📝 前端板块

开发框架与依赖

环境配置

核心代码解析

WalletContext.tsx

create/page.tsx 【创建页面】

1. 填写 NFT 的详细信息（名称、描述、分类、价格）。

2. 上传 NFT 的图片文件。

3. 一键完成整个铸造和上架流程：将图片上传到去中心化存储（IPFS/Pinata）、生成元数据文件、将元数据上传到 IPFS、调用智能合约铸造 NFT、并最终将 NFT 上架到市场进行销售。

1. 验证连接状态：检查钱包是否连接以及是否有provider和图片文件

2. 上传图片到IPFS：使用 pinata.upload.file() 将图片上传到IPFS网络

3. 创建元数据：构建NFT的元数据，包括名称、描述、图片链接等

4. 上传元数据到IPFS：使用 pinata.upload.json() 将元数据上传到IPFS

5. 铸造NFT：调用 mintNFT 函数在区块链上创建NFT

6. 上架NFT：调用 listNFT 函数将NFT放到市场上出售

7. 状态管理：在整个过程中更新UI状态和提示信息

nft[id]/page.tsx 【详情页面】

🤗 总结归纳

📎 项目链接