# revert.wtf AA-Decode

> revert.wtf AA-Decode is a paid API for AI agents from revert.wtf, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Decodes ERC-4337 UserOperation and EntryPoint revert bytes into human-readable error explanations for AAxx failure codes.

## Facts

- Endpoint: POST https://revert.wtf/api/x402/aa-decode?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/revert-wtf-aa-decode-389b901c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B7NY8KefpEwh-ZCE6NYZH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability revert-wtf-aa-decode-389b901c -d '<json body>'
```

Example prompt: My UserOperation failed and the bundler returned this revert: 0x220266b600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000d4141323320726576657274ed — can you decode that EntryPoint revert and tell me what went wrong?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Paid hosted ERC-4337/UserOperation/EntryPoint failure decoder for AAxx messages or EntryPoint revert bytes.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "raw": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/revert-wtf-aa-decode-389b901c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from revert.wtf](https://www.zero.xyz/host/revert.wtf/llms.txt)