본문으로 건너뛰기

CLI: create-qorechain-dapp

공식 스타터 템플릿에서 새 QoreChain dApp을 스캐폴딩하세요.

# 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

create-qorechain-dapp(0.14.0, 0.13.1의 템플릿 수정도 포함)으로 npm에 게시되어 있습니다. 생성되는 package.json 파일은 @qorechain/sdk ^0.14.0에 의존합니다(EVM 템플릿은 @qorechain/evm ^0.14.0). 스캐폴더의 0.8.0 버전은 ^0.3.0 범위를 기록했는데, npm은 이를 실제 네트워크에 서명할 수 없는 0.3 릴리스로 해석합니다. 0.8.0으로 스캐폴딩했다면 npm i @qorechain/sdk@latest를 실행하세요.

템플릿​

템플릿설명
evm-soliditySolidity Counter 컨트랙트 + viem 배포/상호작용 스크립트(@qorechain/evm). 스크립트는 pnpm run deploy로 실행하세요(pnpm deploy는 다른 pnpm 명령입니다). 이 스크립트는 .env를 읽으며, README에 배포 전 EVM 윈도우를 여는 방법이 있습니다.
fullstack-web잔액과 토크노믹스를 읽는 Vite + React + TypeScript dApp(@qorechain/sdk). 공개 REST는 CORS 헤더를 보내지 않으므로 REST는 Vite /lcd 프록시를 거치며, 개발 중 브라우저 코드는 /lcd/...를 호출합니다.
rollup-appRollupClient와 멀티레이어 헬퍼를 사용하는 롤업 + 사이드체인/페이체인 앱(@qorechain/sdk).
foundryQoreChain EVM 엔진용 Foundry 프로젝트. pnpm window는 배포 전에 계정의 ML-DSA-87 키를 등록하고 EVM 인가 윈도우를 엽니다(npm 전용 0.11.0에서 추가).
hardhatHardhat 3용으로 같은 구성이며, pnpm window status, register, open이 있습니다.
viem-wagmi@qorechain/evm의 qorechain 및 qorechainTestnet 체인을 쓰는 viem과 wagmi 기반 웹 dApp. viem ~2.53.1을 고정하고 REST에는 같은 /lcd 프록시를 씁니다.
cosmwasmQoreChain Native(Wasm) 컨트랙트 프로젝트. 라이브 네트워크에서 코드 업로드는 거버넌스 전용입니다. QoreChain Native 가이드를 참고하세요.

rollup-app 템플릿(스캐폴더 0.10.0부터)은 기본적으로 드라이 런을 실행합니다. QORE_BROADCAST=1을 지정하면 니모닉에서 계정의 ML-DSA-87 키를 파생하고, 한 번 등록한 뒤 하이브리드로 서명하는데, 이전 템플릿은 이를 할 수 없었습니다. 샘플 롤업 값(profile: "default", 스테이크)은 예시일 뿐입니다. 브로드캐스트하기 전에 프리셋 프로필과 라이브 모듈 파라미터에서 실제 프로필 이름과 스테이크를 가져오세요.

fullstack-web 템플릿은 client.qor를 통해 토크노믹스 개요를 읽는데, 이는 공개 엔드포인트가 제공하지 않는 qor_ JSON-RPC 호출이므로 메인넷과 테스트넷에서는 해당 패널에 오류가 표시되며, 잔액 조회는 동작합니다. 공개 네트워크용으로는 client.rest.getBurnStats() 같은 REST 조회로 전환하세요.

옵션​

플래그설명
-t, --template <name>사용할 템플릿(evm-solidity | fullstack-web | rollup-app | foundry | hardhat | viem-wagmi | cosmwasm).
--network <name>네트워크 프리셋(testnet | mainnet). 선택한 네트워크의 공개 엔드포인트를 생성되는 .env에 기록합니다(0.13.1부터).
--package-manager <pm>pnpm | npm | yarn.
-y, --yes프롬프트를 건너뛰고 기본값을 사용합니다.
--no-install스캐폴딩 후 의존성을 설치하지 않습니다.
--local@qorechain/* 의존성을 SDK 모노레포로 향하는 로컬 file: 링크로 재작성합니다.
-h, --help도움말을 표시합니다.
-v, --version버전을 출력합니다.

워크스페이스에 대한 로컬 개발​

@qorechain/* 패키지는 npm에 게시되어 있으므로 평범한 npm install로 동작합니다. --local을 사용하면 스캐폴딩된 프로젝트가 대신 모노레포 패키지를 가리키게 됩니다 (먼저 pnpm -r build로 빌드하세요):

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