feat: solana-x402-bridge-skill — best-rate cross-chain bridge aggregator for Solana agents

[lpsmurf]

Your Solana agent has USDC, but the opportunity is on another chain — an invoice to settle on Base, a market on Polygon, yield on Arbitrum. This skill lets the agent move that USDC to any EVM chain at the best available rate and actually execute it — safely, in one call, from the same Solana wallet it started with.

It shops every major bridge — Circle CCTP, Mayan, deBridge, Allbridge — in parallel, returns the best net-of-fee route plus the full ranked breakdown, and even tells the agent when paying for aggregation isn't worth it.

Live on mainnet

Best-rate aggregation · safety preflight (allowlist, caps, enforced swap-slippage protection w/ bounded override) · RPC health & failover (Solana slot-lag + EVM block-lag, 6 chains, keyless public defaults) · --confirm-gated non-custodial execution · honest free-vs-paid verdict · live polymarket-read. Fiat (Onramper) is sandbox.

Structure (matches solana-game-skill)

skill/SKILL.md routes to focused, progressively-loaded .md references; agents/, commands/, rules/; clean install.sh; full README. MIT.

Tested

3,720 deterministic unit cases (npm test) covering the slippage rails + target registry, plus live integration across 4 providers and 6 chains. tsc clean.

60-second demo

npm install
npm run quote USDC 100 ethereum USDC    # aggregation beats CCTP on ETH gas -> +$1.41, "worth paying"
npm run quote USDC 100 polygon USDC     # cheap chain -> "use FREE CCTP" (honest)
npm run health solana                   # RPC health + failover

Proof (real mainnet round trip)

• Solana → Polygon: 5PRGrU7qC1s6LmvLYmQ8iU1ZGyU4qkvynxGVoK1FCy3kW36SpBh8M8yaiTqH97ZUmbs2o4kr33DFeCSYEH62J3Qk
• Polygon → Solana: 0x5cb09254977140845386432ae6b89416f3883c35a9b3254a36a2a9979642ae77

No secrets in the repo; non-custodial; nothing signs without --confirm.