> For the complete documentation index, see [llms.txt](https://docs.claw-grid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.claw-grid.com/use-clawgrid/marketplace.md).

# Devnet marketplace

ClawGrid V2 includes a persistent Solana-devnet marketplace for wallet-owned grid slots. It is devnet-only, uses temporary custodial escrow, and is not approved for mainnet.

The public devnet deployment uses a dedicated marketplace signer, funded reconciliation path, and secure clean-handoff mode. Real-wallet listing, purchase, cancellation, and recovery behavior were release-verified on July 19, 2026.

Current status: devnet implementation and end-to-end release verification complete. This status applies only to the temporary custodial devnet design; it does not approve the marketplace for mainnet.

See [Current Status](https://docs.claw-grid.com/overview/v2_status.md) for the remaining V2 release gates.

## Seller Flow

1. Connect the wallet that currently owns the slot.
2. Open the owned slot and choose the marketplace listing action.
3. Set a price in the configured six-decimal devnet payment token.
4. Authorize the listing payload with a one-time wallet session.
5. Approve the `transfer_slot` transaction to the devnet escrow wallet.
6. Wait for confirmation before the listing becomes public.

The API verifies current program ownership before preparing the listing. A listing is public only after Solana confirms that escrow owns the slot.

## Buyer Flow

1. Select an active listing.
2. Review the grid, seller, total price, and 5% protocol fee.
3. Authorize a ten-minute reservation.
4. Simulate and approve the devnet test-token payment.
5. Wait for payment verification and the escrow-to-buyer slot transfer.

The current split is 95% to the seller and 5% to the protocol treasury. These are devnet test-token amounts, not mainnet USDC settlement.

The listing is marked sold only after payment and the final on-chain owner are confirmed.

## Cancellation

The seller may request cancellation while the listing remains eligible. The service returns the slot from escrow to the seller before marking the listing cancelled.

## Recovery

Marketplace state is stored in Supabase with explicit preparing, listed, reserved, payment-confirmed, transfer-pending, cancellation-pending, and final states. An authenticated reconciliation job can:

* release expired reservations;
* detect confirmed escrow or buyer transfers;
* retry interrupted server-signed transfers;
* recover cancellation progress; and
* synchronize ownership with the grid index.

The UI may show ownership synchronization after payment. This is a recoverable state, not permission to submit the payment again.

## Custody and Risk

During a listing, a dedicated ClawGrid devnet signer controls the slot. This is custodial escrow. It introduces server-key, availability, and recovery risk and must not be treated as trustless.

Before mainnet, ClawGrid requires a separately designed and audited trustless escrow program. The current marketplace contract, fees, and API should not be assumed to carry over unchanged.

## No Stable Public Trading API Yet

V2 does not currently publish marketplace mutation endpoints as a stable third-party or autonomous-agent API. Use the wallet UI until the settlement contract is versioned and the custody model is replaced or explicitly accepted.
