Aller au contenu principal

Avant de commencer : les outils et un portefeuille testnet

Chaque tutoriel de cette section part d'un ordinateur où rien n'est installé. Cette page est le seul endroit où vous préparez cette installation. Faites-le une fois, puis ouvrez n'importe quel tutoriel. Chaque tutoriel renvoie ici et ne répète que les courtes commandes de vérification dont il a besoin.

Durée : environ 20 à 40 minutes la première fois, surtout du temps de téléchargement. Vous n'installez que les outils du tutoriel que vous voulez suivre.

Un compte testnet jetable uniquement

Tout ce qui suit s'exécute sur le testnet de QoreChain, où le QOR n'a aucune valeur. N'utilisez jamais votre vrai portefeuille, une vraie phrase de récupération ou de vrais fonds dans un tutoriel. Vous allez créer un nouveau compte uniquement pour cet exercice.

De quels outils chaque tutoriel a-t-il besoin ?​

N'installez que les lignes dont vous avez besoin. Git, un terminal et un navigateur web sont nécessaires pour tous.

TutorielLangageOutils à installerPortefeuille QoreX
Guide de l'atelier 1TypeScriptNode.js, pnpm, curl, jq (facultatif)Inutile
Q-Day CounterTypeScriptGit, Node.js, pnpmInutile
Q-Day GuestbookTypeScriptGit, Node.js, pnpmNécessaire, avec un compte Ethereum (coin 60)
Hybrid InspectorTypeScriptGit, Node.js, pnpmNécessaire
Rust, qday-payRustGit, RustInutile
Java, Tip JarJavaGit, Java 21, MavenInutile
Python, AirdropPythonGit, Python 3.10 ou plus récentInutile

Ouvrir un terminal​

Un terminal est une fenêtre dans laquelle vous tapez des commandes. Vous y collerez les commandes de ces pages, une à la fois.

SystèmeComment l'ouvrir
macOSAppuyez sur Commande et Espace, tapez Terminal, puis appuyez sur Retour.
WindowsOuvrez le menu Démarrer, tapez PowerShell, ouvrez Windows PowerShell. Pour le tutoriel Java, il vous faut aussi Git Bash (il est fourni avec Git, voir plus bas) ou WSL.
LinuxAppuyez sur Ctrl, Alt et T, ou cherchez Terminal dans vos applications.

Après avoir installé un outil, fermez le terminal et ouvrez-en un nouveau. Un terminal qui était ouvert pendant l'installation ne voit pas encore le nouvel outil.

Installer les outils​

Pour chaque outil, vous avez la commande d'installation ou le lien de téléchargement, puis la commande de vérification. Une commande de vérification demande sa version à l'outil. Si elle affiche un numéro de version égal ou supérieur à celui demandé, l'outil fonctionne.

Gestionnaires de paquets (aides facultatives)​

Un gestionnaire de paquets installe d'autres programmes avec une seule commande. Vous pouvez aussi télécharger chaque outil à la main depuis son site. Les commandes ci-dessous utilisent l'aide adaptée à votre système.

SystèmeAideComment l'obtenir
macOSHomebrewCollez cette ligne dans le terminal, puis suivez ce qu'elle affiche : /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
WindowswingetDéjà inclus dans Windows 10 et 11. Vérifiez avec winget --version.
LinuxaptDéjà inclus sur Ubuntu et Debian. Autres systèmes : utilisez votre propre gestionnaire de paquets (dnf, pacman).

Git​

Git télécharge le code d'exemple depuis GitHub.

