playbooks

home / skills / openclaw / skills / planetexpress-marketplace

planetexpress-marketplace skill

/skills/timowhite88/planetexpress-marketplace

This skill helps you buy, browse, and list encrypted files on the Planet Express marketplace using x402 payments across MON, SOL, or USDC.

npx playbooks add skill openclaw/skills --skill planetexpress-marketplace

Review the files below or copy the command above to add this skill to your agents.

Files (3)
SKILL.md
3.0 KB
---
name: planetexpress-marketplace
description: Decentralized file marketplace on Monad blockchain — buy, sell, and browse encrypted files with x402
homepage: https://planetexpress.dropclaw.cloud
user-invocable: true
---

# Planet Express Marketplace — Decentralized File Commerce

A decentralized marketplace for buying and selling encrypted files on Monad blockchain. Escrow-secured transactions with multi-chain payment support via x402.

## Quick Reference

- **API Base**: `https://dropclaw.cloud/marketplace`
- **Protocol**: x402 (HTTP 402 payment flow)
- **Chain**: Monad (chainId 143)
- **Contract**: `0xeFc5D4f6ee82849492b1F297134872dA2Abb260d`
- **Payment**: MON, SOL, or Base USDC
- **Frontend**: `https://planetexpress.dropclaw.cloud`

## Endpoints

### Browse Listings (Free)
```
GET /marketplace/listings
```
Returns all active marketplace listings.

### Get Listing Detail (Free)
```
GET /marketplace/listing/{id}
```
Returns listing detail with pricing in MON/SOL/USDC.

### Purchase a File (x402 Payment)
```
POST /marketplace/purchase
Content-Type: application/json

{
  "listingId": 123,
  "buyerAddress": "0x..."  // optional
}
```
Triggers x402 flow: receive 402 → pay on preferred chain → retry with X-PAYMENT header.

### List a File for Sale ($30 Listing Fee)
```
POST /marketplace/list
Content-Type: application/json

{
  "fileId": "dropclaw-file-id",
  "title": "My File",
  "description": "What this file contains",
  "skillFileUri": "ipfs://Qm...",
  "keyHash": "0x...",
  "price": "0.5"
}
```
Requires x402 payment of $30 listing fee.

## Purchase Flow

1. `GET /marketplace/listings` to browse available files
2. `GET /marketplace/listing/{id}` for detail + pricing
3. `POST /marketplace/purchase` with `{ listingId }` — receive 402 with payment options
4. Send payment on your preferred chain (MON, SOL, or USDC on Base)
5. Retry POST with `X-PAYMENT: base64(JSON({ network, txHash }))`
6. Receive the encrypted file + skill file for decryption

## Listing Flow

1. First store your file via DropClaw (`POST /vault/store`) — this gives you a fileId
2. `POST /marketplace/list` with file details and price — triggers $30 listing fee via x402
3. Pay the listing fee on any supported chain
4. Your file appears in the marketplace for others to purchase

## Fees

| Fee | Amount | Notes |
|-----|--------|-------|
| Listing fee | $30 USD | Paid when listing a file for sale |
| Buyer fee | ~$1 USD | Added to purchase price |
| Delivery fee | 2.5% | Of listing price |
| FARNS buyback | 50% | Half of all protocol fees buy $FARNS |

## Payment Chains

- **Monad** (eip155:143) — MON native, direct contract interaction
- **Solana** (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp) — SOL, facilitated
- **Base** (eip155:8453) — USDC, facilitated

## Frontend

The marketplace has a fully decentralized frontend hosted on IPFS:
- **Web**: `https://planetexpress.dropclaw.cloud`
- **IPNS**: `k51qzi5uqu5di1vh2ybr8qipy8mod859fjb0i548af7qyopyctlv7zpjblukee`

Install SDK: `npm i dropclaw` or `pip install dropclaw`

Overview

This skill implements a decentralized file marketplace on the Monad blockchain that lets users browse, buy, and sell encrypted files using x402 payment flows. It provides escrow-secured transactions, multi-chain payment support (MON, SOL, Base USDC), and an IPFS-hosted frontend. The skill integrates with DropClaw storage to store files and generate listing entries.

How this skill works

The skill exposes REST endpoints to list and inspect marketplace items and to initiate purchases. Purchases trigger an x402 HTTP 402 payment flow: the client pays on a supported chain, then retries the request with an X-PAYMENT header containing network and txHash to complete delivery. Sellers upload files to DropClaw vault, create a listing which requires a $30 x402 listing fee, and the marketplace handles escrow, delivery of encrypted content, and protocol fee accounting.

When to use it

  • You need a decentralized marketplace for selling encrypted files with on-chain payments and escrow.
  • You want multi-chain payment support (Monad, Solana, Base USDC) with a simple HTTP payment flow.
  • You need to archive or distribute files via IPFS and control access via encrypted delivery.
  • You want a drop-in backend for a data marketplace or digital goods storefront with escrowed transfers.

Best practices

  • Store files first in DropClaw vault to obtain a stable fileId before creating a listing.
  • Verify listing details (price, keyHash, skillFileUri) before paying the listing fee.
  • When completing purchases, include X-PAYMENT as base64(JSON({ network, txHash })) after on-chain payment.
  • Keep a local copy of encrypted skill file and key metadata to support decryption after delivery.
  • Monitor tx confirmations on the chosen chain before retrying the purchase API to avoid failed deliveries.

Example use cases

  • Sell research datasets or proprietary models as encrypted files with pay-per-delivery.
  • Buy licensed digital assets across MON, SOL, or Base networks using the same HTTP flow.
  • Archive all versions of skills and distribute them via IPFS-backed listings.
  • Integrate marketplace flow into a dApp frontend to accept payments and automatically deliver encrypted artifacts.

FAQ

How does payment completion work?

After receiving a 402 response, pay on the indicated chain, then retry the purchase endpoint with X-PAYMENT set to base64 JSON containing network and txHash to trigger delivery.

What payment networks are supported?

Monad (MON native), Solana (SOL), and Base (USDC) are supported. The 402 flow lists available options for each purchase.