Error Codes

class NexusError extends Error {
  readonly code: ErrorCode;
  readonly data?: {
    context?: string;              // Where or why it happened
    cause?: unknown;               // Nested error
    details?: Record<string, unknown>; // Additional structured info
  };
}

import { NexusError, ERROR_CODES } from '@avail-project/nexus-core';

try {
  await sdk.bridge({ token: 'USDC', amount: 1_000_000n, toChainId: 137 });
} catch (error) {
  if (error instanceof NexusError) {
    console.error(`Error Code: ${error.code}`);
    console.error(`Message: ${error.message}`);
    console.error(`Context: ${error.data?.context}`);
    
    // Handle specific errors
    switch (error.code) {
      case ERROR_CODES.INSUFFICIENT_BALANCE:
        showInsufficientBalanceUI();
        break;
      case ERROR_CODES.USER_DENIED_INTENT:
        // User cancelled - not an error to display
        break;
      default:
        showGenericError(error.message);
    }
  }
}

export const ERROR_CODES = {
  // User Actions
  USER_DENIED_INTENT: 'USER_DENIED_INTENT',
  USER_DENIED_ALLOWANCE: 'USER_DENIED_ALLOWANCE',
  USER_DENIED_INTENT_SIGNATURE: 'USER_DENIED_INTENT_SIGNATURE',
  USER_DENIED_SIWE_SIGNATURE: 'USER_DENIED_SIWE_SIGNATURE',
  
  // Balance & Funds
  INSUFFICIENT_BALANCE: 'INSUFFICIENT_BALANCE',
  NO_BALANCE_FOR_ADDRESS: 'NO_BALANCE_FOR_ADDRESS',
  
  // Validation
  INVALID_INPUT: 'INVALID_INPUT',
  INVALID_ADDRESS_LENGTH: 'INVALID_ADDRESS_LENGTH',
  INVALID_VALUES_ALLOWANCE_HOOK: 'INVALID_VALUES_ALLOWANCE_HOOK',
  TOKEN_NOT_SUPPORTED: 'TOKEN_NOT_SUPPORTED',
  
  // Initialization
  SDK_NOT_INITIALIZED: 'SDK_NOT_INITIALIZED',
  SDK_INIT_STATE_NOT_EXPECTED: 'SDK_INIT_STATE_NOT_EXPECTED',
  WALLET_NOT_CONNECTED: 'WALLET_NOT_CONNECTED',
  CONNECT_ACCOUNT_FAILED: 'CONNECT_ACCOUNT_FAILED',
  
  // Chain & Network
  CHAIN_NOT_FOUND: 'CHAIN_NOT_FOUND',
  CHAIN_DATA_NOT_FOUND: 'CHAIN_DATA_NOT_FOUND',
  VAULT_CONTRACT_NOT_FOUND: 'VAULT_CONTRACT_NOT_FOUND',
  ENVIRONMENT_NOT_SUPPORTED: 'ENVIRONMENT_NOT_SUPPORTED',
  ENVIRONMENT_NOT_KNOWN: 'ENVIRONMENT_NOT_KNOWN',
  UNIVERSE_NOT_SUPPORTED: 'UNIVERSE_NOT_SUPPORTED',
  
  // Transactions
  TRANSACTION_TIMEOUT: 'TRANSACTION_TIMEOUT',
  TRANSACTION_REVERTED: 'TRANSACTION_REVERTED',
  TRANSACTION_CHECK_ERROR: 'TRANSACTION_CHECK_ERROR',
  FETCH_GAS_PRICE_FAILED: 'FETCH_GAS_PRICE_FAILED',
  
  // Operations
  SIMULATION_FAILED: 'SIMULATION_FAILED',
  QUOTE_FAILED: 'QUOTE_FAILED',
  SWAP_FAILED: 'SWAP_FAILED',
  REFUND_FAILED: 'REFUND_FAILED',
  REFUND_CHECK_ERROR: 'REFUND_CHECK_ERROR',
  
  // Intent & Solver
  LIQUIDITY_TIMEOUT: 'LIQUIDITY_TIMEOUT',
  RATES_CHANGED_BEYOND_TOLERANCE: 'RATES_CHANGED_BEYOND_TOLERANCE',
  RFF_FEE_EXPIRED: 'RFF_FEE_EXPIRED',
  DESTINATION_REQUEST_HASH_NOT_FOUND: 'DESTINATION_REQUEST_HASH_NOT_FOUND',
  DESTINATION_SWEEP_ERROR: 'DESTINATION_SWEEP_ERROR',
  
  // Allowance
  SLIPPAGE_EXCEEDED_ALLOWANCE: 'SLIPPAGE_EXCEEDED_ALLOWANCE',
  ALLOWANCE_SETTING_ERROR: 'ALLOWANCE_SETTING_ERROR',
  
  // Other
  INTERNAL_ERROR: 'INTERNAL_ERROR',
  UNKNOWN_SIGNATURE: 'UNKNOWN_SIGNATURE',
  ASSET_NOT_FOUND: 'ASSET_NOT_FOUND',
  COSMOS_ERROR: 'COSMOS_ERROR',
} as const;