Skip to main content
Stellar Stellar is fully supported for onramps, offramps, and swaps. It also has the most chain-specific setup of any supported network — assets require trustlines, wallets need a small XLM balance for reserves and fees, and pre-built transactions expire quickly. This page covers everything Stellar-specific; the end-to-end flows live in the Onramps, Offramps, and Swaps guides.

​
Supported operations

OperationSupported
Onramp (fiat → token)✓
Offramp (token → fiat)✓
Swap (token → token)✓

​
Asset identifiers

Stellar assets use CODE:ISSUER format — e.g. CETES:GC3CW7EDYRTWQ635VDIGY6S4ZUF5L6TQ7AA4MWS7LEQDBLUSZXV7UPS4.
Always read identifiers from GET /ramp/assets — never hardcode the issuer. The issuer account differs between sandbox and production and can change. Hardcoding an issuer you found elsewhere is the most common cause of “wrong asset” confusion. Pass blockchain=stellar and use the identifier field verbatim in your quote.
Getting testnet USDC in sandbox. There’s no faucet for Etherfuse’s sandbox USDC. The easiest way to get some is to onramp CETES, then swap CETES → USDC. (You need a trustline for any asset you want to receive — see below.)

​
Stablebond addresses

Live asset issuers for every stablebond on Stellar, each linked to Stellar Expert:

​
Wallet & gas requirements

Holding and receiving Stellar assets requires XLM for the account reserve and per-asset trustlines. These are Stellar network requirements, not Etherfuse fees:
  • ~1 XLM base reserve to create the account on-chain.
  • ~0.5 XLM additional reserve per trustline (so ~1.5 XLM for an account holding one asset).
  • A few stroops per transaction for the network fee — keeping ~0.01 XLM on a wallet covers thousands of transactions.
No fee-bump / gas sponsorship yet. Each Stellar wallet must currently hold its own XLM to cover reserves and fees. (Gasless offramps are available on EVM chains — see Base — and centralized Stellar gas sponsorship is on the roadmap.)

​
Trustlines

A wallet must hold a trustline for any asset it will receive. For onramps, Etherfuse can create the trustline for you (see below). For offramps and swaps, the wallet must already have the trustline and enough XLM before you create the order.

​
Onramps: first-time wallets are handled automatically

When onramping to a wallet that doesn’t yet exist on-chain or lacks the target trustline, pass walletAddress in the quote request. Etherfuse funds the account and adds the trustline for you, folding a one-time cost into the quote fee, and delivers the tokens as a claimable balance the user signs for afterward. See Onramps → Stellar: First-Time Wallet Onramp for the full claimable-balance flow (stellarClaimableBalanceId + stellarClaimTransaction).

​
Offramps and swaps: fund the wallet first

An unfunded or trustline-less wallet fails silently. For offramps and swaps, if the wallet isn’t already funded with XLM and doesn’t hold the asset’s trustline, Etherfuse cannot build the burn/send transaction — so no burnTransaction is returned and no order_updated / swap_updated webhook fires. If you create an offramp or swap and never receive the signing transaction, this is almost always why.Before creating the order: confirm the wallet exists on-chain, holds ≥ ~1.5 XLM, and has a trustline for the asset being sold (use GET /ramp/assets?blockchain=stellar to get the issuer for the trustline). Also double-check the G... address is valid — a mis-copied address fails its checksum.

​
Transaction expiry and regeneration

Pre-built Stellar transactions (burn, swap send, and claim XDRs) are short-lived — roughly 1–2 minutes. Submitting a stale one returns tx_too_late from Horizon. Regenerate a fresh transaction instead of reusing an expired one:
Keep the user’s transaction fresh by calling regenerate_tx about once a minute while they have an unsigned transaction open, so they always have a valid one to sign and submit.

​
Anchor mode (SEP-24)

For Stellar offramps you can use anchor mode (useAnchor: true) instead of the default burn-transaction flow — Etherfuse returns a destination account + memo and you build the payment yourself. See Offramps → Anchor Mode.

Onramps

Offramps

Swaps