hydrex

What this skill does

# Hydrex

Participate in Hydrex governance on Base. Lock HYDX to receive voting power, vote on liquidity pool strategies to direct emissions and rewards, deposit single-sided into auto-managed vaults to earn oHYDX yields, and claim oHYDX rewards from incentive campaigns.

## Quick Start

### Check Voting Power

```
What's my Hydrex voting power?
```

### Lock HYDX for Voting Power

```
Lock 1000 HYDX on Hydrex with rolling lock
```

### Vote on Pools

```
Vote optimally on Hydrex to maximize fees
```

```
Vote 50/50 on HYDX/USDC and cbBTC/WETH on Hydrex
```

### Single-Sided Liquidity

```
What single-sided liquidity vaults can I deposit BNKR into on Hydrex?
```

```
Deposit 500 BNKR into the BNKR/WETH single-sided vault on Hydrex
```

### Rewards

```
Check my Hydrex rewards
```

```
Claim my Hydrex oHYDX rewards
```

```
Convert my oHYDX to veHYDX on Hydrex
```

## Core Capabilities

### Locking HYDX

- Lock HYDX to receive veHYDX (vote-escrowed HYDX)
- Receive an NFT representing your locked position
- Gain voting power starting next epoch
- Rolling locks (Type 1) provide maximum voting power
- Auto-extends to maintain 2-year lock with no manual management
- Earning power = 1.3x voting power for fee distributions

**Reference**: [references/locking.md](references/locking.md)

### Voting on Pools

- Vote to allocate voting power across liquidity pools
- Direct HYDX emissions based on your votes
- Earn fees from supported pools
- Optimize for maximum fee returns
- Natural language voting by pool name

**Reference**: [references/voting.md](references/voting.md)

### Single-Sided Liquidity (ICHI Vaults)

- Deposit a single token into an auto-managed vault
- Earn oHYDX yields on your deposited value
- Vault manages both sides of the liquidity position
- Withdraw with up to 70/30 split (deposit token / counter token)
- No need to source both sides of a pair

**Reference**: [references/single-sided-liquidity.md](references/single-sided-liquidity.md)

### Claiming and Managing Rewards

- Check unclaimed oHYDX across all incentive campaigns
- Claim all eligible rewards in a single transaction
- Convert oHYDX into a veHYDX lock position via `exerciseVe`
- Exercising oHYDX requires a discounted ETH payment and produces a rolling veHYDX lock

**Reference**: [references/rewards.md](references/rewards.md)

## Contracts (Base Mainnet)

| Contract               | Address                                      |
| ---------------------- | -------------------------------------------- |
| HYDX Token             | `0x00000e7efa313F4E11Bfff432471eD9423AC6B30` |
| veHYDX (Voting Escrow) | `0x25B2ED7149fb8A05f6eF9407d9c8F878f59cd1e1` |
| Voter                  | `0xc69E3eF39E3fFBcE2A1c570f8d3ADF76909ef17b` |
| Vault Deposit Guard    | `0x9A0EBEc47c85fD30F1fdc90F57d2b178e84DC8d8` |
| Vault Deployer         | `0x7d11De61c219b70428Bb3199F0DD88bA9E76bfEE` |
| Incentive Distributor  | `0x8604d646df5A15074876fc2825CfeE306473dD45` |
| oHYDX Token            | `0xA1136031150E50B015b41f1ca6B2e99e49D8cB78` |

## Pool Information API

Get current liquidity pool data:

```bash
bankr agent "What are the top Hydrex pools by projected fees?"
bankr agent "Show me all Hydrex liquidity pools with their voting weights"
```

**Key fields for voting optimization:**

- `address` — Pool address (voting target)
- `title` — Pool name (e.g., "HYDX/USDC")
- `gauge.projectedFeeInUsd` — **Primary optimization metric**
- `gauge.liveVotingWeight` — Current competition for fees
- `gauge.votingAprProjection` — Expected APR from voting

**Efficiency formula**: `projectedFeeInUsd / liveVotingWeight` = fee revenue per vote

## Common Workflows

### First-Time Setup

1. **Get HYDX** — Acquire HYDX tokens on Base
2. **Approve HYDX** — Approve veHYDX contract to spend HYDX
3. **Lock HYDX** — Create rolling lock (Type 1) for voting power
4. **Wait for epoch** — Voting power activates next epoch (~weekly)
5. **Vote** — Allocate voting power to pools

**Example:**

