183 lines
6.9 KiB
Markdown
183 lines
6.9 KiB
Markdown
<!-- file: ROADMAP.md -->
|
||
<!-- version: 22 -->
|
||
|
||
# ROADMAP — khadhroony-bot3
|
||
|
||
Le roadmap décrit les objectifs fonctionnels par version mineure. Il ne contient ni prereleases, ni correctifs `fix`, ni journal détaillé des travaux terminés. Les détails opérationnels appartiennent aux `TODO.md` et `CHANGELOG.md` des crates.
|
||
|
||
## 0.4.6 — alignement fonctionnel et clôture de la migration principale
|
||
|
||
### Objectifs
|
||
|
||
- formaliser l’équivalence largement atteinte avec khadhroony-bot2 `0.4.6` ;
|
||
- documenter précisément les écarts résiduels ;
|
||
- valider les renommages, consolidations et nouvelles frontières de crates ;
|
||
- fermer la migration structurelle principale ;
|
||
- décider du réalignement officiel du versionnement et du premier numéro fonctionnel publié après la transition `0.1.0-mig-from-kbot2`.
|
||
|
||
### Lots
|
||
|
||
- refonte de la documentation générale et des règles ;
|
||
- reconstruction des changelogs et du roadmap ;
|
||
- documentation complète des 11 crates ;
|
||
- reconstruction des prompts bot3 ;
|
||
- audit ciblé `docs/V0_4_6_ALIGNMENT_AUDIT.md` ;
|
||
- traitement ou documentation explicite des exceptions restantes.
|
||
|
||
### Critères de sortie
|
||
|
||
- chaque crate possède `README.md`, `TODO.md`, `USAGE.md` et `CHANGELOG.md` ;
|
||
- les versions, noms de crates et binaires sont cohérents ;
|
||
- les tests et validations déjà réalisés sont synthétisés sans nouvel audit complet des protocoles ;
|
||
- le statut de `kb-wallet`, `kb-config`, `kb-pipeline-demo-scenarios`, ElGamal et des transports est explicite ;
|
||
- l’audit conclut `READY_FOR_0_4_6` ou `READY_WITH_DOCUMENTED_EXCEPTIONS` ;
|
||
- le changelog général n’ajoute l’entrée de réalignement qu’au dernier prerelease ou correctif précédant le commit de la version fonctionnelle retenue.
|
||
|
||
## 0.4.7 — Metaplex Token Metadata complet et clôture de 0.4.x
|
||
|
||
### Positionnement de version
|
||
|
||
- le premier numéro fonctionnel après la migration pourra être `0.4.6+` ou une étape préparatoire de la famille `0.4.7`, selon la conclusion de l’audit d’alignement ;
|
||
- l’entrée générale correspondante ne sera ajoutée au changelog qu’au moment de finaliser cette version ;
|
||
- la version finale `0.4.7` doit inclure la surface Metaplex Token Metadata complète, et non le seul décodeur déjà migré.
|
||
|
||
### Objectifs
|
||
|
||
- terminer Metaplex Token Metadata commencé dans bot2 et dont le décodeur a déjà été migré dans bot3 ;
|
||
- vérifier et compléter décodeurs de comptes et instructions ;
|
||
- ajouter les matérialisateurs, exécuteurs, préflights et validations nécessaires ;
|
||
- finaliser les éléments résiduels du noyau historique ;
|
||
- préparer les démonstrations complètes de la série `0.5.x`.
|
||
|
||
### Contraintes
|
||
|
||
- ne pas confondre Metaplex Token Metadata avec les metadata incorporées de Token-2022 ou Metaplex Core ;
|
||
- utiliser les IDL archivées comme références de conception, jamais comme moteur dynamique de production ;
|
||
- conserver les matrices exécutables sous `test-fixtures/contract-matrices/`.
|
||
|
||
### Critères de sortie
|
||
|
||
- couverture fonctionnelle bornée et documentée ;
|
||
- tests contractuels et unitaires complets ;
|
||
- limites et validations réseau explicites ;
|
||
- aucune surface partiellement annoncée comme terminée.
|
||
|
||
## 0.5.x — démonstrations, configuration et wallet
|
||
|
||
### Configuration
|
||
|
||
- scinder `kb-config` en deux fichiers, ou trois si nécessaire ;
|
||
- alléger la configuration générale ;
|
||
- extraire les blocs dupliqués entre profils, notamment le logging ;
|
||
- conserver un schéma explicite et des exemples utilisateurs cohérents.
|
||
|
||
### Scénarios de démonstration
|
||
|
||
- rendre `kb-pipeline-demo-scenarios` pleinement autonome hors desktop ;
|
||
- améliorer le CLI, les fixtures et les rapports ;
|
||
- compléter les démonstrations des surfaces `0.4.x` ;
|
||
- maintenir les adapters Tauri minces.
|
||
|
||
### Wallet
|
||
|
||
- compléter réellement `kb-wallet` ;
|
||
- ajouter import, export, multi-wallets et sélection active ;
|
||
- ajouter changement de mot de passe, chiffrement, déchiffrement et verrouillage ;
|
||
- ajouter sauvegarde, restauration, politiques de sécurité et intégration aux profils/signers.
|
||
|
||
## 0.6.x — Anchor, programmes SPL et Metaplex complémentaires
|
||
|
||
### Anchor
|
||
|
||
- implémenter une infrastructure générique de décodage des conventions Anchor ;
|
||
- prendre en charge discriminants, comptes, événements et erreurs selon des contrats bornés ;
|
||
- intégrer les conventions Anchor aux décodeurs, exécuteurs et matérialisateurs.
|
||
|
||
### IDL
|
||
|
||
- maintenir dès maintenant la classification et le nommage des IDL archivées ;
|
||
- ajouter les IDL de référence au fur et à mesure des protocoles étudiés ;
|
||
- ne jamais charger dynamiquement les IDL ni exécuter arbitrairement leur contenu en production.
|
||
|
||
### Programmes
|
||
|
||
- ajouter le reste des programmes SPL ;
|
||
- ajouter le reste des programmes Metaplex ;
|
||
- documenter chaque surface avec matrices, tests et critères de validation.
|
||
|
||
## 0.7.x — Meteora
|
||
|
||
1. AMM Meteora : DLMM, DAMM v1, DAMM v2 et autres AMM non launchpad ;
|
||
2. launchpad DBC ;
|
||
3. vaults Meteora ;
|
||
4. autres programmes Meteora identifiés et vérifiés.
|
||
|
||
## 0.8.x — Raydium
|
||
|
||
1. AMM et swaps : v4, v3, v2, CPMM, CLMM et stable swap ;
|
||
2. LaunchLab ;
|
||
3. Raydium Lock ;
|
||
4. autres programmes Raydium identifiés et vérifiés.
|
||
|
||
## 0.9.x — Pump
|
||
|
||
1. Pump AMM ;
|
||
2. Pump.fun ;
|
||
3. Pump Fees ;
|
||
4. autres programmes Pump à identifier.
|
||
|
||
À auditer avant classement :
|
||
|
||
```text
|
||
MAyhSmzXzV1pTf7LsNkrNwkWKTo4ougAJ1PPg47MD4e
|
||
```
|
||
|
||
Vérifier sa nature, son déploiement et son appartenance réelle à la famille Pump. Vérifier séparément si `pumpup_ai` appartient à cette famille ou constitue un protocole distinct.
|
||
|
||
## 0.10.x — Orca
|
||
|
||
1. Whirlpool ;
|
||
2. Orca v1 ;
|
||
3. Orca v2 ;
|
||
4. Wavebreak ;
|
||
5. autres programmes Orca identifiés et vérifiés.
|
||
|
||
## 0.11.x — Jupiter
|
||
|
||
- routers et agrégateurs ;
|
||
- DCA et ordres ;
|
||
- perpetuals et lockers ;
|
||
- autres programmes Jupiter identifiés et vérifiés.
|
||
|
||
## 0.12.x — OKX et autres routers
|
||
|
||
- routers et autres programmes OKX ;
|
||
- autres routers et agrégateurs hors Jupiter ;
|
||
- surfaces de matérialisation, sécurité et exécution associées.
|
||
|
||
## 0.13.x — transports temps réel
|
||
|
||
- extension WebSocket Helius dans `kb-onchain-transport` ;
|
||
- amélioration de LaserStream si pertinente ;
|
||
- Yellowstone gRPC ;
|
||
- autres transports streaming ;
|
||
- reprise, continuité, backpressure, reconnexion et métriques ;
|
||
- vérification et classement du listing historique des Program IDs sans modifier l’archive bot2.
|
||
|
||
## 0.14.x — application de trading et orchestration
|
||
|
||
- application de trading ;
|
||
- workers et services séparés ;
|
||
- orchestration et automatisation ;
|
||
- stratégies et exécution contrôlée ;
|
||
- sécurité opérationnelle ;
|
||
- séparation stricte entre UI, workers et services.
|
||
|
||
## 0.15.x+ — extensions futures
|
||
|
||
- nouveaux décodeurs, exécuteurs et matérialisateurs ;
|
||
- protocoles et transports supplémentaires ;
|
||
- opérations historiques et backfills avancés ;
|
||
- optimisations, observabilité et outils d’administration ;
|
||
- extensions futures validées par des contrats bornés.
|