Reference Guides
API Error Codes & Status Messages
Reference for error codes and status messages returned by the Skip Go API, including transaction, bridge, and packet-specific statuses.
This document provides a reference for the various error codes and status messages you may encounter when using Skip Go’s APIs. Understanding these codes is essential for handling API responses correctly and providing accurate feedback to users.
Transaction Status Codes
These codes represent the overall status of a transaction being processed or tracked by the Skip Go API.| Status | Description | Notes |
|---|---|---|
STATE_UNKNOWN | The status of the transaction is unknown. | Should be treated as an error state. |
STATE_SUBMITTED | The transaction has been submitted to the blockchain network. | |
STATE_PENDING | The transaction is in progress and waiting to be processed. | |
STATE_RECEIVED | The transaction has been received by the blockchain network. | |
STATE_COMPLETED | (Internal transitional state) | This state is resolved to STATE_COMPLETED_SUCCESS or STATE_COMPLETED_ERROR before API response. |
STATE_ABANDONED | The transaction was abandoned, often due to timeout (e.g., IBC relayer). | Tracking timed out. Not necessarily a permanent transaction failure; may be retriable. |
STATE_COMPLETED_SUCCESS | The transaction has completed successfully. | This is the only status that definitively indicates successful end-to-end transaction completion. |
STATE_COMPLETED_ERROR | The transaction has completed but encountered errors. | |
STATE_PENDING_ERROR | The transaction encountered errors while being processed. |
General Error Types
These error types provide a broad categorization of issues.| Error Type | Description |
|---|---|
STATUS_ERROR_UNKNOWN | Unknown error type. |
STATUS_ERROR_TRANSACTION_EXECUTION | Error occurred during the execution of the transaction on the blockchain. |
STATUS_ERROR_INDEXING | Error occurred during Skip’s internal processing or indexing. |
STATUS_ERROR_TRANSFER | Error related to a specific transfer operation within the transaction. |
Bridge Protocol Status Codes
Different bridge protocols have their own specific status codes that reflect the state of a transfer leg using that bridge.IBC Transfer Status
| Status | Description |
|---|---|
TRANSFER_UNKNOWN | The status of the IBC transfer is unknown. |
TRANSFER_PENDING | The IBC transfer is in progress. |
TRANSFER_RECEIVED | The IBC transfer has been received by the destination chain. |
TRANSFER_SUCCESS | The IBC transfer has completed successfully. |
TRANSFER_FAILURE | The IBC transfer has failed. |
Axelar Transfer Status
| Status | Description |
|---|---|
AXELAR_TRANSFER_UNKNOWN | The status of the Axelar transfer is unknown. |
AXELAR_TRANSFER_PENDING_CONFIRMATION | The Axelar transfer is waiting for confirmation. |
AXELAR_TRANSFER_PENDING_RECEIPT | The Axelar transfer is waiting for receipt. |
AXELAR_TRANSFER_SUCCESS | The Axelar transfer has completed successfully. |
AXELAR_TRANSFER_FAILURE | The Axelar transfer has failed. |
CCTP Transfer Status
| Status | Description |
|---|---|
CCTP_TRANSFER_UNKNOWN | The status of the CCTP transfer is unknown. |
CCTP_TRANSFER_SENT | The CCTP transfer has been sent. |
CCTP_TRANSFER_PENDING_CONFIRMATION | The CCTP transfer is waiting for confirmation. |
CCTP_TRANSFER_CONFIRMED | The CCTP transfer has been confirmed. |
CCTP_TRANSFER_RECEIVED | The CCTP transfer has been received at the destination. |
GoFast Transfer Status
| Status | Description |
|---|---|
GO_FAST_TRANSFER_UNKNOWN | The status of the GoFast transfer is unknown. |
GO_FAST_TRANSFER_SENT | The GoFast transfer has been sent. |
GO_FAST_POST_ACTION_FAILED | The post-transfer action on the GoFast transfer has failed. |
GO_FAST_TRANSFER_TIMEOUT | The GoFast transfer has timed out. |
GO_FAST_TRANSFER_FILLED | The GoFast transfer has been filled. |
GO_FAST_TRANSFER_REFUNDED | The GoFast transfer has been refunded. |
LayerZero Transfer Status
| Status | Description |
|---|---|
LAYER_ZERO_TRANSFER_UNKNOWN | The status of the LayerZero transfer is unknown. |
LAYER_ZERO_TRANSFER_SENT | The LayerZero transfer has been sent. |
LAYER_ZERO_TRANSFER_RECEIVED | The LayerZero transfer has been received. |
LAYER_ZERO_TRANSFER_FAILED | The LayerZero transfer has failed. |
Hyperlane Transfer Status
| Status | Description |
|---|---|
HYPERLANE_TRANSFER_UNKNOWN | The status of the Hyperlane transfer is unknown. |
HYPERLANE_TRANSFER_SENT | The Hyperlane transfer has been sent. |
HYPERLANE_TRANSFER_FAILED | The Hyperlane transfer has failed. |
HYPERLANE_TRANSFER_RECEIVED | The Hyperlane transfer has been received. |
OPInit Transfer Status
| Status | Description |
|---|---|
OPINIT_TRANSFER_UNKNOWN | The status of the OPInit transfer is unknown. |
OPINIT_TRANSFER_SENT | The OPInit transfer has been sent. |
OPINIT_TRANSFER_RECEIVED | The OPInit transfer has been received. |
Stargate Transfer Status
| Status | Description |
|---|---|
STARGATE_TRANSFER_UNKNOWN | The status of the Stargate transfer is unknown. |
STARGATE_TRANSFER_SENT | The Stargate transfer has been sent. |
STARGATE_TRANSFER_RECEIVED | The Stargate transfer has been received. |
STARGATE_TRANSFER_FAILED | The Stargate transfer has failed. |
Eureka Transfer Status
The Eureka transfer status codes are identical to the IBC transfer status codes.| Status | Description |
|---|---|
TRANSFER_UNKNOWN | The status of the Eureka transfer is unknown. |
TRANSFER_PENDING | The Eureka transfer is in progress. |
TRANSFER_RECEIVED | The Eureka transfer has been received by the destination chain. |
TRANSFER_SUCCESS | The Eureka transfer has completed successfully. |
TRANSFER_FAILURE | The Eureka transfer has failed. |
Additional Error Types
Packet Error Types
When dealing with IBC packets, you may see these error types:| Error Type | Description |
|---|---|
PACKET_ERROR_UNKNOWN | Unknown packet error. |
PACKET_ERROR_ACKNOWLEDGEMENT | Error in packet acknowledgement. |
PACKET_ERROR_TIMEOUT | Packet timed out. |
Bridge-Specific Error Types
| Error Type | Description |
|---|---|
SEND_TOKEN_EXECUTION_ERROR | Error during Axelar send token execution. |
CONTRACT_CALL_WITH_TOKEN_EXECUTION_ERROR | Error during Axelar contract call with token execution. |