Mirror/robosats
1
0
Fork 0
mirror of https://github.com/RoboSats/robosats.git synced 2024-12-13 19:06:26 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
A simple and private bitcoin exchange
239 Commits 41 Branches 70 Tags 181 MiB
Python 64.4%
TypeScript 31.3%
Java 1.4%
CSS 1.1%
Kotlin 0.5%
Other 1.1%
777b9b42dd
Go to file
Reckless_Satoshi 777b9b42dd
Create how-to-use.md
2022-02-14 12:37:12 +00:00
.github/ISSUE_TEMPLATE Add concept for BTC <> Fiat p2p swap using Lightning. 2022-01-01 07:28:49 -08:00
api Merge branch 'stabilize-runtime' of github.com:Reckless-Satoshi/robosats into stabilize-runtime 2022-02-13 09:55:52 -08:00
chat Add expiration logics. Add dispute statements. 2022-01-16 13:54:42 -08:00
dev_utils Work on update order endpoint and taker requests 2022-01-04 16:13:08 -08:00
docker Dev testnet lnd auto unlock 2022-02-09 12:51:05 -08:00
docs Create how-to-use.md 2022-02-14 12:37:12 +00:00
frontend Typo robosat -> robot. Shorten welcome back msg 2022-02-13 09:55:44 -08:00
robosats Fix taker bond is not return on maker cancel. Update all libs. Add extra hosts. 2022-02-13 16:43:49 +00:00
.editorconfig Initialize the Django project and write setup guide 2022-01-01 10:53:17 -08:00
.env-sample Merge branch 'stabilize-runtime' of github.com:Reckless-Satoshi/robosats into stabilize-runtime 2022-02-13 09:55:52 -08:00
.gitignore Init dockerization of dev environment with docker-compose 2022-02-07 03:21:59 -08:00
CONTRIBUTING.md Add concept for BTC <> Fiat p2p swap using Lightning. 2022-01-01 07:28:49 -08:00
docker-compose.yml Fit for daphne + gunicorn. Docker default command runs dev node. 2022-02-10 11:28:59 -08:00
Dockerfile Fix taker bond is not return on maker cancel. Update all libs. Add extra hosts. 2022-02-13 16:43:49 +00:00
LICENSE Add concept for BTC <> Fiat p2p swap using Lightning. 2022-01-01 07:28:49 -08:00
manage.py Initialize the Django project and write setup guide 2022-01-01 10:53:17 -08:00
README.md Update README.md 2022-01-31 15:45:52 +00:00
requirements.txt Fix taker bond is not return on maker cancel. Update all libs. Add extra hosts. 2022-02-13 16:43:49 +00:00
setup.md Fit for daphne + gunicorn. Docker default command runs dev node. 2022-02-10 11:28:59 -08:00

README.md

RoboSats - Buy and sell Satoshis Privately

release AGPL-3.0 license Telegram

RoboSats is a simple and private way to exchange bitcoin for national currencies. Robosats simplifies the peer-to-peer user experience and uses lightning hold invoices to minimize custody and trust requirements. The deterministically generated avatars help users stick to best privacy practices.

Try it out

Bitcoin mainnet:

  • Tor: robosats6tkf3eva7x2voqso3a5wcorsnw34jveyxfqi2fu7oyheasid.onion (Coming soon)
  • Url: robosats.com (Coming soon)
  • Version: v0.0.0 (Last stable)

Bitcoin testnet:

  • Tor: robotestagw3dcxmd66r4rgksb4nmmr43fh77bzn2ia2eucduyeafnyd.onion (Active - On Dev Node)
  • Url: testnet.robosats.com (Coming soon)
  • Latest commit.

Always use Tor Browser and .onion for best anonymity.

How it works

Alice wants to buy satoshis privately:

  1. Alice generates an avatar (AdequateAlice01) using her private random token.
  2. Alice stores safely the token in case she needs to recover AdequateAlice01 in the future.
  3. Alice makes a new order and locks a small hold invoice to publish it (maker bond).
  4. Bob wants to sell satoshis, sees Alice's order in the book and takes it.
  5. Bob scans a small hold invoice as his taker bond. The contract is final.
  6. Bob posts the traded satoshis with a hold invoice. While Alice submits her payout invoice.
  7. On a private chat, Bob tells Alice how to send him fiat.
  8. Alice pays Bob, then they confirm the fiat has been sent and received.
  9. Bob's trade hold invoice is charged and the satoshis are sent to Alice.
  10. Bob and Alice's bonds return automatically, since they complied by the rules.
  11. The bonds would be charged (lost) in case of unilateral cancellation or cheating (lost dispute).

Contribute to the Robotic Satoshis Open Source Project

See CONTRIBUTING.md

Original idea

The concept of a simple custody-minimized lightning exchange using hold invoices is heavily inspired in P2PLNBOT by @grunch

License

The Robotic Satoshis Open Source Project is released under the terms of the AGPL3.0 license. See LICENSE for more details.