罗罗编程学习记录 全栈面试题库
本页导航 展开查看

15.9.1 NFT 市场全栈设计

所属:全栈开发面试题库 / 15 Web3 与区块链 / 15.9 综合场景题

本节要解决的问题

NFT 市场看似"前端挂列表 + 合约转账",实际工程坑全在链上链下的接缝处:元数据到底放链上、IPFS 还是自己的服务器,决定了项目方能否事后改图、用户能否长期访问;挂单本质是"用户离线签名 + 平台链上撮合",nonce、签名重放、跨平台复用一旦设计错就是资金事故;版税想在二级市场强制抽取,必须区分"市场合约内部分账"与"挂了架就无法约束"两种情形。本节按真实项目顺序推演:元数据存储选型 → 版税机制 → 签名撮合 → 懒铸造 → 索引与前端 → Gas 与用户流程,每个环节给出约束、方案、取舍与风险,并附可核对的数量级估算。

学习目标

学完本节,你应当能够:

  • 针对一个具体 NFT 项目,给出元数据存储方案(链上 / IPFS / 中心化)并算出成本与可篡改边界。
  • 画出离线签名挂单的完整数据流,说明订单参数、nonce、签名域分隔与防重放设计。
  • 说清 EIP-2981 类版税在哪些交易路径上生效、哪些路径上失效,并给出工程补偿手段。
  • 估算 mint、挂单、成交三类交易的 Gas 量级,以及懒铸造把成本转嫁给谁。

先修与前置

知识地图

NFT 市场全栈数据流

  创作者/项目方                         买家
      │                                  │
      │  1. 元数据准备                    │
      │  图片/JSON → IPFS(可冗余) 或 中心化 CDN
      │      └─ 合约 tokenURI 指向 CID/URL
      │                                  │
      │  2. 上架(懒铸造时签名授权)        │
      │  用户离线签名 Order{令牌,价格,币种,nonce,有效期,版税}
      │      └─ 订单不上链,平台只存签名
      │                                  │
      │  3. 撮合: 卖家卖单 + 买家买单 或 直接接受报价
      │      链上: 校验签名 → 检查 nonce/授权 → 原子转账分账
      │      ├─ 分账: 卖家款 / 平台费 / 版税接收方
      │                                  │
      │  4. 索引层: 监听 Transfer/Approval/自定义事件
      │      → subgraph/索引服务 → API → 前端列表
      │                                  │
      └─ 5. 展示层: 元数据拉取失败/被改 → 兜底图与状态标记

核心术语

  • tokenURI:ERC-721 返回的元数据指针,通常指向 ipfs:// 或 HTTPS URL,URI 本身可被合约方改写或固定。
  • IPFS / CID:内容寻址存储,文件内容哈希决定寻址(CID),文件不变则 CID 不变;需要 pin 节点持续提供。
  • EIP-2981:类版税标准,合约实现 royaltyInfo(tokenId, price) 返回接收方与版税金额,配合尊重它的市场合约即可强制分账。
  • 离线签名挂单:用户用钱包对订单结构(价格、币种、nonce、有效期、签名域分隔)签名,订单数据不发链,平台撮合时才上链。
  • 订单 nonce / 反查重:每笔订单带唯一 nonce 或计数器,链上成交或取消后置位,同一签名不能被第二次使用。
  • 签名域分隔(EIP-712):把链 ID、合约地址、签名类型纳入哈希,防止一条链的签名在另一条链或另一个合约上重放。
  • 懒铸造(Lazy Mint):项目方先签发铸造授权,买家下单时才真正上链铸造,Gas 由买家承担,项目方零 Gas 上架。
  • 原子分账:撮合交易在一次调用内把款分别打给卖家、平台、版税方,任一分账失败则整笔回滚。

覆盖范围

  • 元数据三种存储方案的成本、可篡改性与可用性对比
  • 链上版税(EIP-2981 类)与市场侧版税的生效边界
  • 签名撮合订单结构、签名校验、nonce 与防重放
  • 懒铸造的授权铸造流程与 Gas 转嫁
  • 事件索引、元数据爬取与前端兜底展示
  • mint、挂单、成交的 Gas 量级与用户流程优化

高频题速览

编号 题目 难度 频率
15.9.1-001 NFT 元数据放链上、IPFS 还是中心化服务器? 基础 ★★★★★
15.9.1-002 EIP-2981 类版税能不能在二级市场强制抽成? 高级 ★★★★★
15.9.1-003 离线签名挂单怎么设计?订单参数与防重放怎么做? 进阶 ★★★★★
15.9.1-004 同一签名挂单被别人拿去别的市场复用怎么办? 高级 ★★★★
15.9.1-005 懒铸造怎么设计?Gas 最终由谁付? 进阶 ★★★★
15.9.1-006 前端怎么索引 NFT 列表与成交?元数据拉取失败怎么办? 基础 ★★★★
15.9.1-007 首次发售 mint 合约参数怎么定?白名单与阶段怎么排? 进阶 ★★★★
15.9.1-008 卖单成交后平台费与版税怎么分?pull 还是 push? 进阶 ★★★
15.9.1-009 IPFS 网关挂了或 CID 被运营商封锁,展示层怎么兜底? 基础 ★★★
15.9.1-010 同一 NFT 在十个市场挂单,版税到底在哪个环节扣? 高级 ★★★

15.9.1-001 NFT 元数据放链上、IPFS 还是中心化服务器?

一句话结论

约束是"不可篡改 + 长期可用 + 成本"三者只能取其二:链上存储最可信但最贵,IPFS 用内容寻址兼顾两者但依赖 pin 生态,中心化服务器最便宜但项目方随时可改图且会单点失效。主流做法是"图片/JSON 存 IPFS 并多节点 pin,合约 tokenURI 固定指向 CID",链上只存必要指针。

