<!-- file: ks-onchain-transport/README.md -->
<!-- version: 3 -->

# 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 ;
- consommation directe des profils partagés définis par `config/transport.config.json` via `ks-config` ;
- 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)