API References
GenLayer Test
glsim

glsim — Local GenLayer Network

A lightweight single-process GenLayer network that runs contracts via direct mode. Supports real LLM and web calls without Docker or WASM.

Installation

pip install genlayer-test[sim]

Usage

# Start with defaults (port 4000, 5 validators)
glsim
 
# Custom configuration
glsim --port 8000 --validators 3 --llm-provider openai:gpt-4o
 
# Deterministic mode (reproducible addresses)
glsim --seed my-test-seed

CLI Options

OptionDefaultDescription
--port4000RPC server port
--host127.0.0.1Bind address
--validators5Number of validators
--max-rotations3Max leader rotations
--chain-id61127Network chain ID
--llm-providerNoneLLM provider:model (e.g., openai:gpt-4o)
--no-browserfalseUse httpx instead of Playwright for web
--seedNoneDeterministic seed for addresses
-v, --verbosefalseVerbose logging

JSON-RPC Methods

glsim exposes a JSON-RPC 2.0 endpoint at POST /api compatible with both GenLayer Studio and standard Ethereum methods:

GenLayer Methods

  • gen_call — Call a contract method
  • gen_get_contract_schema — Get contract schema
  • gen_get_contract_schema_for_code — Get schema from code
  • gen_get_transaction_status — Get transaction status

Simulator Methods

  • sim_deploy — Deploy a contract
  • sim_call — Call a contract method
  • sim_read — Read contract state
  • sim_fund_account — Fund an account
  • sim_get_balance — Get account balance
  • sim_create_snapshot — Create state snapshot
  • sim_restore_snapshot — Restore snapshot
  • sim_install_mocks — Install web/LLM mocks
  • sim_get_mocks — Get current mocks
  • sim_increase_time — Advance time (Anvil-style)
  • sim_set_time — Set time to specific datetime

Ethereum Compatible

  • eth_chainId, eth_blockNumber, eth_getBalance
  • eth_getTransactionReceipt, eth_getTransactionByHash
  • eth_estimateGas, eth_gasPrice, eth_sendRawTransaction
Direct ModeIndex