Metadata-Version: 2.4
Name: moonfun-sdk
Version: 1.0.7
Summary: Unified SDK for Meme Platform with triple-lock security
Home-page: https://github.com/example/moonfun-sdk
Author: Meme Platform Team
Author-email: dev@example.com
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: web3>=7.0.0
Requires-Dist: eth-account>=0.13.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# MoonfunSDK - Python

Unified SDK for Meme Platform with triple-lock security.

## Installation

```bash
pip install -r requirements.txt
```

Or install from source:

```bash
python setup.py install
```

## Quick Start

```python
from moonfun_sdk import MoonfunSDK
import os

# Initialize SDK
sdk = MoonfunSDK(
    private_key=os.getenv('PRIVATE_KEY'),
    image_api_url="https://your-api-url.com"
)

# Create Meme token
result = sdk.create_meme(prompt="A funny cat")
print(f"Token created: {result['token_address']}")

# Buy tokens
sdk.buy_token(token_address="0x...", bnb_amount=0.1)

# Sell tokens
balance = sdk.get_token_balance("0x...")
sdk.sell_token(token_address="0x...", amount=balance)
```

## Features

- **One-Click Meme Creation**: `create_meme()` handles entire flow
- **Triple-Lock Security**: Signature + Timestamp + Balance verification
- **Token Trading**: Buy and sell tokens with slippage protection
- **Comprehensive Error Handling**: Custom exceptions for all error cases
- **Type Hints**: Full type annotations for better IDE support

## Examples

See `examples/` directory:
- `example_create_meme.py` - Create a Meme token
- `example_trading.py` - Buy and sell tokens

## Documentation

- [Security Architecture](../../docs/SECURITY_ARCHITECTURE.md)
- [API Specification](../../docs/API_SPECIFICATION.md)
- [SDK Design](../../docs/SDK_DESIGN.md)

## License

MIT
