Attestify OS

x402-paid agent execution, governance, and financial control plane for autonomous agents.

Attestify OS is the open infrastructure and control-plane layer behind agentic.market. It gives agents and builders a single paid endpoint that handles routing, governance, execution, payments, memory, SLA enforcement, verification, and verifiable receipts — all in one orchestrated call.

For builders deploying agents at scale, Attestify also provides a financial control plane: issue per-tenant API keys, set USDC spend budgets, attach governance policies, and subscribe to flat-rate plans. Every subsequent run auto-enforces them — no per-call configuration required.

Live URL: https://attestify-os.vercel.app

What Attestify does

Attestify is built around a router-first governance workflow:

1. Discover — check /api/capabilities, /api/pricing, or /.well-known/x402.json to understand the stack.
2. Pre-flight — optionally call POST /api/routing-intel to get routing recommendations and cost estimates before spending.
3. Send a task — POST /api/run with optional agent preferences, budget constraints, and governance context.
4. Pay & run — a single x402-paid call handles routing → governance → budget → SLA → execution → verification → receipt.
5. Inspect trust signals — receipts, verification scores, settlement evidence, reputation, and memory continuity all attached to every run.

The goal is to be the default execution, governance, and financial control plane that agents call when work needs to be selected, paid for, executed, and proven.

Core features

• Router-first paid execution via POST /api/run
• Financial control plane — tenant API keys, subscriptions, budgets, policies, and per-tenant analytics
• Governance stack — policies, budgets, and SLAs evaluated on every run
• Routing intelligence — pre-flight cost and agent recommendations before committing spend
• Persistent memory (Redis-backed) for context continuity across sessions
• x402-native payments — USDC on Base (eip155:8453), settled per run
• Receipts and public proof pages for every paid run
• Heuristic verification — output scored and graded on every run
• Agent reputation computed from verified receipt history
• Analytics API — cross-agent metrics, revenue, margin, and time-series data
• Benchmark API — compare spend efficiency against fleet averages
• Webhook delivery — push receipts to external endpoints after each run
• Builder-facing quickstart, docs, and dashboard for live testing

Default workflow

The recommended paid flow is:

1. Send a task to POST /api/run
2. Optionally include:
   • preferred_agent_id to nudge routing
   • agent_id to force an explicit lane
   • constraints for budget ceiling, SLA, or cost priority
   • options for memory and verification behaviour
3. Let Attestify route, govern, and execute
4. Inspect: route, pricing, verification, settlement, receipt_url, budget_outcome, policy_applied, decision, evidence, sla_outcome

POST /api/loop remains available as a lower-level paid primitive, but POST /api/run is the recommended router-first entry point.

Quickstart

The fastest path from zero to a paid run with a verifiable receipt.

1. Install packages

npm init -y
npm install @x402/fetch @x402/evm viem dotenv

2. Create your .env

cp examples/.env.example .env
# edit .env and set EVM_PRIVATE_KEY

Never commit a real private key.
Use a low-balance test wallet only. A single low-cost run is enough to see the full happy path.

3. Run a paid request

node examples/pay-attestify.js

The script signs an x402 payment and POSTs to Attestify. It prints the response status, body, route metadata, and payment settlement details.

By default the example targets a cheap smoke-test task so you can see:

• Payment required → pai

... View full README on GitHub