Sari la conținutul principal

Înainte de a începe: instrumente și un portofel de testnet

Fiecare tutorial din această secțiune pornește de la un calculator pe care nu este instalat nimic. Această pagină este singurul loc unde pregătești totul. Fă-o o singură dată, apoi deschide orice tutorial. Fiecare tutorial trimite înapoi aici și repetă doar comenzile scurte de verificare de care are nevoie.

Cât durează: cam 20 până la 40 de minute prima dată, mai ales din cauza descărcărilor. Instalezi doar instrumentele pentru tutorialul pe care vrei să îl urmezi.

Doar un cont de testnet de unică folosință

Tot ce se întâmplă aici rulează pe testnet-ul QoreChain, unde QOR nu are nicio valoare. Nu folosi niciodată portofelul tău real, o frază de recuperare reală sau fonduri reale în vreun tutorial. Vei crea un cont nou, doar pentru acest exercițiu.

Ce instrumente are nevoie fiecare tutorial?​

Instalează doar rândurile de care ai nevoie. Git, un terminal și un browser web sunt necesare pentru toate.

TutorialLimbajInstrumente de instalatPortofel QoreX
Ghidul Workshop 1TypeScriptNode.js, pnpm, curl, jq (opțional)Nu este necesar
Q-Day CounterTypeScriptGit, Node.js, pnpmNu este necesar
Q-Day GuestbookTypeScriptGit, Node.js, pnpmNecesar, cu un cont Ethereum (coin 60)
Hybrid InspectorTypeScriptGit, Node.js, pnpmNecesar
Rust, qday-payRustGit, RustNu este necesar
Java, Tip JarJavaGit, Java 21, MavenNu este necesar
Python, AirdropPythonGit, Python 3.10 sau mai nouNu este necesar

Deschide un terminal​

Un terminal este o fereastră în care tastezi comenzi. Vei lipi în ea comenzile de pe aceste pagini, una câte una.

SistemCum îl deschizi
macOSApasă Command și Space, scrie Terminal, apasă Return.
WindowsDeschide meniul Start, scrie PowerShell, deschide Windows PowerShell. Pentru tutorialul Java ai nevoie și de Git Bash (vine cu Git, vezi mai jos) sau de WSL.
LinuxApasă Ctrl, Alt și T, sau caută Terminal în aplicații.

După ce instalezi un instrument, închide terminalul și deschide unul nou. Un terminal care era deschis în timpul instalării nu vede încă noul instrument.

Instalează instrumentele​

Pentru fiecare instrument primești comanda de instalare sau linkul de descărcare, apoi comanda de verificare. O comandă de verificare întreabă instrumentul ce versiune are. Dacă afișează un număr de versiune egal sau mai mare decât cel cerut, instrumentul funcționează.

Manageri de pachete (ajutoare opționale)​

Un manager de pachete instalează alte programe cu o singură comandă. Poți să descarci și fiecare instrument manual, de pe site-ul lui. Comenzile de mai jos folosesc ajutorul potrivit sistemului tău.

SistemAjutorCum îl obții
macOSHomebrewLipește această singură linie în terminal, apoi urmează ce afișează: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
WindowswingetEste deja inclus în Windows 10 și 11. Verifică cu winget --version.
LinuxaptEste deja inclus pe Ubuntu și Debian. Alte sisteme: folosește propriul manager de pachete (dnf, pacman).

Git​

Git descarcă codul de exemplu de pe GitHub.

SistemInstalare
macOSxcode-select --install (se deschide o fereastră, alege Install), sau brew install git
Windowswinget install --id Git.Git -e, sau descarcă de pe git-scm.com
Linuxsudo apt install -y git

Verifică:

git --version

Ar trebui să vezi o linie de forma git version 2.40.0. Orice versiune merge.

Node.js 22.13 sau mai nou​

Node.js rulează proiectele TypeScript. Hardhat 3, instrumentul pentru contracte folosit aici, refuză să pornească pe orice versiune de Node.js mai veche de 22.13.

