{"uid":"cap_B7NY8KefpEwh-ZCE6NYZH","slug":"revert-wtf-aa-decode-389b901c","name":"revert.wtf AA-Decode","description":"Paid hosted ERC-4337/UserOperation/EntryPoint failure decoder for AAxx messages or EntryPoint revert bytes.","url":"https://revert.wtf/api/x402/aa-decode?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"raw":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6m1EftOe1Mh_2bWjP0K7l","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Decodes ERC-4337 UserOperation and EntryPoint revert bytes into human-readable error explanations for AAxx failure codes.","exampleAgentPrompt":"My UserOperation failed and the bundler returned this revert: 0x220266b600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000d4141323320726576657274ed — can you decode that EntryPoint revert and tell me what went wrong?","exampleUseCases":[{"title":"Diagnosing bundler UserOperation rejection","prompt":"My ERC-4337 bundler just returned this failure hex: 0x08c379a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000064141323300000000000000000000000000000000000000000000000000000000 — what does the AA23 error mean and why did my UserOperation get rejected?"},{"title":"Debugging paymaster EntryPoint revert","prompt":"I'm building an ERC-4337 paymaster and my sponsored transaction reverted with these bytes from EntryPoint: 0x220266b6... — can you decode the raw revert and explain what the paymaster validation failure is?"},{"title":"Smart account transaction failure in production","prompt":"Our smart contract wallet users are seeing AA31 failures during UserOperation simulation. Decode this raw EntryPoint revert: 0x08c379a000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000004414131 and explain what's going wrong with the account validation."}],"resultDescription":"A human-readable explanation of the ERC-4337 / EntryPoint revert, mapping AAxx error codes or raw hex revert bytes to a clear description of the failure reason, likely cause, and context within the UserOperation lifecycle.","failureModes":["Unknown or unrecognized revert bytes — returns an error indicating the bytes don't match a known AA error pattern","Malformed hex input — returns a parsing error if the raw field is not valid hex","Missing raw field — returns a validation error if the request body is empty","Network or payment failure — x402 payment not accepted, returns 402 with payment details","Empty input — returns an error if no revert bytes are provided"],"whenToPreferThis":"Use this endpoint specifically when debugging ERC-4337 account abstraction failures — AAxx error codes (AA10–AA50+), raw EntryPoint revert bytes, or UserOperation simulation rejections from a bundler. Prefer this over the generic revert.wtf decoder when you know the revert originates from ERC-4337 infrastructure (EntryPoint, paymaster, account contract). It provides targeted AA-domain context rather than generic EVM revert decoding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:39:33.168Z","isFirstParty":false,"canonicalSlug":"revert-wtf-aa-decode-389b901c"}