Zum Hauptinhalt springen

CLI: create-qorechain-dapp

Erstellen Sie eine neue QoreChain-dApp aus einer offiziellen Starter-Vorlage.

# interactive
npm create qorechain-dapp my-dapp
# or
npx create-qorechain-dapp my-dapp

# non-interactive (CI)
npx create-qorechain-dapp my-dapp --template evm-solidity --yes --no-install

Veröffentlicht auf npm als create-qorechain-dapp (0.14.0, das auch die Vorlagen-Korrekturen von 0.13.1 enthält). Die erzeugten package.json-Dateien hängen von @qorechain/sdk ^0.14.0 ab (die EVM-Vorlagen von @qorechain/evm ^0.14.0). Version 0.8.0 des Scaffolders schrieb ^0.3.0-Bereiche, die npm zu einem 0.3-Release auflöst, das für die Live-Netzwerke nicht signieren kann; wenn Sie mit 0.8.0 ein Gerüst erstellt haben, führen Sie npm i @qorechain/sdk@latest aus.

Vorlagen​

VorlageBeschreibung
evm-solidityEin Solidity-Counter-Contract + ein viem-Deploy-/Interaktions-Skript (@qorechain/evm). Führen Sie das Skript mit pnpm run deploy aus (nicht pnpm deploy, das ein anderer pnpm-Befehl ist); es liest .env, und seine README beschreibt, wie Sie vor dem Deploy das EVM-Fenster öffnen.
fullstack-webEine Vite + React + TypeScript-dApp, die Guthaben und Tokenomics liest (@qorechain/sdk). REST läuft über einen Vite-/lcd-Proxy, weil die öffentliche REST keine CORS-Header sendet; Browser-Code ruft daher in der Entwicklung /lcd/... auf.
rollup-appEine Rollup- + Sidechain-/Paychain-App mit dem RollupClient und dem Multilayer-Helfer (@qorechain/sdk).
foundryEin Foundry-Projekt für die EVM Engine von QoreChain. pnpm window registriert den ML-DSA-87-Schlüssel des Kontos und öffnet vor einem Deploy das EVM-Autorisierungsfenster (hinzugefügt im nur auf npm veröffentlichten 0.11.0).
hardhatDasselbe für Hardhat 3, mit pnpm window status, register und open.
viem-wagmiEine Web-dApp auf viem und wagmi mit den Chains qorechain und qorechainTestnet aus @qorechain/evm. Pinnt viem ~2.53.1 und nutzt für REST denselben /lcd-Proxy.
cosmwasmEin Contract-Projekt für QoreChain Native (Wasm). Auf den Live-Netzwerken ist der Code-Upload nur über Governance möglich; siehe den QoreChain-Native-Leitfaden.

Die Vorlage rollup-app (seit Scaffolder 0.10.0) führt standardmäßig einen Probelauf aus. Mit QORE_BROADCAST=1 leitet sie den ML-DSA-87-Schlüssel des Kontos aus der Mnemonic ab, registriert ihn einmalig und signiert hybrid, was die frühere Vorlage nicht konnte. Ihre Beispielwerte für den Rollup (profile: "default", der Stake) sind illustrativ: Entnehmen Sie die echten Profilnamen und den Stake aus den Preset-Profilen und den aktuellen Modulparametern, bevor Sie senden.

Die Vorlage fullstack-web liest die Tokenomics-Übersicht über client.qor, einen JSON-RPC-Aufruf qor_, den die öffentlichen Endpunkte nicht bereitstellen; daher zeigt dieses Panel im Mainnet und Testnet einen Fehler an, während das Lesen des Guthabens funktioniert. Stellen Sie es für die öffentlichen Netzwerke auf einen REST-Lesezugriff wie client.rest.getBurnStats() um.

Optionen​

FlagBeschreibung
-t, --template <name>Zu verwendende Vorlage (evm-solidity | fullstack-web | rollup-app | foundry | hardhat | viem-wagmi | cosmwasm).
--network <name>Netzwerk-Voreinstellung (testnet | mainnet). Schreibt die öffentlichen Endpunkte des gewählten Netzwerks in die erzeugte .env (seit 0.13.1).
--package-manager <pm>pnpm | npm | yarn.
-y, --yesAbfragen überspringen und Standardwerte verwenden.
--no-installNach dem Scaffolding keine Abhängigkeiten installieren.
--local@qorechain/*-Abhängigkeiten auf lokale file:-Links in das SDK-Monorepo umschreiben.
-h, --helpHilfe anzeigen.
-v, --versionDie Version ausgeben.

Lokale Entwicklung gegen den Workspace​

@qorechain/*-Pakete sind auf npm veröffentlicht, daher funktioniert ein einfaches npm install. Verwenden Sie --local, um das erstellte Projekt stattdessen auf die Monorepo-Pakete zeigen zu lassen (bauen Sie diese zuerst mit pnpm -r build):

npx create-qorechain-dapp my-dapp --template fullstack-web --local