search

BrandyJSon / feather-atomic

Fork of feather wallet with COMIT network atomic swap built in.
https://featherwallet.org
BSD 3-Clause "New" or "Revised" License
8 stars 0 forks source link

readme

Feather Atomic

Feather Atomic is a plugin for the free, open-source Monero wallet for Linux, Tails, macOS and Windows, Feather. It is written in C++ with the Qt framework.

Usage

Make sure to click configure button in the atomic tab and either auto install the swap binary or select the already installed binary. All files relevant to swap will be stored in feathers config directory including the binary if you auto install.

If after installing the swap tool, refresh fails to show any swaps make sure to check that you have a version of GLIBC greater or equal to 2.32 or this plugin will not be able to run on your system.

Running a swap

  1. Click refresh offers (may take a little if routing through tor)
  2. Click the offer you would like to take from the table
  3. Enter a BTC change address (make sure you are using a testnet address if feather is running stagenet mode)
  4. Enter a XMR receive address
  5. Click swap
  6. Wait for fund dialog to appear, send at least the minimum BTC covering tx fees to the address and not more then the max BTC of the offer (if there is BTC from a previous uncompleted swap then this dialog may not appear)
  7. Once the transaction is detected in the BTC mempool a different dialog will appear showing the status of confirmations for BTC and XMR side of swap
  8. If all goes right after the BTC transaction reaches at least 1 confirmation and the XMR transaction reaches at least 10 confirmations the swap complete and both parties should be happy with their new coins

Recovery

If for some reason the swap isn't able to be completed when ran, one party goes offline, application crashes, etc then a recovery dialog will automatically appear next time you launch feather atomic as long as the swap still can be resumed or canceled.

To cancel a swap

  1. Make sure swap has had enough BTC confirmations to be able to be canceled (should take about 12 hours, gui reflect if it can be canceled)
  2. Click the swap you wish to cancel then click the cancel button
  3. A dialog will spawn and then after a moment the dialog should update to say the swap has been canceled

To resume a swap

  1. Click the swap you wish to resume then click the resume button
  2. If the seller is still online then the normal swap dialog will appear
  3. The confirmations may not always be accurate when resuming so rely on the status message in the dialog to follow progress of the swap.
  4. As long as both parties stay online the swap should continue as normal and end with both parties having their new coins

Testnet4 swap demo

https://github.com/user-attachments/assets/b7871a2f-21d0-46e2-b575-b9ba885a810d

For release policy, see: RELEASE.md

Development

If you are looking to set up a development environment for Feather, see HACKING.md.

It is highly recommended that you join our Matrix or IRC channel if you are hacking on Feather. Idling in this channel is the best way to stay updated on best practices and new developments.

For information on how Feather is maintained, see: MAINTENANCE.md

To report a security vulnerability, see: SECURITY.md

Support

Feather is funded entirely through donations. We don't take a cut from transaction fees and make no money from exchange integrations.

Donations help pay for hosting, build servers, domain names, e-mail and other recurring costs. Any amount helps.

47ntfT2Z5384zku39pTM6hGcnLnvpRYW2Azm87GiAAH2bcTidtq278TL6HmwyL8yjMeERqGEBs3cqC8vvHPJd1cWQrGC65f

License

Feather is free and open-source software, licensed under BSD-3.

Copyright (c) 2020-2024, The Monero Project