SHUI水
Écosystème

Multisender SHUI : prototype local et modèles d'accès étudiés

Envoyer un token à des dizaines de wallets une adresse après l'autre est long et source d'erreurs. SHUI a construit un prototype de Multisender, déjà utilisé avec succès. Voici son fonctionnement réel, ce qui doit encore être renforcé et la façon dont il pourrait devenir une utilité du token.

Par l'équipe SHUIPublié le Mis à jour le Lecture : 10 min
Fonctionnement du prototype SHUI Multisender : import CSV, validations, découpage en lots de 10 par défaut, une signature Phantom par lot, journal des résultats. Exemple : 50 destinataires donnent 5 lots de 10.
Une opération, plusieurs transactions. Chaque lot est une transaction distincte, validée par l'utilisateur.

Récompenser des contributeurs, distribuer des tokens lors d'un événement, rémunérer un programme communautaire : toutes ces situations reviennent à envoyer un même token SPL à de nombreux wallets. Faire ces envois un par un prend du temps et multiplie les risques d'erreur. Un multisender automatise cette opération sans que l'utilisateur perde le contrôle de son wallet.

Aujourd'hui prototype local fonctionnel En développement intégration à l'écosystème À l'étude pistes non engagées

01Le problème : distribuer un token SPL à de nombreux wallets

Sur Solana, un transfert de token SPL simple coûte peu, mais il faut préparer chaque destinataire, vérifier chaque adresse, s'assurer que le destinataire peut recevoir le token, puis signer. Répété cinquante fois, ce travail devient fastidieux, et une adresse mal copiée suffit à perdre des fonds, car une transaction confirmée est irréversible.

02Comment fonctionne un multisender sur Solana

Cette section décrit le principe général, indépendamment de SHUI.

Les comptes de tokens

Sur Solana, un wallet ne détient pas directement ses tokens SPL : il possède un compte de token par mint. Le compte « standard » s'appelle un compte de token associé (ATA), dont l'adresse se déduit du wallet et du mint. Si le destinataire n'a encore jamais détenu ce token, son ATA n'existe pas : il faut le créer avant le transfert. Cette création immobilise une petite quantité de SOL, payée par celui qui la déclenche.

Une transaction, plusieurs instructions

Une transaction Solana peut contenir plusieurs instructions, par exemple plusieurs transferts. Mais sa taille est limitée à 1 232 octets. Chaque destinataire ajoute des comptes et des instructions, surtout lorsqu'un ATA doit être créé. Au-delà d'un certain nombre, la transaction ne tient plus : il faut répartir les destinataires sur plusieurs transactions.

Des échecs partiels possibles

Chaque transaction réussit ou échoue en bloc. Une distribution répartie sur plusieurs transactions peut donc réussir en partie : certains lots confirmés, d'autres non. Un bon outil doit l'indiquer clairement.

03Le prototype SHUI réellement construit

Aujourd'hui SHUI dispose d'un prototype local de Multisender, fonctionnel et déjà utilisé avec succès pour de vraies distributions. C'est une application web séparée du site, qui s'exécute localement et se connecte à Phantom. Elle vise à ne faire payer que les coûts réellement nécessaires sur le réseau Solana : les frais de transaction et, le cas échéant, la création des ATA manquants.

04Import CSV et validations

La liste des destinataires est importée depuis un fichier CSV à deux colonnes, wallet,amount. Chaque ligne est contrôlée avant tout envoi :

  • l'adresse doit être une adresse Solana valide ;
  • une même adresse ne peut apparaître qu'une fois ;
  • le montant doit être un nombre strictement positif.

Les lignes invalides sont signalées avec leur numéro et exclues de l'envoi. L'outil effectue ensuite un contrôle préalable on-chain, en lecture seule : il lit le compte SHUI du wallet source et son solde, puis vérifie pour chaque destinataire si son ATA existe déjà.

05ATA et transferChecked

