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 erzeugtenpackage.json-Dateien hängen von@qorechain/sdk^0.14.0ab (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 Sienpm i @qorechain/sdk@latestaus.
Vorlagen
| Vorlage | Beschreibung |
|---|---|
evm-solidity | Ein 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-web | Eine 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-app | Eine Rollup- + Sidechain-/Paychain-App mit dem RollupClient und dem Multilayer-Helfer (@qorechain/sdk). |
foundry | Ein 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). |
hardhat | Dasselbe für Hardhat 3, mit pnpm window status, register und open. |
viem-wagmi | Eine 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. |
cosmwasm | Ein 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
| Flag | Beschreibung |
|---|---|
-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, --yes | Abfragen überspringen und Standardwerte verwenden. |
--no-install | Nach dem Scaffolding keine Abhängigkeiten installieren. |
--local | @qorechain/*-Abhängigkeiten auf lokale file:-Links in das SDK-Monorepo umschreiben. |
-h, --help | Hilfe anzeigen. |
-v, --version | Die 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