0.5.1-pre.002

ks-onchain-transport/README.md

@@ -0,0 +1,37 @@
+<!-- file: ks-onchain-transport/README.md -->
+<!-- version: 2 -->
+
+# ks-onchain-transport
+
+`ks-onchain-transport` fournit les transports Solana on-chain de `khadhroony-bot3`.
+
+## Responsabilités
+
+- requêtes JSON-RPC HTTP standard ;
+- sessions et pools WebSocket ;
+- routage par rôle d’endpoint ;
+- adaptation des réponses RPC vers les contrats canoniques ;
+- simulation, soumission et confirmation de transactions ;
+- acquisition de signatures et transactions pour le backfill ;
+- validation bornée des paramètres et réponses réseau.
+
+La crate ne décode pas les programmes Solana et ne persiste pas directement les données. Elle alimente `ks-pipeline`, qui orchestre l’acquisition, l’extraction et le replay, et utilise les contrats de `ks-core` et `ks-lib`.
+
+## Surfaces publiques principales
+
+- `HttpClient`, `HttpEndpointPool` ;
+- `SolanaRpcClient`, `RpcEndpoint` ;
+- contrats JSON-RPC ;
+- méthodes HTTP standard et leurs types de configuration ;
+- `WsClient`, `WsEndpointPool`, sessions et abonnements WebSocket ;
+- adaptateurs `getTransaction`, `getSignaturesForAddress` et méthodes d’exécution RPC.
+
+Voir [USAGE.md](USAGE.md) pour les APIs publiques et les exemples.
+
+## Documentation
+
+- [USAGE.md](USAGE.md)
+- [TODO.md](TODO.md)
+- [CHANGELOG.md](CHANGELOG.md)
+- [Architecture du pipeline](../docs/architecture/PIPELINE_ARCHITECTURE.md)
+- [Carte des crates](../docs/architecture/CRATE_MAP.md)