Sui to Stellar

Sui to Stellar is two transactions on two chains. The user's Sui wallet burns USDC through Circle's CCTP. Once Circle has attested the burn, a Stellar transaction mints it to the recipient. Through the API you submit that second transaction yourself, with any Stellar account paying the network fee.

The route is Standard speed only, and it appears in GET /v1/routes only while it is switched on.

What you needCopy Anchor Link

• The sender's Sui address: 0x and 64 hex characters. It must hold enough USDC, and SUI for gas.
• The recipient's Stellar account (G...). It must already exist and have a USDC trustline. If not, the API refuses with invalid_recipient before anything is signed.
• A Sui wallet that implements the Wallet Standard's sui:signAndExecuteTransaction.
• A Stellar account to pay for the mint: the recipient, the sender's own Stellar account, or yours. It needs a little XLM. It does not need to be the recipient; the mint always pays the recipient the burn names.

The flowCopy Anchor Link

In codeCopy Anchor Link

import { createXebraClient } from "@xebra/sdk";

// Your Sui wallet (Wallet Standard): sign and execute, return the digest.
declare function signAndExecuteSui(transactionJson: string): Promise<string>;
// Your Stellar wallet and RPC: sign, submit, wait for the ledger, return the hash.
declare function signAndSubmitStellar(xdr: string, networkPassphrase: string): Promise<string>;

const xebra = createXebraClient();

const { quote, steps } = await xebra.createTransfer({
  from: "sui",
  to: "stellar",
  amount: "25",
  sender: "0xSuiSender...", // 0x and 64 hex characters
  recipient: "GRECIPIENT...", // a Stellar account with a USDC trustline
});
console.log(`${quote.recipientGets} USDC will arrive`);

const burn = steps[0];
if (!burn || burn.tx.kind !== "sui") throw new Error("expected one Sui step");
const digest = await signAndExecuteSui(burn.tx.json);

const status = await xebra.waitForDelivery("sui", digest);
if (status.state === "needs_claim") {
  const claim = await xebra.createClaim({ chain: "sui", tx: digest, payer: "GPAYER..." });
  for (const step of claim.steps) {
    if (step.tx.kind !== "stellar") throw new Error("expected a Stellar step");
    await signAndSubmitStellar(step.tx.xdr, step.tx.networkPassphrase);
  }
}

When the claim is refusedCopy Anchor Link

• not_ready: Circle has not attested the burn yet. Ask again in a few minutes.
• already_delivered: the USDC has already been minted. Nothing to do.
• invalid_request: the payer is not a Stellar account, or does not exist yet. Fund it with XLM first.
• transaction_rejected: Circle's record of the burn is not a transfer this route can mint (for example, it is not a USDC burn to Stellar). The problem's detail says why.

A failed state on a Sui transfer means the same thing: Circle's record was read and refused. reason carries the explanation, and claimUrl is always null on Sui; finish Sui transfers with POST /v1/claims.