Error Codes

This section defines all error code reference for debugging SDK integrations. Shows all possible errors, what causes them, and how to handle them.

---

General Errors

Code	Description
unknown-error	An unexpected error occurred
invalid-configuration	SDK configuration is invalid
operation-timeout	Operation timed out
operation-cancelled	User cancelled the operation

---

Provider Errors

Code	Description
provider-missing	Required wallet provider not configured
provider-initialization-failed	Failed to initialize wallet provider
provider-call-failed	Wallet provider method call failed
signer-missing	Transaction signer not available
user-rejected	User rejected the transaction or signature
network-mismatch	Wallet is connected to wrong network

---

Validation Errors

Code	Description
invalid-address	Address format is invalid
invalid-amount	Amount format is invalid
amount-too-small	Amount is below minimum
amount-too-large	Amount is above maximum
insufficient-balance	Not enough balance for operation
invalid-parameter	Parameter value is invalid
missing-required-parameter	Required parameter was not provided
invalid-chain	Chain is not supported
invalid-state	Action is in invalid state for operation
invalid-asset	Asset is not supported

---

Contract Errors

Code	Description
contract-call-failed	Smart contract call failed
transaction-failed	Transaction execution failed
transaction-reverted	Transaction was reverted
approval-failed	Token approval failed
insufficient-allowance	Token allowance is too low
gas-estimation-failed	Could not estimate gas

---

Registry Errors

Code	Description
route-not-found	No matching route found
invalid-route-definition	Route definition is invalid
unsupported-chain	Chain is not supported in environment
unsupported-asset	Asset is not supported
incompatible-route	Route is incompatible with parameters
environment-mismatch	Environment mismatch

---

Error Handling

import {
  isLombardError,
  ProviderErrorCode,
  ValidationErrorCode,
} from '@lombard.finance/sdk';

try {
  await stake.authorize();
} catch (error) {
  if (!isLombardError(error)) {
    throw error;
  }

  switch (error.code) {
    case ProviderErrorCode.USER_REJECTED:
      // User cancelled - offer retry
      break;

    case ValidationErrorCode.AMOUNT_TOO_SMALL:
      // Show minimum amount from error.metadata
      break;

    case ProviderErrorCode.NETWORK_MISMATCH:
      // Prompt user to switch networks
      break;

    default:
      // Generic error handling
      break;
  }
}

---

Error Metadata

Errors include context in the metadata property:

if (error.code === ValidationErrorCode.AMOUNT_TOO_SMALL) {
  // error.metadata.amount: provided amount
  // error.metadata.minimum: minimum required
  // error.metadata.asset: asset symbol
}

if (error.code === ProviderErrorCode.PROVIDER_MISSING) {
  // error.metadata.chain: chain that needs provider
  // error.metadata.providerType: type of provider needed
}

---