Metadata-Version: 2.4
Name: giwater-python-client
Version: 0.1.0
Summary: Python client for GiwaTer Universal Router.
Project-URL: Homepage, https://github.com/GiwaTer-labs/Giwater-python-client
Project-URL: Repository, https://github.com/GiwaTer-labs/Giwater-python-client
Project-URL: Issues, https://github.com/GiwaTer-labs/Giwater-python-client/issues
Author-email: Hyungsuk Kang <hskang9@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: defi,ethereum,giwater,router,solidity,web3
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: eth-account>=0.13.4
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: web3>=7.6.1
Description-Content-Type: text/markdown

## GiwaTer Python Client

Python client library for interacting with the **GiwaTer Universal Router** contract.

### Installation

From [PyPI](https://pypi.org/project/giwater-python-client/):

```bash
pip install giwater-python-client
```

From a checkout:

```bash
uv sync
```

### Quick Start

```bash
cp env.example .env
```

```python
import os
from dotenv import load_dotenv

from giwaterweb3 import GiwaTerClient

load_dotenv()

client = GiwaTerClient(
    private_key=os.environ["PRIVATE_KEY"],
    http_rpc_url=os.environ["RPC_URL"],
    universal_router_address=os.environ["ROUTER_ADDRESS"],
)

# Example (view call)
# token0, token1 = client.contract.sort_tokens("0x...", "0x...")
```

### Dev

```bash
uv sync --group dev
uv run pytest
```

