{"uid":"cap_6Rbzijv9DumHMf55oJnHg","slug":"rfc-2181-dns-rrset-positive-credibility-replacement-cache-validator-5002a8d6","name":"RFC 2181 DNS RRset Positive Credibility Replacement & Cache Validator","description":"Recover exact positive DNS RRset replacement, expiry and indivisible set contents under complete ranked source facts.","url":"https://detect.halowerk.com/v1/F-TD2000-DATASTRUCTURES-09/rfc2181-positive-rrset-credibility-replacement-cache?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"artifact":{"type":"object","$defs":{"s0":{"type":"array","items":{"type":"string","maxLength":20000},"maxItems":512},"json":{"anyOf":[{"type":"null"},{"type":"boolean"},{"type":"number"},{"type":"string","maxLength":6000},{"type":"array","items":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/json"},"maxItems":512},{"type":"object","maxProperties":128,"additionalProperties":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/json"}}]}},"required":["dnsCredibility"],"properties":{"dnsCredibility":{"type":"object","required":["data","claim"],"properties":{"data":{"type":"object","required":["equal_rank_policy","events","refresh_identical"],"properties":{"events":{"type":"array","items":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/json"},"maxItems":512},"equal_rank_policy":{"type":"string","maxLength":20000},"refresh_identical":{"type":"boolean"}},"additionalProperties":false},"claim":{"anyOf":[{"type":"null"},{"type":"object","required":["cache","events"],"properties":{"cache":{"type":"array","items":{"type":"object","required":["authenticated","cl","expiry","owner","rank","records","remaining_ttl","type"],"properties":{"cl":{"type":"number"},"rank":{"type":"number"},"type":{"type":"number"},"owner":{"type":"string","maxLength":20000},"expiry":{"type":"number"},"records":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s0"},"authenticated":{"type":"boolean"},"remaining_ttl":{"type":"number"}},"additionalProperties":false},"maxItems":512},"events":{"type":"array","items":{"anyOf":[{"type":"object","required":["action","kind","rank","ttl"],"properties":{"ttl":{"type":"number"},"kind":{"type":"string","maxLength":20000},"rank":{"type":"number"},"action":{"type":"string","maxLength":20000}},"additionalProperties":false},{"type":"object","required":["found","kind","rank","records","ttl"],"properties":{"ttl":{"anyOf":[{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/json"},{"type":"number"}]},"kind":{"type":"string","maxLength":20000},"rank":{"anyOf":[{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/json"},{"type":"number"}]},"found":{"type":"boolean"},"records":{"$ref":"#/properties/input/properties/body/properties/artifact/%24defs/s0"}},"additionalProperties":false}]},"maxItems":512}},"additionalProperties":false}]}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iTGB_JJk8-0Gfjt9aQvYQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates and resolves DNS RRset credibility replacement rules per RFC 2181, returning authoritative cache state, expiry, and indivisible record set contents after ranked-source processing.","exampleAgentPrompt":"Check whether this DNS RRset cache replacement is correct per RFC 2181: I have an existing cache entry for 'example.com A' at rank 3 with TTL 300, and a new event arriving from a rank-5 source with TTL 120 — using 'replace_on_equal' policy, what should the final cache state, expiry, and remaining TTL be?","exampleUseCases":[{"title":"DNS resolver conformance testing","prompt":"I'm building a DNS resolver and need to verify my credibility replacement logic is correct per RFC 2181 — given these cache entries at rank 2 and an incoming authenticated RRset at rank 4 with TTL 600 for 'mail.example.com MX', what does the correct final cache state look like?"},{"title":"Equal-rank RRset collision auditing","prompt":"I have two DNS sources both at rank 3 trying to update the same RRset for 'ns1.example.org NS' with different records — using the 'keep_existing' equal-rank policy, tell me which records survive and what the expiry should be."},{"title":"DNS cache TTL and expiry validation","prompt":"After a sequence of three DNS events updating 'api.myservice.com A' — first from rank 1, then rank 5, then rank 5 again — what are the correct remaining TTL and expiry values in the cache, and are the records treated as an indivisible set?"}],"resultDescription":"Returns the authoritative resolved DNS cache state after applying RFC 2181 credibility replacement rules, including the winning record set, computed expiry timestamp, remaining TTL, credibility level, rank, authenticated flag, and whether replacement occurred given the equal-rank policy and input events.","failureModes":["Missing required fields (dnsCredibility, data, claim) returns a 400 validation error","Invalid rank values or malformed cache entry objects cause schema rejection","Contradictory equal-rank policies may produce undefined replacement behavior","Truncated events array beyond maxItems:512 results in partial processing","Network timeout if event processing is computationally intensive"],"whenToPreferThis":"Use this endpoint when you need to programmatically validate or test DNS resolver logic against RFC 2181 credibility replacement rules, especially when evaluating ranked-source conflict resolution, indivisible RRset semantics, TTL expiry computation, or equal-rank policies. It is specifically suited for DNS resolver conformance testing, protocol compliance auditing, and cache state simulation — not for live DNS resolution or general DNS lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:41:19.185Z","isFirstParty":false,"canonicalSlug":"rfc-2181-dns-rrset-positive-credibility-replacement-cache-validator-5002a8d6"}