Structure du projet Awesome-ZKVM

Après avoir cloné ou téléchargé le dépôt awesome-zkvm, vous rencontrerez l’organisation suivante :

awesome-zkvm/
├── benchmarks/           # Scripts et résultats de tests de performance
├── build/                # Scripts de compilation et Makefile
├── contrib/              # Code et outils fournis par la communauté
├── contracts/            # Code lié aux smart contracts (le cas échéant)
├── docs/                 # Documentation du projet (API, guides)
├── examples/             # Exemples d’utilisation et démonstrations
├── include/              # Fichiers d’en-tête et définitions d’interface
├── lib/                  # Implémentation des bibliothèques centrales
├── scripts/              # Scripts de maintenance et d’automatisation
├── src/                  # Code source principal
├── test/                 # Tests unitaires et fonctionnels
├── tools/                # Outils de développement et de débogage
├── vascular/             # Composant réseau (communication)
├── zk/                   # Composant zero-knowledge proof
├── CMakeLists.txt        # Fichier CMake principal
└── README.md             # Présentation générale du projet

Chaque répertoire a un rôle précis :

• benchmarks/ : scripts de mesure de performance.
• build/ : configuration de compilation via CMake et Makefile.
• contrib/ : contributions externes (outils, correctifs).
• contracts/ : code des smart contracts si le projet intègre la blockchain.
• docs/ : documentation technique et API.
• examples/ : exemples prêts à l’emploi.
• include/ : interfaces et headers publics.
• lib/ : noyau de la logique.
• scripts/ : automatisation (déploiement, tests).
• src/ : code source de l’application.
• test/ : batteries de tests.
• tools/ : utilitaires de développement.
• vascular/ : gestion des communciations réseau.
• zk/ : implémentation des preuves à divulgation nulle de connaissance.

Fichier de démarrage

Le point d’entrée principal se trouve généralement dans src/. Par exemple, pour un outil en ligne de commande, il s’agira de main.cpp. La procédure typique pour compiler et exécuter :

1. Se placer à la racine du projet.
2. Lancer le script de compilation : mkdir build && cd build && cmake .. && make.
3. Exécuter le binaire généré : ./votre_executable.

Fichier de configuration

Les paramètrees d’exécution (connexion base de données, clés API, etc.) sont définis dans un fichier de configuration. Il peut être au format JSON, YAML ou INI. Voici un exemple minimal en INI :

[global]
loglevel = debug
port = 8080

[database]
host = localhost
port = 3306
user = admin
password = secret
db = awesome_zkvm

Ce fichier configure la journalisation, le port du serveur et les accès à la base de données. Au lancement, le projet lit ce fichier et applique les réglages. Adaptez les valeurs selon votre environnement en suivant la documentation officielle ou les commentaires du code source.