Dynamic slippage calculation for synthetic routes — optimized per token category, liquidity depth, and trade size.
Usage
// Auto — SDK calculates optimal slippage
await flash.executeLocal(params, { slippage: 'auto' });
// Manual override — exact bps value
await flash.executeLocal(params, { slippage: 50 }); // 50 bps
// Modes: 'auto', 'aggressive', 'safe', or exact number
import { calculateSlippageBps } from '@vaea/flash';
const bps = calculateSlippageBps('auto', 'synthetic', 0.05);
// Returns 45 bps for a synthetic route with 0.05% price impact
Slippage by Token Category
Route Type
Mode
Slippage
Direct
auto
10 bps (0.1%)
Direct
aggressive
5 bps (0.05%)
Direct
safe
50 bps (0.5%)
Synthetic
auto
max(priceImpact × 200, 30) × 1.5
Synthetic
aggressive
max(priceImpact × 200, 30) × 1.0
Synthetic
safe
max(priceImpact × 200, 30) × 3.0
Calculate Manually
typescript
import { calculateSlippageBps } from '@vaea/flash';
// Modes: 'auto', 'aggressive', 'safe'
const bps = calculateSlippageBps('auto', 'synthetic', priceImpact);
// 'aggressive' — minimal slippage (may fail on volatile markets)
// 'safe' — wide margin (always lands but costs more)
// 'auto' — balanced, recommended for most use cases
ℹ️ Note
For direct routes, the slippage is minimal because no swap is involved. For synthetic routes, slippage scales with price impact — the SDK uses 2× the impact as a safety margin, with a minimum of 30 bps.
