Error handling

class ContoError extends Error {
  readonly code: string;
  readonly status: number;
  readonly requestId?: string;
  readonly retryAfter?: number;
  readonly retryGuidance?: string;
  readonly actionUrl?: string;
  readonly fieldErrors?: Array<{ field: string; message: string }>;
  readonly reasons?: string[];
}

import { Conto, ContoError } from '@conto_finance/sdk';

const conto = new Conto({ apiKey: process.env.CONTO_API_KEY! });

try {
  await conto.payments.pay({
    amount: 100,
    recipientAddress: '0x0000000000000000000000000000000000000001',
    purpose: 'API credits',
  });
} catch (error) {
  if (!(error instanceof ContoError)) throw error;

  switch (error.code) {
    case 'PAYMENT_DENIED':
    case 'POLICY_DENIED_AT_EXECUTION':
      // Final for this request. Show error.reasons and do not retry.
      console.log('Declined:', error.reasons);
      break;

    case 'REQUIRES_APPROVAL':
      // Approval in Conto executes the payment. Keep error.requestId and
      // read payments.status() later for the receipt.
      console.log('Awaiting approval:', error.requestId);
      break;

    case 'INSUFFICIENT_BALANCE':
      console.log('Wallet needs funding');
      break;

    case 'LIMIT_EXCEEDED':
      // A limit changed before execution. Request a smaller payment.
      break;

    case 'RATE_LIMITED':
      // The SDK already retried the request step. It never retries execute().
      console.log('Retry after seconds:', error.retryAfter);
      break;

    default:
      // Log the stable fields only. Never log request bodies or credentials.
      console.error('Payment failed', {
        code: error.code,
        status: error.status,
        requestId: error.requestId,
      });
  }
}

import { Conto, ContoError } from '@conto_finance/sdk';

const requestId = process.env.CONTO_PAYMENT_REQUEST_ID;
if (!requestId) throw new Error('Set CONTO_PAYMENT_REQUEST_ID to the saved request ID');

const conto = new Conto({
  apiKey: process.env.CONTO_API_KEY!,
  timeout: 60000, // 60 seconds
});

try {
  const status = await conto.payments.status(requestId);
  console.log('Payment state:', status.status);
  if (status.transaction) {
    console.log('Transaction:', status.transaction.id, status.transaction.status);
    console.log('Settlement mode:', status.transaction.settlementMode);
  }
} catch (error) {
  if (
    !(error instanceof ContoError) ||
    !['TIMEOUT', 'NETWORK_ERROR'].includes(error.code)
  ) {
    throw error;
  }
  console.error('Status is still unknown. Retain request ID and retry the read later:', requestId);
  process.exitCode = 1;
}