```
# Step 1: Check HYDX balance
"What's my HYDX balance on Base?"

# Step 2 & 3: Approve and lock in one go
"Lock 1000 HYDX on Hydrex with rolling lock"

# Step 4: Wait for next epoch (typically next Thursday 00:00 UTC)

# Step 5: Vote optimally
"Vote optimally on Hydrex to maximize fees"
```

### Optimized Voting

When you want maximum returns:

```
Vote optimally on Hydrex to maximize my fee earnings
```

Bankr will:

1. Fetch all pools from API
2. Calculate efficiency (fees per vote) for each pool
3. Rank pools by efficiency
4. Allocate votes to top pools
5. Execute vote transaction

### Named Pool Voting

Vote by pool name instead of addresses:

```
Vote 100% on HYDX/USDC on Hydrex
```

```
Vote 60% on HYDX/USDC and 40% on cbBTC/WETH on Hydrex
```

```
Vote 33/33/34 on HYDX/USDC, cbBTC/WETH, and USDC/USDbC on Hydrex
```

### Changing Votes

Reallocate your voting power:

```
Change my Hydrex vote to 100% on cbBTC/WETH
```

This will reset current votes and apply new allocation.

## Optimization Strategies

### Simple Strategy

Vote 100% on the pool with highest `projectedFeeInUsd / liveVotingWeight` ratio.

**Example:**

```
Vote on the single best Hydrex pool by fees
```

### Balanced Strategy

Split votes equally across top 3-5 efficient pools for diversification.

**Example:**

```
Vote equally on top 3 Hydrex pools by projected fees
```

### Weighted Strategy

Allocate votes proportional to efficiency scores.

**Example:**

```
Vote on Hydrex pools weighted by their fee efficiency
```

## Understanding Voting Power

### How Voting Power Works

1. **Lock HYDX** → Receive veHYDX NFT
2. **veHYDX amount** = Your voting power
3. **Rolling locks** (Type 1) = Maximum voting power with auto-extension
4. **Earning power** = 1.3x voting power (used for fee distributions)
5. **Next epoch** = Voting power activates
6. **Vote allocation** = Direct emissions to pools

### Checking Your Power

```bash
# Check voting power
bankr agent "What's my Hydrex voting power?"

# Check earning power (1.3x voting power)
bankr agent "What's my Hydrex earning power?"

# Check veHYDX NFT balance
bankr agent "Show my veHYDX NFT balance"

# Check a specific NFT's earning power
bankr agent "How much earning power does my veHYDX NFT #5 have?"
```

**Display to users**: Show earning power (voting power × 1.3) when discussing fee earnings, as this is what determines your share of distributions.

## Vote Proportions

Vote weights are in basis points (10000 = 100%):

| User Says             | Proportions                |
| --------------------- | -------------------------- |
| "100% on X"           | `[10000]`                  |
| "50/50 on X and Y"    | `[5000, 5000]`             |
| "60/40 on X and Y"    | `[6000, 4000]`             |
| "33/33/34 on X, Y, Z" | `[3333, 3333, 3334]`       |
| "25% each on 4 pools" | `[2500, 2500, 2500, 2500]` |

**Proportions must sum to exactly 10000.**

## Epoch System

Hydrex operates on epochs:

- **Duration**: Typically 1 week
- **Voting power activation**: Next epoch after locking
- **Vote changes**: Respect vote delay between changes
- **Epoch boundary**: Usually Thursday 00:00 UTC

## Example Prompts

### Locking

- "Lock 1000 HYDX on Hydrex with rolling lock"
- "Create veHYDX rolling lock with 500 HYDX on Base"
- "Add 250 HYDX to my veHYDX NFT #1"

### Voting

- "Vote optimally on Hydrex"
- "Vote 50/50 on HYDX/USDC and cbBTC/WETH on Hydrex"
- "Allocate my votes to top 3 Hydrex pools by fees"
- "Change my Hydrex vote to 100% on HYDX/USDC"

### Queries

- "What's my Hydrex earning power?"
- "Show me the best Hydrex pools to vote for"
- "How much earning power does my veHYDX NFT #5 have?"

### Single-Sided Liquidity

- "What single-sided liquidity vaults are available on Hydrex?"
- "What single-sided vaults can I deposit BNKR into on Hydrex?"
- "Deposit 500 BNKR into the BNKR/WETH single-sided vault on Hydrex"
- "Show my Hydrex single-sided liquidity positions"
- "Withdraw my BNKR/WETH single-sided position on Hydrex"
- "How much is my Hy