An agent-payable marketplace for licensable video moments.
Autonomous AI agents discover short, rights-cleared clips and pay for them with tiny USDC nanopayments over x402 on Arc — no human, no invoice, no card. Every license settles instantly and splits 80 / 12 / 8 on-chain.
How it works · For agents · Architecture · Deployment · Quickstart
Findling is a two-sided agent economy:
- Buyer agents discover a moment by natural-language intent and pay its
unlockUrlto license it. - Finder agents curate moments to make them findable and earn 12% of every license they surfaced — accrued instantly, withdrawable on-chain to their own wallet.
Money is integer micro-USDC everywhere (1 USDC = 1,000,000). USDC is Arc's native currency, so every payout is a verifiable on-chain transfer.
flowchart LR
subgraph Agents["Autonomous agents"]
BUY["Buyer agent<br/>(licenses moments)"]
FIND["Finder agent<br/>(curates · earns 12%)"]
end
CREATOR["Creator<br/>(uploads / imports clips)"]
subgraph Findling["Findling — Next.js app"]
WEB["Creator Studio<br/>(web UI)"]
API["Agent API + MCP server"]
PAY["x402 unlock + settlement<br/>(80 / 12 / 8 split)"]
end
DB[("Postgres + pgvector<br/>Supabase")]
STORE[("Object storage<br/>clips · posters")]
EMB["Local embeddings<br/>bge-small-en-v1.5"]
GW["Circle Gateway"]
ARC["Arc testnet<br/>USDC settlement"]
CREATOR --> WEB
BUY <-->|search · 402 · pay| API
FIND -->|curate| API
API --> PAY
WEB --> DB
API --> DB
PAY --> DB
API --> EMB --> DB
WEB --> STORE
PAY -->|settle + payout| GW --> ARC
A buyer agent's full license loop is a single x402 round-trip:
sequenceDiagram
participant A as Buyer agent
participant F as Findling
participant G as Circle Gateway
participant C as Arc (USDC)
A->>F: POST /api/agent/search { query, maxPrice }
F-->>A: ranked candidates + agentRunId
A->>F: GET /api/agent/moments/{id}?grantId&agentRunId
F-->>A: detail + x402 unlockUrl
A->>F: GET unlockUrl (no payment)
F-->>A: 402 Payment Required (challenge)
A->>G: pay challenge with funded session key
A->>F: GET unlockUrl + Payment-Signature
F->>F: verify → reserve grant cap → settle
F->>G: split 80/12/8 + record receipt
G->>C: USDC settles on Arc
F-->>A: 200 + signed clip URL + receipt
The whole decision is auditable: every search→pick→pay→settle is recorded as an agent run and a public receipt.
The live, self-describing agent skill is served as markdown at /skill.md:
curl https://<host>/skill.mdIt documents the full loop end-to-end: authenticate (SIWE wallet proof → bearer key), discover, authorize spending (a capped session grant), license (pay x402), curate, withdraw, and trace.
Two ways in, same capabilities:
| Surface | How |
|---|---|
| REST | Authorization: Bearer <fdl_agent_…> — the /api/agent/* routes, plus license (GET /api/payments/x402/.../unlock) and payout (POST /api/earnings/withdraw) |
| MCP | Hosted at /api/mcp (point any MCP client with Authorization: Bearer <key> — no install), or the local stdio server (pnpm mcp, src/server/mcp/server.ts); tools search_moments, get_moment, submit_curation, get_earnings, request_withdraw, get_agent_run |
Findling never holds a buyer's key: discovery returns each moment's unlockUrl,
and the agent pays it with its own wallet via GatewayClient.pay().
Every settled license divides the gross exactly:
flowchart LR
G["Gross USDC<br/>(buyer agent pays)"] --> CR["80% creator"]
G --> FI["12% finder"]
G --> PL["8% platform"]
CR --> L["Ledger accrual<br/>(instant, off-chain)"]
FI --> L
L -->|withdraw on demand| ARC["On-chain payout<br/>to Arc wallet"]
- Credited instantly in the ledger the moment a license settles.
- Withdrawn on-chain on demand — a real Circle Gateway payout to the participant's registered Arc wallet, traceable on the explorer.
The Creator Studio surfaces this as a real on-chain transactions ledger — license credits in, payouts out, a running balance, and a clickable Arc tx on every payout:
| Layer | Choice |
|---|---|
| Framework | Next.js 16 (App Router, RSC, Turbopack) + React 19 + TypeScript |
| Styling | Tailwind v4 (CSS-variable theme tokens) |
| Data | Drizzle ORM → Postgres (Supabase) with pgvector (HNSW cosine) |
| Search | Local HF embeddings — Xenova/bge-small-en-v1.5 (384-dim) |
| Payments | Circle Gateway via @circle-fin/x402-batching — x402 on Arc testnet |
| Auth | SIWE (EIP-4361) for humans; wallet-proven bearer keys for agents |
| Media | ffmpeg clip/poster/preview pipeline; object storage for delivery |
pnpm install
cp .env.example .env.local # fill in DB, Supabase, Circle/Arc, auth secrets
pnpm db:migrate # apply the Drizzle schema
pnpm dev # http://localhost:3000Withdrawals (payouts) run against a deterministic mock unless
PAYMENT_PROVIDER=gateway_x402 is set (which needs a funded seller Gateway
balance); that mock is refused in production, so a misconfig can never mint a
fake "succeeded" payout. The buy / settle path always uses the real Arc
gateway and needs GATEWAY_FACILITATOR_URL + SELLER_ADDRESS configured.
See docs/ARCHITECTURE.md for the full architecture, data model, and subsystem diagrams. See docs/DEPLOYMENT.md for the live deployment checklist and demo smoke tests, and docs/AUDIT.md for the security/correctness audit.
| Path | What lives there |
|---|---|
src/app/ |
Routes — Creator Studio pages, agent + auth APIs, x402 unlock, /skill.md, receipts, agent traces |
src/server/agent/ |
Agent search, ranking, run tracing |
src/server/payment/ |
x402 / Circle Gateway providers (+ mock) |
src/server/ledger/ |
Earnings derivation, settlement recording, withdrawals |
src/server/split/ |
The 80/12/8 split math (computeSplit) |
src/server/catalog/ |
Asset / clip-job / moment writes; studio + transactions read-models |
src/server/search/ |
Embeddings + pgvector retrieval |
src/server/auth/ |
SIWE, agent credentials, sessions, session grants |
src/server/mcp/ |
MCP server exposing the agent surface |
src/server/db/schema.ts |
The full Drizzle schema (single source of truth) |
docs/ |
Architecture docs + design briefs |