genlayer-project-boilerplate

概要

すぐに使える GenLayer サンプルプロジェクトで、サッカー予想ゲームを実装しています。Web/LLM を統合した Python スマートコントラクト、直接/統合テストスイート、Next.js 15 フロントエンド、CI パイプラインが含まれており、GenLayer 開発の出発点として適しています。

README プレビュー

# Sample GenLayer project\n[](https://opensource.org/license/mit/)\n[](https://discord.gg/8Jm4v89VAu)\n[](https://t.me/genlayer)\n[](https://x.com/GenLayer)\n[](https://star-history.com/#yeagerai/genlayer-js)\n\n## About\nThis project includes the boilerplate code for a GenLayer use case implementation, specifically a football bets game.\n\n## What's included\n- An example intelligent contract (Football Bets) with web access and LLM integration\n- **Direct mode tests** — fast, in-memory unit tests with web/LLM mocking (~ms per test)\n- **Integration tests** — full end-to-end tests against GenLayer Studio\n- **Contract linting** — static analysis to catch common contract issues before deployment\n- **CI pipeline** — GitHub Actions workflow for linting and direct tests\n- A production-ready Next.js 15 frontend with TypeScript, TanStack Query, and Radix UI\n- Configuration file template and deployment scripts\n\n## Requirements\n- Python >= 3.12\n- [GenLayer CLI](https://github.com/genlayerlabs/genlayer-cli) globally installed: `npm install -g genlayer`\n- GenLayer Studio (for integration tests and deployment): Install from [Docs](https://docs.genlayer.com/developers/intelligent-contracts/tooling-setup#using-the-genlayer-studio) or use the hosted [GenLayer Studio](https://studio.genlayer.com/)\n\n## Project Structure\n\n```\ncontracts/              # Python intelligent contracts\ntests/\n  direct/               # Fast in-memory tests (no Studio required)\n    test_create_bet.py   # Bet creation logic\n    test_resolve_bet.py  # Bet resolution with web/LLM mocks\n    test_views.py        # Read-only view methods\n  integration/           # Full tests against GenLayer Studio\n    test_football_bets.py\n    fixtures.py          # Expected state fixtures\nfrontend/               # Next.js 15 app (TypeScript, TanStack Query, Radix UI)\ndeploy/                 # TypeScript deployment scripts\ngltest.config.yaml      # Test runner network configuration\npyproject.toml