v0.2.3-pre.009

2026-08-18 17:33:46 +02:00
parent c9a0f7fd37
commit 039b93cfb3
15 changed files with 1020 additions and 67 deletions
--- a/crates/ksp-onchain-transport-lib/README.md
+++ b/crates/ksp-onchain-transport-lib/README.md
@@ -1,5 +1,5 @@
 <!-- file: crates/ksp-onchain-transport-lib/README.md -->
-<!-- version: 5 -->
+<!-- version: 6 -->

 # `ksp-onchain-transport-lib`

@@ -69,16 +69,21 @@ Le registre porte notamment :
 - remplacement historique éventuel ;
 - release de couverture typée KSP.

-La surface typée stable après `0.2.2` contient **26 méthodes** :
+La candidate `0.2.3-pre.009` porte la surface typée à **37 méthodes courantes** :

 ```text
-0.2.1 foundation : 4
-0.2.2 Accounts    : 5
-0.2.2 Tokens      : 5
-0.2.2 Cluster     : 12
+0.2.1 foundation   : 4
+0.2.2 Accounts     : 5
+0.2.2 Tokens       : 5
+0.2.2 Cluster      : 12
+0.2.3 Transactions : 11
 ```

-Les quatre canaris foundation restent `getBalance`, `getGenesisHash`, `getHealth` et `getVersion`. `0.2.2` ajoute les 22 wrappers Accounts/Tokens/Cluster affectés à `HttpRpcCoverageRelease::V0_2_2`. Les 26 méthodes Transactions/Blocks/Economics encore affectées à `0.2.3`–`0.2.4` peuvent déjà passer par l'exécuteur JSON-RPC standard générique lorsqu'un consumer fournit explicitement descriptor et paramètres JSON, mais cette surface raw/générique **ne vaut pas couverture typée**.
+Les quatre canaris foundation restent `getBalance`, `getGenesisHash`, `getHealth` et `getVersion`. `0.2.2` ajoute les 22 wrappers Accounts/Tokens/Cluster. `0.2.3` ajoute les 11 wrappers Transactions, dont `requestAirdrop` et `sendTransaction` en `WriteSubmission / NeverAfterDispatch` et `simulateTransaction` en `Simulation / RetrySafe`.
+
+Les **15 méthodes Blocks/Economics** encore affectées à `0.2.4` peuvent déjà passer par l'exécuteur JSON-RPC standard générique lorsqu'un consumer fournit explicitement descriptor et paramètres JSON, mais cette surface raw/générique **ne vaut pas couverture typée**.
+
+`KSP-TRANSPORT-007` impose qu'un wrapper typé couvre toutes les possibilités RPC supportées retenues par l'audit : paramètres/options, overloads et formes legacy encore supportées, contraintes déterministes utiles et variantes de réponse pertinentes sans perte. Le réaudit `0.2.3-pre.008` confirme cette complétude sur les 37 wrappers courants.

 Les 14 méthodes historiques restent découvrables pour la compliance mais sont `Removed` et ne sont pas simulées comme appelables.

