Repository navigation
What's new
AgentTrace runs in public — a decision can be opened and verified by anyone from a link, and the SDK installs from npm into an existing agent in about a minute.
Details
- Hosted service. API and publisher run as one service on Render;
/healthreports the database, the queue, the publisher's lag behind the chain tip and RPC calls by method, and answers 503 when the database is unreachable. - Public pages.
/verifychecks a signed record against Solana in the browser with no AgentTrace backend in the path;/decisions/<id>shows a live decision with its verification state. The home page now says what the product is, who it is for, what a check can answer — and offers both actions. - SDK on npm:
@agenttracewoof/sdk0.2.1.createClient({ agent, policy })with the hosted endpoint andAGENTTRACE_INGEST_KEYas defaults, andrecord({ model, steps, outcome })for a finished decision in one call. Works under Jest ESM (fs errors from another realm no longer stop the first run). - Cheaper to run. Blockhash and fee reads are cached for 30 s: 2.56 RPC calls per decision instead of 4.9, which keeps 10 000 decisions a day inside the RPC provider's free plan.
- The API refuses an agent key that is not a point on the Ed25519 curve.
Measured on the deployed service
- SC-001 — p95 6.2 s from a finished decision to a checkable status, over a day at 10 000 decisions/day (2026-09-28 → 09-29 UTC).
- SC-004 — 5 000 lamports per decision, about $0.0006 at SOL $119.
- SC-002 — on two third-party projects (LangChain's ReAct starter, the LangGraph.js template), 59 s and 1 min 14 s from
installto a verified decision; the integration adds 6 and 5 statements.
Not in this release, and worth saying out loud
- Solana devnet, which is reset from time to time — no anchor here outlives the demo.
- No accounts and no self-service keys yet: an ingest key comes from the operator.
- No retention or eviction yet: at 10 000 decisions a day the free database fills in about four days.
- Demo decisions on the site are generated by a test agent; the signature, the anchor and the verification are real.
Files changed
apps/api/src/health.ts,apps/api/src/app.ts— readiness/healthwith chain lag and RPC tallyapps/publisher/src/budget.ts,apps/publisher/src/loop.ts— cached chain reads, fewer calls per decisionapps/web/src/pages/Landing.tsx,apps/web/src/pages/Verify.tsx— showcase home page, in-browser verificationpackages/sdk/— publishable package: build, README, defaults,record(), realm-safe errno checksrender.yaml,.github/workflows/pages.yml— hostingLICENSE— MIT
Migration
✅ No migration needed.