Error codes

Every BridgeError.code is one of the values on the exported ErrorCode map. Import both to switch on codes with autocomplete.

import { BridgeError, ErrorCode, ErrorMessage } from "@zethub/bridge";

Input validation

Code	Default message
`AMOUNT_REQUIRED`	Enter an amount.
`AMOUNT_INVALID`	Enter a valid number.
`AMOUNT_TOO_SMALL`	Amount must be greater than zero.
`AMOUNT_EXCEEDS_BALANCE`	Amount exceeds your USDC balance.
`RECIPIENT_REQUIRED`	Enter a recipient address.
`RECIPIENT_INVALID_EVM`	Recipient must be a 0x prefixed Ethereum style address (40 hex characters).
`RECIPIENT_INVALID_STELLAR`	Recipient must be a Stellar address starting with G (account) or C (contract).
`MEMO_INVALID_TEXT`	Memo text must be 28 characters or fewer (ASCII).
`MEMO_INVALID_ID`	Memo ID must be an unsigned integer.
`MEMO_INVALID_HASH`	Memo hash/return must be 32 bytes (64 hex characters).

Routing

Code	Default message
`MISSING_SOURCE`	Pick a source chain.
`MISSING_DESTINATION`	Pick a destination chain.
`MISSING_EVM_CHAIN_ID`	Network is missing its EVM chain id.
`MISSING_FORWARDER`	Stellar network is missing the CctpForwarder configuration.
`MISSING_TRUSTLINE`	The Stellar recipient has no trustline for this asset. Establish the trustline before bridging.
`UNSUPPORTED_ASSET`	The selected asset is not supported on this route.
`UNSUPPORTED_ROUTE`	No chain connector registered for one side of this route.
`MISMATCHED_ENVIRONMENTS`	Source and destination must be on the same environment (mainnet or testnet).
`SAME_NETWORK`	Source and destination networks must differ.

Wallet side (classified from provider errors)

Set by BridgeError.from(err) when it recognises a wallet library error.

Code	Default message
`WRONG_NETWORK`	Switch your wallet to the correct network.
`WALLET_SIGN_REJECTED`	Transaction was rejected in the wallet.

Network / off chain

Code	Default message
`RPC_ERROR`	RPC request failed. Check your network and retry.
`RPC_TIMEOUT`	RPC request timed out. Retrying with a fallback endpoint.
`ATTESTATION_TIMEOUT`	Timed out waiting for Circle to issue the attestation. Your transfer is safe; retry the mint step.

On chain outcome

Code	Default message
`BURN_FAILED`	Burn transaction failed on the source chain.

Fallback

Code	Default message
`UNKNOWN`	Something went wrong. Check the developer console for details.

Overriding a message

import { ErrorMessage } from "@zethub/bridge";

const custom: typeof ErrorMessage = {
  ...ErrorMessage,
  MISSING_TRUSTLINE: "Please add a USDC trustline before bridging to this account.",
};

The types stay open so you can compose your own maps without losing autocomplete.