Metadata-Version: 2.4
Name: borreguil
Version: 0.1.0
Summary: Add your description here
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.28.1
Requires-Dist: orjson<4,>=3.10
Requires-Dist: eth-utils>=5
Requires-Dist: eth-typing>=5
Requires-Dist: pycryptodome

# web3o

A lightweight, fast Python library for Ethereum JSON-RPC. Built as a minimal alternative to web3.py with low overhead and a small, explicit API.

## Install

```bash
pip install web3o
```

## Usage

```python
from web3o.provider import HttpProvider
from web3o.contract import Contract

provider = HttpProvider("https://eth.llamarpc.com")

# Query chain state
block_number = provider.get_block_number()

# Call a contract
usdc = Contract(address="0xA0b...", abi=ABI, provider=provider)
response = usdc.functions.balanceOf("0x...").call()
```

## Why web3o

- **Minimal**: No middleware stacks or heavy abstractions, just direct JSON-RPC wrappers.
- **Fast**: Low per-call overhead; uses `orjson` and `httpx` under the hood.
- **Typed**: Modern Python 3.11+ type hints throughout.
- **Small API surface**: Easy to learn and maintain.

## Documentation

See [docs/](docs/docs/intro.md) for the full guide and [examples/](examples/) for runnable snippets.
