# Hunt Town Co-op — Agent Skill

Interact with the Hunt Town Co-op on Base using the `ht` CLI.

## Setup

```bash
npm install -g hunt.town-cli
```

Set your private key for write operations:
```bash
echo "PRIVATE_KEY=0x..." > ~/.hunttown/.env
```

## Commands

### Read Operations (no key needed)

```bash
ht projects                          # List all Co-op projects (symbol, reserve, price)
ht project <symbol>                  # Detailed project info (price, supply, royalties, updates)
ht project <symbol> --votes          # Include voting stats (today on-chain + 30-day API + rank)
ht stats                             # Co-op overview (HUNT price, TVL, daily rewards, voting activity)
ht leaderboard                       # Top projects ranked by HUNT reserve (TVL)
ht leaderboard -n 10                 # Show top 10 only
ht top-voted                         # Today's top voted projects (on-chain Voted events)
ht top-voted --period week           # This week's top voted (needs fast RPC)
ht top-voted --period month          # This month's top voted (needs fast RPC)
ht top-voted -n 10                   # Show top 10 only
ht updates                           # Recent builder updates across all projects
ht updates -p <symbol>               # Updates for a specific project
ht wallet                            # Wallet balances (ETH, HUNT, project tokens, USD values)
ht claimable                         # Check claimable HUNT from voting (all projects)
ht claimable -p <symbol>             # Check claimable for a specific project
ht royalty                           # Check accumulated HUNT royalties from bonding curves
```

### Write Operations (requires PRIVATE_KEY)

```bash
# Voting & Rewards
ht vote <symbol> <amount>            # Vote on a Co-op project (uses voting points)
ht claim <symbol>                    # Claim HUNT tokens from voting rewards
ht claim <symbol> -t <amount>        # Claim with specific token mint amount
ht claim <symbol> -d <bp>            # Claim with donation (basis points, e.g. 500 = 5%)
ht claim-royalty                     # Claim accumulated HUNT royalties from Bond contract

# Builder Operations
ht post-update <symbol> <link>       # Post a project update (burns HUNT)

# Project Creation (auto-generated hyperbolic bonding curve)
ht create-project --name "My Project" --symbol MYP                       # medium preset ($5K FDV), 100M supply, 1% royalty
ht create-project --name "My Project" --symbol MYP --preset small        # $1K initial FDV
ht create-project --name "My Project" --symbol MYP --preset large        # $30K initial FDV
ht create-project --name "My Project" --symbol MYP --fdv 10000           # custom $10K FDV target
ht create-project --name "My Project" --symbol MYP --max-supply 50000000 # 50M supply instead of 100M
ht create-project --name "My Project" --symbol MYP --mint-royalty 200 --burn-royalty 200  # 2% royalties

# Buy tokens with ETH or USDC via Zap
ht zap-mint <symbol> <amount>                # Buy tokens with ETH (default)
ht zap-mint <symbol> <amount> --from usdc    # Buy tokens with USDC
ht zap-mint <symbol> <amount> --slippage 2   # Custom slippage tolerance (%)
```

## Token Resolution

Use project symbols directly: `H1`, `ONCHAT`, `SIGNET`, `MT`, `HUNT`, etc.

## Environment

| Variable | Description |
|----------|-------------|
| `PRIVATE_KEY` | Wallet private key (stored in `~/.hunttown/.env`) |
| `RPC_URL` | Custom Base RPC endpoint (optional, uses public RPCs by default). Recommended for `top-voted --period week/month` |

## Notes

- All operations are on **Base** (chain 8453)
- HUNT is the reserve token for all Co-op projects
- Voting requires activated voting points (daily allocation via Hunt Town app)
- Project updates burn HUNT tokens (cost shown before confirming)
- Write operations prompt for confirmation before executing
- Zap operations default to 1% slippage
- Community: https://hunt.town