Newsletter
Dépôt Monero : vérifier avant un swap13 min de lecture2 536 mots

Dépôt Monero : vérifier avant un swap

Découvrez comment rapprocher un dépôt Monero avant un swap : sous-adresses, confirmations, paiements partiels et contrôles pour éviter un versement prématuré.

dépôt Moneroswap Moneroconfirmation transaction XMRsous-adresse Monerosécurité des paiements crypto
Dépôt Monero : vérifier avant un swap

Dépôt Monero avant un swap : comment sécuriser le rapprochement

Un client envoie des XMR, puis attend de recevoir un actif sur une autre blockchain. Entre les deux, votre système doit répondre à deux questions très concrètes : le dépôt correspond-il bien à la commande, et peut-on libérer le paiement de destination sans prendre un risque trop élevé ? Avec Monero, ce contrôle ne se fait pas en consultant un explorateur public : les montants et les destinataires ne sont pas visibles de la même façon que sur une blockchain transparente.

Le rapprochement repose donc sur votre portefeuille et sur les données qu'il remonte. L'idée est simple, mais la mise en œuvre doit être rigoureuse : associer chaque ordre à une adresse de réception dédiée, enregistrer les transferts de façon fiable, attendre un niveau de confirmation adapté au risque, puis revérifier juste avant le versement. Et oui, les cas limites (paiement partiel, dépôt tardif, observations répétées, réorganisation de chaîne) doivent être gérés dès le départ. Voici une méthode pragmatique pour construire ce processus sans confondre visibilité technique et sécurité opérationnelle.

Pourquoi le rapprochement est différent avec Monero

Dans un swap entre XMR et un actif sur une autre blockchain, il faut gérer deux « jambes » : la réception de l'actif source, puis l'envoi de l'actif de destination. Un protocole ou un prestataire peut aider côté routage inter-chaînes, mais l'intégrateur doit garder un registre cohérent de ce qui a réellement été payé.

Avec Monero, l'« observabilité » est l'enjeu. Sur la chaîne, un observateur ne peut pas simplement constater qu'une adresse donnée a reçu un montant lié à une commande précise. Résultat : votre système ne peut pas compter sur un rapprochement « classique » basé sur l'adresse et le montant visibles publiquement. La source de vérité, côté opérations, c'est le portefeuille Monero qui suit les fonds.

Concrètement, votre service doit établir le lien commande ↔ sous-adresse ↔ portefeuille avant même de parler de confirmation. Vous ne voulez pas attendre qu'un paiement « apparaisse » quelque part, puis tenter de deviner son propriétaire à partir de données publiques. La manière robuste consiste à créer une adresse de réception distincte par commande et à conserver cette correspondance dans une base de données contrôlée.

Autre point important : le rapprochement (détecter et valider un dépôt) n'est pas la même chose que l'autorisation de paiement (décider d'envoyer l'actif de destination). « Détecté » ne veut pas dire « confirmé », « satisfait les conditions de l'ordre » ou « sans risque ». Ce sont des états différents : il faut les séparer clairement dans votre système.

Un découpage simple permet de clarifier les choses :

  1. Commande créée : les conditions du swap sont enregistrées et une sous-adresse est attribuée.
  2. Dépôt détecté : le portefeuille signale un transfert vers la sous-adresse de la commande.
  3. Dépôt en confirmation : le transfert est identifié, mais n'a pas encore atteint le seuil défini.
  4. Dépôt rapproché : adresse et montant correspondent à la commande selon votre politique.
  5. Versement autorisé ou bloqué : une décision explicite est prise, puis conservée pour audit.

Cette séparation évite un piège fréquent : un seul statut « payé » qui mélange détection, confirmation et sortie. En production, ces événements n'arrivent pas au même moment. Les distinguer rend aussi la reprise après incident plus simple, et donne une réponse claire quand un ordre reste en attente.

Comment identifier le dépôt d'une commande

Créer une sous-adresse par ordre

Attribuez à chaque commande une sous-adresse Monero unique. Une sous-adresse est une adresse de réception générée par le portefeuille et associée à celui-ci. Ensuite, le portefeuille peut repérer les transferts entrants vers cette sous-adresse et les rattacher à son index, sans qu'une observation côté chaîne révèle le lien entre le client, la commande et le paiement.

Au moment de créer l'ordre, enregistrez au minimum :

  • l'identifiant interne de la commande et sa date d'expiration ;
  • le compte du portefeuille et l'index de sous-adresse utilisés ;
  • l'actif attendu et le montant demandé ;
  • la chaîne et l'adresse de destination prévues pour le swap ;
  • vos règles pour les paiements partiels, tardifs et excédentaires.

Ne réutilisez pas une sous-adresse d'une commande à une autre. Une commande expirée peut recevoir un paiement tardif : si son adresse est réaffectée, vous risquez d'attribuer le dépôt au mauvais client ou au mauvais ordre. En pratique, conserver un historique consultable vaut mieux que de « réduire » le nombre d'adresses au prix d'une attribution fragile.

