Construire SHUI : journal technique du développement de l'écosystème
Ce carnet ne présente pas SHUI : il montre comment ses briques sont construites. Pour chacune, le problème posé, le choix technique retenu, sa mise en œuvre, ses limites et ce qui doit encore évoluer.
Un écosystème Web3 ne se résume pas à un token et à une page d'accueil. Derrière chaque bouton « Échanger » ou « Déposer » qu'a proposé le site se trouvent des choix techniques, des compromis et des limites. Ce carnet documente ceux de SHUI, tels qu'ils apparaissent dans le code et dans l'historique du dépôt.
Aujourd'hui vérifiable dans le code En développement en cours de construction À l'étude piste non engagée
01Pourquoi documenter la construction
La page d'accueil et l'Explorer expliquent ce qu'est SHUI et permettent de vérifier ses règles. Ce qu'ils ne montrent pas, c'est la façon dont les outils sont assemblés : quelles bibliothèques sont utilisées, quelles vérifications ont lieu avant une signature, pourquoi certains composants restent séparés.
Documenter ces choix sert trois objectifs. Pour un utilisateur, comprendre ce qui se passe avant qu'une transaction lui soit proposée. Pour un développeur, disposer d'un retour d'expérience concret sur une dApp Solana. Pour le projet, garder une trace des décisions et de leurs raisons. Ce carnet évite volontairement tout détail qui faciliterait une attaque : les configurations sensibles sont décrites en termes généraux.
02Les briques et leurs choix
Les composants ci-dessous existent tous aujourd'hui. Ils sont présentés par rôle, pas par date : l'historique détaillé du dépôt ne couvre que la période récente du site.
Le token : des règles figées plutôt que des promesses
Problème. Un token dont l'émetteur peut créer de nouvelles unités ou geler des comptes impose de faire confiance à cet émetteur. Choix. Utiliser le standard SPL de Solana sans programme propriétaire, et révoquer les autorités sensibles. Mise en œuvre. Le mint CnrMgNn1N3uY6GqD6FeZRdd1uhPViEFxSioWhRZsCz4C utilise 9 décimales ; sa Mint Authority et sa Freeze Authority sont révoquées, ce que chacun peut vérifier on-chain. Limite. Ce choix est irréversible : il n'existe plus aucun moyen technique de corriger la supply.
L'Explorer : vérifier sans connecter de wallet
Problème. Beaucoup d'utilisateurs veulent comprendre un projet avant d'y engager quoi que ce soit. Choix. Une page statique, sans appel RPC et sans wallet. Mise en œuvre. L'Explorer affiche des informations stables (mint, décimales, répartition initiale, niveaux) et renvoie vers des outils publics comme Solscan pour les données dynamiques. Limite. Il n'affiche aucune donnée en temps réel : c'est un choix de sobriété, pas un oubli.
Le Swap : des routes directes et vérifiées
Problème. Un agrégateur choisit lui-même son itinéraire, ce qui rend le résultat plus difficile à expliquer. Choix. Deux routes fixes et directes : SOL ⇄ SHUI via le pool Raydium CPMM, USDC ⇄ SHUI via un Whirlpool Orca, sans passer par SOL. Mise en œuvre. Le devis est calculé à partir de l'état réel des pools ; le minimum reçu intègre la tolérance de prix choisie. Limite. Sans agrégation, le prix obtenu dépend uniquement de la profondeur de ces deux pools.
La Farm : utiliser un programme existant
Problème. Écrire un programme de récompenses propriétaire créerait un nouveau code à auditer. Choix. S'appuyer sur le programme public Raydium Farm v6. Mise en œuvre. Le site ne propose que trois actions utilisateur : déposer, retirer, réclamer. Limite. Les paramètres d'une campagne dépendent de ce programme tiers. Le fonctionnement détaillé fait l'objet d'un article technique dédié.
Le wallet web : l'adresse publique, rien d'autre
Problème. Un site ne doit jamais avoir accès aux clés de ses utilisateurs. Choix. Les adaptateurs officiels de Phantom et Solflare. Mise en œuvre. Le site ne lit que la clé publique ; seul le nom du wallet choisi est mémorisé pour la reconnexion. Pour Solflare, la reconnexion passe par le standard Wallet Standard afin d'afficher l'adresse plus vite, mais la signature reste confiée à l'adaptateur officiel. Limite. Deux wallets seulement sont pris en charge.
SHUI Mobile : une application à part
L'application Android v0.2.10 est distribuée séparément, sous forme d'APK publié avec son empreinte SHA-256. Elle ne partage pas le code du site ; son architecture interne n'est pas détaillée dans ce carnet. L'article consacré à SHUI Mobile en présente les fonctions.
03Un pipeline de transaction commun
Désactivé publiquement Les interfaces Swap et Farm ne sont plus accessibles au public ; leur code est conservé. Le choix le plus structurant de leur conception était qu'elles n'envoient jamais une transaction directement. Les deux passent par la même chaîne de contrôle :
- Réseau vérifié. Le site contrôle qu'il est connecté au réseau principal de Solana.
- Construction. La transaction est assemblée avec un blockhash récent.
- Validation. Seuls les programmes attendus sont autorisés, les comptes attendus doivent être présents, et un seul signataire est admis : le wallet de l'utilisateur.
- Simulation. La transaction est simulée. Si la simulation échoue, rien n'est proposé au wallet.
- Signature. L'utilisateur signe dans son wallet, puis le site vérifie que la transaction n'a pas été modifiée de façon non conforme.
- Envoi et confirmation. La transaction est diffusée puis confirmée.
Ce pipeline est couvert par des tests automatisés qui n'appellent jamais le réseau : mauvais mint, mauvais programme, simulation en échec, solde insuffisant, blockhash expiré, panne RPC. Il sert aussi de référence pour les outils futurs : le prototype Multisender, par exemple, ne l'utilise pas encore.
04Le site, étape par étape
L'historique du dépôt actuel permet de retracer précisément les dernières évolutions. Chacune correspond à une modification relue puis fusionnée.
| Étape | Problème traité |
|---|---|
| Fondation SEO | Rendre les pages publiques compréhensibles par les moteurs de recherche : balises, sitemap, données structurées. |
| Protections navigateur | Ajouter des en-têtes de sécurité, notamment contre l'affichage du site dans un cadre tiers, un risque réel pour une dApp. |
| Favicon SHUI | Identifier le site dans les onglets et les résultats, puis simplifier l'icône. |
| Fondation du Journal | Publier des articles statiques depuis un manifeste unique. |
| URL propres | Servir les articles à des adresses lisibles, sans extension. |
| Navigation | Exposer le Journal dans le menu du site, puis le séparer de la navigation interne des sections. |
| Publication programmée | Préparer un article à l'avance : il n'apparaît qu'une fois sa date de publication passée, au moment du build. |
| Désactivation publique de Swap et Farm | Retirer l'accès public aux interfaces transactionnelles du site, en conservant leur code et l'historique documentaire. |
| Rebuild automatisé | Reconstruire le site à intervalles réguliers pour que les articles programmés paraissent sans intervention manuelle. |
La publication programmée illustre une règle simple : le build est la seule source de vérité. Un article dont la date n'est pas atteinte n'est ni dans l'index, ni dans le sitemap, ni même généré.
05Méthode de travail
Chaque évolution suit le même circuit : une branche dédiée, une demande de fusion vers une branche de préproduction, puis une seconde demande de fusion vers la branche principale. Les vérifications (typage, lint, tests, build) sont lancées avant chaque fusion. Aucune clé privée, aucune seed et aucun secret n'est présent dans le code du site ; les seules valeurs de configuration exposées au navigateur sont celles qui doivent l'être, et elles sont considérées comme publiques.
06Limites et dette technique
Construire avec des bibliothèques existantes a un coût. Trois limites sont connues et documentées :
- Le poids du code. Les SDK utilisés pour Raydium et Orca sont volumineux ; les pages Swap et Farm chargent plus de code que nécessaire. Un découpage plus fin est possible, mais il toucherait au code de transaction, qui est volontairement gelé.
- La dépendance à des bibliothèques tierces. Leur évolution, leurs licences et leurs failles éventuelles doivent être suivies. Ce suivi est un travail continu, pas une étape ponctuelle.
- L'accès au réseau. Toute lecture on-chain passe par un point d'accès RPC, dont la disponibilité et les limites de débit conditionnent l'expérience.
Ces limites ne sont pas des failles connues : ce sont des compromis assumés, à reprendre lorsque le gain le justifiera.
07Ce qui vient ensuite
En développement Le Multisender, aujourd'hui prototype local, doit rejoindre le site en adoptant les mêmes garde-fous que le Swap et la Farm.
À l'étude Une sécurité matérielle pour la signature et un assistant SHUI AI font partie des pistes, sans date engagée.
Ce carnet sera complété au fil des étapes. Le principe restera le même : décrire ce qui est construit, tel qu'il l'est, avec ses limites.
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.

