Dépôt GHOST Token

Compilation et déploiement du jeton GHOST et de l’écosystème associé sur Base (Hardhat, Solidity 0.8.28).

Référence déploiement mainnet : travailler depuis ce dossier (dépôt tokken sur le Bureau). Une copie de travail peut exister ailleurs (ex. dépôt « Ghost Protocol V2 ») : resynchroniser les contrats et scripts/deploy-ghost-ecosystem.ts ici avant tout npm run deploy:ecosystem:base.

Tokenomics (référence)

Tranche	GHOST	% du supply 33 M
Airdrop	6 600 000	20 %
Trésorerie (vesting)	5 940 000	18 %
Équipe (vesting)	5 610 000	17 %
Récompenses (timelock)	6 600 000	20 %
Liquidité	3 300 000	10 %
Prévente	4 950 000	15 %

Détail des flux post-déploiement, vesting, splitter ETH et checklist mainnet : docs/TOKENOMICS.md.

Écosystème GitHub (même organisation / auteur)

Ce dépôt porte le contrat jeton GHOST, la prévente et les scripts Hardhat pour Base. Le protocole Ghost (Schnorr, application, ghost-schnorr-libz.js, SDK npm) vit dans le dépôt Ghost Protocol V2 — auteur Rayane Hila, ligne produit RayTech R&D dans les métadonnées de ce projet.

Dépôt	Contenu principal	URL
Ghost-token (ce dépôt)	ERC-20, prévente, déploiement Base, tests Hardhat	github.com/RT01010011/Ghost-token
Ghost Protocol V2	Protocole Schnorr, UI desktop Electron, ghost-schnorr-libz.js, SDK, tests protocole	github.com/RT01010011/ghost-protocol-v2

Détail des titulaires, Git et contact : docs/TITULAIRE-LICENCE.md et docs/ECOSYSTEM-GITHUB.md.

Documentation

• Tokenomics et flux on-chain
• Prévente, registre bonus +5 % et campagne airdrop 100 GHOST
• Prévente — lien déploiement ↔ SDK (FR/EN)
• Notes pré-GitHub / synchro contrats–SDK (bilingue)
• Structure du dépôt et variables d’environnement
• Contrats Solidity — rôles et déploiement
• Feuille de route déploiement Base + airdrop 100 GHOST
• Publication sur GitHub (remote, push)
• Titulaire de la licence / société / Git
• Lien avec les autres dépôts GitHub
• Politique de sécurité et signalement
• Contribuer
• Audits externes (statut)
• Tests Hardhat
• SDK & intégration plateforme (Ghost Protocol)

Documentation plutôt que « commentaires dev » dans le code

Règle projet : pas de brouillons d’équipe, TODO longs, notes de debug ou explications produit dans les fichiers Solidity, scripts ou index.html. Ce type de contenu va dans ce README, dans docs/ ou dans contrat tokken/README.md / FEUILLE-DE-ROUTE-DEPLOIEMENT.md.
Le code reste lisible ; la doc porte le contexte, les choix et les checklists.

Les NatSpec courts (@title, @notice) sur les fonctions publiques peuvent rester si utiles aux intégrateurs et auditeurs.

Avant un git push (données sensibles)

• Ne jamais versionner .env, clés privées, mnémoniques, jetons d’API (Basescan, RPC avec clé secrète).
• Ne pas committer les fichiers deployed-addresses-*.json (déjà dans .gitignore) : ils peuvent refléter ton déploiement personnel ; les adresses mainnet publiques peuvent en revanche être documentées à la main dans la doc si tu le souhaites, sans rejouer de secrets.
• Vérifier git diff / git status avant push.

Dépôt public : github.com/RT01010011/Ghost-token.

Prérequis

• Node.js 20+
• Un fichier .env local (non versionné), calqué sur .env.example

Installation

npm ci

Vérification locale

npm run compile:token
npm run test:token
npm run estimate:deploy:gas

La suite ~224 tests Hardhat couvre le token, la prévente, le splitter, les registres bonus / welcome, la cohérence SDK et Schnorr (ghost-schnorr-libz.js). Détail : tests/README.md. Rapport JSON : npm run test:token:json. Sur Windows en cas de manque mémoire : NODE_OPTIONS=--max-old-space-size=8192 avant npm run test:token.

Audits externes

Statut et feuille de route : audits/README.md. Aucun rapport d’audit tiers n’est publié dans ce dossier pour l’instant ; le code est couvert par une suite de tests Hardhat (~224 scénarios) et une documentation on-chain détaillée.

International

La documentation est principalement en français (cible projet). Pour une audience investisseurs internationale, une version anglaise du README / tokenomics peut être ajoutée en parallèle (README.en.md, etc.).

Déploiement (Base mainnet)

Le wallet associé à PRIVATE_KEY doit disposer d’ETH sur Base pour le gas.

Écosystème complet (token, prévente, vestings, splitter, registre bonus, etc.) :

npm run deploy:ecosystem:base

Registre welcome 100 GHOST (GhostPresaleWelcomeRegistry) — séparé, pour ne pas redéployer l’écosystème déjà en place ; détail et anti-doublon : scripts/deploy-ghost-welcome-registry-only.ts.

npm run deploy:welcome-registry:base

Les adresses déployées sont écrites dans deployed-addresses-ghost-ecosystem.json et deployed-addresses-ghost-welcome-registry.json (fichiers ignorés par Git — ne pas les committer).

Avant un déploiement mainnet : vérifier .env (wallets, GHOST_PRESALE_*, GHOST_PROTOCOL_V2) et lancer npm run compile:token ; voir aussi la fin de docs/TOKENOMICS.md et contrat tokken/FEUILLE-DE-ROUTE-DEPLOIEMENT.md.

Prévente GHOST : soft cap, finalisation et UX

Documentation produit / dev (ne pas dupliquer en commentaires dans index.html ou les scripts ; maintenir ici).

• GHOST_PRESALE_SOFT_CAP_ETH=0 est la valeur standard (voir .env.example). Dans GhostPresale, si softCapEth est nul, finalize() n’impose aucun plancher de levée globale : même une petite partie du hard cap vendue (par ex. 5 %) permet, après endTime, de finaliser et de distribuer les jetons aux contributeurs au prorata — ce n’est pas un scénario « seuil minimum non atteint = remboursement collectif ».
• Les fonctions enableRefundMode() et refund() du contrat ne sont pertinentes que pour un déploiement avec soft cap strictement positif et une levée restée sous ce seuil ; avec soft cap à 0, enableRefundMode() revert toujours.
• L’UX (index.html) n’expose que le remboursement volontaire pendant la fenêtre d’achat (remboursementVolontaire), pas de bouton « remboursement soft cap », ce qui correspond à cette configuration.

Sécurité (rappel)

• Ne jamais committer .env, clés privées ni secrets RPC (voir aussi section Avant un git push ci-dessus).
• Signalement de vulnérabilités : SECURITY.md.

Contact

Rayane Hila — RayTech Solution — rayane.h42@proton.me (questions générales ; pour les failles de sécurité, voir SECURITY.md).

English (short overview)

GHOST ERC-20, presale, +5 % bonus registry, 100 GHOST welcome airdrop registry, Hardhat deploy for Base, TypeScript SDK and unified JS. Deployment ↔ SDK map and bilingual pre-release checklist: docs/PRESALE-DEPLOYMENT-SDK-LINK.md, docs/PRE-GITHUB-DEV-NOTES.md.

Licence

MIT — copyright RayTech Solution (2026). Auteur principal du code et de l’écosystème : Rayane Hila (voir docs/TITULAIRE-LICENCE.md).