eth_getUserOperationByHash
Look up a UserOperation by its userOpHash.
Base mainnet, chain ID 8453base:rpcpro — enforced matrix policy, not measured capacity or runtime publicationAvailability: unknownValidation: documented
Parameter limits
| JSON path | Frozen limit | Source |
|---|---|---|
| — | unknown | No numeric parameter ceiling is frozen; enforce the declared schema shape and deny an unknown oversized/range profile. |
Historical block retrieval is not an archive-state guarantee. Selectors must be preserved; do not substitute pending, safe, or finalized with latest.
Rate limits and tier
These are enforced product-policy values, not measured upstream capacity or an SLA. Enterprise is finite, never physical “unlimited” capacity.
| Tier | Limit / access | Category |
|---|---|---|
| Free | — (tier gated) | base_aa |
| Basic | — (tier gated) | base_aa |
| Pro | on request | base_aa |
| Business | on request | base_aa |
| Enterprise | on request | base_aa |
See Base limits.
Errors
| Code | Meaning here | Client action |
|---|---|---|
-32602 | Parameters fail the declared schema or upstream parser. | Fix the positional parameters; parser acceptance is not execution success. |
-32003 | The enforced category/provider budget is exhausted. | Honor Retry-After; no capacity SLA is implied. |
-32002 | The key is below the enforced minimum tier. | Upgrade only after the capability is runtime-enabled. |
Authentication/transport failures use the shared client error envelope. See Base errors.
Evidence
- Fixture:
missing— No complete successful correlated request/response pair. - Fixture registry:
infra-4-sety/integration-base/research/R00/import/FIXTURES_INDEX.json. - Evidence boundary: no fixture-backed runtime claim is made.
Limitations
- Provider support unknown. Pending may be null; returned userOperation must use pinned profile. Wire lookup nesting must be pinned to provider example.
- Availability is the frozen baseline, not deployed readiness. documented is the contract floor; evidence_kind retains unknown/source_summary.