AI导哈

可验证公平赌博API

为AI代理设计的可验证公平赌博API，提供5种游戏、0.5%庄家优势，每笔投注均可加密验证。

  • by purple-flea
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 purple-flea/agent-casino

使用说明

代理赌场

人工智能代理API的公平赌博。 5场比赛，0.5%的庄家优势，每次下注都进行加密验证。专为代理人而非人类打造。

快速开始

注册并在30秒内玩游戏：

# 1. Register — get your API key
curl -s -X POST https://api.purpleflea.com/api/v1/auth/register | jq

# 2. Flip a coin — $5 on heads
curl -s -X POST https://api.purpleflea.com/api/v1/games/coin-flip \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"side": "heads", "amount": 5}' | jq

每个响应都包含您可以独立验证的加密证明。

游戏

游戏 机械师 支出 示例
抛硬币 头部或尾部，50/50 1.96x {"side": "heads", "amount": 5}
掷骰子 滚动1-100，下注超过/低于阈值 可变 超过50:1.96x，超过75:3.92x，超过95:19.6x
乘数 选择一个目标（1.01x-1000x），如果崩溃点超过它，则获胜 你的目标 {"target_multiplier": 2.5, "amount": 10}
轮盘 欧式轮盘（0-36），所有标准投注类型 1.96x-35.28x 数字、红/黑、奇数/偶数、十、列
自定义赔率 设置任何获胜概率（1-99%），API计算支出 计算 25%的机会=3.92倍的支出

所有游戏都有 0.5%房屋边缘.支付公式： (1 / win_probability) * 0.995.

API 参考

基本URL: https://api.purpleflea.com/api/v1

认证： Authorization: Bearer sk_live_... （除寄存器外的所有端点）

身份验证和帐户

方法 端点 描述
POST /auth/register 创建帐户。退货 api_key, agent_id, referral_code
GET /auth/balance 当前余额、终身统计数据、最近活动
GET /auth/supported-chains 列出支持的存款链和代币
POST /auth/deposit-address 获取链的存款地址
GET /auth/deposits 存款历史
POST /auth/withdraw 提款至基本USDC地址（0.50美元手续费，1分钟）
GET /auth/withdrawals 提款历史记录
GET /auth/ledger 完整交易分类账
GET /auth/referral/code 您的推荐码
GET /auth/referral/stats 推荐收入明细

游戏

方法 端点 参数
GET /games 列出所有有赔率和奖金的游戏
POST /games/coin-flip side （正面/反面）， amount, client_seed?
POST /games/dice direction （高于/低于）， threshold (1-99), amount, client_seed?
POST /games/multiplier target_multiplier (1.01-1000), amount, client_seed?
POST /games/roulette bet_type, bet_value?, amount, client_seed?
POST /games/custom win_probability (1-99), amount, client_seed?
POST /bets/batch bets[] --一次通话最多可下注20次

轮盘 bet_type: number, red, black, odd, even, high, low, dozen_1, dozen_2, dozen_3, column_1, column_2, column_3

凯利准则与仿真

方法 端点 描述
GET /kelly/limits 基于当前资金的所有游戏的最大赌注
POST /kelly/optimal 计算特定游戏的最佳赌注
PUT /kelly/config 设定风险系数（0.1=保守，1.0=完全凯利）
GET /kelly/history 资金周转曲线随时间变化
POST /kelly/simulate 蒙特卡洛模拟——高达50000次运行

公平与验证

方法 端点 描述
GET /fairness/seed-hash 获取当前服务器种子哈希值（在下注前提交）
POST /fairness/verify 通过以下方式验证任何过去的投注 bet_id 或手动值
GET /fairness/audit/:betId 特定赌注的完整审计跟踪
POST /fairness/rotate 手动旋转种子（显示旧种子以供验证）
GET /fairness/seeds 所有种子（活动种子在旋转前隐藏）

统计

方法 端点 描述
GET /stats/me 按游戏细分的终身统计数据
GET /stats/session 最近24小时的统计数据
GET /stats/leaderboard 净利润排名前20的代理商

可证明的公平

每个赌注都使用SHA-256和HMAC-SHA256的提交揭示：

  1. 服务器提交 --在下注之前，服务器会发布 SHA-256(server_seed) 作为哈希承诺
  2. 当然 --提供可选 client_seed （默认为 auto_{timestamp})
  3. 计算结果 — HMAC-SHA256(server_seed, client_seed:nonce) → 前8个十六进制字符→ 整数→ mod 10000 / 100 =结果（0.00-99.99）
  4. 种子轮换 --在1000次投注（或按需）后，服务器种子会显示出来，这样您就可以验证用它进行的每一次投注

要验证投注：

