TannhauserGate 0.2.9.dev0

P2P Cross Chain Atomic Swap

Tannhauser Gate Atomic Swap

Video Showcase (YouTube)

Installation

python3 -m venv venv
. venv/bin/activate
pip install TannhauserGate
tannhauser

Depends

Tannhauser Gate depends at Tor, BitcoinCore and LitecoinCore. Please install it first. You will find sample config files here.

Showcase

1. Start the client and connect to Tannhauser Gate:

   

2. Take a look at the current conditions like rates, minimum/maximum and the minimum bond:

   

3. Load your wallet. First time users have to initiate a new wallet and fund it:

   

4. Initiate your atomic swap and choose your direction. In this showcase we swap Bitcoin for Litecoin:

   

5. Enter the amount you want to swap:

   

6. After hitting OK you will get an updated summary of your atomic swap with all relevant data:

   

7. If you feel fine hit "Send". After this you get a success message and the transaction ID:

   

8. Save your swap:

   

9. Now you can lean back, grab a coffee and enjoy an automatic atomic swap. The client will check your swap every minute. You have nothing to do - at this point all runs automatically. You can "PAUSE" the check at any time but its not recommended. First we have to wait for the bond confirmation:

   

10. If confirmed Tannhauser Gate will send the Litecoin amount:

    

11. Your client check this Litecoin transaction and send the leftover amount to your swap HTLC address after one confirmation:

    

12. At this point you have send the complete amount you want to swap. Tannhauser Gate will wait for one confirmation:

    

13. After one confirmation Tannhauser Gate will withdraw the bond and swap amount and the secret will be revealed to the blockchain:

    

14. The client extract the secret from the transaction and withdraw the Litecoin funds from the HTLC address:

    

15. A quick balance check shows the newly arrived Litecoin funds:

    

Transactions:

Action	TXID
Client Bond	https://chain.so/tx/BTC/1242b63342d6222a55cfb7c339142acb3e23937b255aeb108a6783ddad56b07c
TG Funding	https://chain.so/tx/LTC/b9bf6e608636560084f0abdb2a552feaaa18452439c90c0c38abc77c0976fddc
Client Funding	https://chain.so/tx/BTC/756c491c236a1ff87feb10f72001fc2450f1815333b38995f23daf034e17fdb0
TG Bond withdraw	https://chain.so/tx/BTC/503ba2a313de754ee850340dd8aac601df11c3586d115abd8c647ce34bf3e46c
TG Swap withdraw	https://chain.so/tx/BTC/24872849fef2f7ee6a284b675eb28c9d2a16bf8b550f586cd185004588dcdf14
Client withdraw	https://chain.so/tx/LTC/9349b37068f8cffb04d7327c2d92930f3d7771999e31d2e8362c8bb03d7a23f0

FAQ:

How to get the secret:

The different results:

All went fine:

Case: The amount is less than agreed or not in time. Result: Swap failed. You lost your Bond. Swap refund is possible:

Case: You dont send the swap amount at all. Result: Swap failed. You lost your Bond. No refund possible:

Case: For any reason Tannhauser dont accept the swap. Result: Swap failed. Bond refund possible:

Configuration

Notes

Tannhauser Gate is a simple POC for an automatic atomic swap service. Tannhauser is still in development mode - so use it at your own risk. For the Litecoin connection Tannhauser uses a customized version of python-bitcoinlib. There is a simple GUI as wrapper for easy handling. The GUI is a little bit guerrilla - but it does the job. So if you are a QT wizard - feel free to make a PR. The GUI uses a different (additional) library for RPC in contrast to the CLI. For some reason the GUI produces a broken pipe error at irregular intervals and I don't have time to look into it at the moment. The main goal of the development is a simple p2p client, where the user can be both maker and taker. Until then you can swap smaller amounts with Tannhauser. For Tannhauser there is a general refund window of 2 hours. Refunds for the user are possible after 1 hour or after 2 hours (Bond).

Donations

I do not accept donations. If you have some sats left donate them to the Torproject or to the EFF.