Lire les transferts depuis le portefeuille

Le service de rapprochement doit interroger un portefeuille connecté à un nœud Monero synchronisé. Les interfaces RPC du portefeuille, notamment get_transfers, peuvent fournir les informations nécessaires sur les transferts entrants et leur sous-adresse. Vous associez ensuite l'index reçu à l'enregistrement de commande correspondant, puis vous vérifiez le montant dans votre registre interne.

Les montants Monero sont exprimés en atomic units (piconeros) : 1 XMR équivaut à 1 000 000 000 000 atomic units. Faites vos comparaisons en entiers, pas en décimaux flottants. Les erreurs d'arrondi ou de conversion se retrouvent ensuite dans les journaux (et dans les tickets support), ce qui n'est pas amusant.

Ne cherchez pas à retrouver le montant ou le destinataire en inspectant des données publiques de transaction. Le portefeuille a les informations pour identifier les transferts qui lui sont destinés. Le rapprochement doit donc partir de ces données et de votre correspondance commande ↔ sous-adresse.

Limiter les permissions du service

Le service qui surveille les dépôts n'a pas besoin de pouvoir dépenser les fonds. Un portefeuille en lecture seule peut suffire pour suivre les entrées, tandis que les clés de dépense restent dans un environnement séparé, avec un accès plus contrôlé. Cette séparation limite l'impact d'une compromission du service qui traite les commandes.

Oui, ça a un coût opérationnel : gérer plusieurs composants, surveiller leur disponibilité, et définir une procédure pour signer les transactions sortantes. Mais exposer des clés de dépense à un service web qui traite chaque commande est souvent un compromis difficile à défendre. Le bon niveau de séparation dépend de vos montants et de votre architecture, mais par défaut, la détection d'un dépôt et l'autorisation de dépenser ne doivent pas être la même chose.

Combien de confirmations attendre avant le swap

Monero produit un bloc toutes les deux minutes environ. Les portefeuilles appliquent souvent une période de déverrouillage de dix confirmations pour certains fonds reçus, ce qui donne un ordre de grandeur d'une vingtaine de minutes. C'est un repère utile pour estimer des délais, mais ce n'est ni une garantie de règlement « en vingt minutes », ni une règle universelle applicable à tous les services de swap.

Le bon seuil dépend du risque que vous êtes prêt à accepter. Un dépôt de faible valeur n'a pas le même enjeu qu'un swap important dont le versement sur la chaîne de destination serait compliqué (ou impossible) à annuler. D'où l'importance de définir une politique en fonction des montants, de la liquidité, du coût potentiel d'une réorganisation de chaîne et de vos engagements envers le client.

Définir un seuil selon le risque

Le nombre de confirmations vous indique combien de blocs sont passés après celui qui contient le transfert. L'état de déverrouillage du portefeuille indique si les fonds sont dépensables selon ses propres règles. Ces deux informations comptent, mais aucune ne suffit à elle seule.

Vous pouvez par exemple prévoir :

  • un seuil plus bas pour les petits ordres ;
  • un seuil plus haut pour les montants élevés ;
  • une validation supplémentaire (automatique ou manuelle) au-delà d'un plafond.

Et surtout : il n'existe pas de nombre « sûr » au sens absolu. Le bon objectif, c'est d'exprimer clairement le risque acceptable et d'appliquer la même règle de façon cohérente.

Documentez ce qui déclenche l'autorisation : montant reçu, sous-adresse reconnue, état du transfert, nombre de confirmations, état de synchronisation du nœud, et absence de signalement de double dépense. Une décision reproductible se prête mieux à l'audit qu'une règle implicite disséminée dans plusieurs fonctions du système.

Vérifier à nouveau juste avant le versement

Ne vous contentez pas du premier événement qui signale l'arrivée d'un transfert. Juste avant d'envoyer l'actif sur la chaîne de destination, refaites un contrôle sur l'état récent du portefeuille. Vérifiez que le nœud est synchronisé, que le transfert apparaît toujours avec le montant attendu et la bonne sous-adresse, et qu'il est effectivement inclus dans la chaîne (pas seulement présent dans le pool).

Recontrôlez aussi le nombre de confirmations et le champ double_spend_seen quand il est disponible côté portefeuille. Si ce champ indique qu'une double dépense a été observée, le transfert ne doit pas être traité comme un dépôt normal. Une transaction visible mais non minée n'est pas un dépôt confirmé.

Enfin, évitez une course entre la vérification et l'envoi. Si plusieurs processus peuvent traiter le même ordre, utilisez une transition d'état atomique (ou un mécanisme équivalent) pour garantir qu'un seul processus autorise le paiement. La vérification de chaîne n'a de valeur que si votre système ne peut pas déclencher deux versements en parallèle.

Comment traiter les paiements ambigus et les changements de chaîne

Un système fiable ne « force » pas une anomalie à devenir un paiement accepté. Il enregistre les faits, applique les règles annoncées et met en attente les cas qui ne passent pas les conditions. Chercher à réduire le volume de tickets support coûte parfois plus cher ailleurs : on finit par déplacer le problème vers la comptabilité ou le service client.