概念解释

  • 链上存储:JSON 与图片 base64 写进合约存储,永久随链存在,但每写入 1 字节 calldata 约 16 gas、SSTORE 冷写入约 20000 gas,成本极高。
  • IPFS:内容寻址,CID 由内容哈希得出,文件不变 CID 不变;但 IPFS 本身不保证永久可用,需要 pin 节点或 Filecoin 类激励层兜底。
  • 中心化 CDN:自己服务器存 JSON 与图片,tokenURI 指向 HTTPS URL;项目方可以随时改 JSON 里的图片地址,即"可篡改图"。
  • 可篡改性边界:合约 tokenURI 若写死 CID,项目方无法改;若暴露 setBaseURI 管理方法,则可改。这是"空投系列"与"承诺稀缺"的核心差异。

原理流程

  1. 先定项目承诺:是否承诺"图不可改"。承诺不可改 → 排除中心化方案,tokenURI 必须写死。
  2. 估算存储量:一件 500KB 图片 + 1KB JSON,10000 件约 5GB。
  3. 对比成本:全部上链不现实(单图片上链 Gas 是图片本身成本的数百倍);IPFS pin 服务按存储量与带宽计费,量级为每月数美元/GB 上下;中心化服务器成本最低。
  4. 落地:图片与 JSON 批量生成 → 打包上传 IPFS 得到根 CID → 合约构造时把 baseURI 固定为 ipfs://根CID/ → mint 时 tokenId 拼路径。
  5. 冗余:至少两个独立 pin 服务商或自建节点 pin,避免单一服务商下线。
  6. 前端兜底:ipfs:// 经公共网关拉取,失败时显示兜底图与"元数据不可达"标记。

代码或图示

成本量级对比(假设 10000 件,每件图片 500KB + JSON 1KB):

方案            链上成本(量级)              可篡改?    长期可用
链上存JSON+图   图片上链仅 calldata 就约    不可篡改   永久(随链)
                500KB×16gas/byte ≈ 800万
                gas/件(数千美元量级)
IPFS            pin 约 5GB, 每月数美元     写死CID后  依赖 pin 生态
                量级, 一次性上传           不可篡改   与网关可用性
中心化CDN       服务器带宽成本最低           可改图     依赖项目方存续

推荐: IPFS + 双 pin + 合约写死 baseURI = ipfs://<CID>/

常见误区

  • 误区:用 IPFS 就等于永久存储;正解:IPFS 只在节点主动 pin 时才可用,没人 pin 的内容会被垃圾回收。
  • 误区:tokenURI 用 HTTPS 就够了;正解:HTTPS 方案下项目方可以事后替换 JSON 里的图片字段,买家买的"稀缺图"可能被换掉。
  • 误区:元数据只存图片;正解:JSON 里的属性(稀有度字段)同样影响二级估值,必须和图片一起固定进 CID。

追问

  • 为什么不直接把图片也上链?答:成本不经济。机制上链上每字节 calldata 约 16 gas、SSTORE 冷写约 20000 gas,一张 500KB 图片仅 calldata 就要约 800 万 gas。边界在于:小尺寸图(几十 KB)或"图鉴式像素图"上链是可行的,成本可接受。延伸:很多项目采用"链上 SVG 生成"——把生成逻辑写进合约,图片由合约实时渲染,存储成本远低于位图。
  • 项目方想保留"后续更新原画"的权利怎么办?答:分离资产与版本。机制上把"原版图"固定 CID,另开一个可升级的 revealURI 指向衍生版本,前端以用户选择的方式展示。边界在于:二级市场买家有权知道哪个版本是"首发资产",必须在 UI 上明确区分。延伸:这本质是"版本化元数据"问题,需要合约层记录每个 token 的版本指针。
  • IPFS 网关被运营方封锁或访问慢怎么办?答:多网关 + 自有节点兜底。机制上前端按列表轮询公共网关,失败时切备用网关或回源自建 pin 节点。边界在于:依赖公共网关始终有可用性风险,严肃项目会自建网关或采用去中心化存储网络。延伸:移动端 App 内嵌 IPFS 节点或用原生代理层,可绕开对公共网关的依赖。

15.9.1-002 EIP-2981 类版税能不能在二级市场强制抽成?

一句话结论

只能在"尊重该标准的市场合约内撮合"时强制生效:合约从 royaltyInfo 读到版税接收方与比例,在原子分账里直接预留。凡是在市场外点对点成交、或市场不读该标准,版税就收不到——链上没有任何机制能阻止卖家把 NFT 直接 transferFrom 给买家。

概念解释

  • 链上版税接口:合约暴露 royaltyInfo(tokenId, salePrice),市场成交前调用,得到 (receiver, amount)。
  • 生效条件:撮合合约主动调用并预留这笔款;买卖双方不经过该合约则无强制。
  • 市场侧版税:历史上很多市场把版税做成"平台规则"——挂在本平台的单强制分账,但平台对站外交易无约束力。
  • 强制授权的边界:合约层面无法检测"transferFrom 背后有没有成交",因为链上只有转账,没有"销售"这个事件。

原理流程

  1. 部署时在 NFT 合约实现 royaltyInfo,返回版税接收方地址与百分比(如成交价的 5%)。
  2. 市场合约撮合前:先收齐买家付款 → 调用 NFT 合约 royaltyInfo(tokenId, price) → 计算版税金额 → 原子分账给卖家、平台、版税方。
  3. 买家视角:一次交易同时完成三个转账,任一环节失败整笔回滚。
  4. 站外路径:卖家直接 transferFrom(seller, buyer),买家自己转钱到卖家钱包——合约完全不知道,版税为零。
  5. 工程补偿:市场侧对"不付版税的 NFT"降低曝光、或要求挂单合约校验版税;但这些都是商业规则,不是链上强制。

代码或图示

版税生效路径图:

  市场内撮合(尊重版税标准):
    买家付款 P
      ├─ 给卖家 P × (1 - 平台费 - 版税率)
      ├─ 给平台 P × 平台费率
      └─ 给版税方 P × 版税率   ← royaltyInfo 返回值预留
    NFT 从卖家原子转移给买家

  站外交易(无强制):
    买家钱包 ──转账 ETH/ERC20──> 卖家钱包   (链上无"成交"语义)
    NFT 合约: transferFrom(seller, buyer)  (无任何分账)
    → 版税 = 0, 平台费 = 0

