Zum Hauptinhalt springen

Workshop 1: Ihre erste hybrid signierte Transaktion

Dieser Leitfaden führt Sie von einem Computer ohne installierte Werkzeuge bis zu einer Transaktion, die gleichzeitig mit zwei Schlüsseln signiert und vom QoreChain-Testnet verifiziert wird. Sie müssen kein Entwickler sein. Jeder Befehl wird in einfachen Worten erklärt, und jeder Schritt endet damit, was Sie auf Ihrem Bildschirm sehen sollten.

Wie lange das dauert: beim ersten Mal etwa 30 Minuten, einschließlich der Installation der Werkzeuge. Etwa 10 Minuten, wenn die Werkzeuge schon installiert sind.

Was wir bauen​

Ein vollständiges Solidity-Projekt (ein kleiner Smart Contract), das mit einem einzigen Befehl erzeugt, getestet und im QoreChain-Testnet bereitgestellt wird. Danach folgt eine Transaktion, die gleichzeitig mit zwei Schlüsseln signiert und von der Chain geprüft wird.

Was es zeigt:

  • Hybride Signierung. Die Transaktion trägt eine klassische secp256k1-Signatur und eine Post-Quanten-Signatur mit ML-DSA-87 (NIST FIPS 204). Beide müssen gültig sein.
  • Eine hybrid signierte Transaktion, auf der Chain verifiziert. Die Validatoren prüfen beide Signaturen. Den Beleg lesen Sie am öffentlichen REST-Endpunkt (die Erweiterung PQCHybridSignature und das Ereignis pqc_hybrid_verify) und im Explorer.
  • Das EVM-Autorisierungsfenster. Eine Ethereum-Transaktion kann keine Post-Quanten-Signatur tragen. Deshalb registrieren Sie auf QoreChain einmalig Ihren ML-DSA-87-Schlüssel und öffnen mit einer hybrid signierten Nachricht ein kurzes Fenster, in dem Ihre normalen EVM-Transaktionen zugelassen werden. Die Idee im Detail finden Sie unter Deploy in 5 Minutes.

Genau das verlangt die Stufe Quantum Pass.

Begriffe in diesem Leitfaden​

BegriffEinfache Bedeutung
TerminalDas Fenster, in dem Sie Befehle eingeben. Terminal unter macOS und Linux, PowerShell unter Windows
TestnetEine Übungskopie von QoreChain. Ihre Coins haben keinen Wert
QOR und uqorQOR ist der Coin. uqor ist seine kleinste Einheit. 1 QOR = 1.000.000 uqor
TransaktionEine signierte Anweisung, die an die Chain gesendet wird
MemoEin kurzer Text, der an eine Transaktion angehängt wird
Privater SchlüsselEin Geheimnis, das für Ihr Konto signiert. Wer es besitzt, kontrolliert das Konto
WiederherstellungscodeEin zweites Geheimnis (beginnt mit QRC1), aus dem Ihr Post-Quanten-Schlüssel erzeugt wird
HashDie eindeutige ID einer Transaktion. Damit schlagen Sie die Transaktion nach
Gas und GebührDer kleine Preis in QOR, den die Chain für die Verarbeitung einer Transaktion verlangt
Nur ein Wegwerf-Konto im Testnet

Verwenden Sie einen Schlüssel, der nur für diese Übung erzeugt wurde und nur Test-QOR enthält. Verwenden Sie niemals eine echte Wallet oder echtes Geld. Tragen Sie niemals den Schlüssel oder Wiederherstellungscode eines Kontos mit echtem Geld in die Datei .env ein, und geben Sie .env niemals weiter und committen Sie sie nicht.

Bevor Sie beginnen​

Sie brauchen einen Computer mit macOS, Windows oder Linux, ein Terminal und einen Webbrowser. Für dieses Tutorial installieren Sie zwei Werkzeuge: Node.js 22 oder neuer (Hardhat 3, das hier verwendete Projektwerkzeug, braucht Version 22) und pnpm (das Werkzeug, das die Bibliotheken des Projekts herunterlädt). Ein optionales Werkzeug, jq, macht nur die Ausgabe einer Verifizierung leichter lesbar.

