{"uid":"cap_tBiGwsPW__2J8U17UMXCw","slug":"ens-name-ownership-vetting-decision-procedure-141175c6","name":"ENS Name Ownership Vetting Decision Procedure","description":"Resolve a human-readable ENS name to a target address, verify current ownership and expiry or namewrapper status, confirm the reverse record matches before approving any agent payment, and choose between a marketplace purchase and direct registration based on cost, speed, and renewal risk. Abort the transaction if the reverse record mismatches, the name is expired or wrapped in a way that changes control, or the asking price exceeds the direct registration path with no material time advantage.","url":"https://k2so-8080.on.ascii.dev/api/services/ens-name-ownership-vetting-decision-procedure","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":"ENS name ownership vetting 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_o_eouqufYFuJP8AOcFM_I","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 an AI-generated decision procedure brief for verifying ENS name ownership, reverse record integrity, expiry status, and cost-path selection before approving an agent payment","exampleAgentPrompt":"Before my agent pays for the ENS name 'vitalik.eth', run the ownership vetting procedure — check that the reverse record matches, it's not expired or strangely wrapped, and tell me whether buying from a marketplace or registering directly makes more sense given cost and renewal risk.","exampleUseCases":[{"title":"Pre-payment ENS name safety check","prompt":"I'm about to have my agent pay for the ENS name 'coolproject.eth' — can you run the ownership vetting procedure to confirm the forward and reverse records match, that it's not expired or wrapped in a suspicious way, and whether I should buy it from a marketplace or just register it directly?"},{"title":"Detecting ENS name hijack risk before wallet transfer","prompt":"My agent is receiving a payment to 'myprotocol.eth' — please run the ENS ownership vetting procedure to confirm the reverse record actually matches that name and the current owner hasn't changed or wrapped it in a way that shifts control away from them."},{"title":"Marketplace vs. direct registration cost decision","prompt":"I want to acquire 'defi-tools.eth' — can you get me a decision brief on whether purchasing it from a secondary marketplace is worth it versus just doing a direct registration, factoring in the current asking price, renewal risk, and how fast I need it?"}],"resultDescription":"A structured JSON response containing a prose decision-procedure brief (the 'brief' field) authored by an LLM or reasoning engine, covering: ENS forward/reverse record resolution steps, ownership and NameWrapper status checks, expiry and renewal risk assessment, marketplace-vs-direct-registration cost/speed comparison, and explicit abort conditions (reverse record mismatch, expired name, price exceeds direct registration with no time advantage). Also includes metadata: service slug, generation source (llm/reasoning/deterministic), ISO-8601 timestamp, model used, and payment receipt details.","failureModes":["Name resolution failure if ENS name is malformed or unregistered","Stale or inconsistent data if the ENS subgraph is lagging behind on-chain state","No topic override provided results in a generic procedure brief not tailored to a specific name","Payment not confirmed leads to unpaid (meta) response without the full decision brief","LLM generation timeout or error returns ok:false with no brief content","Wrapped name edge cases may not be fully captured if NameWrapper state is complex"],"whenToPreferThis":"Choose this endpoint when an AI agent is about to approve a payment for or to an ENS name and needs a structured, opinionated decision procedure — not just raw resolution data. It is especially valuable when evaluating whether a marketplace purchase is justified over direct registration, when reverse-record integrity must be confirmed before funds move, or when the agent lacks internal ENS vetting logic. Prefer this over raw ENS resolver calls when you need actionable go/no-go guidance with explicit abort conditions rather than just lookup results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:06:12.775Z","isFirstParty":false}