Skip to main content

🎲 rollhub-dice

PyPI version npm version Python License: MIT MCP Compatible

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

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)

Source distribution for rollhub-dice 0.7.1
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)

Table of built distributions (wheels) for rollhub-dice 0.7.1
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page