lifi-orchestrator

通过 LI.FI 进行跨链桥接和交换，LI.FI 是领先的桥接聚合器，可跨 30 多个桥接和 DEX 进行路由，以实现最佳速率。当您需要：(1) 获取在链之间移动代币的报价，(2) 以最佳定价执行跨链交换，(3) 跟踪桥接交易状态，(4) 比较 Stargate、Across、Hop、Celer 等协议之间的路由。支持以太坊、Polygon、Arbitrum、Optimism、Base、BSC、Avalanche、Solana 和 15 种以上其他链。处理具有自动滑点保护的原生代币和 ERC-20。

## 概述（中文）

通过 LI.FI 进行跨链桥接和交换，LI.FI 是领先的桥接聚合器，可跨 30 多个桥接和 DEX 进行路由，以实现最佳速率。当您需要：(1) 获取在链之间移动代币的报价，(2) 以最佳定价执行跨链交换，(3) 跟踪桥接交易状态，(4) 比较 Stargate、Across、Hop、Celer 等协议之间的路由。支持以太坊、Polygon、Arbitrum、Optimism、Base、BSC、Avalanche、Solana 和 15 种以上其他链。处理具有自动滑点保护的原生代币和 ERC-20。

## 原文

# LI.FI Orchestrator

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

## Quick Start

```bash
# 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
```bash
curl "https://li.quest/v1/quote?fromChain=1&toChain=137&fromToken=ETH&toToken=USDC&fromAmount=1000000000000000000&fromAddress=<wallet>"
```

### Get Chains
```bash
curl "https://li.quest/v1/chains"
```

### Get Tokens
```bash
curl "https://li.quest/v1/tokens?chains=1,137"
```

### Check Status
```bash
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