# genlayerlabs/genlayer-project-boilerplate

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/genlayerlabs-genlayer-project-boilerplate).**

4,829 stars · 196 forks · TypeScript · mit

## Links

- GitHub: https://github.com/genlayerlabs/genlayer-project-boilerplate
- awesome-repositories: https://awesome-repositories.com/repository/genlayerlabs-genlayer-project-boilerplate.md

## Description

This is a full-stack template for building decentralized applications on the GenLayer blockchain, combining smart contract development with a frontend integration pipeline. It provides a pre-configured environment for writing GenLayer smart contracts using Python decorators that specify function visibility, persistence, and typed storage structures, along with built-in linting to catch forbidden imports and nondeterministic calls before deployment.

The boilerplate distinguishes itself by supporting nondeterministic smart contract operations—such as querying language models and fetching external web data—with automatic consensus validation through custom validator functions or equivalence checks. It includes a testing harness with mocked web and AI services for millisecond-level unit tests, plus a simulated network that runs full-consensus tests to verify correctness before production release. Quality enforcement is automated through Git hooks that run linting and tests on every commit.

Additional capabilities cover the full development lifecycle: configuring test networks and contract paths via YAML, deploying contracts to a target network with a single CLI command, generating frontend client code with wallet integrations, and managing user accounts through local key generation and import/export. The template also includes a working on-chain prediction market example that demonstrates AI-based result verification and real-time frontend updates.

## Tags

### Web Development

