v0.4.8-pre.010

config/README.md

@@ -1,5 +1,5 @@
 <!-- file: config/README.md -->
-<!-- version: 16 -->
+<!-- version: 17 -->
 
 # Configuration locale
 
@@ -77,3 +77,28 @@ logs/<profil>/kb-lib/materializer/transaction/annotations/
 ```
 
 Le test de configuration découvre dynamiquement toutes les crates déclarant `tracing.workspace = true` et vérifie leurs trois routes dans chaque profil. Les logs ne doivent contenir ni secret, ni DSN non masqué, ni payload Config ou bytecode complet.
+
+## Limites du profil public Devnet
+
+`api.devnet.solana.com` est un endpoint public partagé. Les limites configurées par rôle ne sont pas des quotas indépendants fournis par le serveur : leur débit cumulé doit rester sous la limite globale de l’endpoint, et chaque méthode RPC doit également rester sous sa propre limite.
+
+L’exemple `local_devnet` utilise donc volontairement des valeurs conservatrices :
+
+```text
+http_queries:
+  requests_per_second: 3
+  burst_capacity: 3
+  max_concurrent_requests: 2
+  pause_after_rate_limit_ms: 10000
+
+http_transactions:
+  requests_per_second: 1
+  burst_capacity: 1
+  max_concurrent_requests: 1
+  pause_after_rate_limit_ms: 10000
+```
+
+Un fichier de configuration local déjà créé n’est pas modifié automatiquement lorsque `example.config.json` évolue. L’opérateur doit reporter explicitement ces valeurs dans son profil `local_devnet`.
+
+Un warning `retry_http_json_rpc_after_rate_limit` reste possible sur un service public partagé. Il indique que le cooldown et le retry borné ont été activés ; il ne constitue un échec que si les tentatives finissent par être épuisées.
+