Providers

​

Overview

​

Available Providers

​

THORChain

• Native asset swaps (no wrapping required)
• Continuous Liquidity Pools (CLP)
• Streaming swaps for large amounts
• Built-in slip protection
• No impermanent loss for LPs

• Bitcoin, Ethereum, Binance Smart Chain
• Avalanche, Cosmos, THORChain
• Litecoin, Bitcoin Cash, Dogecoin

• Cross-chain native asset swaps
• Large swap amounts ($10k+)
• When security is paramount
• Bitcoin to/from any chain

​

Chainflip

• Just-In-Time (JIT) AMM
• State chain architecture
• Fast finality (~1-2 minutes)
• Competitive pricing
• Native cross-chain swaps

• Bitcoin, Ethereum, Arbitrum
• Polkadot (unique support)
• More chains coming soon

• Need fastest cross-chain execution
• Polkadot ecosystem swaps
• Medium-sized swaps ($1k-$100k)
• Arbitrum cross-chain swaps

​

MayaChain

• Fork of THORChain with modifications
• Native CACAO token
• Specialized pools
• Unique Dash and Kujira support
• Capital efficiency improvements

• Bitcoin, Ethereum, THORChain
• Dash (unique support)
• Kujira (Cosmos ecosystem)
• Maya Protocol native

• Dash cryptocurrency swaps
• CACAO token trading
• Kujira ecosystem access
• Alternative to THORChain routes

​

Jupiter

• Aggregates 30+ Solana DEXs
• Smart order routing
• Auto-slippage calculation
• Transaction priority fees
• Support for 2500+ SPL tokens

• Orca, Raydium, Serum
• Phoenix, Lifinity
• And many more

• Any Solana token swap
• Need best SPL token rates
• Complex token routes on Solana
• Small to large amounts

​

1inch

• Aggregates 300+ liquidity sources
• CHI gas token integration
• Partial fill support
• Complex routing algorithms
• MEV protection

• Ethereum, Arbitrum, Base
• Binance Smart Chain
• Avalanche C-Chain
• 10+ other EVM chains

• EVM token-to-token swaps
• Need gas optimization
• Complex routing requirements
• Arbitrage opportunities

​

DEX Aggregation Chains

​

JUPITER → CHAINFLIP

• Use Case: Solana to Bitcoin/Ethereum
• Path: SPL tokens → SOL → FLIP → BTC/ETH
• Benefits: Access Solana liquidity for cross-chain

​

ONEINCH → CHAINFLIP

• Use Case: EVM tokens to Bitcoin
• Path: ERC-20 → ETH → FLIP → BTC
• Benefits: Optimal EVM routing to cross-chain

​

CHAINFLIP → ONEINCH

• Use Case: Bitcoin to EVM tokens
• Path: BTC → FLIP → ETH → ERC-20
• Benefits: Direct Bitcoin to any EVM token

​

Provider Selection Strategy

​

Automatic Selection

// Let the API choose the best provider
const quote = await fetch('/quote', {
  body: JSON.stringify({
    sellAsset: 'BTC.BTC',
    buyAsset: 'ETH.ETH',
    sellAmount: '1.0'
    // providers field omitted - uses all
  })
});

​

Manual Provider Selection

// Use only THORChain for maximum security
const quote = await fetch('/quote', {
  body: JSON.stringify({
    sellAsset: 'BTC.BTC',
    buyAsset: 'ETH.ETH',
    sellAmount: '1.0',
    providers: ['THORCHAIN']
  })
});

// Use multiple specific providers
const quote = await fetch('/quote', {
  body: JSON.stringify({
    sellAsset: 'BTC.BTC',
    buyAsset: 'ETH.ETH',
    sellAmount: '1.0',
    providers: ['THORCHAIN', 'CHAINFLIP']
  })
});

​

Provider Comparison

​

Streaming Swaps

// Large swaps automatically use streaming
const largeSwap = {
  sellAsset: 'BTC.BTC',
  buyAsset: 'ETH.ETH',
  sellAmount: '10.0', // 10 BTC in decimal format
  providers: ['THORCHAIN']
};

// Track streaming progress
const tracking = await fetch('/track', {
  body: JSON.stringify({
    hash: txHash,
    chainId: 'BTC',
    quoteId: quoteId,
    routeIndex: 0
  })
});

if (tracking.data.isStreaming) {
  console.log(`Progress: ${tracking.data.streamingProgress.percentage}%`);
}

​

Provider-Specific Features

​

THORChain Memos

=:ETH.ETH:0x...address:100:thor1...affiliate:100

• = : Swap identifier
• ETH.ETH : Target asset
• 0x... : Destination address
• 100 : Slip limit (basis points)
• thor1... : Affiliate address
• 100 : Affiliate fee (basis points)

​

Chainflip Deposit Channels

{
  "inboundAddress": "0x123...", // Unique deposit address
  "depositChannel": {
    "id": "cf-123",
    "expiryBlock": 1234567
  }
}

​

Jupiter Route Info

{
  "route": {
    "marketInfos": [
      {
        "id": "orca",
        "label": "Orca",
        "inputMint": "So11...",
        "outputMint": "EPjF..."
      }
    ]
  }
}

​

Error Handling by Provider

​

THORChain Errors

• INSUFFICIENT_LIQUIDITY - Pool too shallow
• TRADING_HALTED - Chain halted
• SLIP_TOLERANCE_EXCEEDED - Price impact too high

​

Chainflip Errors

• PAIR_NOT_SUPPORTED - Asset pair not available
• AMOUNT_TOO_SMALL - Below minimum
• CHANNEL_EXPIRED - Deposit channel expired

​

Jupiter Errors

• ROUTE_NOT_FOUND - No route available
• SLIPPAGE_TOO_HIGH - Price impact exceeds limit
• TOKEN_NOT_VERIFIED - Unverified token

​

Best Practices

​

1. Provider Fallbacks

const getQuoteWithFallback = async (params) => {
  // Try preferred provider first
  try {
    const preferredQuote = await getQuote({
      ...params,
      providers: ['CHAINFLIP'] // Fastest
    });
    if (preferredQuote.routes.length > 0) {
      return preferredQuote;
    }
  } catch (error) {
    console.log('Preferred provider failed, trying others');
  }
  
  // Fallback to all providers
  return await getQuote(params);
};

​

2. Provider-Specific Optimization

// Optimize for THORChain
const thorchainOptimized = {
  sellAmount: amount,
  slippage: 5, // THORChain handles slip well
  providers: ['THORCHAIN']
};

// Optimize for Jupiter
const jupiterOptimized = {
  sellAmount: amount,
  slippage: 1, // Tighter slippage for on-chain
  providers: ['JUPITER']
};

​

3. Multi-Provider Strategies

// Get quotes from all providers and compare
const getAllQuotes = async (params) => {
  const providers = ['THORCHAIN', 'CHAINFLIP', 'MAYACHAIN'];
  
  const quotes = await Promise.allSettled(
    providers.map(provider => 
      getQuote({ ...params, providers: [provider] })
    )
  );
  
  // Analyze results
  return quotes
    .filter(q => q.status === 'fulfilled')
    .map(q => q.value)
    .filter(q => q.routes.length > 0);
};