Faire Tourner Votre Propre Nœud Mostro

Mostro v0.20.2 — Guide de la Communauté · Octobre 2026

1. Qu'est-ce que Mostro et pourquoi votre communauté devrait en faire tourner un ?

Mostro est un exchange peer-to-peer de Bitcoin qui permet aux gens d'acheter et de vendre du Bitcoin en utilisant des monnaies locales (dollars, euros, francs — n'importe quelle devise) sans avoir à fournir de pièce d'identité (KYC). Pensez-y comme un marché décentralisé où acheteurs et vendeurs peuvent échanger directement.

Il fonctionne grâce à deux technologies :

Mostro agit comme un coordinateur de séquestre — il retient le Bitcoin du vendeur dans un « coffre-fort » temporaire (appelé hold invoice) jusqu'à ce que l'acheteur confirme avoir envoyé le paiement en monnaie locale. Mostro ne contrôle jamais réellement les fonds de quiconque ; il les retient brièvement pendant la transaction.

Pourquoi votre communauté voudrait-elle faire tourner un nœud Mostro ?

  1. Revenus de frais — Chaque transaction vous rapporte les frais que vous fixez (le modèle de configuration est livré à 0 ; 0.6% est un choix courant). À 0.6%, une communauté qui réalise 10 000 $ de transactions mensuelles gagne environ 60 $/mois en frais.
  2. Trading P2P sans KYC — Les membres de votre communauté peuvent acheter et vendre du Bitcoin sans fournir de pièce d'identité. Particulièrement important dans les régions aux monnaies instables ou aux réglementations restrictives.
  3. Litiges dans votre langue — Quand une transaction tourne mal, votre communauté la résout, dans votre langue, en comprenant vos méthodes de paiement locales.
  4. Indépendance — Aucune entreprise ne peut fermer votre exchange. Aucun gouvernement ne peut faire pression sur un opérateur unique pour le faire fermer.
  5. Personnalisation — Vous choisissez quelles devises supporter, quelles méthodes de paiement autoriser et quels frais facturer.

Comment fonctionne Mostro (Simplifié)

1. Alice veut VENDRE du Bitcoin pour 50 $ USD → Elle crée un ordre sur Mostro
2. Bob veut ACHETER du Bitcoin avec 50 $ USD → Il voit l'ordre d'Alice et le prend
3. Mostro crée un « coffre-fort » (hold invoice) → Alice envoie ses Bitcoin dans le coffre-fort
4. Bob envoie 50 $ à Alice par virement bancaire, Zelle, espèces, etc. → Bob appuie sur « Fiat Envoyé » dans son app
5. Alice confirme qu'elle a reçu les 50 $ → Elle appuie sur « Libérer »
6. Mostro libère les Bitcoin du coffre-fort vers Bob → Transaction terminée ! ✓

Si quelque chose tourne mal (ex : Bob dit qu'il a payé mais Alice n'a pas reçu), l'une ou l'autre partie peut ouvrir un litige, et les arbitres désignés de votre communauté enquêtent et résolvent le problème.

2. Prérequis — Ce dont vous avez besoin avant de commencer

2.1 Un Serveur (VPS)

Un VPS (Serveur Privé Virtuel) est un ordinateur dans un centre de données qui fonctionne 24h/24 et 7j/7. Vous en louerez un pour héberger votre nœud Mostro.

Spécifications minimales :

RessourceMinimumRecommandé
CPU2 vCPUs (partagés)2+ vCPUs
RAM2 Go4 Go
Stockage60 Go SSD100 Go SSD
Bande passante3 To/mois3+ To/mois
OSUbuntu 22.04+ LTSUbuntu 24.04 LTS

Coût mensuel estimé : 10–24 $/mois.

Ces chiffres valent pour Mostro seul. Si LND tourne sur le même VPS, ajoutez au moins 2 Go de RAM, ainsi que le disque dont a besoin son backend Bitcoin (voir 2.2).

Fournisseurs VPS populaires :

💡 Conseil

De nombreux fournisseurs de VPS acceptent les paiements en Bitcoin. Recherchez cette option si vous souhaitez rester cohérent avec la philosophie Bitcoin.

Vous devez être à l'aise pour vous connecter à un serveur par SSH. Si vous ne l'avez jamais fait, cherchez un tutoriel « Se connecter en SSH à un VPS » — c'est plus simple qu'il n'y paraît.

2.2 Un Nœud Lightning Network (LND)

Lightning Network est un système « couche 2 » construit sur Bitcoin qui permet des paiements rapides et peu coûteux. Pour faire tourner Mostro, vous avez besoin d'un nœud LND (Lightning Network Daemon) — le logiciel Lightning spécifique avec lequel Mostro fonctionne.

Vos options :

OptionDifficultéCoûtNotes
Utiliser un nœud LND existantFacileGratuit (si vous en avez un)Idéal si quelqu'un en a déjà un
Faire tourner LND sur le même VPSDifficileVPS plus gros + liquidité4 Go+ de RAM, et du disque pour le backend Bitcoin (voir ci-dessous)
Solution nœud-en-boîteMoyen200–600 $ + liquiditéStart9, Umbrel, RaspiBlitz
StartOS avec le paquet MostroPlus facile300–600 $ + liquiditéStart9 dispose d'un paquet Mostro en un clic
Utiliser Voltage.cloudFacileÀ partir d'environ 20 $/mois + liquiditéVoltage — LND hébergé avec infrastructure gérée
⚠️ Important

Mostro requiert spécifiquement LND (pas CLN/Core Lightning, pas Eclair, pas LDK). Assurez-vous que votre nœud Lightning fait tourner LND.

Ce dont vous avez besoin de votre nœud LND :

Générez un macaroon dédié pour Mostro. Ne donnez pas votre admin.macaroon à Mostro : il accorde un contrôle total sur votre nœud et ses fonds. Créez un macaroon ne contenant que les permissions que Mostro utilise réellement (lire les infos du nœud, lister les canaux pour le rapport de santé, créer/régler/annuler des hold invoices, envoyer et suivre des paiements).

Choisissez d'abord un root key ID qui n'est pas déjà utilisé. Révoquer un macaroon révoque tous les macaroons partageant son ID : en réutiliser un emporterait des identifiants sans rapport. L'ID 0 appartient aux macaroons de LND, choisissez donc un nombre libre non nul et notez-le :

lncli listmacaroonids

Créez ensuite le macaroon avec l'ID choisi (7 dans cet exemple, remplacez par le vôtre) :

lncli bakemacaroon --root_key_id 7 \
  --save_to /root/.lnd/data/chain/bitcoin/mainnet/mostro.macaroon \
  info:read invoices:read invoices:write offchain:read offchain:write

Ce macaroon ne peut ni ouvrir ou fermer des canaux, ni déplacer des fonds on-chain, ni modifier la configuration de votre nœud. En cas de fuite, révoquez-le avec lncli deletemacaroonid 7, en utilisant le même ID que celui de sa création, et créez-en un nouveau.

Si vous ne pouvez pas écrire dans le répertoire de données de LND (un conteneur, un nœud-en-boîte, un nœud hébergé), omettez --save_to : lncli affiche alors le macaroon en hexadécimal, et vous le convertissez en fichier là où Mostro tourne. lncli peut aussi le créer depuis une autre machine, en pointant vers le nœud avec ses identifiants admin :

lncli --rpcserver=NODE_ADDRESS:10009 --tlscertpath=tls.cert --macaroonpath=admin.macaroon \
  bakemacaroon --root_key_id 7 info:read invoices:read invoices:write offchain:read offchain:write
# copiez l'hexadécimal affiché, puis :
echo "PASTE_THE_HEX_HERE" | xxd -r -p > mostro.macaroon   # apt install -y xxd si absent

Contrairement à Mostro, lncli vérifie que NODE_ADDRESS figure dans le certificat du nœud. LND y inscrit les adresses de la machine lorsqu'il le crée, mais pas, par exemple, une adresse VPN ajoutée plus tard. Si la connexion échoue avec une erreur de certificat, exécutez lncli sur le nœud lui-même, ou ajoutez l'adresse avec tlsextraip (ou tlsextradomain) dans lnd.conf, supprimez tls.cert et tls.key et redémarrez LND pour qu'il crée un nouveau certificat ; copiez ensuite aussi le nouveau tls.cert vers Mostro.

Comment Mostro se connecte à LND

Mostro parle au port gRPC de LND (10009 par défaut) et s'authentifie avec tls.cert et le macaroon. Trois choses à savoir avant de choisir où faire tourner LND :

LND sur le même VPS

Installez LND en suivant le guide officiel (docs.lightning.engineering), avec ses binaires de release. LND a besoin d'une vue de la chaîne Bitcoin, et ce choix détermine la taille de votre VPS :

BackendDisqueCompromis
bitcoind, nœud completPlus de 700 GoLe plus robuste. La synchronisation initiale prend des jours.
bitcoind, élaguéDes dizaines de GoSupporté par LND et robuste ; la synchronisation initiale prend toujours des jours.
neutrinoQuelques GoPas de nœud Bitcoin et un démarrage rapide, mais dépend des pairs auprès desquels il se synchronise. Un nœud neutrino bloqué pendant environ 21 heures est la raison pour laquelle Mostro surveille désormais la synchronisation de LND (5.4). Si vous l'utilisez, pointez-le vers des nœuds Bitcoin de confiance avec neutrino.connect et configurez les alertes de santé.

Rendez ensuite LND joignable depuis Mostro. Avec l'installation native (Option C), rien ne change : utilisez https://127.0.0.1:10009. Avec Docker (Options A et B), le conteneur est un hôte distinct, choisissez donc l'une des deux voies :

LND sur un autre serveur ou à la maison

Reliez les deux machines avec un VPN comme WireGuard ou Tailscale, faites écouter LND sur son adresse VPN (rpclisten=VPN_IP:10009, plus rpclisten=localhost:10009 pour que lncli continue de fonctionner sur le nœud : toute ligne rpclisten remplace celle par défaut) et définissez lnd_grpc_host = 'https://VPN_IP:10009'. Copiez tls.cert et le macaroon sur le serveur Mostro. Ouvrir le port 10009 à Internet fonctionne aussi, mais le macaroon est alors la seule barrière entre le monde et votre nœud : évitez-le. Un nœud à la maison doit rester en ligne 24h/24, 7j/7 : une coupure de courant ou une connexion qui tombe laisse les transactions de vos utilisateurs en attente.

Nœud-en-boîte (Start9, Umbrel, RaspiBlitz)

Ces systèmes installent et mettent à jour LND pour vous, généralement sur un petit ordinateur à la maison. Sur StartOS, le plus simple est le paquet Mostro lui-même, qui se connecte au service LND de la même boîte. Utiliser le LND de la boîte depuis un Mostro sur un VPS est plus difficile : ces systèmes gèrent eux-mêmes la configuration de LND, vous ne pourrez donc peut-être pas ajouter de ligne rpclisten, et ils n'exposent souvent gRPC que sur le réseau local ou via Tor, que Mostro ne peut pas utiliser. Vérifiez ce que votre système permet avant de partir sur cette solution. Chaque système affiche les détails de connexion de LND dans sa propre interface (sur StartOS, dans les propriétés du service LND) ; lncli s'exécute généralement dans le conteneur LND — sur Umbrel, par exemple, sudo docker exec -it lightning_lnd_1 lncli ... (vérifiez le nom avec sudo docker ps). Créez le macaroon en hexadécimal comme montré plus haut.

Voltage (LND hébergé)

Voltage fait tourner LND pour vous. Téléchargez tls.cert et le macaroon admin depuis le tableau de bord du nœud, utilisez-les uniquement pour créer le macaroon restreint de Mostro depuis votre propre machine (voir plus haut), et faites pointer lnd_grpc_host vers l'adresse gRPC affichée par le tableau de bord, port 10009. Vous fournissez et gérez toujours la liquidité.

Réglages de LND qui affectent Mostro

2.3 Liquidité Lightning

Pour faciliter les transactions, votre nœud Lightning a besoin de canaux avec du Bitcoin dedans. Pensez aux canaux Lightning comme des tunnels de paiement pré-financés. Le Bitcoin dans ces canaux est votre « liquidité ».

Combien en faut-il ?

Volume de trading viséLiquidité suggéréeBTC approximatif
Petite communauté (quelques transactions/jour)1–5 millions de sats0.01–0.05 BTC
Communauté moyenne5–20 millions de sats0.05–0.20 BTC
Communauté active20–100 millions de sats0.20–1.0 BTC
💡 Note sur la Liquidité Lightning

Le Bitcoin dans vos canaux Lightning est bloqué onchain mais reste hautement dépensable via le Lightning Network. De nombreux services acceptent les paiements Lightning — des cafés aux fournisseurs VPS — rendant votre liquidité assez flexible pour un usage quotidien.

Commencez petit, grandissez progressivement. Commencez avec suffisamment pour les besoins initiaux de votre communauté et surveillez les retours. Quand les traders signalent que les ordres échouent par manque de capacité, c'est votre signal pour en ajouter. Écoutez votre communauté.

Obtenir de la liquidité :

2.4 Clés Nostr

