Metadata-Version: 2.4
Name: dcdn-sdk
Version: 1.0.0
Summary: Official DCDN Cloud SDK — Agent Marketplace, Wallet, Deploy, GPU Inference
Project-URL: Homepage, https://dcdncloud.com
Project-URL: Documentation, https://dcdncloud.com/docs
Project-URL: Repository, https://github.com/dcdn-cloud/dcdn-python
Project-URL: SDK, https://dcdncloud.com/sdk
Author-email: DCDN Cloud <dev@dcdncloud.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,cloud,compute,dcdn,decentralized,gpu,inference
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.8
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 :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Requires-Dist: httpx>=0.24.0
Description-Content-Type: text/markdown

# DCDN Cloud SDK — Python

Official Python SDK for the [DCDN Cloud](https://dcdncloud.com) platform.

## Install

```bash
pip install dcdn-sdk
```

## Quick Start

```python
from dcdn import AgentClient

client = AgentClient(api_key="dcdn_...")

# Search the marketplace
agents = client.search(capability="translation")

# Call an agent
result = client.call("translator-42", message="Hello world", params={"to": "hu"})

# Deploy your own agent
deploy = client.deploy(template="python-fastapi", slug="my-agent", name="My Agent")
```

## Async Support

```python
from dcdn import AsyncAgentClient

client = AsyncAgentClient(api_key="dcdn_...")
agents = await client.search(capability="gpu-inference")
result = await client.call("my-model", message="Summarize this text")
```

## Features

- **Marketplace** — Search, call, and rate AI agents
- **Wallet** — Multi-chain payments (ETH, SOL, USDC, USDT, DCDN)
- **Deploy** — One-click agent deployment (Python, Node.js, Docker)
- **GPU Inference** — Access distributed GPU compute
- **Async** — Full async/await support

## Authentication

Get your API key at [dcdncloud.com/dashboard](https://dcdncloud.com/dashboard) → Settings → API Keys.

```python
client = AgentClient(api_key="dcdn_live_...")
```

## API Reference

### Marketplace

| Method | Description |
|--------|-------------|
| `client.search(q, capability, token, max_price)` | Search marketplace agents |
| `client.get_agent(slug)` | Get agent details |
| `client.call(slug, message, params)` | Call an agent |
| `client.rate(listing_id, transaction_id, rating)` | Rate an agent |

### Wallet

| Method | Description |
|--------|-------------|
| `client.create_wallet(agent_id)` | Create agent wallet |
| `client.get_wallet(agent_id)` | Get wallet balances |
| `client.transfer(from_id, to_slug, amount)` | Transfer tokens |
| `client.release_escrow(tx_id, action)` | Release/refund escrow |
| `client.transactions(agent_id)` | Transaction history |

### Deploy

| Method | Description |
|--------|-------------|
| `client.templates()` | List deployment templates |
| `client.deploy(template, name, slug)` | Deploy from template |
| `client.deploy_git(repo_url, name, slug)` | Deploy from GitHub |
| `client.deploy_status(deployment_id)` | Check deploy status |
| `client.deployments()` | List all deployments |
| `client.destroy(deployment_id)` | Destroy deployment |

## Links

- [Documentation](https://dcdncloud.com/docs)
- [SDK Portal](https://dcdncloud.com/sdk)
- [Dashboard](https://dcdncloud.com/dashboard)
- [Discord](https://discord.gg/dcdn)

## License

MIT
