Saltar al contenido principal

CLI: create-qorechain-dapp

Crea el andamiaje de una nueva dApp de QoreChain a partir de una plantilla inicial oficial.

# 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

Publicado en npm como create-qorechain-dapp (0.14.0, que también incluye las correcciones de plantillas de la 0.13.1). Los archivos package.json generados dependen de @qorechain/sdk ^0.14.0 (las plantillas EVM, de @qorechain/evm ^0.14.0). La versión 0.8.0 del generador escribía rangos ^0.3.0, que npm resuelve a una versión 0.3 que no puede firmar para las redes en vivo; si generaste el andamiaje con la 0.8.0, ejecuta npm i @qorechain/sdk@latest.

Plantillas​

PlantillaDescripción
evm-solidityUn contrato Counter de Solidity + un script de despliegue/interacción con viem (@qorechain/evm). Ejecuta el script con pnpm run deploy (no con pnpm deploy, que es otro comando de pnpm); lee .env, y su README explica cómo abrir la ventana EVM antes de desplegar.
fullstack-webUna dApp Vite + React + TypeScript que lee saldos y tokenomics (@qorechain/sdk). REST pasa por un proxy /lcd de Vite porque el REST público no envía cabeceras CORS, así que el código del navegador llama a /lcd/... en desarrollo.
rollup-appUna app de rollup + sidechain/paychain que usa el RollupClient y el asistente multilayer (@qorechain/sdk).
foundryUn proyecto de Foundry para el EVM Engine de QoreChain. pnpm window registra la clave ML-DSA-87 de la cuenta y abre la ventana de autorización EVM antes de un despliegue (añadido en la 0.11.0, solo en npm).
hardhatLo mismo para Hardhat 3, con pnpm window status, register y open.
viem-wagmiUna dApp web sobre viem y wagmi que usa las cadenas qorechain y qorechainTestnet de @qorechain/evm. Fija viem ~2.53.1 y usa el mismo proxy /lcd para REST.
cosmwasmUn proyecto de contrato de QoreChain Native (Wasm). En las redes en vivo la subida de código es solo por gobernanza; consulta la guía de QoreChain Native.

La plantilla rollup-app (desde el generador 0.10.0) ejecuta una simulación por defecto. Con QORE_BROADCAST=1 deriva la clave ML-DSA-87 de la cuenta a partir del mnemónico, la registra una vez y firma de forma híbrida, algo que la plantilla anterior no podía hacer. Sus valores de rollup de ejemplo (profile: "default", el stake) son ilustrativos: toma los nombres de perfil y el stake reales de Perfiles predefinidos y de los parámetros del módulo en vivo antes de difundir.

La plantilla fullstack-web lee el resumen de tokenomics mediante client.qor, una llamada JSON-RPC qor_ que los endpoints públicos no sirven, por lo que en mainnet y testnet ese panel muestra un error; la lectura del saldo funciona. Cámbiala por una lectura REST como client.rest.getBurnStats() para las redes públicas.

Opciones​

FlagDescripción
-t, --template <name>Plantilla a usar (evm-solidity | fullstack-web | rollup-app | foundry | hardhat | viem-wagmi | cosmwasm).
--network <name>Preajuste de red (testnet | mainnet). Escribe los endpoints públicos de la red elegida en el .env generado (desde la 0.13.1).
--package-manager <pm>pnpm | npm | yarn.
-y, --yesOmitir los prompts y usar los valores por defecto.
--no-installNo instalar dependencias tras el andamiaje.
--localReescribe las dependencias @qorechain/* como enlaces locales file: al monorepo del SDK.
-h, --helpMostrar la ayuda.
-v, --versionImprimir la versión.

Desarrollo local contra el workspace​

Los paquetes @qorechain/* están publicados en npm, así que un simple npm install funciona. Usa --local para apuntar en su lugar el proyecto generado a los paquetes del monorepo (compílalos primero con pnpm -r build):

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