Metadata-Version: 2.4
Name: rosud
Version: 0.1.0
Summary: Rosud Python SDK - AI 에이전트 자율 USDC 결제 인프라
Project-URL: Homepage, https://rosud.com
Project-URL: Documentation, https://docs.rosud.com
Project-URL: Repository, https://github.com/rosud-com/rosud-python
Project-URL: Issues, https://github.com/rosud-com/rosud-python/issues
Author-email: Rosud Team <team@rosud.com>
License: MIT
Keywords: agents,ai,payments,stablecoin,usdc,web3
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: autogen
Requires-Dist: pyautogen>=0.2.0; extra == 'autogen'
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: respx>=0.20.0; extra == 'dev'
Provides-Extra: langchain
Requires-Dist: langchain>=0.1.0; extra == 'langchain'
Description-Content-Type: text/markdown

# rosud · Python SDK

> AI agent USDC payment infrastructure — Official Python SDK

```bash
pip install rosud
```

## Quick Start

```python
import rosud

client = rosud.Rosud(api_key="rosud_live_xxx")
# or set ROSUD_API_KEY environment variable

# Create a payment
payment = client.payments.create(
    amount=5.00,
    to="0x742d35Cc6634C0532925a3b8D4C9E3Ff9C4A6bB",
    memo="api_call_fee",
)
print(payment.status)   # "confirmed"
print(payment.tx_hash)  # "0x..."

# Check balance
balance = client.wallets.balance()
print(f"Balance: {balance.usdc} USDC")
```

## Async

```python
import asyncio
import rosud

async def main():
    client = rosud.AsyncRosud(api_key="rosud_live_xxx")
    payment = await client.payments.create(amount=1.00, to="0x...")
    await client.close()

asyncio.run(main())
```

## Resources

- **Payments** — `client.payments.create()`, `.list()`, `.get()`
- **Agents** — `client.agents.create()`, `.list()`, `.get()`, `.delete()`
- **Wallets** — `client.wallets.balance()`
- **Webhooks** — `client.webhooks.create()`, `.list()`, `.delete()`

## Error Handling

```python
from rosud.exceptions import RosudAPIError, RosudAuthError

try:
    payment = client.payments.create(amount=5.00, to="0x...")
except RosudAuthError:
    print("Invalid API key")
except RosudAPIError as e:
    print(e.status_code, e.message)
```

## Links

- [Dashboard](https://rosud.com/dashboard)
- [API Docs](https://rosud.com/docs)
- [TypeScript SDK](https://www.npmjs.com/package/rosud)
- [MCP Server](https://pypi.org/project/rosud-mcp)
