Quick Start 🚀

On this site, you'll find information on how to use Mostro, a peer-to-peer (P2P) bitcoin exchange platform on the Lightning Network for any local currency. It operates on Nostr and does not require KYC procedures.

Quick Start Guide 🚀

1. Have a Lightning Network-compatible wallet.

2. Open any Mostro client.

3. Follow the instructions of the client:

   • Log in with a Nostr key; some Mostro clients will create one for you!
   • Find or create bitcoin buy/sell offers.
   • Wait for an interested user.
   • If you're buying sats, provide the invoice where you will receive the sats.
   • If you're selling sats, pay the hold invoice (the sats will remain locked in your wallet until the end of the process).
   • Talk to your counterparty. Agree on how to exchange the fiat. This is a private process.
   • Complete the exchange.
   • If your counterparty does not respond, start a dispute.
   • Rate your counterparty. You will also be rated.

Recommendations

• If you have any questions not answered in this documentation, feel free to ask our community.

• Report bugs or suggest improvements in our GitHub repositories.

• Follow us on Nostr and X to keep up with major announcements.

Frequently Asked Questions

Continue reading this documentation to understand what Mostro is, how it works, and how you can use it.

What is Mostro?

Mostro is a peer-to-peer (P2P) bitcoin exchange platform on the Lightning Network for any local currency, operating on the Nostr protocol and not requiring Know Your Customer (KYC) procedures.

It uses hold invoices as an escrow system to provide security for the exchange of sats, minimizing custody and reducing the trust needed in both the counterparty and Mostro.

By operating on Nostr, a communication protocol designed to be censorship-resistant due to the decentralization of its infrastructure, Mostro ensures that it is very difficult to block bitcoin exchanges, censor the posting of buy and sell offers, or hinder communication between users involved in an exchange. Additionally, as more Mostro nodes become active, combined with Nostr's inherent decentralization, it will become increasingly difficult to stop P2P bitcoin exchanges without KYC.

Origin of Mostro

Mostro is inspired by @lnp2pBot, a Telegram bot created in 2021 to facilitate bitcoin exchange via the Lightning Network without surrendering personal data, without custody of funds, and without KYC. The bot has grown steadily and organically, with global reach and a particularly significant impact in Latin America, where the population faces financial challenges and finds an alternative in bitcoin. It has also gained popularity in countries under authoritarian regimes, such as Cuba and Venezuela, where people use bitcoin to resist tyranny and reduce their dependence on local currency.

Although the @lnp2pBot operates efficiently, it functions on Telegram, a platform that, while offering many advantages, could potentially come under pressure from powerful governments seeking to pursue political dissidents or inconvenient public figures. In this context, Nostr emerges as an ideal alternative, allowing an exchange system like Mostro to operate without the risk of censorship by powerful entities, thus ensuring greater privacy and security for users.

What do I need to use Mostro?

To use Mostro, all you need is a Lightning Network-compatible wallet.

You don't have to be an expert in Nostr. If you are, great! But if not, you can still use Mostro without any issues, as it is designed to be simple and intuitive for all users.

To perform bitcoin exchanges, you'll use a Mostro client. Although each client has its own features, in most of them, you won't need to have a pre-created Nostr private key. To ensure the security and privacy of your transactions, the client should automatically generate a new private key each time you perform a bitcoin exchange, without the need for additional setup or interventions on your part.

Do I need to register or do KYC?

NO! Bitcoin was born as "a peer-to-peer electronic cash system," and we are proud to support that principle. None of your personal data is required. Additionally, Mostro nodes do not have access to conversations between users, so it is not possible to collect any personal information. You can find more information about how your privacy is protected on Mostro here.

How does Mostro work?

To understand how Mostro works, it is important to know its components:

• Mostro daemon (Mostrod): Manages communication between users and the Lightning Network (LN) node. It publishes Nostr events, executes actions sent by users, and guides them through the exchange process.

• Lightning Network node associated with the Mostrod node: Creates and manages the hold invoices that sellers must pay and makes payments for the invoices provided by buyers.

• Mostro clients: These are the applications that users interact with directly. They provide the communication interface between Mostrod and the users. The clients send Mostrod the actions performed by users, such as creating an order, opening a dispute, releasing sats, among others. They are also responsible for generating and handling users' private keys.

