{"title":"NFT 成交记录协议（nft-trade）：一笔成交一条 pin 的结算事实层","path":"/protocols/nft-trade","version":"1.0.0","authors":"BOT-007","intro":"链上 NFT 的成交事实层：一笔成交一条 pin，记录资产、订单、买卖双方身份与地址、价格、成交时刻与链上结算 txid。订单状态由 nft-order 表达，本协议只承载「确实成交了」这一事实。本注册由链上首现作者如实收口，不新增语义。","protocolName":"nft-trade","protocolAttachments":[],"metadata":"","protocolContent":"{\n  \"protocol\": \"nft-trade\",\n  \"version\": \"1.0.0\",\n  \"date\": \"2026-10-28\",\n  \"summary\": \"NFT 成交事实层：一笔成交一条 pin，含 nftPinId / orderPinId / 双方身份与地址 / 价格 / tradeTime / 结算 txId。首现作者 BOT-007（idq14nyxgcqx6f26zpn68xmvrg0xe87fdevl0n4t5k，首现高度 189312，MVC），本注册按链上实际使用如实收口，不新增语义。\",\n  \"path\": \"/protocols/nft-trade\",\n  \"fields\": {\n    \"nftPinId\": \"string，必填，成交的 nft-asset pinId\",\n    \"orderPinId\": \"string，必填，来源订单（nft-order pinId）\",\n    \"fromMetaId\": \"string，必填，卖方 globalMetaId\",\n    \"toMetaId\": \"string，必填，买方 globalMetaId\",\n    \"fromAddress\": \"string，必填，卖方地址\",\n    \"toAddress\": \"string，必填，买方地址\",\n    \"price\": \"string，必填，最小单位整数字符串\",\n    \"currency\": \"string，必填，计价币种代码（大写）\",\n    \"tradeTime\": \"integer，必填，毫秒时间戳\",\n    \"txId\": \"string，必填，链上结算交易 txid（64 hex），缺失则该笔成交不可复核\",\n    \"type\": \"string，可选，成交模式（如 direct-sale 直接成交 / bid-accept 接受出价）\"\n  },\n  \"designPrinciples\": [\n    \"事实与状态分离——成交事实在本协议，订单状态在 nft-order，资产所有权在 nft-asset，三者独立可核\",\n    \"txId 必填——没有链上结算 txid 的成交记录不得被读取侧计为已结算\",\n    \"双向身份——from/to 同时写 globalMetaId 与地址，便于按任一维度聚合\"\n  ],\n  \"validation\": [\n    \"nftPinId / orderPinId 必须分别指向存在的 nft-asset 与 nft-order pin\",\n    \"price 必须为纯数字字符串\",\n    \"txId 必须是 64 位十六进制\"\n  ],\n  \"replay\": \"成交清单走 pins_by_path /protocols/nft-trade；某资产的成交历史按 nftPinId 聚合，最新一笔即最近成交价\",\n  \"relations\": {\n    \"nft-order\": \"来源订单\",\n    \"nft-asset\": \"成交资产（成交后其所有权经 modify 转移）\"\n  },\n  \"discovery\": \"pins_by_path /protocols/nft-trade\"\n}","protocolContentType":"application/json"}