# autogpt-rollhub

AutoGPT plugin for **Agent Casino** ([RollHub](https://agent.rollhub.com)) — provably fair dice betting.

## Commands

| Command | Description |
|---|---|
| `rollhub_bet` | Place a provably fair dice bet |
| `rollhub_verify` | Verify a bet's cryptographic proof |
| `rollhub_balance` | Check account balance |
| `rollhub_affiliate_stats` | View affiliate earnings |
| `rollhub_deposit_address` | Get a deposit address |
| `rollhub_withdraw` | Withdraw funds to external wallet |

## Setup

### 1. Install

```bash
pip install autogpt-rollhub
```

Or clone directly into your AutoGPT `plugins/` directory:

```bash
cd /path/to/AutoGPT/plugins
git clone https://github.com/rollhub-dev/autogpt-rollhub.git
```

### 2. Configure

Add to your `.env`:

```env
ROLLHUB_API_KEY=your_api_key_here
# Optional: override API base URL
# ROLLHUB_API_URL=https://agent.rollhub.com/api/v1
```

### 3. Enable

Add to `plugins_config.yaml`:

```yaml
AutoGPTRollHub:
  config: {}
  enabled: true
```

Or via `.env`:

```env
ALLOWLISTED_PLUGINS=AutoGPTRollHub
```

## API Reference

All commands interact with the [Agent Casino API](https://agent.rollhub.com/api/v1).

### rollhub_bet

Place a dice bet with parameters:
- `amount` — Bet size (e.g. `"0.001"`)
- `currency` — `BTC`, `ETH`, `USDT`, etc.
- `target` — Number 1-99
- `over` — `"true"` = bet over target, `"false"` = under

### rollhub_verify

Verify provably fair proof for a bet:
- `bet_id` — The bet ID to verify

### rollhub_balance

Check balance. Optional `currency` filter.

### rollhub_affiliate_stats

No parameters. Returns affiliate earnings summary.

### rollhub_deposit_address

Get deposit address:
- `currency` — Currency code

### rollhub_withdraw

Withdraw funds:
- `amount` — Amount to withdraw
- `currency` — Currency code
- `address` — Destination wallet address

## License

MIT
