Files
khadhroony-bot3/ks-onchain-transport/README.md
2026-08-10 02:44:24 +02:00

39 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!-- 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 dendpoint ;
- 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 lacquisition, lextraction 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 dexé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)