常见误区

  • 误区:部署了版税接口就能全市场强制抽成;正解:只有尊重该接口的市场在合约内分账时才生效,站外交易完全不受约束。
  • 误区:版税比例写进 NFT 合约就不能改;正解:若 royaltyInfo 的接收方或比例由管理员可写,项目方仍可调整,需在文档中明确是否可改。
  • 误区:把版税做成 ERC-20 手续费式自动扣费;正解:NFT 转账本身没有"成交价"概念,合约不知道这是赠与还是售卖。

追问

  • 为什么不能用合约检测"转账背后是否有销售"?答:链上只有状态转移,没有销售语义。机制上 transferFrom 是 NFT 合约的标准操作,合约无法判断接收方是否付了钱。边界在于:可以通过"要求卖家必须先授权市场合约才能交易"来变相强制——即只接受经过市场合约的转账。延伸:这会牺牲用户自由,属于商业取舍而非技术强制。
  • 版税比例怎么定?答:常见区间为成交价的 2.5%–10%,越高越抑制二级流动性。机制上比例越高,站外成交的经济激励越大(省下的版税可买卖双方分)。边界在于:蓝筹项目因社区认可度高可以承受较高版税,新系列高版税会直接压低挂单意愿。延伸:动态版税(随持有时间递减)是一种折中,但增加了合约复杂度。
  • 多版税接收方(多创作者分润)怎么实现?答:合约返回一个接收方数组,或由分账合约聚合。机制上 royaltyInfo 返回单地址,多创作者时由分账合约接收后再按比例转。边界在于:每次成交多两次外部转账,Gas 上升且引入外部调用失败风险。延伸:用 pull 模式(版税方主动来领)可降低单次成交成本,但延迟到账。

15.9.1-003 离线签名挂单怎么设计?订单参数与防重放怎么做?

一句话结论

订单结构必须包含:资产标识、价格与币种、有效期、签名者、nonce、签名域分隔(链 ID + 合约地址);链上撮合时校验签名、检查 nonce 是否已用、校验授权,成交后把 nonce 置位。核心风险是"同一签名被重复上链执行",防线是 nonce/计数器 + 签名域分隔 + 订单有效期。

概念解释

  • 离线签名:用户用私钥对订单哈希签名,签名与订单数据一起交给平台,平台不持有用户私钥。
  • 签名域分隔(EIP-712 风格):哈希前混入 chainId、合约名与版本、 verifyingContract,防止签名跨链、跨合约复用。
  • nonce 防重放:每笔订单带唯一 nonce,链上成交后标记已用;也可用"计数器 nonce"一次性取消整组挂单。
  • 授权前置:挂单前卖家须先 setApprovalForAll 或 approve 给撮合合约,否则成交时 transferFrom 失败。

原理流程

  1. 用户在前端构造订单:{maker, tokenId, price, currency, deadline, nonce, fees}。
  2. 钱包按 EIP-712 对结构化数据签名,签名包含链 ID 与撮合合约地址。
  3. 平台把签名订单存到数据库,展示在市场列表。
  4. 买家接受报价:提交成交交易,链上合约解包订单与签名 → ecrecover 还原签名者 → 校验等于 maker → 检查 nonce 未用、deadline 未过 → 标记 nonce → 检查授权 → 原子执行转账与分账。
  5. 卖家取消:链上提交取消交易,把 nonce 置位(或递增计数器),订单失效。
  6. 重放防护验证:同一签名在不同链、不同合约、重复提交均会被拒绝。

代码或图示

订单结构与校验流程:

  Order = {
    maker:        卖家地址
    tokenId:      NFT 编号
    price:        成交价格
    currency:     计价 ERC-20 或 ETH
    deadline:     区块时间戳有效期
    nonce:        订单唯一序号
    feeStack:     平台费/版税拆分
  }

  签名哈希 = EIP712_Domain(chainId, verifyingContract)
           ‖ keccak256(encode(Order))

  链上成交校验顺序:
    1. ecrecover(订单哈希, 签名) == maker ?
    2. block.timestamp < deadline ?
    3. nonce[maker][nonce] 未用 ?
    4. maker 已授权本合约转移该 token ?
    5. 标记 nonce → 收款 → 分账 → transferFrom → 事件

常见误区

  • 误区:把订单直接上链存着就行;正解:订单上链存储 Gas 高且无必要,离线签名 + 链上校验是标准做法。
  • 误区:签名只覆盖价格和 tokenId;正解:不混入链 ID 与合约地址,签名可被搬到别的链或别的合约重放。
  • 误区:用区块号做有效期;正解:跨链部署时各链出块速度不同,用 Unix 时间戳(deadline)更通用。

追问

  • 签名订单被抢先成交(front-running)怎么办?答:订单本身是离线的,撮合交易上链时才暴露;风险来自撮合交易在内存池被抢跑。机制上卖家可在订单中限定"只接受指定买家"或用密封报价,平台可走私有内存池/私有订单流。边界在于:公开市场的挂单天然面临抢跑,常见做法是撮合交易由平台统一提交并设置合理滑点。延伸:这是 MEV 在 NFT 场景的具体表现。
  • nonce 用计数器好还是逐单唯一好?答:各有取舍。机制上逐单唯一 nonce 粒度细,取消单只失效一笔;计数器 nonce 可以一次递增批量取消所有挂单。边界在于:计数器方案会误取消有效订单,逐单方案取消每笔都要发交易付 Gas。延伸:成熟协议支持两者组合——单个订单 nonce + 批量取消计数器。
  • 买家也要签名吗?答:买单同样需要离线签名。机制上买卖双方各自签单,撮合时两单一起上链,原子成交;买家订单覆盖出价、数量与有效期。边界在于:双向签名增加交互复杂度,简化做法是"卖家挂卖单 + 买家直接接受",买家只需签名授权支付。延伸:这是不同撮合协议的产品形态差异。

