Due to the growing need to be able to operate with Bitcoin without giving up personal data, in 2021 I started a project to allows people to buy and sell Bitcoin through Lightning Network without funds custody and without KYC, this project is a telegram bot called @lnp2pbot.
@lnp2pBot is growing steadily and organically, it's being use in the whole world and is having a bigger impact in Latin-America, a place where there is no need to explain to people that money is broken, it's being used more and more in dictatorial regimes like Cuba and Venezuela, where people keep resisting tyranny and protesting using less the local currency and more Bitcoin.
Although the bot works excellent, it's running on top of Telegram, a great platform but we do not know if one day it will be reached by the tentacles of a powerful government asking for political dissidents or simply awkward public person.
At this point Nostr appears as a platform where a system like this can live without the possibility of being censored by a powerful entity. This document explains how we can create a censorship-resistant and non custodial lightning network peer-to-peer exchange without a single point of failure like a telegram bot.
Mostro works with a p2p communication on top of Nostr, Mostro will be the escrow that will allow buyer and seller operate reducing the risk for both parties.
Mostro will handle Bitcoin using a Lightning Network node, the node will create the hold invoices for sellers to pay and pays to the buyers lightning regular invoices.
Mostro will need a private key to be able to create, sign and send events through Nostr network.
In the next graphic we can see a very summarized version of how Mostro, the seller and the lightning node interact, a more detailed explanation can be found here:
sequenceDiagram
autonumber
Seller->>Mostro: I want to sell Bitcoin
Mostro-->>LN-Node: Give me a hold invoice
LN-Node->>Mostro: Hold invoice
Mostro->>Seller: Please pay this hold invoice
Seller->>LN-Node: Paying through lightning
LN-Node-->>Mostro: Payment received
Mostro-->>Seller: Thanks! talk to buyer now
In this repository we are building a Mostro daemon on Rust.
Buyers and sellers will need Mostro's clients in order to buy/sell Bitcoin and a Lightning Wallet, for this we need to build at least a web client to start, we plan to build mobile and desktop clients in the future.
For this idea to work we need to make it as easy as possible for anyone to be a Mostro, we don't need dozens of Mostros but we do need the ones that are running to be reliable, that's why with this implementation we encourage to create your own Mostro and give more options to users.
To handle a Mostro is not going to be that easy, a Mostro admin needs to have a lightning node up and running, it will need to have enough liquidity for users to operate lightning fast, the node MUST have uptime closer to 99.9%, all this requires resources that can be obtained by the fee that sellers pay on each successful order, this is a percentage that can vary between Mostros.
Users will be able to rate Mostros and Mostros will compete to obtain more users in order to survive. Bad Mostros should be rejected by users and will lose incentives to keep existing.
- You need Rust version 1.74 or higher to compile.
- You will need a lightning network node.
To compile on Ubuntu/Pop!_OS, please install cargo, then run the following commands:
sudo apt update
sudo apt install -y cmake build-essential libsqlite3-dev pkg-config libssl-devTo compile on Mac, then use brew:
brew update
brew install cmake pkg-config openssl sqlite3If you want to run Mostro on your local machine, you can follow the instructions below, if you want to run it on a server, you can follow the instructions in the INSTALL.md file.
Clone the repository and then create a new settings.toml file based on settings.tpl.toml file.
git clone https://github.com/MostroP2P/mostro.git
cd mostro
cp settings.tpl.toml settings.tomlTo connect to an LND node, you must define 3 variables within the [lightning] section of the settings.toml file.
lnd_cert_file: LND node TLS certificate file path.
lnd_macaroon_file: Macaroon file path, the macaroon file contains permission for doing actions on the lnd node.
lnd_grpc_host: IP address or domain name from the LND node and port, example: https://127.0.0.1:10009.
The data is saved in a sqlite db file named by default mostro.db, this file is saved on the root directory of the project and can be change just editing the url var on the [database] section in settings.toml file.
Before start building we need to initialize the database, for this we need to use sqlx_cli:
cargo install sqlx-cli --version 0.6.2
./init_db.shBefore running it you need to set nsec_privkey in the [nostr] section of the settings.toml file with the private key of your Mostro, if you don't have a nostr private key you can use rana 🐸 to generate a new one.
You must create a .mostro directory in /home/user/ and copy the settings.toml and mostro.db files inside.
mkdir $HOME/.mostro/ && cp settings.toml mostro.db $HOME/.mostro/Finnaly run it:
cargo runcd docker
docker compose up nostr-relayThis will spin a new docker container with an instance of nostr-rs-relay, that will listen at port 7000.
So the relay URL you want to connect to is: ws://localhost:7000.
You need to set relays in the [nostr] section of the settings.toml file:
relays = ['ws://localhost:7000']
If in the relay logs the error appears: unable to open database file: /usr/src/app/db/nostr.db you need to modify the compose.yml file in the docker directory with:
services:
mostro:
build:
context: ..
dockerfile: docker/Dockerfile
volumes:
- ./config:/config # settings.toml and mostro.db
platform: linux/amd64
networks:
- default
nostr-relay:
image: scsibug/nostr-rs-relay
container_name: nostr-relay
ports:
- '${MOSTRO_RELAY_LOCAL_PORT:-7000}:8080'
volumes:
- 'mostro_data:/usr/src/app/db:Z'
- './config/relay/config.toml:/usr/src/app/config.toml:ro,Z'
networks:
default:
driver: bridge
volumes:
mostro_data:You just need to set relays in the [nostr] section of the settings.toml file with the relays you will use.
If you want to run a dockerized version of Mostro, you can follow the step-by-step instructions in the Docker Guide for MostroP2P.
You may be interested in contributing to Mostro. If you're looking for somewhere to start contributing, check out the good first issue list.
More info in our contributing guide.
To incentivize collaborators we have a Rewards board, we must clarify that Mostro is not a company but an open source project, the amounts offered are a way to thank for collaboration and we can offer it thanks to the generous donation of contributors, mostly anonymous, but also to two important institutions that have given us grants, you can check it here.
- Protocol documentation: https://mostro.network/protocol
- Frequently Asked Questions: in English, in Spanish.
Mostro is licensed under the MIT license.