auralshin/defi-bridge-route-planner

DeFi Bridge Route Planner

Purpose

Compare cross-chain transfer options and produce a recommendation with explicit cost/time/risk tradeoffs and quote freshness guarantees.

Is adding a bridge aggregator helpful?

Yes. Aggregators are highly useful as the first discovery layer because they:

• reveal more route candidates (bridges + solvers) quickly,
• improve price competition,
• reduce manual route-by-route querying.

But aggregators should not be the only source. For high-value transfers, cross-check at least one direct bridge quote before final recommendation.

External dependency profile

• Dependency level: High for live route quality.
• Primary sources: bridge aggregators and solver quote APIs.
• Secondary sources: direct bridge quote endpoints.
• Validation/backfill: chain RPC gas estimates and route status pages.
• Offline fallback: cost-modeling only on user-supplied route snapshots.

Use this skill when

• The user wants to bridge assets across chains.
• The user asks for cheapest, fastest, safest, or balanced route.
• The user needs route comparison with fees, slippage, ETA, and risk.

Workflow

1. Capture transfer intent (token, amount, source chain, destination chain, urgency, objective).
2. Fetch route candidates from aggregators first. See references/aggregator-integration.md.
3. Cross-check with direct bridge quotes for major candidates.
4. Score routes with scripts/route_cost_model.py using objective + risk limit.
5. Apply risk checks from references/risk-checklist.md.
6. Return ranked options and recommended route, including quote freshness and caveats.

Data quality rules

• Treat expired quotes as ineligible.
• Reject routes above user risk tolerance.
• Always surface canonical vs wrapped destination token behavior.
• Show total cost decomposition (fees/slippage/gas).

Required output format

{
  "intent": {
    "from_chain": "string",
    "to_chain": "string",
    "token": "string",
    "amount": 0,
    "objective": "cheapest|fastest|safest|balanced"
  },
  "route_options": [
    {
      "route_name": "string",
      "bridge_or_solver": "string",
      "quote_source": "aggregator|direct_bridge",
      "estimated_receive_amount": 0,
      "total_cost_usd": 0,
      "estimated_time_minutes": 0,
      "risk_level": "low|medium|high",
      "quote_age_seconds": 0,
      "quote_valid": true,
      "risk_notes": ["string"]
    }
  ],
  "recommended_route": {
    "route_name": "string",
    "reason": "string"
  },
  "critical_warnings": ["string"]
}

Bundled resources

• references/aggregator-integration.md
• references/risk-checklist.md
• references/route-selection-policy.md
• scripts/route_cost_model.py
• assets/route-options-template.csv