Öffnen Sie zuerst ein Terminal. Unter macOS öffnen Sie Terminal. Unter Windows öffnen Sie PowerShell. Unter Linux öffnen Sie Ihre Terminal-App.

Node.js 22 oder neuer​

  1. Prüfen Sie, ob Sie es schon haben:
node -v

Es muss v22 oder eine höhere Zahl ausgeben. Wenn command not found oder eine ältere Version erscheint, installieren Sie Node.js wie unten beschrieben.

  1. Installieren Sie es für Ihr System:
SystemSo installieren Sie es
macOSLaden Sie den Installer von nodejs.org/en/download herunter, oder führen Sie brew install node@22 aus, wenn Sie Homebrew verwenden
WindowsFühren Sie winget install OpenJS.NodeJS.LTS in PowerShell aus, oder laden Sie den Installer von nodejs.org/en/download herunter
LinuxFühren Sie curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash aus, schließen Sie das Terminal und öffnen Sie es neu, und führen Sie dann nvm install 22 aus
  1. Schließen Sie das Terminal, öffnen Sie ein neues und führen Sie node -v erneut aus.

Was Sie sehen sollten: eine Zahl, die mit v22 oder höher beginnt, zum Beispiel v22.12.0.

pnpm​

  1. Prüfen Sie, ob Sie es schon haben:
pnpm -v
  1. Wenn command not found (oder pnpm: command not found) erscheint, installieren Sie es:
npm install -g pnpm
TeilBedeutung
npmDas Paketwerkzeug, das mit Node.js mitgeliefert wird
installEin Programm herunterladen und installieren
-gGlobal: für Ihren ganzen Computer installieren, nicht nur für einen Ordner
pnpmDas Programm, das installiert werden soll

Mit Homebrew installiertes Node.js enthält pnpm nicht. Deshalb ist pnpm: command not found unter macOS häufig: Der obige Befehl behebt es. Wenn Sie unter Linux oder macOS einen Berechtigungsfehler sehen, führen Sie stattdessen corepack enable aus und danach erneut pnpm -v.

  1. Prüfen Sie noch einmal mit pnpm -v.

Was Sie sehen sollten: eine Versionsnummer, zum Beispiel 9.12.0 oder höher.

jq (optional)​

jq gibt eine lange Antwort in kurzer, lesbarer Form aus. Es wird nur einmal verwendet, in Schritt 8.

SystemInstallationPrüfung
macOSbrew install jqjq --version
Windowswinget install jqlang.jqjq --version
Linuxsudo apt install jq (Debian und Ubuntu)jq --version

curl, das in Schritt 8 verwendet wird, ist unter macOS, Linux und Windows 10 oder neuer bereits vorhanden. Geben Sie in Windows PowerShell curl.exe statt curl ein.

Ihre Testnet-Wallet und der Faucet​

Das Projekt erzeugt in Schritt 3 sein eigenes Wegwerf-Konto, Sie brauchen also keine Wallet, um diesen Leitfaden abzuschließen. Sie brauchen aber Test-QOR auf diesem Konto, und Sie können außerdem die QoreX-Wallet im Testnet einrichten, um sie mit den Beispiel-Apps zu verwenden.

QoreX im Testnet (hier optional, für die Browser-Beispiel-Apps nötig):

  1. In der QoreX-App: Öffnen Sie Einstellungen und aktivieren Sie Use testnet (developers).
  2. In der QoreX-Browser-Erweiterung: Entsperren Sie sie, tippen Sie 7 Mal auf die Versionsnummer ganz unten und wählen Sie dann Switch to testnet (diana).
  3. Für alles auf der Ethereum-Seite (EVM) wählen Sie zusätzlich Add an Ethereum account (coin 60). Damit erhalten Sie ein Konto mit einer 0x...-Adresse, das mit Ethereum-Werkzeugen funktioniert.

