lfi 0.1.0

//! Types for the LI.FI API
//!
//! This module contains request and response types for the LI.FI cross-chain
//! bridge and DEX aggregator API.

use serde::{Deserialize, Serialize};

/// Chain ID type - uses numeric chain IDs
pub type ChainId = u64;

/// Common chain IDs
pub mod chains {
    use super::ChainId;

    /// Ethereum Mainnet
    pub const ETHEREUM: ChainId = 1;
    /// Optimism
    pub const OPTIMISM: ChainId = 10;
    /// BNB Smart Chain
    pub const BSC: ChainId = 56;
    /// Gnosis Chain
    pub const GNOSIS: ChainId = 100;
    /// Polygon
    pub const POLYGON: ChainId = 137;
    /// Fantom
    pub const FANTOM: ChainId = 250;
    /// zkSync Era
    pub const ZKSYNC: ChainId = 324;
    /// Polygon zkEVM
    pub const POLYGON_ZKEVM: ChainId = 1101;
    /// Base
    pub const BASE: ChainId = 8453;
    /// Arbitrum One
    pub const ARBITRUM: ChainId = 42161;
    /// Avalanche C-Chain
    pub const AVALANCHE: ChainId = 43114;
    /// Linea
    pub const LINEA: ChainId = 59144;
    /// Blast
    pub const BLAST: ChainId = 81457;
    /// Scroll
    pub const SCROLL: ChainId = 534352;
    /// Mantle
    pub const MANTLE: ChainId = 5000;
    /// Mode
    pub const MODE: ChainId = 34443;
    /// Solana (non-EVM, uses different ID scheme)
    pub const SOLANA: ChainId = 1151111081099710;
}

// ============================================================================
// Token Types
// ============================================================================

/// Token information
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Token {
    /// Token contract address
    pub address: String,
    /// Chain ID
    pub chain_id: ChainId,
    /// Token symbol
    pub symbol: String,
    /// Token decimals
    pub decimals: u8,
    /// Token name
    pub name: String,
    /// Coin key (optional, used by LI.FI for token identification)
    #[serde(default)]
    pub coin_key: Option<String>,
    /// Logo URI
    #[serde(default)]
    pub logo_uri: Option<String>,
    /// USD price
    #[serde(default)]
    pub price_usd: Option<String>,
    /// Tags (e.g., "stablecoin", "major_asset")
    #[serde(default)]
    pub tags: Vec<String>,
}

/// Token amount with token info
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct TokenAmount {
    /// Token information
    #[serde(flatten)]
    pub token: Token,
    /// Amount in base units (wei)
    pub amount: String,
    /// Amount in human-readable format
    #[serde(default)]
    pub amount_usd: Option<String>,
}

// ============================================================================
// Quote Request/Response Types
// ============================================================================

/// Request parameters for getting a quote
#[derive(Debug, Clone, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct QuoteRequest {
    /// Source chain ID
    pub from_chain: ChainId,
    /// Destination chain ID
    pub to_chain: ChainId,
    /// Source token address
    pub from_token: String,
    /// Destination token address
    pub to_token: String,
    /// Amount in base units (wei)
    pub from_amount: String,
    /// Sender address
    pub from_address: String,
    /// Recipient address (defaults to from_address if not specified)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub to_address: Option<String>,
    /// Slippage tolerance in percent (e.g., 0.5 for 0.5%)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub slippage: Option<f64>,
    /// Integrator identifier
    #[serde(skip_serializing_if = "Option::is_none")]
    pub integrator: Option<String>,
    /// Fee percentage for integrator (0-3%)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub fee: Option<f64>,
    /// Referrer address
    #[serde(skip_serializing_if = "Option::is_none")]
    pub referrer: Option<String>,
    /// Allowed bridges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub allow_bridges: Option<Vec<String>>,
    /// Denied bridges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub deny_bridges: Option<Vec<String>>,
    /// Allowed exchanges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub allow_exchanges: Option<Vec<String>>,
    /// Denied exchanges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub deny_exchanges: Option<Vec<String>>,
    /// Prefer specific route types
    #[serde(skip_serializing_if = "Option::is_none")]
    pub order: Option<RouteOrder>,
    /// Allow switching chains even if destination has no swap
    #[serde(skip_serializing_if = "Option::is_none")]
    pub allow_switch_chain: Option<bool>,
}

