Planet Express Marketplace — 去中心化文件交易市场

基于 Monad 区块链的去中心化文件买卖市场。通过 x402 协议支持多链支付，交易由托管机制保障安全。

快速参考

• API 基础地址: https://dropclaw.cloud/marketplace
• 协议: x402（HTTP 402 支付流程）
• 区块链: Monad（chainId 143）
• 合约地址: 0xeFc5D4f6ee82849492b1F297134872dA2Abb260d
• 支付方式: MON、SOL 或 Base 上的 USDC
• 前端界面: https://planetexpress.dropclaw.cloud

接口列表

浏览商品列表（免费）

GET /marketplace/listings

返回所有当前有效的市场商品列表。

获取商品详情（免费）

GET /marketplace/listing/{id}

返回商品详细信息，包含 MON/SOL/USDC 三种计价单位的价格。

购买文件（x402 支付流程）

POST /marketplace/purchase
Content-Type: application/json

{
  "listingId": 123,
  "buyerAddress": "0x..."  // 可选
}

触发 x402 流程：接收 402 响应 → 在首选链上完成支付 → 使用 X-PAYMENT 头重试请求。

发布文件出售（$30 发布费）

POST /marketplace/list
Content-Type: application/json

{
  "fileId": "dropclaw-file-id",
  "title": "我的文件",
  "description": "该文件的内容说明",
  "skillFileUri": "ipfs://Qm...",
  "keyHash": "0x...",
  "price": "0.5"
}

需通过 x402 支付 $30 的发布费用。

购买流程

1. 使用 GET /marketplace/listings 浏览可购买文件
2. 使用 GET /marketplace/listing/{id} 获取详情及价格信息
3. 使用 POST /marketplace/purchase 提交 { listingId } —— 将收到 402 响应并显示支付选项
4. 在您偏好的链上完成支付（MON、SOL 或 Base 上的 USDC）
5. 使用 X-PAYMENT: base64(JSON({ network, txHash })) 重新提交请求
6. 成功后获取加密文件及用于解密的技能文件

发布流程

1. 首先通过 DropClaw 存储文件（调用 POST /vault/store）—— 此操作将生成一个 fileId
2. 使用 POST /marketplace/list 提交文件信息与定价 —— 触发 $30 发布费的 x402 支付
3. 在任意支持的链上支付发布费用
4. 文件将在市场中上线，供他人购买

费用说明

支付链路支持

• Monad（eip155:143）—— MON 原生币，直接合约交互
• Solana（solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp）—— SOL，由系统协助处理
• Base（eip155:8453）—— USDC，由系统协助处理

前端界面

市场前端为完全去中心化的应用，部署在 IPFS 上：

• 网页访问: https://planetexpress.dropclaw.cloud
• IPNS 地址: k51qzi5uqu5di1vh2ybr8qipy8mod859fjb0i548af7qyopyctlv7zpjblukee

安装 SDK：npm i dropclaw 或 pip install dropclaw