{"uid":"cap_ltrupzMRCZKr6R9T3-Bje","slug":"agent-virtual-wallet-permission-profile-procedure-64624ced","name":"Agent Virtual Wallet Permission Profile Procedure","description":"Decision procedure for provisioning a Cloudflare-style virtual wallet for an AI agent. Answers the questions every wallet issuer faces before the agent's first payment: which ERC-7715 permission scopes to grant, how a merchant gets onto the allowlist and what gets it removed, how to size the asset cap per spend category, what expiry windows make sense per permission, and how revocation is wired so a compromised or overreaching agent loses spend capability before it drains the wallet. Includes","url":"https://k2so-8080.on.ascii.dev/api/services/agent-virtual-wallet-permission-profile-procedur","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"topic":{"type":"string","description":"Optional topic override for the decision procedure"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"Agent virtual wallet permission profile procedure paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"brief":{"type":"string","description":"Decision procedure prose for agents"},"model":{"type":"string"},"topic":{"type":"string"},"service":{"type":"string","description":"Service slug"},"procedure":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"generationSource":{"enum":["llm","reasoning","deterministic"],"type":"string"}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_R-Yk3OOLikwsYBWR3F1me","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a decision procedure for provisioning ERC-7715 permission scopes, allowlists, spend caps, expiry windows, and revocation logic for an AI agent's virtual wallet.","exampleAgentPrompt":"Can you walk me through the full permission profile procedure for provisioning a virtual wallet for my AI agent — I need to know which ERC-7715 scopes to grant, how to set up the merchant allowlist, how to size the spend caps, and how revocation should be wired?","exampleUseCases":[{"title":"First-time agent wallet provisioning","prompt":"I'm about to give my AI agent its own virtual wallet for the first time — can you run me through the decision procedure for which ERC-7715 permission scopes to grant, what the allowlist criteria should look like, and how to set sensible spend caps before it makes its first payment?"},{"title":"Hardening a compromised agent's wallet","prompt":"One of my AI agents just made some suspicious purchases — can you give me the full procedure for revoking its wallet permissions and tightening the spend caps and expiry windows so a compromised agent can't drain the wallet before I can intervene?"},{"title":"Designing merchant allowlist policy","prompt":"I need to figure out how to design the merchant allowlist for my agent's virtual wallet — specifically what criteria get a merchant approved and what behaviors should trigger automatic removal from the allowlist."}],"resultDescription":"A structured JSON response containing a prose decision procedure (the 'brief' and 'procedure' fields) covering ERC-7715 scope selection, merchant allowlist admission and removal criteria, per-category asset cap sizing, expiry window recommendations, and revocation wiring guidance. Also includes metadata like generation timestamp, model used, generation source (llm/reasoning/deterministic), and the service slug.","failureModes":["Payment not received — returns HTTP 402 requiring x402 payment before content is delivered","Invalid method — only GET/HEAD/DELETE are accepted; POST returns 405","Backend LLM unavailable — may return ok:false with no procedure content","Malformed topic override parameter — ignored or causes unexpected procedure focus"],"whenToPreferThis":"Choose this endpoint when an agent or developer needs authoritative, structured guidance on configuring a virtual wallet's permission profile before the agent's first payment — specifically when ERC-7715 scopes, allowlist policies, spend caps, expiry windows, and revocation logic all need to be decided together. Prefer it over generic web3 documentation when you need a concise, actionable decision procedure rather than reference material, and when the wallet issuer context is agent-specific (autonomous spending, not user-interactive flows).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:59:10.375Z","isFirstParty":false}