Votre nœud Mostro a besoin de sa propre identité sur le réseau Nostr — une paire de clés cryptographiques avec une clé publique (l'adresse de votre nœud) et une clé privée (votre secret).

⚠️ Important

Ne réutilisez jamais des clés Nostr entre instances de Mostro. Chaque nœud a besoin de sa propre identité unique.

Générer des clés Nostr sécurisées localement avec rana :

# Installer Rust (si pas déjà installé)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

# Installer rana - générateur local de clés Nostr
cargo install rana

# Générer une nouvelle paire de clés (avec phrase mnémonique de 12 mots)
rana --generate 12

Rana générera votre clé privée (nsec), votre clé publique (npub) et une phrase mnémonique de sauvegarde. Conservez le tout en lieu sûr ! Note : lancer rana sans arguments démarre le minage PoW (difficulté 10) qui peut prendre plusieurs minutes — utilisez --generate pour une génération instantanée. Ne générez jamais de clés importantes via des services en ligne.

2.5 Niveau de connaissances techniques

TâcheDifficultéConnaissances requises
Louer un VPSFacileCarte bancaire, navigation web basique
Se connecter en SSHFacileSuivre des instructions, taper des commandes
Installer DockerMoyenCopier-coller des commandes, dépannage basique
Faire tourner Mostro (Docker)MoyenÉditer des fichiers de configuration, comprendre les chemins
Faire tourner Mostro (natif)DifficileAdministration Linux, compilation de logiciels, systemd
Configurer LND depuis zéroDifficileConnaissances significatives en Linux et réseaux
Gérer la liquidité LightningDifficileComprendre l'économie des canaux Lightning

💡 Notre recommandation : Si votre communauté compte quelqu'un à l'aise avec la ligne de commande Linux, il peut gérer l'installation avec Docker. La compilation native nécessite de l'expérience en administration système. La configuration du nœud Lightning est la partie la plus complexe — envisagez de demander l'aide de quelqu'un d'expérimenté, ou d'utiliser une solution nœud-en-boîte.

3. Installation Pas à Pas

Toutes les options d'installation partagent les mêmes premières étapes. Choisissez ensuite l'option qui vous convient :

Toutes supposent que vous avez déjà : ✅ Un VPS avec Ubuntu · ✅ Un accès SSH · ✅ Un nœud LND fonctionnel.

Étapes Communes (pour les 3 options)

Étape 1 : Connectez-vous à votre VPS

ssh root@VOTRE_ADRESSE_IP_VPS

Étape 2 : Mettez à jour le système

# Télécharger les dernières informations de paquets
apt update

# Installer toutes les mises à jour disponibles
apt upgrade -y

Étape 3 : Installer Docker et Docker Compose

💡 Note

Docker est nécessaire pour les options A et B. Si vous compilez manuellement (Option C), vous pouvez sauter cette étape.

# Installer Docker avec le script officiel
curl -fsSL https://get.docker.com | sh

# Vérifier que Docker est installé
docker --version

# Vérifier Docker Compose
docker compose version

Étape 4 : Installer les outils supplémentaires

apt install -y git make

✅ Étapes communes terminées. Choisissez maintenant votre option d'installation :

Option A : Docker Hub (La plus rapide — Recommandée)

Lancez Mostro directement depuis Docker Hub sans cloner le dépôt ni compiler. Parfait pour les déploiements sur VPS.

Étape 5 : Créer le répertoire de configuration

mkdir -p ~/mostro-config/lnd

Étape 6 : Obtenir le modèle de configuration

curl -sL https://raw.githubusercontent.com/MostroP2P/mostro/v0.20.2/settings.tpl.toml \
  -o ~/mostro-config/settings.toml

Étape 7 : Copier les identifiants LND

cp /chemin/vers/votre/tls.cert ~/mostro-config/lnd/tls.cert
cp /chemin/vers/votre/mostro.macaroon ~/mostro-config/lnd/mostro.macaroon

Si LND est sur la même machine, les chemins typiques sont :

Étape 8 : Modifier la configuration

nano ~/mostro-config/settings.toml

Modifications requises :

[lightning]
lnd_cert_file = '/config/lnd/tls.cert'
lnd_macaroon_file = '/config/lnd/mostro.macaroon'
lnd_grpc_host = 'https://host.docker.internal:10009'  # Si LND sur le même VPS
# Ou utiliser 'https://VOTRE_IP_LND:10009' si LND sur un serveur différent

[database]
url = "sqlite:///config/mostro.db"  # mostrod utilise toujours <répertoire-de-config>/mostro.db

[nostr]
nsec_privkey = 'VOTRE_CLE_NSEC_ICI'
relays = ['wss://relay.mostro.network', 'wss://nos.lol']

[mostro]
fee = 0.006                    # 0.6% de frais par transaction
max_order_amount = 1000000     # Ordre maximum en sats
min_payment_amount = 100       # Ordre minimum en sats
fiat_currencies_accepted = ['USD', 'EUR']  # Vos devises

Enregistrer : Ctrl+X, puis Y, puis Entrée.

Étape 9 : Ajuster les permissions

⚠️ Important

Évitez chmod 777. Utilisez des permissions minimales.

sudo chown -R 1000:1000 ~/mostro-config
chmod 700 ~/mostro-config
chmod 600 ~/mostro-config/settings.toml
chmod 600 ~/mostro-config/lnd/mostro.macaroon

Étape 10 : Lancer le conteneur

Si LND est sur le même VPS (LND doit accepter la connexion du conteneur, ou utilisez plutôt le réseau hôte : voir 2.2) :

docker run -d --name mostro \
  --restart unless-stopped \
  --add-host=host.docker.internal:host-gateway \
  -v ~/mostro-config:/config \
  mostrop2p/mostro:v0.20.2

Si LND est sur un serveur différent :

docker run -d --name mostro \
  --restart unless-stopped \
  -v ~/mostro-config:/config \
  mostrop2p/mostro:v0.20.2

Étape 11 : Vérifier les logs

docker logs -f mostro

Recherchez ces messages :

💡 Note

Il n'existe pas de message « connecté à LND » ni « connecté au relais ». Mostro contacte LND pendant le démarrage : un daemon qui passe le démarrage a donc joint LND. L'échec, lui, est bruyant : il journalise Ln node error et s'arrête. Après le démarrage, il interroge LND toutes les 15 secondes et journalise LND did not answer GetInfo s'il cesse de répondre ; les paiements sortants attendent alors son retour (5.4). Pour les relais, la ligne de l'événement de santé est votre signal : No relay accepted the health event signifie qu'aucun ne l'a accepté.

💡 Dépannage

Si vous voyez Permission denied (os error 13), réajustez les permissions : chown -R 1000:1000 ~/mostro-config et redémarrez : docker restart mostro.

🎉 Félicitations ! Si vous voyez des connexions réussies dans les logs, votre nœud Mostro fonctionne !

Alternative : Docker Compose

Au lieu d'une longue commande docker run, vous pouvez décrire le conteneur dans un fichier compose. Il lance la même image avec les mêmes réglages, et la mise à jour se résume à changer le tag sur une ligne. Créez ~/mostro-docker/compose.yml :

mkdir -p ~/mostro-docker
nano ~/mostro-docker/compose.yml
services:
  mostro:
    image: mostrop2p/mostro:v0.20.2
    container_name: mostro
    restart: unless-stopped
    extra_hosts:
      - "host.docker.internal:host-gateway"  # seulement si LND tourne sur ce VPS
    volumes:
      - ${HOME}/mostro-config:/config

Démarrez-le et suivez les logs :

docker compose -f ~/mostro-docker/compose.yml up -d
docker compose -f ~/mostro-docker/compose.yml logs -f mostro

Choisissez l'un ou l'autre : docker run ou compose, pas les deux. Pour mettre à jour l'un ou l'autre, voyez 5.5.

🔒 Note de Sécurité

Utilisez toujours un tag de version spécifique (ex. mostrop2p/mostro:v0.20.2) au lieu de :latest pour contrôler les déploiements.

Option B : Docker Build (Construire l'image localement)

Étape 5 : Télécharger Mostro

cd /opt
git clone https://github.com/MostroP2P/mostro.git
cd mostro

Étape 6 : Configurer les fichiers

cd docker
mkdir -p config
cp ../settings.tpl.toml config/settings.toml

Étape 7 : Modifier le fichier de configuration

nano config/settings.toml

Modifiez les mêmes paramètres que dans l'Option A, Étape 8, avec une différence : make docker-build copie votre macaroon vers config/lnd/admin.macaroon, quel que soit son nom d'origine ; faites donc pointer Mostro vers ce fichier :

lnd_macaroon_file = '/config/lnd/admin.macaroon'  # c'est toujours votre mostro.macaroon restreint, sous un autre nom
⚠️ Si LND tourne sur le même VPS

Contrairement à l'Option A, le docker/compose.yml du dépôt ne mappe pas host.docker.internal : sous Linux, ce nom ne se résout donc pas dans le conteneur. Ajoutez le mappage au service mostro avant de construire :

    extra_hosts:
      - "host.docker.internal:host-gateway"

Ou pointez lnd_grpc_host vers l'IP locale de l'hôte. Notez que make docker-build construit aussi l'image StartOS, dont un VPS n'a pas besoin : cela ne coûte que du temps de compilation.

Étape 8 : Construire l'image Docker

cd ..
LND_CERT_FILE=/root/.lnd/tls.cert \
LND_MACAROON_FILE=/root/.lnd/data/chain/bitcoin/mainnet/mostro.macaroon \
make docker-build

Étape 9 : Démarrer Mostro

# Démarre Mostro et le relais inclus. `make docker-up` seul démarre
# aussi l'image StartOS, inutile sur un VPS.
docker compose -f docker/compose.yml up -d mostro nostr-relay

# Vérifier l'état
docker compose -f docker/compose.yml ps

# Voir les logs
docker compose -f docker/compose.yml logs -f mostro

🎉 Félicitations ! Si vous voyez des connexions réussies, votre nœud Mostro fonctionne !

Option C : Compilation Native (Pour opérateurs techniques)

Étape 5 : Installer Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source /root/.cargo/env
rustc --version
cargo --version
⚠️ Important

N'installez PAS Rust via apt install rustc. Utilisez toujours rustup. Le paquet système est souvent obsolète.

Étape 6 : Installer les dépendances de compilation

apt install -y cmake build-essential libsqlite3-dev libssl-dev \
  pkg-config git sqlite3 protobuf-compiler

Étape 7 : Télécharger et compiler Mostro

cd /opt
git clone https://github.com/MostroP2P/mostro.git
cd mostro
cargo build --release
💡 Conseil

Si la compilation échoue par manque de RAM, ajoutez de l'espace swap :

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile

Étapes 8–10 : Installer, initialiser et nettoyer

install target/release/mostrod /usr/local/bin
cargo clean  # Économise 2+ Go d'espace

Étapes 11–12 : Créer un utilisateur et configurer

adduser --disabled-login mostro
mkdir -p /opt/mostro
cp settings.tpl.toml /opt/mostro/settings.toml
nano /opt/mostro/settings.toml

Modifiez les mêmes paramètres que dans l'Option A, Étape 8.

Étapes 13–15 : Test, permissions et service systemd

# Test d'exécution
/usr/local/bin/mostrod -d /opt/mostro

# Définir les permissions
chown -R mostro:mostro /opt/mostro
💡 L'assistant de configuration interactif

Si vous lancez mostrod sans settings.toml dans le répertoire visé et que vous êtes sur un terminal, il propose un menu de configuration capable de construire le fichier pour vous et d'écrire le nsec dans un .env. Sans terminal (Docker, systemd, CI), il copie le modèle, affiche où il l'a placé et s'arrête pour que vous l'éditiez.

Créer le service systemd :

# /etc/systemd/system/mostro.service
[Unit]
Description=Mostro daemon
After=network.target

[Service]
Type=simple
User=mostro
WorkingDirectory=/home/mostro
ExecStart=/usr/local/bin/mostrod -d /opt/mostro
Restart=on-failure

[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable mostro.service
systemctl start mostro.service
systemctl status mostro.service

🎉 Félicitations ! Votre nœud Mostro tourne en tant que service système.

4. Configuration en Détail

Le fichier settings.toml contrôle tout sur votre nœud Mostro.

4.1 Clés Nostr — L'identité de votre nœud

[nostr]
nsec_privkey = 'VOTRE_CLE_NSEC'
relays = [
  'wss://relay.mostro.network',
  'wss://nos.lol',
  'wss://relay.nostr.band'
]

Quels relays utiliser ?

💡 Conseil

Vous pouvez aussi faire tourner votre propre relais Nostr à côté de Mostro. La voie Docker Build (Option B) en inclut un dans son compose.yml ; l'Option A et la compilation native non.

Garder la clé hors de settings.toml

Mostro lit aussi la clé depuis la variable d'environnement MOSTRO_NSEC_PRIVKEY. L'ordre de priorité est : variable d'environnement, puis <répertoire-de-config>/.env, puis settings.toml.

# ~/mostro-config/.env  (chmod 600) — chargé automatiquement au démarrage
MOSTRO_NSEC_PRIVKEY=nsec1...

# Docker
docker run -e MOSTRO_NSEC_PRIVKEY=nsec1... ...

# Unité systemd
Environment="MOSTRO_NSEC_PRIVKEY=nsec1..."

Laisser nsec_privkey dans settings.toml fonctionne toujours. Si vous utilisez le fichier .env, sauvegardez-le avec autant de soin que la configuration.

4.2 Frais — Comment vous générez des revenus

[mostro]
fee = 0.006
dev_fee_percentage = 0.30

Frais de transaction (fee) : Pourcentage prélevé par transaction, réparti entre acheteur et vendeur.

Exemple : Sur une transaction de 100 000 sats avec fee = 0.006 : L'acheteur paie 300 sats, le vendeur paie 300 sats, votre nœud gagne 600 sats au total.

Frais de développement (dev_fee_percentage) : Un pourcentage de vos revenus de frais qui va au développement de Mostro.

📝 Note

Définir dev_fee_percentage en dessous de 0.10 empêchera Mostro de démarrer. Ce minimum assure un financement durable du développement.

4.3 Limites d'ordres et devises

[mostro]
max_order_amount = 1000000
min_payment_amount = 100
max_orders_per_response = 10
fiat_currencies_accepted = ['USD', 'EUR', 'ARS', 'CUP']

4.4 Profil du nœud (Optionnel mais recommandé)

[mostro]
name = "LatAm Mostro"
about = "Exchange P2P de Bitcoin pour l'Amérique latine. Support en espagnol."
picture = "https://exemple.com/votre-logo.png"
website = "https://site-de-votre-communaute.com"

Ceux-ci configurent le profil de votre Mostro sur Nostr (NIP-01 kind 0 metadata). Les clients affichent ces informations pour que les utilisateurs sachent sur quel Mostro ils échangent.

4.5 Délais et expiration

[mostro]
expiration_hours = 24        # Durée pendant laquelle un ordre non pris reste dans le carnet
max_expiration_days = 15     # Expiration la plus longue qu'un créateur peut demander
expiration_seconds = 900     # Temps pendant lequel un ordre pris peut attendre la hold invoice
                             # ou la facture de l'acheteur avant de retourner au carnet (15 min)

[lightning]
hold_invoice_expiration_window = 300  # Délai dont dispose le preneur pour payer la facture ou en fournir une de paiement (5 min)
hold_invoice_cltv_delta = 144         # Durée de vie de l'escrow, en blocs (~1 jour)

Notez que hold_invoice_expiration_window appartient à [lightning] : écrit sous [mostro], il est ignoré en silence. Il doit être supérieur à 0, et c'est aussi l'expiration de la facture de caution d'un preneur.

Une fois les sats du vendeur verrouillés, l'acheteur dispose d'environ hold_invoice_cltv_delta - escrow_deadline_margin_blocks blocs pour envoyer le paiement : 144 − 24 = 120 blocs, soit environ 20 heures, avec les valeurs par défaut. Quand ce délai s'écoule, Mostro annule la transaction si l'acheteur n'a jamais marqué le paiement comme envoyé, ou ouvre un litige s'il l'a fait (voir 4.9). Les utilisateurs voient le compte à rebours dans l'application.

4.6 Anti-Spam

[mostro]
pow = 0  # 0 = désactivé ; 10-20 = modéré. Commencez avec 0.

Un filtre plus fin est pow_first_contact. pow s'applique à tous les messages, tandis que pow_first_contact ne s'applique qu'aux expéditeurs étrangers à une transaction active et est vérifié avant déchiffrement. Les transactions en cours restent ainsi peu coûteuses, alors que les inconnus doivent fournir un vrai travail :

[mostro]
pow = 0                  # transactions en cours
pow_first_contact = 16   # nouveaux ordres et prises depuis des clés inconnues

Les clients doivent miner au moins autant. Les utilisateurs de mostro-cli doivent régler POW (ou -p) sur votre valeur, sinon leurs nouveaux ordres et prises sont ignorés sans réponse.

Un moyen de dissuasion plus fort contre ceux qui prennent des ordres puis disparaissent est la caution anti-abus (voir 4.11).

4.7 Interface RPC d'Administration (Optionnel)

[rpc]
enabled = false
listen_address = "127.0.0.1"
port = 50051
# auth_token = "une-longue-chaine-aleatoire"

Cette interface gRPC sert aux outils de l'opérateur : grpcurl, et mostro-cli pour le mode maintenance (admsetmaintenance, admmaintenancestatus, admcancelpending). Mostrix ne l'utilise pas : il passe par Nostr, vous n'avez donc pas besoin du RPC pour résoudre les litiges.

⚠️ Sécurité

Gardez listen_address sur "127.0.0.1" et n'exposez jamais le port à internet. Définissez auth_token dès que le port est joignable autrement que depuis la machine locale, par exemple via un tunnel SSH ou un conteneur sidecar : une connexion transférée arrive en loopback, l'adresse d'écoute ne constitue donc pas une autorisation. Avec un token défini, chaque appel modifiant l'état doit porter l'en-tête authorization: Bearer <token>.

Outre le mode maintenance, le RPC porte les appels de réputation RevokeReputationImports et RebindReputationExport (voir 4.13). Les deux ne sont acceptés que depuis le loopback, et mostro-cli n'a pas encore de commande pour eux : utilisez grpcurl. mostro-cli n'envoie MOSTRO_RPC_TOKEN qu'à une adresse loopback ou via https://, jamais en clair vers un hôte distant.

4.8 Protocole de Transport

Depuis la v0.19.0, un nœud Mostro ne parle que le protocole v2 : événements kind 14 signés, contenu chiffré NIP-44. Le protocole v1 (gift wraps NIP-59, kind 1059) a été supprimé, et il n'y a plus rien à choisir. Laissez la ligne transport hors de settings.toml ; le modèle ne l'a plus.

Ligne dans settings.tomlRésultat
aucuneProtocole v2. Recommandé.
transport = "nip44"Protocole v2. Accepté et sans effet.
transport = "gift-wrap"Mostro refuse de démarrer, avec une erreur qui vous dit de supprimer la ligne.

Votre nœud annonce protocol_version 2 dans son événement d'info kind 38385. Tous les clients actuels parlent v2 : l'application Mostro, Mostrix 0.3.1 ou plus récent, mostro-cli 0.16.2 ou plus récent et Bosstro. Un client qui ne parle que v1, comme une ancienne version de Mostro Mobile, n'obtient aucune réponse de votre nœud : demandez à vos utilisateurs de mettre à jour.

⚠️ Mise à jour depuis la v0.18.x

Si votre settings.toml contient encore transport = "gift-wrap", supprimez cette ligne avant de mettre à jour. Le seul moyen de continuer à servir des clients protocole v1 est de rester sur mostrod 0.18.x, qui ne reçoit plus de correctifs.

4.9 Limites de Sécurité Lightning

Ces réglages de [lightning] bornent la durée pendant laquelle vos canaux peuvent rester verrouillés et le nombre de paiements non résolus simultanés. Ils ont tous une valeur par défaut : un fichier de configuration d'une version antérieure démarre donc en général toujours, mais un modèle récent les inclut et il vaut la peine de les connaître.

[lightning]
max_final_cltv_expiry_delta = 144
escrow_deadline_margin_blocks = 24
max_inflight_payouts = 100
max_inflight_payouts_per_destination = 10
payment_cltv_limit = 1008
allow_node_change = false
RéglageCe qu'il protège
max_final_cltv_expiry_deltaRejette une facture de paiement dont le CLTV final laisserait le bénéficiaire retenir vos sats trop longtemps. 144 blocs (environ un jour) est le maximum demandé par les vrais portefeuilles. Ne le mettez jamais à 0 : cela rejette toutes les factures.
escrow_deadline_margin_blocksMarge de sécurité avant que LND n'annule automatiquement une hold invoice acceptée. Quand la chaîne s'approche à cette distance, Mostro annule la transaction ou ouvre un litige tant que l'escrow existe encore. Depuis la v0.20.0, Mostro refuse de démarrer s'il n'est pas d'au moins 18 (le invoices.holdexpirydelta par défaut de LND, 12, plus 6 blocs de marge) et inférieur à hold_invoice_cltv_delta. Si vous avez relevé holdexpirydelta, gardez vous-même cette marge au moins 6 blocs au-dessus. La valeur est publiée dans votre événement d'info.
max_inflight_payoutsPlafond de paiements non résolus sur l'ensemble du nœud, pour qu'un bénéficiaire qui ne règle jamais ne puisse pas épuiser vos slots HTLC. Un paiement freiné est retardé, jamais abandonné.
max_inflight_payouts_per_destinationLe même plafond par pubkey de destination, et le plus efficace des deux.
payment_cltv_limitPlafond du timelock total d'une route de paiement. Ne doit pas dépasser le --max-cltv-expiry de votre LND et doit se situer au moins 576 blocs au-dessus de max_final_cltv_expiry_delta, sinon les paiements légitimes échouent avec « no route ».
allow_node_changeGarde-fou au démarrage en cas de changement de nœud Lightning. Laissez-le à false et voyez 5.8.

Notez aussi que max_routing_fee, dans le bloc [mostro], vaut désormais 0.002 (0,2 %) par défaut.

4.10 Sources de Prix du Bitcoin

Mostro a besoin d'un taux BTC/fiat pour valoriser les ordres. Sans bloc [price], il utilise une seule source, Yadio, via le désormais déprécié bitcoin_price_api_url. Ajouter le bloc vous donne plusieurs sources, combinées par médiane avec écartement des valeurs aberrantes : une API en panne ou renvoyant un mauvais chiffre ne déplace donc pas vos prix.

[price]
update_interval_seconds = 300
max_price_staleness_seconds = 1800
outlier_threshold_pct = 5.0        # écarte une source à cette distance de la médiane (3+ sources requises)
provider_timeout_seconds = 10
provider_failure_threshold = 3     # échecs avant mise en pause d'une source
provider_failure_cooldown_seconds = 120
publish_to_nostr = true            # publie les taux agrégés en kind 30078

[price.providers.yadio]
enabled = true
url = "https://api.yadio.io"

[price.providers.coingecko]
enabled = true
url = "https://api.coingecko.com/api/v3"
# api_key = "CG-xxxx"              # facultatif, relève les limites de débit

[price.providers.currency_api]
enabled = true
url = "https://currency-api.pages.dev/v1"
fallback_urls = ["https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api@latest/v1"]
except = ["CUP", "MLC"]            # taux officiel seulement, à ne pas mélanger aux sources informelles

[price.providers.blockchain]
enabled = true
url = "https://blockchain.info"

Chaque source accepte only ou except pour limiter les devises auxquelles elle contribue, et fallback_urls pour des miroirs essayés quand l'URL principale échoue. Une source activée à laquelle manque un secret requis échoue au démarrage plutôt que de ne produire aucune cotation en silence.

💡 Si les API de prix sont bloquées dans votre pays

Vous pouvez prendre les taux sur Nostr plutôt qu'en HTTP, publiés par des nœuds Mostro auxquels vous faites confiance. Cela réutilise les relais déjà présents dans [nostr] et fonctionne donc partout où votre nœud atteint déjà un relais. Avec plusieurs nœuds de confiance, l'événement valide le plus récent l'emporte.

[price.providers.nostr]
enabled = true
trusted_nodes = [
    # pubkeys hex des nœuds Mostro auxquels vous faites confiance pour des taux exacts
]

Les opérateurs servant le peso cubain peuvent ajouter El Toque pour le CUP et le MLC du marché informel. C'est un opt-in, limité à ces deux devises, et il faut un token gratuit : un El Toque activé sans token refuse de démarrer.

Gardez publish_to_nostr = true. Outre l'alimentation des autres nœuds, les taux publiés indiquent à l'application Mostro quelles devises votre nœud peut valoriser au prix du marché : un code absent de ces taux n'est proposé qu'à prix fixe. Pour valoriser les stablecoins et le bitcoin sur d'autres réseaux, voyez 4.12.

⚠️ Ajouter un bloc [price] change de moteur de prix

Dès que settings.toml contient une table [price] ou [price.providers.*], Mostro utilise le moteur multi-sources et ignore bitcoin_price_api_url. Assurez-vous qu'au moins une source de marché (Yadio, CoinGecko, Currency API, Blockchain.com…) est activée, sinon votre nœud n'a aucun taux fiat et refuse tous les ordres au prix du marché. Surveillez dans le log de démarrage les avertissements qui commencent par price:.

4.11 Autres Blocs Facultatifs

D'autres blocs que vous pouvez rencontrer dans un modèle récent. Aucun n'est obligatoire. Trois d'entre eux ont leur propre section : [price.providers.pegged] (4.12), [reputation_import] / [reputation_export] (4.13) et [health] (5.4). serbero_pubkey, dans [mostro], est traité en 5.10.

Rétention des événements. Combien de temps Mostro conserve chaque type d'événement avant expiration. Omettez le bloc entièrement pour accepter les valeurs par défaut.

[expiration]
order_days = 30        # événements d'ordres (kind 38383)
rating_days = 90       # historique de réputation (kind 38384)
dispute_days = 90      # litiges, conservés plus longtemps pour l'audit (kind 38386)
fee_audit_days = 365   # transparence des frais (kind 8383)
dm_days = 30           # messages directs du protocole v2 (kind 14)

Cautions anti-abus

[anti_abuse_bond] demande aux preneurs, aux créateurs ou aux deux de verrouiller une petite hold invoice Lightning à côté de la transaction. Les utilisateurs honnêtes la récupèrent intacte ; un solveur peut confisquer la caution de celui qui a agi de mauvaise foi, et une part revient à la contrepartie honnête. Les utilisateurs la voient comme un « dépôt » dans l'application, et la documentation utilisateur l'explique dans son chapitre Dépôt anti-abus. Toutes les phases sont livrées ; il est désactivé par défaut.

[anti_abuse_bond]
enabled = true
amount_pct = 0.01                 # caution = max(1% de l'ordre, base_amount_sats)
base_amount_sats = 1000
apply_to = "take"                 # "take" | "make" | "both"
slash_on_waiting_timeout = false  # confisque aussi à qui laisse expirer son étape
slash_node_share_pct = 0.5        # part d'une caution confisquée que garde le nœud
payout_claim_window_days = 15     # délai dont dispose le gagnant pour réclamer sa part
maker_bond_payment_timeout_seconds = 900
# bond_cltv_delta = 432           # voir ci-dessous

Lisez le docs/ANTI_ABUSE_BOND.md du projet avant de l'activer sur un nœud en production, et annoncez-le d'abord à vos utilisateurs.

Historique du payeur (expérimental)

[payer_history] combat l'arnaque par triangulation, où un acheteur paie depuis le compte bancaire d'un tiers. L'acheteur s'engage sur un hash du compte depuis lequel il paiera (declare-payer), le vendeur peut le comparer à l'expéditeur figurant sur son relevé, et Mostro n'en conserve qu'un HMAC. À partir de la v0.20.2, seule la déclaration est câblée : la porte require_declaration et l'historique montré aux vendeurs ne sont pas encore implémentés, et aucun client publié n'envoie declare-payer. Laissez-le désactivé pour l'instant.

# [payer_history]
# enabled = false
# require_declaration = false

Escrow Cashu

[cashu] est un mode expérimental qui fonctionne sans LND et place l'escrow des transactions dans des tokens Cashu. Il n'est pas encore utilisable pour de vraies transactions — les actions de trade après la prise sont toujours refusées — et il ne peut pas être combiné aux cautions anti-abus. Depuis la v0.19.3, le créateur choisit la mint pour chaque ordre dans une liste autorisée :

# [cashu]
# enabled = false
# mint_urls = ["https://mint.example.com"]   # [] vide = n'importe quelle mint avec un hôte public
# escrow_locktime_days = 15

L'ancienne clé unique mint_url est rejetée : une configuration qui la contient ne se charge pas.

4.12 Stablecoins et Bitcoin sur d'autres réseaux

Depuis la v0.20.2, un nœud peut proposer des transactions contre six codes qui ne sont pas des devises fiat : des stablecoins en dollars, et du bitcoin sur d'autres réseaux. Des sats Lightning sont toujours d'un côté de la transaction ; l'autre côté est payé on-chain, sur Liquid, sur Rootstock ou sur le réseau du stablecoin, directement entre les deux utilisateurs.

CodeCe que c'estValorisé commeMontant de l'ordre en
USDTTether USD1 USDcoins entiers
USDCUSD Coin1 USDcoins entiers
DOCDollar on Chain (Rootstock)1 USDcoins entiers
BTCBitcoin on-chain1 sat = 1 satsats
LBTCL-BTC sur Liquid1 sat = 1 satsats
RBTCRBTC sur Rootstock1 sat = 1 satsats

L'activer

Il vous faut mostrod v0.20.2 ou plus récent. Deux réglages fonctionnent ensemble : fiat_currencies_accepted dit quels codes les ordres peuvent utiliser, et le fournisseur pegged dit lesquels ont un prix de marché.

[mostro]
# Gardez vos devises fiat et ajoutez les nouveaux codes, en MAJUSCULES
fiat_currencies_accepted = ['USD', 'EUR', 'USDT', 'USDC', 'DOC', 'LBTC', 'RBTC']

# Une source de prix de marché pour le fiat (et donc pour les stablecoins).
# Obligatoire en v0.20.2 dès que vous ajoutez une table [price.providers.*].
[price.providers.yadio]
enabled = true
url = "https://api.yadio.io"

[price.providers.pegged]
enabled = true
only = ["USDT", "USDC", "DOC", "LBTC", "RBTC"]   # ou except = ["BTC"] ; sans l'un ni l'autre, les six

Redémarrez Mostro et vérifiez le log. Si vous voyez price: the pegged provider quotes ... but fiat_currencies_accepted does not list them, ajoutez les codes manquants : un code coté mais non accepté publie un taux mais refuse tous les ordres. Un fiat_currencies_accepted = [] vide accepte tous les codes.

⚠️ N'ajoutez pas le bloc pegged seul en v0.20.2

Toute table [price.providers.*] fait passer le nœud au moteur de prix multi-sources et abandonne l'ancien bitcoin_price_api_url. En v0.20.2, une table pegged sans source de marché à côté laisse le nœud sans taux fiat : les ordres au prix du marché en USD, EUR et USDT sont tous refusés. Activez toujours au moins une source de marché, comme dans l'exemple ci-dessus. (La prochaine version conserve automatiquement l'ancienne source Yadio dans ce cas.) En v0.20.1 ou plus ancien, n'ajoutez pas du tout le bloc : le fournisseur n'y existe pas.

Prix fixe uniquement. Pour accepter un code sans le valoriser au prix du marché, listez-le dans fiat_currencies_accepted et laissez-le hors de only. Les utilisateurs doivent alors fixer un montant de sats. C'est un choix judicieux pour le BTC on-chain, où les frais de réseau rendent les petits ordres au prix du marché malcommodes.

Ce que voient vos utilisateurs

L'application Mostro 2.1.2 et plus récent affiche ces codes dans le sélecteur de devises sous Stablecoins et Bitcoin sur d'autres réseaux, mais seulement ceux que votre nœud accepte. Les montants BTC, LBTC et RBTC se saisissent en sats. Le moyen de paiement nomme le réseau (USDT (Tron), USDC (Base), DOC (Rootstock), LBTC (Liquid)…), le vendeur partage une adresse de réception dans le chat de la transaction, et l'acheteur y colle l'ID de transaction après avoir payé. Mostro ne vérifie jamais le réseau ni l'adresse. mostro-cli et Mostrix ne peuvent pour l'instant créer que des ordres à prix fixe dans ces codes.

Les litiges demandent d'autres preuves

Briefez vos solveurs avant d'activer cela. Il n'y a pas de relevé bancaire : la preuve est l'ID de transaction collé dans le chat, que le solveur vérifie dans un explorateur de blocs du réseau concerné. Pour Liquid, l'acheteur doit partager le lien unblinded (non masqué), car Liquid cache les montants. Les transferts sont irréversibles, un paiement sur le mauvais réseau peut être perdu, et l'acheteur paie les frais de réseau : le vendeur doit recevoir le montant complet. Le vendeur ne doit libérer qu'après confirmation du transfert. Le délai est le même que pour le fiat (environ 120 blocs avec les valeurs par défaut, voir 4.5) : un transfert on-chain à faibles frais peut donc le manquer.

💡 Si un stablecoin perd son ancrage

Il n'existe pas encore de garde-fou automatique contre le dépeg. Si l'USDT ou l'USDC s'éloigne d'un dollar, retirez-le de only, ou ajoutez-le à except si vous n'utilisez pas only (gardez-le dans fiat_currencies_accepted si vous voulez encore des ordres à prix fixe) et redémarrez.

4.13 Import et export de réputation

Les utilisateurs peuvent apporter chez vous la réputation acquise ailleurs — sur le bot Telegram @lnp2pBot ou sur un autre nœud Mostro —, pour qu'un trader qui déménage ne reparte pas de zéro. Trois chiffres voyagent : le nombre d'évaluations reçues, la note moyenne et la date de la première transaction. Ils arrivent sous forme d'attestation : un petit événement Nostr (kind 38388) signé par la source, adressé à l'identité de l'utilisateur et valable 7 jours. Votre nœud les ajoute à la réputation propre de l'utilisateur, et les contreparties voient un chiffre unique fusionné.

Les deux sens sont optionnels et désactivés par défaut. L'import exige mostrod v0.20.0 ou plus récent ; l'export, v0.20.1 ou plus récent. Les utilisateurs ont besoin de l'application Mostro en mode réputation : en mode confidentialité totale, il n'y a aucune identité pour porter une réputation.

Importer depuis lnp2pBot

lnp2pBot signe ses attestations avec une clé dédiée. Ajoutez-la à votre liste de confiance :

[reputation_import]
enabled = true
max_lifetime_seconds = 604800   # attestation la plus longue acceptée (7 jours ; 30 au maximum)

[[reputation_import.issuers]]
name = "lnp2pbot"               # ne renommez jamais une entrée qui a déjà des imports
keys = ["000004ac730537f1cf7d91f4f584a498a530a0205d35e816ebbaf23aec61e459"]
# npub1qqqqftrnq5mlrnmaj860tp9ynzjnpgpqt567s9hthter4mrpu3vsrta3em

Redémarrez Mostro. Votre événement d'info (kind 38385) porte maintenant un tag reputation_import_issuers, ce qui permet à l'application de savoir qu'elle peut proposer l'import sur votre nœud. Plusieurs nœuds de communautés font déjà confiance à cette clé.

Le bot exporte un compte ayant au moins 10 transactions terminées et 5 évaluations reçues, et qui n'est pas banni. L'utilisateur part de l'application (Paramètres → Réseau → Réputation → Importer la réputation → L'obtenir de lnp2pBot), confirme dans Telegram que le npub correspond, et recolle le message envoyé par le bot.

Faire confiance à un autre nœud Mostro

Un nœud qui exporte annonce sa clé de signature dans le tag reputation_issuer de son événement d'info. Lisez-le avec la commande de 5.4 (cherchez ce tag), confirmez-le auprès de l'opérateur, et ajoutez une entrée pour lui :

[[reputation_import.issuers]]
name = "mostro-example"         # un nom local stable de votre choix
keys = ["<that node's reputation_issuer key, npub or hex>"]

Un utilisateur peut importer une fois depuis chaque source sur chaque nœud, et l'import ne peut pas être annulé par l'utilisateur. Les chiffres sont un instantané : les évaluations ultérieures sur la source ne suivent pas.

Exporter depuis votre nœud

L'export permet à vos utilisateurs d'emporter vers un autre nœud la réputation acquise sur le vôtre. Seules les évaluations reçues sur votre nœud voyagent, jamais celles importées. L'utilisateur doit avoir 10 transactions terminées et 5 évaluations reçues sur votre nœud, et ne pas être banni.

Les attestations sont signées avec une clé dédiée, jamais la clé de votre nœud. Générez-en une et gardez-la à côté du nsec, dans l'environnement ou dans <config-dir>/.env :

# Disposition Docker Hub ; sinon, utilisez votre propre répertoire de configuration
echo "MOSTRO_REPUTATION_ISSUER_SK=$(openssl rand -hex 32)" >> ~/mostro-config/.env
sudo chown 1000:1000 ~/mostro-config/.env
chmod 600 ~/mostro-config/.env
[reputation_export]
enabled = true
issuer_key_env = "MOSTRO_REPUTATION_ISSUER_SK"
lifetime_seconds = 604800       # 1 à 604800 (7 jours)

Mostro refuse de démarrer si la variable est absente ou invalide, si elle contient la clé de votre propre nœud, ou si sa clé publique figure aussi dans votre liste [reputation_import]. Une fois lancé, votre événement d'info porte le tag reputation_issuer : partagez cette clé avec les opérateurs qui veulent faire confiance à votre nœud. Sauvegardez la clé avec vos autres secrets. Si elle fuit, n'importe qui peut fabriquer des attestations au nom de votre nœud jusqu'à ce que les autres opérateurs la retirent et révoquent les imports.

Révoquer des imports et ré-associer des exports

Deux appels RPC d'administration (4.7) traitent les cas rares. Ils ne sont acceptés que depuis le loopback ; ajoutez -H 'authorization: Bearer <token>' si vous avez défini auth_token. Lancez-les depuis un checkout du dépôt mostro, qui contient proto/admin.proto.

La clé d'un émetteur de confiance a fuité. Retirez d'abord la clé de son entrée et redémarrez, puis annulez chaque import signé avec elle (ajoutez "imported_after": <unix time> pour le limiter aux plus récents) :

grpcurl -plaintext -import-path proto -proto admin.proto \
  -d '{"issuer_key": "<npub or hex>", "reason": "key leaked"}' \
  127.0.0.1:50051 mostro.admin.v1.AdminService/RevokeReputationImports

Chaque import est annulé exactement, les évaluations reçues depuis sont conservées, et les utilisateurs peuvent importer à nouveau avec une attestation de la nouvelle clé.

Un utilisateur a perdu l'identité à laquelle son export est lié. Le premier export lie le compte à une identité ; la déplacer exige normalement une autorisation signée avec l'ancienne identité, que produit l'application. Si l'ancienne identité a disparu, vous pouvez la déplacer vous-même après avoir vérifié la personne :

grpcurl -plaintext -import-path proto -proto admin.proto \
  -d '{"identity": "<old npub>", "new_identity": "<new npub>", "reason": "support ticket"}' \
  127.0.0.1:50051 mostro.admin.v1.AdminService/RebindReputationExport

Un utilisateur qui restaure les mêmes 12 mots garde la même identité et n'a besoin de rien de tout cela.

5. Exploitation de Votre Nœud Mostro

5.1 Comment fonctionnent les litiges

Les litiges sont votre responsabilité opérationnelle la plus importante.

Quand les litiges surviennent-ils ?

Le processus de litige :

  1. L'utilisateur ouvre un litige — L'une des parties clique sur « Litige » dans le client
  2. Mostro marque l'ordre — Le statut passe à « Litige », les fonds restent bloqués
  3. L'arbitre prend le cas — Un admin assigné à votre nœud enquête
  4. Investigation — Communication avec les deux parties, demande de preuves
  5. Résolution — L'arbitre décide : libérer vers l'acheteur, ou rembourser le vendeur. Avec les cautions anti-abus activées (4.11), l'arbitre peut aussi confisquer la caution de celui qui a agi de mauvaise foi.

L'arbitre écrit à chaque partie sur un chat de litige privé, que l'application Mostro affiche sous Chat → Litiges. Chaque partie peut aussi partager la clé de son chat de transaction avec l'arbitre, qui lit alors cette conversation dans l'onglet Observer de Mostrix ou dans Bosstro. Les parties peuvent encore terminer la transaction elles-mêmes : si le vendeur libère, ou si les deux conviennent d'une annulation coopérative, Mostro clôt le litige de lui-même et en informe l'arbitre.

Si vous faites tourner Serbero (5.10), il alerte vos arbitres dès l'ouverture d'un litige et peut faire les premiers pas avec les parties. Il ne décide jamais et ne déplace jamais de fonds.

⚠️ Important

Choisissez vos arbitres avec soin. Ils ont le pouvoir de décider où vont les fonds bloqués. Choisissez des membres de confiance et impartiaux de la communauté. 2-3 arbitres sont recommandés.

Niveaux de permission des solveurs

Un solveur peut être enregistré en lecture seule ou avec les pleins pouvoirs. Les deux niveaux peuvent prendre un litige et parler aux parties, mais seul un solveur read-write peut décider où va l'argent.

Enregistré commePeutNe peut pas
npub1...:readPrendre un litige, le lire, écrire aux deux partiesRégler ou annuler l'ordre
npub1...:read-writeTout, y compris régler et annuler—

Un npub1... nu sans suffixe devient read-write par défaut, de même que l'enregistrement via l'interface RPC. Commencez un nouvel arbitre en :read le temps qu'il apprenne le processus, puis réenregistrez-le en read-write quand vous avez confiance en son jugement. Un solveur read-write peut reprendre un litige détenu par un solveur en lecture seule (ou par Serbero).

Vos arbitres peuvent travailler depuis un terminal avec Mostrix (5.2) ou depuis un téléphone Android avec Bosstro (5.11).

5.2 Mostrix — Votre outil d'administration

Mostrix est un client Mostro en terminal (TUI) avec deux modes : un mode utilisateur pour échanger, et un mode admin pour la résolution des litiges — prendre les litiges, discuter avec les deux parties, régler ou annuler, confisquer des cautions et ajouter des solveurs. Si vous faites tourner un nœud Mostro, vous avez besoin de Mostrix. Il parle à votre nœud uniquement via Nostr, jamais via l'interface RPC.

Option A : Télécharger le binaire pré-compilé (Recommandé)

Téléchargez la dernière version pour votre plateforme depuis GitHub Releases :

# Linux (x86_64)
wget https://github.com/MostroP2P/mostrix/releases/latest/download/mostrix-x86_64-unknown-linux-musl

# Linux (ARM64 / Raspberry Pi 4 et 5, OS 64 bits)
wget https://github.com/MostroP2P/mostrix/releases/latest/download/mostrix-aarch64-unknown-linux-musl

# Linux (ARMv7 / Raspberry Pi OS 32 bits)
wget https://github.com/MostroP2P/mostrix/releases/latest/download/mostrix-armv7-unknown-linux-gnueabi

# macOS (Apple Silicon / Intel)
curl -LO https://github.com/MostroP2P/mostrix/releases/latest/download/mostrix-aarch64-apple-darwin
curl -LO https://github.com/MostroP2P/mostrix/releases/latest/download/mostrix-x86_64-apple-darwin

# FreeBSD : mostrix-x86_64-unknown-freebsd
# Windows : téléchargez mostrix-x86_64-pc-windows-msvc.exe depuis la page des releases

Vérifiez le téléchargement avant de l'exécuter, comme expliqué juste en dessous.

🔐 Vérifiez la Release

Vérifiez toujours le binaire avant de l'exécuter. Importez les clés des mainteneurs une seule fois :

curl https://raw.githubusercontent.com/MostroP2P/mostrix/main/keys/negrunch.asc | gpg --import
curl https://raw.githubusercontent.com/MostroP2P/mostrix/main/keys/arkanoider.asc | gpg --import

Les signatures sont des fichiers détachés nommés manifest.txt.sig.<mainteneur>. Les releases récentes ne portent que manifest.txt.sig.arkanoider (clé 2E98 6CA1 C5E7 EA16 35CD 059C 4989 CC74 15A4 3AEC) : consultez la page de la release et téléchargez celles qui y figurent réellement :

wget https://github.com/MostroP2P/mostrix/releases/latest/download/manifest.txt
wget https://github.com/MostroP2P/mostrix/releases/latest/download/manifest.txt.sig.arkanoider

# Vérifiez chaque signature téléchargée
gpg --verify manifest.txt.sig.arkanoider manifest.txt

# Puis comparez l'empreinte du binaire au manifest
# (les lignes du manifest portent un préfixe artifact-<target>/, retiré ici)
sed 's#  artifact-[^/]*/#  #' manifest.txt | sha256sum -c --ignore-missing

Une signature valide provenant d'une clé de mainteneur que vous jugez fiable suffit. Si un wget renvoie 404, c'est simplement que cette signature n'a pas été publiée pour cette release : ne prenez pas un fichier absent pour un fichier vérifié.

Seulement une fois qu'une signature et l'empreinte concordent, rendez le binaire exécutable et lancez-le :

chmod +x mostrix-x86_64-unknown-linux-musl
./mostrix-x86_64-unknown-linux-musl

Option B : Compiler depuis le code source

Si vous préférez compiler depuis le code source ou avez besoin d'une plateforme non disponible dans les releases :

# Installer les dépendances (Ubuntu/Debian)
sudo apt install -y cmake build-essential pkg-config

# Installer Rust (si pas déjà installé ; Mostrix demande la 1.97 ou plus récente)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Cloner et compiler
git clone https://github.com/MostroP2P/mostrix.git
cd mostrix
cargo build --release

# Exécuter
./target/release/mostrix

Premier lancement et configuration

Au premier lancement, Mostrix crée ~/.mostrix/ avec une base de données contenant une nouvelle seed de 12 mots et un settings.toml, puis affiche une fenêtre Backup New Keys avec les 12 mots. Notez-les. Un settings.toml placé à côté du binaire a la priorité (mode portable).

⚠️ Important : Pointez Mostrix vers votre nœud

La configuration générée pointe vers le nœud public par défaut de Mostro. Passez à votre propre nœud : Settings → Select Mostro Instance, puis collez le npub ou l'hex de votre nœud, ou modifiez mostro_pubkey dans ~/.mostrix/settings.toml et redémarrez.

Pour le mode admin (résolution des litiges), les clés pertinentes sont :

# ~/.mostrix/settings.toml
mostro_pubkey = "VOTRE_PUBKEY_MOSTRO"        # hex ou npub
nsec_privkey  = "nsec1..."                   # votre identité de trader, dérivée de la seed — ne pas modifier
admin_privkey = "nsec1..."                   # la clé d'un solveur enregistré — voir ci-dessous
relays = ["wss://relay.mostro.network"]
currencies_filter = []                       # vide = afficher toutes les devises
user_mode = "admin"                          # ou Settings → Switch Mode
# trusted_dm_senders = ["npub1..."]          # le npub de Serbero, pour voir ses rapports (5.10)
⚠️ Quelle clé mettre dans admin_privkey ?

Mostro accepte les actions de litige venant de sa propre clé (le nsec_privkey du daemon) et des clés de solveurs enregistrés. Toute autre clé est rejetée. Seule la clé du daemon peut ajouter des solveurs : utilisez-la uniquement pour cela et gardez-la sur le serveur. Pour le travail quotidien sur les litiges, enregistrez une clé de solveur — read-write pour régler ou annuler — et mettez celle-là dans admin_privkey. Ne réutilisez jamais nsec_privkey.

ADMIN_NSEC=nsec1<daemon-key> MOSTRO_PUBKEY=<node-npub> \
  RELAYS=wss://relay.mostro.network \
  mostro-cli admaddsolver -n npub1solver...

L'option Settings → Add Dispute Solver de Mostrix fait la même chose, avec Gauche/Droite pour choisir Read ou Read-Write (Read-Write par défaut).

Le mode admin en pratique

5.3 mostro-watchdog — Alertes Telegram pour les litiges et la santé du nœud

mostro-watchdog est un bot Telegram pour votre équipe d'administration. Il surveille votre nœud via Nostr et publie dans un groupe ou un canal privé :

Option A : script d'installation (recommandé). Il télécharge la dernière release, la vérifie avec manifest.txt et l'installe dans /usr/local/bin :

curl -fsSL https://raw.githubusercontent.com/MostroP2P/mostro-watchdog/main/install.sh | bash
# ou dans un autre répertoire :
curl -fsSL https://raw.githubusercontent.com/MostroP2P/mostro-watchdog/main/install.sh | bash -s -- --install-dir ~/.local/bin

Option B : téléchargement manuel du binaire

# Linux x86_64 (Intel/AMD) ; utilisez mostro-watchdog-linux-aarch64 sur ARM64
curl -LO https://github.com/MostroP2P/mostro-watchdog/releases/latest/download/mostro-watchdog-linux-x86_64
curl -LO https://github.com/MostroP2P/mostro-watchdog/releases/latest/download/manifest.txt
sha256sum -c manifest.txt --ignore-missing
chmod +x mostro-watchdog-linux-x86_64
sudo mv mostro-watchdog-linux-x86_64 /usr/local/bin/mostro-watchdog

Les binaires macOS et Windows sont aussi sur la page des releases.

Option C : compiler depuis les sources

sudo apt install -y cmake pkg-config libssl-dev
git clone https://github.com/MostroP2P/mostro-watchdog.git
cd mostro-watchdog
cargo build --release
sudo cp target/release/mostro-watchdog /usr/local/bin/

Configuration

Le watchdog garde son état (disputes.db) à côté de config.toml : donnez-lui donc un répertoire à lui.

sudo useradd --system --home-dir /var/lib/mostro-watchdog --shell /usr/sbin/nologin mostro-watchdog
sudo install -d -o mostro-watchdog -g mostro-watchdog -m 700 /var/lib/mostro-watchdog
curl -LO https://raw.githubusercontent.com/MostroP2P/mostro-watchdog/main/config.example.toml
sudo install -o mostro-watchdog -g mostro-watchdog -m 600 config.example.toml /var/lib/mostro-watchdog/config.toml
sudo nano /var/lib/mostro-watchdog/config.toml
[mostro]
pubkey = "VOTRE_PUBKEY_MOSTRO"         # hex ou npub

[nostr]
# Relais d'amorçage : le watchdog y lit la liste de relais de votre nœud (NIP-65),
# puis suit les relais que votre nœud annonce.
relays = ["wss://relay.mostro.network", "wss://nos.lol"]

[telegram]
bot_token = "VOTRE_TOKEN_BOT"          # fourni par @BotFather
chat_id = -1001234567890              # votre groupe ou canal d'administration

[health]
info_silence_threshold = 900          # 3 × publish_mostro_info_interval de Mostro (300 par défaut)
mostro_health_enabled = true          # nécessite Mostro v0.20.0+
event_alert_threshold = 0             # voir ci-dessous

Pour trouver chat_id, ajoutez le bot au groupe, envoyez-y un message et ouvrez https://api.telegram.org/bot<TOKEN>/getUpdates.

L'ancienne alerte « silence d'événements » se déclenche dès qu'aucun événement de litige n'est arrivé pendant deux heures, ce qui, sur la plupart des nœuds, n'est qu'un après-midi calme. Les contrôles d'info et de santé détectent de façon fiable un nœud arrêté : 0 la désactive donc.

La clé Nostr du watchdog

Les détails de santé, les alertes Serbero, les pings aux solveurs et le heartbeat du watchdog lui-même exigent une clé à lui, passée uniquement par l'environnement :

sudo sh -c 'umask 077; echo "WATCHDOG_NOSTR_PRIVATE_KEY=$(openssl rand -hex 32)" > /etc/mostro-watchdog.env'

Sauvegardez ce fichier. Au démarrage, le watchdog journalise sa clé publique. Mettez-la dans le settings.toml de Mostro et redémarrez Mostro, afin que votre liquidité, vos échecs de paiement et l'expiration de vos HTLC soient chiffrés pour le seul watchdog :

[health]
watchdog_pubkey = "WATCHDOG_PUBKEY"   # hex ou npub

Cela ajoute un tag p public à votre événement de santé, qui relie votre nœud à la clé du watchdog. Sans cela, le watchdog alerte quand même sur le statut public.

Le lancer comme service

# /etc/systemd/system/mostro-watchdog.service
[Unit]
Description=mostro-watchdog
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=mostro-watchdog
WorkingDirectory=/var/lib/mostro-watchdog
EnvironmentFile=/etc/mostro-watchdog.env
ExecStart=/usr/local/bin/mostro-watchdog --config /var/lib/mostro-watchdog/config.toml
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now mostro-watchdog
journalctl -u mostro-watchdog -f

Facultatif : Serbero et alertes aux solveurs

Ajoutez une section vide pour chacune de celles que vous voulez. Les deux utilisent la clé ci-dessus :

[serbero]                 # les étapes de Serbero sur le message de chaque litige
[solver_notifications]    # pings privés aux solveurs

Pour Serbero, ajoutez aussi la clé publique hex du watchdog au config.toml de Serbero comme observateur — jamais comme solveur — et redémarrez Serbero. Les observateurs reçoivent une ligne par étape, jamais ce que les parties ont écrit. Le watchdog trouve Serbero tout seul grâce au serbero_pubkey de votre nœud (5.10).

[[observers]]
pubkey = "WATCHDOG_PUBKEY_HEX"

Pour les pings aux solveurs, chaque solveur envoie /link au bot dans un chat privé et saisit le code dans Mostrix 0.3.6 ou plus récent, sous Settings → Link Watchdog. Le bot ne répond aux commandes que dans les chats privés : /version, /link, /unlink, /status.

💡 Surveillez le watchdog

Un canal silencieux ne prouve pas que le watchdog est vivant. Vous pouvez en faire tourner un second sur une autre machine, chacun avec sa propre WATCHDOG_NOSTR_PRIVATE_KEY et la clé publique de l'autre dans [health].peer_watchdogs. Les alertes de santé peuvent aussi aller dans un chat à part avec [health].alerts_chat_id. Le config.example.toml du projet documente chaque option.

5.4 Surveillance et santé du nœud

Votre nœud doit fonctionner 24h/24 et 7j/7.

# Natif
systemctl status mostro.service
journalctl -u mostro -f
journalctl -u mostro | grep -E "(error|warn|connected)" --ignore-case

# Docker Hub (Option A)
docker ps --filter name=mostro
docker logs -f mostro

# Docker Build (Option B)
docker compose -f /opt/mostro/docker/compose.yml ps
docker compose -f /opt/mostro/docker/compose.yml logs -f mostro

Tourner n'est pas fonctionner

En octobre 2026, le LND d'un nœud en production a cessé de suivre la chaîne pendant environ 21 heures. Mostro a continué de tourner et d'accepter des transactions, mais tous les paiements aux acheteurs ont échoué. Un contrôle de processus, de port ou un robot de disponibilité auraient affiché du vert tout du long.

Depuis la v0.20.0, Mostro contrôle cela lui-même. Chaque minute, il publie un événement de santé signé (kind 38389) avec un statut global (ok, degraded ou down), un état pour chaque contrôle (lnd_sync, payouts, relays, database) et la hauteur de bloc de LND. Il est activé par défaut ; ce bloc ne montre que les valeurs par défaut :

[health]
enabled = true                  # publier l'événement de santé (kind 38389)
interval = 60                   # secondes entre deux publications, de 30 à 3600
watchdog_pubkey = ""            # la clé de votre watchdog : les métriques détaillées lui sont chiffrées (5.3)
lnd_unsynced_fail_after = 600   # doit être supérieur à 60
auto_maintenance_on_lnd_unsynced = true
lnd_resynced_clear_after = 300

Quand LND cesse d'être synchronisé, Mostro protège vos utilisateurs tout seul :

Le log raconte l'histoire : LND reports synced_to_chain = false ...; outgoing payments wait after 60s, puis maintenance mode ON (reason lnd_unsynced), et plus tard LND is synced to chain again et maintenance mode OFF. Vérifiez LND avec lncli getinfo (synced_to_chain, block_height). Définissez auto_maintenance_on_lnd_unsynced = false pour refuser la maintenance automatique.

Mostro ne sait que ce que son propre LND lui dit, et un nœud bloqué sur une chaîne périmée ne le sait pas toujours. C'est pourquoi les deux lecteurs ci-dessous comparent sa hauteur de bloc à celle d'explorateurs publics :

La page de statut publique

La page (Semáforo) lit les événements de santé directement sur les relais et les vérifie dans le navigateur du visiteur, sans backend. Chaque nœud reçoit une couleur :

CouleurQuand
🟢 OpérationnelStatut ok, un événement récent, et LND à moins de 3 blocs de retard sur les explorateurs
🟡 DégradéStatut degraded, mode maintenance, ou aucune hauteur de bloc indépendante avec laquelle comparer
🔴 Hors serviceStatut down, LND à 3 blocs de retard ou plus, ou aucun événement valide récemment (« Not reporting »)
⚪ Non surveilléListé, mais pas encore censé publier

Sous chaque nœud, 90 barres quotidiennes et un chiffre de disponibilité proviennent d'échantillons pris toutes les 10 minutes.

Faire lister votre nœud. Seuls les nœuds sélectionnés sont affichés, car n'importe qui peut signer un événement toujours vert :

  1. Votre nœud est listé comme communauté sur ce site.
  2. Il fait tourner Mostro v0.20.0 ou plus récent avec l'événement de santé activé, et publie sur au moins un de wss://relay.mostro.network, wss://mostro-p2p.tech ou wss://relay.shadowbip.com.
  3. Ouvrez une issue ou une pull request sur MostroP2P/semaforo pour l'ajouter à trusted.json avec sa pubkey hex, son nom, sa région et son réseau. Votre avatar est copié depuis la photo de profil de votre profil Nostr.

Vérifier votre nœud depuis l'extérieur

Votre nœud republie un événement d'info (kind 38385) qui le décrit : frais, devises, version de protocole, indicateur de maintenance, réglages de caution, clés Serbero et de réputation. Le lire, ainsi que l'événement de santé, depuis un relais est le moyen le plus rapide de confirmer que le monde extérieur voit bien ce que vous croyez.

cargo install nostreq nostcat
# Événement d'info
nostreq --kinds 38385 --limit 1 --authors VOTRE_MOSTRO_PUBKEY_HEX \
  | nostcat --stream wss://relay.mostro.network | jq
# Événement de santé : statut, contrôles, hauteur de bloc LND
nostreq --kinds 38389 --limit 1 --authors VOTRE_MOSTRO_PUBKEY_HEX \
  | nostcat --stream wss://relay.mostro.network | jq '.tags'
💡 Les contrôles d'hôte restent utiles

Un ping d'hôte (UptimeRobot ou équivalent) vous dit toujours quand le VPS lui-même est injoignable. Il ne peut pas vous dire si Mostro paie les acheteurs ; l'événement de santé, si.

5.5 Mettre à jour Mostro

Mettre à jour remplace le binaire mostrod et rien d'autre : settings.toml et mostro.db restent en place. Les migrations de la base de données s'appliquent d'elles-mêmes au démarrage de la nouvelle version, il n'y a donc aucune étape supplémentaire.

Avant de mettre à jour

  1. Lisez les notes de version de la version visée. Votre settings.toml n'est jamais écrasé : comparez-le avec le nouveau settings.tpl.toml. La plupart des nouvelles fonctions restent désactivées tant que vous ne les ajoutez pas, mais un bloc absent prend ses valeurs par défaut, et certaines sont activées (l'événement de santé de 5.4, par exemple).
  2. Sauvegardez la base de données avec les commandes de 5.6. Cette sauvegarde est nécessaire pour revenir en arrière.
⚠️ Si vous venez de la v0.18.x

Vérifiez ceci avant de démarrer la nouvelle version, sinon elle peut refuser de démarrer :

  • Supprimez toute ligne transport = "gift-wrap" (4.8). Les utilisateurs d'anciens clients protocole v1 doivent mettre à jour.
  • escrow_deadline_margin_blocks doit valoir au moins 18 et rester inférieur à hold_invoice_cltv_delta (4.9).
  • Sous [cashu], mint_url est devenu mint_urls = [...] (4.11).
  • Avec les cautions anti-abus activées et un hold_invoice_cltv_delta de 288 ou plus, définissez bond_cltv_delta explicitement (4.11).
  • Depuis la v0.20.0, l'événement de santé est publié par défaut, et Mostro peut passer seul en maintenance quand LND est désynchronisé (5.4).

Docker Hub (docker run)

export MOSTRO_TAG=v0.20.2
# Téléchargez d'abord : le nœud reste en service pendant le téléchargement
docker pull mostrop2p/mostro:$MOSTRO_TAG
docker stop mostro
docker rm mostro
docker run -d --name mostro \
  --restart unless-stopped \
  --add-host=host.docker.internal:host-gateway \
  -v ~/mostro-config:/config \
  mostrop2p/mostro:$MOSTRO_TAG

Utilisez les mêmes options qu'à l'installation (retirez --add-host si LND est sur un autre serveur). Si vous ne vous en souvenez plus, consultez docker inspect mostro avant de supprimer le conteneur.

⚠️ docker restart n'est pas une mise à jour

docker restart relance le même conteneur, avec l'image à partir de laquelle il a été créé. Pour lancer une nouvelle version, il faut recréer le conteneur : docker rm + docker run, ou docker compose up -d après avoir changé le tag.

Docker Hub (Docker Compose)

export MOSTRO_TAG=v0.20.2
COMPOSE=~/mostro-docker/compose.yml
# Pointez la ligne image vers le nouveau tag, puis vérifiez-la
sed -i "s|image: mostrop2p/mostro:.*|image: mostrop2p/mostro:$MOSTRO_TAG|" $COMPOSE
grep image: $COMPOSE
docker compose -f $COMPOSE pull
# Recrée le conteneur puisque l'image a changé
docker compose -f $COMPOSE up -d

Docker Build

cd /opt/mostro
git fetch --tags
git checkout v0.20.2
make docker-build
make docker-down
make docker-up

Natif

cd /opt/mostro
git fetch --tags
git checkout v0.20.2
cargo build --release
install target/release/mostrod /usr/local/bin
cargo clean
systemctl restart mostro.service

Vérifier la nouvelle version

# Docker Hub (docker run)
docker exec mostro mostrod --version
docker logs -f mostro

# Docker Hub (Docker Compose)
docker compose -f ~/mostro-docker/compose.yml exec mostro mostrod --version
docker compose -f ~/mostro-docker/compose.yml logs -f mostro

# Docker Build
docker compose -f /opt/mostro/docker/compose.yml exec mostro mostrod --version
docker compose -f /opt/mostro/docker/compose.yml logs -f mostro

# Natif
mostrod --version
journalctl -u mostro -f

Cherchez les mêmes messages de démarrage qu'au premier lancement (Étape 11 de l'Option A).

Revenir en arrière

Si la nouvelle version pose problème, revenez au tag précédent. La nouvelle version a peut-être déjà migré la base de données, et un mostrod plus ancien peut refuser de démarrer avec elle : restaurez donc la sauvegarde faite avant la mise à jour :

docker stop mostro
docker rm mostro
# remplacez YYYYMMDD par la date de la sauvegarde faite avant la mise à jour
BACKUP=/root/mostro-backups/mostro.db.YYYYMMDD
cp "$BACKUP" ~/mostro-config/mostro.db
rm -f ~/mostro-config/mostro.db-wal ~/mostro-config/mostro.db-shm
chown 1000:1000 ~/mostro-config/mostro.db
# puis lancez le tag précédent : même commande docker run,
# ou remettez l'ancien tag dans compose.yml et lancez docker compose up -d

Docker Build et natif fonctionnent de la même façon : revenez au tag précédent, recompilez et restaurez la base de données avant de démarrer.

⚠️ Ne changez pas de nœud Lightning en même temps

Mettre Mostro à jour est sûr à tout moment. Le pointer vers un autre nœud Lightning ne l'est pas : videz l'escrow d'abord, voyez 5.8.

5.6 Sauvegardes

Fichiers critiques à sauvegarder : settings.toml, le fichier .env si vous y gardez votre nsec (voir 4.1) ou votre clé d'export de réputation (4.13), et mostro.db (historique des ordres, réputation). Si vous activez l'historique du payeur (4.11), gardez les sauvegardes de la base séparées du nsec : l'historique est indexé par celui-ci.

⚠️ Ne copiez pas une base active avec cp

SQLite fonctionne en mode WAL : les écritures récentes vivent dans mostro.db-wal jusqu'à leur consolidation. Copier seulement mostro.db pendant que Mostro tourne peut produire une sauvegarde privée des transactions les plus récentes. Utilisez la commande de sauvegarde propre à SQLite, sûre sur une base active et qui écrit un fichier unique et cohérent.

# Sauvegarde manuelle — Docker Hub :
mkdir -p /root/mostro-backups
sqlite3 ~/mostro-config/mostro.db ".backup '/root/mostro-backups/mostro.db.$(date +%Y%m%d)'"
cp ~/mostro-config/settings.toml /root/mostro-backups/settings.toml.$(date +%Y%m%d)
cp ~/mostro-config/.env /root/mostro-backups/env.$(date +%Y%m%d) 2>/dev/null

# Sauvegarde manuelle — Docker Build (Option B) :
sqlite3 /opt/mostro/docker/config/mostro.db ".backup '/root/mostro-backups/mostro.db.$(date +%Y%m%d)'"
cp /opt/mostro/docker/config/settings.toml /root/mostro-backups/settings.toml.$(date +%Y%m%d)
cp /opt/mostro/docker/config/.env /root/mostro-backups/env.$(date +%Y%m%d) 2>/dev/null

# Sauvegarde manuelle — Native :
sqlite3 /opt/mostro/mostro.db ".backup '/root/mostro-backups/mostro.db.$(date +%Y%m%d)'"
cp /opt/mostro/settings.toml /root/mostro-backups/settings.toml.$(date +%Y%m%d)
cp /opt/mostro/.env /root/mostro-backups/env.$(date +%Y%m%d) 2>/dev/null

Sauvegarde quotidienne automatique (à ajouter au crontab avec crontab -e) :

# Docker Hub (Option A) :
0 3 * * * mkdir -p /root/mostro-backups && sqlite3 /root/mostro-config/mostro.db ".backup '/root/mostro-backups/mostro.db.$(date +\%Y\%m\%d)'" && cp /root/mostro-config/settings.toml /root/mostro-backups/settings.toml.$(date +\%Y\%m\%d); cp /root/mostro-config/.env /root/mostro-backups/env.$(date +\%Y\%m\%d) 2>/dev/null

# Docker Build (Option B) :
0 3 * * * mkdir -p /root/mostro-backups && sqlite3 /opt/mostro/docker/config/mostro.db ".backup '/root/mostro-backups/mostro.db.$(date +\%Y\%m\%d)'" && cp /opt/mostro/docker/config/settings.toml /root/mostro-backups/settings.toml.$(date +\%Y\%m\%d); cp /opt/mostro/docker/config/.env /root/mostro-backups/env.$(date +\%Y\%m\%d) 2>/dev/null

# Native (Option C) :
0 3 * * * mkdir -p /root/mostro-backups && sqlite3 /opt/mostro/mostro.db ".backup '/root/mostro-backups/mostro.db.$(date +\%Y\%m\%d)'" && cp /opt/mostro/settings.toml /root/mostro-backups/settings.toml.$(date +\%Y\%m\%d); cp /opt/mostro/.env /root/mostro-backups/env.$(date +\%Y\%m\%d) 2>/dev/null
⚠️ Critique

Votre nsec_privkey dans settings.toml EST l'identité de votre nœud. Si vous la perdez, vous perdez votre réputation et tous les utilisateurs doivent se reconnecter à une nouvelle identité. Conservez une copie hors ligne.

Si vous faites tourner votre propre LND

Les sauvegardes de Mostro ne couvrent pas votre nœud Lightning. Les fonds de vos canaux dépendent de deux sauvegardes de LND :

Ne sauvegardez ni ne restaurez jamais channel.db pour récupérer des canaux : une copie obsolète fait diffuser à votre nœud d'anciens états, et les pairs peuvent prendre tous les fonds de ces canaux. Les systèmes nœud-en-boîte et Voltage ont leurs propres fonctions de sauvegarde ; activez-les. La documentation de LND couvre la récupération en détail (planification de la récupération).

5.7 Vérifier l'activité des transactions

# Compter tous les ordres
sqlite3 /chemin/vers/mostro.db "SELECT COUNT(*) FROM orders;"

# Transactions réussies récentes
sqlite3 /chemin/vers/mostro.db "SELECT id, fiat_code, fiat_amount, amount, fee, status, created_at FROM orders WHERE status = 'success' ORDER BY created_at DESC LIMIT 10;"

# Ordres en attente
sqlite3 /chemin/vers/mostro.db "SELECT id, fiat_code, fiat_amount, status, created_at FROM orders WHERE status = 'pending';"

# Revenus des frais : orders.fee stocke la moitié de chaque partie, donc les frais bruts du nœud sont fee*2 et le dev fee en est déduit
sqlite3 /chemin/vers/mostro.db "SELECT SUM(fee*2) AS gross_fees, SUM(dev_fee) AS dev_fees, SUM(fee*2 - COALESCE(dev_fee, 0)) AS net_fees FROM orders WHERE status = 'success';"

5.8 Mode Maintenance et Changement de Nœud Lightning

Les hold invoices, les cautions et les paiements en vol appartiennent au nœud Lightning qui les a créés. Pointer Mostro vers un autre nœud alors que l'un d'eux est encore ouvert laisserait ces transactions en suspens : le daemon refuse donc de démarrer quand il voit une nouvelle identité LND avec de l'escrow encore lié à l'ancienne :

REFUSING TO START: Lightning node changed from ... but escrow is still bound to the old node

Le mode maintenance permet de vider d'abord. Tant qu'il est actif, les nouveaux ordres et prises sont refusés et les transactions ouvertes continuent, afin que l'escrow puisse se régler. Il exige l'interface RPC activée (voir 4.7), et l'appel n'est accepté que depuis le loopback : lancez-le sur l'hôte du nœud, ou via ssh -N -L 50051:127.0.0.1:50051 user@node.

Mostro peut aussi passer seul en maintenance, avec la raison lnd_unsynced, quand LND se désynchronise (5.4). Si vous activez la maintenance pendant que celle-ci est active, elle devient la vôtre et le daemon ne la lèvera pas ; vous ne pouvez pas utiliser lnd_unsynced comme votre propre raison.

  1. Annoncez la fenêtre à vos utilisateurs bien à l'avance.
  2. Activez le mode maintenance : mostro-cli admsetmaintenance -e true -r "LN node migration".
  3. Interrogez mostro-cli admmaintenancestatus jusqu'à ce qu'il indique drained = true. Les ordres en attente expirent d'eux-mêmes ; pour raccourcir la vidange, vous pouvez en annuler un avec mostro-cli admcancelpending -o <order-id>, ce qui libère aussitôt la caution du créateur. Annoncez-le d'abord, c'est l'ordre de l'utilisateur. Clôturez les litiges de longue durée comme d'habitude.
  4. Gardez l'ancien nœud en ligne tout du long. Il doit encore terminer les paiements en vol.
  5. Arrêtez Mostro et sauvegardez mostro.db.
  6. Pointez [lightning] vers le nouveau nœud et laissez allow_node_change = false.
  7. Démarrez Mostro. Il enregistre la nouvelle pubkey. Désactivez le mode maintenance et testez avec un ordre.
  8. Ce n'est qu'alors que vous pouvez décommissionner l'ancien nœud.
⚠️ allow_node_change

Ne le passez à true que pour une reprise après sinistre, quand l'ancien nœud est définitivement perdu. Cela laisse sciemment les transactions concernées non résolues. Déplacer le même nœud vers un autre hôte n'est pas un changement de nœud et ne nécessite rien de tout cela.

5.9 Commandes d'Opérateur avec mostro-cli

Mostrix est la façon confortable de traiter les litiges, et mostro-cli couvre l'essentiel depuis un shell, plus quelques commandes d'opérateur que Mostrix n'a pas. Les commandes de litige sont signées avec une clé Nostr passée en ADMIN_NSEC, qui doit être celle du daemon lui-même ou celle d'un solveur enregistré. Le CLI ne lit aucun fichier de configuration : définissez votre nœud et vos relais dans l'environnement, et placez les options globales avant la sous-commande.

# Traitement des litiges (via Nostr)
export MOSTRO_PUBKEY=npub1...            # votre nœud
export RELAYS=wss://relay.mostro.network
export ADMIN_NSEC=nsec1...
mostro-cli listdisputes
mostro-cli admtakedispute -d <dispute-id>     # affiche les pubkeys de l'acheteur et du vendeur
mostro-cli getadmindm -s 120
mostro-cli admsenddm -p <party-pubkey> -m "message à une partie"
mostro-cli admsettle -o <order-id> [--slashseller] [--slashbuyer]   # libérer vers l'acheteur
mostro-cli admcancel -o <order-id> [--slashseller] [--slashbuyer]   # rembourser le vendeur

# Enregistrer un arbitre, éventuellement en lecture seule
mostro-cli admaddsolver -n npub1...:read

Les options de confiscation ne comptent qu'avec les cautions anti-abus (4.11). Notez l'orthographe : --slashseller, pas --slash-seller. admsenddm envoie un message direct depuis la clé admin ; ce n'est pas le chat par litige qu'utilisent l'application Mostro, Mostrix et Bosstro : privilégiez donc ces clients pour parler aux parties.

Un autre groupe de commandes passe par le gRPC d'administration plutôt que par Nostr : elles nécessitent l'interface RPC activée (voir 4.7) plutôt qu'ADMIN_NSEC. MOSTRO_RPC_URL vaut par défaut http://127.0.0.1:50051, et MOSTRO_RPC_TOKEN n'est nécessaire que si vous avez défini auth_token.

export MOSTRO_RPC_URL=http://127.0.0.1:50051
export MOSTRO_RPC_TOKEN=votre-token-auth

mostro-cli admsetmaintenance -e true -r "motif"
mostro-cli admmaintenancestatus
mostro-cli admcancelpending -o <order-id>

admcancelpending mérite d'être connu en dehors d'une migration. Il annule un ordre encore en attente ou attendant une caution, prévient le créateur et libère toutes ses cautions d'un coup. Utilisez-le pour un ordre clairement abandonné ou mal valorisé, et prévenez le créateur d'abord : c'est son ordre, et ce n'est pas une résolution de litige.

mostro-cli n'a pas encore de commandes pour l'import et l'export de réputation, l'historique du payeur ou l'événement de santé : utilisez grpcurl pour les RPC de réputation (4.13) et les commandes de 5.4 pour l'événement de santé. Installez-le avec cargo install mostro-cli (Rust 1.97 ou plus récent) ou prenez un binaire dans ses releases ; lancez mostro-cli <command> --help pour chaque option.

5.10 Serbero — Assistant de litiges

Serbero est un assistant facultatif pour les litiges de votre nœud. Vous le faites tourner à côté de Mostro, avec une clé Nostr à lui. Il a deux missions :

Serbero ne déplace jamais de fonds et ne tranche jamais un litige. Mostro l'enregistre comme solveur en lecture seule : il ne peut donc ni régler ni annuler, et tout solveur read-write peut lui reprendre un litige à tout moment. Si Serbero est arrêté, Mostro et vos solveurs fonctionnent exactement comme avant. Gardez au moins un solveur humain read-write.

Installer

Chaque release propose des binaires pour Linux (x86_64, aarch64) et macOS (Apple silicon), chacun avec un fichier SHA-256. Les noms de fichier portent la version :

V=$(curl -fsSL https://api.github.com/repos/MostroP2P/serbero/releases/latest | grep -m1 '"tag_name"' | cut -d'"' -f4)
A=serbero-$V-x86_64-unknown-linux-gnu        # aarch64-unknown-linux-gnu sur ARM64
curl -LO https://github.com/MostroP2P/serbero/releases/download/$V/$A.tar.gz
curl -LO https://github.com/MostroP2P/serbero/releases/download/$V/$A.tar.gz.sha256
shasum -a 256 -c $A.tar.gz.sha256
tar -xzf $A.tar.gz && cd $A        # serbero, config.sample.toml, deploy/

Avec Rust installé, cargo install serbero --locked fonctionne aussi. Une image Docker (ghcr.io/mostrop2p/serbero) et un fichier compose sont décrits dans le README du projet.

Configurer

cp config.sample.toml config.toml
nano config.toml
[serbero]
private_key_env = "SERBERO_PRIVATE_KEY"   # nomme le secret ; la clé ne va jamais dans ce fichier
db_path = "serbero.db"

[mostro]
pubkey = "VOTRE_MOSTRO_PUBKEY_HEX"
relays = ["wss://relay.mostro.network", "wss://nos.lol"]   # relais sur lesquels votre nœud publie

# Une entrée par solveur humain : la pubkey hex de la clé que son client utilise
# (Mostrix : admin_privkey). Ne listez jamais la clé de Serbero lui-même.
[[solvers]]
pubkey = "SOLVER_PUBKEY_HEX"
permission = "write"

[notify]
renotify_after = "15m"

[mediation]
enabled = false

Le lancer comme service

Le projet fournit une unité systemd durcie. Téléchargez-la depuis main : la copie contenue dans l'archive v0.2.5 exige systemd 251 et ne démarre pas sur Ubuntu 22.04.

sudo useradd --system --home-dir /var/lib/serbero --shell /usr/sbin/nologin serbero
sudo install -m 755 serbero /usr/local/bin/serbero
sudo install -d -m 755 /etc/serbero
sudo install -m 644 config.toml /etc/serbero/config.toml
sudo install -d -m 700 /etc/serbero/credentials
sudo sh -c 'umask 077; openssl rand -hex 32 > /etc/serbero/credentials/serbero_private_key'
curl -fsSLO https://raw.githubusercontent.com/MostroP2P/serbero/main/deploy/serbero.service
sudo install -m 644 serbero.service /etc/systemd/system/serbero.service
sudo systemctl daemon-reload && sudo systemctl enable --now serbero
journalctl -u serbero -f        # notez le npub qu'il journalise au démarrage

Sauvegardez /etc/serbero/credentials/serbero_private_key hors ligne. C'est l'identité de Serbero : si vous la perdez, vous devez enregistrer un nouveau npub.

L'enregistrer sur votre nœud

Mostro v0.19.1 ou plus récent enregistre Serbero pour vous. Ajoutez son npub au bloc [mostro] de votre settings.toml et redémarrez Mostro :

[mostro]
serbero_pubkey = "npub1..."   # la clé de Serbero, npub ou hex

Au démarrage, Mostro enregistre cette clé comme solveur en lecture seule et l'annonce dans son événement d'info. Cette annonce permet à l'application Mostro d'étiqueter les messages de Serbero et à mostro-watchdog de le trouver. Le log le confirme : Serbero npub1... configured: registered as a read-only solver.

⚠️ N'ajoutez pas Serbero avec admaddsolver

Un npub nu ajouté avec admaddsolver devient read-write (5.1), et Mostro refuse alors de démarrer avec REFUSING TO START: serbero_pubkey ... is a solver with write permission. Il refuse aussi une clé appartenant à un utilisateur qui n'est pas solveur, et la clé de votre propre nœud. Donnez à Serbero une clé à lui et laissez serbero_pubkey l'enregistrer.

Vos solveurs lisent Serbero dans Mostrix

Mostrix 0.3.5 ou plus récent affiche les messages de Serbero dans un panneau SERBERO pour chaque litige, mais seulement ceux d'expéditeurs auxquels le solveur fait confiance. Dans le ~/.mostrix/settings.toml de chaque solveur :

trusted_dm_senders = ["npub1..."]   # le npub de Serbero

La pubkey de l'admin_privkey du solveur doit être exactement celle d'une entrée [[solvers]], et Mostrix doit lire au moins l'un des relais de Serbero. Pour reprendre un cas, appuyez sur Ctrl+T sur un transfert ; cela exige la permission read-write, et Serbero cesse aussitôt d'écrire. Bosstro (5.11) n'affiche pas encore les résumés de Serbero.

Activer la médiation (pilote)

La médiation est livrée désactivée. Activée, Serbero prend chaque nouveau litige et se présente aux deux parties comme un assistant automatisé, dans leur langue (anglais, espagnol ou portugais), une courte question à la fois. Quand les deux ont répondu, il leur laisse 30 minutes pour régler la transaction eux-mêmes, puis confie le cas à vos solveurs. Il ne dit jamais à personne de libérer ou d'annuler.

Pour lire les réponses, Serbero interroge un modèle juge (Jev de TypeSafe) sur votre propre compte payant. Le juge reçoit les rôles de la transaction, le montant, la devise et le moyen de paiement, ainsi que le texte des messages — jamais les clés publiques. Demandez au fournisseur une rétention de données nulle, et prévenez vos utilisateurs que les messages de litige sont traités par un service automatisé. Le README explique la clé d'API et le tableau des seuils ; définissez enabled = true sous [mediation] et redémarrez, et le log indique mediation ready ou pourquoi ce n'est pas le cas.

Les messages des parties sont des événements kind 14 : utilisez plus d'un relais, et seulement des relais qui les stockent, sinon les messages envoyés pendant que Serbero est hors ligne sont perdus. Pour publier la progression de Serbero sur le Telegram de votre équipe, enregistrez mostro-watchdog comme observateur (5.3). Sauvegardez serbero.db en privé : il contient les conversations des litiges.

5.11 Bosstro — Résoudre des litiges depuis un téléphone

Bosstro est l'application Android pour les solveurs de litiges. Elle apporte le côté admin de Mostrix sur un téléphone : un solveur voit les litiges en attente de votre nœud, en prend un, discute avec l'acheteur et le vendeur (images et PDF compris), lit le chat propre des parties quand l'une d'elles partage sa clé et, avec la permission read-write, paie l'acheteur ou rembourse le vendeur, avec l'option de caution quand votre nœud en a.

C'est un outil pour vos solveurs, pas pour échanger, et il ne détient jamais la clé de votre nœud. L'enregistrement des solveurs se fait toujours depuis Mostrix ou mostro-cli (5.2).

Installer et vérifier

Android 7.0 ou plus récent. Téléchargez l'APK depuis GitHub Releases : arm64-v8a pour presque tous les téléphones, armeabi-v7a pour un ancien modèle 32 bits. Comparez-le au fichier de sommes de contrôle de la release :

sha256sum -c SHA256SUMS.txt --ignore-missing

La somme de contrôle prouve seulement que le téléchargement est complet. Le certificat de signature prouve qui l'a compilé, et Android refuse une mise à jour signée avec une autre clé. Comparez-le avec AppVerifier :

foundation.mostro.bosstro
63:92:27:84:C2:E3:2A:F4:B6:03:0F:5E:2A:18:1F:74:9B:F6:95:E5:2F:1C:A8:45:7E:98:CB:05:D2:9E:B3:4B

Ajouter un solveur

  1. Le solveur ouvre Bosstro, touche Create new account (ou Log in avec un nsec de solveur existant) et vous envoie le npub. Cette clé ne doit servir à rien d'autre — jamais la clé d'une application de trading, sinon les deux rôles sont reliés publiquement.
  2. Vous l'enregistrez, en lecture seule pour commencer (5.1) :
    ADMIN_NSEC=nsec1... mostro-cli admaddsolver -n npub1solver...:read
  3. Le solveur choisit votre nœud dans Bosstro : Mostro, une communauté de la liste, ou votre propre pubkey et vos relais. Bosstro apprend, d'après les réponses de votre nœud, si la clé est celle d'un solveur et avec quelle permission.
⚠️ Limites actuelles

Bosstro ne parle que le protocole v2 (4.8). La version 0.1 n'affiche pas les résumés de transfert de Serbero et n'a pas encore de notifications push : les solveurs qui travaillent avec Serbero ont donc encore besoin de Mostrix pour cela. Un solveur read-write peut reprendre un litige à Serbero dans Bosstro.

6. Détail des Coûts

Coûts opérationnels mensuels

PosteCoût mensuelNotes
VPS (serveur)10–24 $Dépend du fournisseur et des spécifications
Nom de domaine (optionnel)1–2 $Pour un site web/identité
Frais onchain des canaux LightningVariableOuverture/fermeture de canaux
Total mensuel11–26 $Hors liquidité Lightning

Coûts uniques / de capital

PosteCoûtNotes
Liquidité Lightning0.01–1.0+ BTCBloqué dans les canaux ; récupéré à la fermeture
Matériel du nœud (si auto-hébergé)0–600 $Gratuit si VPS ; 300-600 $ pour Start9/Umbrel
Temps de configuration4–16 heuresSelon le niveau d'expérience

Potentiel de revenus

Volume mensuelFrais (0.6%)Contribution dev (30%)Revenu net
1 000 $~6 $~1,80 $~4,20 $
10 000 $~60 $~18 $~42 $
50 000 $~300 $~90 $~210 $
100 000 $~600 $~180 $~420 $
📝 Réalité

La plupart des nœuds nouveaux mettent des mois à construire du volume. N'attendez pas de rentabilité immédiate. La vraie valeur vient souvent du service rendu à votre communauté, les frais étant un bonus.

Engagement en temps

TâcheFréquenceTemps
Surveillance (vérifier les logs, le statut)Quotidien5–10 min
Résolution de litigesSelon les besoins15–60 min par litige
Mises à jourMensuel15–30 min
Gestion de la liquiditéHebdomadaire15–30 min
Estimation hebdomadaire totale1–3 heures

7. Questions Fréquentes

Faut-il être développeur pour faire tourner un nœud Mostro ?

Non, mais vous devez être à l'aise avec les opérations basiques en ligne de commande (taper des commandes, éditer des fichiers texte). La voie Docker (Option A) est conçue pour être accessible.

Puis-je faire tourner Mostro sur un Raspberry Pi ?

Beaucoup de gens font tourner LND sur un Raspberry Pi 4 ou 5 avec un SSD, via Start9, Umbrel ou RaspiBlitz, et le paquet Mostro de StartOS peut tourner à côté. Pour un nœud dont dépend votre communauté, un VPS est plus fiable qu'une connexion et une alimentation domestiques. Un compromis courant : LND à la maison et Mostro sur un VPS, reliés par un VPN (voir 2.2).

Puis-je utiliser Core Lightning (CLN) au lieu de LND ?

Non. Mostro ne supporte actuellement que LND, car il dépend de l'implémentation spécifique des hold invoices de LND. Le support d'autres implémentations pourrait arriver à l'avenir.

Comment les utilisateurs se connectent-ils à mon Mostro ?

Les utilisateurs ont besoin d'un client Mostro — l'application Mostro pour Android, iOS, ordinateur et web, ou mostro-cli ou Mostrix — et de la clé publique de votre Mostro (npub). Dans l'application, ils vont dans Paramètres → Réseau → Nœud Mostro → Ajouter votre propre nœud et collent votre npub ; les nœuds listés sur ce site y apparaissent déjà. Le client communique via les relays Nostr. Aucune connexion directe n'est nécessaire.

Mon nœud peut-il encore servir d'anciens clients (protocole v1) ?

Non. Depuis la v0.19.0, Mostro ne parle que le protocole v2 (4.8). Les utilisateurs d'un ancien client doivent passer à l'application Mostro ou à un Mostrix ou mostro-cli récent.

Mes utilisateurs peuvent-ils échanger de l'USDT, du Liquid ou du Rootstock au lieu du fiat ?

Oui, depuis la v0.20.2 : USDT, USDC, DOC, BTC on-chain, LBTC et RBTC. Vous les activez un par un, et vos solveurs doivent savoir vérifier ces transferts. Voyez 4.12.

Les utilisateurs peuvent-ils apporter leur réputation de lnp2pBot ou d'un autre Mostro ?

Oui, si vous faites confiance à la source. Activez l'import de réputation et ajoutez la clé de lnp2pBot, ou celle d'un nœud Mostro de confiance (4.13). Vous pouvez aussi laisser vos utilisateurs exporter la réputation acquise sur votre nœud.

Puis-je faire tourner plusieurs instances de Mostro ?

Oui, mais chacune nécessite sa propre paire de clés Nostr, son nœud LND (ou au moins des canaux/liquidité séparés) et sa configuration.

Est-ce légal ?

Cela dépend beaucoup de votre juridiction. Mostro est un logiciel d'échange peer-to-peer. Dans certaines juridictions, opérer un exchange P2P peut nécessiter des licences. Consultez les réglementations locales et un conseiller juridique.

Quelle bande passante utilise Mostro ?

Très peu — principalement de petits événements Nostr. Quelques Go par mois est typique même avec un volume modéré.

Que se passe-t-il si mon nœud se déconnecte ?

Les ordres en attente finissent par expirer. Les transactions actives avec des fonds bloqués continuent quand vous revenez en ligne. Si vous êtes hors ligne trop longtemps, les utilisateurs peuvent perdre confiance. Depuis la v0.18.3, il existe aussi une échéance pour l'escrow : si le nœud reste hors ligne assez longtemps pour que la hold invoice approche son horizon CLTV, LND l'annule et le vendeur est remboursé automatiquement. Si c'est votre LND qui se désynchronise alors que Mostro continue de tourner, les paiements attendent au lieu d'échouer et, au bout de 10 minutes, le nœud passe seul en maintenance jusqu'à ce que LND récupère (5.4).

Puis-je changer ma clé Nostr après ?

Vous pouvez, mais vous perdrez l'identité et la réputation de votre nœud. Les utilisateurs le verront comme un nouveau Mostro. Traitez votre clé comme votre identité de marque.

Puis-je perdre de l'argent en faisant tourner un nœud Mostro ?

Oui, c'est possible : les fonds dans les canaux Lightning pourraient être à risque à cause de bugs (rare) ; la fermeture forcée de canaux pendant des périodes de frais élevés peut être coûteuse ; les coûts VPS sont continus.

La liquidité Lightning est-elle « à risque » ?

Votre liquidité Lightning est la vôtre. Elle n'est pas en danger à cause de Mostro en soi — les hold invoices sont des blocages temporaires. Cependant, les risques standard du Lightning Network s'appliquent (fermetures forcées, canaux bloqués, bugs).

Quand atteindrai-je le seuil de rentabilité ?

Cela dépend de vos coûts et du volume de transactions. Avec 20 $/mois de coûts et 0.6% de frais, vous avez besoin d'environ 5 000 $/mois en transactions pour couvrir les coûts (avant la contribution au développement). La plupart des communautés mettent 3–6 mois à atteindre un volume significatif.

Puis-je déplacer Mostro vers un autre nœud Lightning ?

Oui, mais pas en modifiant la configuration puis en redémarrant. L'escrow est lié au nœud qui l'a créé : on le vide d'abord en mode maintenance, et le daemon refuse de démarrer si vous sautez cette étape. Déplacer le même nœud vers un autre hôte n'est pas un changement de nœud et ne demande rien de particulier. Voyez 5.8.

8. Considérations de Sécurité

⚠️ Avertissement — logiciel en phase précoce

Mostro est en phase précoce de développement. Bien que l'équipe travaille dur pour assurer la fiabilité, des bugs non découverts peuvent exister — y compris des bugs de sécurité pouvant entraîner une perte de fonds. Les développeurs ne sont pas responsables de toute perte d'argent due à des bugs logiciels.

Mostro est open source et son code est ouvert aux audits. Nous encourageons les communautés à promouvoir et financer des audits de sécurité indépendants.

Cela dit, le mécanisme central de séquestre utilisant les hold invoices Lightning a été éprouvé depuis 2021, quand @lnp2pBot a implémenté pour la première fois ce type de séquestre. Des milliers de transactions ont été réalisées avec succès.

Gardez la Clé de Votre Nœud Hors d'Atteinte

Votre nsec_privkey est l'identité de votre nœud, et quiconque la détient peut usurper votre Mostro. Préférez la fournir par la variable d'environnement MOSTRO_NSEC_PRIVKEY ou par un fichier .env en chmod 600 plutôt que de la laisser dans settings.toml (voir 4.1). Ne l'emportez pas non plus sur un portable pour traiter les litiges : enregistrez une clé de solveur distincte pour cela (voir 5.2).

Opérer sous des régimes autoritaires

Si vous opérez dans un pays avec un gouvernement autoritaire, la confidentialité n'est pas optionnelle — c'est une exigence de sécurité.

  1. Faites tourner votre nœud Mostro derrière Tor et/ou un VPN. Cela masque l'IP de votre serveur vis-à-vis des relays Nostr.
  2. Si Tor/VPN n'est pas possible (courant dans les pays en développement avec un internet lent), publiez uniquement des événements sur des relays que vous possédez ou en lesquels vous avez confiance.
  3. Soyez très prudent avec les relays que vous utilisez. À l'avenir, les gouvernements pourraient créer des relays Nostr spécifiquement pour collecter des adresses IP.
  4. Pensez également à la confidentialité de votre nœud Lightning. Faire tourner LND derrière Tor est possible et recommandé dans les environnements sensibles. Votre événement d'info publie la pubkey de LND et les adresses qu'il annonce : faites donc annoncer à LND uniquement des adresses Tor.
  5. Sachez ce que votre nœud publie. L'événement de santé (5.4) est public : statut, hauteur de bloc et réseau de LND, version de Mostro. Définir un watchdog_pubkey ajoute un tag qui relie votre nœud à cette clé. Désactivez-le avec [health] enabled = false si cela compte plus que la surveillance.
  6. Les variables de proxy ne suffisent pas. Les résolutions d'adresses Lightning ignorent volontairement HTTP_PROXY/HTTPS_PROXY. Pour masquer l'IP du serveur, faites passer toute la machine par Tor ou un VPN.
💡 Conseil

La beauté de Mostro étant décentralisé est que même si un nœud est arrêté, les autres continuent de fonctionner. Mais la prévention est toujours préférable à la guérison. Prenez la confidentialité au sérieux dès le premier jour.

9. Dépannage

Mostro ne démarre pas

dev_fee_percentage (0.05) is below minimum (0.1)

Définissez dev_fee_percentage à au moins 0.10 dans settings.toml.

Fichier de configuration ou base de données introuvable

Assurez-vous que le flag -d pointe vers le répertoire contenant settings.toml. Pour Docker Hub : vérifiez que ~/mostro-config/settings.toml existe.

Mostro s'arrête au démarrage avec Ln node error

REFUSING TO START: Lightning node changed

Mostro pointe vers une autre identité LND alors que de l'escrow est encore ouvert sur l'ancienne. Reconnectez l'ancien nœud et videz-le avant de changer. Voyez 5.8.

transport = "gift-wrap" (protocol v1) is no longer supported

Supprimez la ligne transport de settings.toml. Voyez 4.8.

escrow_deadline_margin_blocks (X) must be at least 18 ... ou ... must be below hold_invoice_cltv_delta

Réglez la marge entre 18 et hold_invoice_cltv_delta ; les 24 du modèle avec 144 conviennent. Voyez 4.9.

unknown field mint_url

Dans [cashu], renommez-le en mint_urls = ["..."]. Voyez 4.11.

anti_abuse_bond.bond_cltv_delta ... must be above hold_invoice_cltv_delta + 144 ou ... must be at most 864

Définissez bond_cltv_delta explicitement dans ces bornes. En v0.20.2, des cautions avec un hold_invoice_cltv_delta de 288 ou plus déclenchent cette erreur avec la valeur par défaut. Voyez 4.11.

REFUSING TO START: serbero_pubkey ...

La clé de Serbero est déjà un solveur read-write, appartient à un utilisateur, ou est la clé de votre propre nœud. Donnez à Serbero une clé à lui. Voyez 5.10.

Des réglages de réputation empêchent le démarrage

Les noms d'émetteurs doivent être uniques et chaque clé valide et listée une seule fois ; la clé d'un émetteur ne doit jamais passer à un autre nom une fois qu'elle a des imports. Avec l'export activé, MOSTRO_REPUTATION_ISSUER_SK doit être définie, valide, différente de la clé de votre nœud et absente de votre propre liste d'import. Voyez 4.13.

Les clients ne voient pas mes ordres, ou ne peuvent pas écrire à mon nœud

Votre nœud ne parle que le protocole v2. Un utilisateur d'un ancien client limité au protocole v1 n'obtient aucune réponse et doit mettre à jour (4.8). Vérifiez aussi que les clients et votre nœud partagent au moins un relais.

Les paiements échouent avec « no route »

Vérifiez payment_cltv_limit. Il doit se situer au moins 576 blocs au-dessus de max_final_cltv_expiry_delta et ne pas dépasser le --max-cltv-expiry de votre LND. Voyez 4.9.

Problèmes de connexion

Mostro démarre mais ne se connecte pas aux relays

Problèmes de transactions

Un utilisateur reçoit "cant-do: too_many_requests" lors de la restauration de session

Cela se produit lorsque l'utilisateur a plus d'ordres (historiques + actifs) que la valeur de max_orders_per_response dans votre configuration. Le client essaie de récupérer tous ses ordres d'un coup et Mostro le rejette. Ce n'est pas un bannissement ni un blocage temporaire — cela continuera tant que vous n'ajustez pas la valeur.

# Dans settings.toml, augmentez la limite :
max_orders_per_response = 50  # 10 par défaut, maximum 255

La valeur tient sur un seul octet : 255 est donc le plafond. Si un utilisateur a plus d'ordres que cela, il doit purger son historique plutôt que vous continuiez à relever la limite.

Les ordres n'apparaissent pas dans les clients

Paiements échouant

Les paiements ne partent pas, mais il n'y a aucune erreur

Vérifiez si LND est synchronisé : lncli getinfo. Tant qu'il ne l'est pas, Mostro retient les paiements volontairement et les renvoie dès que LND récupère (5.4).

Les utilisateurs reçoivent des refus « maintenance » alors que je ne l'ai jamais activée

mostro-cli admmaintenancestatus montre la raison. lnd_unsynced signifie que Mostro l'a activée parce que LND s'est désynchronisé ; il la lève de lui-même 5 minutes après que LND est de nouveau synchronisé (5.4).

Les frais de développement ne sont jamais payés

Sur testnet, signet ou regtest, c'est normal : les frais de développement ne sont payés que sur mainnet (4.2).

Les ordres au prix du marché dans une devise sont refusés

Votre nœud n'a aucun taux pour elle. Vérifiez les avertissements price: du log de démarrage : un bloc [price] sans source de marché activée, ou un stablecoin coté mais absent de fiat_currencies_accepted, en sont les causes habituelles. Voyez 4.10 et 4.12.

Problèmes de base de données

Erreurs de base de données verrouillée

ps aux | grep mostrod
# S'il y a plusieurs processus, supprimez les extras :
kill <PID>

Obtenir de l'aide

  1. Vérifiez les logs d'abord — la plupart des erreurs expliquent ce qui a mal tourné
  2. Telegram (Développeurs) : @mostro_dev
  3. Telegram (Communauté) : @MostroP2P
  4. GitHub Issues : github.com/MostroP2P/mostro/issues
  5. DeepWiki : deepwiki.com/MostroP2P/mostro

Quand vous demandez de l'aide, incluez toujours : votre version de Mostro, les logs pertinents, et ce que vous avez déjà essayé.

Annexe : Référence Rapide

Emplacements importants des fichiers

FichierDocker HubNatif
Configuration~/mostro-config/settings.toml/opt/mostro/settings.toml
Base de données~/mostro-config/mostro.db/opt/mostro/mostro.db
Cert LND~/mostro-config/lnd/tls.certVariable (voir config LND)
Macaroon LND~/mostro-config/lnd/mostro.macaroonVariable (voir config LND)
ServiceN/A/etc/systemd/system/mostro.service
Logsdocker logs -f mostrojournalctl -u mostro

Commandes essentielles

# Docker
docker logs -f mostro         # Voir les logs
docker restart mostro          # Redémarrer
docker stop mostro             # Arrêter

# Natif (systemd)
systemctl start mostro         # Démarrer
systemctl stop mostro          # Arrêter
systemctl restart mostro       # Redémarrer
systemctl status mostro        # Voir le statut
journalctl -u mostro -f        # Voir les logs

# Base de données
sqlite3 mostro.db "SELECT COUNT(*) FROM orders;"                           # Total des ordres
sqlite3 mostro.db "SELECT COUNT(*) FROM orders WHERE status='success';"    # Transactions réussies
sqlite3 mostro.db "SELECT SUM(fee*2 - COALESCE(dev_fee, 0)) FROM orders WHERE status='success';"  # Frais nets conservés par le nœud

Configuration recommandée pour les nouveaux nœuds

[mostro]
fee = 0.006
max_order_amount = 500000
min_payment_amount = 1000
expiration_hours = 24
expiration_seconds = 900
pow = 0
dev_fee_percentage = 0.30
fiat_currencies_accepted = ['USD']  # Changez pour votre devise locale

[nostr]
relays = [
  'wss://relay.mostro.network',
  'wss://nos.lol',
  'wss://relay.nostr.band'
]

Ce guide est maintenu par la communauté Mostro. Vous avez trouvé une erreur ou souhaitez l'améliorer ?
Les contributions sont les bienvenues sur github.com/MostroP2P/community

Dernière mise à jour : Octobre 2026 · Mostro v0.20.2