Global HashCost Index

Open indicator of Bitcoin’s production cost.

GHI – Global HashCost Index • API v1.0 • Méthodologie v1.0 • Engine v0.4.0-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 :

  • un moteur public documenté (mode Sandbox) ;
  • une méthodologie versionnée et publiée ;
  • 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 actuellement déployé côté public est le Sandbox Engine v0.4.0-sandbox. Il présente les caractéristiques suivantes :

  • data_origin = "sandbox" dans toutes les réponses d’API ;
  • engine_version = "v0.4.0-sandbox" ;
  • stability_seed = 42 – les données sont déterministes ;
  • les valeurs de coûts sont factices et ne doivent pas être interprétées 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 (flots réseau, données régionales internes, etc.) ;
  • 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 traitements de qualité de données (contrôles, filtres, cohérence temporelle).

Cette séparation garantit à la fois l’ouverture du standard et la confidentialité des hypothèses internes utilisées dans les environnements de production.

3. Ce qui reste volontairement non public

Pour des raisons de confidentialité, de sécurité opérationnelle et de protection des données, certains éléments ne sont pas publiés dans le dépôt open source :

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

Le Data Model v1.0 et l’API publique permettent néanmoins à des tiers de reproduire leur propre version du moteur en utilisant leurs propres hypothèses.

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

Pour vérifier un résultat GHI dans l’API publique :

  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 versions indiquées sur les pages “Méthodologie”, “API” et “Changelog”.
  4. Le cas échéant, ouvrir une issue GitHub si un comportement inattendu est observé.

5. Audit & supervision

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

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

Ces procédures font partie du cadre de gouvernance et d’audit du GHI et sont décrites à haut niveau dans les documents “Méthodologie + Transparence”.

GHI Transparency & Documentation

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

  • a documented public engine (in Sandbox mode);
  • a versioned, published 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 currently deployed public engine is the Sandbox Engine v0.4.0-sandbox. Its main properties are:

  • data_origin = "sandbox" in all API responses;
  • engine_version = "v0.4.0-sandbox";
  • stability_seed = 42 – the data is deterministic;
  • cost values are synthetic and must not be interpreted as real-world costs.

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

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

This separation preserves both the openness of the standard and the confidentiality of internal assumptions used in production deployments.

3. Intentionally non-public components

For confidentiality, operational security and data protection reasons, several components are not exposed in the open-source repository:

  • 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 Data Model v1.0 and the public API still allow third parties to build and run their own engine instance using their own assumptions.

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

To verify a GHI result from the public API:

  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 versions stated on the “Methodology”, “API” and “Changelog” pages.
  4. If any unexpected behaviour is observed, open a GitHub issue for review.

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;
  • replay of historical snapshots;
  • additional technical documentation on the internal architecture.

These procedures are part of the GHI governance and audit framework, and are outlined at a high level in the “Methodology + Transparency” documents.