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 archivospackage.jsongenerados 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, ejecutanpm i @qorechain/sdk@latest.
Plantillas
| Plantilla | Descripción |
|---|---|
evm-solidity | Un 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-web | Una 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-app | Una app de rollup + sidechain/paychain que usa el RollupClient y el asistente multilayer (@qorechain/sdk). |
foundry | Un 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). |
hardhat | Lo mismo para Hardhat 3, con pnpm window status, register y open. |
viem-wagmi | Una 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. |
cosmwasm | Un 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
| Flag | Descripció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, --yes | Omitir los prompts y usar los valores por defecto. |
--no-install | No instalar dependencias tras el andamiaje. |
--local | Reescribe las dependencias @qorechain/* como enlaces locales file: al monorepo del SDK. |
-h, --help | Mostrar la ayuda. |
-v, --version | Imprimir 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