One-time setup · Monero

Your swaps, on your device.

The companion passes your selected offer to your own BasicSwap client. Your wallet password stays on your computer. swap.lightning-network.ro can close after submission while BasicSwap continues the swap.

  1. Get BasicSwap ready

    Install BasicSwap from its official instructions ↗. Set up your Monero and Litecoin or Bitcoin wallets. Keep the client running and its API private on 127.0.0.1:12700.

    Lightweight modes ↗ can reduce local blockchain storage, with privacy and validation tradeoffs.

  2. Start the companion

    Download companion ↓

    Unzip it on the same computer. Read the included source and README, then run this inside the extracted folder using Python 3.9 or newer:

    python3 -B companion.py --ask-password

    Enter your local BasicSwap API password in that terminal. The companion never asks the website for it. If your local API has no password, omit --ask-password.

  3. Choose your swap

    Return to swap.lightning-network.ro, choose your coins and amount, and open the local confirmation. It checks the offer and your wallets again. Review the amounts and approve there.

    Back to swap
What if something closes or disconnects?

Keep the BasicSwap engine online for timed claims and refunds. Closing swap.lightning-network.ro or the companion does not stop BasicSwap. Continue in the native BasicSwap interface using the bid ID shown on the local receipt.

The original BasicSwap swap database and wallet backups matter; your seed alone cannot replace an active swap's state. Official backup instructions ↗

If a submission times out, check your sent bids before starting a new proposal. The companion keeps a durable receipt and blocks repeating the same request after restart.

Preview limits

Initial local pairs are BTC ↔ XMR and LTC ↔ XMR. This release has automated tests using a fake BasicSwap API; funded integration testing and an external audit remain outstanding. Redemption fees can reduce the displayed gross receive amount. The companion checks availability but cannot guarantee maker acceptance.

The companion runs only on your computer. It is never installed on the public swap.lightning-network.ro server, never unlocks wallets and never exposes general BasicSwap API access to the website.