Account Demolisher

FAQ

Short answers to the questions we hear most.

Is my secret key sent anywhere?

No. If you connect a wallet, the wallet keeps your key and signs each transaction locally. If you use the secret-key fallback, the seed stays in browser memory only and is used to construct a fresh Keypair for each signing call. It is never persisted to disk, sent to any server, or copied to the clipboard.

What does it cost to use?

The app is free. You pay Stellar network fees for the transactions the demolisher submits. A typical closure runs a handful of transactions at Stellar's base fee of 100 stroops per operation, plus the Soroban resource fee on each Soroban node (computed from simulation). The demolisher does not take a cut.

Why is my account "not mergeable"?

Two cases stop a closure cold:

  • AUTH_IMMUTABLE is set on the account. The Stellar protocol forbids merging accounts with this flag. There is no workaround. The flag is permanent.
  • The account is sponsoring entries for others (num_sponsoring > 0). The owner of those sponsored entries has to revoke them first. The demolisher cannot do this on the owner's behalf.

In both cases the audit step shows the exact reason. If it is IS_SPONSOR and every sponsored entry is a self-sponsored claimable balance, the demolisher proceeds: the configure step's numCoverable check counts those CBs against num_sponsoring, and they are claimed during the closure so the count drops to zero before the merge.

Can I close an account that holds DeFi positions?

Yes. That is the main differentiator. The demolisher handles Blend, Aquarius, Soroswap, and FxDAO. The plan tree shows the protocol-specific exit steps before the classical merge. See How it works for the full sequence.

What if my Blend backstop position cannot be withdrawn yet?

Blend's backstop module has a 17-day withdrawal queue (BACKSTOP_QUEUE_DURATION_SECONDS in src/lib/adapters/blend/constants.ts). The demolisher cannot bypass this. It emits a BackstopQueue node in the plan and surfaces the unlock date. You queue the withdrawal during the closure; you come back when the queue clears to pull the lumens manually.

Why is the Soroswap step skipped on testnet?

Soroswap testnet currently has no on-chain pools. The aggregator returns "no path" for every quote. The demo skips the Soroswap swap and add-liquidity steps and surfaces the diagnostic per step. Mainnet, where Soroswap has real liquidity, is unaffected.

Why can't I send to an exchange directly with ACCOUNT_MERGE?

Most centralized exchanges do not accept incoming ACCOUNT_MERGE ops. The merge succeeds on chain but the exchange never credits the deposit. To recover the final 1 XLM base reserve when sending to an exchange, the demolisher routes through a temporary mediator account. See Destinations and the mediator.

What happens if a step fails mid-closure?

The executor classifies the failure into one of six actions defined in src/lib/orchestrator/recovery.ts. Stale sequence numbers, fee underestimation, and footprint changes auto-retry with the right fix (sequence refresh, fee bump, or re-simulation). Slippage breaches do not auto-retry; the user has to consent to the new quote. Allow-list violations and protocol-level refusals are fatal and the run halts with the specific error.

Can I close someone else's account?

No. The demolisher signs with the wallet you connect. If you don't have the master signer (or a multisig set that meets the closing thresholds), the transactions don't sign.

Does it run on mainnet?

The code path runs identically on mainnet and testnet. The default deployment is configured for testnet so reviewers can run the demo without risk. Mainnet usage requires the operator to set NEXT_PUBLIC_STELLAR_NETWORK=mainnet at build time.

Where is the source?

github.com/bytemaster333/account-demolisher. Apache 2.0 licensed.

stellar.expert/demolisher is the original Stellar account closure tool, by StellarExpert. It handles the classic Stellar surface and uses raw secret-key entry as its signing path. Account Demolisher preserves and modernizes that flow, attribution included, and extends it to the Soroban DeFi surface, the multisig coordination flow, the allowance viewer, and modern wallet integration via Stellar Wallets Kit. The two tools share the same goal; this one covers more of today's account surface.