- [AI-Integrated](https://awesome-repositories.com/f/web-development/smart-contract-environments/ai-integrated.md) — Builds contracts that query language models and fetch web data with automatic consensus validation.
- [Frontend Client Generators](https://awesome-repositories.com/f/web-development/api-client-generators/type-safe-client-generators/frontend-client-generators.md) — Automatically produces frontend client code and wallet integrations to connect web apps to contracts.
- [Smart Contract Environments](https://awesome-repositories.com/f/web-development/smart-contract-environments.md) — A pre-configured environment for developing GenLayer smart contracts with decorators and built-in linting.
- [Automated Contract Testing Suites](https://awesome-repositories.com/f/web-development/smart-contract-environments/automated-contract-testing-suites.md) — Runs contracts in memory with simulated services and asserts state changes and transaction failures. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/CLAUDE.md))
- [Frontend Contract Connections](https://awesome-repositories.com/f/web-development/smart-contract-environments/smart-contract-callers/frontend-contract-connections.md) — Connects the frontend to a deployed smart contract by setting its address. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/README.md))
- [Smart Contract Frontend Integrations](https://awesome-repositories.com/f/web-development/smart-contract-frontend-integrations.md) — Connects frontend applications to deployed smart contracts using generated client code and wallet integrations. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/CLAUDE.md))
- [Smart Contract Web Access](https://awesome-repositories.com/f/web-development/web-apis/data-fetching-and-repository-access/smart-contract-web-access.md) — Makes nondeterministic HTTP requests from contracts to fetch live web data or render pages. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/CLAUDE.md))

### Artificial Intelligence & ML

- [In-Memory Testing](https://awesome-repositories.com/f/artificial-intelligence-ml/external-server-connectivity/in-memory-testing.md) — Executes contracts in memory with mocked web and AI responses for fast feedback. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/README.md))
- [Language Model Querying](https://awesome-repositories.com/f/artificial-intelligence-ml/language-model-querying.md) — Sends prompts to language models to generate text, analyze data, or produce structured output. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/CLAUDE.md))

### DevOps & Infrastructure

- [Smart Contract Deployment Scripts](https://awesome-repositories.com/f/devops-infrastructure/deployment-management-strategies/automation-and-tooling/deployment-tooling/automated-deployment-scripts/smart-contract-deployment-scripts.md) — Provides a single CLI command to deploy compiled contracts to a chosen network. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate#readme))
- [Blockchain Network Deployments](https://awesome-repositories.com/f/devops-infrastructure/deployment-management-strategies/execution-platforms-and-targets/deployment-infrastructure/deployment-targets/blockchain-network-deployments.md) — Selects a target network and deploys compiled contract code to the blockchain. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/CLAUDE.md))
- [CLI-Integrated Pipelines](https://awesome-repositories.com/f/devops-infrastructure/smart-contract-deployment-pipelines/cli-integrated-pipelines.md) — Provides a single-command CLI pipeline for deploying compiled contracts to a target network.

### Networking & Communication

- [Smart Contract Development Frameworks](https://awesome-repositories.com/f/networking-communication/smart-contract-development-frameworks.md) — Provides a full environment for writing, testing, and deploying smart contracts with decorators and typed storage.
- [Decorator-Based Contract Definitions](https://awesome-repositories.com/f/networking-communication/smart-contract-development-frameworks/decorator-based-contract-definitions.md) — Ships a decorator-based approach for defining smart contract logic with typed storage. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/CLAUDE.md))

### Software Engineering & Architecture

- [DApp Scaffolds](https://awesome-repositories.com/f/software-engineering-architecture/application-scaffolding/spa-scaffolds/dapp-scaffolds.md) — A full-stack template for building decentralized applications on the GenLayer blockchain.
- [Nondeterministic](https://awesome-repositories.com/f/software-engineering-architecture/application-scaffolding/spa-scaffolds/dapp-scaffolds/nondeterministic.md) — Provides a template for dApps that use nondeterministic calls with automatic consensus validation.
- [Smart Contract](https://awesome-repositories.com/f/software-engineering-architecture/executable-activity-definitions/test-harnesses/smart-contract.md) — Ships a testing harness with mocked services, test markers, and simulated network support for contracts.
- [Contract Development Decorators](https://awesome-repositories.com/f/software-engineering-architecture/higher-order-function-wrapping/function-decorators/contract-development-decorators.md) — Defines contract logic with Python decorators for visibility, persistence, and typed storage.
- [Nondeterministic Result Validators](https://awesome-repositories.com/f/software-engineering-architecture/validation-rules/consensus-rule-validators/nondeterministic-result-validators.md) — Implements validator functions to ensure consensus on nondeterministic smart contract operations. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/CLAUDE.md))

### Testing & Quality Assurance

- [Local Network Simulators](https://awesome-repositories.com/f/testing-quality-assurance/local-network-simulators.md) — Deploys contracts to a simulated network and runs tests with full consensus verification. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/README.md))
- [Simulated Network End-to-End Tests](https://awesome-repositories.com/f/testing-quality-assurance/software-testing/e2e-integration-testing/end-to-end-testing/simulated-network-end-to-end-tests.md) — Provides end-to-end testing on a simulated network with full consensus verification. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate#readme))
- [Mocked External Service Unit Tests](https://awesome-repositories.com/f/testing-quality-assurance/software-testing/testing-frameworks/unit/unit-testing/web-controller-mocking/mocked-external-service-unit-tests.md) — Runs fast unit tests in memory with mocked web and AI services for quick feedback. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate#readme))

### Part of an Awesome List

- [Prediction Markets](https://awesome-repositories.com/f/awesome-lists/ai/prediction-markets.md) — Includes a working on-chain prediction market with AI-based result verification and real-time frontend updates.
- [Smart Contract Analysis](https://awesome-repositories.com/f/awesome-lists/devtools/smart-contract-analysis.md) — Includes built-in linting that catches forbidden imports and nondeterministic calls before deployment. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate#readme))

### Development Tools & Productivity

- [Contract Deployment Scripts](https://awesome-repositories.com/f/development-tools-productivity/contract-deployment-scripts.md) — Deploys the compiled contract to the chosen network using a command-line tool. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/blob/main/README.md))
- [In-Memory Service Mocks](https://awesome-repositories.com/f/development-tools-productivity/external-service-integrations/in-memory-service-mocks.md) — Runs contract tests in memory with simulated web and AI responses for fast feedback.

### Security & Cryptography

- [Account Management](https://awesome-repositories.com/f/security-cryptography/account-management.md) — Generates, imports, and exports private keys stored locally for decentralized identity management. ([source](https://github.com/genlayerlabs/genlayer-project-boilerplate/tree/main/frontend))
- [Key Management](https://awesome-repositories.com/f/security-cryptography/wallet-integrations/key-management.md) — Generates, imports, and exports private keys locally for secure user identity and wallet integration.