v0.2.9-pre.013-fix.003

deltas/0.2.9/pre.013-fix.003.md

@@ -0,0 +1,116 @@
+<!-- file: deltas/0.2.9/pre.013-fix.003.md -->
+<!-- version: 1 -->
+
+# Delta `0.2.9-pre.013-fix.003` — credentials PublicNode par réseau + fermeture live bornée
+
+## 1. Base
+
+```text
+0.2.9-pre.013-fix.002
+```
+
+Cette tranche reste strictement dans le couloir technique/live de fin de release. Elle ne modifie ni README/USAGE, ni plan/validation, ni CHANGELOG/ROADMAP, ni le prompt de la release suivante.
+
+## 2. Motif opérateur
+
+Deux exécutions live de `yellowstone_publicnode_smoke` avec deux personal tokens PublicNode différents ont montré que l'hypothèse de `fix.002` « un token commun Mainnet/Testnet » n'est pas suffisamment générale :
+
+- avec le premier token fourni au smoke, `SubscribeOpen` a retourné `PERMISSION_DENIED` sur Mainnet et Testnet ;
+- avec le second token, Mainnet a encore retourné `PERMISSION_DENIED` ;
+- avec ce même second token, Testnet a franchi `SubscribeOpen`, reçu le slot attendu, puis `close()` a retourné le timeout borné de cinq secondes parce que le provider n'a pas terminé son half-close avant la deadline KSP.
+
+Ces observations ne suffisent pas à affirmer que PublicNode documente des tokens obligatoirement liés à un réseau. Elles imposent en revanche que KSP puisse fournir des credentials distincts à Mainnet et Testnet et que le smoke ne suppose plus leur interchangeabilité.
+
+## 3. Version technique
+
+`workspace.package.version` devient :
+
+```text
+0.2.9-pre.13.fix.3
+```
+
+## 4. Config V3 — secrets PublicNode séparés
+
+Le placeholder partagé est supprimé au profit de deux variables indépendantes :
+
+```text
+KSP_SECRET_PUBLICNODE_MAINNET_GRPC_X_TOKEN
+KSP_SECRET_PUBLICNODE_TESTNET_GRPC_X_TOKEN
+```
+
+Le profil `publicnode_mainnet` consomme uniquement la première ; le profil `publicnode_testnet` consomme uniquement la seconde. Les deux restent injectées comme metadata gRPC secrète `x-token`, jamais dans l'URL.
+
+`.env.example` inventorie les deux noms sans valeur réelle. Le test Config construit chaque profil avec uniquement son propre canary d'environnement afin de vérifier cette séparation.
+
+## 5. Smoke PublicNode
+
+Le smoke Transport reste programmatique et indépendant de Config/env KSP. Son stdin contient maintenant exactement deux lignes :
+
+```text
+ligne 1 = token Mainnet
+ligne 2 = token Testnet
+```
+
+Les deux valeurs sont lues une seule fois dans un `OnceLock` et sont affectées explicitement au réseau correspondant. L'ordre d'exécution des deux tests n'influence donc pas l'association token/réseau.
+
+Après ouverture de `Subscribe` et réception d'un `YellowstoneSubscribeUpdate::Slot` avec `slot > 0`, la fermeture live accepte deux résultats :
+
+1. fermeture gracieuse `Ok(())` du provider ;
+2. `ERROR_CODE_TIMEOUT` produit par la deadline KSP de half-close.
+
+Le second résultat ne masque pas un échec fonctionnel : il n'est accepté qu'après réception prouvée d'un slot et un `timeout` externe de sept secondes vérifie que `session.close()` reste lui-même borné. Toute autre erreur de fermeture reste un échec du smoke.
+
+Le runtime Yellowstone n'est pas modifié par cette adaptation provider/live ; ses contrats déterministes de fermeture restent inchangés.
+
+## 6. Gate opérateur ciblé
+
+```bash
+cargo fmt --all
+python3 scripts/audit_rust_workspace_rules.py
+python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.2.9
+cargo check --workspace
+cargo clippy --workspace --all-targets
+cargo test -p ksp-config-lib
+cargo test -p ksp-onchain-transport-lib
+cargo test -p ksp-core-lib --test workspace_dependencies
+```
+
+Puis, avec les deux personal tokens réellement générés :
+
+```bash
+read -rsp 'PublicNode Mainnet Yellowstone x-token: ' PUBLICNODE_MAINNET_TOKEN
+echo
+read -rsp 'PublicNode Testnet Yellowstone x-token: ' PUBLICNODE_TESTNET_TOKEN
+echo
+printf '%s\n%s\n' "$PUBLICNODE_MAINNET_TOKEN" "$PUBLICNODE_TESTNET_TOKEN" \
+  | cargo test -p ksp-onchain-transport-lib --test yellowstone_publicnode_smoke -- --ignored --nocapture
+unset PUBLICNODE_MAINNET_TOKEN PUBLICNODE_TESTNET_TOKEN
+```
+
+Attendu :
+
+```text
+2 passed
+0 failed
+0 ignored
+```
+
+Puis les graphes et le gate workspace de fermeture technique :
+
+```bash
+cargo tree -p ksp-onchain-transport-lib
+cargo tree -p ksp-onchain-transport-lib --duplicates
+cargo tree --duplicates
+cargo test --workspace
+```
+
+## 7. Fichiers modifiés/ajoutés
+
+```text
+.env.example
+Cargo.toml
+config/std.transport.json
+crates/ksp-config-lib/unit_tests/transport.rs
+crates/ksp-onchain-transport-lib/tests/yellowstone_publicnode_smoke.rs
+deltas/0.2.9/pre.013-fix.003.md
+```