README
¶
ETH-XMR Atomic Swaps
This is a WIP implementation of ETH-XMR atomic swaps, currently in the pre-production development phase. It currently consists of swapd and swapcli binaries, the swap daemon and swap CLI tool respectively, which allow for peers to discover each other over the network, query peers for their current available offers, and the ability to make and take swap offers and perform the swap protocol. The swapd program has a JSON-RPC endpoint which the user can use to interact with it. swapcli is a command-line utility that interacts with swapd by performing RPC calls.
Disclaimer
This code is unaudited and under active development and should not be used on mainnet or any networks that hold monetary value!!!
Protocol
Please see the protocol documentation for how it works.
Swap instructions
Trying it locally
To try the swap locally with two nodes (maker and taker) on a development environment, follow the instructions here.
Trying it on Monero's stagenet and Ethereum's Goerli testnet
To try the swap on Stagenet/Goerli, follow the instructions here.
Additional documentation
Developer instructions
Please see the developer docs.
Recovery module
In case the swap process crashes during a swap, you can recover your funds with the recovery module. Please see the instructions here.
RPC API
The swap process comes with a HTTP JSON-RPC API as well as a Websockets API. You can find the documentation here.
Contributions
If you'd like to contribute, feel free to fork the repo and make a pull request. Please make sure the CI is passing - you can run make build, make lint, and make test to make sure the checks pass locally.
Donations
The work on this project is currently funded via a Monero CCS Proposal If you would like help fund this project, feel free to contribute to a follow-up CCS proposal when it's ready for funding. In the meantime, check out other CCS proposals ready for funding.
Directories