Sources et méthode
Ce guide a été rédigé à partir de la codebase locale et des clarifications utilisateur du 10 septembre 2026. Les fichiers cités ci-dessous sont des chemins du dépôt, pas des endpoints réseau.
Les références historiques de code de cette édition désignent la révision 991fca9 du protocole, conservée sur la branche work/v1-v2-fixed-walls. La documentation est publiée depuis main ; cette publication ne constitue pas une validation ni un redéploiement des contrats décrits.
Ordre de lecture
La dernière clarification des taxes retient 3 % à l’achat pour l’équipe, et 15 % à la vente : 12 % pour les murs et 3 % pour l’équipe. Cette règle remplace les taux inverses encore présents dans la révision de code historique citée ici.
La règle métier des murs suit les clarifications explicites, consolidées dans CUBIT-cahier-des-charges/docs/VERSION_ACTUELLE.md : cible à l’instant T, base de 7 000 USD de FDV sur 21 millions de tokens, anciens fonds fixés à leurs ticks et frais LP de 0,01 % pour la nouvelle version.
Pour savoir ce qui fonctionne réellement, il faut ensuite relier le code, les résultats de validation et le déploiement d’une même version. Le bandeau du bilan courant distingue les travaux non validés des résultats historiques.
Les commentaires de code encore en cours de modification ne remplacent pas une spécification confirmée. Inversement, une spécification ne prouve pas qu’une implémentation ou qu’un réseau l’exécute déjà.
Le code lu
| Source | Utilisation dans le guide |
|---|---|
contracts/src/CubitToken.sol |
Offre initiale et droit de burn |
contracts/src/CubitHook.sol |
Taxes, compartiments, maintenance, guardian et V2 |
contracts/src/libraries/BandLib.sol |
Géométrie, prix et ticks |
contracts/src/libraries/WallLib.sol |
Nouvelle gestion des murs fixes en chantier |
contracts/src/CubitLens.sol et interfaces |
Prix, soldes et vues de maintenance |
contracts/src/periphery/CubitRouter.sol |
Swaps, limites, approvals et burn final |
contracts/src/periphery/CubitV2.sol |
Signatures, identité des modules et remplacements |
contracts/src/periphery/CubitVault.sol |
Lock, rewards et sorties |
contracts/src/periphery/CubitForge.sol |
Bêta curée et isolation des enfants |
contracts/src/periphery/CubitLaunch.sol |
Lancement atomique préparé |
dapp/src/chain |
Découverte, cotations, contexte de signature et anciens Vaults |
dapp/src/pages/Momentum.tsx |
Périmètre en lecture seule |
services/keeper et README des services |
Simulation, gas, journaux et exploitation |
contracts/foundry.toml et package manifests |
Commandes et paramètres de build |
Rapports et documents historiques
Le bilan de référence est audit/reports/2026-09-10-v1-v2/BILAN_FINAL_FR.md. Son bandeau distingue la révision en cours des recettes antérieures présentes dans la suite du document.
roadmapdev.md et les documents historiques du cahier ont servi à comprendre l’intention et les jalons V1/V2. Les textes d’origine ont été archivés sous CUBIT-cahier-des-charges/historique/2026-09-10-avant-murs-fixes/. Les passages sur un mur unique monotone, le placement E/C, un fee encore indécis, les paramètres anciens de lancement ou une disparition totale des droits administratifs ne constituent pas la règle de la nouvelle version.
contracts/docs/STRICT_BURN.md explique l’évolution historique des contraintes d’isolation. contracts/docs/MODULE_SETTERS.md documente le remplacement des périphériques. Aucun ancien nombre de tests n’est présenté ici comme un résultat de validation des nouveaux murs.
La roadmap du dapp historique est un repère éditorial daté ; son contenu ne doit pas être utilisé seul pour intégrer la nouvelle politique.
La direction artistique
Le thème transpose les décisions déjà présentes dans le dapp :
| Source visuelle | Éléments repris |
|---|---|
dapp/src/index.css |
Crème #f5f1e8, encre #111312, violet #5b4bff, lime #c7ff3d, orange #ff704d, papier #ede7d8 |
dapp/src/index.css |
Titres Archivo à graisse forte et largeur étendue ; libellés Martian Mono ; texture discrète |
dapp/src/components/primitives.tsx |
Bordures franches, ombres décalées, panneaux et statuts |
dapp/src/components/Header.tsx |
Wordmark typographique, carré violet, navigation et distinction des états |
dapp/src/ui.tsx |
Motif étoilé ponctuel et libellés monospace |
Les polices sont copiées localement au build avec leurs licences. Le guide reprend le langage graphique du dapp, sans reprendre ses slogans devenus obsolètes.
La documentation
Le moteur choisi est HonKit 6.2.2, fork du moteur GitBook dédié à la création de livres et documentations à partir de Markdown. Le sommaire, la génération statique, la recherche et la navigation de pages proviennent de ce framework. Le thème CUBIT étend ses templates et styles. Documentation officielle HonKit.
L’installation locale et les commandes serve / build suivent la documentation officielle de démarrage. La configuration du livre précise notamment la racine des contenus et les styles. La release 6.2.2 identifie la version utilisée.
Le README à la racine de gitbook/ décrit l’installation, les commandes, les contrôles navigateur et les limites de l’outillage. Les validations de ce site contrôlent le livre ; elles ne valident pas les contrats du protocole.
Maintenir ce guide
Pour une nouvelle release, commencez par mettre à jour l’état des versions et la référence normative. Synchronisez ensuite les règles, l’API et les parcours réellement raccordés. Conservez la mention historique lorsqu’un ancien résultat ne porte pas sur les sources finales.
Ajoutez une page dans docs/, référencez-la dans SUMMARY.md, puis reconstruisez le livre. Les sources de cette documentation sont sélectionnées explicitement ; les configurations privées, clés, RPC authentifiés et dumps de transactions ne font pas partie du site.