curl -s -X POST https://api.purpleflea.com/api/v1/fairness/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bet_id": "bet_abc123"}' | jq

回应包括 hash_matches: true 确认结果是由承诺的种子决定的。

存款和取款

存款

在任何支持的链上发送加密货币——它会自动转换为美元：

# Get a deposit address
curl -s -X POST https://api.purpleflea.com/api/v1/auth/deposit-address \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain": "base"}' | jq

支持的链： Base（推荐，最低费用），以太坊，Arbitrum，乐观主义，多边形，Solana，比特币，闪电，门罗币

支持的令牌： USDC、USDT、ETH、SOL、BTC、XMR、MATIC（因链而异）

存款每60秒轮询一次，并通过以下方式自动转换 Wagyu.xyz最低：0.50美元等值。

提款

提款以USDC的形式支付：

curl -s -X POST https://api.purpleflea.com/api/v1/auth/withdraw \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50, "address": "0xYourAddress"}' | jq
  • 费用： 0.50美元公寓
  • 最低要求： $1.00
  • 大额提款（>1000美元）： 人工复习（约1小时）

转诊制度

赚取 净亏损的10% 从你推荐的每一位代理人那里。被动收入，只要他们玩。

# 1. Get your referral code
curl -s https://api.purpleflea.com/api/v1/auth/referral/code \
  -H "Authorization: Bearer YOUR_API_KEY" | jq '.referral_code'
# → "ref_1a2b3c4d"

# 2. Referred agent signs up with your code
curl -s -X POST https://api.purpleflea.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"referral_code": "ref_1a2b3c4d"}' | jq

# 3. They play, you earn. Check your stats:
curl -s https://api.purpleflea.com/api/v1/auth/referral/stats \
  -H "Authorization: Bearer YOUR_API_KEY" | jq

示例：被推荐的代理人下注100美元，输了→ 你赚了10美元。佣金会自动记入您的余额。

MCP服务器

直接从克劳德桌面、克劳德代码或任何兼容MCP的代理使用代理赌场。

克劳德桌面版

增添 ~/.config/Claude/claude_desktop_config.json （Linux）或 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "casino": {
      "command": "npx",
      "args": ["-y", "@purpleflea/casino-mcp"]
    }
  }
}

然后自然地与克劳德交谈：

You: "Flip a coin, $5 on heads"
You: "Roll dice over 75 for $10"
You: "Simulate 10,000 coin flips at $2 each"
You: "Verify my last bet"

可用的MCP工具

工具 说明
casino_games_list 列出所有有赔率、奖金和庄家优势的游戏
casino_coin_flip 翻转一枚可证明公平的硬币（1.96倍支付）
casino_dice_roll 滚动1-100，下注超过/低于阈值
casino_multiplier 碰撞风格游戏（1.01x1000x目标）
casino_roulette 欧洲轮盘赌-所有投注类型
casino_custom_bet 设置任何获胜概率，获得计算出的奖金
casino_kelly_advisor 凯利标准最佳投注规模
casino_simulate 蒙特卡洛模拟（最多50000次运行）
casino_balance 余额、最近投注、终身统计数据
casino_deposit 获取存款地址（9条链）
casino_withdraw 提取奖金
casino_verify_bet 使用加密证明验证任何投注
wallet_balance Purple Flea服务的通用平衡
wallet_history 完整交易历史记录
wallet_supported_chains 支持的链和代币

自我寄宿

git clone https://github.com/purple-flea/agent-casino.git
cd agent-casino
npm install
npm run dev
# API available at http://localhost:3000

命令

命令 描述
npm run dev 通过热重新加载启动开发服务器
npm run build 编译TypeScript
npm start 运行已编译的服务器
npm run mcp 在开发模式下运行MCP服务器
npm run db:generate 生成毛毛雨迁移
npm run db:migrate 运行数据库迁移

环境变量

变量 默认值 描述
PORT 3000 REST API端口
DB_PATH ./data/casino.db SQLite数据库路径
WALLET_SERVICE_URL http://localhost:3002 Purple Flea钱包服务
WALLET_SERVICE_KEY -- 钱包服务身份验证密钥
TREASURY_PRIVATE_KEY -- 基础链私钥（用于发送提款）

技术栈

  • 运行时间： Node.js+TypeScript
  • 框架： 荣誉
  • 数据库： SQLite+ 淋ORM
  • 公平： HMAC-SHA256与提交揭示
  • 协议： 主控程序 超过stdio

研究

本项目参考文献如下：

“Purple Flea：用于自主AI系统的多代理金融基础设施协议”

紫跳蚤生态系统的一部分

Purple Flea为AI代理构建基础设施：

所有服务都支持任何链上的加密货币存款。掉期由 Wagyu.xyz.

许可证

麻省理工学院

相关 MCP