The following diagram summarizes how Mostrod, the seller (via a Mostro client), and the LN node interact:

Bitcoin Sale Flow on Mostro

• Seller: Alice
• Buyer: Bob

1. Order creation:
   Alice accesses a Mostro client and decides to post an order to sell 5000 sats for 3 USD, to receive payment on her XYZ card. The interface for creating the order will depend on the client she uses. The order is posted in an order book that can be accessed from any Mostro client. If another user does not take the order within 24 hours, it will be automatically deleted.

2. Order taken by the buyer:
   Bob, interested in buying sats, accesses a Mostro client (not necessarily the same one Alice used). He finds the offer of 5000 sats for 3 USD and decides to take it. He is then asked to provide an invoice for 5000 sats within 15 minutes. Bob generates the invoice in his LN wallet and sends it to Mostro, who instructs him to wait 15 minutes for his counterparty to respond.

3. Payment and communication between parties:
   Alice receives a message from Mostro notifying her that someone has taken her offer and that she must pay a hold invoice for 5000 sats within 15 minutes. If she does not make the payment, the order will be canceled. Once Alice pays the invoice, Mostro reveals Bob’s public key to Alice and vice versa, allowing them to start a private chat. At this point, Alice must provide Bob with the number of her XYZ card to receive the fiat payment. When Bob sends her the 3 USD, he presses the fiat sent button in his Mostro client. Alice receives a notification to verify receipt of the fiat and then release the sats to Bob.

4. Sats release:
   When Alice confirms she received the 3 USD, she presses the release button in her Mostro client. Then Mostro will collect the 5000 sats from Alice's wallet and pay Bob's invoice. Finally, Mostro will ask both parties to rate their counterparty.

When Mostro connects both users, the time they have to complete the exchange is limited by the duration of the hold invoice provided by the Mostro node they are using. Users must respect this time frame; for more information, see here.

If during the process, Alice and Bob decide not to proceed with the exchange, they can cancel the order cooperatively. If either party attempts to cancel arbitrarily or defraud the other, the other party can open a dispute.

Note: In this example, it is assumed that Mostro’s fees are 0. For more information on fees, see Exchange Fees and Limits.

Technical Explanation

1. Alice creates the order:
   When Alice creates the sale offer, her Mostro client should automatically generate a new Nostr private key that Alice will use only for that order (a new private key should always be generated for each order to protect users’ privacy). Using that key, Alice sends a NIP-59 message to Mostrod with the order details. Then, Mostrod publishes an addressable event of type 38383, with the order details and its status: pending. Mostro clients monitor these events and display those orders with pending status in their order books.

2. Bob takes the order:
   When Bob takes the order, his Mostro client automatically generates a new Nostr private key for this order, then sends a NIP-59 message to Mostrod indicating that he has taken that offer. Mostrod publishes a new event 38383 for that order, this time with the status waiting-buyer-invoice, which removes the order from all clients' order books as it is no longer pending. Mostrod sends Bob a NIP-59 message requesting an invoice for 5000 sats. Bob sends the invoice to Mostrod in a NIP-59 message, and then Mostrod publishes an event 38383 for that order, this time with the status waiting-payment.

3. Alice pays the hold invoice:
   Mostrod sends Alice a NIP-59 message with the hold invoice generated by the associated LN node. If Alice pays within the 15 minutes, Mostro sends her a NIP-59 message revealing Bob's pubkey, and another message to Bob revealing Alice's pubkey. Additionally, it updates the event 38383 for this order with the status active. Now, Alice and Bob can communicate directly through encrypted messages using the NIP-44 algorithm, and Mostrod does not receive any of those messages. When Bob makes the fiat payment and presses fiat sent in his client, he sends a NIP-59 message with the fiat-sent action to Mostrod, who in turn sends a NIP-59 message to Alice with that same action, and her client displays a release button to release the sats if she has received the payment. Mostrod also publishes an event 38383 for that order with the status fiat-sent.

