Sandbox Engine v0.4.2 – Moteur de démonstration GHI
1. Rôle du moteur GHI
Le Sandbox Engine est un moteur synthétique utilisé pour démontrer la méthodologie du Global HashCost Index (GHI) et pour tester l’API publique dans un environnement stable.
Toutes les valeurs sont générées de manière déterministe, sans consommation de données réelles. Il s’agit d’un outil d’intégration technique et pédagogique.
Important : ce moteur n’est pas destiné à la prise de décision financière. Il sert uniquement à l’évaluation méthodologique et aux tests API.
2. Version courante : Sandbox Engine v0.4.2
- Engine :
v0.4.2-sandbox - API principale :
API v1.1 - Méthodologie :
v1.0.0
Caractéristiques essentielles
- Alignement complet avec la spécification API v1.1
- Structure normalisée des régions pour
/regions&/snapshot - Endpoints supplémentaires :
/metadata,/network,/forecast - Données cohérentes et reproductibles
- 100% des tests CI du dépôt
ghi-enginepassent
3. Architecture fonctionnelle
Le moteur se compose de modules clairs et isolés :
- Générateur réseau : hashrate, difficulté, frais moyens
- Coûts régionaux : min / avg / max synthétiques
- Statistiques globales : agrégation régionale
- Adaptateur API : formate les réponses
- Métadonnées : version & horodatage injectés dans chaque réponse
Architecture conçue pour être facilement lue dans le code Python/FastAPI du dépôt GitHub.
4. Endpoints servis
| Endpoint | Description | Statut |
|---|---|---|
/v1/ghi/snapshot |
Coûts régionaux + statistiques globales | Stable |
/v1/ghi/history |
Séries historiques synthétiques | Stable |
/v1/ghi/regions |
Liste des régions GHI | Stable |
/v1/ghi/metadata |
Métadonnées API + moteur | Stable |
/v1/ghi/network |
Métriques réseau synthétiques | Beta |
/v1/ghi/forecast |
Prévision synthétique du coût moyen | Beta |
Pour les schémas complets, voir :
→ Documentation API v1.1
→
Spécification technique GitHub
5. Garanties institutionnelles
- Déterminisme total
- Versionnement explicite
- Stabilité de schéma
- Transparence du code (GitHub)
6. Roadmap
- Intégration progressive de données réelles
- Segmentation plus fine par sous-régions
- Temporalité plus riche (halvings, chocs, saisonnalité)
- Indicateurs avancés pour institutions et chercheurs
Documentation des évolutions : Changelog.
7. Ressources liées
Sandbox Engine v0.4.2 – GHI Demonstration Engine
1. Engine purpose
The Sandbox Engine is a synthetic compute engine used to demonstrate the Global HashCost Index (GHI) methodology and to exercise the public API in a stable environment.
All values are deterministically generated so that technical users and institutions can rely on reproducible results.
Important: this engine is for demonstration and technical integration only, not financial decision-making.
2. Current version: Sandbox Engine v0.4.2
- Engine:
v0.4.2-sandbox - Main API:
API v1.1 - Methodology:
v1.0.0
Main properties
- Full alignment with API v1.1 specification
- Normalized regional structure
- New endpoints:
/metadata,/network,/forecast - Consistent synthetic production-cost data
- All automated tests in
ghi-enginepass
3. High-level architecture
- Network generator
- Regional cost module
- Global statistics calculator
- API adapter
- Metadata injector
4. Powered endpoints
| Endpoint | Description | Status |
|---|---|---|
/v1/ghi/snapshot | Regional costs + global stats | Stable |
/v1/ghi/history | Synthetic historical series | Stable |
/v1/ghi/regions | Available regions | Stable |
/v1/ghi/metadata | API & engine metadata | Stable |
/v1/ghi/network | Synthetic metrics | Beta |
/v1/ghi/forecast | Synthetic forecast | Beta |
5. Institutional guarantees
- Determinism
- Explicit versioning
- Schema stability
- Open-source transparency
6. Roadmap
- Real-data integration
- Regional deep segmentation
- Temporal modelling (seasonality, shocks, halvings)
- Advanced indicators