Concepts and Objects

interface Quote {
  id: string;                    // Unique quote identifier
  type: "lifi";                  // Quote type
  tool: string;                  // Bridge or DEX used (e.g., "stargate")
  action: Action;                // What happens in this transfer
  estimate: Estimate;            // Output amounts and fees
  transactionRequest: {          // Ready-to-sign transaction
    to: string;
    data: string;
    value: string;
    gasLimit: string;
    // ... other tx fields
  };
}

interface Route {
  id: string;                    // Unique route identifier
  fromChainId: number;           // Source chain
  toChainId: number;             // Destination chain
  fromToken: Token;              // Source token
  toToken: Token;                // Destination token
  fromAmount: string;            // Input amount (wei)
  toAmount: string;              // Expected output (wei)
  steps: Step[];                 // Array of steps to execute
}

interface Step {
  id: string;                    // Unique step identifier
  type: "swap" | "cross" | "lifi" | "protocol";
  tool: string;                  // Bridge or DEX name
  toolDetails: ToolDetails;      // Logo, name, key
  action: Action;                // What this step does
  estimate: Estimate;            // Output estimates
  includedSteps?: Step[];        // Nested steps (for complex routes)
  transactionRequest?: {         // Transaction data (populated after stepTransaction call)
    to: string;
    data: string;
    value: string;
  };
}

interface Action {
  fromChainId: number;           // Source chain ID
  toChainId: number;             // Destination chain ID
  fromToken: Token;              // Token being sent
  toToken: Token;                // Token being received
  fromAmount: string;            // Input amount (wei)
  slippage: number;              // Allowed slippage (e.g., 0.005 = 0.5%)
  fromAddress?: string;          // Sender address
  toAddress?: string;            // Recipient address (if different)
}

interface Tool {
  key: string;                   // Unique identifier (e.g., "stargate")
  name: string;                  // Display name (e.g., "Stargate")
  logoURI: string;               // Tool logo URL
  supportedChains: Chain[];      // Chains this tool supports
}

interface Chain {
  id: number;                    // Chain ID (e.g., 1 for Ethereum)
  key: string;                   // Short key (e.g., "eth")
  name: string;                  // Display name (e.g., "Ethereum")
  chainType: "EVM" | "SVM" | "UTXO" | "MVM";
  coin: string;                  // Native token symbol
  logoURI: string;               // Chain logo URL
  metamask?: {                   // MetaMask connection info
    chainId: string;
    chainName: string;
    nativeCurrency: {...};
    rpcUrls: string[];
  };
}

interface Token {
  address: string;               // Contract address (or native token identifier)
  chainId: number;               // Chain this token is on
  symbol: string;                // Token symbol (e.g., "USDC")
  name: string;                  // Full name (e.g., "USD Coin")
  decimals: number;              // Decimal places (e.g., 6 for USDC)
  logoURI?: string;              // Token logo URL
  priceUSD?: string;             // Current USD price
  coinKey?: string;              // Canonical token identifier across chains
}