What is x402 in this marketplace?

x402 is the HTTP 402 payment flow used to coordinate cross-chain payments for purchases. It initiates payment on MON, SOL, or USDC and then retries with an X-PAYMENT header to complete delivery.

Which payment currencies are supported?

MON on Monad, SOL on Solana, and USDC on Base are supported for purchases and listing-related payments.

How do I get the encrypted file after paying?

After initiating the purchase, complete the cross-chain payment as directed and retry the purchase call with the X-PAYMENT header. You will receive the encrypted file and the decryption key (skill file) for access.

Planet Express Marketplace

Scanned

@timowhite88

npx machina-cli add skill @timowhite88/planetexpress-marketplace --openclaw

Files (1)

SKILL.md

3.0 KB

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

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

Listing Flow

First store your file via DropClaw (POST /vault/store) — this gives you a fileId
POST /marketplace/list with file details and price — triggers $30 listing fee via x402
Pay the listing fee on any supported chain
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

Source

git clone https://clawhub.ai/timowhite88/planetexpress-marketplaceView on GitHub

Overview

Planet Express Marketplace is a decentralized platform for buying and selling encrypted files on the Monad blockchain. It enables escrow-secured transactions with multi-chain payment via x402, supporting MON, SOL, or Base USDC. Users can browse, list, and purchase files with encrypted delivery and decryption keys.

How This Skill Works

Sellers store their files with DropClaw to obtain a fileId, then list them for sale (including price) via the marketplace. Buyers browse listings through the API, initiate a purchase which starts the x402 flow, pay on MON, SOL, or USDC, and then retry with the X-PAYMENT header to receive the encrypted file and decryption information. The flow leverages REST endpoints like /marketplace/listings, /marketplace/listing/{id}, and /marketplace/purchase, with escrow-enabled transactions on Monad.

When to Use It

You need to securely buy or sell encrypted files on a decentralized marketplace.
You want escrow-secured transactions that support multiple payment chains (MON, SOL, Base USDC) via x402.
You are listing a file for sale and paying a $30 listing fee through the x402 flow.
You require a decentralized frontend experience via IPFS for the marketplace.
You want end-to-end visibility of listings and detailed pricing across MON/SOL/USDC.

Quick Start

Step 1: Store your file via DropClaw (POST /vault/store) to get a fileId.
Step 2: List the file for sale (POST /marketplace/list) with fileId, title, description, price.
Step 3: Purchase a file (POST /marketplace/purchase) and complete the x402 payment flow with X-PAYMENT header to receive the encrypted file.

Best Practices

Store the file with DropClaw first to obtain a fileId before listing.
Verify listing details (title, description, price) and accepted currencies on MON/SOL/USDC.
Use the x402 flow correctly: initiate purchase, pay on your chosen chain, then retry with X-PAYMENT.
Keep the decryption key and skill file secure until after purchase completion.
Regularly monitor listings for changes and ensure frontend endpoints are up-to-date.

Example Use Cases

A creator uploads a dataset via DropClaw, stores it, and lists it for sale with a $0.5 price in MON/SOL/USDC.
A buyer browses /marketplace/listings, views details with /marketplace/listing/{id}, and initiates /marketplace/purchase to start x402.
A seller pays the $30 listing fee through x402 and the file becomes visible in the marketplace.
A buyer completes payment on Base USDC, then retrieves the encrypted file and decryption key.
The decentralized frontend on IPFS serves the marketplace with a fully permissionless experience.

Frequently Asked Questions

Add this skill to your agents