[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_104":105},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@attestifyagent/attestify-os' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":57,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apiUrl","https://odel.app/api","creator","attestifyagent","moduleId","attestify-os","@attestifyagent/attestify-os","displayName","attestify os","tagline","Governed agent execution: x402 payments, budgets, receipts, verification, and audit.","iconKey","https://avatars.githubusercontent.com/u/278453102?v=4","category","dev-tools","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://attestify-os.vercel.app/api/run\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363396000,"updatedAt",1781499586000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.attestifyagent%2Fattestify-os","sourceVerified",true,"importedAt","upstreamStars",0,"upstreamUpdatedAt",1781480301000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/attestifyagent/attestify-os","githubRepoFullName","attestifyagent/attestify-os","releaseId","ext-attestifyagent-attestify-os","version","0.1.1","descriptionMarkdown","# Attestify OS\n\n**x402-paid lane execution, governance, and financial control plane for autonomous agents.**\n\nAttestify 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.\n\nFor 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.\n\n**Live URL**: \n\n---\n\n## What Attestify does\n\nAttestify is built around a router-first governance workflow:\n\n1. **Discover** — check `/api/capabilities`, `/api/pricing`, or `/.well-known/x402.json` to understand the stack.\n2. **Pre-flight** — optionally call `POST /api/routing-intel` to get routing recommendations and cost estimates before spending.\n3. **Send a task** — `POST /api/run` with optional lane preferences, budget constraints, and governance context.\n4. **Pay & run** — a single x402-paid call handles routing → governance → budget → SLA → execution → verification → receipt.\n5. **Inspect trust signals** — receipts, verification scores, settlement evidence, reputation, and memory continuity all attached to every run.\n\nThe 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.\n\n---\n\n## Core features\n\n- **Router-first paid execution** via `POST /api/run`\n- **Financial control plane** — tenant API keys, subscriptions, budgets, policies, and per-tenant analytics\n- **Governance stack** — policies, budgets, and SLAs evaluated on every run\n- **Routing intelligence** — pre-flight cost and lane recommendations before committing spend\n- **Persistent memory** (Redis-backed) for context continuity across sessions\n- **x402-native payments** — USDC on Base (eip155:8453), settled per run\n- **Receipts and public proof pages** for every paid run\n- **Heuristic verification** — output scored and graded on every run\n- **Lane reputation** computed from verified receipt history\n- **Analytics API** — cross-lane metrics, revenue, margin, and time-series data\n- **Benchmark API** — compare spend efficiency against fleet averages\n- **Webhook delivery** — push receipts to external endpoints after each run\n- **Builder-facing quickstart**, docs, and dashboard for live testing\n\n---\n\n## Default workflow\n\nThe recommended paid flow is:\n\n1. Send a task to `POST /api/run`\n2. Optionally include:\n - `preferred_lane_id` to nudge routing\n - `lane_id` to force an explicit lane\n - `constraints` for budget ceiling, SLA, or cost priority\n - `options` for memory and verification behaviour\n3. Let Attestify route, govern, and execute\n4. Inspect: `route`, `pricing`, `verification`, `settlement`, `receipt_url`, `budget_outcome`, `policy_applied`, `decision`, `evidence`, `sla_outcome`\n\n`POST /api/loop` remains available as a lower-level paid primitive, but `POST /api/run` is the recommended router-first entry point.\n\n---\n\n## Quickstart\n\nThe fastest path from zero to a paid run with a verifiable receipt.\n\n### 1. Install packages\n\n```bash\nnpm init -y\nnpm install @x402/fetch @x402/evm viem dotenv\n```\n\n### 2. Create your `.env`\n\n```bash\ncp examples/.env.example .env\n# edit .env and set EVM_PRIVATE_KEY\n```\n\n> **Never commit a real private key.** \n> Use a low-balance test wallet only. A single low-cost run is enough to see the full happy path.\n\n### 3. Run a paid request\n\n```bash\nnode examples/pay-attestify.js\n```\n\nThe script signs an x402 payment and POSTs to Attestify. It prints the response status, body, route metadata, and payment settlement details.\n\nBy default the example targets a cheap smoke-test task so you can see:\n\n- Payment required → paid\n- Router decision\n- Governance and policy outcome\n- Lane execution\n- Stored receipt\n- Verification result\n- Updated lane reputation\n\n### 4. Inspect receipts and reputation\n\n- Recent loops: \n- Single receipt (JSON): `https://attestify-os.vercel.app/api/receipts/`\n- Public receipt page: `https://attestify-os.vercel.app/receipts/`\n- Lane profile (JSON): `https://attestify-os.vercel.app/api/lanes/`\n- Public lane page: `https://attestify-os.vercel.app/lanes/`\n\nFull builder guide: \n\n---\n\n## Router-first request example\n\n```json\n{\n \"session_id\": \"readme-run-001\",\n \"intent\": \"Research the latest x402 adoption trends and summarize the major patterns.\",\n \"preferred_lane_id\": \"researcher-v2\",\n \"constraints\": {\n \"max_cost_usdc\": 0.03,\n \"priority\": \"quality\"\n },\n \"options\": {\n \"include_memory\": true,\n \"write_memory\": true,\n \"verify\": true\n }\n}\n```\n\nThis lets Attestify route on the caller's behalf while respecting preferences and governance constraints.\n\n---\n\n## Response signals\n\nA successful `POST /api/run` response includes:\n\n| Field | Description |\n|---|---|\n| `run_id` / `loop_id` | Unique identifiers for this execution |\n| `lane_id` / `lane_name` | The execution lane that handled the run |\n| `route` | Routing decision: lane, reason, confidence, mode |\n| `output` | The lane's response |\n| `receipt_url` | Link to the public receipt page |\n| `verification` | Score (0–1), grade (A–F), hash, flags |\n| `pricing` | Price breakdown: base, orchestration, margin |\n| `memory` | Memory read/write status and length |\n| `settlement` | Transaction hash and network |\n| `budget_outcome` | Budget check result and source |\n| `policy_applied` | Governance policy effects |\n| `decision` | Final allow/deny governance decision |\n| `evidence` | Structured audit evidence (routing, pricing, budget, policy) |\n| `sla_outcome` | SLA evaluation: compliant, breaches (when SLAs are active) |\n| `latency_ms` | End-to-end execution latency in milliseconds |\n| `governance_version` | Governance ruleset version applied |\n\n---\n\n## Pricing tiers\n\n`POST /api/run` pricing = lane base price + 0.005 USDC orchestration fee.\n\n| Tier | Lane | Base price | Run price |\n|---|---|---:|---:|\n| Smoke test | `comedian-v1` | 0.005 USDC | **0.010 USDC** |\n| Standard | `writer-v1`, `support-v1` | 0.010 USDC | **0.015 USDC** |\n| Mid | `analyst-v1` | 0.015 USDC | **0.020 USDC** |\n| Premium | `researcher-v2`, `coder-v1`, `strategist-v1` | 0.025 USDC | **0.030 USDC** |\n\nFor first integration tests, use `comedian-v1` or a cheap smoke task. For production, let routing or policy decide the lane.\n\n---\n\n## Financial Control Plane\n\nFor builders managing multiple lanes or tenants, Attestify provides a financial control plane that enforces spend limits and governance rules automatically on every run.\n\n### How it works\n\n```\n1. POST /api/keys → issue a tenant API key (X-Admin-Key: )\n2. POST /api/budgets → create a USDC spend budget for that tenant\n3. POST /api/policies → create governance rules (allow/deny/restrict by lane, task, session)\n4. POST /api/run → every run auto-enforces budget + policy for that tenant\n```\n\n### Tenant key issuance\n\n```bash\ncurl -X POST https://attestify-os.vercel.app/api/keys \\\n -H \"X-Admin-Key: \" \\\n -H \"Content-Type: application/json\" \\\n -d '{ \"tenant_id\": \"lane-acme-v1\", \"label\": \"Acme production lane\" }'\n# → { \"key\": \"atst_abc123...\" }\n```\n\n### Budget record\n\n```bash\ncurl -X POST https://attestify-os.vercel.app/api/budgets \\\n -H \"Content-Type: application/json\" \\\n -d '{ \"budget_id\": \"budget-acme-monthly\", \"max_cost_usdc\": 10.00, \"strict\": true }'\n```\n\nPass `constraints.budget_id` on subsequent `/api/run` calls — Attestify enforces the ceiling and tracks cumulative spend.\n\n### Policy rule\n\n```bash\ncurl -X POST https://attestify-os.vercel.app/api/policies \\\n -H \"Content-Type: application/json\" \\\n -d '{ \"policy_id\": \"policy-acme-prod\", \"rule\": \"allow\", \"lanes\": [\"researcher-v2\", \"coder-v1\"] }'\n```\n\n### Subscription plan (bypass per-run x402)\n\nHigh-frequency callers can subscribe to a monthly USDC flat rate:\n\n```bash\ncurl -X POST https://attestify-os.vercel.app/api/subscribe \\\n -H \"Content-Type: application/json\" \\\n -d '{ \"plan\": \"standard\", \"tenant_id\": \"lane-acme-v1\" }'\n```\n\n### Why this creates stickiness\n\n- **Memory** — session context lives in Attestify Redis per `session_id`. It compounds with every run.\n- **Ledger + evidence bundles** — hash-chained audit trails are the compliance record. Enterprises don't migrate these.\n- **Tenant keys + governance configs** — once budgets and policies are wired to a key, that state lives in Attestify.\n- **Reputation scores** — lane reputation is computed from Attestify receipt history. It lives here.\n- **Per-tenant analytics** — spend, margin, and quality dashboards are Attestify-native (`GET /api/tenant/analytics`).\n\n---\n\n## Governance\n\nEvery `/api/run` call passes through the governance stack before execution:\n\n- **Policies** (`/api/policies`) — allow, deny, or restrict by lane, task type, session, or context\n- **Budgets** (`/api/budgets`) — stored budget records with cumulative spend tracking and per-run enforcement\n- **SLAs** (`/api/sla`) — define targets for max latency, min verification score, and max price; breaches recorded on every receipt\n\nAll governance outcomes are attached to the receipt as `policy_applied`, `decision`, `budget_outcome`, `evidence`, and `sla_outcome`.\n\n---\n\n## Receipts, memory, and verification\n\nEvery paid run is recorded as a receipt attributed to the selected execution lane. That record includes memory continuity, verification signals, pricing metadata, settlement evidence, SLA outcomes, and governance decisions.\n\n- **Receipt** — JSON: `GET /api/receipts/` · Public page: `GET /receipts/`\n- **Lane profile** — JSON: `GET /api/lanes/` · Public page: `GET /lanes/`\n- **Loop feed** — `GET /api/loops?limit=N`\n- **Memory** — Write: `POST /api/memory/write` · Read: `GET /api/memory/` · Delete: `DELETE /api/memory/`\n- **Verification** — Verify: `POST /api/verify-output` · Fetch: `GET /api/verify-output/`\n\nThis is what makes lanes on Attestify portable: work history, receipts, memory, and verification artifacts become part of a reusable trust layer.\n\n---\n\n## Key endpoints\n\n### Router and execution\n\n| Endpoint | Method | Description |\n|---|---|---|\n| `/api/run` | POST | **Recommended** — routing + governance + execution + receipt + verification |\n| `/api/loop` | POST | Lower-level paid execution primitive |\n| `/api/route` | POST | Free routing recommendation (no execution) |\n| `/api/routing-intel` | POST | Pre-flight routing + cost intelligence |\n| `/api/loops?limit=N` | GET | Most recent loop receipts |\n| `/api/receipts/` | GET | Receipt for a single loop |\n\n### Financial control plane\n\n| Endpoint | Method | Description |\n|---|---|---|\n| `/api/keys` | POST | Issue a tenant API key (X-Admin-Key required) |\n| `/api/keys/` | DELETE | Revoke a tenant API key |\n| `/api/subscribe` | POST | Subscribe to a monthly USDC flat-rate plan |\n| `/api/subscriptions` | GET | List active subscriptions |\n| `/api/budgets` | GET / POST / DELETE | Budget record CRUD with cumulative spend tracking |\n| `/api/policies` | GET / POST / DELETE | Governance policy CRUD |\n| `/api/sla` | GET / POST / DELETE | SLA definition CRUD |\n| `/api/tenant/analytics` | GET | Per-tenant spend rollups and daily breakdowns |\n| `/api/analytics` | GET | Cross-tenant run metrics, revenue, margin, time series |\n\n### Lanes and discovery\n\n| Endpoint | Method | Description |\n|---|---|---|\n| `/api/lanes` | GET | List available execution lanes |\n| `/api/lanes/` | GET | Lane profile, reputation, and recent receipts |\n| `/api/capabilities` | GET | Machine-readable capability description |\n| `/api/pricing` | GET | Current pricing matrix |\n| `/.well-known/x402.json` | GET | x402 payment surface discovery |\n| `/openapi.json` | GET | OpenAPI 3.1 specification |\n\n### Memory and verification\n\n| Endpoint | Method | Description |\n|---|---|---|\n| `/api/memory/write` | POST | Write session memory |\n| `/api/memory/` | GET | Read session memory |\n| `/api/memory/` | DELETE | Clear session memory |\n| `/api/verify-output` | POST | Verify and score a lane output |\n| `/api/verify-output/` | GET | Fetch stored verification |\n\n### Intelligence and analytics\n\n| Endpoint | Method | Description |\n|---|---|---|\n| `/api/reputation` | GET / POST | Lane or session reputation score |\n| `/api/benchmark` | POST | Spend benchmarking against fleet averages |\n| `/api/webhooks` | GET / POST / DELETE | Webhook endpoint management for receipt delivery |\n| `/api/providers` | GET | List execution providers |\n\n### Health\n\n| Endpoint | Method | Description |\n|---|---|---|\n| `/api/health` | GET | Health and Redis status |\n\n---\n\n## Web surfaces\n\n| Path | Description |\n|---|---|\n| `/` | Homepage |\n| `/quickstart` | Builder quickstart guide |\n| `/dashboard` | Interactive testing UI |\n| `/lanes` | Browse and explore available execution lanes |\n| `/docs` | Full API documentation |\n| `/router` | Live routing tester |\n| `/pricing` | Pricing and plan details |\n\n---\n\n## Useful links\n\n- [Homepage](https://attestify-os.vercel.app)\n- [Quickstart](https://attestify-os.vercel.app/quickstart)\n- [Docs](https://attestify-os.vercel.app/docs)\n- [Router](https://attestify-os.vercel.app/router)\n- [Dashboard](https://attestify-os.vercel.app/dashboard)\n- [Lanes](https://attestify-os.vercel.app/lanes)\n- [Pricing](https://attestify-os.vercel.app/pricing)\n- [Capabilities](https://attestify-os.vercel.app/api/capabilities)\n- [Pricing API](https://attestify-os.vercel.app/api/pricing)\n- [x402 Discovery](https://attestify-os.vercel.app/.well-known/x402.json)\n- [OpenAPI](https://attestify-os.vercel.app/openapi.json)\n\n---\n\n**Built to power the agent economy on agentic.market.**\n\nStar this repo if you're building with agents.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","categoryDisplayName","Developer Tools","upstream",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":103},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_92":57,"_93":57},"ratingAvg","reviewCount","topics",[],"license","MIT","language","JavaScript","registryName","io.github.attestifyagent/attestify-os","homepage","https://attestify-os.vercel.app","ENV",{"_106":107,"_108":109,"_110":111},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]