Metadata-Version: 2.4
Name: gonka-wallet
Version: 0.1.0
Summary: Gonka wallet library for the Gonka chain
Author: raferti
License-Expression: MIT
Project-URL: Repository, https://github.com/raferti/gonka-wallet
Keywords: cosmos,blockchain,wallet,gonka
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mnemonic
Requires-Dist: bip_utils
Requires-Dist: bech32
Requires-Dist: pycryptodome
Requires-Dist: httpx
Requires-Dist: betterproto
Requires-Dist: ecdsa
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Dynamic: license-file

# gonka-wallet

Wallet library for the Gonka chain. Offline key management, transaction building, and network queries.

## Installation

```bash
pip install gonka-wallet
```

## Quick Start

```python
from gonka_wallet import Wallet, GonkaClient, DEFAULT_CHAIN_CONFIG

# Create a new wallet (offline, no network)
wallet = Wallet.create_new()
print(wallet.address)
print(wallet.mnemonic)

# Restore from mnemonic
wallet = Wallet.from_mnemonic("your 24 word mnemonic phrase ...")

# Query balance
with GonkaClient(DEFAULT_CHAIN_CONFIG) as client:
    balance = client.balance(wallet.address)
    print(balance.balances)
```

## Features

- **Offline wallet** — create, restore from mnemonic or private key
- **Transaction builder** — build and sign Cosmos SDK transactions
- **Network client** — balance queries, transaction broadcasting, vesting queries
- **Encrypted storage** — AES-256-GCM wallet encryption with password
- **No external key servers** — all cryptography runs locally

## Development

```bash
pip install -e ".[dev]"
pytest
```

## License

MIT