SistemInstalare
macOSbrew install node, sau descarcă instalatorul LTS de pe nodejs.org
Windowswinget install --id OpenJS.NodeJS.LTS -e, sau descarcă instalatorul LTS de pe nodejs.org
Linux (Ubuntu, Debian)curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - apoi sudo apt install -y nodejs
Linux: nu folosi pachetul apt implicit

Pe Ubuntu și Debian, sudo apt install nodejs instalează o versiune veche, prea mică. Folosește linia NodeSource de mai sus.

Verifică:

node -v

Ar trebui să vezi v22.13.0 sau mai mare, de exemplu v22.20.0 sau v24.1.0. Dacă vezi un număr mai mic, instalează din nou și deschide un terminal nou.

pnpm 9 sau mai nou​

pnpm instalează bibliotecile de care are nevoie un proiect TypeScript. Face aceeași treabă ca npm, doar mai repede.

Instalează-l cu instrumentul de instalare al Node.js, npm, pe orice sistem:

npm install -g pnpm
ParteCe face
npm installDescarcă și instalează un program.
-gPrescurtare de la "global": îl instalează pentru tot calculatorul, nu pentru un singur folder.
pnpmProgramul de instalat.

Pe macOS și Linux, dacă se termină cu EACCES sau "permission denied", rulează din nou comanda ca sudo npm install -g pnpm.

Node.js instalat cu Homebrew nu include pnpm

Dacă un tutorial afișează pnpm: command not found (sau zsh: command not found: pnpm), înseamnă că nu ai instalat încă pnpm. Rulează npm install -g pnpm, deschide un terminal nou și încearcă din nou.

Verifică:

pnpm -v

Ar trebui să vezi 9.0.0 sau mai mare, de exemplu 10.4.1.

curl și jq (doar pentru ghidul Workshop 1)​

curl descarcă o adresă web din terminal. Îl folosești ca să citești tranzacția ta de la punctul final REST public. jq filtrează răspunsul lung, ca să vezi doar partea care te interesează. jq este opțional.

Sistemcurljq
macOSInclus.brew install jq
WindowsInclus în Windows 10 și 11 sub numele curl.exe.winget install --id jqlang.jq -e
Linuxsudo apt install -y curl dacă lipseștesudo apt install -y jq

Verifică-le:

curl --version
jq --version

Ar trebui să vezi câte o linie de versiune pentru fiecare, de exemplu jq-1.7.

Windows PowerShell: scrie curl.exe

În PowerShell, cuvântul scurt curl este o altă comandă încorporată. Scrie curl.exe în locul lui curl în fiecare comandă de pe aceste pagini. Dacă folosești Git Bash, curl simplu funcționează.

Rust 1.88 sau mai nou (doar pentru tutorialul Rust)​

Rust compilează aplicația în linie de comandă qday-pay. Îl instalezi cu rustup, instalatorul oficial Rust. Acesta instalează și cargo, instrumentul de compilare Rust.

SistemInstalare
macOScurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh (apasă Return ca să accepți valoarea implicită). Instrumentele de compilare vin cu xcode-select --install.
WindowsDescarcă și rulează rustup-init.exe de pe rustup.rs, sau winget install --id Rustlang.Rustup -e. Când cere Visual Studio C++ Build Tools, acceptă: Rust are nevoie de ele ca să compileze programe pe Windows.
Linuxsudo apt install -y build-essential curl apoi curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh (apasă Return ca să accepți valoarea implicită)

Verifică:

rustc --version
cargo --version

Ar trebui să vezi rustc 1.88.0 sau mai mare și o linie de versiune cargo. Dacă ai deja Rust, rustup update îl aduce la zi.

Java 21 și Maven (doar pentru tutorialul Java)​

Aplicația Tip Jar are nevoie de un JDK Java 21 sau mai nou (instrumentele pentru compilarea și rularea programelor Java) și de Maven, instrumentul de compilare care descarcă bibliotecile Java.

