A simple and private bitcoin exchange
Go to file
okada-blue ed062416db
Edit Multiple docs (#712)
* Update 01-development.md

Update Communication Channels channels to reflect removal of Twitter and Telegram, and emphasize SimpleX, Nostr, and Matrix chats

* Update 02-languages.md

Update Telegram verbiage to reference SimpleX instead.

* Update 04-guides.md

Update Telegram verbiage to reference SimpleX instead.

* Update 05-art.md

Update Telegram verbiage to reference SimpleX instead.

* Update 06-outreach.md

Update Twitter verbiage and reference Nostr instead

* Update 00-quicks-start-guide.md

Update verbiage slightly. Add more info and links.

* Update 01-lightning.md

Add rough draft to provide overview of Lightning Network and its relation to RoboSats

* Update 02-tor.md

Provide rough draft of introduction to TOR.

* Update 03-access.md

Add access method via Android app APK. Adjust slight typos and some wording for clarity.

* Update 01-trade-pipeline.md

Add TOC, swap steps and pictures placement, adjust small typos and wording.

Picture was swapped with the steps because I think the picture can be slightly overwhelming versus a simple list of steps. The pictures are great but they are a lot to throw at someone right when they open the very first doc under "Understand" to learn about RoboSats.

* Update 02-robots.md

Clean up hyperlinks, adjust grammar slightly.

* Update 03-premium.md

Update verbiage, adjust grammar slightly.

* Update 03-premium.md

Add paragraphs on advice for choosing a premium

* Update 04-bonds.md

Various changes to verbiage and adding/updating information. Grammar fixes, remove reference to Telegram.

* Update 05-trade-escrow.md

Clean up hyperlinks, adjust some wording

* Update 06-disputes.md

Rough draft of disputes section. Committed changes are a placeholder for a longer and more detailed version of the dispute process.

* Update 07-wallets.md

Fix typos, grammar edits, add new section at bottom

* Update 08-limits.md

Rough draft of new content in the limits docs

* Update 09-swaps.md

Adjust "on-chain" to "on chain" and "sats" to "Sats" for consistency across other docs. Slight grammar fixes.

* Update 10-telegram.md

Small grammar fixes, clean up formatting and add table of contents

* Update 12-prices.md

Add verbiage note about explicit pricing method, clean up hyperlinks

* Update 13-fees.md

Clean up hyperlinks, small spelling fixes

* Update 14-on-chain-payouts.md

Add table of contents, small grammar fixes, adjust formatting

* Update 07-wallets.md

Change "on chain" to "on-chain"

* Update 09-swaps.md

Change "on chain" to "on-chain"

* Update 02-tor.md

Add note when using TOR and experiencing connection issues
2023-07-24 17:50:17 +00:00
.github Fix dependabot to increase versions in package.json too 2023-07-16 14:09:05 -07:00
api Add criptoya.com api to price providers (#748) 2023-07-24 17:49:55 +00:00
chat Simplify coordinator updates, automatic migrations and collect statics (#583) 2023-05-15 09:46:59 +00:00
control Simplify coordinator updates, automatic migrations and collect statics (#583) 2023-05-15 09:46:59 +00:00
docker Bump CLN to v23.05.2 and LND to v0.16.3-beta 2023-07-08 09:38:29 -07:00
docs Edit Multiple docs (#712) 2023-07-24 17:50:17 +00:00
frontend Update communities dialog (#749) 2023-07-24 11:26:52 +00:00
mobile Limit pinch to zoom gesture on Android 2023-07-24 02:44:29 -07:00
nodeapp Add selfhosted client custom builds (#630) 2023-05-29 15:58:12 +00:00
robosats Add keysend devfund donations functionality (#589) 2023-05-16 17:12:15 +00:00
scripts Update changelog, fix release workflow, re-sync package-lock 2023-05-29 11:22:41 -07:00
.dockerignore Add googleapis folder to .dockerignore (lighter coordinator image) 2023-04-23 07:46:19 -07:00
.editorconfig Fix all files with pre-commit 2022-10-25 11:04:12 -07:00
.env-sample Add criptoya.com api to price providers (#748) 2023-07-24 17:49:55 +00:00
.flake8 Simplify coordinator updates, automatic migrations and collect statics (#583) 2023-05-15 09:46:59 +00:00
.gitignore Fix android sound notifications 2023-05-27 06:04:59 -07:00
.pre-commit-config.yaml Add collect_phrases pre-commit hook; run new collect phrases (#610) 2023-05-22 08:26:48 +00:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2022-07-23 14:50:31 +00:00
commit_sha Add placeholder commit_sha 2023-05-19 04:45:22 -07:00
CONTRIBUTING.md Rename repository 2023-05-09 06:07:16 -07:00
docker-compose.yml Add core-lightning as backend lightning node vendor (#611) 2023-05-22 14:56:15 +00:00
Dockerfile Bump python from 3.11.3-slim-bullseye to 3.11.4-slim-bullseye (#661) 2023-06-16 17:03:23 +00:00
LICENSE Add concept for BTC <> Fiat p2p swap using Lightning. 2022-01-01 07:28:49 -08:00
manage.py Re-format all python code 2022-02-17 11:50:10 -08:00
pyproject.toml Python files style cleanup (#281) 2022-10-20 09:55:24 +00:00
README.md Add Reviews section to home in learn.robosats (#605) 2023-05-23 21:49:45 +00:00
release_notes.md Update changelog, fix release workflow, re-sync package-lock 2023-05-29 11:22:41 -07:00
requirements.txt Bump gunicorn from 20.1.0 to 21.2.0 (#744) 2023-07-23 19:31:13 +00:00
setup.md Simplify coordinator updates, automatic migrations and collect statics (#583) 2023-05-15 09:46:59 +00:00
version.json Bump to v0.5.1 2023-05-26 06:02:57 -07:00

RoboSats - Buy and sell Satoshis Privately

Coordinator CI Frontend Build 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

Always use Tor Browser and .onion for best privacy. The Clearnet URL redirects to a third party Tor2web service. Your privacy cannot be guaranteed to be respected. Use clearnet only to check around the app, never use for trading!

How to use it

https://user-images.githubusercontent.com/90936742/167310017-dc211a05-dd5e-4ef4-b93f-250f80bc5bca.mp4

Written guides

Video guides

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

Check out our Contribution Guide to find how you can make RoboSats great.

Developer Rewards

Check out the Developer Rewards Panel for tasks paid in Sats.

Sponsors

Reviews

Inspiration

The concept of a simple custody-minimized lightning exchange with hold invoices is 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.