Obolus
HomeResearchCreatorsDemoDocsRun research
What Obolus doesHow to run a queryHow creators get paidx402 tolls and citation royaltiesClaims, quotes, and weightsWhat a receipt provesSystem architectureSecurity and adversarial testsHow to test the claimsCurrent limits

Engineering

System architecture

The app is a Next.js and Supabase product built on Circle's Arc nanopayments reference flow.

Architecture docs

Core components

  • Context asset registry and asset chunks in Postgres/Supabase.
  • Discovery over free metadata.
  • Pay/skip planner with structured LLM output.
  • x402-gated source and citation-license endpoints.
  • Acquire, synthesize, attribute, weight, and settle libraries.
  • Public receipt and creator dashboard renderers.

Persistence

Runs, decisions, payments, syntheses, contribution weights, creator profiles, source chunks, and withdrawals are persisted so pages render from data instead of re-running the pipeline.

Read the engineering doc

The root architecture document includes table names, idempotency rules, payment flow, and scale limits.

Need the implementation-level version? Read the root README, Architecture, Security, and Adversarial Testing documents in the repository.