{
  "markdown": "# stillos-kya — Know Your Agent\n\n**The trust toll for agent-to-agent commerce.** Before your AI agent pays another agent, run one check: is the counterparty sanctioned? Is its wallet a scam/contract/drained? StillOS returns a fail-closed **CLEAR / REVIEW / BLOCK** verdict — OFAC SDN screen + live on-chain wallet signals — with an **Ed25519-signed receipt** you can attach to the transaction as proof-of-diligence.\n\n> a16z (Big Ideas 2026) calls \"Know Your Agent\" — signed agent credentials + counterparty trust — the prerequisite for merchants to let agents onto payment rails. This is a working drop-in for it.\n\n## Install\n```bash\nnpm install stillos-kya\n```\n\n## Use — one call\n```js\nconst { kya } = require('stillos-kya');\n\nconst r = await kya({ name: 'Acme Agent', wallet: '0xabc...' });\nif (!r.allowed) throw new Error(`counterparty ${r.verdict}`); // CLEAR | REVIEW | BLOCK\n// r.receipt -> { hash, signature, verify }  (signed, verifiable proof-of-screening)\n```\n\n## Use — gate an x402 / express route in one line\n```js\nconst { kyaGate } = require('stillos-kya');\n\n// Every payment through this route runs a counterparty trust-check first.\napp.post('/pay-agent', kyaGate({ blockOnReview: false }), async (req, res) => {\n  // req.kya = { verdict, allowed, checks, receipt, ... }\n  // ...proceed to pay; blocked counterparties never reach here\n});\n```\n\n## Tiers\n- **Free:** unsigned verdict — the answer, for triage.\n- **Paid (x402 / API key):** the **signed, independently-verifiable receipt** — the proof-of-diligence that matters in a dispute. Pass `xPayment` or `apiKey` in opts.\n\nPricing + full endpoint reference: https://nolawealthfinancial.com/notary\n\n## Why signed matters\nAn unsigned \"looks fine\" is worthless if a counterparty later turns out sanctioned or fraudulent. A StillOS signed receipt is cryptographic proof that you screened *before* you paid — the audit artifact that protects you.\n",
  "bytes": 1909,
  "sha": "b97b47399d73dc9c34ebba06d411a4ad9b7c1d7caa05d8acaab1dcdaf7a1025a",
  "repo_slug": "stillmarcus24/stillos-kya",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_stillmarcus24_stillos_kya_846b69c2/readme"
}