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-solidity | Solidity 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-app | RollupClient와 멀티레이어 헬퍼를 사용하는 롤업 + 사이드체인/페이체인 앱(@qorechain/sdk). |
foundry | QoreChain EVM 엔진용 Foundry 프로젝트. pnpm window는 배포 전에 계정의 ML-DSA-87 키를 등록하고 EVM 인가 윈도우를 엽니다(npm 전용 0.11.0에서 추가). |
hardhat | Hardhat 3용으로 같은 구성이며, pnpm window status, register, open이 있습니다. |
viem-wagmi | @qorechain/evm의 qorechain 및 qorechainTestnet 체인을 쓰는 viem과 wagmi 기반 웹 dApp. viem ~2.53.1을 고정하고 REST에는 같은 /lcd 프록시를 씁니다. |
cosmwasm | QoreChain 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