Error Codes - c8ntinuum Docs

c8ntinuum uses Ethereum-compatible JSON-RPC error envelopes. Exact 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`

Handling Errors

Most Ethereum libraries parse these errors into library-specific exception types. Always inspect transaction receipts for submitted transactions:

try {
  await contract.someMethod();
} catch (error) {
  if (error.code === "CALL_EXCEPTION") {
    console.log("Reverted:", error.reason);
  }
}

For exchange and custody systems, use Node Interface Calls and Deposit Processing for receipt-based confirmation behavior.