Global HashCost Index

Open indicator of Bitcoin’s production cost.

GHI – Global HashCost Index • API v1.1 • Methodology v1.0 • Engine v0.4.3-sandbox

Langue / Language : FR · EN

Transparence & documentation GHI

Le Global HashCost Index (GHI) est conçu comme un standard ouvert. La transparence repose sur trois piliers fondamentaux :

  • un moteur public documenté (mode Sandbox) ;
  • une méthodologie publiée et traçable ;
  • un historique clair des changements (changelogs, releases GitHub).

1. Ce qui est public

Les éléments suivants sont publiés dans le dépôt ghi-engine et sur ce site :

2. Moteur public vs moteur privé

Le moteur public accessible via l’API fonctionne en mode Sandbox. Il présente les caractéristiques suivantes :

  • data_origin = "sandbox" dans toutes les réponses d’API ;
  • données déterministes (stabilité des résultats) ;
  • valeurs de coûts factices, non interprétables comme des coûts réels.

Le moteur privé réel (non publié) applique la même structure de données et les mêmes contrats API, mais avec :

  • des sources de données réelles (réseau, énergie, régions) ;
  • des formules de coût calibrées et non linéaires ;
  • des hypothèses détaillées par région et par type d’ASIC ;
  • des contrôles avancés de qualité et de cohérence des données.

Cette séparation garantit à la fois l’ouverture du standard et la confidentialité des hypothèses internes.

3. Ce qui reste volontairement non public

  • séries complètes de données internes (réseau, énergie, sites miniers) ;
  • profils détaillés par site, contrat ou contrepartie ;
  • paramètres de calibration du moteur réel ;
  • scripts d’ingestion propriétaires et configuration d’infrastructure ;
  • données sous NDA (partenaires, régulateurs, institutions).

Le Data Model et l’API publique permettent néanmoins à des tiers de reproduire leur propre implémentation du moteur, à partir de leurs hypothèses.

4. Vérifier un résultat GHI (mode public)

  1. Appeler l’endpoint /v1/ghi/indicator ou /v1/ghi/snapshot.
  2. Contrôler le bloc de métadonnées retourné : api_version, methodology_version, engine_version, data_origin, stability_seed.
  3. Comparer avec les informations disponibles sur les pages “Méthodologie”, “API” et “Changelog”.
  4. Ouvrir une issue GitHub en cas de comportement inattendu.

5. Audit & supervision

Pour les régulateurs, superviseurs et institutions travaillant sous NDA, GHI peut fournir, dans des environnements contrôlés :

  • des exemples anonymisés d’entrées/sorties du moteur réel ;
  • des replays de snapshots historiques ;
  • une documentation technique complémentaire.

GHI Transparency & Documentation

The Global HashCost Index (GHI) is designed as an open standard. Transparency relies on three core pillars:

  • a documented public engine (Sandbox mode);
  • a published and traceable methodology;
  • a clear change history (changelogs, GitHub releases).

1. Public information

The following items are public in the ghi-engine repository and on this website:

2. Public vs private engine

The public engine exposed via the API operates in Sandbox mode. Its key properties are:

  • data_origin = "sandbox" in all API responses;
  • deterministic outputs for testing and validation;
  • synthetic cost values that must not be interpreted as real-world data.

The private real engine (non-public) uses the same data structures and API contracts, but with:

  • real data sources (network feeds, internal regional datasets);
  • calibrated, nonlinear cost formulas;
  • detailed assumptions per region and ASIC type;
  • advanced data quality and consistency checks.

This separation preserves both the openness of the standard and the confidentiality of internal assumptions.

3. Intentionally non-public components

  • full internal datasets (network, energy, mining sites);
  • detailed profiles by site, contract or counterparty;
  • calibration parameters of the real engine;
  • proprietary ingestion scripts and infrastructure configuration;
  • any data under NDA with partners, regulators or institutions.

The public data model and API still allow third parties to build their own engine implementation using independent assumptions.

4. How to verify a GHI result (public mode)

  1. Call /v1/ghi/indicator or /v1/ghi/snapshot.
  2. Check the metadata block: api_version, methodology_version, engine_version, data_origin, stability_seed.
  3. Compare with the information available on the “Methodology”, “API” and “Changelog” pages.
  4. Open a GitHub issue if any unexpected behaviour is observed.

5. Audit & supervisory access

For regulators, supervisors and institutional partners working under NDA, GHI can provide, in controlled environments:

  • anonymised input–output examples from the real engine;
  • replays of historical snapshots;
  • additional technical documentation.