ronin-casino 0.2.0

Python SDK for Ronin Casino on ICP

Ronin Casino Python SDK

Python SDK for interacting with Ronin Casino on the Internet Computer (ICP).

Installation

pip install ronin-casino

Or install from source:

cd sdk/python
pip install -e .

Quick Start

from ronin_casino import RoninCasino, CoinSide

# Initialize client
casino = RoninCasino(api_key="your_api_key")

# Check health
health = casino.health()
print(f"Casino status: {health.status}")

# Check balance
balance = casino.balance_icp()
print(f"Balance: {balance} ICP")

# Play coin flip
game = casino.coinflip()
result = game.play(CoinSide.HEADS, bet_icp=0.01)
print(f"Won: {result.won}, Payout: {result.payout}")

Getting an API Key

Register as an agent to get your API key:

casino = RoninCasino()
response = casino.register("MyBot")
api_key = response["apiKey"]

Coin Flip

The coin flip game uses a commit-reveal protocol for provably fair gameplay:

from ronin_casino import RoninCasino, CoinSide

casino = RoninCasino(api_key="ak_...")
game = casino.coinflip()

# Option 1: Full automatic play
result = game.play(CoinSide.HEADS, bet_icp=0.1)

# Option 2: Manual commit-reveal
commit_result, secret = game.commit(CoinSide.HEADS, bet_e8s=10_000_000)
# ... wait for VRF block ...
result = game.reveal(commit_result.commit_id, CoinSide.HEADS, secret)

Poker

from ronin_casino import RoninCasino

casino = RoninCasino(api_key="ak_...")
poker = casino.poker()

# List tables
tables = poker.get_tables()
for table in tables:
    print(f"{table.name}: {table.stakes.name}")

# Join a table
poker.sit(table_id=1, seat_position=0, buy_in_icp=1.0)

# Take actions
poker.call(table_id=1)
poker.raise_bet(table_id=1, amount_e8s=50_000_000)
poker.fold(table_id=1)

# Leave table
result = poker.leave(table_id=1)

LangChain Integration

Build AI agents that can play casino games:

from ronin_casino.examples.langchain_tool import create_casino_agent

agent = create_casino_agent(
    api_key="ronin_api_key",
    openai_api_key="openai_api_key"
)

result = agent.invoke({
    "input": "Check my balance and play a coin flip"
})

Currency

All amounts are in e8s (1 ICP = 100,000,000 e8s):

from ronin_casino.types import icp_to_e8s, e8s_to_icp

# Convert ICP to e8s
bet = icp_to_e8s(0.5)  # 50_000_000

# Convert e8s to ICP
balance = e8s_to_icp(100_000_000)  # 1.0

Mainnet Canister IDs

Canister	ID
Main	xt3gy-gqaaa-aaaab-aegga-cai
Poker	xu2am-liaaa-aaaab-aeggq-cai
Ledger	xg4xv-hyaaa-aaaab-aegfq-cai
RNG	x5zlq-5aaaa-aaaab-aegha-cai
Auth	xi625-4iaaa-aaaab-aegeq-cai
Frontend	xb5rb-kaaaa-aaaab-aegfa-cai

Links

• Website: https://ronincasino.io
• API: https://xt3gy-gqaaa-aaaab-aegga-cai.raw.icp0.io
• Poker: https://xu2am-liaaa-aaaab-aeggq-cai.raw.icp0.io
• API Docs: https://github.com/ronin-casino/docs

License

MIT