15.9.1-004 同一签名挂单被别人拿去别的市场复用怎么办?

一句话结论

只要签名里不含"只允许本市场合约"的约束,理论上任何拿到订单签名的人都能提交成交;工程上通过签名域分隔绑定 verifyingContract、订单里限定接收方(如款必须打给指定地址或经过指定合约)、以及 nonce 在本链全局唯一,来把复用范围压缩到"同一链、同一资产、同一 nonce 只能成交一次"。

概念解释

  • 签名公开传播:订单数据(含签名)展示在列表上,任何看到的人都能提交撮合交易,这本身是设计特性。
  • 跨市场复用风险:如果两个市场用同一套签名格式且都调用同一 NFT 合约,卖家在 A 市场签的卖单,B 市场也能撮合。
  • 防复用手段一:verifyingContract 绑定——签名哈希只在本合约地址下有效。
  • 防复用手段二:nonce 全局唯一——同一条链上,该 nonce 成交一次即失效,第二个市场无法再用。
  • 防复用手段三:订单条款约束——限定币种、收款方、有效期。

原理流程

  1. 订单签名时,哈希域包含 verifyingContract = 本市场合约地址。
  2. B 市场拿到这个签名尝试撮合:调用 B 市场合约 → 校验时按 B 合约地址算哈希 → ecrecover 结果不等于 maker → 拒绝。
  3. 即便两市场共用同一份合约代码(同地址同链),nonce 已在 A 市场成交时置位,B 市场再提交时检查 nonce 已用 → 拒绝。
  4. 跨链场景:链 ID 进入哈希,A 链签名在 B 链重算哈希不匹配 → 拒绝。
  5. 残余风险:同合约同链的多个市场前端,若共用 nonce 体系则可跨前端撮合;这通常是有意设计(开放订单簿),需在产品上说明。

代码或图示

复用攻击路径与防线:

  攻击者拿到订单签名:
    路径1: 换一条链提交
      → 哈希域 chainId 不同, ecrecover ≠ maker → 拒绝
    路径2: 换另一个市场合约提交
      → 哈希域 verifyingContract 不同, ecrecover ≠ maker → 拒绝
    路径3: 同合约重复提交第二笔
      → nonce 已置位 → 拒绝
    路径4: 篡改价格字段
      → 哈希不匹配, ecrecover ≠ maker → 拒绝

  残余: 同合约同链的开放订单簿 → 任意前端可撮合(通常是特性)

常见误区

  • 误区:签名是秘密,不能泄露;正解:签名订单本来就是公开传播的,安全靠"签名绑定约束"而非"保密"。
  • 误区:把订单数据加密存储就安全了;正解:买家必须看到订单才能买,签名必然公开,防重放只能靠链上校验。
  • 误区:nonce 随机数就行;正解:nonce 必须由链上合约记录已用状态,随机数只在链上数据库里查询才有效。

追问

  • 能不能让签名"只能由平台指定地址提交"?答:可以在订单里加 allowedRelayer 字段。机制上合约校验交易提交者或订单指定的中继地址。边界在于:这会牺牲开放性,平台不可用(宕机/审查)时订单无法成交。延伸:常见做法是开放提交但限制订单条款,而非锁死提交者。
  • 卖家想中途改价怎么办?答:取消旧单 + 签新单。机制上取消旧 nonce 需要发一笔链上交易(付 Gas),新单用新 nonce。边界在于:频繁改价产生 Gas 成本与列表延迟,体验上常用"计数器批量取消"一次失效所有旧单。延伸:平台侧下架展示是免费的,但真正失效必须链上置位,否则攻击者仍可用旧签名成交。
  • 签名订单会不会被钓鱼前端骗签?答:会,签名内容必须让用户看懂。机制上 EIP-712 的结构化展示让钱包显示"你要以 X 价卖出 tokenId Y",但仍有仿冒界面风险。边界在于:钱包不展示完整字段时用户无法判断签的是什么。延伸:这与签名登录(SIWE)的风险同源,靠钱包签名展示规范与用户习惯缓解。

15.9.1-005 懒铸造怎么设计?Gas 最终由谁付?

一句话结论

懒铸造是项目方用私钥签发"铸造授权凭证"(含 tokenId、价格、版税、有效期),买家下单时把凭证与成交一起上链,合约校验签名后当场 mint 并直接转给买家——Gas 由买家承担,项目方零 Gas 上架。约束是项目方私钥必须高度安全,且授权凭证本身要防伪造、防重放。

概念解释

  • 铸造授权凭证:项目方签名的离线消息,承诺"凭此签名可以以 X 价铸造 tokenId Y"。
  • 即时铸造:买家成交交易里同时包含"mint 给买家 + 收买家款",链上一步完成。
  • Gas 转嫁:项目方部署合约与签发凭证零 Gas,买家付 mint + 转账的 Gas。
  • 风险点:项目方签名私钥若泄露,攻击者可伪造凭证以极低价铸造。

原理流程

  1. 合约部署后不预设总量,暴露 mintWithSignature(凭证, 签名)。
  2. 项目方后端为每个待售 tokenId 生成凭证(含 tokenId、价格、版税接收方、有效期),用项目私钥签名。
  3. 前端展示待售列表,买家选择后钱包付款并调用 mintWithSignature。
  4. 链上:校验项目方签名 → 检查凭证 nonce 未用 → 检查买家付款 ≥ 价格 → mint 到买家地址 → 标记 nonce。
  5. 买家同时是"mint 人"与"收款人",省去先 mint 到项目方再转账的一步 Gas。
  6. 未售出的 tokenId 永远不在链上存在,链上只有实际成交记录。

代码或图示

懒铸造流程 vs 传统铸造:

传统:
  项目方 mint 10000 件 → 自己钱包(总成本: 部署+10000笔mint, 项目方付Gas)
  → 挂单 → 买家转账带走

