createSigningRequest call returns a new signingRequest.uuid. Execute and confirm that request before continuing to the next transaction.
1. Create a wallet
CreateWallet creates a Stellar API wallet:details.address and use it in place of the sample new-wallet address below. Wallet creation requires no separate execution call.
The wallet’s STATUS_ACTIVE is its MPCVault status; the Stellar account still needs activation.
2. Activate the account
The existing funding wallet sends3 XLM to the new address. stellarSendNative creates the destination account if it is inactive.
This amount covers activation, one trustline and fees in the confirmed run. An unsponsored account requires 1 XLM; a standard trustline adds 0.5 XLM to its reserve. See Stellar account funding.
Use credentials for the funding wallet’s vault:
3. Add a trustline
The new wallet adds a trustline to Circle’s Stellar Mainnet USDC issuer, using its own vault credentials:4. Check the sender’s USDC balance
The existing funding wallet sends the USDC payment. Query its balance with GetBalance, using a token with access to that wallet’s vault:balance is in whole USDC units. Omit tokenAddress to query XLM. The sender needs at least 0.1 USDC available and enough spendable XLM for fees; total balances can include amounts reserved or committed to offers.
5. Send with a memo
The existing wallet sends0.1 USDC to the new wallet. The recipient’s activation and USDC trustline were established in steps 2 and 3.
amount is a decimal string in whole USDC units, with up to seven decimal places. For supported memo types, see Memos.
Execute and confirm
For each activation, trustline or payment request, review its details, then execute its returnedsigningRequest.uuid:
<SOURCE_WALLET_API_TOKEN> is the funding token for activation and payment, or the new-wallet token for the trustline. The vault UUID and client signer key were set when creating that request.
Query the same request to track signing:
STATUS_SUCCEEDED confirms signing, not on-chain execution. Use the returned txHash to check the transaction and its operations:
successful and the operation details; for the payment, also check the memo. Stellar RPC confirmation is also available.
After confirmation, query the new wallet with GetBalance to check its current USDC balance, using its address and <NEW_WALLET_API_TOKEN>. A balance query does not identify which transaction changed it. After a timeout, check the existing request and transaction before creating another request.