SistemInstalare
macOSbrew install --cask temurin@21 apoi brew install maven (sau folosește instalatorul de pe adoptium.net)
Windowswinget install --id EclipseAdoptium.Temurin.21.JDK -e, apoi descarcă Maven de pe maven.apache.org/download.cgi, dezarhiveaz-o și adaugă folderul ei bin în PATH. Varianta mai simplă: instalează WSL (vezi mai jos) și urmează linia pentru Linux.
Linuxsudo apt install -y openjdk-21-jdk maven

Verifică-le:

java -version
mvn -version

Ar trebui să vezi openjdk version "21 (sau un număr mai mare, cum ar fi 25) și Apache Maven 3. urmat de o versiune. Dacă java -version arată 17 sau mai puțin, instalează Java 21 și deschide un terminal nou.

Python 3.10 sau mai nou, cu venv (doar pentru tutorialul Python)​

Python rulează aplicația Airdrop. venv creează un folder privat pentru bibliotecile ei, astfel încât nimic altceva de pe calculator nu este atins.

SistemInstalare
macOSbrew install python, sau descarcă de pe python.org
Windowswinget install --id Python.Python.3.12 -e, sau descarcă de pe python.org și bifează Add python.exe to PATH în instalator
Linuxsudo apt install -y python3 python3-venv python3-pip

Verifică:

python3 --version

Ar trebui să vezi Python 3.10.0 sau mai mare. Pe Windows, scrie în schimb python --version (comanda este python, nu python3).

Windows și comenzile Linux: WSL​

Majoritatea comenzilor din tutoriale sunt aceleași pe orice sistem. Câteva folosesc funcții ale shell-ului Linux: source, chmod, ./tipjar și sleep. Pe Windows ai două variante:

  1. Windows nativ. Folosește PowerShell pentru tutorialele TypeScript, Rust și Python. Tutorialele dau varianta pentru Windows acolo unde diferă, de exemplu .venv\Scripts\activate. Pentru tutorialul Java, folosește Git Bash (instalat odată cu Git).
  2. WSL. Windows Subsystem for Linux îți oferă un Linux real în interiorul Windows. Deschide PowerShell ca administrator, rulează comanda de mai jos, repornește calculatorul, apoi urmează liniile pentru Linux de pe această pagină în fereastra Ubuntu.
wsl --install
ParteCe face
wslInstrumentul Windows Subsystem for Linux.
--installInstalează WSL și sistemul Linux Ubuntu dintr-o singură mișcare.

Verifică totul dintr-o dată​

Rulează comenzile pentru instrumentele pe care le-ai instalat. Fiecare trebuie să afișeze o versiune.

git --version
node -v
pnpm -v
rustc --version
java -version
mvn -version
python3 --version
VerificareRăspuns bun
node -vv22.13.0 sau mai mare
pnpm -v9.0.0 sau mai mare
rustc --versionrustc 1.88.0 sau mai mare
java -version21 sau mai mare
mvn -versionApache Maven 3. și o versiune
python3 --versionPython 3.10.0 sau mai mare

Obține un portofel de testnet​

Ai nevoie de un loc în care să ții QOR de test. Unele tutoriale creează pentru tine un cont de unică folosință, într-un fișier. Altele folosesc portofelul QoreX, portofelul oficial QoreChain, trecut pe testnet. Tabelul din Ce instrumente are nevoie fiecare tutorial? spune care este cazul.

QoreX pe testnet​

  1. Instalează QoreX din lista oficială: App Store pentru iPhone, Google Play pentru Android, Chrome Web Store pentru Chrome, Brave, Edge, Arc și Opera, sau Firefox Add-ons. Lista completă este în Prezentarea QoreX.
  2. Creează un portofel nou și salvează fraza de recuperare pe hârtie. Nu importa o frază care conține fonduri reale.
  3. Treci portofelul pe testnet:
    • Aplicația de telefon: deschide Settings, apoi activează Use testnet (developers).
    • Extensia de browser: deblochează-o, apoi atinge de 7 ori numărul versiunii din partea de jos. Apare o opțiune pentru dezvoltatori. Alege Switch to testnet (diana).
  4. Verifică dacă apare insigna de testnet. Testnet-ul se numește qorechain-diana.

