CCIP v1.6.0 TON Errors API Reference

Errors

CCIP contracts on TON use the TVM exit code system. Each contract has a facility ID that namespaces its errors. Contract-level errors are computed as FACILITY_ID × 100 + offset.

Native TVM Exit Codes

TVM itself defines a set of standard exit codes that can occur before your contract code even runs (e.g., insufficient gas, cell deserialization failure). These are not CCIP-specific. See the TON documentation for the complete list.

Common native exit codes you may encounter:

Router Errors

Facility ID: 571 — errors start at 57100

These errors occur when sending a Router_CCIPSend or Router_GetValidatedFee message.

enum Router_Error {
    DestChainNotEnabled = 57100
    SourceChainNotEnabled   // 57101
    SenderIsNotOffRamp      // 57102
    OffRampNotSetForSelector // 57103
    OffRampAddressMismatch  // 57104
    SubjectCursed           // 57105
    NotOnRamp               // 57106
    MissingTokenAmounts     // 57107
    NoMultiTokenTransfers   // 57108
    InsufficientFee         // 57109
}

OnRamp Errors

Facility ID: 134 — errors start at 13400

These errors occur during OnRamp processing of a CCIP send.

enum Error {
    UnknownDestChainSelector = 13400
    Unauthorized            // 13401
    SenderNotAllowed        // 13402
    InvalidConfig           // 13403
    UnknownToken            // 13404
    InsufficientValue       // 13405
}

FeeQuoter Errors

Facility ID: 344 — errors start at 34400

These errors occur during fee validation. They surface when the Router forwards your Router_CCIPSend to the FeeQuoter, or when you call validatedFeeCell directly.

enum FeeQuoter_Error {
    UnsupportedChainFamilySelector = 34400
    GasLimitTooHigh                 // 34401
    ExtraArgOutOfOrderExecutionMustBeTrue // 34402
    InvalidExtraArgsData            // 34403
    UnsupportedNumberOfTokens       // 34404
    InvalidEVMReceiverAddress       // 34405
    Invalid32ByteReceiverAddress    // 34406
    MsgDataTooLarge                 // 34411
    StaleGasPrice                   // 34412
    DestChainNotEnabled             // 34413
    FeeTokenNotSupported            // 34414
    TokenTransfersNotSupported      // 34419
    MessageFeeTooHigh               // 34427
}

Receiver Errors

Facility ID: 54 — hardcoded error values

These errors are thrown by the validateAndConfirm helper and the minimal_receiver example when validating incoming Receiver_CCIPReceive messages.

enum Receiver_Error {
    Unauthorized = 5400
    LowValue     // 5401
}