Integration Tests

Integration Tests

Use this skill when contract behavior must be checked against a real GenLayer environment such as hosted Studio, local Studio, or a testnet.

The routine Python suite in this repo is direct-mode pytest under test/. There is currently no committed gltest.config.yaml or tests/integration/ scaffold. Do not invent one for routine verification unless the user asks for live integration coverage.

Current Repo Defaults

• Contract sources: intelligent-contracts/
• Factory deploy package: scripts/
• Hosted Studio RPC default: https://studio.genlayer.com/api
• Root app RPC envs: GENLAYER_RPC_URL and NEXT_PUBLIC_GENLAYER_RPC_URL
• Registry envs: IC_REGISTRY_ADDRESS and NEXT_PUBLIC_IC_REGISTRY_ADDRESS

Live Smoke Test Options

Deploy the registry factory only when the user intends to write on-chain state:

cd scripts && npm install && cp .env.example .env && npm run deploy

Use the root Next app to exercise live create/resolve flows after env vars are configured:

npm run dev

Manual live checks:

• / creates a valid oracle config and calls /api/bridge/deploy-intelligent-oracle.
• /explorer reads registry oracles through NEXT_PUBLIC_GENLAYER_RPC_URL.
• /oracle/[address] reads get_dict, polls transactions, and calls resolve.

Optional gltest Scaffold

Only add gltest integration tests when explicitly requested. If added, keep them separate from direct tests, for example:

tests/integration/
  test_oracle_live_flow.py
gltest.config.yaml

The config should point contract_path at intelligent-contracts/, not a generic contracts/ folder.

Example shape:

contract_path: intelligent-contracts/

networks:
  studionet: {}
  localnet: {}

Run with visible output:

gltest tests/integration/ -v -s --network studionet

When Live Tests Are Worth It

• Consensus validation involving leader and validators.
• Real web requests and LLM calls inside IntelligentOracle.resolve.
• Pre-deployment smoke tests.
• Verifying the deployed registry and oracle ABI consumed by the Next UI.

Direct mode should cover most deterministic logic. Live tests are slower and can depend on external services, so keep them intentional.