xmr-btc-swap/README.md

XMR to BTC Atomic Swap
======================

This repository hosts an MVP for atomically swapping BTC to XMR.
It implements the protocol described in [this](https://arxiv.org/abs/2101.12332) paper.

## Quick start

1. Download the [latest release](https://github.com/comit-network/xmr-btc-swap/releases/latest) for your operation system
2. Run the binary: `./swap buy-xmr --receive-address <YOUR MONERO ADDRESS>`
3. Follow the instructions printed to the terminal

## Limitations

For now, the MVP is limited to `testnet3` on Bitcoin and `stagenet` on Monero.

## How it works

This repository primarily hosts two components:

- the `swap` CLI
- the `asb` service

### swap CLI

The `swap` CLI acts in the role of Bob and swaps BTC for XMR.
See `./swap --help` for a description of all commands.
The main command is `buy-xmr` which automatically connects to an instance of `asb`.

### asb service

`asb` is short for **a**utomated **s**wap **b**ackend (we are open to suggestions for better names!).
The service acts as the counter-party for the `swap` CLI in the role of Alice.
It provides the CLI with a quote and the liquidity necessary for swapping BTC into XMR.

## Contact

Feel free to reach to out us in the [COMIT-Monero Matrix channel](https://matrix.to/#/#comit-monero:matrix.org).
Add a README.md file Add a readme that describes the project. Specifically - module structure - what we prove and do not prove - how we test 2020-10-07 18:12:17 -04:00			`XMR to BTC Atomic Swap`
			`======================`

Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`This repository hosts an MVP for atomically swapping BTC to XMR.`
			`It implements the protocol described in [this](https://arxiv.org/abs/2101.12332) paper.`
Add a README.md file Add a readme that describes the project. Specifically - module structure - what we prove and do not prove - how we test 2020-10-07 18:12:17 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`## Quick start`
Move alice/bob definition comment 2020-10-08 18:46:44 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`1. Download the [latest release](https://github.com/comit-network/xmr-btc-swap/releases/latest) for your operation system`
			2. Run the binary: `./swap buy-xmr --receive-address <YOUR MONERO ADDRESS>`
			`3. Follow the instructions printed to the terminal`
Move alice/bob definition comment 2020-10-08 18:46:44 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`## Limitations`
Update README Update the readme inline with review suggestions by doing: - Copy 'long story short' text from blog post - Correct the erroneous description of watching blockchains - Fix gramar 2020-10-08 18:34:24 -04:00
Fixup backticks in README 2021-03-09 22:55:36 -05:00			For now, the MVP is limited to `testnet3` on Bitcoin and `stagenet` on Monero.
Update README Update the readme inline with review suggestions by doing: - Copy 'long story short' text from blog post - Correct the erroneous description of watching blockchains - Fix gramar 2020-10-08 18:34:24 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`## How it works`
Update README Update the readme inline with review suggestions by doing: - Copy 'long story short' text from blog post - Correct the erroneous description of watching blockchains - Fix gramar 2020-10-08 18:34:24 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`This repository primarily hosts two components:`
Add a README.md file Add a readme that describes the project. Specifically - module structure - what we prove and do not prove - how we test 2020-10-07 18:12:17 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			- the `swap` CLI
			- the `asb` service
Add a README.md file Add a readme that describes the project. Specifically - module structure - what we prove and do not prove - how we test 2020-10-07 18:12:17 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`### swap CLI`
Add a README.md file Add a readme that describes the project. Specifically - module structure - what we prove and do not prove - how we test 2020-10-07 18:12:17 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			The `swap` CLI acts in the role of Bob and swaps BTC for XMR.
			See `./swap --help` for a description of all commands.
			The main command is `buy-xmr` which automatically connects to an instance of `asb`.
Add a README.md file Add a readme that describes the project. Specifically - module structure - what we prove and do not prove - how we test 2020-10-07 18:12:17 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`### asb service`
Add a README.md file Add a readme that describes the project. Specifically - module structure - what we prove and do not prove - how we test 2020-10-07 18:12:17 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`asb` is short for automated swap backend (we are open to suggestions for better names!).
			The service acts as the counter-party for the `swap` CLI in the role of Alice.
			`It provides the CLI with a quote and the liquidity necessary for swapping BTC into XMR.`
Add a README.md file Add a readme that describes the project. Specifically - module structure - what we prove and do not prove - how we test 2020-10-07 18:12:17 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`## Contact`
Add a README.md file Add a readme that describes the project. Specifically - module structure - what we prove and do not prove - how we test 2020-10-07 18:12:17 -04:00
Replace protocol definition in README with setup instructions Fixes #262. 2021-03-04 23:47:16 -05:00			`Feel free to reach to out us in the [COMIT-Monero Matrix channel](https://matrix.to/#/#comit-monero:matrix.org).`