Testing

Xian provides ContractingClient -- a local testing environment that lets you submit, execute, and inspect contracts without running a full node. It simulates the on-chain runtime with an in-memory state database.

How It Works

ContractingClient spins up a local instance of the Xian contract executor. You submit contracts as Python functions, call their exported functions, and inspect state changes -- all in a standard Python test file.

from contracting.client import ContractingClient

client = ContractingClient()
client.flush()  # clear all state

# Submit a contract
client.submit(my_contract_func, name="con_my_contract")

# Get a handle and call functions
contract = client.get_contract("con_my_contract")
contract.transfer(to="bob", amount=100)

Quick Links

• Unit Testing -- full guide to setting up tests with ContractingClient
• Return Values & Events -- inspecting function outputs and emitted events
• Multi-Contract Testing -- testing contracts that import each other
• Stamp Costs -- measuring gas consumption in tests

Installation

pip install xian-contracting

This gives you access to ContractingClient, the linter, and all runtime primitives (Hash, Variable, ctx, etc.).