@lifi/sdk/src/core/EVM/parseEVMErrors.ts

LI.FI Any-to-Any Cross-Chain-Swap SDK

import type { LiFiStep } from '@lifi/types'
import { AtomicReadyWalletRejectedUpgradeError } from 'viem'
import { BaseError } from '../../errors/baseError.js'
import { ErrorMessage, LiFiErrorCode } from '../../errors/constants.js'
import { TransactionError, UnknownError } from '../../errors/errors.js'
import { SDKError } from '../../errors/SDKError.js'
import { fetchTxErrorDetails } from '../../utils/fetchTxErrorDetails.js'
import type { Process } from '../types.js'

export const parseEVMErrors = async (
  e: Error,
  step?: LiFiStep,
  process?: Process
): Promise<SDKError> => {
  if (e instanceof SDKError) {
    e.step = e.step ?? step
    e.process = e.process ?? process
    return e
  }

  const baseError = await handleSpecificErrors(e, step, process)

  return new SDKError(baseError, step, process)
}

const handleSpecificErrors = async (
  e: any,
  step?: LiFiStep,
  process?: Process
) => {
  if (
    e.name === 'UserRejectedRequestError' ||
    e.cause?.name === 'UserRejectedRequestError' ||
    /**
     * This error is specific to MetaMask and thrown when the user rejects the signature of the native token transfer, at that point, the bundle id is unknown.
     * @see https://github.com/MetaMask/metamask-extension/blob/main/app/scripts/lib/transaction/eip5792.ts#L141-L146
     */
    e.name === 'UnknownBundleIdError'
  ) {
    return new TransactionError(LiFiErrorCode.SignatureRejected, e.message, e)
  }
  /**
   * Safe Wallet via WalletConnect returns -32000 code when user rejects the signature
   * {
   *   code: -32000,
   *   message: 'User rejected transaction',
   * }
   */
  if (
    e.cause?.code === -32000 ||
    // Safe doesn't return proper code, but the error details includes 'rejected'
    (e.name === 'TransactionExecutionError' &&
      e.cause?.details?.includes('rejected'))
  ) {
    return new TransactionError(LiFiErrorCode.SignatureRejected, e.message, e)
  }
  /**
   * Some wallets reject transactions sometimes with this code because of internal and JSON-RPC errors, e.g.:
   * {
   *     "code": -32603,
   *     "message": "Pop up window failed to open",
   *     "docUrl": "https://docs.cloud.coinbase.com/wallet-sdk/docs/errors"
   * }
   */
  if (e.cause?.code === -32603) {
    return new TransactionError(LiFiErrorCode.TransactionRejected, e.message, e)
  }

  /**
   * This error is specific to Smart Accounts and thrown when the user doesn't have enough gas to pay for the transaction.
   */
  if (
    e.name === 'InsufficientPrefundError' ||
    e.cause?.name === 'InsufficientPrefundError' ||
    e.cause?.cause?.name === 'InsufficientPrefundError'
  ) {
    return new TransactionError(LiFiErrorCode.InsufficientGas, e.message, e)
  }

  if (
    step &&
    process?.txHash &&
    e.code === LiFiErrorCode.TransactionFailed &&
    e.message === ErrorMessage.TransactionReverted
  ) {
    const response = await fetchTxErrorDetails(
      process.txHash,
      step.action.fromChainId
    )

    const errorMessage = response?.error_message

    if (errorMessage?.toLowerCase().includes('out of gas')) {
      return new TransactionError(
        LiFiErrorCode.GasLimitError,
        ErrorMessage.GasLimitLow,
        e
      )
    }
  }

  if (e instanceof BaseError) {
    return e
  }

  return new UnknownError(e.message || ErrorMessage.UnknownError, e)
}

export const isAtomicReadyWalletRejectedUpgradeError = (e: any) => {
  if (e.cause?.code === AtomicReadyWalletRejectedUpgradeError.code) {
    return true
  }

  const details = e.cause?.details?.toLowerCase()
  const isTransactionError =
    e.name === 'TransactionExecutionError' ||
    e.cause?.name === 'TransactionExecutionError'
  const hasRejectedUpgrade =
    details?.includes('rejected') && details?.includes('upgrade')
  const has7702ErrorCode = details?.includes('7702')

  return isTransactionError && (hasRejectedUpgrade || has7702ErrorCode)
}