SystèmeInstallation
macOSxcode-select --install (une fenêtre s'ouvre, choisissez Installer), ou brew install git
Windowswinget install --id Git.Git -e, ou téléchargement depuis git-scm.com
Linuxsudo apt install -y git

Vérifiez :

git --version

Vous devez voir une ligne comme git version 2.40.0. Toutes les versions conviennent.

Node.js 22.13 ou plus récent​

Node.js exécute les projets TypeScript. Hardhat 3, l'outil de contrats utilisé ici, refuse de démarrer avec une version de Node.js antérieure à 22.13.

SystèmeInstallation
macOSbrew install node, ou téléchargez l'installateur LTS depuis nodejs.org
Windowswinget install --id OpenJS.NodeJS.LTS -e, ou téléchargez l'installateur LTS depuis nodejs.org
Linux (Ubuntu, Debian)curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - puis sudo apt install -y nodejs
Linux : n'utilisez pas le paquet apt par défaut

Sur Ubuntu et Debian, sudo apt install nodejs installe une ancienne version, trop basse. Utilisez la ligne NodeSource ci-dessus.

Vérifiez :

node -v

Vous devez voir v22.13.0 ou plus, par exemple v22.20.0 ou v24.1.0. Si vous voyez un numéro plus bas, réinstallez et ouvrez un nouveau terminal.

pnpm 9 ou plus récent​

pnpm installe les bibliothèques dont un projet TypeScript a besoin. Il fait le même travail que npm, en plus rapide.

Installez-le avec l'outil d'installation propre à Node.js, npm, sur tous les systèmes :

npm install -g pnpm
PartieCe qu'elle fait
npm installTélécharge et installe un programme.
-gAbréviation de « global » : l'installe pour tout votre ordinateur, et non pour un seul dossier.
pnpmLe programme à installer.

Sur macOS et Linux, si la commande se termine par EACCES ou « permission denied », relancez-la sous la forme sudo npm install -g pnpm.

Node.js installé avec Homebrew n'inclut pas pnpm

Si un tutoriel affiche pnpm: command not found (ou zsh: command not found: pnpm), c'est que pnpm n'est pas encore installé. Lancez npm install -g pnpm, ouvrez un nouveau terminal et réessayez.

Vérifiez :

pnpm -v

Vous devez voir 9.0.0 ou plus, par exemple 10.4.1.

curl et jq (guide de l'atelier 1 uniquement)​

curl télécharge une adresse web depuis le terminal. Vous l'utilisez pour lire votre transaction sur le point de terminaison REST public. jq filtre la longue réponse pour ne vous montrer que la partie utile. jq est facultatif.

Systèmecurljq
macOSInclus.brew install jq
WindowsInclus dans Windows 10 et 11 sous le nom curl.exe.winget install --id jqlang.jq -e
Linuxsudo apt install -y curl s'il manquesudo apt install -y jq

Vérifiez :

curl --version
jq --version

Vous devez voir une ligne de version pour chacun, par exemple jq-1.7.

Windows PowerShell : tapez curl.exe

Dans PowerShell, le mot court curl désigne une autre commande intégrée. Tapez curl.exe à la place de curl dans toutes les commandes de ces pages. Si vous utilisez Git Bash, curl seul fonctionne.

Rust 1.88 ou plus récent (tutoriel Rust uniquement)​

Rust compile l'application en ligne de commande qday-pay. Vous l'installez avec rustup, l'installateur officiel de Rust. Il installe aussi cargo, l'outil de compilation de Rust.

SystèmeInstallation
macOScurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh (appuyez sur Retour pour accepter le choix par défaut). Les outils de compilation viennent avec xcode-select --install.
WindowsTéléchargez et lancez rustup-init.exe depuis rustup.rs, ou winget install --id Rustlang.Rustup -e. Quand il propose les Visual Studio C++ Build Tools, acceptez : Rust en a besoin pour compiler des programmes sous Windows.
Linuxsudo apt install -y build-essential curl puis curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh (appuyez sur Retour pour accepter le choix par défaut)

Vérifiez :

rustc --version
cargo --version

Vous devez voir rustc 1.88.0 ou plus et une ligne de version de cargo. Si Rust est déjà installé, rustup update le met à jour.

Java 21 et Maven (tutoriel Java uniquement)​

L'application Tip Jar a besoin d'un JDK Java 21 ou plus récent (les outils pour compiler et exécuter du Java) et de Maven, l'outil de compilation qui télécharge les bibliothèques Java.

SystèmeInstallation
macOSbrew install --cask temurin@21 puis brew install maven (ou utilisez l'installateur de adoptium.net)
Windowswinget install --id EclipseAdoptium.Temurin.21.JDK -e, puis téléchargez Maven depuis maven.apache.org/download.cgi, décompressez-le et ajoutez son dossier bin au PATH. Voie plus simple : installez WSL (voir plus bas) et suivez la ligne Linux.
Linuxsudo apt install -y openjdk-21-jdk maven

Vérifiez :

java -version
mvn -version

Vous devez voir openjdk version "21 (ou un numéro plus élevé comme 25) et Apache Maven 3. suivi d'une version. Si java -version affiche 17 ou moins, installez Java 21 et ouvrez un nouveau terminal.

Python 3.10 ou plus récent avec venv (tutoriel Python uniquement)​

Python exécute l'application Airdrop. venv crée un dossier privé pour ses bibliothèques, de sorte que rien d'autre sur votre ordinateur n'est touché.

SystèmeInstallation
macOSbrew install python, ou téléchargement depuis python.org
Windowswinget install --id Python.Python.3.12 -e, ou téléchargement depuis python.org en cochant Add python.exe to PATH dans l'installateur
Linuxsudo apt install -y python3 python3-venv python3-pip

Vérifiez :

python3 --version

Vous devez voir Python 3.10.0 ou plus. Sous Windows, tapez plutôt python --version (la commande est python, et non python3).

Windows et les commandes Linux : WSL​

La plupart des commandes des tutoriels sont identiques sur tous les systèmes. Quelques-unes utilisent des fonctions du shell Linux : source, chmod, ./tipjar et sleep. Sous Windows, vous avez deux choix :

  1. Windows natif. Utilisez PowerShell pour les tutoriels TypeScript, Rust et Python. Les tutoriels donnent la variante Windows quand elle diffère, par exemple .venv\Scripts\activate. Pour le tutoriel Java, utilisez Git Bash (installé avec Git).
  2. WSL. Le sous-système Windows pour Linux vous donne un vrai Linux dans Windows. Ouvrez PowerShell en administrateur, lancez la commande ci-dessous, redémarrez, puis suivez les lignes Linux de cette page dans la fenêtre Ubuntu.
wsl --install
PartieCe qu'elle fait
wslL'outil du sous-système Windows pour Linux.
--installInstalle WSL et le système Linux Ubuntu en une seule étape.

Tout vérifier d'un coup​

Lancez les commandes des outils que vous avez installés. Chacune doit afficher une version.

git --version
node -v
pnpm -v
rustc --version
java -version
mvn -version
python3 --version
VérificationBonne réponse
node -vv22.13.0 ou plus
pnpm -v9.0.0 ou plus
rustc --versionrustc 1.88.0 ou plus
java -version21 ou plus
mvn -versionApache Maven 3. et une version
python3 --versionPython 3.10.0 ou plus

Obtenir un portefeuille testnet​

Il vous faut un endroit où garder du QOR de test. Certains tutoriels créent pour vous un compte jetable dans un fichier. D'autres utilisent le portefeuille QoreX, le portefeuille officiel de QoreChain, basculé sur le testnet. Le tableau de la section De quels outils chaque tutoriel a-t-il besoin ? indique lequel.

QoreX sur le testnet​

  1. Installez QoreX depuis la fiche officielle : App Store pour iPhone, Google Play pour Android, Chrome Web Store pour Chrome, Brave, Edge, Arc et Opera, ou Firefox Add-ons. La liste complète se trouve dans la vue d'ensemble de QoreX.
  2. Créez un nouveau portefeuille et notez la phrase de récupération sur papier. N'importez pas une phrase qui protège de vrais fonds.
  3. Basculez le portefeuille sur le testnet :
    • Application mobile : ouvrez Réglages, puis activez Use testnet (developers).
    • Extension de navigateur : déverrouillez-la, puis touchez 7 fois le numéro de version en bas. Une option développeur apparaît. Choisissez Switch to testnet (diana).
  4. Vérifiez que le badge testnet s'affiche. Le testnet s'appelle qorechain-diana.

Ce que vous devez voir : un badge testnet dans le portefeuille, et une adresse qor1... sur l'écran d'accueil. Les soldes du testnet n'affichent aucune valeur en dollars, et c'est normal.

Ajouter un compte Ethereum (coin 60)​

Le tutoriel Guestbook utilise la voie EVM, le portefeuille a donc besoin d'un compte de type Ethereum.

  1. Dans QoreX, ouvrez la liste des comptes et choisissez Add an Ethereum account (coin 60).
  2. Créez-en un nouveau. Ne restaurez pas une phrase qui protège de vrais fonds.
  3. Sélectionnez ce compte. Il affiche une adresse 0x....

Ce que vous devez voir : un compte intitulé Ethereum, coin 60, avec une adresse qui commence par 0x. Le même compte a aussi une adresse qor1....

Pour en savoir plus sur les comptes : Compte et Dashboard QoreX et Prise en main de QoreX.

Obtenir du QOR de test auprès du faucet​

Le faucet donne du QOR de test gratuit à une adresse testnet. Un nouveau compte doit en recevoir avant de pouvoir faire quoi que ce soit, car chaque transaction paie de petits frais de réseau.

  1. Ouvrez dashboard.qorechain.io/faucet dans votre navigateur.
  2. Connectez-vous au Dashboard QoreChain.
  3. Collez votre adresse qor1... dans le champ d'adresse.
  4. Sélectionnez Request Tokens.
  5. Attendez l'affichage de Tokens Sent!.

Ce que vous devez voir : la carte Tokens Sent! avec 100 QOR, et un lien View on Explorer.

Le faucet verse 100 QOR une fois toutes les 24 heures par compte et par adresse. Si vous redemandez trop tôt, il affiche Rate Limit Reached. Attendez la fin des 24 heures. Une seule demande suffit pour tous les tutoriels de cette page.

Votre première transaction enregistre votre clé post-quantique​

Chaque compte QoreChain a deux clés : une clé classique et une clé post-quantique ML-DSA-87. La toute première transaction d'un nouveau compte enregistre la clé ML-DSA-87 sur la chaîne. Cela n'arrive qu'une seule fois par compte et coûte environ 0,09 QOR. Ensuite, chaque transaction est signée avec les deux clés.

Pour voir comment la clé est créée et liée à votre compte, lisez Comment votre clé post-quantique est liée à votre compte.

Les tutoriels exécutent cette étape pour vous avec une commande nommée register. Vous n'avez rien à faire maintenant. Les 100 QOR du faucet la couvrent largement.

QOR et uqor​

Vous verrez deux noms pour la même pièce. Le QOR est la pièce entière. L'uqor est le plus petit morceau.

1 QOR = 1 000 000 uqor.

Vous voyezCela signifie
1 QOR1 000 000 uqor
0.1 QOR100 000 uqor
0.09 QOR90 000 uqor
0.15uqorUn prix de 0,15 uqor par unité de gas, utilisé quand vous payez des frais

Les portefeuilles et la plupart des commandes utilisent le QOR. La chaîne, elle, compte en uqor. Un mémo est un court texte que vous joignez à une transaction, comme Hello from the workshop. Tout le monde peut le lire sur la chaîne : ne mettez donc jamais de secret dans un mémo.

Le gas mesure le travail qu'une transaction demande au réseau. Les frais sont le gas utilisé multiplié par le prix du gas. Les outils de cette section estiment le gas pour vous, vous n'avez donc rien à calculer.

Protéger vos clés jetables​

Un tutoriel crée un secret pour votre compte testnet et le stocke sur votre ordinateur. Traitez-le avec soin, même si le QOR de test ne vaut rien, pour prendre l'habitude avant le mainnet.

  1. Où il se trouve. Dans les tutoriels TypeScript, les secrets vont dans un fichier nommé .env dans le dossier du projet. Les applications Rust, Java et Python écrivent un fichier de clé avec la commande new, dans un dossier caché nommé .config/qday à l'intérieur de votre dossier personnel. Le tutoriel nomme le fichier exact.
  2. Ne le partagez jamais. Ne le collez pas dans un chat, un e-mail, une capture d'écran ou une vidéo. Masquez le fichier quand vous partagez votre écran.
  3. Ne le versionnez jamais. N'ajoutez pas .env ni un fichier de clé à Git, et ne les poussez jamais sur GitHub. Ajoutez .env à .gitignore si un projet ne l'ignore pas déjà.
  4. Testnet uniquement. Ne réutilisez jamais une clé, une phrase de récupération ou un code de récupération du testnet sur le mainnet.
  5. Supprimez-le à la fin. Quand vous avez terminé un tutoriel, supprimez le fichier de clé ou .env. Vous pouvez toujours créer un nouveau compte en une minute.
Fonds réels

Ne mettez jamais la clé, le mnémonique (phrase de récupération) ou le code de récupération d'un compte qui détient de vrais fonds dans un fichier .env, un fichier de clé ou une commande de cette section.

Le réseau et les points de terminaison publics​

ServiceValeur
Nom du testnetqorechain-diana
ID de chaîne EVM9800
REST (lire des données via le web)https://api-testnet.qore.host
RPChttps://rpc-testnet.qore.host
JSON-RPC EVMhttps://evm-testnet.qore.host
Explorateurexplore.qore.network, puis passez sur Testnet
Faucetdashboard.qorechain.io/faucet

Dépannage​

Ce que vous voyezPourquoiQue faire
pnpm: command not foundpnpm n'est pas installé. Node.js ne l'inclut pas, y compris quand il est installé avec Homebrew.Lancez npm install -g pnpm, ouvrez un nouveau terminal et lancez pnpm -v.
node: command not found, ou une ancienne version après l'installationLe terminal était ouvert pendant l'installation, ou l'ancienne version passe en premier.Fermez le terminal, ouvrez-en un nouveau, lancez node -v. Sous Linux, utilisez la ligne NodeSource, et non le paquet apt par défaut.
ERROR: You are using Node.js ... which is not supported by HardhatNode.js est plus ancien que 22.13.Installez Node.js 22.13 ou plus récent, puis relancez pnpm install dans le projet.
EACCES ou permission refusée pendant npm install -g pnpmVotre utilisateur ne peut pas écrire dans le dossier global.Lancez sudo npm install -g pnpm sur macOS et Linux.
rustc: command not found après l'installation de RustLe terminal ne connaît pas encore le nouveau PATH.Ouvrez un nouveau terminal. Si cela échoue encore, lancez source "$HOME/.cargo/env".
linker 'cc' not found ou link.exe not found lors de la compilation RustLes outils du compilateur C manquent.macOS : xcode-select --install. Linux : sudo apt install -y build-essential. Windows : installez les Visual Studio C++ Build Tools.
java -version affiche 17 ou moinsUne ancienne version de Java passe en premier.Installez Java 21, ouvrez un nouveau terminal, vérifiez de nouveau.
PowerShell indique que l'exécution de scripts est désactivée quand vous activez le venv PythonWindows bloque les scripts par défaut.Lancez Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, répondez Y, puis activez de nouveau.
Rate Limit Reached sur le faucetLe faucet paie une fois toutes les 24 heures par compte et par adresse.Attendez la fin des 24 heures. Une seule demande suffit pour tous les tutoriels.
Le portefeuille n'affiche pas de badge testnetLe portefeuille est encore sur le mainnet.Application mobile : Réglages, puis Use testnet (developers). Extension : touchez 7 fois le numéro de version, puis Switch to testnet (diana).
account has no PQC key and classical fallback is disabledLe nouveau compte n'a pas encore enregistré sa clé ML-DSA-87.Lancez d'abord l'étape register du tutoriel (c'est la première transaction du compte).
Erreurs CORS dans la console du navigateurLe point de terminaison REST public n'envoie pas d'en-têtes CORS, une page web ne peut donc pas l'appeler directement.Appelez le point de terminaison via le proxy /lcd du projet, comme le fait le modèle.

Étape suivante​

Choisissez un tutoriel dans la vue d'ensemble et suivez-le depuis la première commande.