Web3
온체인 레이싱 게임 스마트컨트랙트 구조 문서
Hardhat과 Foundry를 병행하는 레이싱 게임 온체인 컨트랙트 저장소의 구조를 정리한 공개 문서
racing-game-onchain-contracts-docs최근 업데이트 2026년 7월 26일
개요
블록체인 기반 레이싱 게임의 스마트컨트랙트 저장소가 어떻게 구성되어 있는지 외부에 공개하기 위해 작성한 문서입니다. contracts, scripts, test 디렉토리로 역할을 분리하고, Hardhat으로 배포와 타입 생성을, Foundry로 단위 테스트를 병행하는 하이브리드 개발 구조를 설명합니다. 실제 컨트랙트 소스 코드는 포함하지 않고 저장소 구조와 개발 도구 조합에 대한 개념 정리만 담고 있습니다.
담당 역할
레이싱 게임 온체인 컨트랙트 저장소의 구조를 설계하고, Hardhat/Foundry 하이브리드 개발 환경을 구성한 뒤 그 구조를 문서로 정리했습니다.
아키텍처 다이어그램
레포지토리 분석 결과를 바탕으로 자동 생성된 구조도입니다.
아키텍처
저장소 구조 및 도구 흐름
컨트랙트 소스가 Hardhat과 Foundry 두 도구를 거쳐 각각 배포/타입생성, 테스트로 이어지는 흐름을 보여줍니다.
다이어그램을 그리는 중…
기술스택
각 기술을 이 프로젝트에서 어떤 용도로 썼는지 정리했습니다.
언어
- Solidity온체인 레이싱 게임 컨트랙트 작성 언어
- TypeScriptHardhat 설정 및 배포 스크립트 작성
블록체인
- Hardhat컨트랙트 배포 및 TypeChain 타입 생성
테스트
- Foundry컨트랙트 단위 테스트 실행
도구
- TypeChain컨트랙트 타입 정의 자동 생성
핵심 포인트
- Hardhat과 Foundry를 함께 사용해 배포/타입생성과 단위 테스트 도구를 역할별로 분리
- contracts, scripts, test 디렉토리로 컨트랙트 코드와 배포/테스트 로직을 명확히 구분
- artifacts, typechain-types 캐시를 활용해 반복 빌드 시 타입 안정성 확보
레포지토리 정보
- 생성
- 2026년 7월 26일
- 최근 커밋
- 2026년 7월 26일
- 크기
- 0 KB
- 라이선스
- 없음
이 문서는 2026년 7월 26일 에 자동 분석으로 생성되었습니다.