Omnichain

Omnichain-py is a python library for humans and AI Agents to interact with all blockchain networks

Supported Blockchain Networks

• EVM
• UTXO (Bitcoin and bit-like networks)
• Solana
• Sui
• Stellar
• XRP Ledger
• Tron
• TON

Installation

pip install omnichain

Development

This project uses Hatch for environment, build, and publish management.

# install hatch (once)
pip install hatch

# run tests inside the managed environment
hatch run test

# build sdist + wheel into ./dist
hatch build

# bump version (edits src/omnichain/__init__.py)
hatch version patch   # or: minor / major / "1.2.3"

# publish to PyPI (needs HATCH_INDEX_USER / HATCH_INDEX_AUTH or ~/.pypirc)
hatch publish

Running tests

The default Hatch environment defines test = "pytest {args:tests}", so any arguments after hatch run test are forwarded to pytest.

# run the entire test suite
hatch run test

# run a specific file
hatch run test tests/impl/evm/test_evm_chain_e2e.py
hatch run test tests/impl/solana/test_solana_chain_e2e.py

# run a single class
hatch run test tests/impl/evm/test_evm_chain_e2e.py::TestEvmChains
hatch run test tests/impl/solana/test_solana_chain_e2e.py::TestSolanaChainGenesisHash

# run a single parametrized case (quote because of the brackets)
hatch run test "tests/impl/evm/test_evm_chain_e2e.py::TestEvmChains::test_asset_symbol_and_decimals_match_chain[ETHEREUM_USDC]"
hatch run test "tests/impl/solana/test_solana_chain_e2e.py::TestSolanaChainGenesisHash::test_asset_symbol_and_decimals_match_chain[SOLANA_MAINNET_USDC]"

# forward extra pytest flags
hatch run test tests/impl/solana/test_solana_chain_e2e.py -k genesis_hash -x -s

# one-off invocation without the script alias
hatch run pytest tests/impl/solana/test_solana_chain_e2e.py

# drop into the env shell and run pytest directly
hatch shell
pytest tests/impl/evm/test_evm_chain_e2e.py

Running groups of tests by marker

pytest.ini registers markers for both the kind of test (unit, integration, e2e) and the network it exercises (evm, solana, stellar, sui, sui_graphql, tron, xrpl). Use -m to select tests by marker:

# run all unit / integration / e2e tests
hatch run test -m unit
hatch run test -m integration
hatch run test -m e2e

# run all tests for a specific network
hatch run test -m evm
hatch run test -m solana
hatch run test -m sui_graphql

# combine markers with boolean expressions
hatch run test -m "e2e and evm"            # only EVM e2e tests
hatch run test -m "unit or integration"    # everything except e2e
hatch run test -m "evm and not e2e"        # EVM unit + integration only
hatch run test -m "e2e and (solana or sui)"

# chain a marker selection with a name filter and a path
hatch run test tests/impl/evm -m e2e -k genesis_hash

E2E tests load tests/.test.env themselves via python-dotenv, so Hatch needs no extra config — just populate tests/.test.env with the RPC URLs and TEST_1_MNEMONIC / TEST_2_MNEMONIC you want to exercise. Tests whose required env vars are missing are skipped automatically.

License

MIT — see LICENSE.