AccountMergeOperation class

Merges an account into another account, transferring all XLM and removing the source account.

This operation permanently deletes the source account from the ledger and transfers its entire XLM balance to the destination account. This is an IRREVERSIBLE operation that completely removes the account from the network.

Operation Process:

Transfers all remaining XLM from source account to destination
Permanently removes the source account from the ledger
Releases the account's base reserve back to the network
Cannot be undone - the account ID can never be used again

Critical Requirements:

Source account must have exactly 0 subentries:
- No trustlines (remove all with ChangeTrustOperation)
- No open offers (cancel all with ManageOfferOperation)
- No data entries (remove all with ManageDataOperation)
- No additional signers (remove all with SetOptionsOperation)
Destination account must exist and be different from source
Minimum XLM balance will be transferred (at least base reserve)

Security Warnings:

IRREVERSIBLE: Account deletion cannot be undone
PERMANENT: Account ID can never be recreated or reused
ALL XLM is transferred - ensure you intend to close the account
Verify destination address carefully - typos cannot be corrected

Use Cases:

Account cleanup: Remove unused or deprecated accounts
Key rotation: Close old account and move to new keypair
Account consolidation: Merge multiple accounts into one
Security: Close compromised accounts after moving funds
Testing: Clean up test accounts

Example - Simple Account Merge:

var mergeOp = AccountMergeOperationBuilder(
  destinationAccountId
).setSourceAccount(sourceAccountId).build();

var transaction = TransactionBuilder(sourceAccount)
  .addOperation(mergeOp)
  .build();

// Source account will be permanently deleted after submission

Example - Complete Account Closure Workflow:

// Step 1: Remove all trustlines
for (var balance in account.balances) {
  if (balance.assetType != 'native') {
    var changeTrust = ChangeTrustOperationBuilder(
      Asset.createNonNativeAsset(balance.assetCode, balance.assetIssuer),
      "0"
    ).build();
    // Add to transaction
  }
}

// Step 2: Cancel all offers
for (var offer in account.offers) {
  var manageOffer = ManageOfferOperationBuilder(
    selling,
    buying,
    "0",
    price
  ).setOfferId(offer.id).build();
  // Add to transaction
}

// Step 3: Remove data entries
for (var entry in account.data) {
  var manageData = ManageDataOperationBuilder(
    entry.name,
    null
  ).build();
  // Add to transaction
}

// Step 4: Merge account
var mergeOp = AccountMergeOperationBuilder(
  destinationAccountId
).build();

var transaction = TransactionBuilder(sourceAccount)
  .addOperation(changeTrust)
  .addOperation(manageOffer)
  .addOperation(manageData)
  .addOperation(mergeOp)
  .build();

Constructors

Properties

Methods

Operators

Static Methods

stellar_flutter_sdk library