Painless cross-chain swaps: Solana builder stack map

QUOTE_OK
  → USER_REVIEW (amount, est. out, fee, ETA, steps collapsed)
  → SIGNED_SOURCE
  → IN_FLIGHT   (poll status; show source tx + dest expectation)
  → DONE        (dest balance or receipt link)
  → FAILED      (reason + funds location + retry/refund CTA)
  → STUCK       (past ETA; escalate with both chain explorers)

// Thin PoC: painless path = quote + review fields + poll status
// Not production signing — shows the control flow only.

const LIQUEST = "https://li.quest/v1"

type Quote = {
  id?: string
  toolDetails?: { name?: string }
  estimate?: { toAmount?: string; executionDuration?: number }
  transactionRequest?: { data?: string; to?: string; value?: string }
  // …vendor-specific Solana instruction payloads also appear here
}

export async function getCrossChainQuote(p: {
  fromChain: string
  toChain: string
  fromToken: string
  toToken: string
  fromAmount: string // base units
  fromAddress: string
}): Promise<Quote> {
  const q = new URLSearchParams({
    fromChain: p.fromChain,
    toChain: p.toChain,
    fromToken: p.fromToken,
    toToken: p.toToken,
    fromAmount: p.fromAmount,
    fromAddress: p.fromAddress,
  })
  const res = await fetch(`${LIQUEST}/quote?${q}`)
  if (!res.ok) throw new Error(`quote ${res.status}`)
  return res.json()
}

/** Optional: sanity-check quoted out vs Pyth mark (pseudo). */
export function reviewAgainstMark(quotedOutHuman: number, pythMark: number, maxBps = 100) {
  if (!pythMark) return { ok: true as const }
  const bps = Math.abs(quotedOutHuman - pythMark) / pythMark * 10_000
  return bps <= maxBps
    ? { ok: true as const }
    : { ok: false as const, bps, reason: "quote far from mark — refuse or warn hard" }
}

export async function pollStatus(p: {
  txHash: string
  fromChain: string
  toChain: string
  bridge?: string
}): Promise<{ status: string; substatus?: string }> {
  const q = new URLSearchParams({
    txHash: p.txHash,
    fromChain: p.fromChain,
    toChain: p.toChain,
    ...(p.bridge ? { bridge: p.bridge } : {}),
  })
  for (let i = 0; i < 60; i++) {
    const res = await fetch(`${LIQUEST}/status?${q}`)
    const body = await res.json()
    const status = body.status || body.detail || "UNKNOWN"
    if (status === "DONE" || status === "FAILED") return body
    await new Promise((r) => setTimeout(r, 3000))
  }
  return { status: "STUCK" }
}

// App wiring (conceptual):
// 1) if fromChain===toChain===solana → Jupiter, skip this path
// 2) quote = await getCrossChainQuote(...)
// 3) reviewAgainstMark(...) using Pyth HTTP/Hermes or on-chain price
// 4) show collapsed steps + ETA from quote.estimate
// 5) wallet signs quote.transactionRequest / Solana ixs
// 6) pollStatus until DONE | FAILED | STUCK

# Same-chain SOL/SPL — Jupiter quote shape (illustrative)
# Prefer current Jupiter Metis / Ultra docs for live paths.
curl -s "https://quote-api.jup.ag/v6/quote?inputMint=So11111111111111111111111111111111111111112&outputMint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=100000000&slippageBps=50" | head