Errors & recovery

Error reference

import { CTokenError, humanizeError, isUserRejection } from "@inco/ctoken";

try {
  await ctoken.deposit({ token: USDC, amount: "1" });
} catch (error) {
  if (isUserRejection(error)) return;
  if (error instanceof CTokenError) console.log(error.code);
  console.error(humanizeError(error));
}

Code	Meaning / recovery
`WALLET_REQUIRED`	Supply/connect a wallet client.
`NOT_CONNECTED`	The supplied wallet has no selected account.
`UNSUPPORTED_NETWORK`	Use a supported NetworkName.
`WRONG_NETWORK`	Wallet/public-client/source chain mismatch; switch or configure the matching chain.
`INVALID_CONFIG`	Invalid URL/TTL or removed raw signer input, among other configuration failures.
`INVALID_ARGUMENT`	Invalid limits, pagination, handle shape, or option bounds.
`INVALID_ADDRESS`	Malformed address or invalid recipient.
`INVALID_AMOUNT`	Unsupported amount syntax, precision, zero/negative value, or overflow.
`WRAPPER_NOT_FOUND`	No registered wrapper/configuration where a deployed wrapper is required.
`READ_FAILED`	Batched metadata/balance/scope read failed.
`BALANCE_PENDING`	Numeric/exact balance API cannot produce a settled plaintext yet.
`TOKENS_REQUIRED`	Scoped reveal needs resolvable cToken scope.
`SESSION_FAILED`	Session creation/adoption state failed or changed during signing.
`DECRYPT_FAILED`	Pending batch could not settle, or invalid plaintext results.
`INDEXER_NOT_CONFIGURED`	Configure an indexer for the selected network or enable it.
`INDEXER_UNAVAILABLE`	HTTP failure, retry exhaustion, or timeout.
`INDEXER_INVALID_RESPONSE`	JSON/schema validation failed.
`TX_REVERTED`	Confirmed receipt reverted.
`TX_CANCELLED`	Original transaction was cancelled.
`TX_REPLACED`	Original transaction was replaced with a different operation.

CTokenErrorCode contains these codes. Wallet/RPC errors may propagate directly; retain their causes for diagnostics. humanizeError(null/undefined) returns null. Never automatically retry a declined signature.

Confidential-network failures

humanizeError converts threshold/quorum and failed KMS-client errors into: The confidential network couldn’t complete the request. Please try again shortly. Original errors remain available for diagnostics. Wallet declines, timeouts, and rate limits also receive concise messages. Widgets offer explicit balance retries and keep failed balances unavailable. Persistent failures need investigation of the original cause; do not automatically resubmit transactions.

Get started

Integrations

SDK reference

Indexer & raw APIs

Operations

Error reference

Confidential-network failures

​Error reference

​Confidential-network failures

Error reference

Confidential-network failures