Passa al contenuto principale

CLI: create-qorechain-dapp

Genera una nuova dApp QoreChain a partire da un template starter ufficiale.

# 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

Pubblicato su npm come create-qorechain-dapp (0.14.0, che porta anche le correzioni ai template della 0.13.1). I file package.json generati dipendono da @qorechain/sdk ^0.14.0 (i template EVM da @qorechain/evm ^0.14.0). La versione 0.8.0 dello scaffolder scriveva intervalli ^0.3.0, che npm risolve in una release 0.3 incapace di firmare per le reti attive; se hai generato lo scaffolding con la 0.8.0, esegui npm i @qorechain/sdk@latest.

Template​

TemplateDescrizione
evm-solidityUn contratto Solidity Counter + uno script viem di deploy/interazione (@qorechain/evm). Eseguilo con pnpm run deploy (non pnpm deploy, che è un comando pnpm diverso); legge .env, e il suo README spiega come aprire la finestra EVM prima del deploy.
fullstack-webUna dApp Vite + React + TypeScript che legge saldi e tokenomics (@qorechain/sdk). REST passa da un proxy Vite /lcd perché il REST pubblico non invia header CORS, quindi in sviluppo il codice del browser chiama /lcd/....
rollup-appUn'app rollup + sidechain/paychain che usa il RollupClient e l'helper multilayer (@qorechain/sdk).
foundryUn progetto Foundry per l'EVM Engine di QoreChain. pnpm window registra la chiave ML-DSA-87 dell'account e apre la finestra di autorizzazione EVM prima di un deploy (aggiunto nella 0.11.0 solo su npm).
hardhatLo stesso per Hardhat 3, con pnpm window status, register e open.
viem-wagmiUna dApp web su viem e wagmi che usa le chain qorechain e qorechainTestnet di @qorechain/evm. Fissa viem a ~2.53.1 e usa lo stesso proxy /lcd per REST.
cosmwasmUn progetto di contratto QoreChain Native (Wasm). Sulle reti live il caricamento del codice è solo tramite governance; vedi la guida a QoreChain Native.

Il template rollup-app (dallo scaffolder 0.10.0) esegue per impostazione predefinita una prova a vuoto (dry run). Con QORE_BROADCAST=1 deriva la chiave ML-DSA-87 dell'account dal mnemonic, la registra una volta e firma in modo ibrido, cosa che il template precedente non poteva fare. I suoi valori di esempio per il rollup (profile: "default", lo stake) sono illustrativi: prendi i nomi dei profili reali e lo stake da Profili preset e dai parametri live del modulo prima di trasmettere.

Il template fullstack-web legge la panoramica della tokenomics tramite client.qor, una chiamata JSON-RPC qor_ che gli endpoint pubblici non servono, quindi su mainnet e testnet quel pannello mostra un errore; la lettura del saldo funziona. Sostituiscila con una lettura REST come client.rest.getBurnStats() per le reti pubbliche.

Opzioni​

FlagDescrizione
-t, --template <name>Template da usare (evm-solidity | fullstack-web | rollup-app | foundry | hardhat | viem-wagmi | cosmwasm).
--network <name>Preset di rete (testnet | mainnet). Scrive nel .env generato gli endpoint pubblici della rete scelta (dalla 0.13.1).
--package-manager <pm>pnpm | npm | yarn.
-y, --yesSalta i prompt e usa i valori predefiniti.
--no-installNon installa le dipendenze dopo lo scaffolding.
--localRiscrive le dipendenze @qorechain/* come link file: locali nel monorepo dell'SDK.
-h, --helpMostra l'aiuto.
-v, --versionStampa la versione.

Sviluppo locale contro il workspace​

I pacchetti @qorechain/* sono pubblicati su npm, quindi un semplice npm install funziona. Usa --local per puntare invece il progetto generato ai pacchetti del monorepo (compilali prima con pnpm -r build):

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