@@ -122,7 +127,8 @@ Deux smokes Devnet opt-in sont séparés par responsabilité :

 ```text
 Transport pur : settings programmatiques -> HttpTransportPool
-             -> getAccountInfo/getTokenAccountsByOwner/getEpochInfo/getVoteAccounts
+             -> Accounts/Tokens/Cluster représentatifs
+             -> getLatestBlockhash/isBlockhashValid/getTransactionCount

 Composition historique : Config -> std.transport/devnet_public -> HttpTransportPool
                       -> getHealth/getGenesisHash/getVersion/getBalance
@@ -138,4 +144,6 @@ Les deux sont `ignored` par défaut. Le smoke Transport appartient durablement
 - [`../../docs/plans/008-V0_2_1_ONCHAIN_HTTP_PLAN.md`](../../docs/plans/008-V0_2_1_ONCHAIN_HTTP_PLAN.md) — foundation HTTP stable ;
 - [`../../docs/plans/009-V0_2_2_HTTP_ACCOUNTS_TOKENS_CLUSTER_PLAN.md`](../../docs/plans/009-V0_2_2_HTTP_ACCOUNTS_TOKENS_CLUSTER_PLAN.md) — extension typed Accounts/Tokens/Cluster ;
 - [`../../docs/validation/004-V0_2_2_HTTP_ACCOUNTS_TOKENS_CLUSTER.md`](../../docs/validation/004-V0_2_2_HTTP_ACCOUNTS_TOKENS_CLUSTER.md) — matrice finale validée `0.2.2` ;
+- [`../../docs/plans/010-V0_2_3_HTTP_TRANSACTIONS_PLAN.md`](../../docs/plans/010-V0_2_3_HTTP_TRANSACTIONS_PLAN.md) — plan de la candidate `0.2.3` ;
+- [`../../docs/validation/006-V0_2_3_HTTP_TRANSACTIONS.md`](../../docs/validation/006-V0_2_3_HTTP_TRANSACTIONS.md) — matrice de clôture candidate `0.2.3` ;
 - [`../../config/std.transport.json`](../../config/std.transport.json) — configuration standard HTTP.
--- a/crates/ksp-onchain-transport-lib/USAGE.md
+++ b/crates/ksp-onchain-transport-lib/USAGE.md
@@ -1,5 +1,5 @@
 <!-- file: crates/ksp-onchain-transport-lib/USAGE.md -->
-<!-- version: 5 -->
+<!-- version: 6 -->

 # Utilisation de `ksp-onchain-transport-lib`

@@ -96,7 +96,24 @@ let epoch = pool.get_epoch_info(&role, None).await;
 let vote_accounts = pool.get_vote_accounts(&role, None).await;
 ```

-La surface stable `0.2.2` contient 26 wrappers typés au total : 4 foundation + 5 Accounts + 5 Tokens + 12 Cluster. Les DTOs Transport conservent les `null`, options et formes wire : données Account encodées/`jsonParsed`, `TokenAmount.uiAmount`, contexte RPC, nodes, epoch, leader schedule et vote accounts. Aucun décodage Program/SPL métier n'est effectué ici.
+La candidate `0.2.3-pre.009` contient 37 wrappers typés : 4 foundation + 5 Accounts + 5 Tokens + 12 Cluster + 11 Transactions. Les DTOs Transport conservent les `null`, options et formes wire sans décodage Program/SPL métier.
+
+Exemples Transaction représentatifs :
+
+```rust
+let context = ksp_onchain_transport_lib::SolanaContextConfig::new(
+    std::option::Option::Some(ksp_onchain_transport_lib::SolanaCommitment::Finalized),
+    std::option::Option::None,
+);
+let latest = pool
+    .get_latest_blockhash(&role, std::option::Option::Some(&context))
+    .await;
+let transaction_count = pool
+    .get_transaction_count(&role, std::option::Option::Some(&context))
+    .await;
+```
+
+`getTransaction` expose la config moderne complète et une forme bare-encoding legacy séparée et deprecated. `requestAirdrop` et `sendTransaction` sont des write submissions : elles utilisent la protection centrale `NeverAfterDispatch`. `simulateTransaction` reste une simulation retry-safe et conserve son résultat riche sans introduire de décodage Program.

 ## 4. Exécution JSON-RPC standard générique

@@ -155,13 +172,13 @@ La configuration standard route les événements `info` de Transport vers un fic

 ## 9. Smokes Devnet opt-in

-Le smoke **Transport pur** construit ses settings programmatiquement et exerce un sous-ensemble représentatif de `0.2.2` :
+Le smoke **Transport pur** construit ses settings programmatiquement et exerce un sous-ensemble représentatif de `0.2.2` puis trois reads Transactions de `0.2.3` :

 ```bash
 cargo test -p ksp-onchain-transport-lib --test transport_devnet_smoke -- --ignored --nocapture
 ```

