genlayer-project-boilerplate: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Quick Commands

# Linting
genvm-lint check contracts/football_bets.py    # Lint a contract

# Testing
pytest tests/direct/ -v                        # Direct mode tests (fast, no Studio)
gltest tests/integration/ -v -s                # Integration tests (requires Studio)

# Deployment
genlayer network                               # Select network
genlayer deploy                                # Deploy contracts

# Frontend
cd frontend && npm run dev                     # Start frontend dev server

Architecture

contracts/          # Python intelligent contracts
tests/
  direct/           # Fast in-memory tests with web/LLM mocks
  integration/      # Full tests against GenLayer Studio
frontend/           # Next.js 15 app (TypeScript, TanStack Query, Radix UI)
deploy/             # TypeScript deployment scripts

Frontend stack: Next.js 15, React 19, TypeScript, Tailwind CSS, TanStack Query, Wagmi/Viem, MetaMask wallet integration.

Development Workflow

1. Write/modify contract in contracts/
2. Lint: genvm-lint check contracts/your_contract.py
3. Test direct: pytest tests/direct/ -v
4. Start Studio and deploy: genlayer deploy
5. Test integration: gltest tests/integration/ -v -s
6. Run frontend: cd frontend && npm run dev

Contract Development

Contracts are Python files in /contracts/ using the GenLayer SDK:

from genlayer import *

class MyContract(gl.Contract):
    data: TreeMap[Address, str]

    def __init__(self):
        self.data = TreeMap()

    @gl.public.view
    def get_data(self, addr: Address) -> str:
        return self.data.get(addr, "")

    @gl.public.write
    def set_data(self, value: str):
        self.data[gl.message.sender_address] = value

Decorators:

• @gl.public.view — Read-only methods
• @gl.public.write — State-modifying methods
• @gl.public.write.payable — Methods accepting value