Der Faucet ist ein kostenloser Automat, der Test-QOR ausgibt. Sie verwenden ihn in Schritt 4:

  • Adresse: dashboard.qorechain.io/faucet. Sie melden sich zuerst an.
  • Menge: 100 QOR, einmal alle 24 Stunden pro Konto.
  • Die allererste Transaktion eines neuen Kontos registriert dessen Post-Quanten-Schlüssel ML-DSA-87. Das kostet einmalig eine Gebühr von etwa 0,09 QOR, 100 QOR reichen also mehr als aus.

Die in diesem Leitfaden verwendeten Netzwerkdaten:

DienstURL
Testnetqorechain-diana, EVM-Chain-ID 9800
RPChttps://rpc-testnet.qore.host
RESThttps://api-testnet.qore.host
EVM JSON-RPChttps://evm-testnet.qore.host
Explorerhttps://explore.qore.network (auf Testnet umschalten)
Faucethttps://dashboard.qorechain.io/faucet (Anmeldung erforderlich)

Schritte​

Schritt 1: Werkzeuge prüfen​

Wie lange das dauert: 1 Minute.

node -v
TeilBedeutung
nodeDas Programm Node.js
-vDie Version ausgeben und beenden
pnpm -v
TeilBedeutung
pnpmDas Paketwerkzeug
-vDie Version ausgeben und beenden

Was Sie sehen sollten: v22 oder höher bei Node.js und eine Versionsnummer bei pnpm. Wenn nicht, gehen Sie zurück zu „Bevor Sie beginnen“.

Schritt 2: Projekt erzeugen und Tests ausführen​

Wie lange das dauert: etwa 1 Minute. Sie brauchen Internetzugang.

  1. Erzeugen Sie das Projekt in einem neuen Ordner. Wechseln Sie in Ihrem Terminal in einen Ordner, in dem Sie Projekte ablegen (zum Beispiel Ihren Ordner „Dokumente“), und führen Sie dann aus:
npx create-qorechain-dapp@latest qday-demo -t hardhat --network testnet --package-manager pnpm

Was es tut: lädt den QoreChain-Projektersteller herunter und baut ein fertiges Projekt namens qday-demo in einem neuen Ordner.

Parameter:

  • npx: führt ein Programm aus dem Internet aus, ohne es dauerhaft zu installieren.
  • create-qorechain-dapp@latest: der QoreChain-Projektersteller. @latest bedeutet, die neueste Version zu verwenden (dieser Leitfaden wurde mit 0.14.0 geprüft).
  • qday-demo: der Name des neuen Ordners und Projekts. Sie können einen anderen Namen wählen.
  • -t hardhat: -t steht für Vorlage (template). Damit wählen Sie die Hardhat-Vorlage: ein Solidity-Contract-Projekt mit Tests.
  • --network testnet: mit welchem QoreChain-Netzwerk das Projekt spricht. testnet ist das Übungsnetzwerk.
  • --package-manager pnpm: welches Werkzeug die vom Projekt benötigten Bibliotheken installiert.

Was Sie sehen sollten: eine Liste installierter Pakete und dann Done! Created qday-demo. Wenn nachgefragt wird, ob create-qorechain-dapp installiert werden soll, antworten Sie mit y.

  1. Wechseln Sie in den Projektordner:
cd qday-demo

Was es tut: setzt Ihr Terminal in den neuen Ordner. Alle folgenden Befehle laufen von hier aus.

Parameter:

  • cd: Verzeichnis wechseln (change directory).
  • qday-demo: der Ordner, in den Sie wechseln.
  1. Führen Sie die Tests aus:
pnpm test

Was es tut: kompiliert den Contract und prüft, ob er funktioniert, auf einer kleinen simulierten Chain in Ihrem Computer. Es sendet nichts an das echte Testnet.

Parameter:

  • pnpm: das Paketwerkzeug.
  • test: der Name des auszuführenden Skripts (aufgelistet in package.json; es führt hardhat test aus).

