Error Codes#

// Check if market exists before interacting
try {
  const market = await program.account.market.fetch(marketPda);
} catch (e) {
  if (e.code === 0x1001) {
    console.log('Market already exists');
  }
}

// Handle trading state
if (error.code === 0x1004) {
  console.log('Trading has ended for this market');
  // Redirect to settlement or next market
}

// Handle stale oracle
if (error.code === 0x2002) {
  console.log('Oracle price is stale, retrying in 1 second...');
  await sleep(1000);
  // Retry operation
}

// Handle confidence issues
if (error.code === 0x2004) {
  console.log('Price confidence too wide, market may be volatile');
  // Consider waiting for better conditions
}

// Handle insufficient balance
if (error.code === 0x300d) {
  const required = calculateCollateral(price, quantity);
  console.log(`Need ${required} USDT to place this order`);
  // Prompt user to deposit
}

// Handle PostOnly rejection
if (error.code === 0x3004) {
  console.log('Your PostOnly order would match immediately');
  // Either adjust price or switch to Limit
}

// Handle order not found
if (error.code === 0x3003) {
  console.log('Order not found - may have been filled');
  // Refresh order book state
}

// This typically indicates a bug or extreme values
if (error.code === 0x4001) {
  console.error('Math overflow detected - this should not happen');
  console.error('Check your input values:', { price, quantity });
  // Report as bug if values are reasonable
}

// Handle PDA derivation errors
if (error.code === 0x5003) {
  // Verify PDA derivation
  const [expectedPda] = PublicKey.findProgramAddressSync(
    [Buffer.from('seesaw'), Buffer.from('market'), marketIdBuffer],
    programId
  );
  console.log('Expected PDA:', expectedPda.toString());
}

// Handle insolvency (critical)
if (error.code === 0x5005) {
  console.error('CRITICAL: Insolvency detected - report as bug immediately');
  // This indicates a protocol-level issue
}

// Handle protocol pause
if (error.code === 0x6001) {
  console.log('Protocol is currently paused');
  // Check announcements for more info
}

// Handle losing position redemption attempt
if (error.code === 0x7002) {
  console.log('These shares did not win - payout is 0');
}

// Handle market expiration check
if (error.code === 0x7001) {
  console.log('Market cannot be expired yet - check expiration window');
}

// Handle fee split validation
if (error.code === 0x8002) {
  console.log('Fee splits must sum to exactly 10000 bps');
}

// Handle already-set referrer
if (error.code === 0x8003) {
  console.log('Referrer is already set and cannot be changed');
}

function handleSeesawError(error: any): string {
  const code = error.code || error.error?.code;

  const errorMessages: Record<number, string> = {
    0x1001: 'Market already exists',
    0x1002: 'Invalid market state for this operation',
    0x1004: 'Trading has ended for this market',
    0x2002: 'Oracle price is stale - try again shortly',
    0x3001: 'Invalid order quantity',
    0x300d: 'Insufficient balance for this order',
    0x3004: 'PostOnly order would match - adjust price',
    // Add more as needed
  };

  return errorMessages[code] || `Unknown error: ${code}`;
}

async function withRetry<T>(
  fn: () => Promise<T>,
  options: { maxRetries: number; retryableErrors: number[] }
): Promise<T> {
  let lastError: any;

  for (let i = 0; i < options.maxRetries; i++) {
    try {
      return await fn();
    } catch (e: any) {
      lastError = e;

      if (!options.retryableErrors.includes(e.code)) {
        throw e;
      }

      await sleep(1000 * Math.pow(2, i));
    }
  }

  throw lastError;
}

// Use with oracle errors
await withRetry(() => snapshotPrice(market), {
  maxRetries: 5,
  retryableErrors: [0x2002], // StaleOracle
});

MARKET (0x10xx)                ORACLE (0x20xx)              ORDER (0x30xx)
├─ 0x1001 MarketExists         ├─ 0x2001 OracleMismatch     ├─ 0x3001 InvalidQuantity
├─ 0x1002 InvalidState         ├─ 0x2002 StaleOracle        ├─ 0x3002 OrderbookFull
├─ 0x1003 TradingNotStarted    ├─ 0x2003 InvalidPrice       ├─ 0x3003 OrderNotFound
├─ 0x1004 TradingEnded         ├─ 0x2004 ConfidenceTooWide  ├─ 0x3004 WouldCross
├─ 0x1005 AlreadyResolved      ├─ 0x2005 FeedIdMismatch     ├─ 0x3005 PriceTooLow
├─ 0x1006 MarketNotResolved    ├─ 0x2006 InvalidOracleData  ├─ 0x3006 PriceTooHigh
├─ 0x1007 TooEarly             └─ 0x2007 OraclePriceJump    ├─ 0x3007 SlippageExceeded
├─ 0x1008 EpochNotStarted                                   ├─ 0x3008 InsufficientFill
├─ 0x1009 EpochNotEnded        MATH (0x40xx)                ├─ 0x3009 NoFillForIoc
├─ 0x100A NotOwner             └─ 0x4001 MathOverflow       ├─ 0x300A SelfTradeAbort
├─ 0x100B PositionsRemaining                                ├─ 0x300B PostOnlyModeActive
├─ 0x100C MarketCloseTimeout   ACCOUNT (0x50xx)             ├─ 0x300C OrderNotExpired
├─ 0x100D InvalidCreator       ├─ 0x5001 InvalidAccountType ├─ 0x300D InsufficientBalance
├─ 0x100E VaultNotEmpty        ├─ 0x5002 InvalidAccountOwner├─ 0x300F MaxTotalSharesExceeded
├─ 0x100F InvalidDuration      ├─ 0x5003 InvalidPDA         ├─ 0x3010 AuthorityClaimNotEligible
├─ 0x1010 InvalidConfidenceRatio├─ 0x5004 AlreadyInitialized├─ 0x3011 OrderbookCrossedPostInsert
└─ 0x1011 InvalidStateTransition├─ 0x5005 InsolvencyDetected├─ 0x3012 InsufficientFreeBalance
                               ├─ 0x5006 UnauthorizedInitializer├─ 0x3013 MinRestingNotionalNotMet