4. Alice releases the sats:
   When Alice presses the release button in her client, she sends a NIP-59 message to Mostrod indicating that the sats should be released to Bob. Then, the LN node associated with that Mostrod node settles the payment of the hold invoice and pays the invoice provided by Bob. At the end of the process, Mostrod publishes an event 38383 for that order with the status success and sends a NIP-59 message to Alice and Bob, requesting that they rate their counterparty, who send back their rating through a NIP-59 message.

For more details on the communication between Mostrod and its clients, you can read here.

Accepted Currencies and Payment Methods

Mostro is a peer-to-peer (P2P) exchange, so it technically supports any currency and payment method, as long as there is a counterparty willing to make the trade.

However, each Mostro node operator can decide which fiat currencies to enable on their node. Before trading, make sure the node you choose supports the currency you want to trade with.

Mostro uses yadio.io as a reference for currency prices, which allows the exchange of over 90 currencies listed on that platform. If your currency does not appear on yadio.io, you can request them to add it. If this is not possible, you can still use Mostro by creating an order with a fixed amount of sats in exchange for a fixed amount of your currency.

If your currency is not available on any existing node or does not appear as an option in the clients, you have two paths:

• Contact the administrator of an unrestricted node to explore the possibility of adding it
• Run your own Mostro node for your community, with the currencies and payment methods you need

Exchange Fees and Limits

Each operator of a Mostro node can set their own fees and limits per transaction, fostering competition among different nodes and allowing users to select the one that best suits their needs.

Fees

Fees are charged to both the buyer and the seller for each completed transaction. The exact percentage depends on the Mostro node you use.

The Mostro node currently active on mainnet (npub1stagewtcks78nvs4vkzm4skqzytk5gwj46kkm8mu2awqqklgswgqfvtamr) charges a 0.3% fee to both the buyer and the seller.

Limits

Each node also defines the minimum and maximum amounts allowed per transaction. The main node on mainnet allows exchanges from 100 sats to 20,000 sats per operation.

Multiple Mostro Nodes

Mostro is designed to be a decentralized system where multiple operators can run their own nodes. This means that:

• There is competition among nodes to offer the best service
• Each operator defines their own fees, limits, and accepted currencies
• Users are free to choose which node to trade on
• If one node goes down, others remain available

Development Contribution

Each Mostro node automatically contributes a percentage of its earnings to the project's development fund. This contribution comes from the operator's earnings and is not charged extra to users.

This system ensures the sustainability of Mostro's development in a transparent way: all contributions are published as events on Nostr and can be verified by anyone.

For more details on how this system works, you can read the full article: Sustainable Funding for Mostro Development

Can I cancel an order?

If you created an order and it hasn't been taken yet, you can cancel it.

If the order has already been taken, or if you have taken an order and decide not to proceed, you will need to initiate a cooperative cancellation with your counterparty. If both parties agree, Mostro will cancel the hold invoice paid by the seller, and the sats will be returned to them.

In case your counterparty does not want to cancel, you can initiate a dispute.

Hold Invoices: Security of Exchanges on Mostro

Mostro uses hold invoices as an escrow mechanism to secure the funds of a transaction, protecting the buyer from potential fraud or non-payment. At the same time, it ensures the seller's security by not directly holding their funds.

To sell sats through Mostro, you must pay the hold invoice that will be provided to you. Hold invoices are a type of Lightning Network invoice that allows the "locking" of the sats you intend to sell in your wallet, without settling the payment until the transaction with your counterparty is completed. Depending on the wallet you use, you might see your payment as "queued", "frozen", "in flight", or "pending".

Once the seller of sats notifies Mostro that they have received the fiat, the hold invoice payment is automatically settled: the sats will be "unlocked" and collected by the Lightning Network node of Mostro used for the exchange. Then, the corresponding fee will be deducted, and an attempt will be made to pay the invoice provided by the buyer immediately. If the payment fails, Mostro will request a new invoice from the buyer and repeat the process until the payment is completed successfully.

Mostro minimizes the custody time of users' funds, limiting it only to the period from when the hold invoice is collected from the seller until it is paid to the buyer, a process that can take only a few seconds.

