Files
khadhroony-solana-project/docs/architecture/001-PROJECT_OBJECTIVES.md
2026-08-14 00:03:57 +02:00

69 lines
3.1 KiB
Markdown

<!-- file: docs/architecture/001-PROJECT_OBJECTIVES.md -->
<!-- version: 1 -->
# Objectifs de Khadhroony Solana Project
## Positionnement
Khadhroony Solana Project est un umbrella project consacré à la blockchain Solana.
Sa fonction n'est pas de construire une seule application monolithique, mais de fournir des bibliothèques KSP cohérentes, réutilisables, interconnectables et, lorsque leur contrat le permet, utilisables indépendamment.
## Capacités générales visées
KSP doit progressivement fournir des capacités permettant notamment de :
- représenter les primitives et contrats KSP/Solana communs ;
- posséder les interfaces wire nécessaires aux programmes on-chain pris en charge ;
- acquérir des données Solana en temps réel ou historiquement ;
- décoder transactions, instructions, comptes, événements et autres formats pertinents ;
- construire des opérations compatibles avec les programmes supportés ;
- signer, simuler, soumettre et suivre des opérations lorsque les frontières correspondantes auront été définies ;
- gérer les wallets et signers nécessaires aux usages KSP ;
- matérialiser les données décodées vers des faits canoniques ;
- stocker, rejouer, reconstruire et interroger les données ;
- composer ces capacités dans des applications, workers et demos spécialisés.
## Objectif court terme
L'objectif produit prioritaire est une application de trading Solana monoposte.
Cette priorité ne transforme pas les bibliothèques fondamentales en bibliothèques spécifiques au trading. Les données, interfaces, transports, décodages et modèles généraux doivent rester réutilisables par les autres produits KSP.
## Objectifs moyen et long terme
KSP doit permettre de construire notamment :
### Explorer Solana
Une application générale comparable dans son domaine à `explorer.solana.com` ou Solscan, capable d'exploiter les données et contrats KSP sans créer une seconde pile de décodage/stockage.
### Explorer et analyse DEX
Une application comparable dans son principe à DexScreener, avec une couverture plus complète des DEX et des modèles de marché Solana lorsque les données KSP le permettent.
## Non-objectifs architecturaux
KSP ne doit pas :
- devenir un monolithe centré sur une seule application ;
- dupliquer la même connaissance Solana dans plusieurs produits ;
- transformer les applications/demos en propriétaires de logique bas niveau ou protocolaire ;
- utiliser automatiquement une crate externe de protocole simplement parce qu'elle fournit les structures wire nécessaires ;
- forcer chaque application à dépendre de toutes les couches KSP ;
- créer des bibliothèques spécifiques à un produit lorsque la responsabilité est générale à Solana ou à KSP.
## Conséquence structurante
Les produits finaux doivent partager les mêmes bibliothèques fondamentales :
```text
bibliothèques KSP
├── application de trading
├── explorer Solana
├── explorer/analyse DEX
└── autres applications spécialisées
```
La première utilisation d'une capacité dans un produit ne détermine donc pas automatiquement son propriétaire architectural.