如何将 NFT 元数据备份到 IPFS？ （分散存储）

了解 NFT 元数据及其漏洞

1. NFT 元数据通常以 JSON 格式驻留在链外，包含名称、描述、图像 URL 和特征等属性。

2. 许多早期的 NFT 项目将元数据托管在中心化服务器或云平台上，使它们面临链接腐烂、审查或服务关闭的风险。

3. 损坏的 URI 意味着 NFT 可能在钱包或市场中显示为空白资产，即使代币本身在链上仍然有效。

4. 仅依赖 Cloudflare 的 IPFS 网关等第三方网关会引入对可以限制或修改访问的中介机构的依赖。

5. 由于以太坊 Gas 成本和大小限制，完整元数据的链上存储很少可行，因此去中心化的链下存储至关重要。

准备 IPFS 上传元数据

1. 标准化您的 JSON 结构以遵循 ERC-721 或 ERC-1155 元数据架构，确保存在名称、描述和图像等必需字段。

2. 将图像或animation_url字段中的任何绝对HTTP URL 替换为用于以后CID 替换的相对路径或占位符。

3. 将关联的媒体文件（PNG、GIF、MP4）存储在与 JSON 相同的本地目录中，以便使用ipfs add -r等工具启用递归固定。

4. 上传前通过计算 SHA-256 哈希值验证文件完整性；上传后哈希值不匹配表示损坏或传输不完整。

5. 避免在元数据文件中嵌入私钥、钱包地址或 API 令牌——即使存储在 IPFS 上，它们也会永久公开且不可变。

使用命令行工具上传到 IPFS

1. 安装ipfs-desktop或go-ipfs CLI，然后使用ipfs init初始化本地节点并通过ipfs daemon启动它。

2. 导航到元数据文件夹并运行ipfs add -r ./nft-assets/以递归方式添加所有文件并生成根 CID。

3.使用ipfs cid base32将默认的base58 CID转换为base32格式，提高可读性并减少转录错误。

4. 使用Pinata 、 NFT.Storage或Web3.Storage等持久服务固定根 CID，以防止本地节点进行垃圾收集。

5. 打开https://ipfs.io/ipfs/交叉检查渲染的元数据浏览器中的/metadata.json — 确保所有嵌套引用正确解析。

使用 IPFS URI 更新智能合约

1. 对于可升级的NFT合约，调用类似setBaseURI('ipfs:// /')将所有令牌 ID 指向共享前缀路径。

2. 如果使用每个令牌 URI，请为每个 JSON 文件构建单独的 CID，并将它们直接存储在合约的tokenURI()覆盖逻辑中。

3. 避免对网关 URL 进行硬编码（例如，https: //gateway.pinata.cloud/ipfs/ ）在合同中——这些引入了集中化，并且如果提供商改变政策则可能会中断。

4. 通过单击“查看令牌 URI”链接并确认返回值以ipfs://开头，后跟有效的 CID，在 Etherscan 或 Polygonscan 上测试分辨率。

5. 使用ipfs cid inform审核最终的 URI 格式验证版本 (v0/v1)、编解码器 (dag-pb/dag-cbor) 和多重哈希完整性。

常见问题解答

问：上传到 IPFS 后可以更新元数据吗？答：不可以——IPFS 内容在设计上是不可变的。为了反映更改，您必须生成新文件、重新上传、获取新的 CID 并更新合约的 URI 指针。

问：我需要将整个媒体库存储在 IPFS 上，还是只存储 JSON？答：两者都需要。 JSON 必须使用相对路径或嵌入的 CID 引用媒体；否则，NFT 将缺乏视觉表示或功能资产。

问：如果我的本地 IPFS 节点在上传过程中离线，会发生什么情况？答：通过 CLI 发起的上传首先在本地处理。只要ipfs 守护进程在ipfs add期间运行，该块就会添加到节点的数据存储中 - 即使之后与网络断开连接。

问：IPFS 上的元数据文件有大小限制吗？答：没有协议级别的上限，但存在实际限制：网关通常将单个文件上传限制为100 MB ，而较大的文件会增加检索延迟和跨分布式节点的固定成本。