> For the complete documentation index, see [llms.txt](https://xeqmlabs.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xeqmlabs.gitbook.io/docs/documentation/guides/xeq-legacy-swap-mainnet/cli-wallet-legacy-swap.md). # CLI Wallet - Legacy Swap {% hint style="danger" %} For advanced users who prefer the command line. CLI support is limited, if you are using CLI, YOU BETTER KNOW WHAT YOU ARE DOING. SEE RISK NOTICE BELOW! {% endhint %} ⚠️ **Disclaimer / Risk Notice** **Use official Equilibria wallets only. The Equilibria team and contributors are not responsible for lost funds, incorrect addresses, user error, third-party software, or any mishandled or failed transactions.** The Legacy Swap is used **entirely at your own risk.** {% hint style="danger" %} WARNING — CLI WALLET USERS You MUST type exit to close the CLI wallet. Do NOT close the terminal window, do NOT restart your PC, do NOT shut down — until after you have generated and saved your proof. If the CLI wallet is force-closed for any reason (power loss, Windows auto-restart, closing the window) before you type exit, your wallet will not save correctly. If that happens, you will permanently lose the ability to generate a proof for any transaction sent during that session. The funds sent to the burn address cannot be recovered!!!!! Using the GUI wallet eliminates this risk entirely. The GUI saves your wallet automatically after every transaction. {% endhint %} ## Step 1 — Download the GUI Wallet Package The CLI tools are bundled inside the official GUI wallet download — no separate download needed. {% embed url="" %} {% hint style="warning" %} ⚠️ Use official wallets only. Do not download from third-party websites. {% endhint %} #### Windows - Download and install the wallet for your platform, then navigate to the install directory. Inside you will find: resources/ bin-legacy/ ← Legacy XEQ binaries (v22) xeq-d.exe xeq-wallet-cli.exe bin/ ← New mainnet binaries (v23) xeq-d.exe xeq-wallet-cli.exe #### Linux — The AppImage must be extracted first to access the CLI binaries: Install required dependencies: \ sudo apt-get install -y libboost-all-dev libsodium23 libfuse2t64 Download and extract: \ wget \ chmod +x XEQ-GUI-1.2.1-linux.AppImage \ ./XEQ-GUI-1.2.1-linux.AppImage --appimage-extract
Your binaries will be at: \ squashfs-root/resources/ \ bin-legacy/ ← Legacy XEQ binaries (v22) \ xeq-d \ xeq-wallet-cli \ bin/ ← New mainnet binaries (v23) \ xeq-d \ xeq-wallet-cli #### macOS — Download the .dmg, open it, then right-click the app → Show Package Contents → navigate to Contents/Resources/ ⚠️ Use official wallets only. Do not download from third-party websites. *** ### Step 2 — Create Your New Mainnet Wallet (Offline) Before touching your legacy wallet, generate a new mainnet wallet to receive your swapped XEQ. Navigate to resources/bin/ (or squashfs-root/resources/bin/ on Linux) and run: Windows: xeq-wallet-cli.exe Linux/macOS: ./xeq-wallet-cli * Select Create a new wallet * Choose a wallet name and password * The CLI will generate your 25-word seed phrase ⚠️ Write down your seed phrase and store it somewhere safe offline. If you lose it your funds are permanently lost. Never share it with anyone. Your wallet address will start with XEQM. Copy and save it — this is where your swapped XEQ will be sent. No daemon is needed for this step. The new mainnet is not yet live. *** ## Step 3 — Start the Legacy Daemon Navigate to resources/bin-legacy/ (or squashfs-root/resources/bin-legacy/ on Linux) and start the daemon: Windows: xeq-d.exe --rpc-bind-port 19231 Linux/macOS: ./xeq-d --rpc-bind-port 19231 Alternatively, connect directly to a remote node and skip running a local daemon (see Step 4). Running a local daemon is recommended — it reduces failed proof generation, ensures accurate confirmations, and avoids remote node disconnects. Wait for the daemon to fully sync before proceeding. *** ## Step 4 — Open Your Legacy Wallet From inside resources/bin-legacy/ (or squashfs-root/resources/bin-legacy/ on Linux), run: Windows (local daemon): xeq-wallet-cli.exe --wallet-file your\_wallet\_name Windows (remote node, no local daemon): xeq-wallet-cli.exe --wallet-file your\_wallet\_name --daemon-address us.equilibriacc.com:9231 Linux/macOS: ./xeq-wallet-cli --wallet-file your\_wallet\_name --daemon-address us.equilibriacc.com:9231 Wait for the wallet to finish refreshing. Before continuing confirm: * ✔ Wallet is fully synced * ✔ Daemon is connected * ✔ Balance is unlocked *** ## Step 5 — Send Legacy XEQ to the Swap Address Inside the wallet CLI, run: transfer MAINNET\_SWAP\_ADDRESS\_PLACEHOLDER amount 🚨 Always send a small test transaction first. Once it confirms, send the full amount. After sending, the TXID will appear in the output — it looks like: Transaction successfully submitted, transaction <7843151985ebdfbf4faf502c361bad8d75cfa5efd89a23e6d140e09c7336671a> Copy and save your TXID. You will need it in the next steps. *** ## Step 6 — Wait for Confirmations Wait for at least 50 confirmations before generating a proof. You can check confirmation count inside the wallet with: show\_transfers ⚠️ Generating a proof before 50 confirmations may cause it to fail. *** ## Step 7 — Generate Your Transaction Proof Once confirmed, run inside the wallet CLI: get\_tx\_proof Tw1AmWavnFtPT4rgfwt7seYHsLW1vPE7wR8s5BBtu7NZCK31H9jWy6r7m4iZ8APaLDfzGvrgqU9fW3BLjKKiHBw82EntBGmLn Example: get\_tx\_proof 7843151985ebdfbf4faf502c361bad8d75cfa5efd89a23e6d140e09c7336671a Tw1AmWavnFtPT4rgfwt7seYHsLW1vPE7wR8s5BBtu7NZCK31H9jWy6r7m4iZ8APaLDfzGvrgqU9fW3BLjKKiHBw82EntBGmLn This will create a file called equilibria\_tx\_proof in your wallet directory. Open it with any text editor — it will look like: OutProofV17v5idEXec1c8aD1dcmJVPGBaQ3ysZm3HkFLQAp......... Copy the entire contents. *** ## Step 8 — Verify Your Proof (Optional but Recommended) Before submitting, verify your proof is valid: check\_tx\_proof Tw1AmWavnFtPT4rgfwt7seYHsLW1vPE7wR8s5BBtu7NZCK31H9jWy6r7m4iZ8APaLDfzGvrgqU9fW3BLjKKiHBw82EntBGmLn equilibria\_tx\_proof You should see: Good signature If you see Good signature your proof is valid and ready to submit. *** ## Step 9 — Submit on the Swap Portal Go to the official swap portal: [https://swap.xeqlabs.com](https://swap.xeqlabs.com/) Complete the required fields. Click Submit Swap Request. If the Submit button is greyed out, one or more fields are incorrect. Check your entries and try again. Once submitted and validated your swap entry is recorded. You are done. *** ## Verify Your Swap Track your swap status at: [https://swap-tracker.xeqlabs.com](https://swap-tracker.xeqlabs.com/) Search using your TXID. Statuses: * Pending — awaiting verification * Verified — swap successfully recorded * Rejected — proof failed validation *** ## Important Reminders {% hint style="info" %} 🚨 Do NOT send from exchanges Exchanges cannot generate transaction proofs. Funds sent from exchanges may be unrecoverable. {% endhint %} {% hint style="info" %} 🚨 Never share your seed phrase The Equilibria team will never ask for your seed phrase. {% endhint %} {% hint style="info" %} 🚨 Always verify the swap address Only use addresses published in the official GitBook, official announcements, or the official swap portal. {% endhint %} *** ⚠️ **Disclaimer / Risk Notice** **Use official Equilibria wallets only. The Equilibria team and contributors are not responsible for lost funds, incorrect addresses, user error, third-party software, or any mishandled or failed transactions.** The Legacy Swap is used **entirely at your own risk.**