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. Payments prove money moved; SettleProof proves whether the merchant delivered.

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.

API/data wedge

The first focused market: paid API calls and data delivery where proof can be hashed cleanly.

Market brief

The honest commercial framing: unit economics, comparables, revenue scenarios, and anti-vanity takeaways.

Public API

Headless agent surface: registry, proof templates, evidence packets, relay, indexer, and 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.

Light audit

Devnet contract review notes, current controls, residual risks, and mainnet blockers.

Mainnet readiness

The honest pre-mainnet checklist: audit, keys, registry policy, ops, monitoring, and governance.

vs Visa

Settlement and dispute latency benchmarks against the legacy chargeback flow.

Devnet status

Program	Address (devnet)	Solana Explorer
`aap_custody`	DbpCDpaHvKmWgbFxqHJAaEZ35Zz96yCuNB6V5c91WnFp	view ↗
`aap_attestor`	DcbEtMkSJczzbQgUC9vUeKhGfQZ4HKYMFbjAyXH2gXaa	view ↗

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	22 ✓
SDK smoke tests	12 ✓
Devnet demo flows	guided demo, release, refund, partial, x402, API
Public API	OpenAPI + registry + templates + evidence + relay + indexer
Docs routes	/docs + 10 focused sections
Default merchant attestation	Ed25519 (sysvar verified)
Default escrow TTL	24h (config 1s–7d)