懒铸造:
  项目方部署合约(1笔Gas) + 离线签发 10000 份凭证(零Gas)
  → 买家下单时: 一笔交易内 校验签名+mint+收款
    Gas 构成(量级估算):
      校验签名(ecrecover)      ≈ 3000 gas
      mint 新 token(SSTORE+事件) ≈ 50000-90000 gas
      收款与分账               ≈ 20000-40000 gas
      合计 ≈ 8万-13万 gas/笔
      按 20 gwei 约 0.0016-0.0026 ETH/笔
  → 未售出 token 永远不在链上

常见误区

  • 误区:懒铸造是"免费铸造";正解:Gas 只是从项目方转嫁给买家,买家在成交时一并支付。
  • 误区:凭证不验签就能用;正解:不验签任何人都能凭空造 token,必须强校验项目方签名。
  • 误区:凭证可以重复用;正解:每份凭证必须有 nonce 或 tokenId 唯一性约束,成交后置位。

追问

  • 项目方签名私钥放哪?答:必须用多签或 HSM,绝不能放前端。机制上凭证由后端服务在签名服务器生成,后端只暴露"获取待售列表"接口。边界在于:后端被攻破即等于项目方信誉破产,攻击者可大量签发低价凭证。延伸:严肃项目用多签签发(需多个项目方 key 中的 M 个),降低单点泄露影响。
  • 买家想"囤一批凭证"怎么办?答:凭证绑定 tokenId 与价格,未成交前随时可被项目方取消(撤销公钥或置位)。机制上项目方可轮换签名公钥使旧凭证失效。边界在于:这给了项目方"反悔"能力,与买家信任冲突,需在条款中说明凭证有效期。延伸:信任型项目与无许可型项目的取舍在此再次出现。
  • 懒铸造能省多少?答:量级上省掉了项目方侧的批量 mint Gas。机制上传统 mint 10000 件是 10000 笔交易(或一批打包),每笔数万元 gas;懒铸造把铸造只发生在真实成交时。边界在于:如果发售即秒空,两种方式总 Gas 接近——懒铸造只是把付款人换了。延伸:真正的收益是"未售出零成本",适合销量不确定的项目。

15.9.1-006 前端怎么索引 NFT 列表与成交?元数据拉取失败怎么办?

一句话结论

索引层订阅合约事件(Transfer、Approval、自定义成交事件),用 subgraph 或自建索引服务把链上事件转成可查询的关系数据;前端不直接扫块,而是调索引 API。元数据按 CID/URI 拉取,缓存到自己的 CDN,失败时兜底展示,绝不能让"一个 IPFS 挂了"导致整个列表白屏。

概念解释

  • 事件订阅:合约在 mint、转账、成交时 emit 事件,索引服务从区块头同步 logs。
  • 索引服务:把 logs 解析成"谁持有 tokenId X""最近成交价多少"的表,对外提供分页查询。
  • 元数据爬取:索引服务或前端按 tokenURI 拉取 JSON,提取图片与属性,缓存。
  • 兜底展示:拉取失败显示占位图 + "元数据不可达"标签,不影响列表渲染。

原理流程

  1. 部署索引:配置合约地址与关注事件,从指定区块开始同步。
  2. 同步逻辑:每个区块扫 logs → 匹配 Transfer(from, to, tokenId) → 更新持有关系表;匹配成交事件 → 更新价格历史。
  3. 元数据处理:新 token 出现时后台任务拉取 tokenURI → 存 JSON 与图片到自有存储 → 记录拉取状态。
  4. 前端 API:提供"按集合分页列表""按持有者查""按成交查"三类接口,数据来自索引表而非实时链上查询。
  5. 失败兜底:元数据拉取失败标记 status=degraded,前端显示兜底图;定时重试拉取。
  6. 一致性校验:定期用 eth_call ownerOf(tokenId) 校正索引与链上状态,防漏块。

代码或图示

索引架构:

  链上合约 events ──→ 索引服务(同步器) ──→ 数据库
       │                  │
       │                  ├─ 持有关系表(tokenId, owner, 更新块高)
       │                  ├─ 成交记录表(tokenId, 价格, 买方, 卖方, 块高)
       │                  └─ 元数据任务队列(拉取 JSON/图片 → 自有CDN)
       │
       └─→ 定时校正: eth_call ownerOf 对比索引, 差异告警

  前端:
    列表页 → 索引 API(分页, 毫秒级响应)
    元数据图片 → 自有CDN缓存(原站失败时兜底图)

常见误区

  • 误区:前端直接 eth_call 循环查所有 tokenId;正解:几千个 tokenId 逐个 RPC 查询会被限流且延迟极高,必须用事件索引。
  • 误区:元数据实时拉取;正解:实时拉 IPFS 会拖慢首屏,必须缓存到自有 CDN 并异步更新。
  • 误区:索引同步一次就完事;正解:链上持续出块,索引服务必须跟随最新块,且要有漏块补偿与校正。

追问

  • 索引服务漏块了怎么办?答:块高游标 + 定期全量校正。机制上同步器记录已处理到的块高,重启后从断点继续;每天用 eth_call ownerOf 抽查核对。边界在于:校正只能发现差异,发现后需要回放缺失区间的 logs 才能修复。延伸:成熟方案会保留原始 logs 存档,便于任意回放。
  • 一个集合几万件,元数据爬取压力多大?答:后台异步队列 + 限速。机制上首次全量爬取分批拉取,每件一次 HTTP 请求,配合并发限制避免被 IPFS 网关限流。边界在于:公共网关本身有速率限制,大批量爬取可能被封。延伸:把元数据包直接从 IPFS 根 CID 批量取回,比逐件 HTTP 更高效。
  • 成交事件自己定义还是用 Transfer?答:必须自定义。机制上 Transfer 只说明"易手",不包含价格与平台费;市场合约应 emit 含价格、买卖方、版税的成交事件。边界在于:站外成交没有事件,索引永远记录不到,这是"链上可见 vs 链上不可见"的天然边界。延伸:可通过持有关系变化 + 链上转账推断成交,但精度差。

