Sari la conținutul principal

CLI: create-qorechain-dapp

Schelărie pentru un nou dApp QoreChain pornind de la un șablon oficial de start.

# 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

Publicat pe npm ca create-qorechain-dapp (0.14.0, care poartă și corecțiile de șabloane din 0.13.1). Fișierele package.json generate depind de @qorechain/sdk ^0.14.0 (șabloanele EVM de @qorechain/evm ^0.14.0). Versiunea 0.8.0 a schelei scria intervale ^0.3.0, pe care npm le rezolvă la o versiune 0.3 care nu poate semna pentru rețelele live; dacă ai generat proiectul cu 0.8.0, rulează npm i @qorechain/sdk@latest.

Șabloane​

ȘablonDescriere
evm-solidityUn contract Solidity Counter + un script viem de deploy/interacțiune (@qorechain/evm). Rulează scriptul cu pnpm run deploy (nu pnpm deploy, care este o altă comandă pnpm); citește .env, iar README-ul său explică deschiderea ferestrei EVM înainte de deploy.
fullstack-webUn dApp Vite + React + TypeScript care citește solduri și tokenomics (@qorechain/sdk). REST trece printr-un proxy Vite /lcd, pentru că REST-ul public nu trimite antete CORS, deci codul din browser apelează /lcd/... în dev.
rollup-appO aplicație rollup + sidechain/paychain care folosește RollupClient și ajutorul multilayer (@qorechain/sdk).
foundryUn proiect Foundry pentru EVM Engine al QoreChain. pnpm window înregistrează cheia ML-DSA-87 a contului și deschide fereastra de autorizare EVM înainte de un deploy (adăugat în 0.11.0, doar pe npm).
hardhatLa fel pentru Hardhat 3, cu pnpm window status, register și open.
viem-wagmiUn dApp web pe viem și wagmi care folosește lanțurile qorechain și qorechainTestnet din @qorechain/evm. Fixează viem la ~2.53.1 și folosește același proxy /lcd pentru REST.
cosmwasmUn proiect de contract QoreChain Native (Wasm). Pe rețelele live încărcarea codului este doar prin guvernanță; vezi ghidul QoreChain Native.

Șablonul rollup-app (începând cu scaffolder 0.10.0) rulează implicit o simulare (dry run). Cu QORE_BROADCAST=1 derivă cheia ML-DSA-87 a contului din mnemonic, o înregistrează o singură dată și semnează hibrid, ceea ce șablonul anterior nu putea face. Valorile sale de rollup de exemplu (profile: "default", stake-ul) sunt ilustrative: ia numele reale de profil și stake-ul din Profiluri presetate și din parametrii live ai modulului înainte de a difuza.

Șablonul fullstack-web citește prezentarea generală a tokenomics prin client.qor, un apel JSON-RPC qor_ pe care endpoint-urile publice nu îl servesc, așa că pe mainnet și testnet acel panou afișează o eroare; citirea soldului funcționează. Treci-l la o citire REST, precum client.rest.getBurnStats(), pentru rețelele publice.

Opțiuni​

FlagDescriere
-t, --template <name>Șablonul de utilizat (evm-solidity | fullstack-web | rollup-app | foundry | hardhat | viem-wagmi | cosmwasm).
--network <name>Presetare de rețea (testnet | mainnet). Scrie punctele finale publice ale rețelei alese în .env generat (începând cu 0.13.1).
--package-manager <pm>pnpm | npm | yarn.
-y, --yesSari peste prompturi și folosește valorile implicite.
--no-installNu instala dependențele după schelărie.
--localRescrie dependențele @qorechain/* în linkuri locale file: către monorepo-ul SDK.
-h, --helpAfișează ajutorul.
-v, --versionAfișează versiunea.

Dezvoltare locală față de workspace​

Pachetele @qorechain/* sunt publicate pe npm, așadar un simplu npm install funcționează. Folosește --local pentru a indica în schimb proiectul schelărit spre pachetele din monorepo (compilează-le mai întâi cu pnpm -r build):

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