The hold invoice payment may also be settled if users enter a dispute and the administrator determines that the sats should be transferred to the buyer. Conversely, if the administrator decides that the order should be canceled, the hold invoice payment will be canceled, and the sats will be "unlocked" in the seller's wallet, without ever leaving it. This will also occur if a cooperative cancellation is made, or if the validity time of the hold invoice, which is limited, is exceeded.

The hold invoices generated by the Lightning Network node of the Mostro node currently active on mainnet (npub1stagewtcks78nvs4vkzm4skqzytk5gwj46kkm8mu2awqqklgswgqfvtamr) have an approximate validity period of 24 hours.

Exchange Times

Mostro is designed for bitcoin-to-fiat exchanges to be fast, so it is recommended to use instant fiat payment methods.

Each Mostro node operator can set their own time frames for each step of the exchange, fostering competition among Mostro nodes and allowing users to select the one that best fits their needs.

Below are the specific time frames for the Mostro node currently active on mainnet (npub1stagewtcks78nvs4vkzm4skqzytk5gwj46kkm8mu2awqqklgswgqfvtamr). As more Mostro nodes become available, this information should be accessible to users so they can choose their preferred one.

When an offer is posted, it remains in the order book for 23 hours. If no one takes it within that time, it will be automatically deleted.

Once someone takes an offer, they have up to 15 minutes to either pay the hold invoice if they are the seller or provide an invoice if they are the buyer. If they do not complete their part within that time frame, the order will be automatically reposted. However, if they do, then the counterparty will have up to 15 minutes to complete their corresponding action (either paying the hold invoice or providing an invoice, depending on their role in the exchange); if they fail to do so, the order will be canceled and not reposted.

After the seller pays the hold invoice and the buyer provides their invoice, they have until the expiration of the hold invoice provided by Mostro to finalize the exchange. For the Mostro node npub1stagewtcks78nvs4vkzm4skqzytk5gwj46kkm8mu2awqqklgswgqfvtamr, this period is approximately 24 hours. During this time, the buyer must send the fiat payment, and the seller must release the sats upon confirming receipt of the fiat. If this time frame is exceeded, the order will expire, and the sats will be returned to the original wallet without Mostro being able to intervene. For this reason, it is recommended to only use instant fiat payment methods.

Within this validity period, users can successfully complete the exchange, cancel it cooperatively, or open a dispute. After the hold invoice expires, Mostro has no ability to intervene in that order.

If both participants in a transaction are online and use instant fiat payment methods, the transactions can be completed almost instantly.

Reputation System

Upon successfully completing a purchase or sale of sats, Mostro will ask you to rate your counterparty, and your counterparty will also rate you. The reputation system uses a 5-star rating scale, where 1 star represents the lowest rating and 5 stars the highest, allowing you to evaluate the transaction experience.

Reputation in Mostro is calculated iteratively, combining the mean and standard deviation of ratings and successful transactions. This means that during your first transactions, even if you receive maximum ratings, your initial reputation will not be very high; instead, it will progressively increase as you accumulate more successful transactions with good evaluations.
This calculation is based on: https://math.stackexchange.com/questions/2148877/iterative-calculation-of-mean-and-standard-deviation.

Dispute Management

If your counterparty is unresponsive, you suspect a scam attempt, or a misunderstanding arises that you are unable to resolve, you can initiate a dispute.

How It Works

When you start a dispute, you will be attended to by the administrator of the Mostro node you are using, or by a person designated by that administrator (solver). Upon opening the dispute, Mostro will provide you with a unique token number, and your counterparty will receive a different one. Both tokens will be revealed to the administrator handling the dispute. When the administrator contacts you and your counterparty, they will tell you your token, allowing you to verify that they are the designated person and ensuring they are not an impostor.

Resolution

There is no standard method for resolving disputes across all Mostro nodes. Each administrator can decide how to manage disputes generated in their node and what evidence to request from users to make the most appropriate decision.

When the administrator decides which user is in the right, they will have Mostro release the sats to the appropriate user. Administrators do not charge any extra fee for resolving disputes.

Chat Evidence

During a trade, the buyer and the seller communicate through an end-to-end encrypted chat. This chat generates a "shared master key" known only to both parties.