Ce ar trebui să vezi: o insignă de testnet în portofel și o adresă qor1... pe ecranul principal. Soldurile de pe testnet nu arată nicio valoare în dolari, și este corect așa.

Adaugă un cont Ethereum (coin 60)​

Tutorialul Guestbook folosește lane-ul EVM, deci portofelul are nevoie de un cont de tip Ethereum.

  1. În QoreX, deschide lista de conturi și alege Add an Ethereum account (coin 60).
  2. Creează unul nou. Nu restaura o frază care conține fonduri reale.
  3. Selectează acel cont. Afișează o adresă 0x....

Ce ar trebui să vezi: un cont etichetat Ethereum, coin 60, cu o adresă care începe cu 0x. Același cont are și o adresă qor1....

Mai multe despre conturi: Contul QoreX și Dashboard și Primii pași cu QoreX.

Obține QOR de test de la faucet​

Faucet-ul oferă QOR de test gratuit unei adrese de testnet. Un cont nou trebuie să primească ceva înainte de a putea face orice, pentru că fiecare tranzacție plătește o mică taxă de rețea.

  1. Deschide dashboard.qorechain.io/faucet în browser.
  2. Autentifică-te în Dashboard-ul QoreChain.
  3. Lipește adresa ta qor1... în câmpul pentru adresă.
  4. Selectează Request Tokens.
  5. Așteaptă mesajul Tokens Sent!.

Ce ar trebui să vezi: cardul Tokens Sent! cu 100 QOR și un link View on Explorer.

Faucet-ul oferă 100 QOR o singură dată la 24 de ore, per cont și per adresă. Dacă ceri din nou prea devreme, afișează Rate Limit Reached. Așteaptă să treacă cele 24 de ore. O singură cerere este suficientă pentru toate tutorialele de pe această pagină.

Prima ta tranzacție înregistrează cheia ta post-cuantică​

Fiecare cont QoreChain are două chei: o cheie clasică și o cheie post-cuantică ML-DSA-87. Chiar prima tranzacție a unui cont nou înregistrează pe lanț cheia ML-DSA-87. Se face o singură dată, pentru fiecare cont, și costă cam 0.09 QOR. După aceea, fiecare tranzacție este semnată cu ambele chei.

Ca să vezi cum se face cheia și cum este legată de contul tău, citește Cum este legată cheia ta post-cuantică de contul tău.

Tutorialele rulează acest pas pentru tine, cu o comandă numită register. Acum nu trebuie să faci nimic. Cei 100 QOR de la faucet o acoperă de multe ori.

QOR și uqor​

Vei vedea două nume pentru aceeași monedă. QOR este moneda întreagă. uqor este cea mai mică bucată.

1 QOR = 1,000,000 uqor.

Ce veziCe înseamnă
1 QOR1,000,000 uqor
0.1 QOR100,000 uqor
0.09 QOR90,000 uqor
0.15uqorUn preț de 0.15 uqor pentru fiecare unitate de gaz, folosit când plătești o taxă

Portofelele și majoritatea comenzilor folosesc QOR. Lanțul în sine numără în uqor. Un memo este o scurtă bucată de text pe care o atașezi unei tranzacții, de exemplu Hello from the workshop. Oricine îl poate citi pe lanț, așa că nu pune niciodată un secret într-un memo.

Gazul măsoară cât de multă muncă cere o tranzacție rețelei. Taxa este gazul folosit înmulțit cu prețul gazului. Instrumentele din această secțiune estimează gazul pentru tine, deci nu calculezi nimic.

Păstrează în siguranță cheile tale de unică folosință​

