Smart Retry

Automatic transaction retry with priority fee escalation (×1.5 per attempt) and intelligent error classification. Never retries program errors.

How It Works

text

Attempt 1: priority 1,000 µ-lamports → Timeout
  → Classify: 'congestion' → RETRY (×1.5 escalation, wait 400ms)
Attempt 2: priority 1,500 µ-lamports → BlockhashExpired
  → Classify: 'expired' → REBUILD + RETRY (fresh blockhash)
Attempt 3: priority 2,250 µ-lamports → Success ✓

Code Examples

const sig = await flash.executeLocal({
  token: 'SOL', amount: 1000,
  onFunds: async (ixs) => [...ixs, myArbIx],
}, {
  retry: {
    maxAttempts: 3,
    strategy: 'adaptive',   // smart retry with escalation
    onRetry: (attempt, reason) => {
      console.log(`Retry #${attempt}: ${reason}`);
    },
  },
  priorityMicroLamports: 1000,
});

Error Classification

Classified As	Error Patterns	Action	Retried?
expired	`Blockhash not found, expired, block height exceeded`	Rebuild TX with fresh blockhash + retry	✅
congestion	All other errors (timeout, network)	Priority fee ×1.5, wait 400ms, retry	✅
program_error	`InstructionError, Custom(...), custom program error`	Stop immediately — your logic has a bug	❌ Never

Configuration

Option	Type	Default	Description
`maxAttempts`	`number`	3	Maximum number of send attempts
`strategy`	`'none' \| 'adaptive'`	adaptive	`none` = single attempt, `adaptive` = smart retry
`onRetry`	`(attempt, reason) => void`	undefined	Callback fired on each retry for logging

⚠️ Warning

Program errors (logic bugs in your instructions) are never retried. This prevents wasting SOL on transactions that will always fail.

💡 Tip

When using Jito Bundles, Smart Retry escalates the tip amount instead of the priority fee.