If a dispute arises, either party can choose to voluntarily share this key with the solver. With it, the solver can access a copy of the conversation that cannot be altered or deleted. This allows disputes to be resolved fairly, exposing any attempted deception. For more details on how this privacy system works, see the Privacy in Mostro section.

Important Timeframes

Disputes are never opened automatically. The users involved must initiate them before the hold invoice paid by the seller expires, so that the administrator has enough time to request evidence from both parties and make an appropriate decision.

Time continues to run from when the order was accepted and does not stop when a dispute is opened. The administrator must resolve it before the time expires, so users should not wait too long to initiate one. You can read more about timeframes here.

Privacy in Mostro

User Communication Privacy with Mostro

Communication between Mostrod and users takes place through Mostro clients using NIP-59 events. Within these events, the content and the public key of the sender are encrypted with an ephemeral key, preventing the public revelation of the identity of those interacting with Mostro. To enhance privacy, Mostro clients automatically generate a new private key for users for each order they take or create. This way, when Mostrod sends NIP-59 events to users, the generated event will display a public key that is used only for that operation, ensuring a new "identity" for each exchange and preventing buy and sell transactions from being linked to a single person.

Mostro clients will never share users’ private keys with a Mostro node or its administrator under any circumstances.

Reputation Mode

Mostro offers users the option to operate in a reputation mode. In this mode, users identify themselves to the Mostro node they are using with a fixed public key that acts as a primary identifier, allowing that node to associate a reputation with the user based on ratings received from their counterparts after completing transactions. Although this public key is known to that particular Mostro node, it is not shared with other users or exposed publicly, thereby preserving individual privacy. In this mode, each new order continues to use ephemeral keys, protecting the details of each exchange from third parties.

Full Private Mode

For users who prioritize privacy above all else, Mostro offers full private mode. In this mode, users do not send any fixed identifying key to the Mostro node they use. Instead, each transaction exclusively uses ephemeral keys generated for that specific exchange. This means that the Mostro node has no way to link orders from the same user, providing the highest level of anonymity. Thus, not even a Mostro node can determine which transactions belong to the same person.

Since in full private mode there is no fixed key associated with the user, it is not possible to build or maintain a reputation. When someone in this mode creates a new order, their reputation will appear as 0, just as if they were a new user. However, for those who value absolute privacy over trust based on ratings, this mode is ideal.

Privacy in User-to-User Communication

Communication between the buyer and seller during a transaction occurs directly from client to client through an end-to-end encrypted chat, integrated into the Mostro clients. This system uses a simplified version of NIP-59 to hide metadata from external observers, and messages are directed to a unique shared public key generated using advanced cryptography (Elliptic Curve Diffie-Hellman or ECDH). This "shared master key" is known only to the buyer and seller, ensuring that neither the Mostro node where they are transacting nor third parties can access the conversation content. Additionally, since each transaction generates new and unique keys, privacy remains intact even between transactions with the same counterparty.

In case of a dispute, this shared key provides an effective solution: either party can choose to voluntarily share it with the designated mediator. With it, the mediator can decrypt only the conversation of that specific transaction, accessing an immutable copy of the messages, which cannot be altered or deleted. This allows disputes to be resolved fairly and transparently, exposing any attempts at deception without compromising the default privacy of users and only revealing information when necessary and with consent.

Account Backup and Restoration

Your identity on Mostro is based on a private key that clients automatically generate when you create your account. This key is represented as a 12-word phrase (seed phrase) that you must store securely.

Why Backup Matters

Without a backup of your 12-word phrase, you could lose:

• Access to active trades: if you switch devices or reinstall the app during an exchange, you won't be able to continue the operation
• Your reputation: the ratings you've accumulated are tied to your identity; without a backup, you'd start from scratch
• History: you won't be able to recover information from previous trades

How to Back Up

Each Mostro client has its own way of displaying and backing up your 12-word phrase. Check the documentation of the client you use to learn how.

The important things are:

• Write down the 12 words in the correct order
• Store them in a safe and private place
• Do not share them with anyone
• Do not store them in plain text on internet-connected devices

Restoring Your Account

If you need to switch devices, reinstall the app, or use a different client, you can restore your identity by importing your 12-word phrase.

When restoring:

• You recover your identity and reputation
• You can continue trades that were active
• You can access from any compatible Mostro client

The exact restoration process depends on the client you use. Check the specific client documentation for detailed steps.

Important: Full Privacy Mode

If you operate in full privacy mode, orders created in that mode cannot be recovered when restoring your account. Only orders created in reputation mode can be restored.

This is because in full privacy mode there is no fixed key associated with your identity, so Mostro cannot link those operations to your restored account.

Recommendations

• Back up as soon as you create your account, before your first trade
• Verify that you wrote the words correctly before you need them
• Consider keeping more than one copy in different secure locations
• Never share your phrase with anyone, not even Mostro support
• If you value being able to recover active trades, use reputation mode

Support and Contact

Mostro is not a company but an Open Source project maintained by its community, so it does not have a technical support department. However, there is a community you can reach out to if needed.

If you have any questions, you can ask in the Telegram groups:

• Mostro community: https://t.me/MostroP2P
• Mostro devs: https://t.me/mostro_dev

We also have a group on Nostr.

Additionally, you can follow us on:

• Nostr: npub1m0str0d7z2ww8rdh20t2n9lx520xjwhaq24p68umqp06wwrwtsnqen40un.
• X: https://twitter.com/MostroP2P.

How to Contribute

Thank you for your interest in contributing to Mostro!
Mostro is not a company but an Open Source project, driven and maintained by its community, so any type of contribution is valuable and helpful to its users.

While we suggest some areas where you can collaborate, feel free to propose any improvement you think may benefit the project:

• Documentation: Help improve the documentation so that more people can understand what Mostro is and how to use it.
• Translations: If you are multilingual, you can translate Mostro's clients or contribute to the documentation in other languages.
• Development: In the Mostro project you can find various repositories and programming languages. If you're unsure where to start, check out the "good first issue" lists to get involved.
• Bug reporting: If you detect any errors or unexpected behavior, reporting them is greatly helpful. This contributes to improving the stability and quality of the project.
• Improvement proposals: If you have ideas to enhance Mostro, we invite you to share them. Many key features have arisen thanks to suggestions from the community. You can propose your ideas in the support groups, or open an issue in the corresponding repository. If you believe it will spark significant discussion, then start a discussion in that repository.
• Content creation: If you have skills in content creation, you can make video tutorials or written guides to help users make the most of Mostro.
• Social media outreach: Sharing information about Mostro on social media helps increase its visibility and attract more people interested in contributing or using it.
• Donations: If you prefer to financially support the development and maintenance of Mostro, you can make a donation to https://geyser.fund/project/mostro.

Thank you so much for your support!

Clients. How to use Mostro

To use Mostro, you need to access it through a specific client. Below, we will cover several of them, which will allow you to interact both with Mostrod and with your counterpart in an operation.

The available Mostro clients so far are:

• Mostro mobile (operational in beta): mobile application.
• Mostro-cli (operational): command line client.
• MostriX (in development): TUI client, which operates in the terminal with an enhanced appearance.

Each client has particular features, so users can choose which one to use according to their interests and switch between them when they consider it convenient. The clients are responsible for creating, storing, and managing their users' Nostr keys. To learn how clients handle user privacy, read here.

Although some clients are already operational, they are under constant development, with new features being implemented, UX improvements, bug fixes, etc. You may encounter bugs; if this happens, please report them. Your feedback is very important.

Note: Two users using different Mostro clients can exchange sats; however, for direct communication between them, they must take into account what type of messages their respective clients accept. Clients must implement this peer-to-peer chat, but if a client has not yet implemented it, its users will not be able to view messages sent from a client that has implemented it. Similarly, this could occur with other functionalities. Developers of each client make their best effort to update them as soon as possible.

Mostro is a FOSS project, so anyone interested can create a client to interact with it. We encourage you to develop your own client or collaborate on the development of existing ones to enhance the experience of P2P Bitcoin exchanges without KYC on Nostr!

To learn more details about them, keep reading this documentation.

Mostro Mobile

Mostro Mobile is the official mobile application for using Mostro. It is available for Android and coming soon to iOS.

Downloads

• Android: GitHub Releases or Zapstore
• iOS: Coming soon