Was Sie sehen sollten:

Counter
✔ starts at the constructor value
✔ increments and emits CountChanged

2 passing (2 nodejs)
  1. Sehen Sie sich an, was Sie bekommen haben (optional):
DateiWas sie ist
contracts/Counter.solDer Smart Contract: Er speichert eine Zahl und kann 1 addieren
ignition/modules/Counter.tsDas Rezept, das den Contract bereitstellt
scripts/window.tsDer Helfer hinter pnpm window: Ihren Schlüssel registrieren und das Autorisierungsfenster öffnen
hardhat.config.tsEinstellungen, einschließlich des Netzwerks qorechainTestnet (Chain-ID 9800)
.envIhre geheime Einstellungsdatei. Sie füllen sie in Schritt 3 aus. Geben Sie sie niemals weiter

Mehr zu den Vorlagen: Scaffolder und CLI und Chain Developer Kit.

Schritt 3: Ein Wegwerf-Konto im Testnet erstellen​

Wie lange das dauert: 3 Minuten.

Das Konto braucht zwei Geheimnisse: einen privaten Schlüssel im Ethereum-Stil und einen Wiederherstellungscode (beginnt mit QRC1), aus dem der Post-Quanten-Schlüssel ML-DSA-87 erzeugt wird. Beide kommen in die Datei .env in Ihrem Projektordner. Die Datei bleibt privat auf Ihrem Computer.

  1. Erzeugen Sie einen neuen privaten Schlüssel. Legen Sie dazu zuerst im Ordner qday-demo eine kleine Datei namens make-key.mjs mit diesem Inhalt an (verwenden Sie einen beliebigen Texteditor, zum Beispiel Notepad, TextEdit im Nur-Text-Modus oder nano):
import { generatePrivateKey } from "viem/accounts";
import { readFileSync, writeFileSync } from "node:fs";

const env = readFileSync(".env", "utf8");
writeFileSync(".env", env.replace(/^PRIVATE_KEY=.*$/m, `PRIVATE_KEY=${generatePrivateKey()}`));
console.log("New private key saved in .env");

Was diese Datei tut: erzeugt einen zufälligen privaten Schlüssel und schreibt ihn in Ihre Datei .env, sodass er nie auf dem Bildschirm angezeigt oder von Hand kopiert wird.

  1. Führen Sie sie aus:
node make-key.mjs

Was es tut: führt die kleine Datei mit Node.js aus.

Parameter:

  • node: das Programm Node.js.
  • make-key.mjs: die Datei, die ausgeführt wird.

Was Sie sehen sollten: New private key saved in .env. Führen Sie es nur einmal aus: Ein zweiter Lauf erzeugt ein anderes Konto.

  1. Erzeugen Sie einen Wiederherstellungscode:
pnpm window recovery-code

Was es tut: erstellt einen neuen Wiederherstellungscode und gibt ihn aus.

Parameter:

  • pnpm window: startet den Fenster-Helfer des Projekts (scripts/window.ts).
  • recovery-code: die Aktion: einen neuen Wiederherstellungscode ausgeben.

Was Sie sehen sollten: eine lange Zeile, die mit QRC1 beginnt, und danach einen Hinweis zur Aufbewahrung. Kopieren Sie die ganze QRC1...-Zeile.

  1. Tragen Sie den Code in .env ein. Öffnen Sie die Datei in einem Editor:
SystemBefehl
macOSopen -e .env
Windowsnotepad .env
Linuxnano .env

Suchen Sie die Zeile QORE_PQC_RECOVERY_CODE= und fügen Sie den Code direkt hinter dem Gleichheitszeichen ein, ohne Leerzeichen und ohne Anführungszeichen. Speichern Sie die Datei. Das Ergebnis sieht so aus (Platzhalter gezeigt, Ihre sind echt):

PRIVATE_KEY=0x...
QORE_PQC_RECOVERY_CODE=QRC1...
QORE_NETWORK=testnet

