khadhroony-bot3/ROADMAP.md

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.

0.4.6 — alignement fonctionnel et clôture de la migration principale

Version clôturée : architecture en onze crates, alignement bot2 0.4.6, validations workspace et scénarios applicatifs. Le registre ElGamal reste implémenté et validé synthétiquement sans preuve réseau réelle.

0.4.7 — Metaplex Token Metadata

Version en clôture documentaire.

Périmètre réalisé

• décodeur d’instructions et de comptes, PDA, owners et variantes historiques ;
• matérialisation metadata, administration, lifecycle et risques applicables ;
• intents typés, builders, exécuteur, préflights, simulation exacte et postconditions ;
• intégration généraliste dans kb-pipeline ;
• scénarios synthétiques NFT, SFT, fungible, collection et pNFT ;
• runner Devnet réutilisable et panneau kb-app-demo-desktop ;
• fixtures Rust natives sans dépendance à une CLI externe ;
• soumissions confirmées de parcours représentatifs Create, UpdateAsUpdateAuthorityV2 et transition immutable.

Qualification de validation

• les opérations structurantes et les parcours représentatifs sont validés réellement sur Devnet ;
• les autres opérations exposées restent couvertes par leurs builders, matrices et tests synthétiques ;
• les campagnes Devnet spécialisées Print, Burn, collections avancées, délégations/lock pNFT, rule sets et maintenance sont une dette de validation complémentaire, non un blocant de clôture ;
• aucune preuve synthétique ne doit être présentée comme preuve RPC.

Hors périmètre

• metadata incorporées Token-2022 et SPL Token Metadata ;
• Metaplex Core, Bubblegum et autres programmes Metaplex ;
• fetch HTTP/IPFS/Arweave des URI off-chain.

0.4.8 — SPL Token Metadata et décision off-chain metadata

Première prerelease

La première prerelease doit produire un plan et un inventaire fermé avant tout développement fonctionnel. Elle doit prévoir dès le départ des scénarios Devnet réels dans kb-app-demo-desktop, en parallèle des tests synthétiques et des campagnes automatisées de kb-pipeline-demo-scenarios.

Objectifs

• auditer spl-token-metadata-interface comme surface distincte ;
• séparer SPL Token Metadata, metadata Token-2022 et Metaplex Token Metadata ;
• implémenter uniquement les couches decoder, materializer, executor, pipeline et démonstrations justifiées ;
• décider si kb-offchain-transport doit être créée ;
• si retenue, commencer par un module metadata borné HTTP/IPFS/Arweave.

Contraintes off-chain

• le contenu externe ne modifie jamais le statut canonique du replay on-chain ;
• timeout, taille, type MIME, redirections, cache, hash et provenance sont bornés ;
• protection SSRF et interdiction des réseaux locaux ;
• aucune confiance implicite dans les JSON distants.

0.5.x — configuration, wallet, stockage et démonstrations

• restructurer kb-config et séparer le logging si retenu ;
• compléter multi-wallets, import/export, chiffrement, verrouillage, sauvegarde et restauration dans kb-wallet ;
• auditer pool, résilience, administration et besoins historiques de kb-store ;
• maintenir les scénarios UI Devnet/Testnet dans le desktop et leurs équivalents automatisés dans kb-pipeline-demo-scenarios ;
• compléter les validations Devnet spécialisées Metaplex Token Metadata reportées de 0.4.7 lorsque leur utilité le justifie.

0.6.x — Anchor générique, programmes SPL et Metaplex complémentaires

• infrastructure générique Anchor : discriminants, comptes, événements et erreurs ;
• classification et conservation des IDL comme références statiques ;
• autres programmes SPL et Metaplex, chacun avec matrices et scénarios Devnet réels représentatifs.

0.7.x — Meteora

DLMM, DAMM v1/v2, DBC, vaults et autres programmes vérifiés.

0.8.x — Pump

Pump AMM, Pump.fun, Pump Fees et autres surfaces vérifiées. Auditer MAyhSmzXzV1pTf7LsNkrNwkWKTo4ougAJ1PPg47MD4e et l’appartenance de pumpup_ai.

0.9.x — Raydium

AMM v4/v3/v2, CPMM, CLMM, stable swap, LaunchLab, Lock et autres surfaces vérifiées.

0.10.x — Orca

Whirlpool, Orca v1/v2, Wavebreak et autres surfaces vérifiées.

0.11.x — Jupiter

Routers, agrégateurs, DCA, ordres, perpetuals, lockers et autres surfaces vérifiées.

0.12.x — autres routers et protocoles

OKX et autres routers, puis surfaces complémentaires classées selon leur priorité réelle.

0.13.x — transports temps réel

WebSocket Helius, LaserStream, Yellowstone gRPC, continuité, backpressure, reconnexion et métriques.

0.14.x — workers et applications consommatrices

• W1 acquisition temps réel vers les raw ;
• W2 décodage et matérialisation temps réel ;
• rattrapage historique séparé ;
• application de contrôle ;
• application de trading et applications de visualisation.

0.15.x+ — extensions futures

Nouveaux protocoles, transports, backfills, observabilité, administration et optimisations validées par des contrats bornés.