Un tutorial creează un secret pentru contul tău de testnet și îl stochează pe calculatorul tău. Tratează-l cu grijă, chiar dacă QOR de test nu are valoare, ca să prinzi obiceiul înainte de mainnet.

  1. Unde se află. În tutorialele TypeScript, secretele ajung într-un fișier numit .env, în folderul proiectului. Aplicațiile Rust, Java și Python scriu un fișier de chei cu comanda new, într-un folder ascuns numit .config/qday, în folderul tău personal. Tutorialul indică fișierul exact.
  2. Nu îl da nimănui. Nu îl lipi într-un chat, într-un email, într-o captură de ecran sau într-un video. Ascunde fișierul când îți partajezi ecranul.
  3. Nu îl trimite în Git. Nu adăuga .env sau un fișier de chei în Git și nu le trimite niciodată pe GitHub. Adaugă .env în .gitignore dacă un proiect nu îl ignoră deja.
  4. Doar pe testnet. Nu refolosi niciodată o cheie de testnet, o frază de recuperare sau un cod de recuperare pe mainnet.
  5. Șterge-l când termini. După ce ai terminat un tutorial, șterge fișierul de chei sau .env. Poți oricând să faci un cont nou într-un minut.
Fonduri reale

Nu pune niciodată cheia, mnemonicul (fraza de recuperare) sau codul de recuperare al unui cont care deține fonduri reale într-un fișier .env, într-un fișier de chei sau în vreo comandă din această secțiune.

Rețeaua și punctele finale publice​

ServiciuValoare
Numele testnet-uluiqorechain-diana
EVM chain ID9800
REST (citești date prin web)https://api-testnet.qore.host
RPChttps://rpc-testnet.qore.host
EVM JSON-RPChttps://evm-testnet.qore.host
Explorerexplore.qore.network, apoi treci pe Testnet
Faucetdashboard.qorechain.io/faucet

Depanare​

Ce veziDe ceCe faci
pnpm: command not foundpnpm nu este instalat. Node.js nu îl include, nici când este instalat cu Homebrew.Rulează npm install -g pnpm, deschide un terminal nou și rulează pnpm -v.
node: command not found, sau o versiune veche după instalareTerminalul era deschis în timpul instalării, sau versiunea veche are prioritate.Închide terminalul, deschide unul nou, rulează node -v. Pe Linux folosește linia NodeSource, nu pachetul apt implicit.
ERROR: You are using Node.js ... which is not supported by HardhatNode.js este mai vechi de 22.13.Instalează Node.js 22.13 sau mai nou, apoi rulează din nou pnpm install în proiect.
EACCES sau permission denied în timpul npm install -g pnpmUtilizatorul tău nu poate scrie în folderul global.Rulează sudo npm install -g pnpm pe macOS și Linux.
rustc: command not found după instalarea RustTerminalul nu cunoaște încă noul PATH.Deschide un terminal nou. Dacă tot nu merge, rulează source "$HOME/.cargo/env".
linker 'cc' not found sau link.exe not found la compilarea RustLipsesc instrumentele compilatorului C.macOS: xcode-select --install. Linux: sudo apt install -y build-essential. Windows: instalează Visual Studio C++ Build Tools.
java -version arată 17 sau mai puținO versiune mai veche de Java are prioritate.Instalează Java 21, deschide un terminal nou, verifică din nou.
PowerShell spune că rularea scripturilor este dezactivată când activezi venv-ul PythonWindows blochează scripturile implicit.Rulează Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, răspunde Y, apoi activează din nou.
Rate Limit Reached la faucetFaucet-ul plătește o dată la 24 de ore, per cont și per adresă.Așteaptă să treacă cele 24 de ore. O singură cerere este suficientă pentru toate tutorialele.
Portofelul nu arată insigna de testnetPortofelul este încă pe mainnet.Aplicația de telefon: Settings, apoi Use testnet (developers). Extensia: atinge de 7 ori numărul versiunii, apoi Switch to testnet (diana).
account has no PQC key and classical fallback is disabledContul nou nu și-a înregistrat încă cheia ML-DSA-87.Rulează mai întâi pasul register al tutorialului (este prima tranzacție a contului).
Erori CORS în consola browseruluiPunctul final REST public nu trimite antete CORS, deci o pagină web nu îl poate apela direct.Apelează punctul final prin proxy-ul /lcd al proiectului, așa cum face șablonul.

Pasul următor​

Alege un tutorial din prezentare și urmează-l de la prima comandă.