ChainForge Studio

ethrex 기반 모듈러 앱체인(롤업) 팩토리 — 웹 스튜디오. 웹 위저드에서 롤업 사양을 입력하면 ethrex(Rust L2 클라이언트)에 바로 배포 가능한 산출물을 생성하고, L1 컨트랙트 배포까지 수행한다. 여기에 바로 올릴 수 있는 dApp 템플릿 카탈로그를 함께 제공한다.

한 줄: zkVM 위에 커스텀 롤업을 위저드로 찍어내고 배포하는 RaaS 스튜디오 + dApp 템플릿.

---

무엇을 하나

1. Factory — 롤업 생성 위저드 (핵심)

6단계 위저드로 사양을 입력하면 ethrex에 즉시 적용 가능한 산출물을 생성한다.

1. Architecture — VM(levm), 롤업 모드(zk-rollup / validium / based), DA 레이어(eip-4844 / validium-offchain), ZK 백엔드(sp1 / risc0 / zisk / openvm)
2. Guest Program — zkVM 게스트 프로그램 선택/구성
3. Genesis — 제네시스 생성
4. Circuit — 회로 설정
5. Contracts — 롤업 컨트랙트 구성
6. Deploy — 배포

생성 산출물: genesis.json, manifest.json, programs.toml, deploy 스크립트

2. 배포 파이프라인

• Anvil + ethrex deployer로 실제 L1 컨트랙트 배포
• Manager bundle deploy API를 통한 번들 배포
• Guest program ELF 빌드 파이프라인

3. dApp 템플릿 카탈로그 (~24종)

생성한 체인에 바로 올릴 수 있는 예제 dApp + companion Solidity 컨트랙트:

• DeFi: amm-dex(AMMFactory), staking-rewards(StakingFactory), oracle-interface(PriceOracle), token-factory(TokenFactory)
• ZK / 프라이버시: zk-identity(IdentityRegistry), shielded-transfer(ShieldedPool), private-voting(PrivateVoteVerifier), blind-auction-zk(AuctionVerifier), zk-ml(MlVerifier), zk-randomness(RandomnessOracle)
• 거버넌스: governance-voting(Governor), modular-dao(ModularDAO), multisig-wallet(MultiSigFactory)
• NFT / 게임: nft-collection(NFTFactory), batch-minting(BatchMinter), loyalty-points(LoyaltyProgram), focg-engine(GameEngine), tokamon(TokamoniFactory), social-graph(SocialGraph)
• 인프라: bridge, faucet(Faucet), l1-token-mapping, custom-stf

4. 스튜디오 UI

Factory · Dashboard · Marketplace · Analytics · Community · Docs · Utilities · Login/Auth

---

아키텍처

Frontend (React + Vite)      ── src/       (pages, dapps, components, lib, context)
Server (Express/serverless)  ── server/    (routes, repositories, storage)  # guest build API, manager bundle deploy
Contracts (Foundry)          ── contracts/ (defi, assets, governance, nft-gaming, infra)
Target                       ── ethrex (Rust L2) + zkVM 백엔드 (SP1 / RISC0 / zisk / openvm)

테스트 현황

종류	상태
단위 (vitest)	✅ 86 passed
E2E (Playwright)	✅ 26 passed
통합 (Anvil + ethrex 실제 L1 배포)	🟡 90% (배포 성공, verify 스크립트 함수명 수정 남음)
번들 최적화	940KB → 225KB (gzip −76%)

---

실행

Prerequisites: Node.js

npm install
cp .env.example .env   # 필요한 키 채우기
npm run dev

통합 테스트(실제 L1 배포)는 ethrex 빌드가 필요하다:

# ethrex 빌드 (최초 1회)
COMPILE_CONTRACTS=true cargo build --bin ethrex --features l2
# 통합 테스트
bash integration-test/run-local.sh

자세한 설계·프로토콜은 docs/ 참고: IMPLEMENTATION.md · factory-design.md · GUEST_BUILD_PROTOCOL.md · ELF_BUILD_PIPELINE.md · MANAGER_DEPLOY_DESIGN.md · ethrex-analysis.md · CURRENT_STATUS.md

---

로드맵 (미착수 — 비전)

WHITEPAPER.md의 아래 항목은 아직 구현 전이다:

• Phase 5: 마켓플레이스 퍼블리싱 플로우
• Phase 6: 영속 저장소 (Dexie/IndexedDB → Supabase, 소셜 로그인)
• 멀티 VM(Move/SVM), 외부 DA(Celestia/EigenDA/Avail), ZK-Relay 브리지, 마켓플레이스 토크노믹스

---

개인 작업본. 원본은 tokamak-network 조직에서 개발되었으며, 이 저장소는 개인 포트폴리오/실험용 사본이다.