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 :
- Lightning Network — une couche de paiements rapides et peu coûteux pour Bitcoin (pensez-y comme la voie express de Bitcoin pour les petits paiements agiles)
- Nostr — un protocole de communication résistant à la censure (pensez-y comme un système de messagerie que personne ne peut éteindre)
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 ?
- 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.
- 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.
- 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.
- Indépendance — Aucune entreprise ne peut fermer votre exchange. Aucun gouvernement ne peut faire pression sur un opérateur unique pour le faire fermer.
- Personnalisation — Vous choisissez quelles devises supporter, quelles méthodes de paiement autoriser et quels frais facturer.
Comment fonctionne Mostro (Simplifié)
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 :
| Ressource | Minimum | Recommandé |
|---|---|---|
| CPU | 2 vCPUs (partagés) | 2+ vCPUs |
| RAM | 2 Go | 4 Go |
| Stockage | 60 Go SSD | 100 Go SSD |
| Bande passante | 3 To/mois | 3+ To/mois |
| OS | Ubuntu 22.04+ LTS | Ubuntu 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 :
- Hostinger — à partir d'environ 7 $/mois (prix promotionnel ; le renouvellement peut être plus élevé) (KVM 2 : 2 vCPU, 8 Go RAM, 100 Go NVMe, 8 To de bande passante) · Accepte le Bitcoin
- Hetzner — 3,49–8 €/mois (CX23 à partir de 3,49 €, bon rapport qualité-prix, basé dans l'UE)
- Digital Ocean — 24 $/mois (4 Go RAM, 2 CPUs, 80 Go SSD) ou 32 $/mois (4 Go RAM, 2 Intel CPUs, 120 Go NVMe)
- OVH — environ 6–12 $/mois
- Linode/Akamai — 12 $/mois
- Lunanode — Accepte les paiements en Bitcoin
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 :
| Option | Difficulté | Coût | Notes |
|---|---|---|---|
| Utiliser un nœud LND existant | Facile | Gratuit (si vous en avez un) | Idéal si quelqu'un en a déjà un |
| Faire tourner LND sur le même VPS | Difficile | VPS plus gros + liquidité | 4 Go+ de RAM, et du disque pour le backend Bitcoin (voir ci-dessous) |
| Solution nœud-en-boîte | Moyen | 200–600 $ + liquidité | Start9, Umbrel, RaspiBlitz |
| StartOS avec le paquet Mostro | Plus facile | 300–600 $ + liquidité | Start9 dispose d'un paquet Mostro en un clic |
| Utiliser Voltage.cloud | Facile | À partir d'environ 20 $/mois + liquidité | Voltage — LND hébergé avec infrastructure gérée |
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 :
- Le fichier
tls.cert(un certificat de sécurité) - Un fichier
mostro.macaroondédié (un jeton d'authentification avec uniquement les permissions dont Mostro a besoin, voir ci-dessous) - L'adresse gRPC (typiquement
https://127.0.0.1:10009si sur la même machine)
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 :
- Par défaut, LND n'écoute que sur
localhost. Un Mostro sur la même machine l'atteint àhttps://127.0.0.1:10009; tout le reste (un conteneur Docker, un autre serveur) demande les étapes supplémentaires ci-dessous. - Mostro épingle le certificat. Il accepte exactement le certificat de
tls.certet ignore le nom d'hôte, donc vous n'avez pas besoin detlsextraipni detlsextradomain. Mais si LND régénère son certificat (il expire après environ 14 mois), copiez le nouveautls.certvers Mostro et redémarrez-le, sinon il s'arrête au démarrage avecLn node error. - Pas de Tor pour ce lien. Mostro ne peut pas joindre LND via Tor ni via un proxy SOCKS. Un LND distant doit être joignable par le réseau : utilisez un VPN.
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 :
| Backend | Disque | Compromis |
|---|---|---|
bitcoind, nœud complet | Plus de 700 Go | Le plus robuste. La synchronisation initiale prend des jours. |
bitcoind, élagué | Des dizaines de Go | Supporté par LND et robuste ; la synchronisation initiale prend toujours des jours. |
neutrino | Quelques Go | Pas 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 :
- Réseau hôte (le plus simple). Lancez le conteneur avec
--network hostau lieu de--add-host=host.docker.internal:host-gateway(dans compose,network_mode: hostau lieu deextra_hosts) et définissezlnd_grpc_host = 'https://127.0.0.1:10009'. LND continue de n'écouter que surlocalhost. - Gardez le réseau bridge et
host.docker.internal, comme dans l'Option A. LND doit alors écouter au-delà delocalhost(ajoutezrpclisten=0.0.0.0:10009àlnd.conf) et votre pare-feu doit garder le port 10009 fermé à Internet, par exempleufw allow from 172.16.0.0/12 to any port 10009 proto tcpsuivi deufw deny 10009/tcp. Si UFW n'est pas encore actif, autorisez d'abord SSH (ufw allow OpenSSH) puis lancezufw enable: inactif, il n'applique aucune de ces règles.
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
invoices.holdexpirydelta(par défaut 12) : si vous l'augmentez, augmentezescrow_deadline_margin_blockspour qu'il reste d'au moins 6 blocs au-dessus (4.9).max-cltv-expiry(par défaut 2016) : lepayment_cltv_limitde Mostro ne doit pas le dépasser (4.9).- Gardez en sécurité la seed du portefeuille de LND et la sauvegarde des canaux : voir 5.6.
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ée | BTC approximatif |
|---|---|---|
| Petite communauté (quelques transactions/jour) | 1–5 millions de sats | 0.01–0.05 BTC |
| Communauté moyenne | 5–20 millions de sats | 0.05–0.20 BTC |
| Communauté active | 20–100 millions de sats | 0.20–1.0 BTC |
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é :
- Ouvrez des canaux vers des nœuds bien connectés (utilisez Lightning Network+ ou Amboss pour trouver de bons pairs)
- Vous avez besoin de capacité sortante (pour payer les acheteurs) et de capacité entrante (pour recevoir des vendeurs). Chaque transaction reçoit d'abord les sats du vendeur, puis paie l'acheteur : gardez donc au moins votre
max_order_amount(4.3) de capacité dans chaque direction - Obtenir de la liquidité entrante est généralement plus difficile — envisagez Lightning Loop, Magma, ou des services d'échange de canaux
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).
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âche | Difficulté | Connaissances requises |
|---|---|---|
| Louer un VPS | Facile | Carte bancaire, navigation web basique |
| Se connecter en SSH | Facile | Suivre des instructions, taper des commandes |
| Installer Docker | Moyen | Copier-coller des commandes, dépannage basique |
| Faire tourner Mostro (Docker) | Moyen | Éditer des fichiers de configuration, comprendre les chemins |
| Faire tourner Mostro (natif) | Difficile | Administration Linux, compilation de logiciels, systemd |
| Configurer LND depuis zéro | Difficile | Connaissances significatives en Linux et réseaux |
| Gérer la liquidité Lightning | Difficile | Comprendre 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 :
- Option A (Docker Hub) : La plus rapide. Pas de compilation, pas de clonage. Recommandée pour la plupart.
- Option B (Docker Build) : Vous construisez l'image localement depuis le dépôt.
- Option C (Compilation native) : Plus de contrôle, mieux pour les administrateurs expérimentés.
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
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 :
/root/.lnd/tls.cert/root/.lnd/data/chain/bitcoin/mainnet/mostro.macaroon
É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
É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 :
Mostro pubkey: npub1... (hex ...)— L'identité de votre nœud. Notez le npub : c'est ce dont les utilisateurs et les autres outils ont besoinSettings correctly loaded!— La configuration est valideTransport: nip44 (protocol v2, event kind 14)— Protocole utilisé (voir 4.8)Recorded Lightning node identity <pubkey>— LND joint (premier démarrage uniquement)Published health event: status ok, seq N— Répété chaque minute. Au moins un relais a accepté le rapport de santé du nœud (voir 5.4)
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é.
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.
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
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
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
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
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 ?
wss://relay.mostro.network— Relay propre à Mostro, recommandéwss://nos.lol— Relay fiable et bien connecté- Ajoutez 3–5 relays pour la fiabilité. Plus de relays = meilleure disponibilité mais plus de bande passante.
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.
0.006= 0.6% (chaque partie paie 0.3%)0.01= 1.0% (chaque partie paie 0.5%)0= gratuit (bon pour développer votre base d'utilisateurs)
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.
0.30= 30% (par défaut) — sur 600 sats, 180 vont au fonds de développement- Minimum : 10% (
0.10), Maximum : 100% (1.0) - Payé par votre nœud sur ses revenus, non facturé aux utilisateurs
- Envoyé automatiquement à l'adresse Lightning
dev@pay.mostro.foundation; il n'y a rien à configurer - Payé uniquement quand votre LND tourne sur mainnet. Sur testnet, signet ou regtest, les montants sont toujours calculés, mais rien n'est payé et le log indique
dev fee payments are disabled - Un paiement échoué est retenté pour chaque ordre, à intervalles d'une minute jusqu'à une heure
- Tous les paiements sont vérifiables publiquement via des événements Nostr (kind 8383)
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']
max_order_amount: Transaction maximale en satoshis. Configurez-la en fonction de la capacité de vos canaux Lightning.min_payment_amount: Transaction minimale en satoshis. 1 000 ou 10 000 est plus pratique que 100. Les deux limites sont vérifiées sur les sats que l'ordre déplace réellement, prime ou décote comprise.max_orders_per_response: Nombre maximum d'ordres que Mostro renvoie en une seule requête. Si un utilisateur accumule plus d'ordres que cette limite (par exemple lors de la restauration de sa session depuis le client mobile), il recevra une erreurcant-do: too_many_requestset ne pourra pas récupérer ses ordres. Si vos utilisateurs tradent fréquemment, augmentez cette valeur (par exemple 50 ou 100). La valeur par défaut de 10 peut être insuffisante.fiat_currencies_accepted: Utilisez les codes ISO 4217, en MAJUSCULES : la correspondance est exacte. Un tableau vide[]accepte toutes les devises. Depuis la v0.20.2, la liste peut aussi contenir les stablecoinsUSDT,USDCetDOC, ainsi que du bitcoin sur d'autres réseaux (BTC,LBTC,RBTC) — voir 4.12.
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.
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.toml | Résultat |
|---|---|
| aucune | Protocole 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.
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églage | Ce qu'il protège |
|---|---|
max_final_cltv_expiry_delta | Rejette 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_blocks | Marge 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_payouts | Plafond 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_destination | Le même plafond par pubkey de destination, et le plus efficace des deux. |
payment_cltv_limit | Plafond 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_change | Garde-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.
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.
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
- Un créateur qui n'a pas encore payé la caution peut annuler l'ordre, et un ordre impayé expire après
maker_bond_payment_timeout_seconds. - Une caution de créateur reste verrouillée tant que l'ordre repose dans le carnet : un ordre n'y reste donc au plus que
bond_cltv_delta - hold_invoice_cltv_delta - 144blocs (environ 24 h avec les valeurs par défaut), quel que soitexpiration_hours. bond_cltv_deltadoit être supérieur àhold_invoice_cltv_delta + 144et d'au plus 864. En v0.20.2, sa valeur par défaut est fixe, 432 : si vous avez relevéhold_invoice_cltv_deltaà 288 ou plus, définissez-le explicitement, sinon Mostro refuse de démarrer.- Les solveurs confisquent avec l'option de caution lorsqu'ils règlent ou annulent (Mostrix, Bosstro, ou
mostro-cli admsettle/admcancel --slashseller/--slashbuyer).
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.
| Code | Ce que c'est | Valorisé comme | Montant de l'ordre en |
|---|---|---|---|
USDT | Tether USD | 1 USD | coins entiers |
USDC | USD Coin | 1 USD | coins entiers |
DOC | Dollar on Chain (Rootstock) | 1 USD | coins entiers |
BTC | Bitcoin on-chain | 1 sat = 1 sat | sats |
LBTC | L-BTC sur Liquid | 1 sat = 1 sat | sats |
RBTC | RBTC sur Rootstock | 1 sat = 1 sat | sats |
- Les stablecoins sont indexés 1:1 sur le dollar : un ordre USDT au prix du marché est donc valorisé exactement comme un ordre USD, prime comprise. Le taux USD vient de vos sources de prix habituelles (4.10) ; aucune API supplémentaire n'est appelée.
- BTC, LBTC et RBTC sont cotés 1:1 en sats, ils n'ont donc besoin d'aucune API de prix. Un ordre de 100 000 signifie 100 000 sats de l'actif (0,001 RBTC). Au prix du marché, la prime est le prix du swap : un ordre de vente (le créateur vend des sats Lightning) de 100 000 sats de RBTC avec une prime de 1% verrouille 99 000 sats Lightning, et le vendeur reçoit 100 000 sats de RBTC.
- Aucun autre code n'est pris en charge : DAI, EURC et les autres sont refusés au démarrage si vous les listez dans
only.
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.
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.
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>"]
- Le
nameest ce sur quoi les imports sont dédupliqués. Ne renommez jamais une entrée qui a déjà des imports : Mostro refuse de démarrer si une clé passe à un autre nom. - Une clé ne peut appartenir qu'à une seule entrée. Pour suivre une rotation de clé, ajoutez la nouvelle clé à la même entrée et retirez l'ancienne une fois ses attestations expirées.
- Ne faites confiance qu'à des sources de confiance : un gros historique importé pèse plus lourd que les évaluations locales.
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 ?
- L'acheteur dit qu'il a payé, le vendeur dit qu'il n'a pas reçu
- Le vendeur refuse de libérer les Bitcoin après avoir reçu le paiement
- L'une des parties cesse de répondre
Le processus de litige :
- L'utilisateur ouvre un litige — L'une des parties clique sur « Litige » dans le client
- Mostro marque l'ordre — Le statut passe à « Litige », les fonds restent bloqués
- L'arbitre prend le cas — Un admin assigné à votre nœud enquête
- Investigation — Communication avec les deux parties, demande de preuves
- 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.
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é comme | Peut | Ne peut pas |
|---|---|---|
npub1...:read | Prendre un litige, le lire, écrire aux deux parties | Régler ou annuler l'ordre |
npub1...:read-write | Tout, 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 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).
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)
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
- Disputes Pending : Entrée prend un litige. Ctrl+T en reprend un à Serbero.
- Disputes Management : Tab fait défiler les chats BUYER, SELLER et SERBERO. Shift+F finalise : payer l'acheteur, rembourser le vendeur, et confisquer une caution quand le nœud en a.
- Observer : collez la clé du chat de transaction qu'une partie a partagée pour lire sa conversation.
- Settings → Link Watchdog : lie le solveur à mostro-watchdog (5.3), pour qu'il reçoive un ping Telegram privé quand une partie écrit dans un litige qu'il a pris.
- Ctrl+H affiche l'aide contextuelle. Quittez depuis l'onglet Exit.
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é :
- Litiges : un message par litige, envoyé à l'ouverture puis modifié au fil de l'eau (pris, étapes de Serbero, reprise, résolution). Chaque modification reçoit une courte réponse pour que les téléphones sonnent quand même.
- Santé du nœud : une alerte quand Mostro cesse de fonctionner, et pas seulement quand il cesse de tourner : un événement d'info devenu silencieux, le mode maintenance et, avec Mostro v0.20.0 ou plus récent, LND désynchronisé ou en retard sur la chaîne, paiements d'acheteurs bloqués ou en échec, HTLC proches de l'expiration et canaux inactifs. Seuls les changements sont publiés : une alerte, des rappels tant qu'elle dure, et « résolu ».
- Progression de Serbero sur chaque litige, si vous faites tourner Serbero (5.10).
- Pings privés aux solveurs quand une partie leur écrit dans un litige qu'ils ont pris.
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.
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 :
- Après 60 secondes, les paiements sortants (paiements aux acheteurs, frais de développement, paiements de cautions) attendent au lieu d'échouer. Un paiement en attente ne consomme pas l'une des tentatives de paiement de l'acheteur, et il part dès que LND récupère.
- Après
lnd_unsynced_fail_aftersecondes, Mostro passe en mode maintenance avec la raisonlnd_unsynced: plus de nouveaux ordres ni de prises, tandis que les transactions ouvertes peuvent encore se terminer. Il quitte la maintenance une fois LND synchronisé depuislnd_resynced_clear_aftersecondes. Une maintenance activée par vous (5.8) n'est jamais levée automatiquement.
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 :
- Alertes privées : mostro-watchdog (5.3) prévient votre Telegram quand quelque chose casse et quand c'est rétabli.
- Page de statut publique : status.mostro.network montre l'état en direct et la disponibilité sur 90 jours de chaque Mostro listé. Vos utilisateurs la voient aussi.
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 :
| Couleur | Quand |
|---|---|
| 🟢 Opérationnel | Statut 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 service | Statut 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 :
- Votre nœud est listé comme communauté sur ce site.
- 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.techouwss://relay.shadowbip.com. - Ouvrez une issue ou une pull request sur MostroP2P/semaforo pour l'ajouter à
trusted.jsonavec 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'
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
- Lisez les notes de version de la version visée. Votre
settings.tomln'est jamais écrasé : comparez-le avec le nouveausettings.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). - Sauvegardez la base de données avec les commandes de 5.6. Cette sauvegarde est nécessaire pour revenir en arrière.
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_blocksdoit valoir au moins 18 et rester inférieur àhold_invoice_cltv_delta(4.9).- Sous
[cashu],mint_urlest devenumint_urls = [...](4.11). - Avec les cautions anti-abus activées et un
hold_invoice_cltv_deltade 288 ou plus, définissezbond_cltv_deltaexplicitement (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 à jourdocker 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.
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.
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
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 :
- La seed du portefeuille (24 mots, plus la passphrase si vous en avez défini une), affichée une seule fois à la création du portefeuille. Notez-la hors ligne.
- La sauvegarde statique des canaux,
channel.backup(par exemple~/.lnd/data/chain/bitcoin/mainnet/channel.backup). LND la réécrit à chaque ouverture ou fermeture de canal, copiez-la donc régulièrement hors de la machine, par exemple dans la même tâche cron que les sauvegardes de Mostro. Avec la seed et ce fichier, vous pouvez fermer vos canaux et récupérer les fonds sur un nouveau nœud.
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.
- Annoncez la fenêtre à vos utilisateurs bien à l'avance.
- Activez le mode maintenance :
mostro-cli admsetmaintenance -e true -r "LN node migration". - Interrogez
mostro-cli admmaintenancestatusjusqu'à ce qu'il indiquedrained = true. Les ordres en attente expirent d'eux-mêmes ; pour raccourcir la vidange, vous pouvez en annuler un avecmostro-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. - Gardez l'ancien nœud en ligne tout du long. Il doit encore terminer les paiements en vol.
- Arrêtez Mostro et sauvegardez
mostro.db. - Pointez
[lightning]vers le nouveau nœud et laissezallow_node_change = false. - Démarrez Mostro. Il enregistre la nouvelle pubkey. Désactivez le mode maintenance et testez avec un ordre.
- Ce n'est qu'alors que vous pouvez décommissionner l'ancien nœud.
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 :
- Notifier (toujours actif). Chaque solveur que vous listez reçoit un message direct quelques secondes après un nouveau litige, avec des rappels toutes les 15 minutes jusqu'à ce que quelqu'un le prenne.
- Médier (optionnel, pilote). Serbero prend le litige, demande à l'acheteur s'il a payé et au vendeur si l'argent est arrivé, leur laisse le temps de terminer eux-mêmes la transaction, et sinon confie le cas à un solveur humain avec un résumé et la transcription complète.
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.
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
- 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.
- Vous l'enregistrez, en lecture seule pour commencer (5.1) :
ADMIN_NSEC=nsec1... mostro-cli admaddsolver -n npub1solver...:read - 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.
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
| Poste | Coût mensuel | Notes |
|---|---|---|
| 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 Lightning | Variable | Ouverture/fermeture de canaux |
| Total mensuel | 11–26 $ | Hors liquidité Lightning |
Coûts uniques / de capital
| Poste | Coût | Notes |
|---|---|---|
| Liquidité Lightning | 0.01–1.0+ BTC | Bloqué 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 configuration | 4–16 heures | Selon le niveau d'expérience |
Potentiel de revenus
| Volume mensuel | Frais (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 $ |
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âche | Fréquence | Temps |
|---|---|---|
| Surveillance (vérifier les logs, le statut) | Quotidien | 5–10 min |
| Résolution de litiges | Selon les besoins | 15–60 min par litige |
| Mises à jour | Mensuel | 15–30 min |
| Gestion de la liquidité | Hebdomadaire | 15–30 min |
| Estimation hebdomadaire totale | 1–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é
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é.
- 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.
- 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.
- 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.
- 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.
- 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_pubkeyajoute un tag qui relie votre nœud à cette clé. Désactivez-le avec[health] enabled = falsesi cela compte plus que la surveillance. - 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.
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
- Vérifiez que LND tourne :
lncli getinfo - Vérifiez que
lnd_grpc_hostcorrespond à l'adresse de votre LND - Vérifiez que les chemins de
tls.certetmostro.macaroonsont corrects - Vérifiez que le macaroon porte bien les permissions de 2.2
- Docker + LND sur l'hôte : utilisez
host.docker.internal. L'Option B exige en plus le mappageextra_hosts.
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
- Vérifiez les URLs des relays (doivent commencer par
wss://) - Assurez-vous que le pare-feu de votre VPS autorise les connexions sortantes sur le port 443
- Essayez avec différents relays — certains peuvent être temporairement en panne
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
- Vérifiez les connexions aux relays dans les logs
- Assurez-vous que les clients utilisent les mêmes relays que votre nœud
Paiements échouant
- Vérifiez la liquidité :
lncli listchannels - Assurez-vous d'avoir suffisamment de capacité sortante
- Vérifiez le paramètre
max_routing_fee
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
- Vérifiez les logs d'abord — la plupart des erreurs expliquent ce qui a mal tourné
- Telegram (Développeurs) : @mostro_dev
- Telegram (Communauté) : @MostroP2P
- GitHub Issues : github.com/MostroP2P/mostro/issues
- 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
| Fichier | Docker Hub | Natif |
|---|---|---|
| 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.cert | Variable (voir config LND) |
| Macaroon LND | ~/mostro-config/lnd/mostro.macaroon | Variable (voir config LND) |
| Service | N/A | /etc/systemd/system/mostro.service |
| Logs | docker logs -f mostro | journalctl -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