Repolode
genlayerlabs

genlayerlabs/genlayer-project-boilerplate

Plantilla para crear contratos inteligentes de GenLayer, con un juego de apuestas de fútbol como ejemplo, pruebas, linting, CI y un frontend con Next.js.

Estrellas
19,307
Forks
937
Issues abiertos
38
Último commit
hace 2 meses

¿Qué es?

Este repositorio es una plantilla inicial para crear un contrato inteligente en GenLayer. El ejemplo es un juego de apuestas de fútbol: los usuarios predicen el ganador de un partido y, más adelante, el contrato obtiene el resultado de BBC Sport, usa un LLM para extraer el marcador y comprueba el resultado mediante el principio de equivalencia antes de otorgar puntos.

La plantilla cubre todo el ciclo de desarrollo. Un linter de GenVM comprueba los contratos de Python para detectar imports no permitidos, llamadas no deterministas y tipos de almacenamiento no válidos antes del despliegue. Las pruebas directas rápidas en memoria usan mocks para las llamadas web y al LLM, mientras que las pruebas de integración se ejecutan en GenLayer Studio. Un workflow de GitHub Actions ejecuta el linting y las pruebas directas.

Un frontend con Next.js 15, creado con TypeScript, TanStack Query y Radix UI, se conecta al contrato desplegado mediante una variable de entorno. Se incluyen scripts de despliegue y un archivo de configuración de red.

Funciones clave

  • 01Contrato inteligente de ejemplo que obtiene datos de la web y llama a un LLM
  • 02Linter estático que detecta código no determinista y tipos de almacenamiento no válidos
  • 03Pruebas directas en memoria con mocks para las respuestas web y del LLM
  • 04Pruebas de integración ejecutadas en GenLayer Studio
  • 05CI con GitHub Actions para el linting y las pruebas directas
  • 06Frontend con Next.js 15, TypeScript, TanStack Query y Radix UI

Casos de uso

  • Iniciar un proyecto de contrato inteligente de GenLayer a partir de un ejemplo funcional
  • Aprender cómo se estructuran el acceso a la web y las llamadas a un LLM dentro de un contrato
  • Configurar el linting y las comprobaciones de CI para el código del contrato antes del despliegue

Inicio rápido

  1. 1

    Instala GenLayer CLI de forma global

    npm install -g genlayer
  2. 2

    Crea un entorno virtual de Python (Python 3.12 o posterior)

    python3 -m venv .venv
  3. 3

    Ejecuta las pruebas rápidas en memoria del modo directo (no necesitas Studio)

    pytest tests/direct/ -v
  4. 4

    Instala las dependencias del frontend en la carpeta frontend y luego ejecuta npm run dev

    npm install

Antes de usarlo

  • Se requiere Python 3.12 o posterior.
  • Las pruebas de integración y el despliegue requieren que GenLayer Studio esté en ejecución, ya sea en local o alojado.
  • Para que el frontend funcione, debes configurar en su archivo de entorno la dirección de un contrato desplegado.

En colecciones

Temas

Preguntas frecuentes

¿Qué es genlayer-project-boilerplate?
Plantilla para crear contratos inteligentes de GenLayer, con un juego de apuestas de fútbol como ejemplo, pruebas, linting, CI y un frontend con Next.js. Este repositorio es una plantilla inicial para crear un contrato inteligente en GenLayer. El ejemplo es un juego de apuestas de fútbol: los usuarios predicen el ganador de un partido y, más adelante, el contrato obtiene el resultado de BBC Sport, usa un LLM para extraer el marcador y comprueba el resultado mediante el principio de equivalencia antes de otorgar puntos.
¿genlayer-project-boilerplate es gratuito? ¿Qué licencia tiene?
genlayer-project-boilerplate es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿genlayer-project-boilerplate sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de genlayer-project-boilerplate fue el 9 sept 2026.
¿Para qué puedo usar genlayer-project-boilerplate?
Iniciar un proyecto de contrato inteligente de GenLayer a partir de un ejemplo funcional Aprender cómo se estructuran el acceso a la web y las llamadas a un LLM dentro de un contrato Configurar el linting y las comprobaciones de CI para el código del contrato antes del despliegue
¿Cómo se instala genlayer-project-boilerplate?
Instala GenLayer CLI de forma global: npm install -g genlayer Crea un entorno virtual de Python (Python 3.12 o posterior): python3 -m venv .venv Ejecuta las pruebas rápidas en memoria del modo directo (no necesitas Studio): pytest tests/direct/ -v Instala las dependencias del frontend en la carpeta frontend y luego ejecuta npm run dev: npm install
¿Dónde consigo genlayer-project-boilerplate?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/genlayerlabs/genlayer-project-boilerplate

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados