Metadata-Version: 2.4
Name: paysponge
Version: 0.1.1
Summary: Python SDK for PaySponge
Author-email: PaySponge <team@paysponge.com>
License-Expression: MIT
Project-URL: Homepage, https://docs.paysponge.com
Project-URL: Documentation, https://docs.paysponge.com
Project-URL: Repository, https://github.com/paysponge/sponge
Project-URL: Issues, https://github.com/paysponge/sponge/issues
Keywords: PaySponge,SDK,payments,wallets,agents
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
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: Programming Language :: Python :: 3 :: Only
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: urllib3<3.0.0,>=2.1.0
Requires-Dist: python-dateutil>=2.8.2
Requires-Dist: pydantic>=2
Requires-Dist: typing-extensions>=4.7.1

# paysponge

Python SDK for PaySponge.

The `paysponge` package is a small first-class SDK surface for common wallet
and platform workflows.

## Install

```bash
cd mobwallet/python/paysponge
uv sync --group dev
```

## Quick Start

```python
from paysponge import SpongeWallet

wallet = SpongeWallet.connect(api_key="sponge_test_xxx")

agent = wallet.get_agent()
addresses = wallet.get_addresses()
balances = wallet.get_balances()
```

Platform/master-key usage:

```python
from paysponge import SpongePlatform

platform = SpongePlatform.connect(api_key="sponge_master_xxx")
agent = platform.create_agent(name="Hackathon Agent")
```

## Examples

- `examples/basic.py`
- `examples/transfer.py`
- `examples/basic_sdk.py`

Run them with `uv run` so they use the package environment:

```bash
cd mobwallet/python/paysponge
SPONGE_API_KEY=sponge_test_xxx uv run python examples/basic.py
SPONGE_API_KEY=sponge_test_xxx RECIPIENT_ADDRESS=0x... uv run python examples/transfer.py
```

## Tests

```bash
cd mobwallet/python/paysponge
uv run python -m unittest discover -s tests
```