impl QuoteRequest {
    /// Create a new quote request
    pub fn new(
        from_chain: ChainId,
        to_chain: ChainId,
        from_token: impl Into<String>,
        to_token: impl Into<String>,
        from_amount: impl Into<String>,
        from_address: impl Into<String>,
    ) -> Self {
        Self {
            from_chain,
            to_chain,
            from_token: from_token.into(),
            to_token: to_token.into(),
            from_amount: from_amount.into(),
            from_address: from_address.into(),
            to_address: None,
            slippage: None,
            integrator: None,
            fee: None,
            referrer: None,
            allow_bridges: None,
            deny_bridges: None,
            allow_exchanges: None,
            deny_exchanges: None,
            order: None,
            allow_switch_chain: None,
        }
    }

    /// Set the destination address (recipient)
    #[must_use]
    pub fn with_to_address(mut self, to_address: impl Into<String>) -> Self {
        self.to_address = Some(to_address.into());
        self
    }

    /// Set slippage tolerance in percent
    #[must_use]
    pub fn with_slippage(mut self, slippage: f64) -> Self {
        self.slippage = Some(slippage);
        self
    }

    /// Set integrator identifier
    #[must_use]
    pub fn with_integrator(mut self, integrator: impl Into<String>) -> Self {
        self.integrator = Some(integrator.into());
        self
    }

    /// Set integrator fee percentage (0-3%)
    #[must_use]
    pub fn with_fee(mut self, fee: f64) -> Self {
        self.fee = Some(fee);
        self
    }

    /// Set referrer address
    #[must_use]
    pub fn with_referrer(mut self, referrer: impl Into<String>) -> Self {
        self.referrer = Some(referrer.into());
        self
    }

    /// Set allowed bridges
    #[must_use]
    pub fn with_allowed_bridges(mut self, bridges: Vec<String>) -> Self {
        self.allow_bridges = Some(bridges);
        self
    }

    /// Set denied bridges
    #[must_use]
    pub fn with_denied_bridges(mut self, bridges: Vec<String>) -> Self {
        self.deny_bridges = Some(bridges);
        self
    }

    /// Set allowed exchanges
    #[must_use]
    pub fn with_allowed_exchanges(mut self, exchanges: Vec<String>) -> Self {
        self.allow_exchanges = Some(exchanges);
        self
    }

    /// Set denied exchanges
    #[must_use]
    pub fn with_denied_exchanges(mut self, exchanges: Vec<String>) -> Self {
        self.deny_exchanges = Some(exchanges);
        self
    }

    /// Set route ordering preference
    #[must_use]
    pub fn with_order(mut self, order: RouteOrder) -> Self {
        self.order = Some(order);
        self
    }
}

/// Route ordering preference
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "SCREAMING_SNAKE_CASE")]
pub enum RouteOrder {
    /// Recommend the best route (default)
    #[default]
    Recommended,
    /// Fastest execution
    Fastest,
    /// Cheapest (best output)
    Cheapest,
    /// Most secure (safest bridges)
    Safest,
}

/// Quote response containing the best route
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Quote {
    /// Unique quote ID
    pub id: String,
    /// Type of the quote (e.g., "lifi")
    #[serde(rename = "type")]
    pub quote_type: String,
    /// Tool used (bridge/exchange name)
    pub tool: String,
    /// Tool details
    #[serde(default)]
    pub tool_details: Option<ToolDetails>,
    /// Action details
    pub action: Action,
    /// Estimate of the swap/bridge
    pub estimate: Estimate,
    /// Transaction request to execute
    #[serde(default)]
    pub transaction_request: Option<TransactionRequest>,
    /// Included steps
    #[serde(default)]
    pub included_steps: Vec<Step>,
    /// Integrator
    #[serde(default)]
    pub integrator: Option<String>,
}

// ============================================================================
// Routes Request/Response Types (Advanced API)
// ============================================================================

/// Request parameters for getting multiple routes (advanced API)
#[derive(Debug, Clone, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct RoutesRequest {
    /// Source chain ID
    pub from_chain_id: ChainId,
    /// Source token address
    pub from_token_address: String,
    /// Amount in base units (wei)
    pub from_amount: String,
    /// Sender address
    pub from_address: String,
    /// Destination chain ID
    pub to_chain_id: ChainId,
    /// Destination token address
    pub to_token_address: String,
    /// Recipient address
    #[serde(skip_serializing_if = "Option::is_none")]
    pub to_address: Option<String>,
    /// Route options
    #[serde(skip_serializing_if = "Option::is_none")]
    pub options: Option<RoutesOptions>,
}