Was jede Zeile bedeutet:

  • PRIVATE_KEY: das Geheimnis, das für die klassische Hälfte (secp256k1) Ihres Kontos signiert.
  • QORE_PQC_RECOVERY_CODE: das Geheimnis, aus dem die Post-Quanten-Hälfte (ML-DSA-87) erzeugt wird.
  • QORE_NETWORK: mit welchem Netzwerk der Helfer spricht. testnet ist das Übungsnetzwerk.

Lassen Sie .env genau so, wie sie ist. Derselbe Schlüssel und derselbe Code ergeben jedes Mal dasselbe Konto. Wenn Sie die Datei verlieren, beginnen Sie mit einem neuen Konto von vorn. Geben Sie sie niemals weiter und committen Sie sie niemals in Git.

Möchten Sie lieber eine Mnemonic (zwölf Wörter) verwenden? Tragen Sie dann statt des Schlüssels und des Codes QORE_MNEMONIC="your twelve words" in .env ein. Beide Schlüssel entstehen aus derselben Phrase, und ein Wiederherstellungscode ist nicht nötig. Verwenden Sie eine Phrase, die nur für diese Übung erzeugt wurde.

  1. Fragen Sie das Projekt nach der Adresse Ihres neuen Kontos:
pnpm window status

Was es tut: liest die öffentliche Chain und zeigt Ihr Konto, Ihren Post-Quanten-Schlüssel und Ihr Fenster an. Es ändert nichts.

Parameter:

  • pnpm window: startet den Fenster-Helfer.
  • status: die Aktion: den aktuellen Zustand anzeigen.

Was Sie sehen sollten: drei Zeilen (bei Ihnen mit echten Adressen):

account: 0x... (qor1...)
PQC key: not registered (run: pnpm window register)
window: none (run: pnpm window open)

Kopieren Sie die Adresse qor1.... Diese geben Sie dem Faucet. Beide Adressen gehören zum selben Konto: 0x... ist die Ethereum-Form und qor1... die QoreChain-Form.

Schritt 4: Test-QOR vom Faucet holen​

Wie lange das dauert: 2 Minuten.

  1. Öffnen Sie den Faucet in Ihrem Browser und melden Sie sich an.
  2. Stellen Sie sicher, dass das Dashboard auf Testnet steht.
  3. Fügen Sie Ihre Adresse qor1... ein.
  4. Wählen Sie Request Tokens.

Was Sie sehen sollten: eine Karte mit Tokens Sent! und 100 QOR (plus einigen Fest-Testtoken) sowie einen Link View on Explorer.

Der Faucet zahlt einmal alle 24 Stunden pro Konto aus. Die genauen Mengen stehen unter Faucet. Prüfen Sie nun von Ihrem Terminal aus:

pnpm window status

Was Sie sehen sollten: dieselben drei Zeilen wie zuvor. Ihr Konto existiert jetzt auf der Chain und kann Gebühren zahlen. Es steht weiterhin dort, dass der Schlüssel nicht registriert ist. Das kommt als Nächstes.

Schritt 5: Schlüssel registrieren und das Fenster öffnen​

Wie lange das dauert: etwa 2 Minuten.

  1. Registrieren Sie Ihren ML-DSA-87-Schlüssel. Das ist ein einmaliger Schritt pro Konto:
pnpm window register

Was das Registrieren genau bewirkt, lesen Sie unter Wie Ihr Post-Quanten-Schlüssel an Ihr Konto gebunden wird.

Was es tut: sendet eine Transaktion, die der Chain mitteilt, welcher Post-Quanten-Schlüssel zu Ihrem Konto gehört. Sie kostet einmalig eine Gebühr von etwa 0,09 QOR. Die Chain akzeptiert diese eine Nachricht nur mit dem klassischen Schlüssel signiert, weil noch kein Post-Quanten-Schlüssel hinterlegt ist.

Parameter:

  • pnpm window: startet den Fenster-Helfer.
  • register: die Aktion: den Schlüssel registrieren.

