Metadata-Version: 2.4
Name: rollhub-dice
Version: 0.5.1
Summary: AI agent gambling API SDK — provably fair dice, crypto betting, zero-trust verification for autonomous agents. 99% RTP, 70+ chains.
Author-email: Rollhub <dev@rollhub.com>
License: MIT
Project-URL: Homepage, https://agent.rollhub.com
Project-URL: Documentation, https://agent.rollhub.com
Project-URL: Repository, https://github.com/rollhub/rollhub-dice-python
Project-URL: Issues, https://github.com/rollhub/rollhub-dice-python/issues
Keywords: dice,casino,gambling,ai,agent,provably-fair,crypto,ai-agent-gambling-api,crypto-betting-api,zero-trust-gambling,ai-agent-casino,autonomous-gambling-agent
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.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: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: cryptography>=3.4
Dynamic: license-file

# 🎲 rollhub-dice

[![PyPI version](https://img.shields.io/pypi/v/rollhub-dice)](https://pypi.org/project/rollhub-dice/)
[![Python](https://img.shields.io/pypi/pyversions/rollhub-dice)](https://pypi.org/project/rollhub-dice/)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

**The AI agent gambling API SDK for Python — provably fair dice, crypto betting, and zero-trust verification for autonomous agents.**

## What is this?

`rollhub-dice` is the core Python SDK for [Agent Casino](https://agent.rollhub.com), the first provably fair crypto betting API built specifically for AI agents. Every dice roll is cryptographically verified using SHA3-384 + AES-256-CTR commit-reveal, giving autonomous gambling agents zero-trust guarantees. Supports 70+ cryptocurrency chains for deposits and withdrawals with 99% RTP.

## Features

- **Provably fair dice gambling** for AI agents — every bet auto-verified client-side
- **Zero-trust gambling** — SHA3-384 + AES-256-CTR commit-reveal cryptographic proof
- **70+ cryptocurrency chains** for deposits and withdrawals (SOL, ETH, BTC, TRX, and more)
- **99% RTP**, 1% house edge, transparent math
- **30% affiliate earnings** on every bet by agents you refer — instant credit
- **AI agent earn money** — agents can gamble, verify, and earn affiliate revenue autonomously
- Typed responses, async-ready, lightweight with zero heavy dependencies

## Quick Start

```bash
pip install rollhub-dice
```

```python
from rollhub_dice import DiceAgent

agent = DiceAgent(api_key="your-key")
result = agent.bet(target=50, direction="over", amount=100)
print(f"Roll: {result.roll}, Won: {result.won}, Verified: {result.proof.verified}")
```

## Affiliate Program

Earn **30% of house edge** on every bet by agents you refer. This is the agent affiliate program — instant credit, no minimums, designed for autonomous agents to earn money by referring other AI agents.

## Full Ecosystem

| Package | Registry | Description |
|---------|----------|-------------|
| [rollhub-dice](https://pypi.org/project/rollhub-dice/) | PyPI | Core Python SDK for AI agent gambling API |
| [rollhub-dice](https://www.npmjs.com/package/rollhub-dice) | npm | Core JS/TS SDK for AI agent gambling API |
| [rollhub-dice-mcp](https://www.npmjs.com/package/rollhub-dice-mcp) | npm | MCP server for Claude Desktop & AI assistants |
| [langchain-rollhub](https://pypi.org/project/langchain-rollhub/) | PyPI | LangChain gambling tool for provably fair dice |
| [crewai-rollhub](https://pypi.org/project/crewai-rollhub/) | PyPI | CrewAI gambling tool for autonomous agents |
| [rollhub-openai-tools](https://www.npmjs.com/package/rollhub-openai-tools) | npm | OpenAI function calling gambling integration |
| [rollhub-ai-tools](https://www.npmjs.com/package/rollhub-ai-tools) | npm | Vercel AI SDK tools for agent casino |
| [eliza-rollhub](https://www.npmjs.com/package/eliza-rollhub) | npm | ElizaOS plugin for AI agent gambling |
| [autogpt-rollhub](https://pypi.org/project/autogpt-rollhub/) | PyPI | AutoGPT plugin for crypto betting |

## Links

- 🌐 **Landing page:** [agent.rollhub.com](https://agent.rollhub.com)
- 📖 **API docs:** [agent.rollhub.com](https://agent.rollhub.com) (scroll to API Reference)
