Sasedev/khadhroony-bot3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.1.0-pre.023

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-07-24 23:54:38 +02:00
parent 929c89cf9f
commit c30ba8a2d9
28 changed files with 203 additions and 160 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/HISTORICAL_DATA_ACQUISITION_PLAN.md
View File

@@ -31,12 +31,12 @@ W2 — historique manuel
-> aucune consommation implicite du budget réservé au trading
```
W2 ne remplace ni `kb_rpc`, ni le pipeline canonique, ni les fournisseurs temps réel. Il sert à alimenter progressivement PostgreSQL avec des données historiques dont la latence n'est pas critique.
W2 ne remplace ni `kb_onchain_transport`, ni le pipeline canonique, ni les fournisseurs temps réel. Il sert à alimenter progressivement PostgreSQL avec des données historiques dont la latence n'est pas critique.
## 2. Principes non négociables
- `kb_rpc` reste la frontière des protocoles Solana : JSON-RPC HTTP/WS standard, extensions fournisseur officiellement prises en charge, Yellowstone/gRPC et transports similaires.
- Une source historique parlant JSON-RPC standard peut réutiliser `kb_rpc`, mais sa politique de campagne, son coût, sa provenance et ses fallbacks restent hors de `kb_rpc`.
- `kb_onchain_transport` reste la frontière des protocoles Solana : JSON-RPC HTTP/WS standard, extensions fournisseur officiellement prises en charge, Yellowstone/gRPC et transports similaires.
- Une source historique parlant JSON-RPC standard peut réutiliser `kb_onchain_transport`, mais sa politique de campagne, son coût, sa provenance et ses fallbacks restent hors de `kb_onchain_transport`.
- Les APIs REST indexées, exports, datasets analytiques, archives CAR ou outils externes appartiennent à des crates de sources historiques séparées.
- W2 fonctionne en `free_only` par défaut. Aucun fournisseur payant ne doit être interrogé sans autorisation explicite de la campagne.
- Les endpoints et crédits de W1 ne doivent jamais être utilisés comme fallback silencieux de W2.
@@ -95,7 +95,7 @@ kb_historical_api
-> capacités, campagnes, candidats, provenance, coût et complétude
kb_historical_source_rpc
-> profils RPC publics/best-effort utilisant les contrats de kb_rpc
-> profils RPC publics/best-effort utilisant les contrats de kb_onchain_transport
kb_historical_source_old_faithful
-> intégration avec un processus faithful-cli externe ou une archive locale
@@ -325,7 +325,7 @@ Mesurer pour chaque source :
### Phase R2 — source RPC gratuite
- réutiliser `kb_rpc` pour les méthodes standards ;
- réutiliser `kb_onchain_transport` pour les méthodes standards ;
- ajouter quotas, backoff, déduplication et frontières de complétude.
### Phase R3 — archive profonde
@@ -350,6 +350,6 @@ Ce chantier ne revient dans le `ROADMAP.md` que lorsque :
- les décodeurs/matérialisateurs/exécuteurs prioritaires ont suffisamment progressé ;
- au moins deux sources gratuites ont été testées réellement ;
- une stratégie de licence et de conditions d'utilisation est validée ;
- la frontière avec `kb_rpc`, `kb_pipeline` et PostgreSQL est décidée ;
- la frontière avec `kb_onchain_transport`, `kb_pipeline` et PostgreSQL est décidée ;
- la politique `free_only` est testable et empêche réellement tout fallback payant ;
- un prompt de session dédié peut être écrit sans hypothèse majeure non vérifiée.