Was Sie sehen sollten: registered: <HASH>. Wenn dort The account already has a PQC key; nothing to do. steht, ist das in Ordnung: Machen Sie weiter.

  1. Öffnen Sie das Autorisierungsfenster:
pnpm window open

Was es tut: sendet eine hybrid signierte Transaktion (beide Schlüssel), die ein kurzes Fenster öffnet, in dem Ihre normalen Transaktionen im Ethereum-Stil, etwa ein Contract-Deploy, zugelassen werden.

Parameter:

  • pnpm window: startet den Fenster-Helfer.
  • open: die Aktion: ein Fenster öffnen. Standardmäßig dauert es 600 Blöcke und erlaubt 5 Transaktionen. Das können Sie mit QORE_WINDOW_BLOCKS und QORE_WINDOW_TXS in .env ändern.

Was Sie sehen sollten: opened: <HASH>, dann eine Zeile wie window: 600 blocks, 5 txs, 3750000 uqor (value plus fees). Die letzte Zahl ist die Ausgabengrenze des Fensters in uqor (3,75 QOR). Notieren Sie sich den Hash bei opened:: Sie verifizieren ihn in Schritt 8.

  1. Warten Sie etwa 10 Sekunden. Das Öffnen des Fensters hat den Zähler Ihres Kontos (die Nonce) erhöht, und Hardhat wartet, bis sich die Chain beruhigt hat.

Schritt 6: Den Contract bauen​

Wie lange das dauert: ein paar Sekunden.

pnpm build

Was es tut: wandelt den Solidity-Contract in die Form um, die die Chain ausführt.

Parameter:

  • pnpm: das Paketwerkzeug.
  • build: das auszuführende Skript (es führt hardhat build aus).

Was Sie sehen sollten: Compiled 1 Solidity file oder No contracts to compile. Beides ist in Ordnung: Der Test in Schritt 2 hat ihn bereits kompiliert.

Schritt 7: Den Contract im Testnet bereitstellen​

Wie lange das dauert: etwa 30 Sekunden.

pnpm deploy:testnet

Was es tut: sendet den Contract mit Hardhat Ignition an das QoreChain-Testnet und nutzt dabei das Fenster, das Sie geöffnet haben. Das ist eine normale EVM-Transaktion.

Parameter:

  • pnpm: das Paketwerkzeug.
  • deploy:testnet: das auszuführende Skript. Es führt hardhat ignition deploy ignition/modules/Counter.ts --network qorechainTestnet aus: das Rezept Counter.ts im Netzwerk namens qorechainTestnet (Chain-ID 9800) bereitstellen.

Wenn Hardhat Confirm deploy to network qorechainTestnet (9800)? fragt, geben Sie y ein und drücken Sie die Eingabetaste.

Was Sie sehen sollten: [ CounterModule ] successfully deployed und eine Zeile CounterModule#Counter - 0x.... Die 0x... ist die Adresse Ihres Contracts. Wenn Sie HHE10402 sehen, führen Sie denselben Befehl noch einmal aus (siehe Fehlerbehebung).

Schritt 8: Die hybride Signatur auf der Chain verifizieren​

Wie lange das dauert: 3 Minuten.

Die Transaktion opened: aus Schritt 5 wurde mit beiden Schlüsseln signiert. Jeder kann sie am öffentlichen REST-Endpunkt prüfen.

  1. Ersetzen Sie <HASH> durch diesen Hash (ohne < und >) und führen Sie aus:
curl -s https://api-testnet.qore.host/cosmos/tx/v1beta1/txs/<HASH>

Was es tut: fragt den öffentlichen Testnet-Server nach dem vollständigen Datensatz Ihrer Transaktion.

Parameter:

  • curl: ein Programm, das eine Webadresse abruft.
  • -s: still (silent), es blendet die Fortschrittsanzeige aus und zeigt nur die Antwort.
  • https://api-testnet.qore.host/cosmos/tx/v1beta1/txs/<HASH>: die REST-Adresse des Testnets, gefolgt von Ihrem Transaktions-Hash.