-Il appelle `getAccountInfo`, `getTokenAccountsByOwner`, `getEpochInfo` et `getVoteAccounts`. La branche Token suit la forme Devnet documentée : owner Pubkey ordinaire de l'exemple officiel, selector `programId` avec l'ID canonique du programme SPL Token, puis config explicite `commitment: finalized` + `encoding: jsonParsed`. Une réponse vide reste acceptable : le smoke valide ainsi la route Token sans dépendre de la persistance d'un mint ou d'un token account Devnet particulier.
+Il appelle `getAccountInfo`, `getTokenAccountsByOwner`, `getEpochInfo`, `getVoteAccounts`, puis `getLatestBlockhash`, `isBlockhashValid` et `getTransactionCount`. La branche Token suit la forme Devnet documentée : owner Pubkey ordinaire de l'exemple officiel, selector `programId` avec l'ID canonique du programme SPL Token, puis config explicite `commitment: finalized` + `encoding: jsonParsed`. Une réponse vide reste acceptable. La branche Transaction reste read-only : elle ne déclenche ni airdrop ni soumission de transaction et ne remplace pas les fixtures déterministes couvrant les 11 wrappers.

 Le smoke historique de **composition Config -> Transport** reste également disponible :

--- a/crates/ksp-onchain-transport-lib/tests/transport_devnet_smoke.rs
+++ b/crates/ksp-onchain-transport-lib/tests/transport_devnet_smoke.rs
@@ -1,7 +1,7 @@
 // file: crates/ksp-onchain-transport-lib/tests/transport_devnet_smoke.rs
-// version: 3
+// version: 4

-//! Opt-in live Devnet smoke for the pure Transport Accounts/Tokens/Cluster path.
+//! Opt-in live Devnet smoke for representative pure Transport Accounts/Tokens/Cluster/Transactions reads.

 fn devnet_pool() -> ksp_core_lib::Result<ksp_onchain_transport_lib::HttpTransportPool> {
    let role = ksp_onchain_transport_lib::HttpRoleName::new("default");
@@ -42,7 +42,7 @@ fn devnet_pool() -> ksp_core_lib::Result<ksp_onchain_transport_lib::HttpTranspor

 #[tokio::test(flavor = "current_thread")]
 #[ignore = "opt-in live Solana Devnet smoke; performs external network requests"]
-async fn programmatic_devnet_transport_reaches_accounts_tokens_and_cluster_wrappers() {
+async fn programmatic_devnet_transport_reaches_accounts_tokens_cluster_and_transaction_read_wrappers() {
    let pool = devnet_pool().expect("programmatic Devnet Transport settings must construct a pool");
    let role = ksp_onchain_transport_lib::HttpRoleName::new("default");

@@ -94,4 +94,27 @@ async fn programmatic_devnet_transport_reaches_accounts_tokens_and_cluster_wrapp

    let vote_accounts = pool.get_vote_accounts(&role, std::option::Option::None).await.expect("Devnet getVoteAccounts smoke must succeed");
    assert!(!vote_accounts.current().is_empty() || !vote_accounts.delinquent().is_empty());
+
+    let transaction_context = ksp_onchain_transport_lib::SolanaContextConfig::new(
+        std::option::Option::Some(ksp_onchain_transport_lib::SolanaCommitment::Finalized),
+        std::option::Option::None,
+    );
+    let latest_blockhash = pool
+        .get_latest_blockhash(&role, std::option::Option::Some(&transaction_context))
+        .await
+        .expect("Devnet getLatestBlockhash smoke must succeed");
+    assert!(!latest_blockhash.value().blockhash().is_empty());
+    assert!(latest_blockhash.value().last_valid_block_height() > 0);
+
+    let blockhash_valid = pool
+        .is_blockhash_valid(&role, latest_blockhash.value().blockhash(), std::option::Option::Some(&transaction_context))
+        .await
+        .expect("Devnet isBlockhashValid smoke must succeed");
+    assert_eq!(blockhash_valid.value(), &true);
+
+    let transaction_count = pool
+        .get_transaction_count(&role, std::option::Option::Some(&transaction_context))
+        .await
+        .expect("Devnet getTransactionCount smoke must succeed");
+    assert!(transaction_count > 0);
 }