Migrate from v3 to v4

# Update starknet.js to v8.9+ (required for PaymasterInterface)
npm install starknet@^8.9.1

# Update the SDK
npm install @avnu/avnu-sdk@^4.0.0

// v3 - NO LONGER WORKS
const response = await executeSwap(account, quote, {
  gasless: true,
  gasTokenAddress: '0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7',
  maxGasTokenAmount: BigInt('1000000000000000000'),
});

import { executeSwap } from '@avnu/avnu-sdk';
// PaymasterInterface comes from starknet.js
import { PaymasterInterface } from 'starknet';

// Create your paymaster provider (implementation depends on your setup)
const paymasterProvider: PaymasterInterface = /* your paymaster implementation */;

const response = await executeSwap({
  provider: account,
  quote,
  slippage: 0.005,
  paymaster: {
    active: true,
    provider: paymasterProvider,
    params: executionParams, // ExecutionParameters from starknet.js
  },
});

// v3
interface Quote {
  buyAmountWithoutFees: bigint;
  buyAmountWithoutFeesInUsd: number;
  gasFees: bigint;
  gasFeesInUsd: number;
  avnuFees: bigint;
  avnuFeesInUsd: number;
  avnuFeesBps: bigint;
  integratorFees: bigint;
  integratorFeesInUsd: number;
  integratorFeesBps: bigint;
  liquiditySource: string;
  gasless: Gasless;
  // ...
}

// v4
interface Quote {
  fee: Fee;           // Consolidated fee structure
  priceImpact: number;        // New
  estimatedSlippage?: number; // New
  gasFees: bigint;
  gasFeesInUsd?: number;      // Now optional
  // ...
}

interface Fee {
  feeToken: string;
  avnuFees: bigint;
  avnuFeesInUsd: number;
  avnuFeesBps: bigint;
  integratorFees: bigint;
  integratorFeesInUsd: number;
  integratorFeesBps: bigint;
}

// v3
interface Route {
  routeInfo?: Map<string, string>;
  // ...
}

// v4
interface Route {
  routeInfo?: Record<string, string>; // Changed from Map to Record
  alternativeSwapCount: number;       // New field
  // ...
}

// v3
interface Source {
  name: string;
  address: string;  // Removed in v4
  icon?: string;    // Removed in v4
  type: SourceType;
}

// v4
interface Source {
  name: string;
  type: SourceType;
}

// v3
enum SourceType {
  DEX = 'DEX',
  MARKET_MAKER = 'MARKET_MAKER',
  SOLVER = 'SOLVER',        // Removed in v4
  ORDERBOOK = 'ORDERBOOK',
}

// v4
enum SourceType {
  DEX = 'DEX',
  MARKET_MAKER = 'MARKET_MAKER',
  TOKEN_WRAPPER = 'TOKEN_WRAPPER', // New
  ORDERBOOK = 'ORDERBOOK',
}

// v3
interface Page<T> {
  content: T[];
  totalPages: number;
  totalElements: number;
  size: number;
  number: number;  // Field name in v3
}

// v4
interface Page<T> {
  content: T[];
  totalPages: number;
  totalElements: number;
  size: number;
  page: number;    // Renamed from 'number' to 'page'
}

// Correct usage in v4
const minReceived = calculateMinReceivedAmount(amount, 0.005); // 0.5% slippage
const maxSpend = calculateMaxSpendAmount(amount, 0.01);        // 1% slippage

// v3 - Gas fees in ETH (WEI)
const gasFeesInEth = quote.gasFees; // BigInt in WEI

// v4 - Gas fees in STRK (FRI)
const gasFeesInStrk = quote.gasFees; // BigInt in FRI

import {
  getMarketData,
  getTokenMarketData,
  getPriceFeed,
  getPrices,
  getVolumeByExchange,
  getTVLByExchange,
  FeedDateRange,
  PriceFeedType,
  FeedResolution,
} from '@avnu/avnu-sdk';

// Get popular tokens with market data
const marketData = await getMarketData();

// Get price feed for a token
const priceFeed = await getPriceFeed(
  tokenAddress,
  {
    type: PriceFeedType.CANDLE,
    dateRange: FeedDateRange.ONE_DAY,
    resolution: FeedResolution.HOURLY,
  }
);

import {
  getAvnuStakingInfo,
  getUserStakingInfo,
  stakeToCalls,
  executeStake,
} from '@avnu/avnu-sdk';

// Get staking info
const stakingInfo = await getAvnuStakingInfo();

// Stake tokens
const response = await executeStake({
  provider: account,
  poolAddress: '0x...',
  amount: BigInt('1000000000000000000'),
});