Was Sie sehen sollten: einen langen Textblock. Achten Sie auf drei Dinge:

  1. "code": 0 innerhalb von tx_response. Code 0 bedeutet Erfolg.

  2. Die Erweiterung PQCHybridSignature, die die ML-DSA-87-Signatur enthält: 4.627 Bytes, neben der 64 Byte langen secp256k1-Signatur.

  3. In events ein Ereignis vom Typ pqc_hybrid_verify mit dem Attribut status auf verified.

  4. Um nur dieses Ereignis auszugeben (braucht jq):

curl -s https://api-testnet.qore.host/cosmos/tx/v1beta1/txs/<HASH> | jq '.tx_response.events[] | select(.type=="pqc_hybrid_verify")'

Was es tut: ruft denselben Datensatz ab und leitet ihn durch jq, das nur das Verifizierungsereignis behält.

Parameter:

  • |: leitet die Ausgabe des ersten Befehls an den zweiten weiter.
  • jq: das Filterprogramm.
  • '.tx_response.events[] | select(.type=="pqc_hybrid_verify")': geht die Liste der Ereignisse durch und behält diejenigen, deren Typ pqc_hybrid_verify ist.

Was Sie sehen sollten: einen kleinen Textblock mit "status" auf "verified".

  1. Sehen Sie es sich im Explorer an:
    1. Öffnen Sie explore.qore.network.
    2. Schalten Sie die Netzwerkauswahl auf Testnet.
    3. Suchen Sie nach dem Hash.

Was Sie sehen sollten: Die Transaktionsseite zeigt die Signatursicherheit als quantensicher, auf der Chain verifiziert, mit dem Algorithmus ML-DSA-87 (FIPS 204).

Das ist der Beweis: Die Validatoren haben beide Signaturen geprüft. Das ist Ihre Quantum-Pass-Transaktion.

Was Sie sehen sollten, im Überblick​

WoWas
Nach Schritt 2Done! Created qday-demo und 2 passing
Nach Schritt 3Eine Adresse qor1... und eine Adresse 0x... aus pnpm window status, mit nicht registriertem Schlüssel
Nach Schritt 4Tokens Sent! auf dem Faucet
Nach Schritt 5registered: <HASH>, dann opened: <HASH> und die Fensterzeile
Nach Schritt 7CounterModule#Counter - 0x...
Nach Schritt 8code 0, eine 4.627 Byte lange ML-DSA-87-Signatur und pqc_hybrid_verify mit status verified, in der REST-Ausgabe und im Explorer im Testnet

Verwendete Pakete​

Deklariert in der erzeugten package.json:

PaketRegistryVersion
create-qorechain-dappnpm0.14.0
@qorechain/sdknpm^0.14.0
@qorechain/evmnpm^0.14.0
@cosmjs/stargatenpm^0.39.0
hardhatnpm^3.21.1
viemnpm^2.47.6
tsxnpm^4.19.0
typescriptnpm^5.6.3

Der Scaffolder installiert außerdem die Hardhat-Toolbox sowie die Ignition- und Keystore-Plugins, die in der erzeugten package.json aufgeführt sind.

Fehlerbehebung​

