Agent skill · software engineering · aiskillstore
integration-tests
Write and run integration tests against a GenLayer environment.
Why this skill is useful
Adds specific commands and patterns for running integration tests in a GenLayer environment that the AI wouldn't reliably generate on its own.
What it needs
Requires genlayer-test, pytest, python installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Integration Tests Run contracts against a real GenLayer environment (GLSim, Studio, or testnet) with full consensus validation. Running Tests Always use -v -s for visible output during development. Test Pattern ACCEPTED and FINALIZED are transaction lifecycle states, not proof that contract execution succeeded. A transaction can be accepted and finalized with an execution error, and failed execution applies no state changes. For deploy transactions, failed execution means no contract is created. Always assert txexecutionsucceeded(receipt) before reading state, checking schema/code, or treating a missing contract as an infrastructure issue. Key Differences from Direct Mode Direct Mode Integration Tests --- --- --- Speed ~30ms ~seconds to minutes Server required No Yes (GLSim, Studio, or testnet) Consensus Leader only Full leader + validators Write methods Return values directly Return transaction receipts Read methods Return values directly Use .call() Mocking mockweb() / mockllm() Real web/LLM calls Write vs Read Calls Write methods (state-changing): Read methods (view-only): Configuration (gltest.config.yaml) Test Markers Environments GLSim (pip install genlayer-test[sim], glsim --port 4000 --validators 5) — lightweight, no Docker, ~1s startup. Runs Python natively, not in GenVM. Good for fast iteration. Studio local (genlayer up) — full GenVM, real consensus, Docker required. Validates runtime compatibility. studio.genlayer.com (StudioNet) — hosted Studio, no setup, rate-limited (see Common Issues). Gasless: no tokens required. Accounts with 0 GEN balance can deploy and run tests normally. Testnet Bradbury — real network, requires funded accounts. When to Use Integration Tests Validating consensus (leader + validators agree) Testing real web requests and LLM calls Pre-deployment smoke tests Verifying contract works in actual GenVM (not just Python runner) Direct mode should cover most logic testing. Use integration tests for final validation before deploying. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/integration-tests