impl RoutesRequest {
    /// Create a new routes request
    pub fn new(
        from_chain_id: ChainId,
        from_token_address: impl Into<String>,
        from_amount: impl Into<String>,
        from_address: impl Into<String>,
        to_chain_id: ChainId,
        to_token_address: impl Into<String>,
    ) -> Self {
        Self {
            from_chain_id,
            from_token_address: from_token_address.into(),
            from_amount: from_amount.into(),
            from_address: from_address.into(),
            to_chain_id,
            to_token_address: to_token_address.into(),
            to_address: None,
            options: None,
        }
    }

    /// Set the destination address
    #[must_use]
    pub fn with_to_address(mut self, to_address: impl Into<String>) -> Self {
        self.to_address = Some(to_address.into());
        self
    }

    /// Set route options
    #[must_use]
    pub fn with_options(mut self, options: RoutesOptions) -> Self {
        self.options = Some(options);
        self
    }
}

/// Options for route requests
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct RoutesOptions {
    /// Slippage tolerance in percent
    #[serde(skip_serializing_if = "Option::is_none")]
    pub slippage: Option<f64>,
    /// Integrator identifier
    #[serde(skip_serializing_if = "Option::is_none")]
    pub integrator: Option<String>,
    /// Fee percentage for integrator
    #[serde(skip_serializing_if = "Option::is_none")]
    pub fee: Option<f64>,
    /// Referrer address
    #[serde(skip_serializing_if = "Option::is_none")]
    pub referrer: Option<String>,
    /// Allowed bridges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub bridges: Option<BridgeOptions>,
    /// Allowed exchanges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub exchanges: Option<ExchangeOptions>,
    /// Route ordering preference
    #[serde(skip_serializing_if = "Option::is_none")]
    pub order: Option<RouteOrder>,
    /// Maximum price impact allowed (in percent)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max_price_impact: Option<f64>,
    /// Allow unsafe transactions (optional)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub allow_destination_call: Option<bool>,
}

impl RoutesOptions {
    /// Create new route options
    pub fn new() -> Self {
        Self::default()
    }

    /// Set slippage tolerance
    #[must_use]
    pub fn with_slippage(mut self, slippage: f64) -> Self {
        self.slippage = Some(slippage);
        self
    }

    /// Set integrator
    #[must_use]
    pub fn with_integrator(mut self, integrator: impl Into<String>) -> Self {
        self.integrator = Some(integrator.into());
        self
    }

    /// Set bridge options
    #[must_use]
    pub fn with_bridges(mut self, bridges: BridgeOptions) -> Self {
        self.bridges = Some(bridges);
        self
    }

    /// Set exchange options
    #[must_use]
    pub fn with_exchanges(mut self, exchanges: ExchangeOptions) -> Self {
        self.exchanges = Some(exchanges);
        self
    }

    /// Set route order
    #[must_use]
    pub fn with_order(mut self, order: RouteOrder) -> Self {
        self.order = Some(order);
        self
    }
}

/// Bridge options
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct BridgeOptions {
    /// Allowed bridges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub allow: Option<Vec<String>>,
    /// Denied bridges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub deny: Option<Vec<String>>,
}

/// Exchange options
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ExchangeOptions {
    /// Allowed exchanges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub allow: Option<Vec<String>>,
    /// Denied exchanges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub deny: Option<Vec<String>>,
}

/// Routes response
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct RoutesResponse {
    /// Available routes
    pub routes: Vec<Route>,
    /// Unavailable routes (with reasons)
    #[serde(default)]
    pub unavailable_routes: Option<UnavailableRoutes>,
}

/// Unavailable routes with reasons
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct UnavailableRoutes {
    /// Routes filtered by tool
    #[serde(default)]
    pub filtered_out: Vec<FilteredRoute>,
    /// Routes that failed
    #[serde(default)]
    pub failed: Vec<FailedRoute>,
}

/// A route that was filtered out
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct FilteredRoute {
    /// Tool name
    pub tool: String,
    /// Reason for filtering
    pub reason: String,
}

/// A route that failed
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct FailedRoute {
    /// Tool name
    pub tool: String,
    /// Error message
    pub error_message: String,
    /// Error code
    #[serde(default)]
    pub error_code: Option<String>,
}

// ============================================================================
// Route Types
// ============================================================================

/// A complete route for a cross-chain swap
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Route {
    /// Unique route ID
    pub id: String,
    /// Source chain ID
    pub from_chain_id: ChainId,
    /// Source token
    pub from_token: Token,
    /// Source amount
    pub from_amount: String,
    /// Source amount in USD
    #[serde(default)]
    pub from_amount_usd: Option<String>,
    /// Sender address
    pub from_address: String,
    /// Destination chain ID
    pub to_chain_id: ChainId,
    /// Destination token
    pub to_token: Token,
    /// Destination amount (estimated)
    pub to_amount: String,
    /// Destination amount in USD (estimated)
    #[serde(default)]
    pub to_amount_usd: Option<String>,
    /// Minimum destination amount (after slippage)
    pub to_amount_min: String,
    /// Recipient address
    #[serde(default)]
    pub to_address: Option<String>,
    /// Route steps
    pub steps: Vec<Step>,
    /// Gas cost in USD
    #[serde(default)]
    pub gas_cost_usd: Option<String>,
    /// Total execution time in seconds
    #[serde(default)]
    pub execution_duration: Option<u64>,
    /// Tags for this route
    #[serde(default)]
    pub tags: Vec<String>,
    /// Insurance available
    #[serde(default)]
    pub insurance: Option<Insurance>,
}

/// Insurance information for a route
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Insurance {
    /// Insurance state
    pub state: String,
    /// Fee in USD
    #[serde(default)]
    pub fee_amount_usd: Option<String>,
}

// ============================================================================
// Step Types
// ============================================================================

/// A single step in a route
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Step {
    /// Step ID
    pub id: String,
    /// Step type (swap, cross, lifi)
    #[serde(rename = "type")]
    pub step_type: StepType,
    /// Tool used for this step
    pub tool: String,
    /// Tool details
    #[serde(default)]
    pub tool_details: Option<ToolDetails>,
    /// Action details
    pub action: Action,
    /// Estimate for this step
    pub estimate: Estimate,
    /// Transaction request (if available)
    #[serde(default)]
    pub transaction_request: Option<TransactionRequest>,
    /// Included steps (for composite steps)
    #[serde(default)]
    pub included_steps: Vec<Step>,
}

/// Type of step
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum StepType {
    /// Same-chain swap
    Swap,
    /// Cross-chain transfer
    Cross,
    /// LI.FI composite step
    Lifi,
    /// Protocol-specific step
    Protocol,
    /// Custom step
    Custom,
}

/// Tool details
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ToolDetails {
    /// Tool key
    pub key: String,
    /// Tool name
    pub name: String,
    /// Tool logo URI
    #[serde(default)]
    pub logo_uri: Option<String>,
}

// ============================================================================
// Action Types
// ============================================================================

/// Action details for a step
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Action {
    /// Source chain ID
    pub from_chain_id: ChainId,
    /// Source token
    pub from_token: Token,
    /// Source amount
    pub from_amount: String,
    /// Destination chain ID
    pub to_chain_id: ChainId,
    /// Destination token
    pub to_token: Token,
    /// Slippage tolerance (may not be present for some steps)
    #[serde(default)]
    pub slippage: Option<f64>,
    /// Sender address
    #[serde(default)]
    pub from_address: Option<String>,
    /// Recipient address
    #[serde(default)]
    pub to_address: Option<String>,
    /// Destination call data (for contract interactions on destination)
    #[serde(default)]
    pub destination_call_data: Option<String>,
}

// ============================================================================
// Estimate Types
// ============================================================================

/// Estimate for a step
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Estimate {
    /// Tool used for this estimate
    #[serde(default)]
    pub tool: Option<String>,
    /// Source amount
    pub from_amount: String,
    /// Source amount in USD
    #[serde(default)]
    pub from_amount_usd: Option<String>,
    /// Destination amount
    pub to_amount: String,
    /// Destination amount in USD
    #[serde(default)]
    pub to_amount_usd: Option<String>,
    /// Minimum destination amount (after slippage)
    pub to_amount_min: String,
    /// Approval address (for token approvals)
    #[serde(default)]
    pub approval_address: Option<String>,
    /// Execution duration in seconds
    #[serde(default)]
    pub execution_duration: Option<u64>,
    /// Fee costs
    #[serde(default)]
    pub fee_costs: Option<Vec<FeeCost>>,
    /// Gas costs
    #[serde(default)]
    pub gas_costs: Option<Vec<GasCost>>,
    /// Data
    #[serde(default)]
    pub data: Option<EstimateData>,
}

/// Fee cost
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct FeeCost {
    /// Fee name
    pub name: String,
    /// Fee description
    #[serde(default)]
    pub description: Option<String>,
    /// Fee token
    pub token: Token,
    /// Fee amount
    pub amount: String,
    /// Fee amount in USD
    #[serde(default)]
    pub amount_usd: Option<String>,
    /// Percentage fee
    #[serde(default)]
    pub percentage: Option<String>,
    /// Whether included in source amount
    #[serde(default)]
    pub included: bool,
    /// Fee split between integrator and LI.FI
    #[serde(default)]
    pub fee_split: Option<FeeSplit>,
}

/// Fee split between integrator and LI.FI
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct FeeSplit {
    /// Integrator fee amount
    pub integrator_fee: String,
    /// LI.FI fee amount
    pub lifi_fee: String,
}

/// Gas cost
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct GasCost {
    /// Type of gas cost
    #[serde(rename = "type")]
    pub gas_type: String,
    /// Estimate gas
    #[serde(default)]
    pub estimate: Option<String>,
    /// Gas limit
    #[serde(default)]
    pub limit: Option<String>,
    /// Gas amount
    pub amount: String,
    /// Amount in USD
    #[serde(default)]
    pub amount_usd: Option<String>,
    /// Gas price
    #[serde(default)]
    pub price: Option<String>,
    /// Token used for gas
    pub token: Token,
}

/// Additional estimate data
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct EstimateData {
    /// Exchange rate
    #[serde(default)]
    pub exchange_rate: Option<String>,
    /// Price impact percentage
    #[serde(default)]
    pub price_impact: Option<String>,
}

// ============================================================================
// Transaction Request Types
// ============================================================================

/// Transaction request to execute on-chain
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct TransactionRequest {
    /// Contract address to call
    pub to: String,
    /// Call data
    pub data: String,
    /// ETH value to send (in wei)
    pub value: String,
    /// Sender address
    #[serde(default)]
    pub from: Option<String>,
    /// Chain ID
    #[serde(default)]
    pub chain_id: Option<ChainId>,
    /// Gas limit
    #[serde(default)]
    pub gas_limit: Option<String>,
    /// Gas price
    #[serde(default)]
    pub gas_price: Option<String>,
    /// Max fee per gas (EIP-1559)
    #[serde(default)]
    pub max_fee_per_gas: Option<String>,
    /// Max priority fee per gas (EIP-1559)
    #[serde(default)]
    pub max_priority_fee_per_gas: Option<String>,
}

// ============================================================================
// Status Types
// ============================================================================

/// Status request parameters
#[derive(Debug, Clone, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct StatusRequest {
    /// Transaction hash to check
    pub tx_hash: String,
    /// Bridge used
    #[serde(skip_serializing_if = "Option::is_none")]
    pub bridge: Option<String>,
    /// Source chain ID
    #[serde(skip_serializing_if = "Option::is_none")]
    pub from_chain: Option<ChainId>,
    /// Destination chain ID
    #[serde(skip_serializing_if = "Option::is_none")]
    pub to_chain: Option<ChainId>,
}

impl StatusRequest {
    /// Create a new status request
    pub fn new(tx_hash: impl Into<String>) -> Self {
        Self {
            tx_hash: tx_hash.into(),
            bridge: None,
            from_chain: None,
            to_chain: None,
        }
    }

    /// Set the bridge used
    #[must_use]
    pub fn with_bridge(mut self, bridge: impl Into<String>) -> Self {
        self.bridge = Some(bridge.into());
        self
    }

    /// Set the source chain
    #[must_use]
    pub fn with_from_chain(mut self, chain: ChainId) -> Self {
        self.from_chain = Some(chain);
        self
    }

    /// Set the destination chain
    #[must_use]
    pub fn with_to_chain(mut self, chain: ChainId) -> Self {
        self.to_chain = Some(chain);
        self
    }
}

/// Status response for tracking cross-chain transactions
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatusResponse {
    /// Transaction ID
    #[serde(default)]
    pub transaction_id: Option<String>,
    /// Sending transaction details
    #[serde(default)]
    pub sending: Option<TransactionInfo>,
    /// Receiving transaction details
    #[serde(default)]
    pub receiving: Option<TransactionInfo>,
    /// LI.FI explorer link
    #[serde(default)]
    pub lifi_explorer_link: Option<String>,
    /// Source chain ID
    #[serde(default)]
    pub from_chain_id: Option<ChainId>,
    /// Destination chain ID
    #[serde(default)]
    pub to_chain_id: Option<ChainId>,
    /// Bridge used
    #[serde(default)]
    pub bridge: Option<String>,
    /// Overall status
    pub status: TransactionStatus,
    /// Substatus
    #[serde(default)]
    pub substatus: Option<String>,
    /// Substatus message
    #[serde(default)]
    pub substatus_message: Option<String>,
    /// Metadata
    #[serde(default)]
    pub metadata: Option<StatusMetadata>,
}

/// Transaction information
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct TransactionInfo {
    /// Transaction hash
    pub tx_hash: String,
    /// Transaction link
    #[serde(default)]
    pub tx_link: Option<String>,
    /// Amount
    #[serde(default)]
    pub amount: Option<String>,
    /// Token
    #[serde(default)]
    pub token: Option<Token>,
    /// Chain ID
    #[serde(default)]
    pub chain_id: Option<ChainId>,
    /// Gas price
    #[serde(default)]
    pub gas_price: Option<String>,
    /// Gas used
    #[serde(default)]
    pub gas_used: Option<String>,
    /// Gas amount in USD
    #[serde(default)]
    pub gas_amount_usd: Option<String>,
    /// Timestamp
    #[serde(default)]
    pub timestamp: Option<u64>,
}

/// Transaction status
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "SCREAMING_SNAKE_CASE")]
pub enum TransactionStatus {
    /// Transaction not started
    NotStarted,
    /// Pending
    Pending,
    /// Transaction is being processed
    Done,
    /// Failed
    Failed,
    /// Invalid
    Invalid,
    /// Not found
    NotFound,
}

/// Status metadata
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatusMetadata {
    /// Integrator
    #[serde(default)]
    pub integrator: Option<String>,
}

// ============================================================================
// Chain Types
// ============================================================================

/// Chain information from LI.FI
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Chain {
    /// Chain ID
    pub id: ChainId,
    /// Chain key
    pub key: String,
    /// Chain name
    pub name: String,
    /// Coin symbol (native token)
    pub coin: String,
    /// Chain type (EVM, SVM, etc.)
    #[serde(default)]
    pub chain_type: Option<String>,
    /// Logo URI
    #[serde(default)]
    pub logo_uri: Option<String>,
    /// Native token
    #[serde(default)]
    pub native_token: Option<Token>,
    /// Tokens on this chain (when fetching with tokens)
    #[serde(default)]
    pub tokens: Vec<Token>,
    /// Whether mainnet
    #[serde(default)]
    pub mainnet: bool,
    /// Multicall address
    #[serde(default)]
    pub multicall_address: Option<String>,
    /// Metamask settings
    #[serde(default)]
    pub metamask: Option<MetamaskChainInfo>,
}

/// Metamask chain information
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct MetamaskChainInfo {
    /// Chain ID in hex
    pub chain_id: String,
    /// Chain name
    pub chain_name: String,
    /// Native currency
    #[serde(default)]
    pub native_currency: Option<NativeCurrency>,
    /// RPC URLs
    #[serde(default)]
    pub rpc_urls: Vec<String>,
    /// Block explorer URLs
    #[serde(default)]
    pub block_explorer_urls: Vec<String>,
}

/// Native currency info
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct NativeCurrency {
    /// Currency name
    pub name: String,
    /// Currency symbol
    pub symbol: String,
    /// Decimals
    pub decimals: u8,
}

/// Chains response
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ChainsResponse {
    /// List of chains
    pub chains: Vec<Chain>,
}

// ============================================================================
// Connections Types
// ============================================================================

/// Request for available connections
#[derive(Debug, Clone, Default, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct ConnectionsRequest {
    /// Source chain ID
    #[serde(skip_serializing_if = "Option::is_none")]
    pub from_chain: Option<ChainId>,
    /// Destination chain ID
    #[serde(skip_serializing_if = "Option::is_none")]
    pub to_chain: Option<ChainId>,
    /// Source token address
    #[serde(skip_serializing_if = "Option::is_none")]
    pub from_token: Option<String>,
    /// Destination token address
    #[serde(skip_serializing_if = "Option::is_none")]
    pub to_token: Option<String>,
    /// Allow specific bridges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub allow_bridges: Option<Vec<String>>,
    /// Deny specific bridges
    #[serde(skip_serializing_if = "Option::is_none")]
    pub deny_bridges: Option<Vec<String>>,
}

impl ConnectionsRequest {
    /// Create a new connections request
    pub fn new() -> Self {
        Self::default()
    }

    /// Set source chain
    #[must_use]
    pub fn with_from_chain(mut self, chain: ChainId) -> Self {
        self.from_chain = Some(chain);
        self
    }

    /// Set destination chain
    #[must_use]
    pub fn with_to_chain(mut self, chain: ChainId) -> Self {
        self.to_chain = Some(chain);
        self
    }

    /// Set source token
    #[must_use]
    pub fn with_from_token(mut self, token: impl Into<String>) -> Self {
        self.from_token = Some(token.into());
        self
    }

    /// Set destination token
    #[must_use]
    pub fn with_to_token(mut self, token: impl Into<String>) -> Self {
        self.to_token = Some(token.into());
        self
    }
}

/// Connections response
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ConnectionsResponse {
    /// Available connections
    pub connections: Vec<Connection>,
}

/// A connection between chains
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Connection {
    /// Source chain ID
    pub from_chain_id: ChainId,
    /// Destination chain ID
    pub to_chain_id: ChainId,
    /// Source tokens
    pub from_tokens: Vec<Token>,
    /// Destination tokens
    pub to_tokens: Vec<Token>,
}

// ============================================================================
// Tokens Types
// ============================================================================

/// Request for available tokens
#[derive(Debug, Clone, Default, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct TokensRequest {
    /// Filter by chains
    #[serde(skip_serializing_if = "Option::is_none")]
    pub chains: Option<Vec<ChainId>>,
}

impl TokensRequest {
    /// Create a new tokens request
    pub fn new() -> Self {
        Self::default()
    }

    /// Filter by specific chains
    #[must_use]
    pub fn with_chains(mut self, chains: Vec<ChainId>) -> Self {
        self.chains = Some(chains);
        self
    }
}

/// Tokens response
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct TokensResponse {
    /// Tokens organized by chain ID
    pub tokens: std::collections::HashMap<String, Vec<Token>>,
}

// ============================================================================
// Tools Types (Bridges and Exchanges)
// ============================================================================

/// Tool information (bridge or exchange)
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Tool {
    /// Tool key
    pub key: String,
    /// Tool name
    pub name: String,
    /// Tool type
    #[serde(rename = "type")]
    pub tool_type: ToolType,
    /// Logo URI
    #[serde(default)]
    pub logo_uri: Option<String>,
    /// Supported chains
    #[serde(default)]
    pub supported_chains: Vec<ChainId>,
}

/// Tool type
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum ToolType {
    /// Bridge
    Bridge,
    /// Exchange/DEX
    Exchange,
}

/// Tools response
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ToolsResponse {
    /// Bridges
    #[serde(default)]
    pub bridges: Vec<Tool>,
    /// Exchanges
    #[serde(default)]
    pub exchanges: Vec<Tool>,
}

// ============================================================================
// Gas Prices Types
// ============================================================================

/// Gas price information
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct GasPrice {
    /// Chain ID
    pub chain_id: ChainId,
    /// Slow gas price (wei)
    #[serde(default)]
    pub slow: Option<String>,
    /// Average gas price (wei)
    #[serde(default)]
    pub average: Option<String>,
    /// Fast gas price (wei)
    #[serde(default)]
    pub fast: Option<String>,
    /// Instant gas price (wei)
    #[serde(default)]
    pub instant: Option<String>,
}

// ============================================================================
// Error Types
// ============================================================================

/// API error response
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ApiError {
    /// Error message
    pub message: String,
    /// Error code
    #[serde(default)]
    pub code: Option<String>,
}