Key Features

Identity Management

• Automatic account creation with a 12-word phrase
• Identity backup
• Account restoration on any device
• Recovery of active trades upon restoration (reputation mode only)

Trading

• Create buy and sell orders
• Take orders from the order book
• Filter by fiat currency
• Support for fixed price or market price orders
• Support for premium/discount on market price

Lightning Address

• Set up your Lightning Address in the app
• When buying sats, the app automatically uses your Lightning Address
• No need to generate invoices manually

Communication

• End-to-end encrypted chat with your counterparty
• Chat with the solver during disputes
• Messages cannot be deleted or altered

Notifications

• Push notifications for activity on your trades
• Important to keep them enabled so you don't miss the timing of a trade
• Configurable from the app settings

Disputes

• Open disputes directly from the app
• Communication with the solver
• Share chat evidence if needed

Multi-language

• Available in Spanish, English, and Italian

Multiple Nodes

• Support for connecting to different Mostro nodes
• Switch between nodes from settings

Getting Started

1. Download the app from official sources
2. When you open it for the first time, your identity will be created automatically
3. Back up your 12 words before trading
4. Set up your Lightning Address (optional but recommended)
5. Enable push notifications
6. Ready to trade

More Information

• Repository: https://github.com/MostroP2P/mobile
• Report bugs: GitHub Issues

Mostro CLI

Mostro CLI is a Mostro client with a command-line interface. It is primarily used by developers and advanced users to test the latest Mostro features and to automate operations.

Installation

You can install Mostro CLI directly from crates.io:

cargo install mostro-cli

Or build it manually:

git clone https://github.com/MostroP2P/mostro-cli.git
cd mostro-cli
cargo build --release

Requirements: Rust 1.64 or higher.

Features

• Create buy and sell orders
• Take orders from the order book
• Support for range orders (min-max)
• Create buy orders with Lightning Address
• Direct chat with counterparties (NIP-17)
• Identity management (NIP-06 support)
• Full dispute flow
• Restore session to recover pending orders
• Administration commands for Mostro operators

Basic Usage

# Set environment variables (replace the variables as needed)
export MOSTRO_PUBKEY=npub1stagewtcks78nvs4vkzm4skqzytk5gwj46kkm8mu2awqqklgswgqfvtamr
export RELAYS='wss://relay.mostro.network,wss://nos.lol'

# List available orders
mostro-cli listorders

# Create a buy order
mostro-cli neworder -k buy -c ves -f 1000 -m "face to face"

# Create a sell order with a range
mostro-cli neworder -k sell -c ars -f 1000-10000 -m "bank transfer"

# Cancel a pending order
mostro-cli cancel -o <order-id>

# Restore session
mostro-cli restore

To see all available commands:

mostro-cli help

More Information

Mostro CLI is a FOSS project. You can visit its GitHub repository to learn more about its development, report bugs, or propose improvements.

MostriX

MostriX is a Mostro client with a TUI (Terminal User Interface) primarily focused on Mostro node administrators. Its visual terminal interface allows managing disputes and administering the node efficiently, without the need to type commands manually.

Note: MostriX is in active development. Some features may be incomplete or require additional testing.

Installation

git clone https://github.com/MostroP2P/mostrix.git
cd mostrix
cargo run

Requirements: Rust 1.90 or higher.

Implemented Features

• View order book
• Create buy and sell orders
• Create buy orders with Lightning Address
• Take orders (buy and sell)
• Confirm fiat sent
• Release sats
• Add new invoice if payment fails
• Automatic 12-word seed generation
• Key management according to the Mostro protocol
• Configuration via settings.toml file

Features in Development

• Peer-to-peer chat
• List own orders
• Cooperative cancellation
• Rate counterparties
• Dispute flow

Configuration

MostriX is configured through a settings.toml file. On first run, it is automatically created at ~/.mostrix/settings.toml.

Main parameters:

• mostro_pubkey: Public key of the Mostro node
• nsec_privkey: Your Nostr private key
• relays: List of relays to connect to
• currencies: Fiat currencies you're interested in

More Information

MostriX is a FOSS project. You can visit its GitHub repository to learn more about its development, report bugs, or propose improvements.