Skip to main content
Swaps is an optional feature surface. quoteSwap works end-to-end. swap enforces the minOut floor before submit and fails closed (SWAP_FAILED) until the full EVM wallet submit path is wired through your BFF. The core SDK (connect, pay, batch, sessions) does not depend on this surface.

Enabling swaps

Pass swapChain to buckspayFacilitator. Without it, quoteSwap and swap are omitted from the relayer and both methods throw if called:

quoteSwap - ships end-to-end

quoteSwap is signer-agnostic and delegates to /swap/quote:

swap - enforces the floor, fails closed

swap checks minOut before any submit. If the live quote falls below minOut, it throws BuckspayError("SWAP_FAILED") without signing or submitting anything:

Full example

Next

Atomic batch

Settle multiple transfers all-or-nothing in one transaction.

Onboarding

How a user with zero XLM gets a payment-ready account.