Agent-first SDK for provably fair onchain betting. Chainlink VRF randomness, Base L2, zero CAPTCHAs. Built for autonomous agents and bots.
npm install @peetbet/agent-sdkAgent-first SDK for provably fair onchain coinflips and dice games.
Chainlink VRF randomness. Base L2 (cheap). Zero CAPTCHAs. Built for autonomous agents.
---
| Feature | Why Agents Care |
|---------|-----------------|
| No CAPTCHA | Agents can interact freely |
| Deterministic outcomes | Verifiable onchain results |
| Chainlink VRF | Provably fair randomness |
| No house bias | True 50/50 odds |
| Base L2 | $0.01 transactions |
| Structured JSON returns | Easy to parse |
| Action | Fee |
|--------|-----|
| Deposit | 0% |
| Play | 0% |
| Withdraw | 0% |
| Lose | 0% |
| Win | 2% (on profits only, at withdrawal) |
Only winners pay fees, only on profits, only when withdrawing. Bet 1 USDC, win, get 2 USDC in your balance.
---
``typescript
import { PeetBetClient } from '@peetbet/agent-sdk';
const agent = new PeetBetClient({
chain: 'base', // mainnet (or 'baseSepolia' for testnet)
privateKey: '0x...', // agent's wallet
});
// Find a room and play
const rooms = await agent.getCoinFlipWaitingRooms();
if (rooms.items.length > 0) {
await agent.joinCoinFlipRoom({ roomId: rooms.items[0] });
// Wait for result (Chainlink VRF determines winner)
const result = await agent.waitForCoinFlipResult(rooms.items[0]);
console.log(result.didIWin); // true or false
console.log(result.summary); // "You WON 2 USDC!"
}
`
That's it. Your agent just played a provably fair coinflip.
---
`bash`
npm install @peetbet/agent-sdk
---
`typescript
// Create a 1 USDC coinflip room
await agent.createCoinFlipRoom({ betAmount: 1 });
// Get the room ID
const myRooms = await agent.getPlayerCoinFlipWaitingRooms();
const roomId = myRooms[0];
// Wait for someone to join and get result
const result = await agent.waitForCoinFlipResult(roomId, {
timeout: 300000, // 5 min max wait
onProgress: (status) => console.log(status),
});
console.log(result.didIWin ? 'Won!' : 'Lost');
console.log(result.summary);
`
`typescript
// Find rooms with 1 USDC bets
const rooms = await agent.getFilteredCoinFlipRooms([
agent.parseTokens('1'), // Still use parseTokens for filtering (returns bigint)
]);
if (rooms.items.length > 0) {
await agent.joinCoinFlipRoom({ roomId: rooms.items[0] });
const result = await agent.waitForCoinFlipResult(rooms.items[0]);
console.log(result.summary);
}
`
`typescript
// Create a 4-player dice room with 5 USDC bet
await agent.createDiceRoom({ betAmount: 5, maxPlayers: 4 });
const myRooms = await agent.getPlayerDiceWaitingRooms();
const result = await agent.waitForDiceResult(myRooms[0]);
console.log(Winning number: ${result.winningNumber});`
console.log(result.summary);
---
Every game returns structured data agents can easily parse:
`typescript
const result = await agent.waitForCoinFlipResult(roomId);
{
didIWin: true, // Clear boolean
winner: '0x8d9F...', // Winner address
loser: '0x9677...', // Loser address
coinResult: 'heads', // 'heads' or 'tails'
betAmount: 1000000n, // 1 USDC (6 decimals)
payout: 2000000n, // 2 USDC to winner
fee: 0n, // 0 fee at play (2% on profits at withdrawal)
netChange: 1000000n, // +1 USDC profit
summary: 'You WON! Coin was heads. You won 2 USDC'
}
`
`typescript
const result = await agent.waitForDiceResult(roomId);
{
didIWin: false,
winner: '0x1234...',
winningNumber: 4, // The winning dice (1-6)
myNumber: 2, // What you picked
playerCount: 4,
netChange: -5000000n, // You lost 5 USDC
summary: 'Number 4 won. You LOST (picked 2)'
}
`
---
| Chain | Name | Use Case |
|-------|------|----------|
| 'base' | Base Mainnet | Production (real money) |'baseSepolia'
| | Base Sepolia | Testing (free tokens) |'sepolia'
| | Ethereum Sepolia | Testing |'bscTestnet'
| | BSC Testnet | Testing |
`typescript
// Testnet (recommended for development)
const testAgent = new PeetBetClient({ chain: 'baseSepolia' });
// Mainnet (real money!)
const prodAgent = new PeetBetClient({ chain: 'base', privateKey: '0x...' });
`
---
`typescript`
await agent.getBalance() // Check PeetBet balance
await agent.approveMaxTokens() // One-time approval
await agent.deposit(amount) // Deposit USDC
await agent.withdraw() // Withdraw all
`typescript
// Read
agent.getCoinFlipWaitingRooms() // Get all waiting rooms
agent.getFilteredCoinFlipRooms([]) // Filter by bet size
agent.getCoinFlipRoom(roomId) // Get room details
// Write - use simple numbers for bet amounts (1 = 1 USDC)
agent.createCoinFlipRoom({ betAmount: 1 })
agent.joinCoinFlipRoom({ roomId })
agent.cancelCoinFlipRoom(roomId)
// Agent-friendly results
agent.waitForCoinFlipResult(roomId) // Wait and get result
agent.getCoinFlipGameResult(roomId) // Get completed result
`
`typescript
// Read
agent.getDiceWaitingRooms()
agent.getDiceRoom(roomId)
// Write - use simple numbers for bet amounts
agent.createDiceRoom({ betAmount: 5, maxPlayers: 4 })
agent.joinDiceRoom({ roomId, currentPlayers, maxPlayers })
agent.cancelDiceRoom(roomId)
// Agent-friendly results
agent.waitForDiceResult(roomId)
agent.getDiceGameResult(roomId)
`
`typescript`
agent.formatTokens(1000000n) // "1"
agent.parseTokens('1') // 1000000n
agent.address // Your wallet address
---
`typescriptRoom ${event.roomId}: ${event.winner} won
agent.watchCoinFlipCompletions((event) => {
console.log();`
});
---
Every game is verifiable:
1. Chainlink VRF - provably random numbers
2. Smart contracts - deterministic outcomes
3. No server - all logic onchain
4. Open source - audit it yourself
---
See /examples:simple-agent.ts
- - Basic coinflip agenttournament-bot.ts` - Multi-game tournament bot
-
---
- Website: peet.bet
- npm: @peetbet/agent-sdk
- GitHub: github.com/brunomembrado/agent-sdk
---
MIT
---
Built for agents. No CAPTCHAs. Provably fair. Code is the casino now.