genlayer-project-boilerplate: GenVM 20개 규칙 정적 분석과 밀리초 단위 테스트 루프

GenLayer 플랫폼에서 인텔리전트 계약을 구현할 때 필요한 구조를 축구 베팅 게임 예제로 정리해 둔 프로젝트다. 계약 작성, 웹 데이터 연동, LLM 호출, 프론트엔드 구성까지 실제 서비스 배포에 필요한 요소를 한 번에 갖춘 상태다. MIT 라이선스로 공개되어 있어 자유롭게 수정하거나 참고할 수 있다.

핵심은 계약 로직의 검증과 테스트 환경을 분리한 점이다. GenVM linter를 통해 비결정적 호출이나 잘못된 저장소 타입 등 20개 이상의 규칙을 정적 분석으로 잡아낸다. Direct mode 테스트는 GenLayer Studio 없이 메모리에서 실행되며, 웹 요청과 LLM 응답을 목킹해 테스트당 수 밀리초 만에 피드백을 준다. 이는 AI 코딩 에이전트와 함께 반복 개발을 할 때 특히 유리한 구조다.

프론트엔드는 Next.js 15, TypeScript, TanStack Query, Radix UI를 사용해 생산 환경 수준으로 구성했다. 계약 배포 스크립트와 CI 파이프라인(GitHub Actions)도 포함되어 있어 린팅부터 통합 테스트까지 자동화할 수 있다. 통합 테스트는 실제 GenLayer Studio 환경에서 합의(consensus) 동작을 검증한다.

GenLayer 생태계에서 새로운 프로젝트를 시작하거나, LLM을 활용한 온체인 로직을 개발하는 개발자에게 적합하다. 특히 빠른 단위 테스트 루프가 필요한 AI 보조 개발 환경에서 표준 템플릿으로 활용하기 좋다.