Error Codes

import { createSDK } from '@veridex/sdk';
 
const sdk = createSDK('base', { network: 'testnet' });
 
try {
  await sdk.transferViaRelayer({
    token: USDC,
    recipient: '0x...',
    amount: parseUnits('100', 6),
  });
} catch (error) {
  switch (error.code) {
    case 'INSUFFICIENT_BALANCE':
      showToast('Not enough tokens in your wallet');
      break;
    
    case 'SPENDING_LIMIT_EXCEEDED':
      showToast(`Limit exceeded. Available: ${error.available}`);
      break;
    
    case 'SESSION_EXPIRED':
      // Prompt to create new session
      await sdk.sessions.create({ duration: 3600 });
      // Retry transfer
      break;
    
    case 'RATE_LIMITED':
      // Wait and retry
      await sleep(error.retryAfter * 1000);
      // Retry transfer
      break;
    
    case 'RELAYER_UNAVAILABLE':
      showToast('Service temporarily unavailable. Please try again.');
      break;
    
    default:
      console.error('Unexpected error:', error);
      showToast('Something went wrong. Please try again.');
  }
}

import { Component, ReactNode } from 'react';
 
interface Props {
  children: ReactNode;
  fallback: ReactNode;
}
 
interface State {
  hasError: boolean;
  error?: Error;
}
 
class VeridexErrorBoundary extends Component<Props, State> {
  state: State = { hasError: false };
 
  static getDerivedStateFromError(error: Error): State {
    return { hasError: true, error };
  }
 
  render() {
    if (this.state.hasError) {
      const code = (this.state.error as any)?.code;
      
      if (code === 'PASSKEY_NOT_SUPPORTED') {
        return <div>Your browser doesn't support passkeys.</div>;
      }
      
      return this.props.fallback;
    }
 
    return this.props.children;
  }
}

import { AgentPaymentError, AgentPaymentErrorCode } from '@veridex/agentic-payments';

try {
  await agent.pay({ chain: 10004, token: 'USDC', amount: '100000000', recipient: '0x...' });
} catch (error) {
  if (error instanceof AgentPaymentError) {
    console.log('Code:', error.code);
    console.log('Message:', error.message);
    console.log('Retryable:', error.retryable);
    console.log('Suggestion:', error.suggestion);
 
    switch (error.code) {
      case AgentPaymentErrorCode.LIMIT_EXCEEDED:
        console.log('Over budget — wait for daily reset');
        break;
      case AgentPaymentErrorCode.INSUFFICIENT_BALANCE:
        console.log('Need more tokens:', error.suggestion);
        break;
      case AgentPaymentErrorCode.SESSION_EXPIRED:
        console.log('Re-initialize agent wallet');
        break;
      case AgentPaymentErrorCode.NETWORK_ERROR:
        if (error.retryable) {
          console.log('Retrying...');
        }
        break;
    }
  }
}

interface VeridexError extends Error {
  code: string;           // Machine-readable error code
  message: string;        // Human-readable message
  details?: {             // Additional context
    [key: string]: any;
  };
  retryAfter?: number;    // Seconds to wait (for rate limits)
  httpStatus?: number;    // HTTP status code (relayer errors)
}

interface AgentPaymentError extends Error {
  code: AgentPaymentErrorCode;  // Typed error code enum
  message: string;              // Human-readable message
  retryable: boolean;           // Whether the operation can be retried
  suggestion?: string;          // Suggested action for the user/agent
}

{
  "code": "SPENDING_LIMIT_EXCEEDED",
  "message": "Transfer exceeds daily spending limit",
  "details": {
    "limitType": "daily",
    "limit": "1000000000000000000",
    "attempted": "2000000000000000000",
    "available": "500000000000000000",
    "resetsAt": 1704153600
  }
}

{
  "code": "LIMIT_EXCEEDED",
  "message": "Transaction of $150.00 exceeds daily limit of $100.00",
  "retryable": false,
  "suggestion": "Reduce amount to $75.00 or wait for daily reset at 2026-02-15T00:00:00Z"
}