lifi-orchestrator

LI.FI Orchestrator

Bridge tokens across chains using LI.FI's aggregated bridge/DEX routing.

Quick Start

# Get a quote (ETH on Ethereum → MATIC on Polygon)
python3 scripts/quote.py --from-chain 1 --to-chain 137 \
  --from-token ETH --to-token MATIC --amount 0.1

# Execute a bridge (requires private key)
python3 scripts/bridge.py --from-chain 1 --to-chain 137 \
  --from-token ETH --to-token USDC --amount 0.1

# Check transaction status
python3 scripts/status.py <txHash>

API Base

• Endpoint: https://li.quest/v1
• Auth: Optional API key via x-lifi-api-key header (higher rate limits)
• Rate limit: 10 req/min without key, higher with key

Common Chain IDs

Chain	ID	Native Token
Ethereum	1	ETH
Polygon	137	MATIC
Arbitrum	42161	ETH
Optimism	10	ETH
Base	8453	ETH
BSC	56	BNB
Avalanche	43114	AVAX
Solana	1151111081099710	SOL

Key Endpoints

Get Quote

curl "https://li.quest/v1/quote?fromChain=1&toChain=137&fromToken=ETH&toToken=USDC&fromAmount=1000000000000000000&fromAddress=<wallet>"

Get Chains

curl "https://li.quest/v1/chains"

Get Tokens

curl "https://li.quest/v1/tokens?chains=1,137"

Check Status

curl "https://li.quest/v1/status?txHash=<hash>"

Token Addresses

Use 0x0000000000000000000000000000000000000000 for native tokens (ETH, MATIC, etc.) or the actual contract address for ERC-20 tokens.

Common stablecoins:

• USDC (Ethereum): 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
• USDC (Polygon): 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359
• USDT (Ethereum): 0xdAC17F958D2ee523a2206206994597C13D831ec7

Workflow

1. Get quote → Returns best route with gas estimates
2. Check approval → For ERC-20 tokens, approve spending if needed
3. Execute transaction → Sign and send the transactionRequest from quote
4. Track status → Poll /status until complete

Scripts

• scripts/quote.py — Get bridge quotes with human-readable output
• scripts/bridge.py — Execute bridge transactions (requires wallet)
• scripts/status.py — Track transaction status

Notes

• LI.FI aggregates 30+ bridges and DEXs for best rates
• Slippage default: 0.5% (configurable)
• Some routes have minimum amounts
• Cross-chain transactions typically take 1-20 minutes