Documentation
Build on SettleProof.
SettleProof is powered by AAP, a Solana protocol that holds USDC until a registered merchant signs cryptographic proof of delivery. Valid proof releases funds. Missing proof before TTL refunds them automatically. No chargebacks.
Sections
Quickstart
Install, run the canonical devnet scenarios, hit the x402 paywall, and inspect the hosted API.
Architecture
On-chain programs, PDA derivations, the CPI graph, and the Ed25519 sysvar verification.
Public API
Headless agent surface: API console, prepare, relay, indexer, escrow reads, and merchant reads.
SDK reference
AapClient methods, PDA helpers, off-chain message signing.
x402 paywall
Drop-in Express middleware that converts HTTP 402 challenges into on-chain escrows.
Threat model
Trust boundaries, current controls, beta limitations, and what must be hardened before mainnet.
vs Visa
Settlement and dispute latency benchmarks against the legacy chargeback flow.
Devnet status
Public endpoints
| Host | Role | Runtime |
|---|---|---|
| settleproof.xyz | landing + docs | Next.js app |
| demo.settleproof.xyz | demo merchant + x402 backend | Express service on apps/demo-merchant |
| api.settleproof.xyz | relay, indexer, and public API surface | Express console + /v1 JSON API on apps/api |
One picture
agent → card issuer → ★ SettleProof / AAP custody (Solana) ★ → merchant
│
┌───────────┴───────────┐
▼ ▼
attestation OK TTL expired
→ release USDC → refund USDC
(Ed25519 verified) (auto, no dispute)At a glance
| Metric | Value |
|---|---|
| On-chain programs | 2 (aap-custody + aap-attestor) |
| Anchor integration tests | 19 ✓ |
| SDK smoke tests | 8 ✓ |
| Devnet demo flows | release, refund, partial, x402, API |
| Public API | console + /v1/status, prepare, relay, indexer |
| Docs routes | /docs + 7 focused sections |
| Default merchant attestation | Ed25519 (sysvar verified) |
| Default escrow TTL | 24h (config 1s–7d) |