API Error Codes

This document contains all user error codes that can be returned by the API. These errors are categorized by their retry behavior and error type.

Contract-Level

Code	Type	Description
1201	Terminal	User account is not delegated to the OtimDelegate contract
1202	Terminal	Signature verification failed for the provided instruction
1203	Terminal	Action cannot be executed due to contract-level restrictions
1204	Retryable	Action execution failed on-chain, may succeed with retry
1205	Terminal	Instruction has already been deactivated and cannot be executed
1206	Terminal	Instruction has already been deactivated in DeactivateInstructionAction

Transfer

Code	Type	Description
1301	Terminal	Invalid or malformed arguments provided for transfer action
1302	Terminal	SafeERC20 transfer operation failed due to token contract issues
1303	Retryable	Insufficient fee token balance to cover execution costs
1304	Retryable	Insufficient native token balance for the transfer amount

Transfer ERC20

Code	Type	Description
1305	Terminal	Invalid or malformed arguments provided for ERC20 transfer action
1306	Terminal	SafeERC20 transfer operation failed due to token contract issues
1307	Retryable	Insufficient fee token balance to cover execution costs
1308	Retryable	Insufficient ERC20 token balance for the transfer amount

Refuel

Code	Type	Description
1309	Terminal	Invalid or malformed arguments provided for refuel action
1310	Terminal	SafeERC20 transfer operation failed due to token contract issues
1311	Retryable	Insufficient fee token balance to cover execution costs
1313	Retryable	Insufficient native token balance for the refuel amount

Refuel ERC20

Code	Type	Description
1314	Terminal	Invalid or malformed arguments provided for ERC20 refuel action
1315	Terminal	SafeERC20 transfer operation failed due to token contract issues
1316	Retryable	Insufficient fee token balance to cover execution costs
1318	Retryable	Insufficient ERC20 token balance for the refuel amount

UniswapV3 Exact Input

Code	Type	Description
1319	Terminal	Invalid or malformed arguments provided for UniswapV3 swap action
1320	Terminal	UniswapV3 pool does not exist for the specified token pair and fee tier
1321	Terminal	Unexpected invalid tick data encountered during pool validation
1322	Terminal	SafeERC20 transfer operation failed due to token contract issues
1323	Retryable	Insufficient fee token balance to cover execution costs
1324	Retryable	Insufficient input token balance for the swap amount
1328	Retryable	UniswapV3 swap received too little output tokens

Deactivate Instruction

Code	Type	Description
1340	Retryable	Insufficient fee token balance to cover execution costs
1341	Terminal	Invalid or malformed arguments provided for deactivate instruction action
1342	Terminal	SafeERC20 transfer operation failed due to token contract issues

Sweep CCTP

Code	Type	Description
1343	Terminal	Invalid or malformed arguments provided for sweep CCTP action
1344	Terminal	CCTP token is not supported for the specified operation
1345	Retryable	Insufficient fee token balance to cover execution costs
1346	Terminal	SafeERC20 transfer operation failed due to token contract issues

Transfer CCTP

Code	Type	Description
1347	Terminal	Invalid or malformed arguments provided for transfer CCTP action
1348	Retryable	Insufficient token balance for the CCTP transfer amount
1349	Terminal	CCTP token is not supported for the specified operation
1350	Retryable	Insufficient fee token balance to cover execution costs
1351	Terminal	SafeERC20 transfer operation failed due to token contract issues

Sweep

Code	Type	Description
1352	Terminal	Invalid or malformed arguments provided for sweep action
1353	Retryable	Insufficient fee token balance to cover execution costs
1354	Terminal	SafeERC20 transfer operation failed due to token contract issues

Sweep ERC20

Code	Type	Description
1355	Terminal	Invalid or malformed arguments provided for sweep ERC20 action
1356	Retryable	Insufficient fee token balance to cover execution costs
1357	Terminal	SafeERC20 transfer operation failed due to token contract issues

Sweep UniswapV3

Code	Type	Description
1358	Terminal	Invalid or malformed arguments provided for sweep UniswapV3 action
1359	Terminal	UniswapV3 pool does not exist for the specified token pair and fee tier
1360	Terminal	Unexpected invalid tick data encountered during pool validation
1361	Terminal	SafeERC20 transfer operation failed due to token contract issues
1362	Retryable	Insufficient fee token balance to cover execution costs