Paiement partiel, fractionné ou excédentaire

Imaginons qu'une commande attende 0,50 XMR, mais que le portefeuille détecte 0,47 XMR sur sa sous-adresse. Votre système doit enregistrer le montant effectivement reçu et garder la commande en état non réglé, conformément à la politique de sous-paiement. Ne marquez pas la commande « payée » en silence.

Si le client envoie le complément plus tard, vous pouvez rapprocher ce nouveau transfert à la même commande, à condition que les règles et la durée de validité le permettent. Le total doit être recalculé à partir des transferts réellement attribués à l'ordre. Et il faut définir à l'avance le traitement d'un paiement excédentaire, d'un paiement après expiration, ou d'un montant jamais complété (manuel, remboursement selon une procédure définie, ou autre politique explicitée).

Les scans peuvent remonter la même observation plusieurs fois. Pour éviter de créditer deux fois, traitez vos traitements de façon idempotente. Une clé basée sur l'identifiant de transaction et l'index de sous-adresse aide à reconnaître une observation déjà enregistrée. Dans tous les cas, le traitement doit pouvoir être relancé sans provoquer de crédit ou de versement en double.

Gardez les commandes expirées consultables. Un dépôt reçu après expiration doit soit rester attribué à la commande d'origine, soit être envoyé dans une file de revue selon votre politique. N'associez pas automatiquement ce dépôt à un autre client juste parce que la commande initiale n'apparaît plus dans l'interface.

Réagir à une réorganisation de chaîne

Une réorganisation arrive quand une chaîne concurrente remplace une partie des blocs précédemment suivis. Si un transfert « confirmé » disparaît des résultats confirmés du portefeuille, suspendez tout versement qui n'a pas encore été exécuté. Refaites ensuite un scan depuis une hauteur suffisamment antérieure pour retrouver un état cohérent, plutôt que de supposer que l'observation précédente reste valide.

Si l'actif de destination a déjà été envoyé, la situation change : une transaction finale sur une autre chaîne ne peut pas être annulée automatiquement par une réorganisation de la chaîne Monero. L'ordre doit alors passer en rapprochement manuel, avec les événements enregistrés et les actions déjà réalisées clairement visibles. C'est précisément pour ça que le contrôle final et la politique de confirmation comptent.

Conserver une piste d'audit exploitable

Pour chaque décision, gardez : le transfert observé, la sous-adresse, le montant en atomic units, le nombre de confirmations, l'état du portefeuille, et la décision prise. Ajoutez les horodatages utiles et la version de la règle appliquée.

L'objectif n'est pas de stocker des journaux sans fin, mais de pouvoir répondre à trois questions : qu'a-t-on observé, quelle règle a été appliquée, et pourquoi le versement a été autorisé ou suspendu.

Avant de lancer en production, testez l'ensemble du parcours sur un réseau adapté à vos essais. Incluez au minimum : un paiement partiel, un complément envoyé plus tard, une observation répétée et un dépôt arrivé après expiration. Vérifiez aussi la reprise après indisponibilité du nœud. Un flux testé dans ces conditions est plus utile qu'un scénario « parfait » qui ne couvre que le paiement exact et immédiat.

Conclusion

Le rapprochement d'un dépôt Monero ne consiste pas à regarder un explorateur et attendre une notification. Il repose sur une correspondance construite à l'avance entre commande et sous-adresse, une lecture fiable du portefeuille, une politique de confirmations cohérente avec le risque, puis une vérification juste avant chaque versement.

Commencez par cadrer les états de vos commandes et vos règles pour les paiements partiels, tardifs et réorganisés. Ensuite, testez le parcours de bout en bout avant de traiter des fonds réels. C'est le moyen le plus direct de réduire les erreurs d'attribution et d'éviter qu'un transfert parte vers la destination sur la base d'un dépôt encore incertain.

Questions frequentes

Pas comme sur une blockchain transparente. Les montants et les destinataires ne sont pas publiquement lisibles de cette façon. Utilisez le portefeuille qui surveille les sous-adresses attribuées aux commandes.
Non. Dix confirmations constituent un repère fréquent, mais pas une règle universelle. Définissez un seuil selon le montant, le risque de réorganisation et les conséquences d’un versement déjà exécuté.
Enregistrez le montant reçu et laissez la commande en attente selon votre politique de sous-paiement. Si un complément arrive, rattachez-le au même ordre et évitez de créditer plusieurs fois une observation identique.
Une sous-adresse unique permet au portefeuille de relier le transfert à une commande et limite les erreurs d’attribution, y compris pour les paiements tardifs. Ne réutilisez pas l’adresse pour un nouvel ordre.
Si le versement de destination n’a pas eu lieu, suspendez-le et rescanez depuis une hauteur antérieure. Si l’actif a déjà été envoyé, ouvrez un dossier de rapprochement : cet envoi ne sera pas automatiquement annulé.

Articles similaires