🎲 rollhub-dice
The AI agent gambling API SDK for Python — provably fair dice & coinflip, crypto betting, and zero-trust verification for autonomous agents.
🎰 Agent Casino — The first provably fair crypto casino built for AI agents
What is this?
rollhub-dice is the core Python SDK for Agent Casino, 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 & coinflip 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, USDT, USDC...)
- 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
pip install rollhub-dice
from rollhub_dice import DiceAgent
agent = DiceAgent(api_key="your-key")
# Dice bet
result = agent.bet(target=50, direction="over", amount=100)
print(f"Roll: {result.roll}, Won: {result.won}, Verified: {result.proof.verified}")
# Coinflip
flip = agent.coinflip(side="heads", amount=50)
print(f"Result: {flip.side}, Won: {flip.won}")
🤖 Claude Desktop / MCP Integration
Use Agent Casino directly from Claude Desktop with rollhub-dice-mcp:
{
"mcpServers": {
"rollhub-dice": {
"command": "npx",
"args": ["-y", "rollhub-dice-mcp"],
"env": {
"ROLLHUB_API_KEY": "your-api-key"
}
}
}
}
🔗 LangChain Integration
pip install langchain-rollhub
from langchain_rollhub import RollhubDiceTool
tool = RollhubDiceTool(api_key="your-key")
# Use with any LangChain agent
💰 Affiliate Program — Earn Crypto with AI
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.
Use rollhub-affiliate-mcp for automated affiliate marketing via MCP.
Full Ecosystem
| Package | Registry | Description |
|---|---|---|
| rollhub-dice | PyPI | Core Python SDK for AI agent gambling API |
| rollhub-dice | npm | Core JS/TS SDK for AI agent gambling API |
| rollhub-dice-mcp | npm | MCP server casino for Claude Desktop & Cursor |
| rollhub-affiliate-mcp | npm | Affiliate marketing MCP server |
| langchain-rollhub | PyPI | LangChain gambling tool |
| crewai-rollhub | PyPI | CrewAI gambling tool |
| rollhub-openai-tools | npm | OpenAI function calling gambling |
| rollhub-ai-tools | npm | Vercel AI SDK tools |
| eliza-rollhub | npm | ElizaOS plugin |
| autogpt-rollhub | PyPI | AutoGPT plugin |
Keywords
AI agent gambling API, provably fair dice, crypto betting SDK, Python casino API, zero-trust verification, autonomous agent betting, Solana gambling, coinflip API, LangChain gambling, CrewAI casino, MCP server casino
Links
- 🌐 Website: agent.rollhub.com
- 📖 API docs: agent.rollhub.com (scroll to API Reference)
- 🎰 MCP Server: rollhub-dice-mcp
- 💰 Affiliate MCP: rollhub-affiliate-mcp
Metadata
Release files for rollhub-dice 0.7.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| rollhub_dice-0.7.1.tar.gz | 14.2 kB | Without provenance | Details for rollhub_dice-0.7.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| rollhub_dice-0.7.1-py3-none-any.whl | Python 3 | none | any | Details for rollhub_dice-0.7.1-py3-none-any.whl |
Total release size: 26.6 kB
Release files / rollhub_dice-0.7.1.tar.gz
| Download URL | rollhub_dice-0.7.1.tar.gz |
|---|---|
| Size | 14.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
45195f827794c531b8fc06e9893615015662209f20816c7ab22febd0489eeeca
|
|
BLAKE2b-256 checksum How to use checksums |
865093bcef10c854f1930c492893fc702b2833891321c11f3cca7e61581c629e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / rollhub_dice-0.7.1-py3-none-any.whl
| Download URL | rollhub_dice-0.7.1-py3-none-any.whl |
|---|---|
| Size | 12.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f77613e05e0930f2cc9dfbe369e11718bc6f7121d33d9eb2d0e92b37b366cea3
|
|
BLAKE2b-256 checksum How to use checksums |
2dc5da36692da86c0e14d02f6421163601cecb345d85fcd64edd33d679b08231
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Security for rollhub-dice 0.7.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.