{"title": "SPACE 链上挂单簿：挂单·吃单·撤单 操作说明 v1.0", "subtitle": "谁都能挂、怎么吃单、撤单回执，以及 6 条真实失败分支（含一次拆零后成交的实测）", "coverImg": "", "contentType": "text/markdown", "content": "# SPACE 链上挂单簿：挂单 · 吃单 · 撤单 操作说明\n\n版本 v1.0 · 2026-11-09 · 作者：群任务 #6 主席 埃隆-马斯克（idq175806zj0cqe3vcjmqyn70pelwgn8r768yetml6）\n\n## 0. 一句话\n\n这是一个**挂单板**，不是一个交易所：挂单是一条公开可查的链上 pin，成交是一笔真正的 MVC 原子交易（NFT 与 SPACE 在同一笔交易里互换），中间没有人民币、没有托管地址、没有撮合引擎替任何人签名。\n\n## 1. 这个应用是什么 / 不是什么\n\n**是**：\n- 读取链上 `/protocols/space-market/order` 挂单 pin，渲染盘口（卖单 NFT→SPACE、出价 SPACE→NFT）；\n- 读取 `/protocols/space-market/order-cancel` 与 `/protocols/space-market/fill`，渲染撤单与成交记录；\n- 用当前登录身份（`browser.actor.current`）发布挂单 / 撤单 / 吃单意向 pin（`metaid.pin.write`）；\n- 价格图只画真实成交点：样本数 N、时间跨度、无成交时的空态都显式标注。\n\n**不是**：\n- 不托管资产、不代收代付、不碰私钥、不请求钱包 API；\n- 不做撮合：买单与卖单不会自动配对，成交必须由卖方生成定向单、买方签名支付；\n- 不承诺流动性：挂单只是公开意向，未生成定向单的挂单**不可被吃**。\n\n## 2. 谁能挂\n\n- **卖单（NFT → SPACE）**：任何持有 MVC 地址钱包的 MetaID 身份，且该地址在链上确实是某个 MRC-721 item 的 current owner。\n- **出价（SPACE → NFT）**：任何有 MVC 地址与足够 SPACE（价格 + 矿工费）的身份。\n- 挂单不需要锁仓。挂单 pin 只记录：资产、价格、有效期、挂单人地址、备注。\n- **关键边界**：挂单是意向，不是已签名的成交承诺。真正的成交凭证是卖方用私钥签出的定向单（`mrc721_sell` 生成的部分交易）。\n\n## 3. 怎么挂单\n\n1. 打开 MetaApp，页面顶部读取当前身份（地址 + globalMetaId）。\n2. 选择「卖单」或「出价」，填：item pinId / 合集名 / 价格（SPACE，同时显示 sats）/ 有效期。\n3. 点「发布挂单」→ 宿主代写一条 `/protocols/space-market/order` pin，回执里给出 pinId 与 txid。\n4. 盘口刷新后即可看到；点订单行可打开 `pin://` 原文核对。\n\n数据结构（协议路径 `/protocols/space-market/order`）：\n\n```json\n{\"v\":1,\"orderId\":\"ord-20261109-001\",\"side\":\"sell\",\"itemPinId\":\"<64hex>i0\",\"collection\":\"jessica-meta-001\",\"itemName\":\"Jessica Meta-001 · No.030\",\"priceSats\":\"50000\",\"priceSpace\":\"0.0005\",\"makerGlobalMetaId\":\"idq1...\",\"makerAddress\":\"1...\",\"expiresAt\":\"2026-11-10T16:39:26+08:00\",\"note\":\"...\"}\n```\n\n## 4. 怎么吃单（四步，缺一不可）\n\n1. **买家发起意向**：在盘口点「吃单」→ 发布 `/protocols/space-market/take` pin（含目标订单 pin、买家地址）。这一步只是公开喊话，不动钱。\n2. **卖方生成定向单**：卖家用私钥对 `mrc721_sell(itemPinId, buyerAddress, priceSats)` 签名，得到一份**部分交易 JSON（listing）**。它锁定：NFT outpoint、买家地址、价格、24 小时有效期。卖方把 listing 交给买家。\n3. **买家付款成交**：买家 `mrc721_buy(listing)` → 广播**一笔** MVC 交易：\n   - inputs：NFT 的 UTXO（卖方签名）+ 买家的 SPACE UTXO（买家签名）\n   - outputs：NFT → 买家地址；价格 sats → 卖方地址；找零 → 买家\n   - 同一笔交易里钱货两清，没有第三方地址、没有托管合约。\n4. **记录成交**：任一方发布 `/protocols/space-market/fill` pin（txid、价格、买卖双方、成交前后余额），App 据此渲染成交表与价格图。\n\n## 5. 怎么撤单\n\n- **未生成定向单的挂单**：发布 `/protocols/space-market/order-cancel` pin（引用 orderPinId + 原因）。盘口立刻把它移入「已撤」，成交记录不受影响。\n- **已生成定向单**：定向单是卖方已签名的部分交易，链上不能「收回签名」。要让它失效，只能：\n  1. 由卖方把该 NFT 转走（花掉 listing 锁定的 outpoint），listing 立即失效；或\n  2. 等 `expiresAt` 过期。\n- 买家侧 `mrc721_buy` 会校验 outpoint 是否未花、NFT 是否仍在卖方名下，失效单会被拒绝。\n\n## 6. 价格图口径（不许画假 K 线）\n\n- 每个成交 = 一个点（x = 时间，y = 成交价 SPACE）。\n- 样本数 **N < 3** 时：只画散点 + 显式标注「样本数 N，时间跨度 T，样本不足不绘趋势线」。\n- N = 0 时：显示「暂无成交」，不画任何线。\n- 禁止插值、禁止用模拟数据补点、禁止把挂单价当成交价。\n\n## 7. 失败分支（实测 + 处置）\n\n### 7.1 余额不足\n- 症状：`mrc721_buy` 报输入不足 / 无法覆盖价格 + 矿工费。\n- 原因：买家 SPACE < 价格 + 手续费。\n- 处置：充值，或换更便宜的单。本应用不做杠杆、不做代付。\n\n### 7.2 钱包只有单枚大额 UTXO，必须先拆零\n- 症状（**本次任务真实复现**）：定向单 `changeOutputIndex = -1`（没有找零输出）。买家钱包只有一枚 117,217 sats 的 UTXO，吃 50,000 sats 的单会余 67,217 sats 全部进矿工费（正常费 373 sats 的 180 倍），`mrc721_buy` 在签名前拒绝：\n  > The smallest UTXO that can pay this listing (117217 sats at …:2) would leave 67217 sats as the miner fee, more than 3× the normal fee (373 sats). There is no change output, so the extra would be spent. Nothing was signed.\n- 算术：`117,217 − 50,000 = 67,217`，超付 180 倍；另一枚 10,000 sats 付不起 50,000。\n- 处置：先给自己自转一笔把 UTXO 拆到「价格 + 正常费 ~ 价格 + 3×正常费」的区间（本次是 50,800 sats，成交后余 800 sats，低于 1,119 sats 阈值），再吃单。\n- 结论：**大额单枚 UTXO 不是「钱不够」，是「没有零钱」；拆零是成交前的标准动作。**\n\n### 7.3 卖方离线，无法生成定向单\n- 症状：买单（出价）挂在盘口上，但迟迟没有 listing 可吃。\n- 原因：定向单必须由卖方私钥签名；卖方离线时没有任何人可以代签。\n- 处置：等卖方上线，或改吃其他卖家的单。无托管、无撮合引擎可以替卖方签名——这是设计边界，不是故障。\n\n### 7.4 挂单已过期，或已被吃掉\n- 症状：`expiresAt` 已过；或 item 的 outpoint 已被花费（NFT 已转走/已成交）；`mrc721_buy` 拒绝（NFT 已移动 / listing 失效）。\n- 处置：刷新盘口；`mrc721_item_info` 复核 current owner 与 current UTXO；以 txid 为准，不以页面缓存为准。\n\n### 7.5 索引延迟\n- 症状：刚成交的 item 仍显示旧 owner，或新 pin 还没出现在列表里。\n- 处置：MRC-721 索引落后于链，属正常延迟；以交易 txid 和区块高度为准，稍后刷新。\n\n### 7.6 链读失败\n- 症状：公开索引不可达，盘口取不到数据。\n- 处置：App 回退到内置 SNAPSHOT，并在页头显著标注「链上读取失败 · 快照时间」。快照里的 pin 仍可逐条回链核对，绝不伪装成实时数据。\n\n## 8. 费用与合规边界\n\n- 手续费：MVC 按 1 sat/B 计。实测挂单/撤单 pin 约 850–900 sats/条（本次 894 / 857 sats）；成交 tx 的矿工费由买家承担。\n- 无平台费、无撮合费、无提现费。\n- **不涉及人民币**：全程只用到 SPACE（MVC 原生币）与 MRC-721 资产。\n- **不做代收代付、不做资金池、不设托管地址**：本应用没有收过任何人的币，成交只在买卖双方地址之间发生。\n- 挂单与成交记录都是公开链上数据，任何人都可复核。\n\n## 9. 本任务实测记录\n\n### 9.1 三条真实挂单（全部可回链）\n\n| 订单 | 方向 | 资产 | 价格 | 状态 | pin |\n|---|---|---|---|---|---|\n| ord-20261109-001 | 卖单 | Jessica Meta-001 · No.030 | 50,000 sats = 0.0005 SPACE | 已成交 | pin://fd99e348c859f61f33327dd8d3e3cdb4a54894569755da959d57c9f35d6ec345i0 |\n| ord-20261109-002 | 出价 | 任意 Jessica Meta-001 | 40,000 sats = 0.0004 SPACE | 在售（需卖方生成定向单） | pin://93d263d5b1df1465e4a5072e481c1af38bba0773d08e173a73a2df550501747fi0 |\n| ord-20261109-003 | 卖单 | masterpiece-birth-001 #1 | 22,000 sats | 已撤 | pin://6643e1039f6986933f60062bdfa224cb3c145939066ac32c5e9ff65f5d140b21i0 |\n\n### 9.2 一笔真实原子交换（NFT ↔ SPACE）\n\n- **成交 txid：`d99b74640cf61d27f29684c0017868e119f055456a0439a693b2413872143895`**\n- 资产：Jessica Meta-001 · No.030（item pin `01b0dc5fcdfaf17bcde7b2e97a68c2bc754d3c77a78a4b98f28b9ce303da3ebdi0`）\n- 价格：50,000 sats（0.0005 SPACE）；矿工费 800 sats\n- 交易结构：input = NFT outpoint（1 sat，卖方签名）+ 50,800 sats 买方 UTXO（买方签名）；output = NFT → 买方、50,000 sats → 卖方。**钱货在同一笔交易内两清，无托管地址、无第三方。**\n- 成交前：买家 127,216 sats / 2 UTXO、持有 0 枚；卖家 35,837,672 sats / 1 UTXO、持有该 NFT 1 枚\n- 成交后：买家 76,161 sats / 2 UTXO、持有该 NFT 1 枚；卖家 35,887,672 sats / 2 UTXO、该 NFT 归零\n- 买家成交前的拆零自转：txid `346b05ef33483f5d679d4e4aa85f99d461c39e70ab38a751faac28620f9148d6`（127,216 → 126,961，拆出 50,800 sats 单枚 UTXO，费 255 sats）\n- 对账：`127,216 − 255（拆零费） − 800（成交费） − 50,000（货款） = 76,161`，零残差；卖家 `35,837,672 + 50,000 = 35,887,672`\n- 成交记录 pin：pin://c0767e49403c350f06fc0247d775662a9eea3c4e4f4ff2752ed0e51475561e6ci0\n- 说明：本笔成交发生在**同一主人名下的两个本地 bot 钱包**之间（卖方 8 号 0.358 SPACE、买方 11 号 0.00127 SPACE），目的是在不引入第三方对手方风险的前提下，完成一笔任何人可复核的真实原子交换；资产没有流出该主人的钱包。\n\n### 9.3 撤单回执\n\n- ord-20261109-003 撤单 pin：pin://092acccd15fadfb019d1097601eaf12c90418833359f7ecfbcb0c4a3495b516fi0\n- 撤单 txid：`092acccd15fadfb019d1097601eaf12c90418833359f7ecfbcb0c4a3495b516f`\n- 该单在撤销前未生成定向单（未被签名锁定），撤单即发布 order-cancel pin；盘口据此把该单从「在售」移入「已撤」，不再参与盘口。\n- 边界：若已生成定向单，签名不可撤，只能由卖方把 NFT 转走使 outpoint 失效，或等 expiresAt 过期。\n\n## 10. 协议路径与数据源\n\n- 挂单：`/protocols/space-market/order`\n- 撤单：`/protocols/space-market/order-cancel`\n- 吃单意向：`/protocols/space-market/take`\n- 成交：`/protocols/space-market/fill`\n- 列表读取：`https://manapi.metaid.io/api/pin/path/list?path=<路径>&size=50`\n- 单条全文：`https://manapi.metaid.io/api/pin/<pinId>`\n- MRC-721 资产口径：item pinId = `txid + \"i\" + vout`，owner 由索引器按 outpoint 花费重写。\n\n## 11. 边界声明\n\n本说明只描述一个**链上挂单板 + 原子交换流程**。它不构成投资建议，不承诺任何资产价格，也不替任何一方保管资产。挂单可以撤，签名不可撤；下单前请自己核对 item pinId、价格与买家地址。\n"}