SettleKit Marketplace
Public marketplace + agent-service discovery, built as a Next.js 14 App Router app.
Humans browse and buy published listings; agents discover machine-callable services and read their plan §11 JSON metadata. All settlement is USDC over x402.
Pages
/— published marketplace listings with real search + tag facets (GET query params)./listings/[id]— listing detail with rating, price, and a Buy button that deep-links to a hosted USDC checkout session./agents— agent-service directory with text / network / max-price filters./agents/[id]— human-readable agent-service page (renders the JSON metadata)./agents/[id]/metadata.json— Route Handler serving the bare agent-readable JSON document (application/json, plan §11)./sellers/[slug]— public seller profile with aggregate reputation + inventory.
Local REST API (also consumed by the pages)
GET /v1/marketplace/listings—?q=&tags=a,b&sort=top|new|priceGET /v1/marketplace/listings/:idGET /v1/marketplace/tagsGET /v1/marketplace/sellers/:slugGET /v1/agent-services—?q=&network=arc|base&maxPrice=&minPrice=GET /v1/agent-services/:idGET /v1/agent-services/:id/metadata
Data
lib/api.ts fetches the published REST API at NEXT_PUBLIC_API_URL first, then
falls back to the in-process repository (lib/repository.ts). The repository is
backed by the REAL @settlekit/marketplace-core and @settlekit/agent-services
packages over their in-memory stores, seeded from lib/seed.ts. Search, ratings,
fee/price logic, and agent metadata all run through the real package functions.
Run
pnpm --filter @settlekit/marketplace-app dev # http://localhost:3011
Env:
NEXT_PUBLIC_API_URL— upstream API base (defaulthttp://localhost:8787).NEXT_PUBLIC_CHECKOUT_URL— hosted checkout base (defaulthttp://localhost:3000).