117 lines
4.5 KiB
Markdown
117 lines
4.5 KiB
Markdown
<!-- 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
|
|
```
|