# CCIP v1.5.1 Error Codes and Messages API Reference Source: https://docs.chain.link/ccip/v1/evm/api-reference/v1.5.1/errors > For the complete documentation index, see [llms.txt](/llms.txt). > **NOTE: Integrate Chainlink CCIP v1.5.1 into your project** > > ### npm > > If you use [NPM](https://www.npmjs.com/), install the [@chainlink/contracts-ccip NPM package](https://www.npmjs.com/package/@chainlink/contracts-ccip): > > ```shell > npm install @chainlink/contracts-ccip@1.5.1-beta.0 > ``` > > ### yarn > > If you use [Yarn](https://yarnpkg.com/), install the [@chainlink/contracts-ccip NPM package](https://www.npmjs.com/package/@chainlink/contracts-ccip): > > ```shell > yarn add @chainlink/contracts-ccip@1.5.1-beta.0 > ``` > > ### foundry > > If you use [Foundry](https://book.getfoundry.sh/), install the package: > > ```shell > forge install smartcontractkit/ccip@5e7b2096586bc32c6e975fc13f4c411eb687f833 > ``` When invoking the `ccipSend` [function](/ccip/v1/evm/api-reference/v1.5.1/i-router-client#ccipsend), it is possible to encounter various errors. These might be thrown either by the CCIP router or by one of the downstream contracts called by the CCIP router. Below is a compiled list of potential errors you might encounter. Referencing this list will enable you to capture and handle these exceptions gracefully. ## Router Errors | Error | Parameters | Error selector | Description | | ----------------------------- | -------------------------- | -------------- | --------------------------------------------------------------------- | | `UnsupportedDestinationChain` | `uint64 destChainSelector` | `0xae236d9c` | Thrown when sending to an unsupported destination chain. | | `InsufficientFeeTokenAmount` | - | `0x07da6ee6` | Thrown when the fee token amount provided is less than required. | | `InvalidMsgValue` | - | `0x1841b4e1` | Thrown when msg.value is non-zero for non-native fee token payments. | | `BadARMSignal` | - | `0xc1483715` | Thrown when the RMN (Risk Management Network) has cursed the network. | | `SafeERC20FailedOperation` | - | `0x70c9c181` | Thrown when an ERC20 token transfer fails. | ## OnRamp Errors | Error | Parameters | Error selector | Description | | --------------------------------------- | --------------------------------------- | -------------- | ------------------------------------------------------------------------------- | | `CursedByRMN` | - | `0x53ad11d8` | Thrown when the RMN (Risk Management Network) has cursed the destination chain. | | `RouterMustSetOriginalSender` | - | `0xa4ec7479` | Thrown when the router has not set the original sender address. | | `MustBeCalledByRouter` | - | `0x1c0a3529` | Thrown when the caller is not the configured router address. | | `InvalidChainSelector` | `uint64 destChainSelector` | `0xd9a9cd68` | Thrown when the destination chain selector does not match the configured one. | | `InvalidExtraArgsTag` | - | `0x5247fdce` | Thrown when an invalid extra arguments tag is used. | | `MessageTooLarge` | `uint256 maxSize`, `uint256 actualSize` | `0x86933789` | Thrown when the message size exceeds the maximum allowed size. | | `MessageGasLimitTooHigh` | - | `0x4c4fc93a` | Thrown when the gas limit exceeds the maximum per-message gas limit. | | `CannotSendZeroTokens` | - | `0x5cf04449` | Thrown when attempting to send a token with amount zero. | | `MaxFeeBalanceReached` | - | `0xe5c7a491` | Thrown when the onRamp has reached its maximum fee storage capacity. | | `UnsupportedNumberOfTokens` | - | `0x4c056b6a` | Thrown when too many tokens are involved in the transfer. | | `UnsupportedToken` | `address token` | `0xbf16aab6` | Thrown when attempting to send an unsupported token. | | `ExtraArgOutOfOrderExecutionMustBeTrue` | - | `0xee433e99` | Thrown when enforceOutOfOrder is true but allowOutOfOrderExecution is false. | | `SourceTokenDataTooLarge` | `address token` | `0x36f536ca` | Thrown when the source token data exceeds the configured maximum size. | ## Rate Limiter Errors | Error | Parameters | Error selector | Description | | ----------------------------------- | ----------------------------------------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------- | | `BucketOverfilled` | - | `0x9725942a` | Thrown when the token bucket contains more tokens than its capacity. | | `OnlyCallableByAdminOrOwner` | - | `0xf6cd5620` | Thrown when a function is called by an address that is not the admin or owner. | | `TokenMaxCapacityExceeded` | `uint256 capacity`, `uint256 requested`, `address tokenAddress` | `0x1a76572a` | Thrown when attempting to consume more tokens than the bucket's maximum capacity. | | `TokenRateLimitReached` | `uint256 minWaitInSeconds`, `uint256 available`, `address tokenAddress` | `0xd0c8d23a` | Thrown when attempting to consume more tokens than currently available in the bucket. | | `AggregateValueMaxCapacityExceeded` | `uint256 capacity`, `uint256 requested` | `0xf94ebcd1` | Thrown when attempting to consume more aggregate value than the bucket's maximum capacity. | | `AggregateValueRateLimitReached` | `uint256 minWaitInSeconds`, `uint256 available` | `0x15279c08` | Thrown when attempting to consume more aggregate value than currently available in the bucket. | ## Token (ERC20) Errors | Error | Description | | ------------------------------------------ | ------------------------------------------------------------- | | `ERC20: burn amount exceeds balance` | Thrown when the amount to be burned exceeds the pool balance. | | `ERC20: transfer amount exceeds allowance` | Thrown when the transfer amount exceeds the allowance. | ## BurnMintERC20 Errors | Error | Parameters | Error selector | Description | | ------------------- | ------------------------- | -------------- | --------------------------------------------------------------------------------------------- | | `MaxSupplyExceeded` | `uint256 supplyAfterMint` | `0xcbbf1113` | Thrown when a mint operation would cause the total supply to exceed the maximum supply limit. | | `InvalidRecipient` | `address recipient` | `0x17858bbe` | Thrown when attempting to transfer or approve tokens for the contract itself (address(this)). | ## Token Pool Errors | Error | Parameters | Error selector | Description | | -------------------------- | ---------------------------- | -------------- | ------------------------------------------------------------------------------- | | `InvalidToken` | `address token` | `0x961c9a4f` | Thrown when the token being locked or burned is not supported by the pool. | | `CursedByRMN` | - | `0x53ad11d8` | Thrown when the RMN (Risk Management Network) has cursed the network. | | `SenderNotAllowed` | `address sender` | `0xd0d25976` | Thrown when the sender is not on the allowlist (when allowlist is enabled). | | `ChainNotAllowed` | `uint64 remoteChainSelector` | `0xa9902c7e` | Thrown when the remote chain selector is not supported. | | `CallerIsNotARampOnRouter` | `address caller` | `0x728fe07b` | Thrown when the caller is not a valid onRamp for the given chain on the Router. |