message text can vary by client, proxy, and execution path, so integrations should branch on error category and transaction receipt status rather than exact strings.
Standard JSON-RPC errors
| Code | Message | Description |
|---|---|---|
-32700 | Parse error | Invalid JSON |
-32600 | Invalid request | Missing required fields |
-32601 | Method not found | Method does not exist or is not supported |
-32602 | Invalid params | Incorrect method parameters |
-32603 | Internal error | Internal server or proxy error |
EVM execution errors
| Category | Typical code | Typical message pattern | Handling guidance |
|---|---|---|---|
| Contract revert | -32000 or library-specific call exception | execution reverted, ABI Error(string), or custom revert data | Decode revert data when available; do not credit failed transactions. |
| Out of gas | -32000 | out of gas, gas required exceeds allowance, or ErrOutOfGas | Re-estimate gas against the same calldata and network. |
| Insufficient funds | -32000 | insufficient funds | Check native CTM balance for value plus max fee. |
| Nonce too low | -32000 | nonce too low, already known, or replacement conflict | Refresh pending nonce before rebroadcasting. |
| Nonce too high | -32000 | nonce too high | Wait for missing nonce or rebroadcast the earlier transaction. |
| Fee too low | -32000 | transaction underpriced, max fee per gas less than block base fee, or similar | Use current fee data and respect the minimum gas price in Gas on c8ntinuum. |
| Unsupported method | -32601 | method not found | Confirm the namespace is enabled on the selected RPC profile. |
| Rate limited | HTTP 429 | Provider-specific body | Back off and retry with jitter; see RPC Providers. |
Precompile errors
Precompile reverts are documented in the Precompile ABI Reference.| Case | Behavior |
|---|---|
| Stateful precompile action returns an error | Standard ABI Error(string) revert data |
| Unknown selector, short calldata, or failed ABI unpack in most stateless precompiles | Plain execution reverted |
| SDK gas panic or exhausted EVM gas | ErrOutOfGas |
| ERC20 extension SDK/bank errors | ERC20-style revert strings such as ERC20: transfer amount exceeds balance |