Bridge Cost Optimizer
Compare live cross-chain bridge quotes from multiple providers to find the cheapest, fastest, or balanced token transfer route between EVM and select non-EVM...
Bridge Cost Optimizer
Find the cheapest and fastest cross-chain bridge for any token+amount+source+destination.
What this skill can do (working code, no promises)
- Compare live quotes from Across, Stargate, Hop, Connext, Wormhole, and deBridge public read endpoints.
- Score each route on: total USD cost, estimated delivery time, number of hops, and a composite "best" score.
- Recommend the optimal route given a user preference (
cheapest,fastest, orbalanced). - Filter by token (USDC, USDT, ETH, WETH, DAI) and source/destination chain.
What this skill cannot do (honest limits)
- It does not execute the bridge. It produces a recommendation and the calldata URL — you must sign and send via your own wallet.
- Quote APIs are pulled at request time; rates move. Always re-pull within 30 seconds of signing.
- Public endpoints can rate-limit. The skill has a built-in retry+timeout but no paid-tier fallback.
- Non-EVM chains are partially supported (Stargate handles Solana + some non-EVM; Wormhole covers more). The CLI defaults to EVM-only unless
--allow-non-evmis passed.
Install
pip install requests
Usage
# Cheapest way to bridge 1000 USDC from Ethereum to Base
python scripts/bridge_optimizer.py compare --from ethereum --to base --token USDC --amount 1000
# Fastest route, prefer low time over cost
python scripts/bridge_optimizer.py compare --from arbitrum --to optimism --token ETH --amount 0.5 --prefer fastest
# All quotes, table view
python scripts/bridge_optimizer.py table --from polygon --to base --token USDC --amount 500
Environment
BRIDGE_PREFERENCE— defaultbalanced(alternates between cheapest and fastest per call).BRIDGE_TIMEOUT_SEC— request timeout (default 10).
Limitations to be aware of
- Bridge fee APIs do not always return USD-denominated fees; the script converts via CoinGecko's free public price endpoint.
- Some bridges (Wormhole portal) are not strictly "cheapest" — they exist for token coverage. Use them when the token isn't available on Stargate or Across.
- Downloads
- 552All time
- Security audit
- Review
- Last updated
- 4mo ago
- Current version
- v1.0.0
- License
- MIT-0
