Aller au contenu

Plus et dépannage

Clé API

C'est une bonne pratique d'utiliser une clé API pour limiter l'accès aux endpoints REST de votre fullnode.

Configuration de la clé API

Veuillez ajouter ce qui suit à votre user.conf en remplaçant les zéros par votre propre clé (>= 32 caractères).

Text Only
alephium.api.api-key = "--- votre propre clé avec >= 32 caractères"

Redémarrez votre fullnode pour que cela prenne effet.

Génération de la clé API

Sous GNU/Linux: cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 48 | head -n 1

Utiliser la clé API

  1. Cliquez sur le bouton Authorize en haut à droite de votre interface Swagger: full-node-api-key-auth0

  2. Remplissez la case de valeur avec votre clé et cliquez sur le bouton d'autorisation: full-node-api-key-auth1

Maintenant vous pouvez utiliser Swagger UI comme s'il n'y avait pas de clé API.

Comment rendre l'API du nœud complet publiquement accessible?

  1. Configurez correctement votre clé API en suivant le guide ci-dessus.

  2. Ajoutez ce qui suit à votre fichier user.conf et redémarrez votre nœud complet.

Text Only
alephium.api.network-interface = "0.0.0.0"

Pour accéder à l'interface utilisateur Swagger de votre nœud complet depuis un autre ordinateur dans le même sous-réseau, suivez ces étapes:

  1. Ajoutez ce qui suit à votre fichier user.conf et redémarrez votre nœud complet.
Text Only
alephium.api.network-interface = "0.0.0.0"
  1. Changez le host de l'interface Swagger UI pour qu'il corresponde à l'IP du sous-réseau de votre nœud complet.

Error "java.lang.AssertionError: assumption failed"

Cette erreur survient souvent en raison d'une perte de connexion pendant la synchronisation du nœud et signifie que certains fichiers sont corrompus. Pour résoudre le problème:

  1. Supprimez le dossier .alephium rm .alephium

  2. Redémarrez le nœud et attendez la synchronisation java -jar alephium-x.x.x.jar

Déplacement du dossier de données Alephium

De nombreux utilisateurs préfèrent conserver le dossier de données Alephium sur un disque différent du disque de démarrage principal. Pour ce faire avec le jar du nœud complet Alephium, vous pouvez utiliser la variable d'environnement ALEPHIUM_HOME:

  1. Arrêtez le jar du nœud complet Alephium.
  2. Déplacez le dossier de données Alephium (normalement situé à %userprofile%\.alephium pour Windows ou ~/.alephium pour Linux et macOS) vers le nouvel emplacement.
  3. Ajoutez une variable d'environnement ALEPHIUM_HOME au système, pointant vers le nouvel emplacement. Vous pouvez le faire au niveau du système ou simplement créer un fichier batch qui définit la variable avant de démarrer le jar Alephium.
  4. Redémarrez le nœud Alephium.

Si vous utilisez le nœud complet Docker, changez simplement les définitions des dossiers montés dans le fichier Docker pour qu'ils pointent vers le nouveau domicile, puis redémarrez.

Personnalisation des journaux

Plusieurs variables d'environnement sont utilisées pour la journalisation:

  • ALEPHIUM_LOG_LEVEL peut changer le niveau de journalisation de la console.
  • ALEPHIUM_ENABLE_DEBUG_LOGGING peut activer la journalisation de débogage.
  • ALEPHIUM_HOME peut changer le dossier principal du nœud complet, et donc le dossier des journaux.

Voici un exemple avec toutes les options de journalisation possibles:

Text Only
ALEPHIUM_HOM=<folder> ALEPHIUM_LOG_LEVEL=<DEBUG | INFO | WARN | ERROR> ALEPHIUM_ENABLE_DEBUG_LOGGING=<true | false> java -jar alephium-x.x.x.jar

Il est également possible de remplacer le fichier de configuration des journaux d'Alephium.

Text Only
java -Dlogback.configurationFile=/path/to/config.xml alephium-x.x.x.jar

Élagage

Un nœud complet Alephium entièrement synchronisé nécessite plus de 80 Go d'espace disque pour stocker les données de la blockchain. Depuis la version 2.6.1 , le nœud complet Alephium prend en charge l'élagage du stockage, ce qui peut réduire considérablement les besoins en espace de stockage.

Voici les étapes pour élaguer le nœud complet Alephium:

Utilisation du fichier Jar

  1. Assurez-vous que le nœud complet Alephium est arrêté.
  2. Téléchargez alephium-tools-x.y.z.jar from https://github.com/alephium/alephium/releases
  3. Si vous avez modifié le répertoire principal d'Alephium par défaut, définissez la variable d'environnement ALEPHIUM_HOME.
  4. Exécutez la commande suivante java -cp alephium-tools-x.y.z.jar org.alephium.tools.PruneStorage pour commencer l'élagage.
  5. Attendez que la commande termine son exécution, l'espace disque devrait être réduit à environ 20 Go.
  6. Redémarrez le nœud complet Alephium.

Utilisation de Docker

  1. Assurez-vous que le nœud complet Alephium est arrêté.
  2. Exécutez la commande suivante docker run -it -v ${YOUR_ALEPHIUM_HOME}:/alephium-home/.alephium alephium/alephium-tools:x.y.z org.alephium.tools.PruneStorage
  3. Attendez que la commande termine son exécution, l'espace disque devrait être réduit à environ 20 Go.
  4. Redémarrez le nœud complet Alephium.