mirror of
https://github.com/comit-network/xmr-btc-swap.git
synced 2024-12-22 06:05:11 -05:00
4115a452e3
allow --change-address to be omitted and default to internal wallet address (#1709) Co-authored-by: binarybaron <86064887+binarybaron@users.noreply.github.com> Co-authored-by: Byron Hambly <byron@hambly.dev>
142 lines
7.5 KiB
Markdown
142 lines
7.5 KiB
Markdown
# Swap CLI
|
|
|
|
The CLI defaults to **mainnet** (from version 0.6.0 onwards).
|
|
For testing and to familiarise yourself with the tool, we recommend you to try it on testnet first.
|
|
To do that, pass the `--testnet` flag with the actual command:
|
|
|
|
```shell
|
|
swap --testnet <SUBCOMMAND>
|
|
```
|
|
|
|
Take note that applying `--testnet` results in transacting on Bitcoin testnet and on Monero stagenet, not on Monero testnet.
|
|
|
|
The two main commands of the CLI are:
|
|
|
|
- `buy-xmr`: for swapping BTC to XMR with a particular seller
|
|
- `list-sellers`: for discovering available sellers through a rendezvous point
|
|
|
|
Running `swap --help` gives us roughly the following output:
|
|
|
|
```
|
|
swap 0.8.0
|
|
The COMIT guys <hello@comit.network>
|
|
CLI for swapping BTC for XMR
|
|
|
|
USAGE:
|
|
swap [FLAGS] [OPTIONS] <SUBCOMMAND>
|
|
|
|
FLAGS:
|
|
--debug Activate debug logging
|
|
-h, --help Prints help information
|
|
-j, --json Outputs all logs in JSON format instead of plain text
|
|
--testnet Swap on testnet and assume testnet defaults for data-dir and the blockchain related parameters
|
|
-V, --version Prints version information
|
|
|
|
OPTIONS:
|
|
--data-base-dir <data> The base data directory to be used for mainnet / testnet specific data like database, wallets etc
|
|
|
|
SUBCOMMANDS:
|
|
buy-xmr Start a BTC for XMR swap
|
|
list-sellers Discover and list sellers (i.e. ASB providers)
|
|
|
|
cancel Try to cancel an ongoing swap (expert users only)
|
|
help Prints this message or the help of the given subcommand(s)
|
|
history Show a list of past, ongoing and completed swaps
|
|
refund Try to cancel a swap and refund the BTC (expert users only)
|
|
resume Resume a swap
|
|
```
|
|
|
|
## Swapping BTC for XMR
|
|
|
|
Running `swap buy-xmr --help` gives us roughly the following output:
|
|
|
|
```
|
|
swap-buy-xmr 0.8.0
|
|
Start a BTC for XMR swap
|
|
|
|
USAGE:
|
|
swap buy-xmr [FLAGS] [OPTIONS] --change-address <bitcoin-change-address> --receive-address <monero-receive-address> --seller <seller>
|
|
|
|
FLAGS:
|
|
-h, --help Prints help information
|
|
--testnet Swap on testnet and assume testnet defaults for data-dir and the blockchain related parameters
|
|
-V, --version Prints version information
|
|
|
|
OPTIONS:
|
|
--change-address <bitcoin-change-address> The bitcoin address where any form of change or excess funds should be sent to
|
|
--receive-address <monero-receive-address> The monero address where you would like to receive monero
|
|
--seller <seller> The seller's address. Must include a peer ID part, i.e. `/p2p/`
|
|
|
|
--electrum-rpc <bitcoin-electrum-rpc-url> Provide the Bitcoin Electrum RPC URL
|
|
--bitcoin-target-block <bitcoin-target-block> Estimate Bitcoin fees such that transactions are confirmed within the specified number of blocks
|
|
--monero-daemon-address <monero-daemon-address> Specify to connect to a monero daemon of your choice: <host>:<port>
|
|
--tor-socks5-port <tor-socks5-port> Your local Tor socks5 proxy port [default: 9050]
|
|
```
|
|
|
|
This command has three core options:
|
|
|
|
- `--change-address`: A Bitcoin address you control. Will be used for refunds of any kind. You can also omit this flag which will refund any change to the internal wallet.
|
|
- `--receive-address`: A Monero address you control. This is where you will receive the Monero after the swap.
|
|
- `--seller`: The multiaddress of the seller you want to swap with.
|
|
|
|
## Discovering sellers
|
|
|
|
Running `swap list-sellers --help` gives us roughly the following output:
|
|
|
|
```
|
|
swap-list-sellers 0.8.0
|
|
Discover and list sellers (i.e. ASB providers)
|
|
|
|
USAGE:
|
|
swap list-sellers [FLAGS] [OPTIONS]
|
|
|
|
FLAGS:
|
|
-h, --help Prints help information
|
|
--testnet Swap on testnet and assume testnet defaults for data-dir and the blockchain related parameters
|
|
-V, --version Prints version information
|
|
|
|
OPTIONS:
|
|
--rendezvous-point <rendezvous-point> Address of the rendezvous point you want to use to discover ASBs
|
|
--tor-socks5-port <tor-socks5-port> Your local Tor socks5 proxy port [default: 9050]
|
|
```
|
|
|
|
Running `swap --testnet list-sellers --rendezvous-point /dns4/discover.unstoppableswap.net/tcp/8888/p2p/12D3KooWA6cnqJpVnreBVnoro8midDL9Lpzmg8oJPoAGi7YYaamE` will give you something like:
|
|
|
|
```
|
|
Connected to rendezvous point, discovering nodes in 'xmr-btc-swap-testnet' namespace ...
|
|
Discovered peer 12D3KooWPZ69DRp4wbGB3wJsxxsg1XW1EVZ2evtVwcARCF3a1nrx at /dns4/ac4hgzmsmekwekjbdl77brufqqbylddugzze4tel6qsnlympgmr46iid.onion/tcp/8765
|
|
+----------------+----------------+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+
|
|
| PRICE | MIN_QUANTITY | MAX_QUANTITY | STATUS | ADDRESS |
|
|
+====================================================================================================================================================================================================+
|
|
| 0.00665754 BTC | 0.00010000 BTC | 0.00100000 BTC | Online | /dns4/ac4hgzmsmekwekjbdl77brufqqbylddugzze4tel6qsnlympgmr46iid.onion/tcp/8765/p2p/12D3KooWPZ69DRp4wbGB3wJsxxsg1XW1EVZ2evtVwcARCF3a1nrx |
|
|
+----------------+----------------+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+
|
|
```
|
|
|
|
or this if a node is not reachable:
|
|
|
|
```
|
|
Connected to rendezvous point, discovering nodes in 'xmr-btc-swap-testnet' namespace ...
|
|
Discovered peer 12D3KooWPZ69DRp4wbGB3wJsxxsg1XW1EVZ2evtVwcARCF3a1nrx at /dns4/ac4hgzmsmekwekjbdl77brufqqbylddugzze4tel6qsnlympgmr46iid.onion/tcp/8765
|
|
+-------+--------------+--------------+-------------+----------------------------------------------------------------------------------------------------------------------------------------+
|
|
| PRICE | MIN_QUANTITY | MAX_QUANTITY | STATUS | ADDRESS |
|
|
+============================================================================================================================================================================================+
|
|
| ??? | ??? | ??? | Unreachable | /dns4/ac4hgzmsmekwekjbdl77brufqqbylddugzze4tel6qsnlympgmr46iid.onion/tcp/8765/p2p/12D3KooWPZ69DRp4wbGB3wJsxxsg1XW1EVZ2evtVwcARCF3a1nrx |
|
|
+-------+--------------+--------------+-------------+----------------------------------------------------------------------------------------------------------------------------------------+
|
|
```
|
|
|
|
## Automating discover and swapping
|
|
|
|
The `buy-xmr` and `list-sellers` command have been designed to be composed.
|
|
[This script](./discover_and_take.sh) is example of what can be done.
|
|
Deciding on the seller to use is non-trivial to automate which is why it is not implemented as part of the tool.
|
|
|
|
## Tor
|
|
|
|
By default, the CLI will look for Tor at the default socks port `9050` and automatically route all traffic with a seller through Tor.
|
|
This allows swapping with sellers that are only reachable with an onion address.
|
|
|
|
Disclaimer:
|
|
Communication with public blockchain explorers (Electrum, public XMR nodes) currently goes through clearnet.
|
|
For complete anonymity it is recommended to run your own blockchain nodes.
|
|
Use `swap buy-xmr --help` to see configuration options.
|