@glideco/crosschain-bridge

npm install @glideco/crosschain-bridge

import { routeCandidates, isBridgeable } from '@glideco/crosschain-bridge';

routeCandidates('base', 'arb');  // ['across', 'squid'] — EVM↔EVM, Across preferred
routeCandidates('base', 'sol');  // ['squid']           — Squid only
routeCandidates('sol', 'stellar'); // ['squid']         — Squid only
routeCandidates('eth', 'eth');   // ['glide-internal']  — same-chain

isBridgeable('base', 'sol');  // true
isBridgeable('sol', 'tempo'); // false — tempo not in Squid's chain set

import type { BridgeQuoteRequest } from '@glideco/crosschain-bridge';

const req: BridgeQuoteRequest = {
  fromChain: 'base',
  toChain: 'arb',
  fromToken: 'USDC',
  amountIn: '100000000',   // 100 USDC in 6-decimal units
  fromAddress: '0xSENDER',
  toAddress: '0xRECIPIENT',
  slippageBps: 50,          // 0.5%
  bridges: ['across'],      // restrict to one adapter
};

// Quote the adapter in apps/web; the result shape is:
// {
//   bridge: 'across',
//   fromChain: 'base', toChain: 'arb',
//   fromToken: 'USDC', toToken: 'USDC',
//   amountIn: '100000000', amountOutMin: '99940000',
//   bridgeFee: '60000',
//   etaSeconds: 8,
//   routePayload: { ... },   // opaque, passed to dispatch
//   expiresAt: '2026-04-30T14:22:30Z',
// }

import { aggregateQuotes } from '@glideco/crosschain-bridge';

// Combine quotes from both adapters; pick the cheapest fresh one.
const { best, all, expired } = aggregateQuotes([squidQuote, acrossQuote]);

// best.bridge → 'across' (lower bridgeFee)
// expired → quotes past their expiresAt

import type { BridgeDispatchRequest } from '@glideco/crosschain-bridge';

const dispatch: BridgeDispatchRequest = {
  quote: best,
  idempotencyKey: 'pay_2026_04_30_invoice_099',
  grantId: 'd4e5f6a7-b8c9-0123-abcd-ef1234567890',
  correlationId: 'mcp_audit_9a8b7c6d',
};

// apps/web routes to squid-sdk or across-sdk based on dispatch.quote.bridge