Pour chaque destinataire, le prototype ajoute à la transaction, si nécessaire, une instruction de création de son ATA, payée par l'expéditeur, puis une instruction transferChecked. Contrairement à un transfert simple, transferChecked impose de préciser le mint et le nombre de décimales : le programme SPL refuse la transaction si ces valeurs ne correspondent pas au token réel. C'est une protection contre une erreur d'unité.

06Pourquoi découper les destinataires en lots

Une opération Multisender n'est pas une transaction Solana. Pour respecter la taille limite, le prototype répartit les destinataires en lots, par défaut de 10 wallets. Chaque lot devient une transaction distincte, traitée l'une après l'autre.

07Signature et contrôle par l'utilisateur

Avant l'envoi, une confirmation récapitule le total à distribuer et le nombre de wallets. Ensuite, chaque lot est présenté à Phantom, qui demande la validation de l'utilisateur. Chaque transaction est confirmée sur le réseau avant de passer au lot suivant. Un journal d'envoi affiche, lot par lot, la réussite avec sa signature de transaction ou l'échec avec son message d'erreur. Le prototype ne signe jamais seul.

08Ce que le prototype sait faire, et ses limites

Le prototype remplit sa fonction principale : importer, contrôler, créer les ATA manquants, envoyer en lots et rendre compte. Il n'est pas encore prêt pour un usage public, pour plusieurs raisons :

  • il ne simule pas les transactions avant de les soumettre à la signature, contrairement à l'ancien pipeline des interfaces Swap et Farm du site ;
  • il ne compare pas le solde disponible au total à envoyer ;
  • il n'affiche pas d'estimation des frais ni du coût de création des ATA ;
  • la taille des lots est fixe, sans calcul de la taille réelle de chaque transaction ;
  • après un échec partiel, relancer le même fichier renverrait aussi aux destinataires déjà servis ;
  • il ne fonctionne qu'avec Phantom et ne vérifie pas on-chain les décimales du mint saisi.

09À renforcer avant l'intégration publique

En développement L'objectif est d'intégrer le Multisender à l'écosystème SHUI. Avant cela, il doit adopter les mêmes garde-fous que les autres outils du site :

  1. Simulation explicite de chaque transaction, avec affichage du résultat attendu avant signature.
  2. Contrôle du solde et estimation des frais réseau et des créations d'ATA.
  3. Lots dynamiques, dimensionnés selon la taille réelle de chaque transaction.
  4. Reprise sûre après un échec partiel, en empêchant tout double envoi.
  5. Vérification on-chain du mint et de ses décimales.
  6. Environnement de test sur devnet, et prise en charge éventuelle de Solflare.

10Un accès lié à la détention de SHUI

À l'étude Un accès lié au token est l'une des pistes étudiées. Le modèle examiné repose sur une lecture du solde SHUI du wallet connecté : les SHUI restent dans le wallet, sans dépôt, sans transfert et sans verrouillage. Le service vérifie simplement une condition sur une donnée publique.

La comparaison de ce modèle avec d'autres approches (verrouillage, dépôt, consommation) fait l'objet de l'article sur l'accès aux services par le token.

11Suivi et export après distribution

À l'étude Un rapport exportable en CSV permettrait de conserver une trace exploitable de chaque distribution : wallet destinataire, montant, statut, lot et signature publique de la transaction. Ce rapport faciliterait aussi la reprise sûre après un échec partiel.

12Sécurité et modèle non-custodial

Le Multisender ne demande jamais de phrase de récupération ni de clé privée. Il ne détient pas les fonds : les tokens partent directement du wallet de l'utilisateur vers les destinataires, et chaque transaction est signée par l'utilisateur dans son wallet. Il reste de sa responsabilité de vérifier la liste importée, car une adresse valide mais erronée recevra bien les tokens. Les adresses officielles de SHUI sont rassemblées dans l'Explorer.

Partager cet article

Cet article est publié à titre d'information. Il ne constitue ni un conseil en investissement, ni une incitation à acheter, vendre ou déposer des cryptoactifs. Les cryptoactifs sont volatils et comportent un risque de perte en capital. Vérifiez toujours les informations par vous-même.

À lire aussi

Adresse copiée