15.9.1-007 首次发售 mint 合约参数怎么定?白名单与阶段怎么排?

一句话结论

发售参数要同时定:总量、价格、每笔上限、阶段(预售/公售)、白名单凭证、合约暂停开关、申领截止;核心约束是"防女巫(白名单被批量撸)"与"Gas 可承受"。白名单用离线签名凭证,每阶段有独立时间窗与配额,合约层强制校验时间与上限,前端只做展示。

概念解释

  • 阶段发售:白名单预售(凭证签名)→ 公售(公开排队),各阶段独立时间窗与单价。
  • 白名单凭证:项目方离线签名"地址 X 可在预售期买 Y 件",链上验签,无需链上名单(省 Gas)。
  • 每笔/每人上限:maxPerTx 与 maxPerWallet,防止单笔囤货与女巫。
  • 申领截止:未售完的部分转入后续阶段或销毁,避免无限挂着。

原理流程

  1. 定总量与价格:总量 = 计划铸造数,价格覆盖成本 + 合理利润,单价按目标买家画像定。
  2. 定阶段:预售 48 小时(仅白名单)→ 公售开放,两阶段单价可不同。
  3. 白名单凭证:后端筛地址 → 离线签名凭证含地址、配额、有效期 → 合约 mintPresale(凭证, 签名) 验签。
  4. 合约强制:block.timestamp 在窗口内、已用量 + 本次 ≤ 该地址配额、总量未超。
  5. 暂停开关:发售异常时一键暂停 mint,已 mint 不受影响。
  6. Gas 预算:估算单笔 mint 约 8 万–12 万 gas,告知用户按当时 gas 价准备,避免用户在高 gas 期被坑。

代码或图示

发售参数示例(量级说明,非真实项目):
  总量:          10000 件
  预售期:        T+0h 至 T+48h, 单价 0.05 ETH, 每人上限 2
  公售期:        T+48h 至 T+2 周, 单价 0.08 ETH, 每笔上限 5
  白名单:        离线签名凭证, 链上验签
  暂停:          管理员可暂停 mint
  未售完:        转入后续活动或销毁

  单笔 mint Gas 量级:
    校验签名 + 时间窗       ≈ 5000 gas
    mint 新 token(存储)    ≈ 50000-90000 gas
    累计用量 SSTORE        ≈ 20000 gas
    合计 ≈ 8万-12万 gas
    按 20 gwei ≈ 0.0016-0.0024 ETH 网络费

常见误区

  • 误区:白名单上链存数组;正解:链上存几万个地址数组成本极高,离线签名凭证更省。
  • 误区:合约只限制每笔不限制每人;正解:不限每人上限,女巫用几十个钱包批量领空预售。
  • 误区:mint 价格写死不含手续费;正解:要明确"价格是否含 Gas",用户预期管理是发售事故的常见起因。

追问

  • 白名单凭证怎么防伪造?答:同懒铸造的验签机制。机制上合约只认项目方公钥签名的凭证,伪造凭证验签失败。边界在于:项目方公钥若被替换(管理员作恶),可签发任意凭证,多签与延迟升级可缓解。延伸:这又回到"信任项目方 vs 无许可"的架构取舍。
  • 发售瞬间 Gas 飙升怎么办?答:上限控制 + 分阶段。机制上每笔上限限制单人消耗,合约在高 gas 期用户可选择暂缓;更激进的做法是随机抽签(先申领后 mint),避免抢跑。边界在于:随机抽签牺牲"先到先得"的公平直觉,需在设计时讲清。延伸:这与 NFT 发售的 MEV/抢跑问题同源。
  • 售完后合约要留什么?答:预留 reveal(揭示原画)、版税接口、暂停开关的状态管理。机制上 reveal 可通过延迟 baseURI 更新实现(先挂占位图,后揭示)。边界在于:延迟 reveal 给了项目方"最后时刻改图"的空间,信任项目需谨慎。延伸:承诺"reveal 即固定"并公开生成种子,是降低信任的做法。

15.9.1-008 卖单成交后平台费与版税怎么分?push 还是 pull?

一句话结论

撮合时用"原子 push 分账"——在同一笔交易里依次把款打给卖家、平台、版税方,任一步失败整笔回滚;对于收款方频繁变动或外部调用可能失败的场景,退一步用"pull 模式"——把应付金额记账,由收款方自行提取,避免单次成交因某个外部转账失败而卡死。

概念解释

  • push 分账:合约主动向多个地址转账,一次交易完成全部分账。
  • pull 分账:合约只记账(待领余额[地址] += amount),收款方另行调用提取。
  • 外部调用风险:分账打到外部合约时,对方合约的 receive 可能 revert、消耗 gas 耗尽甚至恶意逻辑。
  • 原子性:push 模式任一转账失败 → 整笔成交回滚,保证"要么全分账要么不成交"。

原理流程

  1. 成交收款:买家付款进入撮合合约。
  2. 计算拆分:卖家款 = P × (1 - 平台费率 - 版税率);平台 = P × 平台费率;版税 = P × 版税率。
  3. push 路径:依次调用三个转账,全部成功 → emit 成交事件。
  4. 风险路径:版税接收方是恶意合约,转账时 revert → 整笔成交回滚,买家买不到。
  5. pull 路径备选:合约记录三笔待领余额,卖家/平台/版税方各自来领;成交本身不受外部合约影响。
  6. 选择原则:收款方都是可信 EOA 或简单合约 → push;收款方不确定或可能变更 → pull 或混合(核心方 push,不确定方 pull)。

代码或图示

push 分账(原子):
  合约收到 P
    ├─ transfer 卖家: P × (1-fee-platform-royalty)
    ├─ transfer 平台: P × platformFee
    └─ royaltyInfo → transfer 版税方: P × royalty
  任一失败 → 整笔回滚, NFT 不转移

