# 🎲 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)
