Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lumenwipe.com/llms.txt

Use this file to discover all available pages before exploring further.

LumenWipe is an open-source, non-custodial tool that cleanly closes a Stellar account and returns its locked XLM to the user. It unwinds everything that holds an account open (trustlines, offers, data entries, extra signers, liquidity pool shares, and DeFi positions), converts whatever is left to XLM, and merges the account into a destination wallet or exchange. It extends the public-domain stellar.expert/demolisher by Orbit Lens with the piece that tool lacks: full Soroban and DeFi support.

​
The problem

Stellar has more than ten million accounts on mainnet, and a large share are stale, abandoned, or effectively locked. Every account holds XLM in reserve (1 XLM base, plus 0.5 XLM per trustline, offer, data entry, or signer), and that reserve is only recoverable by closing the account. Closing one cleanly is a manual, multi-step process most users cannot perform: a single leftover entry makes the final ACCOUNT_MERGE fail. Exchanges make it worse, because none support ACCOUNT_MERGE, so the base reserve stays frozen for anyone trying to cash out to a CEX. DeFi users have no tool at all today, since the existing demolisher has no Soroban support.

​
What we build

A guided web app that runs the whole wind-down in one flow and signs every transaction in the browser. The headline difference from the reference tool is closing positions across the main Soroban DeFi protocols (Blend, Aquarius, Soroswap, Phoenix, FxDAO) on top of all classic operations, plus a CEX-compatible merge, a read-only allowance inspector for revoking risky token approvals, and a UX designed for irreversible actions.

​
Why us

The classic wind-down already runs. The current codebase reads account state over Stellar RPC and the stellar.expert API, builds and signs classic transactions client-side, and executes the full path (signer normalization, data entry removal, offer cancellation, asset conversion via SDEX path payments, trustline removal, and AccountMerge, including the mediator flow for exchange destinations), with unit and end-to-end tests. We are extending a working foundation, not starting from a blank page.

​
How it works

Analyze the account, generate a deterministic ordered plan, execute it step by step with explicit confirmation, then merge. A full close is several sequential transactions, so the tool shows the complete plan up front and simulates each step before asking for a signature.

​
Technical pillars

  • Non-custodial by construction. Private keys never leave the browser, the backend is read-only, and no operator (including us) can move a user’s funds.
  • No bespoke indexer, no Horizon dependency. Stellar RPC reads live state, simulates, and submits; an existing indexer (stellar.expert) handles enumeration; OctoPos and Orion provide DeFi position detection.
  • Per-protocol exit adapters and a versioned contract registry. Detect positions with the DeFi Position API, build the exit with each protocol’s SDK, public API, or contract, and simulate before signing. A protocol upgrade is a registry update, not a rewrite.
  • CEX compatibility through a transparent temporary mediator account, since exchanges do not support ACCOUNT_MERGE.
  • Safety for irreversible operations. Per-step confirmation, simulation before signing, resumable sessions reconciled against on-chain state, and a third-party security audit before any mainnet release.

​
How it meets the RFP

  • Covers the full Account Demolisher requirement set: sponsorship and multisig checks, signer and threshold normalization, trustline, data entry, offer, and DeFi position removal, claimable balances, asset conversion, and merge with the mediator flow. See the RFP compliance matrix.
  • Consumes a funded DeFi Position API recipient, OctoPos as primary and Orion as fallback, exactly as the RFP requires.
  • Open source under Apache 2.0, self-hostable as a single service, with a third-party security audit through the Audit Bank.

​
Delivery

TrancheFocus
1. Classic MVPFull classic wind-down on testnet, the mediator flow, multisig, session recovery. Largely built today.
2. Soroban and DeFiPosition detection via OctoPos and Orion; Blend, Aquarius, Soroswap, Phoenix, and FxDAO exits; Soroban conversion; allowance inspector.
3. Production hardeningThird-party security audit and remediation, mainnet deployment, performance validation, final documentation.

​
Read more