Install & Compatibility
Where this runs
tested against v6.0.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.234s · 18.2MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.6s · import 0.210s · 19MB
16MB installed
● package 16MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
TypeStr
✓ from eth_typing import TypeStr
HexStr
✓ from eth_typing.encoding import HexStr
Address
✓ from eth_typing.evm import Address
✗ from eth_typing import Address
Specific EVM-related types are found in submodules like `eth_typing.evm`.
ChecksumAddress
✓ from eth_typing.evm import ChecksumAddress
✗ from eth_typing.evm import HexAddress
Use `ChecksumAddress` for ERC-55 formatted addresses, `HexAddress` for general hex-encoded addresses. [9]
ABI
✓ from eth_typing.abi import ABI
✗ from eth_typing import ABI
ABI-related types are located in the `eth_typing.abi` submodule. [1, 9]
Demonstrates importing and using `Address`, `ChecksumAddress`, and `HexStr` for type hinting. This example simplifies address processing as `eth-typing` focuses solely on type definitions, not implementation logic.
from eth_typing.evm import Address, ChecksumAddress
from eth_typing.encoding import HexStr
def process_ethereum_address(address: Address) -> ChecksumAddress:
# In a real application, you would perform checksum validation
# or other address-related logic here.
# For this example, we'll just cast it for demonstration.
# eth-utils or web3.py typically handle checksumming.
if not isinstance(address, str) or not address.startswith('0x'):
raise ValueError('Invalid address format')
# Simulate a checksummed address return
return ChecksumAddress(address.lower()) # Simplified for quickstart
my_raw_address: Address = Address('0x742d35Cc6634C0532925a3b844Bc454e4438f444')
checksum_addr: ChecksumAddress = process_ethereum_address(my_raw_address)
print(f'Processed Address: {checksum_addr}')
def get_hex_string_length(hex_str: HexStr) -> int:
return len(hex_str)
my_hex_string: HexStr = HexStr('0xabcdef123456')
print(f'Hex string length: {get_hex_string_length(my_hex_string)}')
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'eth_typing'
The 'eth-typing' library is not installed in your Python environment, or there's an issue with the installation, often due to missing C++ build tools on Windows.
fixRun `pip install eth-typing` to install the library. On Windows, if this fails, you may need to install 'Microsoft C++ Build Tools' for Python to compile certain dependencies.
ImportError: cannot import name 'X' from 'eth_typing'
The specific type 'X' you are trying to import from 'eth_typing' has either been renamed, moved to a different submodule, or removed in the installed version of the library (e.g., due to API changes between major versions). For example, `ContractName` was moved in a past update.
fixCheck the `eth-typing` documentation (for version 6.0.0 or your installed version) to find the correct import path or the new name for the type. You might need to import from a submodule like `eth_typing.evm` or `eth_typing.abi`, or use an updated type name. If migrating from older versions, pin `eth-typing` to a compatible version or update your code to match the new API.
ERROR: <package_name> has requirement eth-typing<X,>=Y, but you'll have eth-typing Z which is incompatible.
This error indicates a dependency conflict where another installed library (`<package_name>`) requires a different version range of `eth-typing` than what is currently installed or being attempted to install, leading to an incompatible package environment.
fixUpgrade the conflicting packages to compatible versions using `pip install --upgrade <package_name> eth-typing` or explicitly specify compatible versions for all conflicting libraries in your `requirements.txt` file (e.g., `eth-typing==Z`, `eth-utils==A`). Consider using a virtual environment to manage dependencies for different projects.
Web3.py only accepts checksum addresses. The software that gave you this non-checksum address should be considered unsafe, please file it as a bug on their platform. Try using an ENS name instead. Or, if you must accept lower safety, use Web3.toChecksumAddress(lower_case_address).
You are attempting to use an Ethereum address string that is not a checksummed address (as defined by EIP-55) with `web3.py`. `web3.py` (which relies on `eth-typing` for address types) enforces checksumming to prevent common typos and increase safety.
fixConvert the non-checksummed address to a checksummed address using `Web3.toChecksumAddress()` before passing it to `web3.py` functions. Example: `from web3 import Web3; w3 = Web3(Web3.HTTPProvider('http://localhost:8545')); checksum_address = w3.toChecksumAddress('0x06012c8cf97bead5deae237070f9587f8e7a266d')`. Upgrade
Version history
6.0.0latest on PyPI · released Mar 25, 2026
Audit
Dependencies
No dependency data recorded yet.