Was Sie sehenWarumWas zu tun ist
HHE10402 oder „wait for confirmations“ direkt nach dem Öffnen des FenstersDas Öffnen des Fensters hat die Nonce des Kontos erhöhtFühren Sie pnpm deploy:testnet noch einmal aus
„EVM authorisation window exhausted“ oder „no window“Dem Fenster sind die Transaktionen oder Blöcke ausgegangen, oder es gilt für einen anderen Contract (ein Fenster, das auf einen anderen Contract begrenzt ist, blockiert ein Deploy)Führen Sie pnpm window open aus, um ein neues Fenster zu öffnen, warten Sie etwa 10 Sekunden und stellen Sie dann erneut bereit
„account has no PQC key and classical fallback is disabled“Das Konto hat noch keinen ML-DSA-87-Schlüssel registriertFühren Sie zuerst pnpm window register aus und dann pnpm window open
„does not exist on chain yet“Das Konto hat noch kein QORHolen Sie QOR vom Faucet (Schritt 4)
„Rate Limit Reached“ auf dem Faucet, oder nach 30 Sekunden keine TokenEine Anforderung pro 24 Stunden pro Konto und pro Adresse, und Anfragen werden nacheinander bearbeitetWarten Sie ein paar Sekunden und versuchen Sie es erneut, oder warten Sie, bis die 24 Stunden vergangen sind. Nur eine Anfrage pro 24 Stunden
pnpm: command not foundpnpm ist nicht installiert. Mit Homebrew installiertes Node.js enthält es nichtFühren Sie npm install -g pnpm aus und öffnen Sie dann ein neues Terminal
pnpm window bricht mit einer Meldung über einen fehlenden Wiederherstellungscode ab.env hat PRIVATE_KEY ohne QORE_PQC_RECOVERY_CODEFühren Sie pnpm window recovery-code aus und fügen Sie den Code in .env ein (Schritt 3), oder verwenden Sie QORE_MNEMONIC
„QORE_PQC_RECOVERY_CODE is not a valid QRC1 recovery code“Ein Tippfehler, ein Leerzeichen oder ein Anführungszeichen beim EinfügenFügen Sie den Code noch einmal ohne Leerzeichen und Anführungszeichen ein
„registered, but NOT this key“ in pnpm window statusFür dieses Konto wurde früher ein anderer Wiederherstellungscode verwendetTragen Sie den ursprünglichen Wiederherstellungscode wieder in .env ein, oder beginnen Sie mit einem neuen Konto von vorn
CORS-Fehler in einer Browser-AppEin Browser blockiert Aufrufe an eine Chain-Adresse, die Ihre Seite nicht zulässtVerwenden Sie für REST-Aufrufe aus dem Browser den /lcd-Proxy-Pfad der Vorlage, statt die Chain-Adresse direkt aufzurufen
Hardhat startet nichtNode.js ist älter als 22Installieren Sie Node.js 22 oder neuer (siehe „Bevor Sie beginnen“) und führen Sie pnpm install erneut aus
curl zeigt direkt nach dem Schritt tx not foundDer Block ist noch nicht finalWarten Sie 10 Sekunden und führen Sie den Befehl erneut aus
curl funktioniert in Windows PowerShell nichtcurl ist dort ein anderer BefehlGeben Sie curl.exe statt curl ein

Die Beispiel-Apps​

Derselbe Ablauf, aus mehreren Sprachen und Frontends. Jede signiert hybrid. Alle befinden sich im öffentlichen Repository github.com/qorechain/build-before-qday, Ordner workshop-1. Um sie zu erhalten, brauchen Sie Git (prüfen Sie mit git --version; Installation von git-scm.com). Führen Sie dann aus:

git clone https://github.com/qorechain/build-before-qday
cd build-before-qday/workshop-1

Was es tut: lädt eine Kopie aller Beispiel-Apps herunter und wechselt in den Ordner workshop-1.

Parameter:

  • git clone <address>: ein Projekt aus dem Internet auf Ihren Computer kopieren.
  • cd build-before-qday/workshop-1: den Ordner betreten, der die sechs Apps enthält.

Jede App-Seite ist ein eigener vollständiger Leitfaden von Anfang bis Ende, mit dem, was Sie installieren müssen, und dem, was Sie erwarten können.

AppSpracheSeite
Q-Day CounterTypeScript, Solidityqday-counter
Q-Day GuestbookTypeScript, Solidityqday-guestbook
Hybrid InspectorTypeScripthybrid-inspector
Q-Day PayRustrust-qday-pay
Q-Day Tip JarJavajava-tipjar
Q-Day AirdropPythonpython-airdrop

Die Kits hinter diesen Apps stehen unter Kits. Wie Sie die QoreX-Wallet mit einer Browser-dApp verwenden, lesen Sie unter QoreX.