Skip to main content

​
Spark Stables Bridge

Spark Stables is a quote-based bridge that lets users send USDC on supported chains and receive USDB on Spark. The flow is one-way into Spark.

​
Components

  • User wallet (Solana/EVM): Sends USDC from the source chain.
  • Bridge SDK (spark.stables): Quote, submit, and status helpers.
  • Bridge API: Issues quotes, verifies deposits, and orchestrates minting.
  • Chain verifiers: RPC providers confirm deposits and confirmations.
  • Brale: Converts USDC to USDB and transfers to Spark.
  • Spark: Receives USDB at the user’s Spark address.

​
Architecture

​
Flow: USDC -> USDB (Spark)

​
Status model

  • processing: deposit submitted, waiting for verification.
  • confirming: tx found, waiting for chain confirmations.
  • minting: Brale transfer in progress.
  • completed: USDB sent to the Spark address.
  • failed: terminal failure.
Quote status (when polling by quoteId):
  • pending: quote active, waiting for deposit.
  • expired: quote expired.
  • completed: quote fulfilled.

​
Operational notes

  • Amounts are strings in smallest units (USDC has 6 decimals).
  • Quotes expire; the deposit address is bound to the quote.
  • Processing is idempotent; it is safe to retry process.
  • Supported source chains: solana, base, polygon, arbitrum, optimism, ethereum.