pull 分账(记账 + 自取):
  合约:
    pending[卖家]   += P × (1-fee-platform-royalty)
    pending[平台]   += P × platformFee
    pending[版税方] += P × royalty
  收款方:
    function claim() { uint a = pending[msg.sender]; pending[msg.sender]=0; transfer(msg.sender, a); }

取舍:
  push: 一次成交, 体验好, 但外部转账失败风险高
  pull: 成交可靠, 收款方需多一步操作, 到账延迟

常见误区

  • 误区:分账随便打,失败了下次再补;正解:成交交易里外部调用失败会导致整笔 revert,买家体验是"买不了"而非"分账失败"。
  • 误区:pull 模式完全无害;正解:pull 增加收款方操作成本,且待领余额长期不领会形成账面负债,需要监控。
  • 误区:ETH 转账和 ERC-20 转账一样写;正解:ETH 转账用 call{value:} 且要防重入,ERC-20 转账要检查返回值(transfer 返回 bool 或直接 revert)。

追问

  • 分账时怎么防重入?答:checks-effects-interactions + 重入锁。机制上先更新所有内部状态(待领金额、nonce),最后再做外部转账;或加重入锁。边界在于:外部转账到未知合约时,对方可在回调里再次进入。延伸:pull 模式天然把外部调用移出成交路径,是更安全的选择。
  • 平台费能动态调整吗?答:可以,但要受控。机制上费率参数由管理员或治理设置,且通常上限封顶(如不超过成交价的 10%)。边界在于:成交时费率按"下单时"还是"成交时"算?订单里应锁定费率,避免撮合时费率被改导致纠纷。延伸:这是订单签名覆盖字段的又一个理由——把费率上限写进签名。
  • 版税接收方是合约且吞掉了退款怎么办?答:push 失败时整笔回滚,无法成交;pull 模式下版税方不来领。机制上合约无法替收款方决定"怎么收钱"。边界在于:协议层面可以设"版税接收方必须是 EOA 或白名单合约"来规避。延伸:这是开放市场与安全约束的永恒张力。

15.9.1-009 IPFS 网关挂了或 CID 被运营商封锁,展示层怎么兜底?

一句话结论

前端不能把可用性押在单一 IPFS 网关上:架构上做"自有 CDN 缓存镜像 + 多网关轮询 + 失败兜底图"三层;根因是元数据可用性是市场展示的 SLA 问题,不是链上问题,工程上用缓存与降级解决,而不是指望 IPFS 永远可达。

概念解释

  • 公共网关:ipfs.io/ipfs/<CID> 这类公共入口,有速率限制与可用性波动。
  • 自有镜像:索引服务把图片与 JSON 提前抓到自己的 CDN,前端默认从自有 CDN 取。
  • 多网关轮询:前端配置多个网关,一个失败自动切下一个。
  • 兜底图:拉取失败时展示占位图 + "元数据不可达"状态,列表不白屏。

原理流程

  1. 索引服务在 token 首次出现时,按 tokenURI 拉取 JSON 与图片,存入自有对象存储并 CDN 分发。
  2. 前端列表默认请求自有 CDN,秒级响应。
  3. 若自有 CDN 未命中(新 token 或缓存过期),前端按顺序尝试:网关 A → 网关 B → 自建节点。
  4. 全部失败:展示兜底图,标记"元数据加载中",后台异步重试。
  5. 监控:记录网关成功率与失败原因,调整缓存策略。
  6. 长期:严肃项目会自建 IPFS 节点做回源,不依赖公共网关。

代码或图示

展示层兜底链:

  前端请求图片
    ├─ 自有 CDN 缓存命中? ──是──→ 直接返回(毫秒级)
    │                          │
    │                          否
    │                          ↓
    │                    网关轮询:
    │                      网关A → 成功? 是→回源CDN+返回
    │                                否↓
    │                      网关B → 成功? 是→回源CDN+返回
    │                                否↓
    │                      自建节点 → 成功? 是→回源CDN+返回
    │                                        否↓
    │                                  兜底图 + 后台重试队列
    ↓
  绝不: 让一个失败请求阻塞整个列表渲染

常见误区

  • 误区:前端直接拼 ipfs.io 地址;正解:公共网关有限速与封锁风险,只能作为兜底之一。
  • 误区:元数据拉取失败就报错;正解:列表页必须降级展示,一个 token 的元数据问题不应影响其他 token。
  • 误区:缓存永远新鲜;正解:元数据(写死 CID 场景)一旦拉到就长期有效,缓存策略可激进;可篡改场景需定期校验。

追问

  • 自有 CDN 缓存了被换掉的元数据怎么办?答:区分场景。机制上写死 CID 的元数据内容永不变化,缓存安全;HTTPS 可篡改场景需定期回源校验。边界在于:校验频率与成本是权衡。延伸:这又回到"元数据是否可改"的根问题——不可改的元数据运维成本最低。
  • 移动端内嵌 WebView 拉不到 IPFS 怎么办?答:走应用层代理。机制上 App 不直接访问 IPFS,而是请求自己的后端,后端回源 IPFS 后返回。边界在于:后端成了单点与成本中心,但可控性最强。延伸:这与"去中心化存储"的产品承诺存在张力,需在文档中说明架构。
  • 一个 CID 在某些地区被封锁怎么办?答:多地域节点 + 多网关。机制上不同地区用户命中不同网关节点。边界在于:完全规避区域性封锁需要在多个司法辖区部署节点,运营成本上升。延伸:这是可用性与合规的双重问题。

15.9.1-010 同一 NFT 在十个市场挂单,版税到底在哪个环节扣?

一句话结论

版税只在"实际撮合的那一笔交易"里扣:买家在哪家市场成交,就由哪家市场合约在原子分账里按 royaltyInfo 预留;卖家同时挂十个平台,只有最终成交的那个平台扣版税,其余挂单只是未成交的签名。风险在于"买家被引导到站外成交以省版税/平台费",这是链上无法强制、只能靠商业规则约束的边界。