POSITION (0x60xx)              ├─ 0x5007 DuplicateAccount   ├─ 0x3014 OrderPriceOutOfBand
└─ 0x6001 ProtocolPaused       ├─ 0x5009 FailedToSerializeEvent├─ 0x3015 TraderLedgerFull
                               ├─ 0x500A FailedToFlushBuffer├─ 0x3016 OrderbookNotEmpty
TOKEN (0x70xx)                 ├─ 0x500B InvalidRecorderPayloadLength├─ 0x3017 TraderLedgerNotAllocated
├─ 0x7001 CannotExpire         ├─ 0x500C InvalidRecorderVersion├─ 0x3018 TraderLedgerOversized
├─ 0x7002 InvalidRedemption    ├─ 0x500D InvalidRecorderAuthorityKind├─ 0x3019 OrderbookTreeCorruption
├─ 0x7003 InvalidMint          └─ 0x500E InvalidRecorderEventCount├─ 0x301A InternalInvariantViolated
├─ 0x7004 SolvencyViolation                                   ├─ 0x301B BookConsistencyInvariantViolated
├─ 0x7005 SolvencyInvariantViolated                           └─ 0x301C CrossedBookInvariantViolated
└─ 0x7006 InvalidSettlementMintDecimals

FEE/REFERRAL/TREASURY (0x80xx)                 AUTHORITY/GOVERNANCE/EMERGENCY (0x90xx)
├─ 0x8001 InvalidFeeCurve                      ├─ 0x9001 NoPendingAuthority
├─ 0x8002 InvalidFeeSplit                      ├─ 0x9002 UnauthorizedClaim
├─ 0x8003 ReferrerAlreadySet                   ├─ 0x9003 NoPendingOracleUpdate
├─ 0x8004 SelfReferralForbidden                ├─ 0x9004 OracleTimelockNotElapsed
├─ 0x8005 ReferrerTreasuryMismatch             ├─ 0x9006 EmergencyDelayNotElapsed
├─ 0x8006 AccumulatedAmountZero                ├─ 0x9007 UnauthorizedPauser
├─ 0x8007 FeeConfigRateLimit                   └─ 0x9008 OracleProgramIdFrozen
├─ 0x8008 TreasuryIndexOutOfRange
├─ 0x8009 TreasuryRecipientMismatch
├─ 0x800A InvalidTreasuryRecipient
├─ 0x800B DuplicateTreasuryRecipient
├─ 0x800C TreasuryUpdateRateLimit
├─ 0x800D OperationalParamsRateLimit
├─ 0x800E MicrostructureRateLimit
├─ 0x800F ReferralCacheMismatch
├─ 0x8010 InvalidReferralRollupBatch
├─ 0x8011 ReferralFeesPending
├─ 0x8012 ReferralLiabilityMismatch
├─ 0x8013 InvalidSplineConfig
├─ 0x8014 InstructionNotYetEnabled
├─ 0x8015 InvalidSplineShape
├─ 0x8016 UnauthorizedSplineMaker
├─ 0x8017 StaleSequence
├─ 0x8018 InvalidMidPrice
├─ 0x8019 InvalidSplineSeries
├─ 0x801A InsufficientSplineCommitment
├─ 0x801B SplineGenerationMismatch
├─ 0x801C InvalidSplineQuoteOrigin
├─ 0x801D MissingSplineAccounts
├─ 0x801E ProtocolShareTooLow
├─ 0x801F MakerRebateShareTooHigh
├─ 0x8020 MakerRebateRestBoundTooHigh
├─ 0x8021 UnsettledSplines
├─ 0x8022 OrderIdExhausted
├─ 0x8023 UnsupportedFreeFundsSide
├─ 0x8024 BulkCancelIncomplete
├─ 0x8025 RestingNotionalTooSmall
└─ 0x8026 SplineCommitmentUnderflow

`OracleProgramIdFrozen (0x9008)`, along with the related oracle-timelock
entries, is retained as an append-only legacy error identity. The historical
`0x31`/`0x32` instruction assignments are reserved wire holes; current default
dispatch rejects them with `InvalidInstructionData` before any error variant is
constructed.

EXTERNAL MARKET (0xA0xx)
├─ 0xA001 WrongResolver
├─ 0xA002 ResolverNotRegistered
├─ 0xA003 ResolverRevoked
├─ 0xA004 MarketKindDisabled
├─ 0xA005 UnsupportedMarketKind
├─ 0xA006 MarketHalted
├─ 0xA007 ExternalMarketInvalid
├─ 0xA008 InvalidPayoutNumerators
├─ 0xA009 MarketMetaMismatch
├─ 0xA00A ExternalMarketNotExpired
├─ 0xA00B PreallocationReceiptMismatch
├─ 0xA00C PreallocationReceiptNotActive
├─ 0xA00D PreallocationReclaimTooEarly
├─ 0xA00E PreallocationTargetMismatch
├─ 0xA00F PreallocationDataNotZero
├─ 0xA010 PreallocationMarketExists
├─ 0xA011 ExternalCloseTimeOutOfRange
└─ 0xA012 ExternalExpiryDeadlineOverflow