| name | claw-wallet-bridge |
| description | Cross-chain bridge skill for AI agents using LI.FI, enabling seamless asset transfers between 20+ chains including EVM, Solana, and Sui. |
Use this skill when...
Use this skill when the user wants to transfer tokens from one blockchain to another (e.g., from Ethereum to Solana, or BSC to Sui).
Use this skill when the user wants to estimate the cost, time, and received amount for a cross-chain swap.
Use this skill when the user needs to find the exact contract address of a token on a specific chain before bridging.
bridge skill
This skill provides a managed cross-chain bridge experience powered by LI.FI, integrated directly with the local wallet sandbox for secure signing.
Core Flow
To ensure a successful bridge, the agent MUST follow these steps:
- Verify Token Support: Call
/api/v1/tx/bridge/lifi/tokens to get the correct contract address for the source and target chains.
- Get Quote: Call
/api/v1/tx/bridge/lifi/quote to show the user the estimated received amount, fees, and duration.
- User Confirmation: Present the quote to the user and ask for explicit confirmation (e.g., "Confirm to bridge 100 USDC from Ethereum to Solana?").
- Execute: Call
/api/v1/tx/bridge/lifi/execute to sign and broadcast the transaction.
- Monitor: If the status is
PENDING, provide the final_status_url to the user or poll it until it reaches DONE.
API Specification
All endpoints are under /api/v1/tx/bridge/lifi/.
1. Token Verification
Query supported tokens for specific chains to find exact contract addresses.
- Endpoint:
GET /api/v1/tx/bridge/lifi/tokens?chains={chainIDs}
- Parameters:
chains (comma-separated IDs, e.g., "1,56,1151111081099710, 9270000000000000").
2. Bridge Quote
Estimate cross-chain swap details.
- Endpoint:
POST /api/v1/tx/bridge/lifi/quote
- MANDATORY: Before calling this, you MUST call
/api/v1/tx/bridge/lifi/tokens to verify if the specific token is supported on both source and target chains.
- Payload:
LifiBridgeRequest
from_chain_id: Source chain (e.g., ETH: '1', BSC: '56', Solana: '1151111081099710', Sui: '9270000000000000').from_token: Source token address or symbol.to_chain_id: Destination chain.to_token: Destination token address or symbol.amount: Smallest unit decimal string.from_address: Source wallet address.to_address: Recipient address.
3. Bridge Execution
Execute the cross-chain transaction.
- Endpoint:
POST /api/v1/tx/bridge/lifi/execute
- Payload: Same as
quote.
- Handling PENDING: If the response returns
status: "PENDING", use the final_status_url for tracking. Do not retry the execute call if it returns PENDING.
Chain ID Reference
| Chain | ID |
|---|
| Ethereum | 1 |
| BSC | 56 |
| Base | 8453 |
| Arbitrum | 42161 |
| Optimism | 10 |
| Polygon | 137 |
| Avalanche | 43114 |
| Linea | 59144 |
| Solana | 1151111081099710 |
| Sui | 9270000000000000 |
Agent Instructions
- Token Support Pre-check: CRITICAL. You MUST call
/api/v1/tx/bridge/lifi/tokens?chains={from_chain_id},{to_chain_id} before requesting a quote or execution. This ensures the tokens are supported and provides the exact contract addresses required for stablecoins (USDT/USDC).
- EVM to Sui Optimization: Direct EVM -> Sui takes ~15 mins. To reduce to ~3 mins, suggest routing through Solana:
- Stage 1: EVM -> Solana (Target: USDC).
- Stage 2: Solana -> Sui.
- Note: Ensure the Solana wallet has at least 0.005 SOL for gas before starting.
- No Silent Retries: If execution fails or times out, check the explorer first. Obtain user approval before any retry attempt.
- Bitcoin: Note that Bitcoin is currently not supported by the LI.FI bridge.