概念解释

  • 多平台挂单:同一卖家在多个市场挂卖单,每张单是独立的签名订单(不同 nonce)。
  • 唯一成交:十个挂单中只有一个最终被买家接受,其余随之失效。
  • 版税随成交走:成交市场合约调用版税接口并分账,未成交的挂单不产生任何链上动作。
  • 站外引导:买家与卖家私下协商,绕开市场直接转账,版税与平台费均为零。

原理流程

  1. 卖家在 A、B、C 三个市场各签一份卖单(价格可不同,nonce 各不同)。
  2. 买家在 B 市场接受 B 的卖单 → B 市场合约撮合 → 原子分账:卖家款 + B 平台费 + 版税。
  3. A、C 的挂单仍挂着(未成交),卖家可手动取消或等买家发现无人问津。
  4. 若买家绕过 B,直接联系卖家转账 → 卖家 transferFrom 给买家 → 无分账。
  5. 平台应对:对"绕开市场成交"的买卖方降低未来曝光;链上无法检测私下转账,只能靠地址行为画像。
  6. 结论:版税链路 = 成交合约的分账逻辑,与挂单数量无关。

代码或图示

多市场挂单的成交路径:

  卖家挂单: 市场A(nonce=1) 市场B(nonce=2) 市场C(nonce=3)
                    │           │           │
  买家接受 B ───────┘           │           │
  B 合约撮合:                    │           │
    ├─ NFT: 卖家 → 买家          │           │
    ├─ 款: 买家 → B合约分账      │           │
    │    ├─ 卖家 (扣除费)        │           │
    │    ├─ B 平台费             │           │
    │    └─ 版税方 ← royaltyInfo │           │
  A、C 挂单仍在, 可取消          │           │
                                │
  站外路径(无版税):              │
    买家 → 卖家钱包转账(链下约定) │
    卖家 transferFrom 给买家 ─────┘
    → 无事件, 无分账, 平台索引永远记录不到

常见误区

  • 误区:挂十个平台就要交十次版税;正解:只有成交的那一笔产生分账,挂单本身零成本零版税。
  • 误区:市场能检测到站外成交;正解:站外转账在链上只是"易手",没有价格信息,平台只能通过"持有关系变化 + 链上转账推断"做粗筛。
  • 误区:版税应该在 NFT 合约转账时自动扣;正解:转账时不知道成交价,合约无法计算版税,必须在撮合合约里完成。

追问

  • 怎么抑制站外成交?答:商业规则 + 技术引导。机制上市场对"不付版税"的 NFT 降低曝光、对绕单地址打标;技术上把尊重版税作为上市场条件。边界在于:链上没有强制力,最终靠社区共识与市场选择。延伸:这是版税在开源协议下的根本局限——你无法强制陌生人遵守你的规则。
  • 版税方在多个市场都能收到钱吗?答:只要成交市场尊重版税标准即可。机制上版税接口在 NFT 合约层,与具体市场无关。边界在于:不尊重该标准的市场不调用接口,版税为零。延伸:市场是否尊重版税是商业决策,蓝筹 NFT 可通过品牌压力获得尊重。
  • 跨平台价格不一致怎么办?答:以成交时的链上订单为准。机制上卖家在不同市场挂不同价格,买家选择最便宜的成交。边界在于:价格不一致本身就是市场行为,平台应透明展示"最低价"。延伸:这是聚合市场(comparing across marketplaces)存在的原因。

动手练习

练习 1:设计一个 NFT 集合的元数据方案

  • 任务:假设你要发 5000 件 NFT,每件图片 300KB。给出存储方案(链上/IPFS/中心化),算一次性上传与年度存储成本的量级,说明 tokenURI 是否可改以及理由。
  • 验收标准:
    1. 明确说明是否承诺"图不可改",并据此选择 baseURI 写死或可管理。
    2. 给出 IPFS pin 的冗余方案(至少两个独立来源)。
    3. 估算单图片上链与 IPFS 方案的 Gas/存储成本量级差异。

练习 2:写出一份离线签名挂单的订单结构

  • 任务:列出订单必须包含的字段,说明每个字段防的是什么风险;画出链上撮合时的校验顺序。
  • 验收标准:
    1. 包含 maker、tokenId、price、currency、deadline、nonce、chainId、verifyingContract 全部字段。
    2. 能解释为什么必须有 chainId 与 verifyingContract。
    3. 能说出重复提交同一签名时哪一步校验会拦截。

自检清单

  • [ ] 能否说出三种元数据方案在"成本/可篡改/长期可用"三个维度上的取舍?
  • [ ] 能否解释 EIP-2981 类版税为什么只在市场合约内撮合时生效?
  • [ ] 能否列出签名挂单的防重放三件套(nonce、签名域分隔、有效期)?
  • [ ] 能否说清懒铸造把 Gas 从谁转嫁给谁,以及项目方私钥的风险?
  • [ ] 能否画出事件索引从 logs 到前端 API 的完整数据流?
  • [ ] 能否估算一笔 mint 的 Gas 量级并解释每部分构成?
  • [ ] 能否说清 push 分账与 pull 分账的选择条件?
  • [ ] 能否解释多市场挂单时版税只在成交环节扣一次?

延伸阅读

  • ERC-721 与 EIP-2981 标准文档(ethereum.org / EIP 仓库当前版本):接口定义与版税返回结构。
  • EIP-712 结构化数据签名规范:签名域分隔与类型化哈希的标准做法。
  • 主流签名撮合协议的文档(如 Seaport 等):订单结构、nonce、分账的工程实现参考。
  • IPFS 官方文档:CID、pinning、网关机制。

待整理清单

  • [ ] 补充 ERC-1155 多数量版税与分账的差异
  • [ ] 补充 subgraph 索引在 NFT 场景的具体 schema 设计
  • [ ] 补充真实发售中 Gas 飙升导致 mint 失败的案例复盘(金额待确认)