Repolode
genlayerlabs

genlayerlabs/genlayer-project-boilerplate

Boilerplate para criar contratos inteligentes na GenLayer, com um jogo de apostas em futebol como exemplo, além de testes, lint, CI e frontend em Next.js.

Estrelas
19,304
Forks
937
Issues abertas
38
Último commit
há 2 meses

O que é?

Este repositório é um template inicial para criar um contrato inteligente na GenLayer. O exemplo é um jogo de apostas em futebol: os usuários preveem o vencedor de uma partida, e o contrato consulta o resultado posteriormente na BBC Sport, usa um LLM para extrair o placar e verifica o resultado pelo princípio da equivalência antes de atribuir pontos.

O template abrange todo o ciclo de desenvolvimento. Um linter do GenVM verifica contratos em Python em busca de imports proibidos, chamadas não determinísticas e tipos de armazenamento inválidos antes da implantação. Testes diretos rápidos, executados em memória, usam mocks para chamadas à web e ao LLM, enquanto os testes de integração rodam no GenLayer Studio. Um workflow do GitHub Actions executa o lint e os testes diretos.

Um frontend em Next.js 15, criado com TypeScript, TanStack Query e Radix UI, conecta-se ao contrato implantado por meio de uma variável de ambiente. O template inclui scripts de implantação e um arquivo de configuração de rede.

Recursos principais

  • 01Contrato inteligente de exemplo que consulta dados na web e chama um LLM
  • 02Linter estático que sinaliza código não determinístico e tipos de armazenamento inválidos
  • 03Testes diretos em memória com mocks para respostas da web e do LLM
  • 04Testes de integração executados no GenLayer Studio
  • 05CI do GitHub Actions para lint e testes diretos
  • 06Frontend em Next.js 15 com TypeScript, TanStack Query e Radix UI

Casos de uso

  • Começar um novo projeto de contrato inteligente na GenLayer a partir de um exemplo funcional
  • Aprender como o acesso à web e as chamadas a LLM são estruturados dentro de um contrato
  • Configurar verificações de lint e CI para o código do contrato antes da implantação

Início rápido

  1. 1

    Instale o GenLayer CLI globalmente

    npm install -g genlayer
  2. 2

    Crie um ambiente virtual do Python (Python 3.12 ou superior)

    python3 -m venv .venv
  3. 3

    Execute os testes rápidos em memória do modo direto (não é necessário usar o Studio)

    pytest tests/direct/ -v
  4. 4

    Instale as dependências do frontend na pasta frontend e, em seguida, execute npm run dev

    npm install

Antes de usar

  • É necessário usar Python 3.12 ou superior.
  • Os testes de integração e a implantação exigem que o GenLayer Studio esteja em execução, localmente ou hospedado.
  • Para o frontend funcionar, é necessário definir o endereço de um contrato implantado no arquivo de ambiente.

Em coleções

Tópicos

Perguntas frequentes

O que é genlayer-project-boilerplate?
Boilerplate para criar contratos inteligentes na GenLayer, com um jogo de apostas em futebol como exemplo, além de testes, lint, CI e frontend em Next.js. Este repositório é um template inicial para criar um contrato inteligente na GenLayer. O exemplo é um jogo de apostas em futebol: os usuários preveem o vencedor de uma partida, e o contrato consulta o resultado posteriormente na BBC Sport, usa um LLM para extrair o placar e verifica o resultado pelo princípio da equivalência antes de atribuir pontos.
genlayer-project-boilerplate é gratuito? Qual é a licença?
genlayer-project-boilerplate é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
genlayer-project-boilerplate ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de genlayer-project-boilerplate foi em 9 de set. de 2026.
Para que posso usar genlayer-project-boilerplate?
Começar um novo projeto de contrato inteligente na GenLayer a partir de um exemplo funcional Aprender como o acesso à web e as chamadas a LLM são estruturados dentro de um contrato Configurar verificações de lint e CI para o código do contrato antes da implantação
Como instalar genlayer-project-boilerplate?
Instale o GenLayer CLI globalmente: npm install -g genlayer Crie um ambiente virtual do Python (Python 3.12 ou superior): python3 -m venv .venv Execute os testes rápidos em memória do modo direto (não é necessário usar o Studio): pytest tests/direct/ -v Instale as dependências do frontend na pasta frontend e, em seguida, execute npm run dev: npm install
Onde consigo genlayer-project-boilerplate?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/genlayerlabs/genlayer-project-boilerplate

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados