用途
该技能面向 NFT 合约开发,用于实现 NFT 标准(ERC-721、ERC-1155),并处理元数据、铸造策略与市场集成。资料给出的适用场景包括:创建 NFT 合集(艺术、游戏、收藏品)、实现市场功能、构建链上或链下元数据、创建灵魂绑定通证(不可转让)、实现版税与收益分成、开发动态/演化 NFT。
主要能力
ERC-721(非同质化通证标准)
资料提供的 ERC-721 模板基于 OpenZeppelin 的 ERC721URIStorage、ERC721Enumerable 与 Ownable,使用 Counters 管理 tokenId。合约定义常量:MAX_SUPPLY = 10000、MINT_PRICE = 0.08 ether、MAX_PER_MINT = 20。mint 函数校验数量范围、总量上限与支付金额,逐个铸造并设置 tokenURI;generateTokenURI 返回形如 ipfs://QmHash/{tokenId}.json 的 IPFS URI。模板还包含 _beforeTokenTransfer、_burn、tokenURI、supportsInterface 的必需重写,以及仅限 owner 的 withdraw 提款函数。
ERC-1155(多通证标准)
资料提供的 ERC-1155 模板基于 OpenZeppelin 的 ERC1155 与 Ownable,示例为游戏道具合约。合约定义 SWORD = 1、SHIELD = 2、POTION = 3,并维护 tokenSupply 与 maxSupply 映射;构造函数设置各道具最大供应量(SWORD 1000、SHIELD 500、POTION 10000),基础 URI 为 ipfs://QmBaseHash/{id}.json。提供单件 mint(仅 owner,校验最大供应量)、mintBatch 批量铸造(逐项校验供应量)与 burn 销毁(校验调用者身份或授权)。
元数据标准
- 链下元数据(IPFS):JSON 包含 name、description、image、attributes;attributes 支持 trait_type/value,并可为数值属性设置 display_type、max_value。
- 链上元数据:合约内部维护 Traits 结构(background、body、head、rarity),tokenURI 通过 Base64 编码组装 JSON,image 为 data:image/svg+xml;base64 形式,由 generateSVG 根据特征生成 SVG。
版税(EIP-2981)
资料提供实现 IERC2981 的示例:维护 royaltyRecipient 与 royaltyFee(示例为 500,即 5%),royaltyInfo 返回接收方与按 salePrice 计算的版税金额,setRoyalty 限制费率上限(示例注释为 10%),并重写 supportsInterface 以声明对 IERC2981 的支持。
使用方式
资料以 Solidity 代码示例(pragma solidity ^0.8.0)展示实现方式,依赖 OpenZeppelin 合约库。更多详细的模板与完整示例位于 references/details.md。资料未提供具体的安装命令、部署步骤或命令行使用方式。
适用场景
创建 NFT 合集(艺术、游戏、收藏品)、实现市场功能、构建链上或链下元数据、创建灵魂绑定通证(不可转让)、实现版税与收益分成、开发动态/演化 NFT。
限制
资料未说明所支持的具体区块链网络、编译器版本约束、安全审计状态或性能表现;除资料中展示的代码外,未提供额外功能承诺。具体安装与使用步骤暂未提供。