# Hyperdrome Documentation Full Context

> Complete multi-language documentation context for Hyperdrome, the agentic ve(3,3) DEX on Hyperliquid.

- Website: https://hyperdrome.finance
- App: https://app.hyperdrome.finance
- Docs: https://docs.hyperdrome.finance
- GitHub: https://github.com/hyperdrome
- X/Twitter: https://x.com/HyperdromeFinance

Key facts:
- Chain: HyperEVM (Hyperliquid L1, Chain ID 999, HYPE gas token)
- DEX model: ve(3,3) inspired by Solidly/Aerodrome/Velodrome
- Token: HDROME (ERC-20, 1B total supply)
- Locking: Lock HDROME -> veHDROME (ERC-721 veNFT, up to 4 years)
- AMM: Dual pool design — volatile (x*y=k, 0.2% fee) and stable (x^3*y+y^3*x=k, 0.02% fee)
- Fees: 100% of trading fees go to veHDROME voters
- AI agent: Chat-to-DeFi interface using Claude, GPT-4, Gemini at $0 cost to users

## en - English

### Getting Started

#### Introduction

URL: https://docs.hyperdrome.finance/en/introduction

Learn what Hyperdrome is, how its agentic ve(3,3) DEX works on Hyperliquid, and how HDROME, veHDROME, pools, voting, and AI fit together.

## What is Hyperdrome?

Hyperdrome is the **agentic ve(3,3) DEX** on Hyperliquid. It combines a battle-tested AMM (forked from Aerodrome/Velodrome) with an AI-powered agent that handles swaps, liquidity, voting, and yield optimization through natural language.

The product is **not a DEX with AI — it's an AI agent with a DEX.**

## The ve(3,3) System

The ve(3,3) model creates a sustainable flywheel where every participant benefits from cooperation:

![${2}](${1})

### Core Components

1. **Voting Escrow (ve)**
   * Lock HDROME to receive veHDROME voting power (up to 4 years)
   * Longer locks = more voting power, linearly decaying
   * Locked position represented as an ERC-721 NFT

2. **(3,3) Game Theory**
   * Cooperation is the dominant strategy for all participants
   * Voters earn 100% of trading fees + external bribes
   * Anti-dilution rebases protect long-term lockers

### Benefits

* **Sustainable Emissions**: ~1% weekly decay with 0.2% circulating supply floor
* **Voting Power**: Direct weekly emission distribution across gauges
* **Fee Distribution**: 100% of trading fees to veHDROME voters
* **Bribe Marketplace**: Protocols acquire liquidity at a fraction of direct incentive costs

## Dual AMM Design

| Pool Type | Curve | Default Fee | Best For |
|-----------|-------|-------------|----------|
| **Volatile (vAMM)** | `x * y = k` | 0.2% | HYPE/USDC, HDROME/HYPE |
| **Stable (sAMM)** | `x³y + y³x = k` | 0.02% | USDC/USDT, pegged pairs |

Every pool includes a built-in **TWAP oracle** with 30-minute observation periods.

## Built on HyperEVM

| Property | Value |
|----------|-------|
| Chain | HyperEVM |
| Chain ID | 999 |
| Native Token | HYPE |
| RPC | `https://rpc.hyperliquid.xyz/evm` |
| Explorer | `https://explorer.hyperliquid.xyz` |

## Getting Started

  ### Launch App
    Start trading, providing liquidity, and earning rewards
  

  ### Swap Tokens
    Trade tokens with optimized multi-hop routing
  

  ### Provide Liquidity
    Deposit token pairs and stake in gauges for emissions
  

  ### Lock & Vote
    Lock HDROME for veHDROME and direct protocol emissions
  

## Why Hyperdrome?

* **AI-Native**: Built-in agent handles DeFi complexity via natural language and slash commands
* **Proven Codebase**: Fork of Aerodrome/Velodrome — the most battle-tested ve(3,3) implementation
* **Autopilot** *(coming soon)*: Deposit & Chill — AI manages LP, staking, voting, rebalancing, compounding 24/7
* **$0 AI Cost**: Unlimited access to Claude, GPT-4, and Gemini at zero marginal cost per user
* **Bribe Optimizer** *(coming soon)*: B2B tool — protocols input a liquidity target, AI outputs exact bribe amount + projected ROI

---

### Tokenomics

#### HDROME Token

URL: https://docs.hyperdrome.finance/en/tokenomics/hdrome-token

Understand the HDROME token, veHDROME locking, voting power, veNFT mechanics, governance rights, trading fees, bribes, and rebases.

# HDROME Token

![${2}](${1})

## Token Details

| Property | Value |
|----------|-------|
| Symbol | HDROME |
| Decimals | 18 |
| Chain | HyperEVM (Chain ID 999) |
| Standard | ERC-20 |
| Total Supply | 1,000,000,000 |

## Core Utilities

HDROME is the native token of the Hyperdrome protocol. Its primary utilities:

* **Lock for veHDROME** — Lock HDROME to receive veHDROME voting power as an ERC-721 NFT
* **Governance** — veHDROME holders govern protocol parameters and emission allocation
* **Gauge Voting** — Direct weekly HDROME emissions to liquidity pools of your choice
* **100% Trading Fees** — Voters earn 100% of trading fees from the pools they vote for
* **Bribes** — Earn external bribes deposited by protocols seeking liquidity
* **Rebases** — Anti-dilution HDROME rebases protect long-term lockers from emission dilution

---

## Lock Mechanics

![${2}](${1})

Locking HDROME creates a **veHDROME** position represented as an ERC-721 NFT (veNFT). Voting power decays linearly over the lock duration.

### Lock Parameters

| Parameter | Value |
|-----------|-------|
| Minimum Lock | 1 week |
| Maximum Lock | 4 years |
| Decay | Linear over lock duration |
| Representation | ERC-721 NFT (veNFT) |

### Voting Power Formula

```
votingPower = (lockAmount × lockDuration) / maxDuration
```

Where `maxDuration` = 4 years. The longer you lock, the more voting power you receive:

| Lock Duration | Voting Power (% of locked amount) |
|---------------|----------------------------------|
| 4 years | 100% |
| 2 years | 50% |
| 1 year | 25% |
| 6 months | 12.5% |

### veNFT Management

| Action | Description |
|--------|-------------|
| **Create** | Lock HDROME to mint a new veNFT with chosen duration |
| **Increase Amount** | Add more HDROME to an existing veNFT |
| **Extend Lock** | Extend the lock duration to increase voting power |
| **Merge** | Combine two veNFTs into one (durations reconciled) |
| **Transfer** | Send your veNFT to another wallet (ERC-721 transfer) |
| **Withdraw** | Claim unlocked HDROME after lock expiry |

  Locked HDROME cannot be withdrawn until the lock expires. Voting power decays linearly — a 4-year lock at 1,000 HDROME starts at 1,000 veHDROME and reaches 0 at expiry. Extend your lock to maintain full voting power.

---

#### Token Distribution & Emissions

URL: https://docs.hyperdrome.finance/en/tokenomics/distribution-emissions

Review HDROME token allocation, weekly emissions, supply mechanics, decay schedule, rebase protection, and long-term ve(3,3) incentives.

# Token Distribution & Emissions

## Total Supply: 1,000,000,000 HDROME

![${2}](${1})

| Category | Allocation | Amount | Form | Details |
|----------|-----------|--------|------|---------|
| **Protocol** | 65% | 650,000,000 | HDROME | Emissions, liquidity, and protocol growth |
| **Presale** | 20% | 200,000,000 | HDROME | Details coming soon |
| **Team & Contributors** | 5% | 50,000,000 | veHDROME | Vesting locks |
| **Community Airdrop** | 5% | 50,000,000 | veHDROME | 4-year lock via MerkleClaim |
| **Marketing** | 5% | 50,000,000 | HDROME | Growth, partnerships, and incentives |

  
    The largest allocation is reserved for the protocol itself. This includes gauge emissions to reward LPs, protocol-owned liquidity, and future protocol growth initiatives. The allocation ensures long-term sustainability of the Hyperdrome ecosystem.
  
  
    200,000,000 HDROME allocated for the presale round. Further details will be announced soon.
  
  
    50,000,000 HDROME distributed as **veHDROME** with vesting locks. This aligns the team's incentives with long-term protocol success — the team earns through voting fees and bribes, not by selling tokens.
  
  
    50,000,000 HDROME distributed as **veHDROME** with 4-year locks via the MerkleClaim contract. Recipients immediately gain voting power and fee revenue from day one.
  
  
    50,000,000 HDROME allocated for growth initiatives, strategic partnerships, KOL campaigns, and ecosystem incentives.
  

---

## Emission Schedule

![${2}](${1})

### Weekly Emissions

Emissions start at **15,000,000 HDROME per week** and decay approximately 1% each epoch:

```
weekly_emission(n) = weekly_emission(n-1) × 990 / 1000
```

| Period | Weekly Emission | Cumulative Emitted |
|--------|----------------|--------------------|
| Week 1 | 15,000,000 | 15,000,000 |
| Week 13 (~3 months) | 13,100,000 | ~182,000,000 |
| Week 26 (~6 months) | 11,600,000 | ~338,000,000 |
| Week 52 (~1 year) | 8,950,000 | ~573,000,000 |
| Week 104 (~2 years) | 5,340,000 | ~831,000,000 |

  When the decayed emission falls below **0.2% of circulating supply**, the tail emission floor activates to maintain a minimum emission rate indefinitely.

### Weekly Distribution Split

| Recipient | Share | Description |
|-----------|-------|-------------|
| **Gauges** | ~96.7% | Distributed to liquidity pools based on veHDROME vote weights |
| **Team** | ~3% | 30 basis points to team address (max 50 bps) |
| **Rebases** | Variable | Anti-dilution HDROME to veHDROME holders via RewardsDistributor |

---

## Epoch Cycle

![${2}](${1})

Each epoch runs from **Thursday 00:00 UTC** to the next Thursday:

  
    Previous votes tallied. Minter calculates the new emission amount based on the decay formula.
  
  
    Minter mints HDROME. Voter contract distributes to gauges proportionally to vote weights. RewardsDistributor sends rebases to veHDROME holders.
  
  
    veHDROME holders allocate votes across pools. Each veNFT can vote once per epoch.
  
  
    Trading fees and bribes accumulate for voters. LP emissions stream continuously to gauge stakers.

---

#### veHDROME & Voting

URL: https://docs.hyperdrome.finance/en/tokenomics/vehdrome-voting

Learn how veHDROME voting directs emissions to gauges, how weekly epochs work, and how voters earn trading fees, bribes, and rebases.

# veHDROME & Voting

![${2}](${1})

## Voting Flow

Each epoch (Thursday 00:00 UTC to Thursday 00:00 UTC), veHDROME holders allocate their voting power across liquidity pool gauges. The flow works as follows:

1. **veHDROME holders** select one or more pools and assign vote weights (percentage-based).
2. The **Voter contract** tallies all votes at epoch flip.
3. The **Minter** mints the weekly HDROME emission and distributes it to gauges proportionally to their vote share.
4. **LPs staked in gauges** earn HDROME emissions over the following epoch on a per-second basis.
5. **Voters** earn 100% of trading fees and external bribes from the pools they voted for.

## Gauge System

| Parameter | Value |
|-----------|-------|
| Max Reward Tokens per Gauge | 16 |
| Epoch Duration | 7 days (Thursday to Thursday UTC) |
| Emission Accrual | Per-second, proportional to staked LP share |

---

## Revenue Streams

![${2}](${1})

veHDROME voters earn from three distinct revenue streams:

| Stream | Source | Distribution |
|--------|--------|-------------|
| **Trading Fees** | 100% of swap fees from voted pools | Claimable after epoch flip |
| **External Bribes** | Deposited by protocols seeking votes | Claimable after epoch flip |
| **Rebases** | Anti-dilution HDROME from Minter | Automatically distributed to veHDROME holders via RewardsDistributor |

---

## Voting Rules

| Rule | Detail |
|------|--------|
| **Once per epoch** | Each veNFT can vote once per epoch |
| **Locked until flip** | Votes are locked for the entire epoch once cast |
| **Reset required** | Must reset votes before transferring or merging veNFTs |
| **Poke** | Anyone can poke a veNFT to update its decayed voting power in existing allocations |

## Voting Strategies

  
    Vote for pools with the highest trading volume relative to their current vote weight. High-volume pools with fewer votes generate more fees per veHDROME allocated. Check the fee/vote ratio each epoch to identify underweight pools.
  
  
    Vote for pools with active external bribes. Protocols deposit bribes to attract votes, and the bribe-per-vote ratio can significantly exceed fee revenue. Compare total bribe value to current vote weight to find the best opportunities.
  
  
    If you want to deepen liquidity for a specific protocol's token, concentrate votes on its gauge. This directs more HDROME emissions to that pool's LPs, attracting more liquidity and tightening spreads for the token.
  

  Votes are locked for the entire epoch once cast. You cannot change or withdraw your vote until the next epoch flip. Plan your allocation carefully before voting.

---

#### Pools & Liquidity

URL: https://docs.hyperdrome.finance/en/tokenomics/pools-liquidity

Explore Hyperdrome liquidity pools, volatile and stable AMM curves, swap routing, LP staking, fee structure, and built-in TWAP oracles.

# Pools & Liquidity

![${2}](${1})

## Pool Architecture

Hyperdrome uses a **dual AMM** design with two pool types optimized for different asset classes. The PairFactory deploys pools deterministically via CREATE2. Each pool has its own fee collection contract (PairFees) and can have a gauge attached for HDROME emissions. Every pool also includes a built-in TWAP oracle with 30-minute observation periods.

### Volatile Pools (vAMM)

| Property | Value |
|----------|-------|
| Curve | `x * y = k` (constant product) |
| Default Fee | 0.2% |
| Naming Convention | vAMM-TOKEN0/TOKEN1 |
| Best For | Uncorrelated pairs (HYPE/USDC, HDROME/HYPE) |

### Stable Pools (sAMM)

| Property | Value |
|----------|-------|
| Curve | `x³y + y³x = k` (StableSwap variant) |
| Default Fee | 0.02% |
| Naming Convention | sAMM-TOKEN0/TOKEN1 |
| Best For | Pegged/correlated pairs (USDC/USDT, HYPE/stHYPE) |

---

## Fee Structure

| Parameter | Detail |
|-----------|--------|
| Volatile Pool Fee | 0.2% (adjustable by Fee Manager) |
| Stable Pool Fee | 0.02% (adjustable by Fee Manager) |
| Fee Recipient | 100% to veHDROME voters of that pool's gauge |
| Fee Collection | Collected per swap into PairFees contract |

---

## Swap Routing

The Router contract finds the optimal path for any token swap. It checks all available pools (both volatile and stable) and constructs multi-hop routes when a direct pair doesn't exist or when a multi-hop path offers better execution. For example, a TOKEN_A to TOKEN_B swap might route through TOKEN_A → HYPE → TOKEN_B if it results in less slippage.

---

## Providing Liquidity

![${2}](${1})

  
    Choose a volatile (vAMM) or stable (sAMM) pool pair. Volatile pools suit uncorrelated assets; stable pools suit pegged pairs.
  
  
    Provide both tokens in the pair at the current pool ratio. The Router handles the math to minimize leftover dust.
  
  
    You receive LP tokens representing your share of the pool. These accrue trading fees automatically.
  
  
    Deposit your LP tokens into the pool's gauge to earn HDROME emissions. Unstaked LPs earn zero emissions.
  

  Always stake your LP tokens in the gauge after depositing. Unstaked LP positions earn trading fees but miss out on HDROME emissions — which often represent the majority of yield.

---

## Built-in Oracle

Every Hyperdrome pool includes a **TWAP (Time-Weighted Average Price) oracle** with 30-minute observation periods. This provides manipulation-resistant price feeds that can be consumed by other protocols on HyperEVM. The oracle stores cumulative price observations and can be queried for any window up to the maximum observation history.

---

#### Bribes & Rewards

URL: https://docs.hyperdrome.finance/en/tokenomics/bribes-rewards

Learn how Hyperdrome rewards flow through external bribes, trading fees, emissions, rebases, gauge votes, and veHDROME voter claims.

# Bribes & Rewards

![${2}](${1})

## Reward Flow

The Hyperdrome reward system has three distinct streams flowing to different participants:

1. **LP Emissions** — The Minter creates HDROME each epoch. The Voter contract distributes it to gauges based on veHDROME vote weights. LPs staked in gauges earn these emissions on a per-second basis proportional to their share of the gauge.

2. **Trading Fees + External Bribes → Voters** — 100% of trading fees from each pool and any external bribes deposited for that pool's gauge flow to the veHDROME holders who voted for it. These are claimable after each epoch flip.

3. **Rebases → veHDROME Holders** — The RewardsDistributor sends anti-dilution HDROME rebases to all veHDROME holders proportional to their voting power, protecting lockers from emission dilution.

---

## Reward Types

| Reward | Recipient | Source | Timing |
|--------|-----------|--------|--------|
| **LP Emissions** | Gauge-staked LPs | Weekly HDROME mint | Per-second accrual |
| **Trading Fees** | veHDROME voters | 100% of swap fees | Claimable after epoch flip |
| **External Bribes** | veHDROME voters | Protocol deposits | Claimable after epoch flip |
| **Rebases** | All veHDROME holders | Minter anti-dilution | Distributed at epoch flip |

---

## External Bribes

![${2}](${1})

External bribes allow protocols to incentivize veHDROME voters to direct emissions toward specific pools. This is the primary mechanism for protocols to acquire deep liquidity on Hyperdrome.

  
    A protocol deposits tokens into the ExternalBribe contract for a specific gauge before the epoch flip.
  
  
    At epoch flip, the bribe becomes visible to voters. veHDROME holders factor bribe value into their voting decisions for the current epoch.
  
  
    After the epoch ends, voters who allocated votes to that gauge can claim their proportional share of the bribe based on their vote weight.
  

### Bribe Efficiency

* Protocols typically acquire $2-5 of liquidity for every $1 spent on bribes
* Bribe ROI varies by epoch — lower total vote weight means higher per-vote returns
* Consistent bribing across multiple epochs builds sustained liquidity depth
* Up to 16 different reward tokens can be used as bribes per gauge

---

## Internal Bribes (Trading Fees)

Internal bribes are not deposited by external parties — they are the **trading fees** generated by each pool. 100% of swap fees are automatically routed to the InternalBribe contract for that pool's gauge. veHDROME voters who voted for the gauge claim these fees after each epoch flip. Higher-volume pools generate more internal bribes, making them attractive voting targets.

---

## Rebases

Rebases are anti-dilution rewards distributed to all veHDROME holders via the RewardsDistributor contract. When new HDROME is minted each epoch, a proportional amount is distributed as rebases to prevent voting power dilution. The rebase amount scales with the ratio of locked HDROME to total circulating supply — more locking means higher rebases.

---

## Claiming Rewards

| Reward Type | Where to Claim | Frequency |
|-------------|---------------|-----------|
| LP Emissions | Gauge contract | Anytime (accrues per-second) |
| Trading Fees | InternalBribe contract | After each epoch flip |
| External Bribes | ExternalBribe contract | After each epoch flip |
| Rebases | RewardsDistributor | After each epoch flip |

  Use the `/claim` slash command in the Hyperdrome agent to claim all pending rewards across all positions in a single transaction.

---

#### Deployed Contracts

URL: https://docs.hyperdrome.finance/en/tokenomics/deployed-contracts

Find Hyperdrome deployed contract addresses on HyperEVM, including core protocol contracts, token addresses, and network details.

# Deployed Contracts

## Network Information

| Parameter | Value |
|-----------|-------|
| Network | Hyperliquid EVM |
| Chain ID | `999` |
| RPC URL | `https://rpc.hyperliquid.xyz/evm` |
| Explorer | `https://explorer.hyperliquid.xyz` |
| Native Token | HYPE |

## Core Contracts (HyperEVM Mainnet)

| Contract | Address |
|----------|---------|
| HDROME Token | `TBD` |
| VotingEscrow (veHDROME) | `TBD` |
| Voter | `TBD` |
| Router | `TBD` |
| PairFactory | `TBD` |
| GaugeFactory | `TBD` |
| BribeFactory | `TBD` |
| Minter | `TBD` |
| RewardsDistributor | `TBD` |
| MerkleClaim | `TBD` |
| VeArtProxy | `TBD` |
| HyperdromeLibrary | `TBD` |

  Contract addresses will be published here after mainnet deployment. All contracts will be verified on the Hyperliquid Explorer.

## Known Token Addresses

| Token | Address | Decimals |
|-------|---------|----------|
| WHYPE (Wrapped HYPE) | `0x5555555555555555555555555555555555555555` | 18 |
| USDC | `0xb88339CB7199b77E23DB6E890353E22632Ba630f` | 6 |
| USDT0 | `0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb` | 6 |

## Contract Architecture

| Layer | Contracts | Purpose |
|-------|-----------|---------|
| **AMM Core** | Pair, PairFees, PairFactory, Router | Token swaps, liquidity, fee collection |
| **Token & Locking** | Hyperdrome, VotingEscrow, VeArtProxy | HDROME token, veNFT creation and management |
| **Voting & Gauges** | Voter, Gauge, InternalBribe, ExternalBribe | Emission voting, LP staking, bribe distribution |
| **Emissions** | Minter, RewardsDistributor | Weekly minting, rebase distribution |
| **Factories** | PairFactory, GaugeFactory, BribeFactory | Deterministic contract deployment |
| **Governance** | L2Governor, HyperdromeGovernor (Multisig) | On-chain proposals, timelocked execution |
| **Airdrop** | MerkleClaim | Merkle tree airdrop (4-year veHDROME locks) |

  Always verify contract addresses before interacting. Only use addresses listed in this official documentation or the Hyperdrome app.

---

#### Security

URL: https://docs.hyperdrome.finance/en/tokenomics/security

Review Hyperdrome security assumptions, inherited Velodrome and Solidly architecture, access controls, audits, timelocks, and user risks.

# Security

![${2}](${1})

## Codebase Heritage

Hyperdrome is built on the **Velodrome/Solidly** codebase, one of the most battle-tested ve(3,3) implementations in DeFi:

* **Solidly** — Original ve(3,3) AMM by Andre Cronje on Fantom
* **Velodrome** — Refined fork on Optimism, the largest DEX by TVL on OP

## Audits

| Audit | Scope | Report |
|-------|-------|--------|
| Solidly Audit | Core AMM, VotingEscrow, Minter | Available in repo |
| Velodrome Audits | Full protocol review | Available in repo |

## Smart Contract Security

### Access Control

| Role | Permissions |
|------|------------|
| **Governor** | Whitelist tokens, create gauges, protocol parameters |
| **Emergency Council** | Kill/revive gauges in emergencies |
| **Fee Manager** | Adjust trading fee rates per pool |
| **Pauser** | Pause all swaps in emergency |

### Timelock

The **HyperdromeGovernor** multisig includes per-function timelocks:

* Custom delay per function selector / destination combo
* Batch transaction execution support
* Based on 0x's ZeroExGovernor pattern

### Key Security Properties

* **Immutable Minter assignment** — `setMinter()` can only be called once on the HDROME token
* **CREATE2 deterministic deployment** — Pair addresses are predictable and verifiable
* **veNFT attachment system** — Prevents transfer of veNFTs while staked in gauges
* **Epoch-locked votes** — Votes cannot be changed mid-epoch, preventing manipulation
* **TWAP oracle** — 30-minute observation periods resist price manipulation

## Solidity Version

All contracts compiled with **Solidity 0.8.13** with standard overflow/underflow protections.

## Test Suite

The protocol includes **21 Foundry test files** covering:

* AMM pair mechanics and fee accounting
* veNFT lock/unlock/merge operations
* Emission calculations and decay schedules
* Gauge staking and reward distribution
* Voting mechanics and epoch transitions
* Emergency gauge kill/revive
* Merkle claim airdrop distribution
* On-chain governance proposals
* Anti-wash-trade protection
* Oracle accuracy and edge cases

---

### Agentic

#### Agentic Overview

URL: https://docs.hyperdrome.finance/en/agentic/overview

Understand the Hyperdrome AI agent, chat-to-DeFi interface, slash commands, smart suggestions, execution flow, and LLM-agnostic architecture.

# The Hyperdrome Agent

![${2}](${1})

## Not a DEX with AI — It's an AI Agent with a DEX

Hyperdrome is built AI-first. The agent isn't a chatbot bolted onto a trading interface — it **is** the interface. Every DeFi action (swapping, LPing, locking, voting, claiming) is accessible through natural language conversation or slash commands. The traditional UI exists as a fallback, but the agent is the primary way users interact with the protocol.

---

## Architecture

The Hyperdrome agent uses an LLM routing layer to interpret user intent and map it to on-chain actions. When a user sends a message, the agent:

1. **Parses intent** — The LLM analyzes the message to determine what the user wants to do (swap, LP, vote, check portfolio, etc.)
2. **Gathers context** — Reads on-chain state (wallet balances, pool data, veNFT positions, pending rewards) and off-chain data (prices, TVL, APRs)
3. **Generates response** — Produces a natural language explanation with rich UI cards showing the proposed action, parameters, and expected outcomes
4. **Executes on approval** — When the user confirms, the agent constructs and submits the transaction(s)

The agent supports multiple LLM backends (Claude, GPT-4, Gemini) at zero cost to the user.

---

## Chat-to-DeFi

Users interact with the full protocol through conversational prompts:

* *"Swap 100 USDC to HYPE"*
* *"What are my pending rewards?"*
* *"Lock 1000 HDROME for 4 years"*
* *"Vote all my veHDROME on the HYPE/USDC pool"*
* *"What's the best yield right now?"*

The agent handles routing, slippage, gas estimation, and transaction construction behind the scenes.

---

## Slash Commands

| Command | Action |
|---------|--------|
| `/swap` | Swap tokens with optimized routing |
| `/lp` | Add or remove liquidity from a pool |
| `/vote` | Allocate veHDROME votes across gauges |
| `/lock` | Lock HDROME to create or extend a veNFT |
| `/claim` | Claim all pending rewards (emissions, fees, bribes) |
| `/help` | Show available commands and usage |

---

## Rich UI Cards

The agent renders interactive cards for every action — not just text responses. Cards display:

* **Swap cards** — Token pair, amount, price impact, route path, slippage tolerance
* **LP cards** — Pool pair, TVL, APR, your share, deposit amounts
* **Vote cards** — Gauge list, current vote weights, projected fee/bribe revenue
* **Portfolio cards** — Token balances, LP positions, veNFT details, pending rewards
* **Reward cards** — Breakdown of claimable emissions, fees, and bribes with USD values

---

## Executable Actions

| Category | Actions |
|----------|---------|
| **Trading** | Swap tokens, multi-hop routing, set slippage |
| **Liquidity** | Add liquidity, remove liquidity, stake in gauge, unstake from gauge |
| **Locking** | Create veNFT, increase lock amount, extend lock duration, merge veNFTs |
| **Voting** | Vote on gauges, reset votes, poke stale votes |
| **Rewards** | Claim emissions, claim fees, claim bribes, claim rebases |
| **Portfolio** | View balances, view positions, view pending rewards, get yield recommendations |

---

## Smart Suggestions

The agent proactively surfaces optimization opportunities based on wallet state:

| Priority | Trigger | Suggestion |
|----------|---------|------------|
| **High** | Unstaked LP tokens detected | Stake in gauge to earn emissions |
| **High** | Unclaimed rewards > $10 | Claim and compound pending rewards |
| **High** | veNFT expiring within 7 days | Extend lock to maintain voting power |
| **Medium** | Idle tokens > $10 not in LP/lock | Provide liquidity or lock for veHDROME |
| **Medium** | Suboptimal vote allocation | Rebalance votes to higher-yielding gauges |
| **Low** | New high-APR pool available | Consider LPing in trending pools |

---

## LLM-Agnostic Architecture

The Hyperdrome agent is **not locked into a single AI provider**. The architecture separates intent parsing, context gathering, and execution into independent layers — so the LLM backend can be swapped without changing anything else.

| Layer | Role | LLM Required? |
|-------|------|---------------|
| **Intent Parser** | Understand what the user wants | Yes — any LLM |
| **Context Gatherer** | Read on-chain + off-chain data | No |
| **Responder** | Generate explanation + UI cards | Yes — any LLM |
| **Executor** | Build and submit transactions | No |

Currently supports **Claude**, **GPT-4**, and **Gemini** with intelligent routing. Open-source models (Llama, Mistral, Qwen) and Bring Your Own LLM are on the roadmap.

  ### LLM Integrations
    Claude, GPT-4, Gemini, Llama, Mistral + Bring Your Own LLM
  

  ### MCP Server
    Connect any AI assistant to Hyperdrome via Model Context Protocol
  

  ### Agent Frameworks
    GOAT SDK, Wayfinder, Eliza, Olas, REST API
  

---

## Multi-Language Support

The agent responds in the user's language. Prompts in English, Chinese, Japanese, Korean, Spanish, French, Portuguese, Turkish, Russian, Arabic, and other languages are all supported natively through the underlying LLM capabilities. The UI labels and slash commands remain in English, but all conversational responses adapt to the user's language.

---

#### LLM Integrations

URL: https://docs.hyperdrome.finance/en/agentic/llm-integrations

See how Hyperdrome connects to Claude, GPT-4, Gemini, Llama, Mistral, and other LLMs through routing, adapters, and BYO model support.

# LLM Integrations

![${2}](${1})

## LLM-Agnostic by Design

Hyperdrome is not locked into a single AI provider. The agent architecture separates **intent parsing**, **context gathering**, and **execution** into independent layers — so the LLM backend can be swapped without changing anything else.

This means Hyperdrome works with any large language model today, and will work with any model released tomorrow.

---

## Supported Models

  ### Claude
    Opus, Sonnet, Haiku — **Live**
  

  ### GPT-4
    GPT-4o, GPT-4, GPT-4 Turbo — **Live**
  

  ### Gemini
    Gemini 2.5 Pro, 2.5 Flash — **Live**
  

  ### Open Source
    Llama, Mistral, Qwen, DeepSeek — *Planned*
  

  All models are available at **$0 cost** to users. Hyperdrome covers inference costs.

---

## Architecture

The agent pipeline is model-agnostic at every stage:

![${2}](${1})

| Step | Component | LLM Required? | Description |
|------|-----------|---------------|-------------|
| 1 | **Intent Parser** | Yes — any LLM | Analyzes the user's message to determine intent (swap, LP, vote, etc.) |
| 2 | **Context Gatherer** | No | Reads on-chain state + off-chain data (wallet, pools, prices, APRs) |
| 3 | **Responder** | Yes — any LLM | Generates natural language explanation with rich UI cards |
| 4 | **Executor** | No | Builds and submits the transaction on-chain |

The LLM is only involved in two steps: understanding what the user wants, and explaining the result. Everything else — reading blockchain state, building transactions, submitting on-chain — is deterministic code.

---

## Intelligent Routing

The backend automatically selects the best model for each request based on:

| Factor | Logic |
|--------|-------|
| **Complexity** | Simple queries (price checks, balance) → fastest model. Complex multi-step actions → most capable model. |
| **Language** | Some models perform better in specific languages. The router optimizes for the user's detected language. |
| **Latency** | If the primary model is slow or unavailable, the router falls back to the next best option in < 500ms. |
| **Cost** | The router balances capability vs. cost to keep inference free for all users. |

---

## Bring Your Own LLM *(Coming Soon)*

  This feature is on the roadmap and not yet available.

Users will be able to connect their own LLM provider:

* **API key** — Plug in your own OpenAI, Anthropic, Google, or any OpenAI-compatible API key
* **Self-hosted models** — Point the agent to your own Ollama, vLLM, or TGI endpoint running Llama, Mistral, Qwen, or any open-source model
* **Custom system prompts** — Tailor the agent's personality, risk tolerance, and response style
* **Full privacy** — When using your own model, no data passes through Hyperdrome's inference servers

### Compatible Endpoints

Any endpoint that implements the OpenAI Chat Completions API format will work:

| Runtime | Example Models |
|---------|---------------|
| **Ollama** | Llama 3.3, Mistral, Qwen 2.5, DeepSeek V3, Gemma |
| **vLLM** | Any HuggingFace model |
| **TGI** | Any HuggingFace model |
| **Together AI** | Llama, Mixtral, Qwen |
| **Groq** | Llama, Mixtral, Gemma |
| **Fireworks** | Llama, Mixtral, DeepSeek |

---

## Why LLM-Agnostic Matters

1. **No vendor lock-in** — If a provider raises prices, degrades quality, or adds restrictions, Hyperdrome switches seamlessly.

2. **Best model for the job** — Different models excel at different tasks. Routing lets Hyperdrome use the best tool for each request.

3. **Future-proof** — New models are released monthly. LLM-agnostic architecture means Hyperdrome adopts them immediately without rewrites.

4. **User sovereignty** — With Bring Your Own LLM, users control their data and inference. No dependency on centralized AI providers.

5. **Censorship resistance** — Open-source models can't be shut down or restricted. Users running their own Llama or Mistral instance have full autonomy.

---

#### MCP Server

URL: https://docs.hyperdrome.finance/en/agentic/mcp-server

Connect AI assistants to Hyperdrome with the Model Context Protocol server for swaps, liquidity, voting, locking, rewards, and portfolio tools.

# MCP Server

![${2}](${1})

  The Hyperdrome MCP server is on the roadmap and not yet live. This page documents the planned specification.

## What is MCP?

**Model Context Protocol (MCP)** is an open standard by Anthropic that lets AI assistants discover and call tools on external servers. It uses JSON-RPC 2.0 — the assistant calls `tools/list` to discover available actions, then `tools/call` to execute them.

MCP is supported by **Claude Desktop**, **Cursor**, **Opencode**, **Windsurf**, and a growing number of AI coding and chat tools.

---

## Why MCP for DeFi?

Today, interacting with DeFi requires:
1. Opening a browser
2. Connecting a wallet
3. Navigating a complex UI
4. Understanding slippage, routing, gas

With Hyperdrome's MCP server, any AI assistant can **directly** swap tokens, check yields, vote on gauges, and manage positions — without the user ever leaving their preferred tool.

> *"Swap 500 USDC to HYPE on Hyperdrome"* — typed into Claude Desktop, Cursor, or any MCP client.

---

## Available Tools

The MCP server exposes the full Hyperdrome protocol as callable tools:

### Trading

| Tool | Description | Parameters |
|------|-------------|------------|
| `swap` | Swap tokens with optimized multi-hop routing | `fromToken`, `toToken`, `amount`, `slippageBps?` |
| `get_quote` | Get a swap quote without executing | `fromToken`, `toToken`, `amount` |

### Liquidity

| Tool | Description | Parameters |
|------|-------------|------------|
| `add_liquidity` | Deposit token pair into a pool | `tokenA`, `tokenB`, `amountA`, `amountB`, `stable` |
| `remove_liquidity` | Withdraw from a pool | `tokenA`, `tokenB`, `stable`, `liquidity` |
| `stake_lp` | Stake LP tokens in a gauge | `pool`, `amount` |
| `unstake_lp` | Unstake LP tokens from a gauge | `pool`, `amount` |

### Locking & Voting

| Tool | Description | Parameters |
|------|-------------|------------|
| `lock` | Lock HDROME to create or extend a veNFT | `amount`, `duration` |
| `vote` | Allocate veHDROME votes across gauges | `tokenId`, `pools[]`, `weights[]` |
| `reset_votes` | Reset votes for a veNFT | `tokenId` |

### Rewards

| Tool | Description | Parameters |
|------|-------------|------------|
| `claim_rewards` | Claim all pending rewards | `tokenId?` |
| `claim_fees` | Claim trading fees for a specific gauge | `gauge` |
| `claim_bribes` | Claim external bribes | `gauge`, `tokens[]` |

### Read-Only

| Tool | Description | Parameters |
|------|-------------|------------|
| `get_pools` | List all pools with TVL, APR, volume | `sortBy?`, `limit?` |
| `get_portfolio` | Full wallet analysis | `address` |
| `get_yields` | Top yield opportunities | `limit?`, `minTvl?` |
| `get_venft` | Get veNFT details | `tokenId` |
| `get_pending_rewards` | Check unclaimed rewards | `address` |

---

## Tool Schema Example

Each tool follows the MCP specification with a JSON Schema for inputs:

```json
{
  "name": "swap",
  "description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromToken": {
        "type": "string",
        "description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
      },
      "toToken": {
        "type": "string",
        "description": "Token symbol or address to buy (e.g. 'HYPE')"
      },
      "amount": {
        "type": "string",
        "description": "Amount to swap in human-readable units (e.g. '100')"
      },
      "slippageBps": {
        "type": "number",
        "description": "Max slippage in basis points (default: 50 = 0.5%)"
      }
    },
    "required": ["fromToken", "toToken", "amount"]
  }
}
```

---

## Connection

### Claude Desktop / Cursor / Opencode

Add to your MCP configuration:

```json
{
  "mcpServers": {
    "hyperdrome": {
      "url": "https://mcp.hyperdrome.finance/sse"
    }
  }
}
```

### Self-Hosted

The MCP server will be open-source. Run your own instance:

```bash
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
```

---

## Security Model

| Property | Detail |
|----------|--------|
| **Read-only by default** | Portfolio queries and pool data require no wallet connection |
| **Transaction approval** | All write operations return unsigned transactions for the user to review and sign |
| **No private keys** | The hosted MCP server never touches private keys. Signing happens client-side. |
| **Rate limiting** | Per-IP and per-API-key rate limits to prevent abuse |
| **Audit trail** | Every tool call is logged with timestamp, parameters, and result |

  The MCP server never executes transactions on your behalf. It builds the transaction and returns it for your explicit approval — just like any DeFi frontend.

---

## Use Cases

| Scenario | How |
|----------|-----|
| **Developer building a DeFi dashboard** | Query pools, yields, and positions via MCP tools |
| **AI coding assistant** | "Help me write a script that claims all my Hyperdrome rewards" — the assistant calls `get_pending_rewards` then `claim_rewards` |
| **Autonomous agent** | A portfolio management agent checks yields hourly and rebalances via `add_liquidity` / `remove_liquidity` |
| **Chat bot** | A Telegram bot that lets users swap, check portfolio, and vote through natural language |
| **Research** | An analyst queries `get_pools` to build a yield comparison across HyperEVM DEXes |

---

#### Agent Framework Integrations

URL: https://docs.hyperdrome.finance/en/agentic/agent-frameworks

Learn how Hyperdrome integrates with GOAT SDK, Wayfinder, Eliza, Olas, REST APIs, LangChain tools, and autonomous agent frameworks.

# Agent Framework Integrations

![${2}](${1})

Hyperdrome is designed to be accessible from **any AI agent**, not just our own. The protocol exposes its functionality through multiple integration layers so that third-party agents, frameworks, and platforms can interact with Hyperdrome natively.

  ### GOAT SDK
    200+ tools, 13+ framework adapters
  

  ### MCP
    Claude Desktop, Cursor, Opencode
  

  ### Wayfinder
    AI-native DeFi terminal
  

  ### Eliza
    Autonomous social + DeFi agents
  

  ### Olas
    Decentralized autonomous agents
  

  ### REST API
    Direct HTTP endpoints for any developer
  

---

## Integration Architecture

![${2}](${1})

| Layer | Components | Role |
|-------|-----------|------|
| **AI Agent Frameworks** | Claude, GPT, Gemini, Llama, Mistral, ... | User-facing AI models |
| **Adapter Layer** | GOAT SDK, Wayfinder, Eliza, LangChain, Vercel AI, MCP, REST API | Translate agent calls to protocol actions |
| **Hyperdrome Protocol** | Intent Parser → Context → Tx Builder → Chain | Parse, gather data, build transactions |
| **HyperEVM** | Router, Voter, Gauges, VotingEscrow, ... | On-chain smart contracts |

Any framework that supports one of the adapter layers can interact with Hyperdrome. No custom integration code needed.

---

## GOAT SDK Plugin

  The GOAT SDK plugin is on the roadmap and not yet published.

**GOAT SDK** is the largest agentic finance toolkit — 200+ tools, 15+ chains, 13+ framework adapters. Protocols like Uniswap, Aave, 1inch, and Balancer already have GOAT plugins.

Hyperdrome will publish `@goat-sdk/plugin-hyperdrome` with full protocol coverage:

### Exposed Actions

| Action | Description |
|--------|-------------|
| `swap` | Swap tokens with optimized routing |
| `addLiquidity` | Deposit into volatile or stable pools |
| `removeLiquidity` | Withdraw from pools |
| `stakeLp` | Stake LP tokens in gauges |
| `unstakeLp` | Unstake from gauges |
| `lock` | Lock HDROME → veHDROME (create/extend veNFT) |
| `vote` | Allocate votes across gauges |
| `claimRewards` | Claim emissions, fees, bribes, rebases |
| `getPools` | List pools with TVL, APR, volume |
| `getPortfolio` | Full wallet analysis |

### Framework Reach

Once the GOAT plugin is published, Hyperdrome is automatically available in:

| Framework | Type |
|-----------|------|
| **Vercel AI SDK** | Full-stack AI apps |
| **LangChain** | Agent orchestration (Python & JS) |
| **LlamaIndex** | Data-augmented agents |
| **MCP** | Claude Desktop, Cursor, Opencode |
| **Eliza** | Autonomous social + DeFi agents |
| **CrewAI** | Multi-agent systems |
| **Mastra** | TypeScript agent framework |
| **GAME (Virtuals)** | Gaming + DeFi agents |
| **OpenAI Agents SDK** | OpenAI's native agent runtime |
| **ZerePy** | Python agent framework |
| **AutoGen** | Microsoft's multi-agent framework |
| **Olas** | Decentralized autonomous agents |

---

## Wayfinder Paths

  The Wayfinder integration is on the roadmap and not yet available.

**Wayfinder** is an AI-native DeFi terminal with its own SDK (Paths). It already supports Hyperliquid perps, Aave V3, Morpho, Pendle, and Uniswap V3.

Hyperdrome will publish a **Wayfinder protocol adapter** enabling:

* Swap, LP, vote, and lock via Wayfinder Shells (AI trading interface)
* Strategy composition — combine Hyperdrome yield with cross-protocol strategies
* MCP bridge — Wayfinder's built-in MCP server will expose Hyperdrome tools

---

## Eliza (ElizaOS)

**Eliza** is the leading open-source framework for autonomous crypto agents. It powers social + DeFi bots that operate on Twitter, Telegram, and on-chain.

Hyperdrome integration via the GOAT plugin (`@elizaos/plugin-goat`):

* Eliza agents can swap, LP, vote, and claim on Hyperdrome
* Autonomous yield farming — agents that monitor APRs and rebalance positions
* Social + DeFi — agents that post yield updates, respond to community questions, and execute trades

---

## Olas (Autonolas)

**Olas** is a decentralized platform for co-owning and running autonomous AI agents. 3,600+ agents deployed, 17M+ transactions.

Hyperdrome integration path:

* Build an **Olas agent service** that manages Hyperdrome positions
* Register as a **Mech** in the Olas marketplace — other agents can hire Hyperdrome actions
* Compose with existing Olas agents for cross-protocol strategies

---

## REST API

  The public REST API is on the roadmap and not yet available.

For developers who want direct integration without a framework:

### Planned Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/api/pools` | List all pools with TVL, APR, fees, volume |
| `GET` | `/api/pools/:address` | Pool details |
| `GET` | `/api/portfolio/:wallet` | Full portfolio analysis |
| `GET` | `/api/yields` | Top yield opportunities |
| `POST` | `/api/quote` | Get a swap quote |
| `POST` | `/api/swap` | Build a swap transaction |
| `POST` | `/api/liquidity/add` | Build an add-liquidity transaction |
| `POST` | `/api/liquidity/remove` | Build a remove-liquidity transaction |
| `POST` | `/api/lock` | Build a lock transaction |
| `POST` | `/api/vote` | Build a vote transaction |
| `POST` | `/api/claim` | Build a claim-all transaction |

### Response Format

All write endpoints return unsigned transaction data:

```json
{
  "tx": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "chainId": 999,
    "gasLimit": "250000"
  },
  "summary": {
    "action": "Swap 100 USDC → 1.62 HYPE",
    "priceImpact": "0.03%",
    "route": ["USDC", "HYPE"],
    "minReceived": "1.611 HYPE"
  }
}
```

  The API never requires private keys. All transactions are returned unsigned for client-side signing.

---

## LangChain Tool

For Python developers using LangChain directly:

```python
from langchain.tools import tool

@tool
def hyperdrome_swap(from_token: str, to_token: str, amount: str) -> str:
    """Swap tokens on Hyperdrome (HyperEVM). Returns unsigned transaction."""
    # Calls Hyperdrome REST API
    ...
```

The GOAT SDK adapter handles this automatically, but developers can also build custom LangChain tools against the REST API.

---

## Build Your Own Integration

Want to integrate Hyperdrome into your agent, bot, or app?

1. **Fastest** — Use the GOAT SDK plugin. Works with 13+ frameworks out of the box.
2. **Most flexible** — Use the REST API directly. Build and sign transactions in any language.
3. **AI-native** — Connect via MCP. Works with Claude Desktop, Cursor, Opencode, and any MCP client.
4. **Autonomous** — Build an Olas agent service for fully decentralized, on-chain agent execution.

All integration layers return unsigned transactions — your app handles signing and submission. Hyperdrome never touches private keys.

---

#### Agent Capabilities & Roadmap

URL: https://docs.hyperdrome.finance/en/agentic/capabilities

Explore Hyperdrome agent capabilities, live data sources, wallet analysis, privacy model, and roadmap for Autopilot and DeFi automation.

# Agent Capabilities & Roadmap

## Live Data Sources

| Source | Data | Update |
|--------|------|--------|
| **HyperEVM RPC** | Wallet balances, LP positions, veNFT details, gauge stakes, pending rewards | Real-time |
| **CoinGecko** | HYPE, USDC, USDT, BTC, ETH, SOL prices + 24h change + market cap + volume | 60s cache |
| **DeFiLlama** | Hyperliquid L1 chain TVL, top 20 protocols with TVL/category/7d change | 60s cache |
| **Hyperliquid API** | All spot tokens with mark prices, 24h volumes, circulating supply | 60s cache |
| **Protocol Contracts** | Pool reserves, TVL, APRs, vote weights, bribe amounts, emission rates | Real-time |

## Wallet Analysis

The agent performs deep portfolio analysis when your wallet is connected:

* **Token balances** with USD values (sorted by value)
* **Idle capital detection** — tokens > $10 not in LP/locks
* **LP positions** — pair, stable/volatile, staked/unstaked, TVL, APR, gauge address
* **Unstaked LP detection** — LPs earning zero emissions
* **veNFTs** — lock amount, expiry, days left, expired/expiring flags, voting power, voted status
* **Pending rewards** — emissions, bribes, fees — broken down per pair with USD totals
* **Top 10 pools by APR** for recommendations

## Roadmap

| Feature | Status |
|---------|--------|
| Chat-to-DeFi (Web) | **Shipped** |
| Slash Commands | **Shipped** |
| Rich UI Cards | **Shipped** |
| Smart Suggestions | **Shipped** |
| Multi-LLM Backend (Claude, GPT-4, Gemini) | **Shipped** |
| Telegram Super-Agent | **In Progress** |
| MCP Server | Planned |
| GOAT SDK Plugin | Planned |
| Public REST API | Planned |
| Wayfinder Integration | Planned |
| Bring Your Own LLM | Planned |
| Autopilot | Planned |
| Content Machine | Planned |
| Dynamic veNFT PFPs | Planned |
| Bribe Optimizer | Planned |
| Yield Reports | Planned |
| AI Treasury | Planned |

### Autopilot *(Coming Soon)*

"Deposit & Chill" — the agent manages your entire DeFi position automatically.

| Risk Profile | Target APY | Strategy |
|-------------|-----------|----------|
| **Conservative** | 8-15% | Stable pools, max lock, blue-chip pairs |
| **Balanced** | 15-30% | Mixed stable/volatile, medium locks |
| **Aggressive** | 30-80% | Volatile pools, bribe farming, active rebalancing |
| **Degen** | 50-200% | New pools, maximum bribe capture, short locks |

The agent handles: LP position management, gauge staking, veHDROME voting, reward claiming, compound reinvesting, and rebalancing — all 24/7 without user intervention.

**Revenue model**: 5% performance fee on Autopilot yield.

### Telegram Super-Agent *(Coming Soon)*

Single bot for the full Hyperdrome experience:
* Swap, yield, portfolio, claim, autopilot
* Education, alerts, meme generation
* PFP generation, bribe analysis, yield reports

### Bribe Optimizer *(Coming Soon)*

B2B tool for protocols:
* Input: liquidity target (e.g., "$500K TVL for TOKEN/HYPE")
* Output: exact bribe amount, projected ROI, recommended epoch timing
* Tracks bribe efficiency over time

### Dynamic veNFT PFPs *(Coming Soon)*

AI-generated profile pictures that evolve based on:
* Lock duration and amount
* Voting activity and streak
* Total yield earned
* Protocol tenure

### AI Treasury *(Coming Soon)*

Autonomous treasury management:
* AI allocates up to 30% of treasury per epoch
* Publishes decisions 12 hours before execution
* Community veto mechanism
* Full on-chain transparency

## Privacy

* Only reads public on-chain data from your connected wallet
* No wallet data stored between sessions
* Conversations not persisted server-side

---

## zh - Chinese

### 快速开始

#### 简介

URL: https://docs.hyperdrome.finance/zh/introduction

欢迎来到 Hyperdrome — Hyperliquid 上的智能代理 ve(3,3) DEX 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

## 什么是 Hyperdrome？

Hyperdrome 是 Hyperliquid 上的**智能代理 ve(3,3) DEX**。它将经过实战检验的 AMM（分叉自 Aerodrome/Velodrome）与 AI 驱动的代理相结合，通过自然语言处理兑换、流动性、投票和收益优化。

这个产品**不是一个带有 AI 的 DEX — 而是一个拥有 DEX 的 AI 代理。**

## ve(3,3) 系统

ve(3,3) 模型创建了一个可持续的飞轮效应，每个参与者都能从合作中受益：

![${2}](${1})

### 核心组件

1. **投票锁仓 (ve)**
   * 锁定 HDROME 以获得 veHDROME 投票权（最长 4 年）
   * 锁定时间越长 = 投票权越大，线性衰减
   * 锁仓仓位以 ERC-721 NFT 表示

2. **(3,3) 博弈论**
   * 合作是所有参与者的优势策略
   * 投票者获得 100% 的交易手续费 + 外部贿赂奖励
   * 抗稀释增发保护长期锁仓者

### 优势

* **可持续排放**：每周约 1% 衰减，流通供应量 0.2% 为下限
* **投票权**：每周直接分配排放至各 gauge
* **手续费分配**：100% 的交易手续费归 veHDROME 投票者所有
* **贿赂市场**：协议以远低于直接激励成本的价格获取流动性

## 双重 AMM 设计

| 池类型 | 曲线 | 默认手续费 | 最适用于 |
|--------|------|------------|----------|
| **波动池 (vAMM)** | `x * y = k` | 0.2% | HYPE/USDC, HDROME/HYPE |
| **稳定池 (sAMM)** | `x³y + y³x = k` | 0.02% | USDC/USDT, 锚定资产对 |

每个池都包含内置的 **TWAP 预言机**，观察周期为 30 分钟。

## 基于 HyperEVM 构建

| 属性 | 值 |
|------|-----|
| 链 | HyperEVM |
| Chain ID | 999 |
| 原生代币 | HYPE |
| RPC | `https://rpc.hyperliquid.xyz/evm` |
| 浏览器 | `https://explorer.hyperliquid.xyz` |

## 快速开始

  ### 启动应用
    开始交易、提供流动性并赚取奖励
  

  ### 代币兑换
    通过优化的多跳路由交易代币
  

  ### 提供流动性
    存入代币对并在 gauge 中质押以获取排放奖励
  

  ### 锁定与投票
    锁定 HDROME 获取 veHDROME 并引导协议排放
  

## 为什么选择 Hyperdrome？

* **AI 原生**：内置代理通过自然语言和斜杠命令处理 DeFi 复杂操作
* **经过验证的代码库**：分叉自 Aerodrome/Velodrome — 最经实战检验的 ve(3,3) 实现
* **自动驾驶** *（即将推出）*：存入即可 — AI 全天候管理 LP、质押、投票、再平衡、复投
* **$0 AI 成本**：无限使用 Claude、GPT-4 和 Gemini，每用户零边际成本
* **贿赂优化器** *（即将推出）*：B2B 工具 — 协议输入流动性目标，AI 输出精确贿赂金额 + 预估 ROI

---

### 代币经济

#### HDROME 代币

URL: https://docs.hyperdrome.finance/zh/tokenomics/hdrome-token

HDROME 代币驱动 Hyperliquid 上的 Hyperdrome ve(3,3) DEX — 锁定、投票并赚取收益 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# HDROME 代币

![${2}](${1})

## 代币详情

| 属性 | 值 |
|------|-----|
| 符号 | HDROME |
| 精度 | 18 |
| 链 | HyperEVM (Chain ID 999) |
| 标准 | ERC-20 |
| 总供应量 | 1,000,000,000 |

## 核心功能

HDROME 是 Hyperdrome 协议的原生代币。其主要功能：

* **锁定获取 veHDROME** — 锁定 HDROME 以获得 veHDROME 投票权，以 ERC-721 NFT 形式呈现
* **治理** — veHDROME 持有者治理协议参数和排放分配
* **Gauge 投票** — 将每周 HDROME 排放引导至您选择的流动性池
* **100% 交易手续费** — 投票者获得其投票池 100% 的交易手续费
* **贿赂** — 赚取协议为获取流动性而存入的外部贿赂奖励
* **增发补偿** — 抗稀释 HDROME 增发保护长期锁仓者免受排放稀释

---

## 锁仓机制

![${2}](${1})

锁定 HDROME 会创建一个 **veHDROME** 仓位，以 ERC-721 NFT (veNFT) 形式表示。投票权在锁仓期内线性衰减。

### 锁仓参数

| 参数 | 值 |
|------|-----|
| 最短锁定 | 1 周 |
| 最长锁定 | 4 年 |
| 衰减方式 | 在锁仓期内线性衰减 |
| 表示形式 | ERC-721 NFT (veNFT) |

### 投票权计算公式

```
votingPower = (lockAmount × lockDuration) / maxDuration
```

其中 `maxDuration` = 4 年。锁定时间越长，获得的投票权越大：

| 锁仓期限 | 投票权（占锁仓金额的百分比） |
|----------|--------------------------|
| 4 年 | 100% |
| 2 年 | 50% |
| 1 年 | 25% |
| 6 个月 | 12.5% |

### veNFT 管理

| 操作 | 描述 |
|------|------|
| **创建** | 锁定 HDROME 以选择的期限铸造新的 veNFT |
| **增加金额** | 向现有 veNFT 添加更多 HDROME |
| **延长锁定** | 延长锁仓期限以增加投票权 |
| **合并** | 将两个 veNFT 合并为一个（期限协调） |
| **转让** | 将 veNFT 发送到另一个钱包（ERC-721 转账） |
| **提取** | 锁定到期后领取已解锁的 HDROME |

  锁定的 HDROME 在锁仓期满前无法提取。投票权线性衰减 — 以 1,000 HDROME 锁定 4 年，初始为 1,000 veHDROME，到期时降为 0。延长锁定以维持完整投票权。

---

#### 代币分配与排放

URL: https://docs.hyperdrome.finance/zh/tokenomics/distribution-emissions

HDROME 代币分配和排放计划的详细说明 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# 代币分配与排放

## 总供应量：1,000,000,000 HDROME

![${2}](${1})

| 类别 | 分配比例 | 数量 | 形式 | 详情 |
|------|---------|------|------|------|
| **协议** | 65% | 650,000,000 | HDROME | 排放、流动性和协议增长 |
| **预售** | 20% | 200,000,000 | HDROME | 详情即将公布 |
| **团队与贡献者** | 5% | 50,000,000 | veHDROME | 锁仓归属 |
| **社区空投** | 5% | 50,000,000 | veHDROME | 通过 MerkleClaim 进行 4 年锁仓 |
| **市场营销** | 5% | 50,000,000 | HDROME | 增长、合作伙伴关系和激励 |

  
    最大的分配保留给协议本身。包括奖励 LP 的 gauge 排放、协议自有流动性以及未来协议增长举措。该分配确保 Hyperdrome 生态系统的长期可持续性。
  
  
    200,000,000 HDROME 分配给预售轮次。更多详情将很快公布。
  
  
    50,000,000 HDROME 以 **veHDROME** 形式分发，附带锁仓归属。这使团队的激励与协议的长期成功保持一致 — 团队通过投票手续费和贿赂获益，而非出售代币。
  
  
    50,000,000 HDROME 以 **veHDROME** 形式通过 MerkleClaim 合约分发，锁定 4 年。接收者从第一天起即可获得投票权和手续费收入。
  
  
    50,000,000 HDROME 分配用于增长计划、战略合作伙伴关系、KOL 推广和生态系统激励。
  

---

## 排放计划

![${2}](${1})

### 每周排放

排放从**每周 15,000,000 HDROME** 开始，每个周期约衰减 1%：

```
weekly_emission(n) = weekly_emission(n-1) × 990 / 1000
```

| 时期 | 每周排放 | 累计排放 |
|------|---------|---------|
| 第 1 周 | 15,000,000 | 15,000,000 |
| 第 13 周（约 3 个月） | 13,100,000 | ~182,000,000 |
| 第 26 周（约 6 个月） | 11,600,000 | ~338,000,000 |
| 第 52 周（约 1 年） | 8,950,000 | ~573,000,000 |
| 第 104 周（约 2 年） | 5,340,000 | ~831,000,000 |

  当衰减后的排放量低于**流通供应量的 0.2%** 时，尾部排放下限将激活，以无限期维持最低排放速率。

### 每周分配比例

| 接收方 | 份额 | 描述 |
|--------|------|------|
| **Gauge** | ~96.7% | 根据 veHDROME 投票权重分配到流动性池 |
| **团队** | ~3% | 30 个基点给团队地址（最高 50 基点） |
| **增发补偿** | 可变 | 通过 RewardsDistributor 向 veHDROME 持有者发放抗稀释 HDROME |

---

## 周期循环

![${2}](${1})

每个周期从**每周四 00:00 UTC** 运行到下一个周四：

  
    统计上一周期的投票。Minter 根据衰减公式计算新的排放量。
  
  
    Minter 铸造 HDROME。Voter 合约根据投票权重按比例分配到各 gauge。RewardsDistributor 向 veHDROME 持有者发送增发补偿。
  
  
    veHDROME 持有者在各池之间分配投票。每个 veNFT 每周期只能投票一次。
  
  
    交易手续费和贿赂为投票者累积。LP 排放以每秒为基础持续流向 gauge 质押者。

---

#### veHDROME 与投票

URL: https://docs.hyperdrome.finance/zh/tokenomics/vehdrome-voting

veHDROME 投票的工作原理 — gauge 分配、收入来源和投票策略 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# veHDROME 与投票

![${2}](${1})

## 投票流程

每个周期（周四 00:00 UTC 至下周四 00:00 UTC），veHDROME 持有者将其投票权分配到各流动性池 gauge。流程如下：

1. **veHDROME 持有者**选择一个或多个池并分配投票权重（基于百分比）。
2. **Voter 合约**在周期翻转时统计所有投票。
3. **Minter** 铸造每周 HDROME 排放，并根据投票份额按比例分配到各 gauge。
4. **在 gauge 中质押的 LP** 在下一个周期以每秒为基础赚取 HDROME 排放。
5. **投票者**获得其投票池 100% 的交易手续费和外部贿赂。

## Gauge 系统

| 参数 | 值 |
|------|-----|
| 每个 Gauge 最大奖励代币数 | 16 |
| 周期时长 | 7 天（周四至周四 UTC） |
| 排放累积 | 每秒计算，按质押 LP 份额比例 |

---

## 收入来源

![${2}](${1})

veHDROME 投票者从三个不同的收入来源获益：

| 来源 | 来自 | 分配方式 |
|------|------|----------|
| **交易手续费** | 已投票池 100% 的兑换手续费 | 周期翻转后可领取 |
| **外部贿赂** | 协议为获取投票而存入 | 周期翻转后可领取 |
| **增发补偿** | Minter 发放的抗稀释 HDROME | 通过 RewardsDistributor 自动分配给 veHDROME 持有者 |

---

## 投票规则

| 规则 | 详情 |
|------|------|
| **每周期一次** | 每个 veNFT 每周期只能投票一次 |
| **锁定至翻转** | 投票一旦投出，在整个周期内锁定 |
| **需先重置** | 转让或合并 veNFT 前必须重置投票 |
| **更新** | 任何人都可以更新 veNFT 以反映其在现有分配中衰减后的投票权 |

## 投票策略

  
    投票给交易量相对于当前投票权重最高的池。高交易量但投票较少的池为每个 veHDROME 产生更多手续费。每个周期检查手续费/投票比率以识别权重不足的池。
  
  
    投票给有活跃外部贿赂的池。协议存入贿赂以吸引投票，贿赂/投票比率可能大幅超过手续费收入。比较贿赂总价值与当前投票权重以寻找最佳机会。
  
  
    如果您想为特定协议的代币增加流动性深度，请集中投票给其 gauge。这将引导更多 HDROME 排放到该池的 LP，吸引更多流动性并收窄代币的价差。
  

  投票一旦投出即在整个周期内锁定。您无法在下一次周期翻转前更改或撤回投票。投票前请仔细规划分配方案。

---

#### 池与流动性

URL: https://docs.hyperdrome.finance/zh/tokenomics/pools-liquidity

Hyperdrome 的双重 AMM 池架构、手续费结构和流动性提供 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# 池与流动性

![${2}](${1})

## 池架构

Hyperdrome 使用**双重 AMM** 设计，针对不同资产类别优化了两种池类型。PairFactory 通过 CREATE2 确定性部署池。每个池都有自己的手续费收取合约 (PairFees)，并可附加 gauge 以获取 HDROME 排放。每个池还包含内置的 TWAP 预言机，观察周期为 30 分钟。

### 波动池 (vAMM)

| 属性 | 值 |
|------|-----|
| 曲线 | `x * y = k`（恒定乘积） |
| 默认手续费 | 0.2% |
| 命名规则 | vAMM-TOKEN0/TOKEN1 |
| 最适用于 | 非相关资产对 (HYPE/USDC, HDROME/HYPE) |

### 稳定池 (sAMM)

| 属性 | 值 |
|------|-----|
| 曲线 | `x³y + y³x = k`（StableSwap 变体） |
| 默认手续费 | 0.02% |
| 命名规则 | sAMM-TOKEN0/TOKEN1 |
| 最适用于 | 锚定/相关资产对 (USDC/USDT, HYPE/stHYPE) |

---

## 手续费结构

| 参数 | 详情 |
|------|------|
| 波动池手续费 | 0.2%（可由 Fee Manager 调整） |
| 稳定池手续费 | 0.02%（可由 Fee Manager 调整） |
| 手续费接收方 | 100% 归该池 gauge 的 veHDROME 投票者所有 |
| 手续费收取 | 每笔兑换时收取至 PairFees 合约 |

---

## 兑换路由

Router 合约为任何代币兑换寻找最优路径。它检查所有可用池（波动池和稳定池），并在不存在直接交易对或多跳路径提供更好执行价格时构建多跳路由。例如，TOKEN_A 到 TOKEN_B 的兑换可能通过 TOKEN_A → HYPE → TOKEN_B 路由，如果这样可以减少滑点。

---

## 提供流动性

![${2}](${1})

  
    选择波动池 (vAMM) 或稳定池 (sAMM) 交易对。波动池适合非相关资产；稳定池适合锚定资产对。
  
  
    按当前池比例提供交易对中的两种代币。Router 会自动计算以最小化剩余零头。
  
  
    您将收到代表您在池中份额的 LP 代币。这些代币自动累积交易手续费。
  
  
    将 LP 代币存入池的 gauge 以赚取 HDROME 排放。未质押的 LP 获得零排放。
  

  存入后务必将 LP 代币在 gauge 中质押。未质押的 LP 仓位可以赚取交易手续费，但会错过 HDROME 排放 — 这通常占收益的大部分。

---

## 内置预言机

每个 Hyperdrome 池都包含 **TWAP（时间加权平均价格）预言机**，观察周期为 30 分钟。这提供了抗操纵的价格数据，可供 HyperEVM 上的其他协议使用。预言机存储累积价格观测值，可查询最大观测历史范围内的任何时间窗口。

---

#### 贿赂与奖励

URL: https://docs.hyperdrome.finance/zh/tokenomics/bribes-rewards

贿赂、交易手续费、排放和增发补偿如何在 Hyperdrome 生态系统中流动 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# 贿赂与奖励

![${2}](${1})

## 奖励流向

Hyperdrome 奖励系统有三个不同的流向，流向不同的参与者：

1. **LP 排放** — Minter 每个周期创建 HDROME。Voter 合约根据 veHDROME 投票权重将其分配到各 gauge。在 gauge 中质押的 LP 按其在 gauge 中的份额比例每秒赚取这些排放。

2. **交易手续费 + 外部贿赂 → 投票者** — 每个池 100% 的交易手续费以及为该池 gauge 存入的任何外部贿赂都流向投了该池的 veHDROME 持有者。这些奖励在每次周期翻转后可领取。

3. **增发补偿 → veHDROME 持有者** — RewardsDistributor 向所有 veHDROME 持有者按投票权比例发送抗稀释 HDROME 增发补偿，保护锁仓者免受排放稀释。

---

## 奖励类型

| 奖励 | 接收方 | 来源 | 时间 |
|------|--------|------|------|
| **LP 排放** | 在 gauge 中质押的 LP | 每周 HDROME 铸造 | 每秒累积 |
| **交易手续费** | veHDROME 投票者 | 100% 兑换手续费 | 周期翻转后可领取 |
| **外部贿赂** | veHDROME 投票者 | 协议存入 | 周期翻转后可领取 |
| **增发补偿** | 所有 veHDROME 持有者 | Minter 抗稀释机制 | 周期翻转时分配 |

---

## 外部贿赂

![${2}](${1})

外部贿赂允许协议激励 veHDROME 投票者将排放引导至特定池。这是协议在 Hyperdrome 上获取深度流动性的主要机制。

  
    协议在周期翻转前将代币存入特定 gauge 的 ExternalBribe 合约。
  
  
    在周期翻转时，贿赂对投票者可见。veHDROME 持有者在当前周期的投票决策中考虑贿赂价值。
  
  
    周期结束后，向该 gauge 分配投票的投票者可根据其投票权重按比例领取贿赂份额。
  

### 贿赂效率

* 协议通常每花费 $1 贿赂可获取 $2-5 的流动性
* 贿赂 ROI 因周期而异 — 总投票权重越低，每票回报越高
* 跨多个周期持续贿赂可建立持续的流动性深度
* 每个 gauge 最多可使用 16 种不同的奖励代币作为贿赂

---

## 内部贿赂（交易手续费）

内部贿赂不由外部方存入 — 它们是每个池产生的**交易手续费**。100% 的兑换手续费自动路由到该池 gauge 的 InternalBribe 合约。投票给该 gauge 的 veHDROME 投票者在每次周期翻转后领取这些手续费。交易量更高的池产生更多内部贿赂，使其成为有吸引力的投票目标。

---

## 增发补偿

增发补偿是通过 RewardsDistributor 合约分配给所有 veHDROME 持有者的抗稀释奖励。每个周期铸造新 HDROME 时，按比例分配相应数量的增发补偿以防止投票权稀释。增发补偿金额与已锁定 HDROME 占总流通供应量的比率成正比 — 锁定越多意味着增发补偿越高。

---

## 领取奖励

| 奖励类型 | 领取位置 | 频率 |
|----------|----------|------|
| LP 排放 | Gauge 合约 | 随时（每秒累积） |
| 交易手续费 | InternalBribe 合约 | 每次周期翻转后 |
| 外部贿赂 | ExternalBribe 合约 | 每次周期翻转后 |
| 增发补偿 | RewardsDistributor | 每次周期翻转后 |

  在 Hyperdrome 代理中使用 `/claim` 斜杠命令，一笔交易即可领取所有仓位的全部待领奖励。

---

#### 已部署合约

URL: https://docs.hyperdrome.finance/zh/tokenomics/deployed-contracts

Hyperdrome 生态系统中已部署智能合约及其功能列表 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# 已部署合约

## 网络信息

| 参数 | 值 |
|------|-----|
| 网络 | Hyperliquid EVM |
| Chain ID | `999` |
| RPC URL | `https://rpc.hyperliquid.xyz/evm` |
| 浏览器 | `https://explorer.hyperliquid.xyz` |
| 原生代币 | HYPE |

## 核心合约 (HyperEVM 主网)

| 合约 | 地址 |
|------|------|
| HDROME Token | `TBD` |
| VotingEscrow (veHDROME) | `TBD` |
| Voter | `TBD` |
| Router | `TBD` |
| PairFactory | `TBD` |
| GaugeFactory | `TBD` |
| BribeFactory | `TBD` |
| Minter | `TBD` |
| RewardsDistributor | `TBD` |
| MerkleClaim | `TBD` |
| VeArtProxy | `TBD` |
| HyperdromeLibrary | `TBD` |

  合约地址将在主网部署后在此公布。所有合约将在 Hyperliquid Explorer 上进行验证。

## 已知代币地址

| 代币 | 地址 | 精度 |
|------|------|------|
| WHYPE (Wrapped HYPE) | `0x5555555555555555555555555555555555555555` | 18 |
| USDC | `0xb88339CB7199b77E23DB6E890353E22632Ba630f` | 6 |
| USDT0 | `0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb` | 6 |

## 合约架构

| 层级 | 合约 | 用途 |
|------|------|------|
| **AMM 核心** | Pair, PairFees, PairFactory, Router | 代币兑换、流动性、手续费收取 |
| **代币与锁仓** | Hyperdrome, VotingEscrow, VeArtProxy | HDROME 代币、veNFT 创建和管理 |
| **投票与 Gauge** | Voter, Gauge, InternalBribe, ExternalBribe | 排放投票、LP 质押、贿赂分配 |
| **排放** | Minter, RewardsDistributor | 每周铸造、增发补偿分配 |
| **工厂** | PairFactory, GaugeFactory, BribeFactory | 确定性合约部署 |
| **治理** | L2Governor, HyperdromeGovernor (Multisig) | 链上提案、时间锁执行 |
| **空投** | MerkleClaim | Merkle 树空投（4 年 veHDROME 锁仓） |

  交互前请务必验证合约地址。仅使用本官方文档或 Hyperdrome 应用中列出的地址。

---

#### 安全性

URL: https://docs.hyperdrome.finance/zh/tokenomics/security

Hyperdrome 的安全措施和审计历史 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# 安全性

![${2}](${1})

## 代码库传承

Hyperdrome 基于 **Velodrome/Solidly** 代码库构建，这是 DeFi 中最经实战检验的 ve(3,3) 实现之一：

* **Solidly** — Andre Cronje 在 Fantom 上创建的原始 ve(3,3) AMM
* **Velodrome** — Optimism 上的改进分叉，OP 链上按 TVL 排名最大的 DEX

## 审计

| 审计 | 范围 | 报告 |
|------|------|------|
| Solidly 审计 | 核心 AMM、VotingEscrow、Minter | 可在代码库中查阅 |
| Velodrome 审计 | 全协议审查 | 可在代码库中查阅 |

## 智能合约安全

### 访问控制

| 角色 | 权限 |
|------|------|
| **Governor** | 白名单代币、创建 gauge、协议参数 |
| **Emergency Council** | 紧急情况下关闭/恢复 gauge |
| **Fee Manager** | 按池调整交易手续费率 |
| **Pauser** | 紧急情况下暂停所有兑换 |

### 时间锁

**HyperdromeGovernor** 多签包含按功能设置的时间锁：

* 每个函数选择器/目标地址组合的自定义延迟
* 批量交易执行支持
* 基于 0x 的 ZeroExGovernor 模式

### 核心安全特性

* **不可变 Minter 分配** — HDROME 代币上的 `setMinter()` 只能调用一次
* **CREATE2 确定性部署** — 交易对地址可预测且可验证
* **veNFT 附着系统** — 防止在 gauge 中质押时转让 veNFT
* **周期锁定投票** — 投票在周期内不可更改，防止操纵
* **TWAP 预言机** — 30 分钟观察周期抵抗价格操纵

## Solidity 版本

所有合约使用 **Solidity 0.8.13** 编译，包含标准的溢出/下溢保护。

## 测试套件

协议包含 **21 个 Foundry 测试文件**，覆盖：

* AMM 交易对机制和手续费核算
* veNFT 锁定/解锁/合并操作
* 排放计算和衰减计划
* Gauge 质押和奖励分配
* 投票机制和周期转换
* 紧急 gauge 关闭/恢复
* Merkle claim 空投分配
* 链上治理提案
* 反刷量交易保护
* 预言机精度和边界情况

---

### 智能代理

#### 智能代理概览

URL: https://docs.hyperdrome.finance/zh/agentic/overview

Hyperdrome 代理 — Hyperliquid 上 ve(3,3) DEX 的 AI 原生界面 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# Hyperdrome 代理

![${2}](${1})

## 不是带有 AI 的 DEX — 而是拥有 DEX 的 AI 代理

Hyperdrome 以 AI 优先构建。代理不是附加在交易界面上的聊天机器人 — 它**本身就是**界面。每一个 DeFi 操作（兑换、LP、锁仓、投票、领取奖励）都可以通过自然语言对话或斜杠命令完成。传统 UI 作为备选方案存在，但代理是用户与协议交互的主要方式。

---

## 架构

Hyperdrome 代理使用 LLM 路由层来解析用户意图并将其映射到链上操作。当用户发送消息时，代理会：

1. **解析意图** — LLM 分析消息以确定用户想要执行的操作（兑换、LP、投票、查看投资组合等）
2. **收集上下文** — 读取链上状态（钱包余额、池数据、veNFT 仓位、待领奖励）和链下数据（价格、TVL、APR）
3. **生成响应** — 生成自然语言解释，并附带丰富的 UI 卡片展示建议操作、参数和预期结果
4. **经确认后执行** — 当用户确认后，代理构建并提交交易

代理支持多个 LLM 后端（Claude、GPT-4、Gemini），对用户零成本。

---

## 对话式 DeFi

用户通过对话提示与完整协议交互：

* *"将 100 USDC 兑换为 HYPE"*
* *"我有哪些待领取的奖励？"*
* *"锁定 1000 HDROME，期限 4 年"*
* *"将我所有的 veHDROME 投票给 HYPE/USDC 池"*
* *"目前最佳收益率是多少？"*

代理在后台处理路由、滑点、Gas 估算和交易构建。

---

## 斜杠命令

| 命令 | 操作 |
|------|------|
| `/swap` | 通过优化路由兑换代币 |
| `/lp` | 向池中添加或移除流动性 |
| `/vote` | 在各 gauge 之间分配 veHDROME 投票 |
| `/lock` | 锁定 HDROME 以创建或延长 veNFT |
| `/claim` | 领取所有待领取奖励（排放、手续费、贿赂） |
| `/help` | 显示可用命令和用法 |

---

## 丰富 UI 卡片

代理为每个操作渲染交互式卡片 — 不仅仅是文字响应。卡片展示：

* **兑换卡片** — 代币对、数量、价格影响、路由路径、滑点容忍度
* **LP 卡片** — 池对、TVL、APR、你的份额、存入金额
* **投票卡片** — Gauge 列表、当前投票权重、预估手续费/贿赂收入
* **投资组合卡片** — 代币余额、LP 仓位、veNFT 详情、待领奖励
* **奖励卡片** — 可领取的排放、手续费和贿赂的明细及美元价值

---

## 可执行操作

| 类别 | 操作 |
|------|------|
| **交易** | 兑换代币、多跳路由、设置滑点 |
| **流动性** | 添加流动性、移除流动性、在 gauge 中质押、从 gauge 取消质押 |
| **锁仓** | 创建 veNFT、增加锁仓金额、延长锁仓期限、合并 veNFT |
| **投票** | 投票给 gauge、重置投票、更新过期投票 |
| **奖励** | 领取排放、领取手续费、领取贿赂、领取增发补偿 |
| **投资组合** | 查看余额、查看仓位、查看待领奖励、获取收益建议 |

---

## 智能建议

代理基于钱包状态主动发现优化机会：

| 优先级 | 触发条件 | 建议 |
|--------|----------|------|
| **高** | 检测到未质押的 LP 代币 | 在 gauge 中质押以赚取排放奖励 |
| **高** | 未领取奖励 > $10 | 领取并复投待领奖励 |
| **高** | veNFT 将在 7 天内到期 | 延长锁定以维持投票权 |
| **中** | 闲置代币 > $10 未在 LP/锁仓中 | 提供流动性或锁定获取 veHDROME |
| **中** | 投票分配不够优化 | 将投票重新平衡到更高收益的 gauge |
| **低** | 新的高 APR 池可用 | 考虑在热门池中提供流动性 |

---

## 与 LLM 无关的架构

Hyperdrome 代理**不绑定单一 AI 提供商**。架构将意图解析、上下文收集和执行分离为独立层 — 因此 LLM 后端可以随意替换，而无需更改其他任何内容。

| 层 | 角色 | 需要 LLM？ |
|----|------|-----------|
| **Intent Parser** | 理解用户想要什么 | 是 — 任何 LLM |
| **Context Gatherer** | 读取链上 + 链下数据 | 否 |
| **Responder** | 生成解释 + UI 卡片 | 是 — 任何 LLM |
| **Executor** | 构建并提交交易 | 否 |

目前支持 **Claude**、**GPT-4** 和 **Gemini** 并具备智能路由。开源模型（Llama、Mistral、Qwen）和自带 LLM 功能在路线图中。

  ### LLM 集成
    多模型支持、路由和自带 LLM
  

  ### MCP 服务器
    通过 MCP 将任何 AI 助手连接到 Hyperdrome
  

  ### 代理框架
    GOAT SDK、Wayfinder、Eliza、Olas、REST API
  

---

## 多语言支持

代理以用户的语言回复。英语、中文、日语、韩语、西班牙语、法语、葡萄牙语、土耳其语、俄语、阿拉伯语及其他语言均通过底层 LLM 能力原生支持。UI 标签和斜杠命令保持英语，但所有对话响应会自动适配用户的语言。

---

#### LLM 集成

URL: https://docs.hyperdrome.finance/zh/agentic/llm-integrations

Hyperdrome 如何连接任意 LLM — Claude、GPT-4、Gemini、Llama、Mistral 等 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# LLM 集成

![${2}](${1})

## 设计上与 LLM 无关

Hyperdrome 不绑定单一 AI 提供商。代理架构将**意图解析**、**上下文收集**和**执行**分离为独立层 — 因此 LLM 后端可以随意替换，而无需更改其他任何内容。

这意味着 Hyperdrome 可以与当前的任何大语言模型配合使用，也将兼容未来发布的任何模型。

---

## 支持的模型

  ### Claude
    Opus, Sonnet, Haiku — **已上线**
  

  ### GPT-4
    GPT-4o, GPT-4, GPT-4 Turbo — **已上线**
  

  ### Gemini
    Gemini 2.5 Pro, 2.5 Flash — **已上线**
  

  ### 开源模型
    Llama, Mistral, Qwen, DeepSeek — *计划中*
  

  所有模型对用户**零成本**。Hyperdrome 承担推理费用。

---

## 架构

代理管线在每个阶段都与模型无关：

```
User Input (natural language or /command)
        │
        ▼
┌──────────────────┐
│  Intent Parser   │ ← Any LLM (Claude, GPT-4, Gemini, Llama...)
│  "What does the  │
│   user want?"    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Context Gatherer │ ← On-chain + off-chain data (no LLM needed)
│  Wallet, pools,  │
│  prices, APRs    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Responder     │ ← Any LLM (generates explanation + UI cards)
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Executor      │ ← Transaction builder (no LLM needed)
│  Build tx, sign, │
│  submit on-chain │
└──────────────────┘
```

LLM 仅参与两个步骤：理解用户想要什么，以及解释结果。其他一切 — 读取区块链状态、构建交易、链上提交 — 都是确定性代码。

---

## 智能路由

后端根据以下因素自动选择最佳模型：

| 因素 | 逻辑 |
|------|------|
| **复杂度** | 简单查询（价格查看、余额）→ 最快模型。复杂的多步操作 → 最强模型。 |
| **语言** | 某些模型在特定语言上表现更好。路由器会针对用户检测到的语言进行优化。 |
| **延迟** | 如果主模型响应缓慢或不可用，路由器会在 500ms 内切换到次优选项。 |
| **成本** | 路由器在能力与成本之间取得平衡，确保所有用户免费使用推理服务。 |

---

## 自带 LLM *（即将推出）*

  此功能在路线图中，尚未上线。

用户将能够连接自己的 LLM 提供商：

* **API key** — 接入您自己的 OpenAI、Anthropic、Google 或任何 OpenAI 兼容的 API key
* **自托管模型** — 将代理指向您自己运行 Llama、Mistral、Qwen 或任何开源模型的 Ollama、vLLM 或 TGI 端点
* **自定义系统提示** — 定制代理的个性、风险偏好和响应风格
* **完全隐私** — 使用您自己的模型时，不会有任何数据经过 Hyperdrome 的推理服务器

### 兼容端点

任何实现 OpenAI Chat Completions API 格式的端点均可使用：

| Runtime | Example Models |
|---------|---------------|
| **Ollama** | Llama 3.3, Mistral, Qwen 2.5, DeepSeek V3, Gemma |
| **vLLM** | Any HuggingFace model |
| **TGI** | Any HuggingFace model |
| **Together AI** | Llama, Mixtral, Qwen |
| **Groq** | Llama, Mixtral, Gemma |
| **Fireworks** | Llama, Mixtral, DeepSeek |

---

## 为什么与 LLM 无关很重要

1. **无供应商锁定** — 如果提供商提高价格、降低质量或增加限制，Hyperdrome 可以无缝切换。

2. **为任务选择最佳模型** — 不同模型擅长不同任务。路由机制让 Hyperdrome 为每个请求使用最佳工具。

3. **面向未来** — 新模型每月发布。与 LLM 无关的架构意味着 Hyperdrome 可以立即采用，无需重写。

4. **用户主权** — 通过自带 LLM，用户掌控自己的数据和推理。不依赖中心化 AI 提供商。

5. **抗审查** — 开源模型不会被关闭或限制。运行自己的 Llama 或 Mistral 实例的用户拥有完全自主权。

---

#### MCP 服务器

URL: https://docs.hyperdrome.finance/zh/agentic/mcp-server

Hyperdrome 的 Model Context Protocol 服务器 — 将任何 AI 助手连接到 ve(3,3) DEX 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# MCP 服务器

![${2}](${1})

  Hyperdrome MCP 服务器在路线图中，尚未上线。本页记录了计划中的规格。

## 什么是 MCP？

**Model Context Protocol (MCP)** 是 Anthropic 推出的开放标准，允许 AI 助手发现并调用外部服务器上的工具。它使用 JSON-RPC 2.0 — 助手调用 `tools/list` 发现可用操作，然后调用 `tools/call` 执行它们。

MCP 已被 **Claude Desktop**、**Cursor**、**Opencode**、**Windsurf** 以及越来越多的 AI 编程和聊天工具支持。

---

## 为什么将 MCP 用于 DeFi？

目前，与 DeFi 交互需要：
1. 打开浏览器
2. 连接钱包
3. 在复杂的 UI 中导航
4. 理解滑点、路由、Gas

通过 Hyperdrome 的 MCP 服务器，任何 AI 助手都可以**直接**兑换代币、查看收益、投票给 gauge、管理仓位 — 用户无需离开他们偏好的工具。

> *"在 Hyperdrome 上将 500 USDC 兑换为 HYPE"* — 在 Claude Desktop、Cursor 或任何 MCP 客户端中输入即可。

---

## 可用工具

MCP 服务器将完整的 Hyperdrome 协议暴露为可调用工具：

### Trading

| Tool | Description | Parameters |
|------|-------------|------------|
| `swap` | Swap tokens with optimized multi-hop routing | `fromToken`, `toToken`, `amount`, `slippageBps?` |
| `get_quote` | Get a swap quote without executing | `fromToken`, `toToken`, `amount` |

### Liquidity

| Tool | Description | Parameters |
|------|-------------|------------|
| `add_liquidity` | Deposit token pair into a pool | `tokenA`, `tokenB`, `amountA`, `amountB`, `stable` |
| `remove_liquidity` | Withdraw from a pool | `tokenA`, `tokenB`, `stable`, `liquidity` |
| `stake_lp` | Stake LP tokens in a gauge | `pool`, `amount` |
| `unstake_lp` | Unstake LP tokens from a gauge | `pool`, `amount` |

### Locking & Voting

| Tool | Description | Parameters |
|------|-------------|------------|
| `lock` | Lock HDROME to create or extend a veNFT | `amount`, `duration` |
| `vote` | Allocate veHDROME votes across gauges | `tokenId`, `pools[]`, `weights[]` |
| `reset_votes` | Reset votes for a veNFT | `tokenId` |

### Rewards

| Tool | Description | Parameters |
|------|-------------|------------|
| `claim_rewards` | Claim all pending rewards | `tokenId?` |
| `claim_fees` | Claim trading fees for a specific gauge | `gauge` |
| `claim_bribes` | Claim external bribes | `gauge`, `tokens[]` |

### Read-Only

| Tool | Description | Parameters |
|------|-------------|------------|
| `get_pools` | List all pools with TVL, APR, volume | `sortBy?`, `limit?` |
| `get_portfolio` | Full wallet analysis | `address` |
| `get_yields` | Top yield opportunities | `limit?`, `minTvl?` |
| `get_venft` | Get veNFT details | `tokenId` |
| `get_pending_rewards` | Check unclaimed rewards | `address` |

---

## Tool Schema 示例

每个工具遵循 MCP 规范，使用 JSON Schema 定义输入：

```json
{
  "name": "swap",
  "description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromToken": {
        "type": "string",
        "description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
      },
      "toToken": {
        "type": "string",
        "description": "Token symbol or address to buy (e.g. 'HYPE')"
      },
      "amount": {
        "type": "string",
        "description": "Amount to swap in human-readable units (e.g. '100')"
      },
      "slippageBps": {
        "type": "number",
        "description": "Max slippage in basis points (default: 50 = 0.5%)"
      }
    },
    "required": ["fromToken", "toToken", "amount"]
  }
}
```

---

## 连接

### Claude Desktop / Cursor / Opencode

添加到您的 MCP 配置中：

```json
{
  "mcpServers": {
    "hyperdrome": {
      "url": "https://mcp.hyperdrome.finance/sse"
    }
  }
}
```

### 自托管

MCP 服务器将开源。运行您自己的实例：

```bash
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
```

---

## 安全模型

| 属性 | 详情 |
|------|------|
| **默认只读** | 投资组合查询和池数据无需钱包连接 |
| **交易审批** | 所有写操作返回未签名交易供用户审查和签名 |
| **无私钥** | 托管的 MCP 服务器从不接触私钥。签名在客户端完成。 |
| **速率限制** | 按 IP 和 API key 的速率限制以防止滥用 |
| **审计跟踪** | 每次工具调用都记录时间戳、参数和结果 |

  MCP 服务器从不代表您执行交易。它构建交易并返回供您明确批准 — 就像任何 DeFi 前端一样。

---

## 使用场景

| 场景 | 方式 |
|------|------|
| **构建 DeFi 仪表盘的开发者** | 通过 MCP 工具查询池、收益和仓位 |
| **AI 编程助手** | "帮我写一个脚本来领取我所有的 Hyperdrome 奖励" — 助手调用 `get_pending_rewards` 然后 `claim_rewards` |
| **自主代理** | 投资组合管理代理每小时检查收益并通过 `add_liquidity` / `remove_liquidity` 进行再平衡 |
| **聊天机器人** | Telegram 机器人，让用户通过自然语言进行兑换、查看投资组合和投票 |
| **研究** | 分析师查询 `get_pools` 以构建跨 HyperEVM DEX 的收益对比 |

---

#### 代理框架集成

URL: https://docs.hyperdrome.finance/zh/agentic/agent-frameworks

Hyperdrome 如何与 GOAT SDK、Wayfinder、Eliza、Olas 及更广泛的 AI 代理生态系统集成 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# 代理框架集成

![${2}](${1})

Hyperdrome 被设计为可从**任何 AI 代理**访问，而不仅仅是我们自己的代理。协议通过多个集成层暴露其功能，以便第三方代理、框架和平台可以原生地与 Hyperdrome 交互。

  ### GOAT SDK
    200+ 工具，13+ 框架适配器
  
  ### MCP
    Claude Desktop, Cursor, Opencode
  
  ### Wayfinder
    AI 原生 DeFi 终端
  
  ### Eliza
    自主社交 + DeFi 代理
  
  ### Olas
    去中心化自主代理
  
  ### REST API
    直接 HTTP 端点
  

---

## 集成架构

```
┌─────────────────────────────────────────────────┐
│              AI Agent Frameworks                 │
│  Claude · GPT · Gemini · Llama · Mistral · ...  │
├─────────────────────────────────────────────────┤
│              Adapter Layer                       │
│  GOAT SDK · Wayfinder · Eliza · LangChain ·     │
│  Vercel AI · MCP · REST API                     │
├─────────────────────────────────────────────────┤
│           Hyperdrome Protocol Layer              │
│  Intent Parser → Context → Tx Builder → Chain   │
├─────────────────────────────────────────────────┤
│                 HyperEVM                         │
│  Router · Voter · Gauges · VotingEscrow · ...   │
└─────────────────────────────────────────────────┘
```

任何支持适配层之一的框架都可以与 Hyperdrome 交互。无需自定义集成代码。

---

## GOAT SDK Plugin

  GOAT SDK plugin 在路线图中，尚未发布。

**GOAT SDK** 是最大的代理金融工具集 — 200+ 工具、15+ 链、13+ 框架适配器。Uniswap、Aave、1inch 和 Balancer 等协议已经拥有 GOAT plugin。

Hyperdrome 将发布 `@goat-sdk/plugin-hyperdrome`，提供完整的协议覆盖：

### 暴露的操作

| Action | Description |
|--------|-------------|
| `swap` | Swap tokens with optimized routing |
| `addLiquidity` | Deposit into volatile or stable pools |
| `removeLiquidity` | Withdraw from pools |
| `stakeLp` | Stake LP tokens in gauges |
| `unstakeLp` | Unstake from gauges |
| `lock` | Lock HDROME → veHDROME (create/extend veNFT) |
| `vote` | Allocate votes across gauges |
| `claimRewards` | Claim emissions, fees, bribes, rebases |
| `getPools` | List pools with TVL, APR, volume |
| `getPortfolio` | Full wallet analysis |

### 框架覆盖

GOAT plugin 发布后，Hyperdrome 将自动在以下框架中可用：

| Framework | Type |
|-----------|------|
| **Vercel AI SDK** | Full-stack AI apps |
| **LangChain** | Agent orchestration (Python & JS) |
| **LlamaIndex** | Data-augmented agents |
| **MCP** | Claude Desktop, Cursor, Opencode |
| **Eliza** | Autonomous social + DeFi agents |
| **CrewAI** | Multi-agent systems |
| **Mastra** | TypeScript agent framework |
| **GAME (Virtuals)** | Gaming + DeFi agents |
| **OpenAI Agents SDK** | OpenAI's native agent runtime |
| **ZerePy** | Python agent framework |
| **AutoGen** | Microsoft's multi-agent framework |
| **Olas** | Decentralized autonomous agents |

---

## Wayfinder Paths

  Wayfinder 集成在路线图中，尚未上线。

**Wayfinder** 是一个 AI 原生的 DeFi 终端，拥有自己的 SDK (Paths)。它已支持 Hyperliquid 永续合约、Aave V3、Morpho、Pendle 和 Uniswap V3。

Hyperdrome 将发布 **Wayfinder 协议适配器**，支持：

* 通过 Wayfinder Shells（AI 交易界面）进行兑换、LP、投票和锁仓
* 策略组合 — 将 Hyperdrome 收益与跨协议策略结合
* MCP 桥接 — Wayfinder 内置的 MCP 服务器将暴露 Hyperdrome 工具

---

## Eliza (ElizaOS)

**Eliza** 是领先的开源自主加密代理框架。它驱动在 Twitter、Telegram 和链上运行的社交 + DeFi 机器人。

Hyperdrome 通过 GOAT plugin (`@elizaos/plugin-goat`) 集成：

* Eliza 代理可以在 Hyperdrome 上兑换、LP、投票和领取奖励
* 自主收益耕作 — 代理监控 APR 并再平衡仓位
* 社交 + DeFi — 代理发布收益更新、回答社区问题并执行交易

---

## Olas (Autonolas)

**Olas** 是一个去中心化的平台，用于共同拥有和运行自主 AI 代理。已部署 3,600+ 代理，17M+ 笔交易。

Hyperdrome 集成路径：

* 构建管理 Hyperdrome 仓位的 **Olas agent service**
* 在 Olas 市场注册为 **Mech** — 其他代理可以雇用 Hyperdrome 操作
* 与现有 Olas 代理组合实现跨协议策略

---

## REST API

  公共 REST API 在路线图中，尚未上线。

面向希望无需框架直接集成的开发者：

### 计划中的端点

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/api/pools` | List all pools with TVL, APR, fees, volume |
| `GET` | `/api/pools/:address` | Pool details |
| `GET` | `/api/portfolio/:wallet` | Full portfolio analysis |
| `GET` | `/api/yields` | Top yield opportunities |
| `POST` | `/api/quote` | Get a swap quote |
| `POST` | `/api/swap` | Build a swap transaction |
| `POST` | `/api/liquidity/add` | Build an add-liquidity transaction |
| `POST` | `/api/liquidity/remove` | Build a remove-liquidity transaction |
| `POST` | `/api/lock` | Build a lock transaction |
| `POST` | `/api/vote` | Build a vote transaction |
| `POST` | `/api/claim` | Build a claim-all transaction |

### 响应格式

所有写端点返回未签名的交易数据：

```json
{
  "tx": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "chainId": 999,
    "gasLimit": "250000"
  },
  "summary": {
    "action": "Swap 100 USDC → 1.62 HYPE",
    "priceImpact": "0.03%",
    "route": ["USDC", "HYPE"],
    "minReceived": "1.611 HYPE"
  }
}
```

  API 从不要求私钥。所有交易均以未签名状态返回，供客户端签名。

---

## LangChain Tool

面向直接使用 LangChain 的 Python 开发者：

```python
from langchain.tools import tool

@tool
def hyperdrome_swap(from_token: str, to_token: str, amount: str) -> str:
    """Swap tokens on Hyperdrome (HyperEVM). Returns unsigned transaction."""
    # Calls Hyperdrome REST API
    ...
```

GOAT SDK 适配器会自动处理此操作，但开发者也可以直接针对 REST API 构建自定义 LangChain 工具。

---

## 构建您自己的集成

想要将 Hyperdrome 集成到您的代理、机器人或应用中？

1. **最快** — 使用 GOAT SDK plugin。开箱即用支持 13+ 框架。
2. **最灵活** — 直接使用 REST API。用任何语言构建和签名交易。
3. **AI 原生** — 通过 MCP 连接。支持 Claude Desktop、Cursor、Opencode 及任何 MCP 客户端。
4. **自主化** — 构建 Olas agent service，实现完全去中心化的链上代理执行。

所有集成层返回未签名交易 — 您的应用负责签名和提交。Hyperdrome 从不接触私钥。

---

#### 代理能力与路线图

URL: https://docs.hyperdrome.finance/zh/agentic/capabilities

Hyperdrome 代理的完整能力、数据源和即将推出的功能 包含关键数值、操作流程和面向 Hyperdrome 用户的 HyperEVM 参考信息。

# 代理能力与路线图

## 实时数据源

| 来源 | 数据 | 更新频率 |
|------|------|----------|
| **HyperEVM RPC** | 钱包余额、LP 仓位、veNFT 详情、gauge 质押、待领奖励 | 实时 |
| **CoinGecko** | HYPE、USDC、USDT、BTC、ETH、SOL 价格 + 24 小时变化 + 市值 + 交易量 | 60 秒缓存 |
| **DeFiLlama** | Hyperliquid L1 链 TVL、前 20 协议的 TVL/分类/7 日变化 | 60 秒缓存 |
| **Hyperliquid API** | 所有现货代币的标记价格、24 小时交易量、流通供应量 | 60 秒缓存 |
| **协议合约** | 池储备、TVL、APR、投票权重、贿赂金额、排放速率 | 实时 |

## 钱包分析

当您的钱包连接后，代理会执行深度投资组合分析：

* **代币余额**及美元价值（按价值排序）
* **闲置资金检测** — 超过 $10 且未在 LP/锁仓中的代币
* **LP 仓位** — 交易对、稳定/波动类型、已质押/未质押、TVL、APR、gauge 地址
* **未质押 LP 检测** — 获得零排放的 LP
* **veNFT** — 锁仓金额、到期日、剩余天数、已到期/即将到期标志、投票权、投票状态
* **待领奖励** — 排放、贿赂、手续费 — 按交易对细分并附美元总计
* **APR 排名前 10 的池**供推荐使用

## 路线图

| 功能 | 状态 |
|------|------|
| 对话式 DeFi（网页端） | **已上线** |
| 斜杠命令 | **已上线** |
| 丰富 UI 卡片 | **已上线** |
| 智能建议 | **已上线** |
| 多 LLM 后端（Claude、GPT-4、Gemini） | **已上线** |
| Telegram 超级代理 | **开发中** |
| MCP 服务器 | 计划中 |
| GOAT SDK Plugin | 计划中 |
| 公共 REST API | 计划中 |
| Wayfinder 集成 | 计划中 |
| 自带 LLM | 计划中 |
| 自动驾驶 | 计划中 |
| 内容引擎 | 计划中 |
| 动态 veNFT 头像 | 计划中 |
| 贿赂优化器 | 计划中 |
| 收益报告 | 计划中 |
| AI 国库 | 计划中 |

### 自动驾驶 *（即将推出）*

"存入即可" — 代理自动管理您的整个 DeFi 仓位。

| 风险偏好 | 目标 APY | 策略 |
|----------|----------|------|
| **保守型** | 8-15% | 稳定池、最长锁仓、蓝筹交易对 |
| **平衡型** | 15-30% | 稳定/波动混合、中等锁仓 |
| **激进型** | 30-80% | 波动池、贿赂挖矿、主动再平衡 |
| **冒险型** | 50-200% | 新池、最大贿赂捕获、短期锁仓 |

代理负责：LP 仓位管理、gauge 质押、veHDROME 投票、奖励领取、复投再投资和再平衡 — 全天候 24/7 无需用户干预。

**收入模式**：自动驾驶收益收取 5% 的绩效费。

### Telegram 超级代理 *（即将推出）*

一个机器人即可体验完整的 Hyperdrome：
* 兑换、收益、投资组合、领取、自动驾驶
* 教育、提醒、表情包生成
* 头像生成、贿赂分析、收益报告

### 贿赂优化器 *（即将推出）*

面向协议的 B2B 工具：
* 输入：流动性目标（例如"TOKEN/HYPE 需要 $500K TVL"）
* 输出：精确贿赂金额、预估 ROI、推荐周期时机
* 跟踪贿赂效率随时间的变化

### 动态 veNFT 头像 *（即将推出）*

基于以下因素演变的 AI 生成头像：
* 锁仓期限和金额
* 投票活动和连续投票次数
* 总收益
* 协议使用时长

### AI 国库 *（即将推出）*

自主国库管理：
* AI 每个周期最多分配 30% 的国库资金
* 执行前 12 小时公布决策
* 社区否决机制
* 完全链上透明

## 隐私

* 仅读取已连接钱包的公开链上数据
* 会话间不存储钱包数据
* 对话内容不在服务器端持久化

---

## es - Spanish

### Primeros Pasos

#### Introduccion

URL: https://docs.hyperdrome.finance/es/introduction

Bienvenido a Hyperdrome - El DEX Agentico ve(3,3) en Hyperliquid. Con valores, flujos y referencias HyperEVM.

## Que es Hyperdrome?

Hyperdrome es el **DEX agentico ve(3,3)** en Hyperliquid. Combina un AMM probado en batalla (fork de Aerodrome/Velodrome) con un agente impulsado por IA que gestiona swaps, liquidez, votaciones y optimizacion de rendimiento a traves de lenguaje natural.

El producto **no es un DEX con IA — es un agente de IA con un DEX.**

## El Sistema ve(3,3)

El modelo ve(3,3) crea un ciclo sostenible donde cada participante se beneficia de la cooperacion:

![${2}](${1})

### Componentes Principales

1. **Voto en Custodia (ve)**
   * Bloquea HDROME para recibir poder de voto veHDROME (hasta 4 anos)
   * Bloqueos mas largos = mas poder de voto, con decaimiento lineal
   * La posicion bloqueada se representa como un NFT ERC-721

2. **Teoria de Juegos (3,3)**
   * La cooperacion es la estrategia dominante para todos los participantes
   * Los votantes ganan el 100% de las comisiones de trading + sobornos externos
   * Los rebases anti-dilucion protegen a los bloqueadores a largo plazo

### Beneficios

* **Emisiones Sostenibles**: ~1% de decaimiento semanal con un piso del 0.2% del suministro circulante
* **Poder de Voto**: Distribucion semanal directa de emisiones entre gauges
* **Distribucion de Comisiones**: 100% de las comisiones de trading para los votantes de veHDROME
* **Mercado de Sobornos**: Los protocolos adquieren liquidez a una fraccion del costo de incentivos directos

## Diseno de AMM Dual

| Tipo de Pool | Curva | Comision Predeterminada | Ideal Para |
|-----------|-------|-------------|----------|
| **Volatil (vAMM)** | `x * y = k` | 0.2% | HYPE/USDC, HDROME/HYPE |
| **Estable (sAMM)** | `x³y + y³x = k` | 0.02% | USDC/USDT, pares vinculados |

Cada pool incluye un **oraculo TWAP** integrado con periodos de observacion de 30 minutos.

## Construido en HyperEVM

| Propiedad | Valor |
|----------|-------|
| Cadena | HyperEVM |
| Chain ID | 999 |
| Token Nativo | HYPE |
| RPC | `https://rpc.hyperliquid.xyz/evm` |
| Explorador | `https://explorer.hyperliquid.xyz` |

## Primeros Pasos

  ### Lanzar App
    Comienza a operar, proveer liquidez y ganar recompensas
  

  ### Intercambiar Tokens
    Opera tokens con enrutamiento multi-salto optimizado
  

  ### Proveer Liquidez
    Deposita pares de tokens y haz staking en gauges para emisiones
  

  ### Bloquear y Votar
    Bloquea HDROME por veHDROME y dirige las emisiones del protocolo
  

## Por que Hyperdrome?

* **IA Nativa**: Agente integrado que gestiona la complejidad DeFi mediante lenguaje natural y comandos slash
* **Codigo Probado**: Fork de Aerodrome/Velodrome — la implementacion ve(3,3) mas probada en batalla
* **Autopilot** *(proximamente)*: Deposita y Relajate — la IA gestiona LP, staking, votacion, rebalanceo y composicion 24/7
* **$0 en Costos de IA**: Acceso ilimitado a Claude, GPT-4 y Gemini sin costo marginal por usuario
* **Optimizador de Sobornos** *(proximamente)*: Herramienta B2B — los protocolos ingresan un objetivo de liquidez, la IA devuelve el monto exacto de soborno + ROI proyectado

---

### Tokenomics

#### Token HDROME

URL: https://docs.hyperdrome.finance/es/tokenomics/hdrome-token

El token HDROME impulsa el DEX ve(3,3) de Hyperdrome en Hyperliquid — bloquea, vota y gana. Con valores, flujos y referencias HyperEVM.

# Token HDROME

![${2}](${1})

## Detalles del Token

| Propiedad | Valor |
|----------|-------|
| Simbolo | HDROME |
| Decimales | 18 |
| Cadena | HyperEVM (Chain ID 999) |
| Estandar | ERC-20 |
| Suministro Total | 1,000,000,000 |

## Utilidades Principales

HDROME es el token nativo del protocolo Hyperdrome. Sus utilidades principales:

* **Bloquear por veHDROME** — Bloquea HDROME para recibir poder de voto veHDROME como un NFT ERC-721
* **Gobernanza** — Los poseedores de veHDROME gobiernan los parametros del protocolo y la asignacion de emisiones
* **Votacion de Gauges** — Dirige las emisiones semanales de HDROME a los pools de liquidez de tu eleccion
* **100% de Comisiones de Trading** — Los votantes ganan el 100% de las comisiones de trading de los pools por los que votan
* **Sobornos** — Gana sobornos externos depositados por protocolos que buscan liquidez
* **Rebases** — Los rebases anti-dilucion de HDROME protegen a los bloqueadores a largo plazo de la dilucion por emisiones

---

## Mecanica de Bloqueo

![${2}](${1})

Bloquear HDROME crea una posicion **veHDROME** representada como un NFT ERC-721 (veNFT). El poder de voto decae linealmente durante la duracion del bloqueo.

### Parametros de Bloqueo

| Parametro | Valor |
|-----------|-------|
| Bloqueo Minimo | 1 semana |
| Bloqueo Maximo | 4 anos |
| Decaimiento | Lineal durante la duracion del bloqueo |
| Representacion | NFT ERC-721 (veNFT) |

### Formula de Poder de Voto

```
votingPower = (lockAmount × lockDuration) / maxDuration
```

Donde `maxDuration` = 4 anos. Cuanto mas tiempo bloquees, mas poder de voto recibes:

| Duracion del Bloqueo | Poder de Voto (% del monto bloqueado) |
|---------------|----------------------------------|
| 4 anos | 100% |
| 2 anos | 50% |
| 1 ano | 25% |
| 6 meses | 12.5% |

### Gestion de veNFT

| Accion | Descripcion |
|--------|-------------|
| **Crear** | Bloquea HDROME para acunar un nuevo veNFT con la duracion elegida |
| **Aumentar Monto** | Agrega mas HDROME a un veNFT existente |
| **Extender Bloqueo** | Extiende la duracion del bloqueo para aumentar el poder de voto |
| **Fusionar** | Combina dos veNFTs en uno (las duraciones se reconcilian) |
| **Transferir** | Envia tu veNFT a otra billetera (transferencia ERC-721) |
| **Retirar** | Reclama HDROME desbloqueado despues del vencimiento del bloqueo |

  El HDROME bloqueado no puede retirarse hasta que expire el bloqueo. El poder de voto decae linealmente — un bloqueo de 4 anos con 1,000 HDROME comienza en 1,000 veHDROME y llega a 0 al vencimiento. Extiende tu bloqueo para mantener el poder de voto completo.

---

#### Distribucion de Tokens y Emisiones

URL: https://docs.hyperdrome.finance/es/tokenomics/distribution-emissions

Desglose detallado de la distribucion del token HDROME y el calendario de emisiones. Con valores, flujos y referencias HyperEVM.

# Distribucion de Tokens y Emisiones

## Suministro Total: 1,000,000,000 HDROME

![${2}](${1})

| Categoria | Asignacion | Cantidad | Forma | Detalles |
|----------|-----------|--------|------|---------|
| **Protocolo** | 65% | 650,000,000 | HDROME | Emisiones, liquidez y crecimiento del protocolo |
| **Preventa** | 20% | 200,000,000 | HDROME | Detalles proximamente |
| **Equipo y Colaboradores** | 5% | 50,000,000 | veHDROME | Bloqueos con vesting |
| **Airdrop Comunitario** | 5% | 50,000,000 | veHDROME | Bloqueo de 4 anos via MerkleClaim |
| **Marketing** | 5% | 50,000,000 | HDROME | Crecimiento, alianzas e incentivos |

  
    La mayor asignacion esta reservada para el protocolo en si. Esto incluye emisiones de gauge para recompensar a los LPs, liquidez propiedad del protocolo e iniciativas futuras de crecimiento. La asignacion garantiza la sostenibilidad a largo plazo del ecosistema Hyperdrome.
  
  
    200,000,000 HDROME asignados para la ronda de preventa. Se anunciaran mas detalles proximamente.
  
  
    50,000,000 HDROME distribuidos como **veHDROME** con bloqueos de vesting. Esto alinea los incentivos del equipo con el exito a largo plazo del protocolo — el equipo gana a traves de comisiones de votacion y sobornos, no vendiendo tokens.
  
  
    50,000,000 HDROME distribuidos como **veHDROME** con bloqueos de 4 anos a traves del contrato MerkleClaim. Los beneficiarios obtienen poder de voto e ingresos por comisiones inmediatamente desde el primer dia.
  
  
    50,000,000 HDROME asignados para iniciativas de crecimiento, alianzas estrategicas, campanas con KOLs e incentivos del ecosistema.
  

---

## Calendario de Emisiones

![${2}](${1})

### Emisiones Semanales

Las emisiones comienzan en **15,000,000 HDROME por semana** y decaen aproximadamente un 1% por epoca:

```
weekly_emission(n) = weekly_emission(n-1) × 990 / 1000
```

| Periodo | Emision Semanal | Emitido Acumulado |
|--------|----------------|--------------------|
| Semana 1 | 15,000,000 | 15,000,000 |
| Semana 13 (~3 meses) | 13,100,000 | ~182,000,000 |
| Semana 26 (~6 meses) | 11,600,000 | ~338,000,000 |
| Semana 52 (~1 ano) | 8,950,000 | ~573,000,000 |
| Semana 104 (~2 anos) | 5,340,000 | ~831,000,000 |

  Cuando la emision con decaimiento cae por debajo del **0.2% del suministro circulante**, se activa el piso de emision minima para mantener una tasa de emision minima indefinidamente.

### Division de Distribucion Semanal

| Destinatario | Participacion | Descripcion |
|-----------|-------|-------------|
| **Gauges** | ~96.7% | Distribuido a pools de liquidez basado en los pesos de voto de veHDROME |
| **Equipo** | ~3% | 30 puntos base a la direccion del equipo (maximo 50 bps) |
| **Rebases** | Variable | HDROME anti-dilucion a poseedores de veHDROME via RewardsDistributor |

---

## Ciclo de Epoca

![${2}](${1})

Cada epoca se ejecuta desde el **jueves 00:00 UTC** hasta el siguiente jueves:

  
    Los votos anteriores se contabilizan. El Minter calcula el nuevo monto de emision basado en la formula de decaimiento.
  
  
    El Minter acuna HDROME. El contrato Voter distribuye a los gauges proporcionalmente a los pesos de voto. El RewardsDistributor envia rebases a los poseedores de veHDROME.
  
  
    Los poseedores de veHDROME asignan votos entre pools. Cada veNFT puede votar una vez por epoca.
  
  
    Las comisiones de trading y los sobornos se acumulan para los votantes. Las emisiones LP fluyen continuamente a los stakers de gauge.

---

#### veHDROME y Votacion

URL: https://docs.hyperdrome.finance/es/tokenomics/vehdrome-voting

Como funciona la votacion veHDROME — asignacion de gauges, flujos de ingresos y estrategias de votacion. Con valores, flujos y referencias HyperEVM.

# veHDROME y Votacion

![${2}](${1})

## Flujo de Votacion

Cada epoca (jueves 00:00 UTC a jueves 00:00 UTC), los poseedores de veHDROME asignan su poder de voto entre los gauges de pools de liquidez. El flujo funciona de la siguiente manera:

1. Los **poseedores de veHDROME** seleccionan uno o mas pools y asignan pesos de voto (basados en porcentaje).
2. El **contrato Voter** contabiliza todos los votos en el cambio de epoca.
3. El **Minter** acuna la emision semanal de HDROME y la distribuye a los gauges proporcionalmente a su participacion de votos.
4. Los **LPs con staking en gauges** ganan emisiones de HDROME durante la siguiente epoca en base por segundo.
5. Los **votantes** ganan el 100% de las comisiones de trading y los sobornos externos de los pools por los que votaron.

## Sistema de Gauges

| Parametro | Valor |
|-----------|-------|
| Maximo de Tokens de Recompensa por Gauge | 16 |
| Duracion de Epoca | 7 dias (jueves a jueves UTC) |
| Acumulacion de Emisiones | Por segundo, proporcional a la participacion de LP en staking |

---

## Flujos de Ingresos

![${2}](${1})

Los votantes de veHDROME ganan de tres flujos de ingresos distintos:

| Flujo | Fuente | Distribucion |
|--------|--------|-------------|
| **Comisiones de Trading** | 100% de las comisiones de swap de los pools votados | Reclamable despues del cambio de epoca |
| **Sobornos Externos** | Depositados por protocolos que buscan votos | Reclamable despues del cambio de epoca |
| **Rebases** | HDROME anti-dilucion del Minter | Distribuido automaticamente a poseedores de veHDROME via RewardsDistributor |

---

## Reglas de Votacion

| Regla | Detalle |
|------|--------|
| **Una vez por epoca** | Cada veNFT puede votar una vez por epoca |
| **Bloqueado hasta el cambio** | Los votos quedan bloqueados durante toda la epoca una vez emitidos |
| **Reinicio requerido** | Debes reiniciar los votos antes de transferir o fusionar veNFTs |
| **Poke** | Cualquiera puede hacer poke a un veNFT para actualizar su poder de voto con decaimiento en las asignaciones existentes |

## Estrategias de Votacion

  
    Vota por pools con el mayor volumen de trading en relacion a su peso de voto actual. Los pools de alto volumen con menos votos generan mas comisiones por veHDROME asignado. Revisa la relacion comision/voto cada epoca para identificar pools con peso insuficiente.
  
  
    Vota por pools con sobornos externos activos. Los protocolos depositan sobornos para atraer votos, y la relacion soborno por voto puede superar significativamente los ingresos por comisiones. Compara el valor total de sobornos con el peso de voto actual para encontrar las mejores oportunidades.
  
  
    Si quieres profundizar la liquidez del token de un protocolo especifico, concentra los votos en su gauge. Esto dirige mas emisiones de HDROME a los LPs de ese pool, atrayendo mas liquidez y reduciendo los spreads para el token.
  

  Los votos quedan bloqueados durante toda la epoca una vez emitidos. No puedes cambiar ni retirar tu voto hasta el siguiente cambio de epoca. Planifica tu asignacion cuidadosamente antes de votar.

---

#### Pools y Liquidez

URL: https://docs.hyperdrome.finance/es/tokenomics/pools-liquidity

Arquitectura de pools AMM dual de Hyperdrome, estructura de comisiones y provision de liquidez. Con valores, flujos y referencias HyperEVM.

# Pools y Liquidez

![${2}](${1})

## Arquitectura de Pools

Hyperdrome utiliza un diseno de **AMM dual** con dos tipos de pools optimizados para diferentes clases de activos. El PairFactory despliega pools de forma deterministica via CREATE2. Cada pool tiene su propio contrato de recoleccion de comisiones (PairFees) y puede tener un gauge adjunto para emisiones de HDROME. Cada pool tambien incluye un oraculo TWAP integrado con periodos de observacion de 30 minutos.

### Pools Volatiles (vAMM)

| Propiedad | Valor |
|----------|-------|
| Curva | `x * y = k` (producto constante) |
| Comision Predeterminada | 0.2% |
| Convencion de Nombre | vAMM-TOKEN0/TOKEN1 |
| Ideal Para | Pares no correlacionados (HYPE/USDC, HDROME/HYPE) |

### Pools Estables (sAMM)

| Propiedad | Valor |
|----------|-------|
| Curva | `x³y + y³x = k` (variante StableSwap) |
| Comision Predeterminada | 0.02% |
| Convencion de Nombre | sAMM-TOKEN0/TOKEN1 |
| Ideal Para | Pares vinculados/correlacionados (USDC/USDT, HYPE/stHYPE) |

---

## Estructura de Comisiones

| Parametro | Detalle |
|-----------|--------|
| Comision de Pool Volatil | 0.2% (ajustable por el Fee Manager) |
| Comision de Pool Estable | 0.02% (ajustable por el Fee Manager) |
| Destinatario de Comisiones | 100% a los votantes de veHDROME del gauge de ese pool |
| Recoleccion de Comisiones | Recolectada por swap en el contrato PairFees |

---

## Enrutamiento de Swaps

El contrato Router encuentra la ruta optima para cualquier intercambio de tokens. Verifica todos los pools disponibles (tanto volatiles como estables) y construye rutas multi-salto cuando no existe un par directo o cuando una ruta multi-salto ofrece mejor ejecucion. Por ejemplo, un intercambio de TOKEN_A a TOKEN_B podria enrutarse a traves de TOKEN_A → HYPE → TOKEN_B si resulta en menos slippage.

---

## Proveer Liquidez

![${2}](${1})

  
    Elige un pool volatil (vAMM) o estable (sAMM). Los pools volatiles son ideales para activos no correlacionados; los pools estables para pares vinculados.
  
  
    Provee ambos tokens del par en la proporcion actual del pool. El Router gestiona las matematicas para minimizar los residuos.
  
  
    Recibes tokens LP que representan tu participacion en el pool. Estos acumulan comisiones de trading automaticamente.
  
  
    Deposita tus tokens LP en el gauge del pool para ganar emisiones de HDROME. Los LPs sin staking no ganan emisiones.
  

  Siempre haz staking de tus tokens LP en el gauge despues de depositar. Las posiciones LP sin staking ganan comisiones de trading pero pierden las emisiones de HDROME — que a menudo representan la mayor parte del rendimiento.

---

## Oraculo Integrado

Cada pool de Hyperdrome incluye un **oraculo TWAP (Precio Promedio Ponderado por Tiempo)** con periodos de observacion de 30 minutos. Esto proporciona feeds de precios resistentes a la manipulacion que pueden ser consumidos por otros protocolos en HyperEVM. El oraculo almacena observaciones de precios acumulados y puede ser consultado para cualquier ventana hasta el historial maximo de observaciones.

---

#### Sobornos y Recompensas

URL: https://docs.hyperdrome.finance/es/tokenomics/bribes-rewards

Como fluyen los sobornos, comisiones de trading, emisiones y rebases a traves del ecosistema Hyperdrome. Con valores, flujos y referencias HyperEVM.

# Sobornos y Recompensas

![${2}](${1})

## Flujo de Recompensas

El sistema de recompensas de Hyperdrome tiene tres flujos distintos que van a diferentes participantes:

1. **Emisiones LP** — El Minter crea HDROME cada epoca. El contrato Voter lo distribuye a los gauges basado en los pesos de voto de veHDROME. Los LPs con staking en gauges ganan estas emisiones por segundo, proporcional a su participacion en el gauge.

2. **Comisiones de Trading + Sobornos Externos → Votantes** — El 100% de las comisiones de trading de cada pool y cualquier soborno externo depositado para el gauge de ese pool fluyen a los poseedores de veHDROME que votaron por el. Estos son reclamables despues de cada cambio de epoca.

3. **Rebases → Poseedores de veHDROME** — El RewardsDistributor envia rebases anti-dilucion de HDROME a todos los poseedores de veHDROME proporcionalmente a su poder de voto, protegiendo a los bloqueadores de la dilucion por emisiones.

---

## Tipos de Recompensa

| Recompensa | Destinatario | Fuente | Momento |
|--------|-----------|--------|--------|
| **Emisiones LP** | LPs con staking en gauge | Acunacion semanal de HDROME | Acumulacion por segundo |
| **Comisiones de Trading** | Votantes de veHDROME | 100% de comisiones de swap | Reclamable despues del cambio de epoca |
| **Sobornos Externos** | Votantes de veHDROME | Depositos de protocolos | Reclamable despues del cambio de epoca |
| **Rebases** | Todos los poseedores de veHDROME | Anti-dilucion del Minter | Distribuido en el cambio de epoca |

---

## Sobornos Externos

![${2}](${1})

Los sobornos externos permiten a los protocolos incentivar a los votantes de veHDROME para dirigir emisiones hacia pools especificos. Este es el mecanismo principal para que los protocolos adquieran liquidez profunda en Hyperdrome.

  
    Un protocolo deposita tokens en el contrato ExternalBribe para un gauge especifico antes del cambio de epoca.
  
  
    En el cambio de epoca, el soborno se hace visible para los votantes. Los poseedores de veHDROME consideran el valor del soborno en sus decisiones de votacion para la epoca actual.
  
  
    Despues de que la epoca termina, los votantes que asignaron votos a ese gauge pueden reclamar su parte proporcional del soborno basada en su peso de voto.
  

### Eficiencia de Sobornos

* Los protocolos tipicamente adquieren $2-5 de liquidez por cada $1 gastado en sobornos
* El ROI de sobornos varia por epoca — un menor peso total de votos significa mayores retornos por voto
* Los sobornos consistentes a lo largo de multiples epocas construyen profundidad de liquidez sostenida
* Se pueden usar hasta 16 tokens diferentes de recompensa como sobornos por gauge

---

## Sobornos Internos (Comisiones de Trading)

Los sobornos internos no son depositados por partes externas — son las **comisiones de trading** generadas por cada pool. El 100% de las comisiones de swap se enrutan automaticamente al contrato InternalBribe del gauge de ese pool. Los votantes de veHDROME que votaron por el gauge reclaman estas comisiones despues de cada cambio de epoca. Los pools de mayor volumen generan mas sobornos internos, haciendolos objetivos de votacion atractivos.

---

## Rebases

Los rebases son recompensas anti-dilucion distribuidas a todos los poseedores de veHDROME a traves del contrato RewardsDistributor. Cuando se acuna nuevo HDROME cada epoca, una cantidad proporcional se distribuye como rebases para prevenir la dilucion del poder de voto. El monto de rebase escala con la proporcion de HDROME bloqueado respecto al suministro circulante total — mas bloqueo significa mayores rebases.

---

## Reclamar Recompensas

| Tipo de Recompensa | Donde Reclamar | Frecuencia |
|-------------|---------------|-----------|
| Emisiones LP | Contrato Gauge | En cualquier momento (se acumula por segundo) |
| Comisiones de Trading | Contrato InternalBribe | Despues de cada cambio de epoca |
| Sobornos Externos | Contrato ExternalBribe | Despues de cada cambio de epoca |
| Rebases | RewardsDistributor | Despues de cada cambio de epoca |

  Usa el comando slash `/claim` en el agente de Hyperdrome para reclamar todas las recompensas pendientes en todas las posiciones en una sola transaccion.

---

#### Contratos Desplegados

URL: https://docs.hyperdrome.finance/es/tokenomics/deployed-contracts

Lista de contratos inteligentes desplegados y sus funciones en el ecosistema Hyperdrome. Con valores, flujos y referencias HyperEVM.

# Contratos Desplegados

## Informacion de Red

| Parametro | Valor |
|-----------|-------|
| Red | Hyperliquid EVM |
| Chain ID | `999` |
| URL RPC | `https://rpc.hyperliquid.xyz/evm` |
| Explorador | `https://explorer.hyperliquid.xyz` |
| Token Nativo | HYPE |

## Contratos Principales (HyperEVM Mainnet)

| Contrato | Direccion |
|----------|---------|
| Token HDROME | `TBD` |
| VotingEscrow (veHDROME) | `TBD` |
| Voter | `TBD` |
| Router | `TBD` |
| PairFactory | `TBD` |
| GaugeFactory | `TBD` |
| BribeFactory | `TBD` |
| Minter | `TBD` |
| RewardsDistributor | `TBD` |
| MerkleClaim | `TBD` |
| VeArtProxy | `TBD` |
| HyperdromeLibrary | `TBD` |

  Las direcciones de los contratos se publicaran aqui despues del despliegue en mainnet. Todos los contratos seran verificados en el Explorador de Hyperliquid.

## Direcciones de Tokens Conocidos

| Token | Direccion | Decimales |
|-------|---------|----------|
| WHYPE (Wrapped HYPE) | `0x5555555555555555555555555555555555555555` | 18 |
| USDC | `0xb88339CB7199b77E23DB6E890353E22632Ba630f` | 6 |
| USDT0 | `0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb` | 6 |

## Arquitectura de Contratos

| Capa | Contratos | Proposito |
|-------|-----------|---------|
| **Nucleo AMM** | Pair, PairFees, PairFactory, Router | Intercambios de tokens, liquidez, recoleccion de comisiones |
| **Token y Bloqueo** | Hyperdrome, VotingEscrow, VeArtProxy | Token HDROME, creacion y gestion de veNFT |
| **Votacion y Gauges** | Voter, Gauge, InternalBribe, ExternalBribe | Votacion de emisiones, staking de LP, distribucion de sobornos |
| **Emisiones** | Minter, RewardsDistributor | Acunacion semanal, distribucion de rebases |
| **Fabricas** | PairFactory, GaugeFactory, BribeFactory | Despliegue determinista de contratos |
| **Gobernanza** | L2Governor, HyperdromeGovernor (Multisig) | Propuestas on-chain, ejecucion con timelock |
| **Airdrop** | MerkleClaim | Airdrop por arbol Merkle (bloqueos veHDROME de 4 anos) |

  Siempre verifica las direcciones de los contratos antes de interactuar. Solo usa direcciones listadas en esta documentacion oficial o en la aplicacion de Hyperdrome.

---

#### Seguridad

URL: https://docs.hyperdrome.finance/es/tokenomics/security

Medidas de seguridad e historial de auditorias de Hyperdrome. Con valores, flujos y referencias HyperEVM.

# Seguridad

![${2}](${1})

## Herencia del Codigo

Hyperdrome esta construido sobre el codigo de **Velodrome/Solidly**, una de las implementaciones ve(3,3) mas probadas en batalla en DeFi:

* **Solidly** — AMM ve(3,3) original de Andre Cronje en Fantom
* **Velodrome** — Fork refinado en Optimism, el DEX mas grande por TVL en OP

## Auditorias

| Auditoria | Alcance | Reporte |
|-------|-------|--------|
| Auditoria de Solidly | AMM principal, VotingEscrow, Minter | Disponible en el repositorio |
| Auditorias de Velodrome | Revision completa del protocolo | Disponible en el repositorio |

## Seguridad de Contratos Inteligentes

### Control de Acceso

| Rol | Permisos |
|------|------------|
| **Governor** | Incluir tokens en whitelist, crear gauges, parametros del protocolo |
| **Emergency Council** | Desactivar/reactivar gauges en emergencias |
| **Fee Manager** | Ajustar tasas de comision de trading por pool |
| **Pauser** | Pausar todos los swaps en emergencia |

### Timelock

El multisig **HyperdromeGovernor** incluye timelocks por funcion:

* Retraso personalizado por combinacion de selector de funcion / destino
* Soporte para ejecucion de transacciones en lote
* Basado en el patron ZeroExGovernor de 0x

### Propiedades Clave de Seguridad

* **Asignacion inmutable del Minter** — `setMinter()` solo puede llamarse una vez en el token HDROME
* **Despliegue determinista CREATE2** — Las direcciones de pares son predecibles y verificables
* **Sistema de vinculacion de veNFT** — Previene la transferencia de veNFTs mientras estan en staking en gauges
* **Votos bloqueados por epoca** — Los votos no pueden cambiarse a mitad de epoca, previniendo manipulacion
* **Oraculo TWAP** — Periodos de observacion de 30 minutos resisten la manipulacion de precios

## Version de Solidity

Todos los contratos compilados con **Solidity 0.8.13** con protecciones estandar contra overflow/underflow.

## Suite de Pruebas

El protocolo incluye **21 archivos de prueba Foundry** que cubren:

* Mecanica de pares AMM y contabilidad de comisiones
* Operaciones de bloqueo/desbloqueo/fusion de veNFT
* Calculos de emisiones y calendarios de decaimiento
* Staking en gauge y distribucion de recompensas
* Mecanica de votacion y transiciones de epoca
* Desactivacion/reactivacion de gauge en emergencia
* Distribucion de airdrop por Merkle claim
* Propuestas de gobernanza on-chain
* Proteccion contra wash-trading
* Precision del oraculo y casos limite

---

### Agente

#### Vision General del Agente

URL: https://docs.hyperdrome.finance/es/agentic/overview

El agente de Hyperdrome — una interfaz nativa de IA para el DEX ve(3,3) en Hyperliquid. Con valores, flujos y referencias HyperEVM.

# El Agente de Hyperdrome

![${2}](${1})

## No es un DEX con IA — Es un Agente de IA con un DEX

Hyperdrome esta construido con IA como prioridad. El agente no es un chatbot anadido a una interfaz de trading — **es** la interfaz. Cada accion DeFi (intercambiar, proveer liquidez, bloquear, votar, reclamar) es accesible a traves de conversacion en lenguaje natural o comandos slash. La interfaz tradicional existe como respaldo, pero el agente es la forma principal en que los usuarios interactuan con el protocolo.

---

## Arquitectura

El agente de Hyperdrome utiliza una capa de enrutamiento LLM para interpretar la intencion del usuario y mapearla a acciones on-chain. Cuando un usuario envia un mensaje, el agente:

1. **Analiza la intencion** — El LLM analiza el mensaje para determinar que quiere hacer el usuario (intercambiar, proveer liquidez, votar, consultar portafolio, etc.)
2. **Recopila contexto** — Lee el estado on-chain (saldos de billetera, datos de pools, posiciones veNFT, recompensas pendientes) y datos off-chain (precios, TVL, APRs)
3. **Genera respuesta** — Produce una explicacion en lenguaje natural con tarjetas de interfaz enriquecidas que muestran la accion propuesta, parametros y resultados esperados
4. **Ejecuta con aprobacion** — Cuando el usuario confirma, el agente construye y envia la(s) transaccion(es)

El agente soporta multiples backends LLM (Claude, GPT-4, Gemini) sin costo para el usuario.

---

## Chat-to-DeFi

Los usuarios interactuan con el protocolo completo a traves de indicaciones conversacionales:

* *"Intercambia 100 USDC a HYPE"*
* *"Cuales son mis recompensas pendientes?"*
* *"Bloquea 1000 HDROME por 4 anos"*
* *"Vota todo mi veHDROME en el pool HYPE/USDC"*
* *"Cual es el mejor rendimiento ahora mismo?"*

El agente gestiona el enrutamiento, el slippage, la estimacion de gas y la construccion de transacciones en segundo plano.

---

## Comandos Slash

| Comando | Accion |
|---------|--------|
| `/swap` | Intercambiar tokens con enrutamiento optimizado |
| `/lp` | Agregar o retirar liquidez de un pool |
| `/vote` | Asignar votos veHDROME entre gauges |
| `/lock` | Bloquear HDROME para crear o extender un veNFT |
| `/claim` | Reclamar todas las recompensas pendientes (emisiones, comisiones, sobornos) |
| `/help` | Mostrar comandos disponibles y su uso |

---

## Tarjetas de Interfaz Enriquecidas

El agente renderiza tarjetas interactivas para cada accion — no solo respuestas de texto. Las tarjetas muestran:

* **Tarjetas de intercambio** — Par de tokens, monto, impacto en precio, ruta, tolerancia de slippage
* **Tarjetas de LP** — Par del pool, TVL, APR, tu participacion, montos de deposito
* **Tarjetas de votacion** — Lista de gauges, pesos de voto actuales, ingresos proyectados por comisiones/sobornos
* **Tarjetas de portafolio** — Saldos de tokens, posiciones LP, detalles de veNFT, recompensas pendientes
* **Tarjetas de recompensas** — Desglose de emisiones reclamables, comisiones y sobornos con valores en USD

---

## Acciones Ejecutables

| Categoria | Acciones |
|----------|---------|
| **Trading** | Intercambiar tokens, enrutamiento multi-salto, configurar slippage |
| **Liquidez** | Agregar liquidez, retirar liquidez, hacer staking en gauge, retirar staking de gauge |
| **Bloqueo** | Crear veNFT, aumentar monto bloqueado, extender duracion del bloqueo, fusionar veNFTs |
| **Votacion** | Votar en gauges, reiniciar votos, actualizar votos obsoletos |
| **Recompensas** | Reclamar emisiones, reclamar comisiones, reclamar sobornos, reclamar rebases |
| **Portafolio** | Ver saldos, ver posiciones, ver recompensas pendientes, obtener recomendaciones de rendimiento |

---

## Sugerencias Inteligentes

El agente muestra proactivamente oportunidades de optimizacion basadas en el estado de la billetera:

| Prioridad | Disparador | Sugerencia |
|----------|---------|------------|
| **Alta** | Tokens LP sin staking detectados | Haz staking en gauge para ganar emisiones |
| **Alta** | Recompensas no reclamadas > $10 | Reclama y reinvierte las recompensas pendientes |
| **Alta** | veNFT expirando en 7 dias | Extiende el bloqueo para mantener el poder de voto |
| **Media** | Tokens inactivos > $10 sin LP/bloqueo | Provee liquidez o bloquea por veHDROME |
| **Media** | Asignacion de votos suboptima | Rebalancea votos hacia gauges de mayor rendimiento |
| **Baja** | Nuevo pool con APR alto disponible | Considera proveer liquidez en pools en tendencia |

---

## Arquitectura Agnostica de LLM

El agente de Hyperdrome **no esta atado a un solo proveedor de IA**. La arquitectura separa el analisis de intencion, la recopilacion de contexto y la ejecucion en capas independientes — por lo que el backend LLM puede intercambiarse sin cambiar nada mas.

| Capa | Rol | Requiere LLM? |
|------|-----|----------------|
| **Intent Parser** | Entender que quiere el usuario | Si — cualquier LLM |
| **Context Gatherer** | Leer datos on-chain + off-chain | No |
| **Responder** | Generar explicacion + tarjetas UI | Si — cualquier LLM |
| **Executor** | Construir y enviar transacciones | No |

Actualmente soporta **Claude**, **GPT-4** y **Gemini** con enrutamiento inteligente. Los modelos open-source (Llama, Mistral, Qwen) y Bring Your Own LLM estan en la hoja de ruta.

  ### Integraciones LLM
    Soporte multi-modelo, enrutamiento y Bring Your Own LLM
  

  ### Servidor MCP
    Conecta cualquier asistente de IA a Hyperdrome via MCP
  

  ### Frameworks de Agentes
    GOAT SDK, Wayfinder, Eliza, Olas, REST API
  

---

## Soporte Multi-Idioma

El agente responde en el idioma del usuario. Indicaciones en ingles, chino, japones, coreano, espanol, frances, portugues, turco, ruso, arabe y otros idiomas son compatibles de forma nativa a traves de las capacidades del LLM subyacente. Las etiquetas de la interfaz y los comandos slash permanecen en ingles, pero todas las respuestas conversacionales se adaptan al idioma del usuario.

---

#### Integraciones LLM

URL: https://docs.hyperdrome.finance/es/agentic/llm-integrations

Como Hyperdrome se conecta a cualquier LLM — Claude, GPT-4, Gemini, Llama, Mistral y mas. Con valores, flujos y referencias HyperEVM.

# Integraciones LLM

![${2}](${1})

## Agnostico de LLM por Diseno

Hyperdrome no esta atado a un solo proveedor de IA. La arquitectura del agente separa el **analisis de intencion**, la **recopilacion de contexto** y la **ejecucion** en capas independientes — por lo que el backend LLM puede intercambiarse sin cambiar nada mas.

Esto significa que Hyperdrome funciona con cualquier modelo de lenguaje grande hoy, y funcionara con cualquier modelo lanzado manana.

---

## Modelos Soportados

  ### Claude
    Opus, Sonnet, Haiku — **En vivo**
  

  ### GPT-4
    GPT-4o, GPT-4, GPT-4 Turbo — **En vivo**
  

  ### Gemini
    Gemini 2.5 Pro, 2.5 Flash — **En vivo**
  

  ### Codigo Abierto
    Llama, Mistral, Qwen, DeepSeek — *Planificado*
  

  Todos los modelos estan disponibles a **$0 de costo** para los usuarios. Hyperdrome cubre los costos de inferencia.

---

## Arquitectura

El pipeline del agente es agnostico de modelo en cada etapa:

```
User Input (natural language or /command)
        │
        ▼
┌──────────────────┐
│  Intent Parser   │ ← Any LLM (Claude, GPT-4, Gemini, Llama...)
│  "What does the  │
│   user want?"    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Context Gatherer │ ← On-chain + off-chain data (no LLM needed)
│  Wallet, pools,  │
│  prices, APRs    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Responder     │ ← Any LLM (generates explanation + UI cards)
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Executor      │ ← Transaction builder (no LLM needed)
│  Build tx, sign, │
│  submit on-chain │
└──────────────────┘
```

El LLM solo interviene en dos pasos: entender que quiere el usuario y explicar el resultado. Todo lo demas — leer el estado de la blockchain, construir transacciones, enviarlas on-chain — es codigo deterministico.

---

## Enrutamiento Inteligente

El backend selecciona automaticamente el mejor modelo para cada solicitud basandose en:

| Factor | Logic |
|--------|-------|
| **Complexity** | Consultas simples (verificacion de precios, saldo) → modelo mas rapido. Acciones complejas multi-paso → modelo mas capaz. |
| **Language** | Algunos modelos funcionan mejor en idiomas especificos. El enrutador optimiza para el idioma detectado del usuario. |
| **Latency** | Si el modelo principal es lento o no esta disponible, el enrutador cambia a la siguiente mejor opcion en < 500ms. |
| **Cost** | El enrutador equilibra capacidad vs. costo para mantener la inferencia gratuita para todos los usuarios. |

---

## Bring Your Own LLM *(Proximamente)*

  Esta funcionalidad esta en la hoja de ruta y aun no esta disponible.

Los usuarios podran conectar su propio proveedor LLM:

* **API key** — Conecta tu propia clave API de OpenAI, Anthropic, Google, o cualquier API compatible con OpenAI
* **Modelos auto-hospedados** — Apunta el agente a tu propio endpoint de Ollama, vLLM o TGI ejecutando Llama, Mistral, Qwen o cualquier modelo open-source
* **System prompts personalizados** — Personaliza la personalidad del agente, tolerancia al riesgo y estilo de respuesta
* **Privacidad total** — Al usar tu propio modelo, ningun dato pasa por los servidores de inferencia de Hyperdrome

### Endpoints Compatibles

Cualquier endpoint que implemente el formato de API OpenAI Chat Completions funcionara:

| Runtime | Example Models |
|---------|---------------|
| **Ollama** | Llama 3.3, Mistral, Qwen 2.5, DeepSeek V3, Gemma |
| **vLLM** | Any HuggingFace model |
| **TGI** | Any HuggingFace model |
| **Together AI** | Llama, Mixtral, Qwen |
| **Groq** | Llama, Mixtral, Gemma |
| **Fireworks** | Llama, Mixtral, DeepSeek |

---

## Por Que Importa Ser Agnostico de LLM

1. **Sin dependencia de proveedor** — Si un proveedor sube precios, degrada la calidad o agrega restricciones, Hyperdrome cambia sin problemas.

2. **El mejor modelo para el trabajo** — Diferentes modelos sobresalen en diferentes tareas. El enrutamiento permite a Hyperdrome usar la mejor herramienta para cada solicitud.

3. **A prueba de futuro** — Se lanzan nuevos modelos mensualmente. La arquitectura agnostica de LLM permite que Hyperdrome los adopte inmediatamente sin reescrituras.

4. **Soberania del usuario** — Con Bring Your Own LLM, los usuarios controlan sus datos e inferencia. Sin dependencia de proveedores de IA centralizados.

5. **Resistencia a la censura** — Los modelos open-source no pueden ser apagados ni restringidos. Los usuarios que ejecutan su propia instancia de Llama o Mistral tienen autonomia total.

---

#### Servidor MCP

URL: https://docs.hyperdrome.finance/es/agentic/mcp-server

El servidor Model Context Protocol de Hyperdrome — conecta cualquier asistente de IA al DEX ve(3,3). Con valores, flujos y referencias HyperEVM.

# Servidor MCP

![${2}](${1})

  El servidor MCP de Hyperdrome esta en la hoja de ruta y aun no esta activo. Esta pagina documenta la especificacion planificada.

## Que es MCP?

**Model Context Protocol (MCP)** es un estandar abierto de Anthropic que permite a los asistentes de IA descubrir y llamar herramientas en servidores externos. Utiliza JSON-RPC 2.0 — el asistente llama a `tools/list` para descubrir las acciones disponibles, y luego `tools/call` para ejecutarlas.

MCP es compatible con **Claude Desktop**, **Cursor**, **Opencode**, **Windsurf** y un numero creciente de herramientas de IA para programacion y chat.

---

## Por Que MCP para DeFi?

Hoy, interactuar con DeFi requiere:
1. Abrir un navegador
2. Conectar una billetera
3. Navegar una interfaz compleja
4. Entender slippage, enrutamiento, gas

Con el servidor MCP de Hyperdrome, cualquier asistente de IA puede **directamente** intercambiar tokens, consultar rendimientos, votar en gauges y gestionar posiciones — sin que el usuario salga de su herramienta preferida.

> *"Swap 500 USDC to HYPE on Hyperdrome"* — escrito en Claude Desktop, Cursor o cualquier cliente MCP.

---

## Herramientas Disponibles

El servidor MCP expone el protocolo completo de Hyperdrome como herramientas invocables:

### Trading

| Tool | Description | Parameters |
|------|-------------|------------|
| `swap` | Intercambiar tokens con enrutamiento multi-salto optimizado | `fromToken`, `toToken`, `amount`, `slippageBps?` |
| `get_quote` | Obtener cotizacion de intercambio sin ejecutar | `fromToken`, `toToken`, `amount` |

### Liquidity

| Tool | Description | Parameters |
|------|-------------|------------|
| `add_liquidity` | Depositar par de tokens en un pool | `tokenA`, `tokenB`, `amountA`, `amountB`, `stable` |
| `remove_liquidity` | Retirar de un pool | `tokenA`, `tokenB`, `stable`, `liquidity` |
| `stake_lp` | Hacer staking de tokens LP en un gauge | `pool`, `amount` |
| `unstake_lp` | Retirar staking de tokens LP de un gauge | `pool`, `amount` |

### Locking & Voting

| Tool | Description | Parameters |
|------|-------------|------------|
| `lock` | Bloquear HDROME para crear o extender un veNFT | `amount`, `duration` |
| `vote` | Asignar votos veHDROME entre gauges | `tokenId`, `pools[]`, `weights[]` |
| `reset_votes` | Reiniciar votos de un veNFT | `tokenId` |

### Rewards

| Tool | Description | Parameters |
|------|-------------|------------|
| `claim_rewards` | Reclamar todas las recompensas pendientes | `tokenId?` |
| `claim_fees` | Reclamar comisiones de trading de un gauge especifico | `gauge` |
| `claim_bribes` | Reclamar sobornos externos | `gauge`, `tokens[]` |

### Read-Only

| Tool | Description | Parameters |
|------|-------------|------------|
| `get_pools` | Listar todos los pools con TVL, APR, volumen | `sortBy?`, `limit?` |
| `get_portfolio` | Analisis completo de billetera | `address` |
| `get_yields` | Mejores oportunidades de rendimiento | `limit?`, `minTvl?` |
| `get_venft` | Obtener detalles de veNFT | `tokenId` |
| `get_pending_rewards` | Verificar recompensas no reclamadas | `address` |

---

## Ejemplo de Esquema de Herramienta

Cada herramienta sigue la especificacion MCP con un JSON Schema para las entradas:

```json
{
  "name": "swap",
  "description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromToken": {
        "type": "string",
        "description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
      },
      "toToken": {
        "type": "string",
        "description": "Token symbol or address to buy (e.g. 'HYPE')"
      },
      "amount": {
        "type": "string",
        "description": "Amount to swap in human-readable units (e.g. '100')"
      },
      "slippageBps": {
        "type": "number",
        "description": "Max slippage in basis points (default: 50 = 0.5%)"
      }
    },
    "required": ["fromToken", "toToken", "amount"]
  }
}
```

---

## Conexion

### Claude Desktop / Cursor / Opencode

Agrega a tu configuracion MCP:

```json
{
  "mcpServers": {
    "hyperdrome": {
      "url": "https://mcp.hyperdrome.finance/sse"
    }
  }
}
```

### Self-Hosted

El servidor MCP sera open-source. Ejecuta tu propia instancia:

```bash
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
```

---

## Modelo de Seguridad

| Property | Detail |
|----------|--------|
| **Read-only by default** | Las consultas de portafolio y datos de pools no requieren conexion de billetera |
| **Transaction approval** | Todas las operaciones de escritura devuelven transacciones sin firmar para que el usuario revise y firme |
| **No private keys** | El servidor MCP hospedado nunca toca claves privadas. La firma ocurre del lado del cliente. |
| **Rate limiting** | Limites de tasa por IP y por API key para prevenir abuso |
| **Audit trail** | Cada llamada a herramienta se registra con timestamp, parametros y resultado |

  El servidor MCP nunca ejecuta transacciones en tu nombre. Construye la transaccion y la devuelve para tu aprobacion explicita — igual que cualquier frontend DeFi.

---

## Casos de Uso

| Scenario | How |
|----------|-----|
| **Desarrollador construyendo un dashboard DeFi** | Consulta pools, rendimientos y posiciones via herramientas MCP |
| **Asistente de programacion IA** | "Ayudame a escribir un script que reclame todas mis recompensas de Hyperdrome" — el asistente llama a `get_pending_rewards` y luego `claim_rewards` |
| **Agente autonomo** | Un agente de gestion de portafolio verifica rendimientos cada hora y rebalancea via `add_liquidity` / `remove_liquidity` |
| **Chat bot** | Un bot de Telegram que permite a los usuarios intercambiar, consultar portafolio y votar a traves de lenguaje natural |
| **Investigacion** | Un analista consulta `get_pools` para construir una comparacion de rendimientos entre DEXes de HyperEVM |

---

#### Integraciones con Frameworks de Agentes

URL: https://docs.hyperdrome.finance/es/agentic/agent-frameworks

Como Hyperdrome se integra con GOAT SDK, Wayfinder, Eliza, Olas y el ecosistema mas amplio de agentes de IA. Con valores, flujos y referencias HyperEVM.

# Integraciones con Frameworks de Agentes

![${2}](${1})

Hyperdrome esta disenado para ser accesible desde **cualquier agente de IA**, no solo el nuestro. El protocolo expone su funcionalidad a traves de multiples capas de integracion para que agentes, frameworks y plataformas de terceros puedan interactuar con Hyperdrome de forma nativa.

  ### GOAT SDK
    200+ herramientas, 13+ adaptadores de frameworks
  
  ### MCP
    Claude Desktop, Cursor, Opencode
  
  ### Wayfinder
    Terminal DeFi nativo de IA
  
  ### Eliza
    Agentes autonomos sociales + DeFi
  
  ### Olas
    Agentes autonomos descentralizados
  
  ### REST API
    Endpoints HTTP directos
  

---

## Arquitectura de Integracion

```
┌─────────────────────────────────────────────────┐
│              AI Agent Frameworks                 │
│  Claude · GPT · Gemini · Llama · Mistral · ...  │
├─────────────────────────────────────────────────┤
│              Adapter Layer                       │
│  GOAT SDK · Wayfinder · Eliza · LangChain ·     │
│  Vercel AI · MCP · REST API                     │
├─────────────────────────────────────────────────┤
│           Hyperdrome Protocol Layer              │
│  Intent Parser → Context → Tx Builder → Chain   │
├─────────────────────────────────────────────────┤
│                 HyperEVM                         │
│  Router · Voter · Gauges · VotingEscrow · ...   │
└─────────────────────────────────────────────────┘
```

Cualquier framework que soporte una de las capas de adaptador puede interactuar con Hyperdrome. No se necesita codigo de integracion personalizado.

---

## GOAT SDK Plugin

  El plugin GOAT SDK esta en la hoja de ruta y aun no ha sido publicado.

**GOAT SDK** es el toolkit de finanzas agentivas mas grande — 200+ herramientas, 15+ cadenas, 13+ adaptadores de frameworks. Protocolos como Uniswap, Aave, 1inch y Balancer ya tienen plugins GOAT.

Hyperdrome publicara `@goat-sdk/plugin-hyperdrome` con cobertura completa del protocolo:

### Acciones Expuestas

| Action | Description |
|--------|-------------|
| `swap` | Intercambiar tokens con enrutamiento optimizado |
| `addLiquidity` | Depositar en pools volatiles o estables |
| `removeLiquidity` | Retirar de pools |
| `stakeLp` | Hacer staking de tokens LP en gauges |
| `unstakeLp` | Retirar staking de gauges |
| `lock` | Bloquear HDROME → veHDROME (crear/extender veNFT) |
| `vote` | Asignar votos entre gauges |
| `claimRewards` | Reclamar emisiones, comisiones, sobornos, rebases |
| `getPools` | Listar pools con TVL, APR, volumen |
| `getPortfolio` | Analisis completo de billetera |

### Alcance de Frameworks

Una vez publicado el plugin GOAT, Hyperdrome estara automaticamente disponible en:

| Framework | Type |
|-----------|------|
| **Vercel AI SDK** | Full-stack AI apps |
| **LangChain** | Agent orchestration (Python & JS) |
| **LlamaIndex** | Data-augmented agents |
| **MCP** | Claude Desktop, Cursor, Opencode |
| **Eliza** | Autonomous social + DeFi agents |
| **CrewAI** | Multi-agent systems |
| **Mastra** | TypeScript agent framework |
| **GAME (Virtuals)** | Gaming + DeFi agents |
| **OpenAI Agents SDK** | OpenAI's native agent runtime |
| **ZerePy** | Python agent framework |
| **AutoGen** | Microsoft's multi-agent framework |
| **Olas** | Decentralized autonomous agents |

---

## Wayfinder Paths

  La integracion con Wayfinder esta en la hoja de ruta y aun no esta disponible.

**Wayfinder** es un terminal DeFi nativo de IA con su propio SDK (Paths). Ya soporta Hyperliquid perps, Aave V3, Morpho, Pendle y Uniswap V3.

Hyperdrome publicara un **adaptador de protocolo Wayfinder** que habilitara:

* Intercambio, LP, votacion y bloqueo via Wayfinder Shells (interfaz de trading IA)
* Composicion de estrategias — combinar rendimiento de Hyperdrome con estrategias cross-protocol
* Puente MCP — el servidor MCP integrado de Wayfinder expondra las herramientas de Hyperdrome

---

## Eliza (ElizaOS)

**Eliza** es el framework open-source lider para agentes crypto autonomos. Impulsa bots sociales + DeFi que operan en Twitter, Telegram y on-chain.

Integracion de Hyperdrome via el plugin GOAT (`@elizaos/plugin-goat`):

* Los agentes Eliza pueden intercambiar, proveer liquidez, votar y reclamar en Hyperdrome
* Yield farming autonomo — agentes que monitorean APRs y rebalancean posiciones
* Social + DeFi — agentes que publican actualizaciones de rendimiento, responden preguntas de la comunidad y ejecutan trades

---

## Olas (Autonolas)

**Olas** es una plataforma descentralizada para co-propiedad y ejecucion de agentes de IA autonomos. 3,600+ agentes desplegados, 17M+ transacciones.

Camino de integracion con Hyperdrome:

* Construir un **servicio de agente Olas** que gestione posiciones en Hyperdrome
* Registrar como **Mech** en el marketplace de Olas — otros agentes pueden contratar acciones de Hyperdrome
* Componer con agentes Olas existentes para estrategias cross-protocol

---

## REST API

  La REST API publica esta en la hoja de ruta y aun no esta disponible.

Para desarrolladores que quieren integracion directa sin un framework:

### Endpoints Planificados

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/api/pools` | Listar todos los pools con TVL, APR, comisiones, volumen |
| `GET` | `/api/pools/:address` | Detalles del pool |
| `GET` | `/api/portfolio/:wallet` | Analisis completo de portafolio |
| `GET` | `/api/yields` | Mejores oportunidades de rendimiento |
| `POST` | `/api/quote` | Obtener cotizacion de intercambio |
| `POST` | `/api/swap` | Construir transaccion de intercambio |
| `POST` | `/api/liquidity/add` | Construir transaccion de agregar liquidez |
| `POST` | `/api/liquidity/remove` | Construir transaccion de retirar liquidez |
| `POST` | `/api/lock` | Construir transaccion de bloqueo |
| `POST` | `/api/vote` | Construir transaccion de votacion |
| `POST` | `/api/claim` | Construir transaccion de reclamar todo |

### Formato de Respuesta

Todos los endpoints de escritura devuelven datos de transaccion sin firmar:

```json
{
  "tx": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "chainId": 999,
    "gasLimit": "250000"
  },
  "summary": {
    "action": "Swap 100 USDC → 1.62 HYPE",
    "priceImpact": "0.03%",
    "route": ["USDC", "HYPE"],
    "minReceived": "1.611 HYPE"
  }
}
```

  La API nunca requiere claves privadas. Todas las transacciones se devuelven sin firmar para firma del lado del cliente.

---

## LangChain Tool

Para desarrolladores Python que usan LangChain directamente:

```python
from langchain.tools import tool

@tool
def hyperdrome_swap(from_token: str, to_token: str, amount: str) -> str:
    """Swap tokens on Hyperdrome (HyperEVM). Returns unsigned transaction."""
    # Calls Hyperdrome REST API
    ...
```

El adaptador GOAT SDK maneja esto automaticamente, pero los desarrolladores tambien pueden construir herramientas LangChain personalizadas contra la REST API.

---

## Construye Tu Propia Integracion

Quieres integrar Hyperdrome en tu agente, bot o aplicacion?

1. **Mas rapido** — Usa el plugin GOAT SDK. Funciona con 13+ frameworks de forma inmediata.
2. **Mas flexible** — Usa la REST API directamente. Construye y firma transacciones en cualquier lenguaje.
3. **Nativo de IA** — Conecta via MCP. Funciona con Claude Desktop, Cursor, Opencode y cualquier cliente MCP.
4. **Autonomo** — Construye un servicio de agente Olas para ejecucion de agentes completamente descentralizada y on-chain.

Todas las capas de integracion devuelven transacciones sin firmar — tu aplicacion maneja la firma y el envio. Hyperdrome nunca toca claves privadas.

---

#### Capacidades del Agente y Hoja de Ruta

URL: https://docs.hyperdrome.finance/es/agentic/capabilities

Capacidades completas, fuentes de datos y funcionalidades proximas del agente de Hyperdrome. Con valores, flujos y referencias HyperEVM.

# Capacidades del Agente y Hoja de Ruta

## Fuentes de Datos en Vivo

| Fuente | Datos | Actualizacion |
|--------|------|--------|
| **HyperEVM RPC** | Saldos de billetera, posiciones LP, detalles de veNFT, stakes en gauge, recompensas pendientes | Tiempo real |
| **CoinGecko** | Precios de HYPE, USDC, USDT, BTC, ETH, SOL + cambio 24h + capitalizacion de mercado + volumen | Cache de 60s |
| **DeFiLlama** | TVL de la cadena Hyperliquid L1, top 20 protocolos con TVL/categoria/cambio 7d | Cache de 60s |
| **Hyperliquid API** | Todos los tokens spot con precios mark, volumenes 24h, suministro circulante | Cache de 60s |
| **Contratos del Protocolo** | Reservas de pools, TVL, APRs, pesos de voto, montos de soborno, tasas de emision | Tiempo real |

## Analisis de Billetera

El agente realiza un analisis profundo del portafolio cuando tu billetera esta conectada:

* **Saldos de tokens** con valores en USD (ordenados por valor)
* **Deteccion de capital inactivo** — tokens > $10 que no estan en LP/bloqueos
* **Posiciones LP** — par, estable/volatil, con staking/sin staking, TVL, APR, direccion del gauge
* **Deteccion de LP sin staking** — LPs que no ganan emisiones
* **veNFTs** — monto bloqueado, vencimiento, dias restantes, indicadores de expirado/por expirar, poder de voto, estado de votacion
* **Recompensas pendientes** — emisiones, sobornos, comisiones — desglosadas por par con totales en USD
* **Top 10 pools por APR** para recomendaciones

## Hoja de Ruta

| Funcionalidad | Estado |
|---------|--------|
| Chat-to-DeFi (Web) | **Lanzado** |
| Comandos Slash | **Lanzado** |
| Tarjetas de Interfaz Enriquecidas | **Lanzado** |
| Sugerencias Inteligentes | **Lanzado** |
| Multi-LLM Backend (Claude, GPT-4, Gemini) | **Lanzado** |
| Super-Agente de Telegram | **En Progreso** |
| MCP Server | Planificado |
| GOAT SDK Plugin | Planificado |
| Public REST API | Planificado |
| Wayfinder Integration | Planificado |
| Bring Your Own LLM | Planificado |
| Autopilot | Planificado |
| Maquina de Contenido | Planificado |
| PFPs Dinamicos de veNFT | Planificado |
| Optimizador de Sobornos | Planificado |
| Reportes de Rendimiento | Planificado |
| Tesoreria IA | Planificado |

### Autopilot *(Proximamente)*

"Deposita y Relajate" — el agente gestiona tu posicion DeFi completa automaticamente.

| Perfil de Riesgo | APY Objetivo | Estrategia |
|-------------|-----------|----------|
| **Conservador** | 8-15% | Pools estables, bloqueo maximo, pares blue-chip |
| **Equilibrado** | 15-30% | Mezcla estable/volatil, bloqueos medios |
| **Agresivo** | 30-80% | Pools volatiles, farming de sobornos, rebalanceo activo |
| **Degen** | 50-200% | Pools nuevos, captura maxima de sobornos, bloqueos cortos |

El agente gestiona: administracion de posiciones LP, staking en gauge, votacion veHDROME, reclamacion de recompensas, reinversion compuesta y rebalanceo — todo 24/7 sin intervencion del usuario.

**Modelo de ingresos**: 5% de comision por rendimiento en el yield de Autopilot.

### Super-Agente de Telegram *(Proximamente)*

Un solo bot para la experiencia completa de Hyperdrome:
* Intercambio, rendimiento, portafolio, reclamacion, autopilot
* Educacion, alertas, generacion de memes
* Generacion de PFP, analisis de sobornos, reportes de rendimiento

### Optimizador de Sobornos *(Proximamente)*

Herramienta B2B para protocolos:
* Entrada: objetivo de liquidez (ej., "$500K TVL para TOKEN/HYPE")
* Salida: monto exacto de soborno, ROI proyectado, epoca recomendada
* Rastrea la eficiencia de sobornos a lo largo del tiempo

### PFPs Dinamicos de veNFT *(Proximamente)*

Imagenes de perfil generadas por IA que evolucionan basandose en:
* Duracion y monto del bloqueo
* Actividad y racha de votacion
* Rendimiento total ganado
* Antiguedad en el protocolo

### Tesoreria IA *(Proximamente)*

Gestion autonoma de tesoreria:
* La IA asigna hasta el 30% de la tesoreria por epoca
* Publica decisiones 12 horas antes de la ejecucion
* Mecanismo de veto comunitario
* Transparencia total on-chain

## Privacidad

* Solo lee datos publicos on-chain de tu billetera conectada
* No se almacenan datos de billetera entre sesiones
* Las conversaciones no se persisten en el servidor

---

## fr - French

### Pour commencer

#### Introduction

URL: https://docs.hyperdrome.finance/fr/introduction

Bienvenue sur Hyperdrome - Le DEX agentique ve(3,3) sur Hyperliquid. Avec valeurs, flux et references HyperEVM.

## Qu'est-ce que Hyperdrome ?

Hyperdrome est le **DEX agentique ve(3,3)** sur Hyperliquid. Il combine un AMM eprouve (fork d'Aerodrome/Velodrome) avec un agent IA qui gere les echanges, la liquidite, le vote et l'optimisation du rendement par langage naturel.

Le produit n'est **pas un DEX avec de l'IA -- c'est un agent IA avec un DEX.**

## Le systeme ve(3,3)

Le modele ve(3,3) cree un volant d'inertie durable ou chaque participant beneficie de la cooperation :

![${2}](${1})

### Composants principaux

1. **Vote Escrow (ve)**
   * Verrouillez des HDROME pour recevoir du pouvoir de vote veHDROME (jusqu'a 4 ans)
   * Verrouillage plus long = plus de pouvoir de vote, decroissance lineaire
   * Position verrouillee representee sous forme de NFT ERC-721

2. **Theorie des jeux (3,3)**
   * La cooperation est la strategie dominante pour tous les participants
   * Les votants percoivent 100 % des frais de trading + les pots-de-vin externes
   * Les rebases anti-dilution protegent les verrouilleurs a long terme

### Avantages

* **Emissions durables** : decroissance hebdomadaire d'environ 1 % avec un plancher de 0,2 % de l'offre en circulation
* **Pouvoir de vote** : distribution hebdomadaire directe des emissions entre les gauges
* **Distribution des frais** : 100 % des frais de trading aux votants veHDROME
* **Marche des pots-de-vin** : les protocoles acquierent de la liquidite a une fraction du cout des incitations directes

## Conception AMM double

| Type de pool | Courbe | Frais par defaut | Ideal pour |
|-----------|-------|-------------|----------|
| **Volatile (vAMM)** | `x * y = k` | 0,2 % | HYPE/USDC, HDROME/HYPE |
| **Stable (sAMM)** | `x³y + y³x = k` | 0,02 % | USDC/USDT, paires indexees |

Chaque pool integre un **oracle TWAP** avec des periodes d'observation de 30 minutes.

## Construit sur HyperEVM

| Propriete | Valeur |
|----------|-------|
| Chaine | HyperEVM |
| Chain ID | 999 |
| Jeton natif | HYPE |
| RPC | `https://rpc.hyperliquid.xyz/evm` |
| Explorateur | `https://explorer.hyperliquid.xyz` |

## Pour commencer

  ### Lancer l'application
    Commencez a trader, fournir de la liquidite et gagner des recompenses
  

  ### Echanger des jetons
    Echangez des jetons avec un routage multi-saut optimise
  

  ### Fournir de la liquidite
    Deposez des paires de jetons et stakez dans les gauges pour des emissions
  

  ### Verrouiller et voter
    Verrouillez des HDROME pour obtenir des veHDROME et diriger les emissions du protocole
  

## Pourquoi Hyperdrome ?

* **IA native** : un agent integre gere la complexite DeFi via le langage naturel et les commandes slash
* **Code eprouve** : fork d'Aerodrome/Velodrome -- l'implementation ve(3,3) la plus eprouvee au monde
* **Autopilot** *(bientot disponible)* : Deposez et relaxez -- l'IA gere LP, staking, vote, reequilibrage et capitalisation 24h/24
* **IA a 0 $** : acces illimite a Claude, GPT-4 et Gemini sans cout marginal par utilisateur
* **Optimiseur de pots-de-vin** *(bientot disponible)* : outil B2B -- les protocoles saisissent un objectif de liquidite, l'IA calcule le montant exact du pot-de-vin + le ROI projete

---

### Tokenomics

#### Token HDROME

URL: https://docs.hyperdrome.finance/fr/tokenomics/hdrome-token

Le token HDROME alimente le DEX ve(3,3) Hyperdrome sur Hyperliquid -- verrouillez, votez et gagnez. Avec valeurs, flux et references HyperEVM.

# Token HDROME

![${2}](${1})

## Details du Token

| Propriete | Valeur |
|-----------|--------|
| Symbole | HDROME |
| Decimales | 18 |
| Chaine | HyperEVM (Chain ID 999) |
| Standard | ERC-20 |
| Offre Totale | 1 000 000 000 |

## Fonctions Principales

HDROME est le token natif du protocole Hyperdrome. Ses fonctions principales :

* **Verrouiller pour veHDROME** -- Verrouillez des HDROME pour recevoir du pouvoir de vote veHDROME sous forme de NFT ERC-721
* **Gouvernance** -- Les detenteurs de veHDROME gouvernent les parametres du protocole et l'allocation des emissions
* **Vote des Gauges** -- Dirigez les emissions hebdomadaires de HDROME vers les pools de liquidite de votre choix
* **100% des Frais de Trading** -- Les votants percoivent 100% des frais de trading des pools pour lesquels ils ont vote
* **Pots-de-vin** -- Gagnez des pots-de-vin externes deposes par les protocoles recherchant de la liquidite
* **Rebases** -- Les rebases anti-dilution en HDROME protegent les verrouilleurs a long terme de la dilution des emissions

---

## Mecanismes de Verrouillage

![${2}](${1})

Le verrouillage de HDROME cree une position **veHDROME** representee sous forme de NFT ERC-721 (veNFT). Le pouvoir de vote decroit lineairement sur la duree du verrouillage.

### Parametres de Verrouillage

| Parametre | Valeur |
|-----------|--------|
| Verrouillage minimum | 1 semaine |
| Verrouillage maximum | 4 ans |
| Decroissance | Lineaire sur la duree du verrouillage |
| Representation | NFT ERC-721 (veNFT) |

### Formule du Pouvoir de Vote

```
votingPower = (lockAmount × lockDuration) / maxDuration
```

Ou `maxDuration` = 4 ans. Plus vous verrouillez longtemps, plus vous recevez de pouvoir de vote :

| Duree de Verrouillage | Pouvoir de Vote (% du montant verrouille) |
|-----------------------|-------------------------------------------|
| 4 ans | 100% |
| 2 ans | 50% |
| 1 an | 25% |
| 6 mois | 12,5% |

### Gestion des veNFT

| Action | Description |
|--------|-------------|
| **Creer** | Verrouillez des HDROME pour emettre un nouveau veNFT avec la duree choisie |
| **Augmenter le montant** | Ajoutez plus de HDROME a un veNFT existant |
| **Prolonger le verrouillage** | Prolongez la duree du verrouillage pour augmenter le pouvoir de vote |
| **Fusionner** | Combinez deux veNFTs en un seul (les durees sont reconciliees) |
| **Transferer** | Envoyez votre veNFT a un autre portefeuille (transfert ERC-721) |
| **Retirer** | Reclamez les HDROME deverrouilles apres expiration du verrouillage |

  Les HDROME verrouilles ne peuvent pas etre retires avant l'expiration du verrouillage. Le pouvoir de vote decroit lineairement -- un verrouillage de 4 ans avec 1 000 HDROME commence a 1 000 veHDROME et atteint 0 a l'expiration. Prolongez votre verrouillage pour maintenir le plein pouvoir de vote.

---

#### Distribution et Emissions des Tokens

URL: https://docs.hyperdrome.finance/fr/tokenomics/distribution-emissions

Repartition detaillee de la distribution et du calendrier d'emission du token HDROME. Avec valeurs, flux et references HyperEVM.

# Distribution et Emissions des Tokens

## Offre Totale : 1 000 000 000 HDROME

![${2}](${1})

| Categorie | Allocation | Montant | Forme | Details |
|----------|-----------|--------|------|---------|
| **Protocole** | 65% | 650 000 000 | HDROME | Emissions, liquidite et croissance du protocole |
| **Prevente** | 20% | 200 000 000 | HDROME | Details a venir prochainement |
| **Equipe et Contributeurs** | 5% | 50 000 000 | veHDROME | Verrouillages avec acquisition progressive |
| **Airdrop Communautaire** | 5% | 50 000 000 | veHDROME | Verrouillage de 4 ans via MerkleClaim |
| **Marketing** | 5% | 50 000 000 | HDROME | Croissance, partenariats et incitations |

  
    La plus grande allocation est reservee au protocole lui-meme. Cela inclut les emissions de gauges pour recompenser les fournisseurs de liquidite, la liquidite detenue par le protocole et les initiatives futures de croissance du protocole. Cette allocation garantit la durabilite a long terme de l'ecosysteme Hyperdrome.
  
  
    200 000 000 HDROME alloues pour le tour de prevente. De plus amples details seront annonces prochainement.
  
  
    50 000 000 HDROME distribues sous forme de **veHDROME** avec des verrouillages a acquisition progressive. Cela aligne les incitations de l'equipe avec le succes a long terme du protocole -- l'equipe gagne grace aux frais de vote et aux pots-de-vin, et non en vendant des tokens.
  
  
    50 000 000 HDROME distribues sous forme de **veHDROME** avec des verrouillages de 4 ans via le contrat MerkleClaim. Les beneficiaires obtiennent immediatement un pouvoir de vote et des revenus de frais des le premier jour.
  
  
    50 000 000 HDROME alloues pour les initiatives de croissance, les partenariats strategiques, les campagnes KOL et les incitations ecosystemiques.
  

---

## Calendrier d'Emission

![${2}](${1})

### Emissions Hebdomadaires

Les emissions commencent a **15 000 000 HDROME par semaine** et decroissent d'environ 1% a chaque epoque :

```
weekly_emission(n) = weekly_emission(n-1) × 990 / 1000
```

| Periode | Emission Hebdomadaire | Total Cumule |
|--------|----------------|-------------------|
| Semaine 1 | 15 000 000 | 15 000 000 |
| Semaine 13 (~3 mois) | 13 100 000 | ~182 000 000 |
| Semaine 26 (~6 mois) | 11 600 000 | ~338 000 000 |
| Semaine 52 (~1 an) | 8 950 000 | ~573 000 000 |
| Semaine 104 (~2 ans) | 5 340 000 | ~831 000 000 |

  Lorsque l'emission decroissante tombe en dessous de **0,2% de l'offre en circulation**, le plancher d'emission de base s'active pour maintenir un taux d'emission minimum indefiniment.

### Repartition Hebdomadaire de la Distribution

| Destinataire | Part | Description |
|-------------|------|-------------|
| **Gauges** | ~96,7% | Distribues aux pools de liquidite en fonction des poids de vote veHDROME |
| **Equipe** | ~3% | 30 points de base vers l'adresse de l'equipe (max 50 bps) |
| **Rebases** | Variable | HDROME anti-dilution pour les detenteurs de veHDROME via le RewardsDistributor |

---

## Cycle d'Epoque

Chaque epoque s'etend du **jeudi 00:00 UTC** au jeudi suivant :

![${2}](${1})

  
    Les votes precedents sont comptabilises. Le Minter calcule le nouveau montant d'emission en fonction de la formule de decroissance.
  
  
    Le Minter emet les HDROME. Le contrat Voter distribue aux gauges proportionnellement aux poids de vote. Le RewardsDistributor envoie les rebases aux detenteurs de veHDROME.
  
  
    Les detenteurs de veHDROME allouent leurs votes aux differents pools. Chaque veNFT peut voter une fois par epoque.
  
  
    Les frais de trading et les pots-de-vin s'accumulent pour les votants. Les emissions LP sont distribuees en continu aux stakers de gauges.

---

#### veHDROME et Vote

URL: https://docs.hyperdrome.finance/fr/tokenomics/vehdrome-voting

Comment fonctionne le vote veHDROME -- allocation des gauges, flux de revenus et strategies de vote. Avec valeurs, flux et references HyperEVM.

# veHDROME et Vote

![${2}](${1})

## Processus de Vote

A chaque epoque (jeudi 00:00 UTC au jeudi 00:00 UTC suivant), les detenteurs de veHDROME allouent leur pouvoir de vote aux gauges des pools de liquidite. Le processus fonctionne comme suit :

1. Les **detenteurs de veHDROME** selectionnent un ou plusieurs pools et attribuent des poids de vote (en pourcentage).
2. Le **contrat Voter** comptabilise tous les votes au changement d'epoque.
3. Le **Minter** emet l'emission hebdomadaire de HDROME et la distribue aux gauges proportionnellement a leur part de vote.
4. Les **LPs stakes dans les gauges** gagnent des emissions HDROME sur l'epoque suivante a la seconde.
5. Les **votants** percoivent 100% des frais de trading et des pots-de-vin externes des pools pour lesquels ils ont vote.

## Systeme de Gauges

| Parametre | Valeur |
|-----------|--------|
| Tokens de recompense max par gauge | 16 |
| Duree d'epoque | 7 jours (jeudi a jeudi UTC) |
| Accumulation des emissions | A la seconde, proportionnelle a la part de LP stake |

---

## Flux de Revenus

![${2}](${1})

Les votants veHDROME gagnent a partir de trois flux de revenus distincts :

| Flux | Source | Distribution |
|------|--------|-------------|
| **Frais de Trading** | 100% des frais de swap des pools votes | Reclamables apres changement d'epoque |
| **Pots-de-vin Externes** | Deposes par les protocoles recherchant des votes | Reclamables apres changement d'epoque |
| **Rebases** | HDROME anti-dilution du Minter | Distribues automatiquement aux detenteurs de veHDROME via le RewardsDistributor |

---

## Regles de Vote

| Regle | Detail |
|-------|--------|
| **Une fois par epoque** | Chaque veNFT peut voter une fois par epoque |
| **Verrouille jusqu'au changement** | Les votes sont verrouilles pour toute l'epoque une fois emis |
| **Reinitialisation requise** | Les votes doivent etre reinitialises avant de transferer ou fusionner des veNFTs |
| **Poke** | N'importe qui peut poker un veNFT pour mettre a jour son pouvoir de vote decroissant dans les allocations existantes |

## Strategies de Vote

  
    Votez pour les pools avec le volume de trading le plus eleve par rapport a leur poids de vote actuel. Les pools a fort volume avec moins de votes generent plus de frais par veHDROME alloue. Verifiez le ratio frais/vote a chaque epoque pour identifier les pools sous-ponderes.
  
  
    Votez pour les pools avec des pots-de-vin externes actifs. Les protocoles deposent des pots-de-vin pour attirer les votes, et le ratio pot-de-vin par vote peut depasser significativement les revenus de frais. Comparez la valeur totale des pots-de-vin au poids de vote actuel pour trouver les meilleures opportunites.
  
  
    Si vous souhaitez approfondir la liquidite pour le token d'un protocole specifique, concentrez vos votes sur son gauge. Cela dirige plus d'emissions HDROME vers les LPs de ce pool, attirant plus de liquidite et resserrant les spreads pour le token.
  

  Les votes sont verrouilles pour toute l'epoque une fois emis. Vous ne pouvez pas modifier ou retirer votre vote jusqu'au prochain changement d'epoque. Planifiez soigneusement votre allocation avant de voter.

---

#### Pools et Liquidite

URL: https://docs.hyperdrome.finance/fr/tokenomics/pools-liquidity

Architecture des pools AMM doubles de Hyperdrome, structure des frais et fourniture de liquidite. Avec valeurs, flux et references HyperEVM.

# Pools et Liquidite

![${2}](${1})

## Architecture des Pools

Hyperdrome utilise une conception **AMM double** avec deux types de pools optimises pour differentes classes d'actifs. La PairFactory deploie les pools de maniere deterministe via CREATE2. Chaque pool possede son propre contrat de collecte de frais (PairFees) et peut recevoir un gauge pour les emissions HDROME. Chaque pool integre egalement un oracle TWAP avec des periodes d'observation de 30 minutes.

### Pools Volatiles (vAMM)

| Propriete | Valeur |
|-----------|--------|
| Courbe | `x * y = k` (produit constant) |
| Frais par defaut | 0,2% |
| Convention de nommage | vAMM-TOKEN0/TOKEN1 |
| Ideal pour | Paires non correlees (HYPE/USDC, HDROME/HYPE) |

### Pools Stables (sAMM)

| Propriete | Valeur |
|-----------|--------|
| Courbe | `x³y + y³x = k` (variante StableSwap) |
| Frais par defaut | 0,02% |
| Convention de nommage | sAMM-TOKEN0/TOKEN1 |
| Ideal pour | Paires indexees/correlees (USDC/USDT, HYPE/stHYPE) |

---

## Structure des Frais

| Parametre | Detail |
|-----------|--------|
| Frais pool volatile | 0,2% (ajustable par le Fee Manager) |
| Frais pool stable | 0,02% (ajustable par le Fee Manager) |
| Destinataire des frais | 100% aux votants veHDROME du gauge du pool |
| Collecte des frais | Collectes par swap dans le contrat PairFees |

---

## Routage des Swaps

Le contrat Router trouve le chemin optimal pour chaque echange de tokens. Il verifie tous les pools disponibles (volatiles et stables) et construit des routes multi-sauts lorsqu'une paire directe n'existe pas ou qu'un chemin multi-sauts offre une meilleure execution. Par exemple, un echange TOKEN_A vers TOKEN_B pourrait etre route via TOKEN_A → HYPE → TOKEN_B si cela resulte en moins de slippage.

---

## Fournir de la Liquidite

![${2}](${1})

  
    Choisissez une paire de pool volatile (vAMM) ou stable (sAMM). Les pools volatiles conviennent aux actifs non correles ; les pools stables aux paires indexees.
  
  
    Fournissez les deux tokens de la paire au ratio actuel du pool. Le Router gere les calculs pour minimiser les restes.
  
  
    Vous recevez des tokens LP representant votre part du pool. Ceux-ci accumulent automatiquement les frais de trading.
  
  
    Deposez vos tokens LP dans le gauge du pool pour gagner des emissions HDROME. Les LPs non stakes ne recoivent aucune emission.
  

  Stakez toujours vos tokens LP dans le gauge apres le depot. Les positions LP non stakees gagnent des frais de trading mais manquent les emissions HDROME -- qui representent souvent la majorite du rendement.

---

## Oracle Integre

Chaque pool Hyperdrome integre un **oracle TWAP (prix moyen pondere dans le temps)** avec des periodes d'observation de 30 minutes. Cela fournit des flux de prix resistants a la manipulation qui peuvent etre consommes par d'autres protocoles sur HyperEVM. L'oracle stocke des observations de prix cumulatives et peut etre interroge pour n'importe quelle fenetre jusqu'a l'historique d'observation maximum.

---

#### Pots-de-vin et Recompenses

URL: https://docs.hyperdrome.finance/fr/tokenomics/bribes-rewards

Comment les pots-de-vin, frais de trading, emissions et rebases circulent dans l'ecosysteme Hyperdrome. Avec valeurs, flux et references HyperEVM.

# Pots-de-vin et Recompenses

![${2}](${1})

## Flux de Recompenses

Le systeme de recompenses Hyperdrome comporte trois flux distincts destines a differents participants :

1. **Emissions LP** -- Le Minter cree des HDROME a chaque epoque. Le contrat Voter les distribue aux gauges en fonction des poids de vote veHDROME. Les LPs stakes dans les gauges gagnent ces emissions a la seconde proportionnellement a leur part du gauge.

2. **Frais de Trading + Pots-de-vin Externes → Votants** -- 100% des frais de trading de chaque pool et tous les pots-de-vin externes deposes pour le gauge de ce pool reviennent aux detenteurs de veHDROME qui ont vote pour lui. Ceux-ci sont reclamables apres chaque changement d'epoque.

3. **Rebases → Detenteurs de veHDROME** -- Le RewardsDistributor envoie des rebases anti-dilution en HDROME a tous les detenteurs de veHDROME proportionnellement a leur pouvoir de vote, protegeant les verrouilleurs de la dilution des emissions.

---

## Types de Recompenses

| Recompense | Destinataire | Source | Frequence |
|-----------|-------------|--------|-----------|
| **Emissions LP** | LPs stakes dans les gauges | Emission hebdomadaire de HDROME | Accumulation a la seconde |
| **Frais de Trading** | Votants veHDROME | 100% des frais de swap | Reclamables apres changement d'epoque |
| **Pots-de-vin Externes** | Votants veHDROME | Depots des protocoles | Reclamables apres changement d'epoque |
| **Rebases** | Tous les detenteurs de veHDROME | Anti-dilution du Minter | Distribues au changement d'epoque |

---

## Pots-de-vin Externes

![${2}](${1})

Les pots-de-vin externes permettent aux protocoles d'inciter les votants veHDROME a diriger les emissions vers des pools specifiques. C'est le mecanisme principal par lequel les protocoles acquierent une liquidite profonde sur Hyperdrome.

  
    Un protocole depose des tokens dans le contrat ExternalBribe pour un gauge specifique avant le changement d'epoque.
  
  
    Au changement d'epoque, le pot-de-vin devient visible pour les votants. Les detenteurs de veHDROME prennent en compte la valeur du pot-de-vin dans leurs decisions de vote pour l'epoque en cours.
  
  
    Apres la fin de l'epoque, les votants qui ont alloue des votes a ce gauge peuvent reclamer leur part proportionnelle du pot-de-vin en fonction de leur poids de vote.
  

### Efficacite des Pots-de-vin

* Les protocoles acquierent typiquement 2 a 5 $ de liquidite pour chaque 1 $ depense en pots-de-vin
* Le ROI des pots-de-vin varie par epoque -- un poids de vote total plus faible signifie des rendements par vote plus eleves
* Des pots-de-vin reguliers sur plusieurs epoques construisent une profondeur de liquidite durable
* Jusqu'a 16 tokens de recompense differents peuvent etre utilises comme pots-de-vin par gauge

---

## Pots-de-vin Internes (Frais de Trading)

Les pots-de-vin internes ne sont pas deposes par des parties externes -- ce sont les **frais de trading** generes par chaque pool. 100% des frais de swap sont automatiquement achemines vers le contrat InternalBribe pour le gauge de ce pool. Les votants veHDROME qui ont vote pour le gauge reclament ces frais apres chaque changement d'epoque. Les pools a volume plus eleve generent plus de pots-de-vin internes, ce qui en fait des cibles de vote attractives.

---

## Rebases

Les rebases sont des recompenses anti-dilution distribuees a tous les detenteurs de veHDROME via le contrat RewardsDistributor. Lorsque de nouveaux HDROME sont emis a chaque epoque, un montant proportionnel est distribue sous forme de rebases pour empecher la dilution du pouvoir de vote. Le montant du rebase evolue avec le ratio de HDROME verrouilles par rapport a l'offre totale en circulation -- plus de verrouillages signifie des rebases plus eleves.

---

## Reclamer les Recompenses

| Type de Recompense | Ou Reclamer | Frequence |
|-------------------|-------------|-----------|
| Emissions LP | Contrat Gauge | A tout moment (accumulation a la seconde) |
| Frais de Trading | Contrat InternalBribe | Apres chaque changement d'epoque |
| Pots-de-vin Externes | Contrat ExternalBribe | Apres chaque changement d'epoque |
| Rebases | RewardsDistributor | Apres chaque changement d'epoque |

  Utilisez la commande slash `/claim` dans l'agent Hyperdrome pour reclamer toutes les recompenses en attente sur toutes les positions en une seule transaction.

---

#### Contrats deployes

URL: https://docs.hyperdrome.finance/fr/tokenomics/deployed-contracts

Liste des contrats intelligents deployes et de leurs fonctions dans l'ecosysteme Hyperdrome. Avec valeurs, flux et references HyperEVM.

# Contrats deployes

## Informations reseau

| Parametre | Valeur |
|-----------|-------|
| Reseau | Hyperliquid EVM |
| Chain ID | `999` |
| URL RPC | `https://rpc.hyperliquid.xyz/evm` |
| Explorateur | `https://explorer.hyperliquid.xyz` |
| Jeton natif | HYPE |

## Contrats principaux (HyperEVM Mainnet)

| Contrat | Adresse |
|----------|---------|
| HDROME Token | `TBD` |
| VotingEscrow (veHDROME) | `TBD` |
| Voter | `TBD` |
| Router | `TBD` |
| PairFactory | `TBD` |
| GaugeFactory | `TBD` |
| BribeFactory | `TBD` |
| Minter | `TBD` |
| RewardsDistributor | `TBD` |
| MerkleClaim | `TBD` |
| VeArtProxy | `TBD` |
| HyperdromeLibrary | `TBD` |

  Les adresses des contrats seront publiees ici apres le deploiement sur le mainnet. Tous les contrats seront verifies sur l'explorateur Hyperliquid.

## Adresses de jetons connus

| Jeton | Adresse | Decimales |
|-------|---------|----------|
| WHYPE (Wrapped HYPE) | `0x5555555555555555555555555555555555555555` | 18 |
| USDC | `0xb88339CB7199b77E23DB6E890353E22632Ba630f` | 6 |
| USDT0 | `0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb` | 6 |

## Architecture des contrats

| Couche | Contrats | Fonction |
|-------|-----------|---------|
| **Coeur AMM** | Pair, PairFees, PairFactory, Router | Echanges de jetons, liquidite, collecte des frais |
| **Jeton et verrouillage** | Hyperdrome, VotingEscrow, VeArtProxy | Jeton HDROME, creation et gestion des veNFT |
| **Vote et gauges** | Voter, Gauge, InternalBribe, ExternalBribe | Vote sur les emissions, staking LP, distribution des pots-de-vin |
| **Emissions** | Minter, RewardsDistributor | Frappe hebdomadaire, distribution des rebases |
| **Factories** | PairFactory, GaugeFactory, BribeFactory | Deploiement deterministe des contrats |
| **Gouvernance** | L2Governor, HyperdromeGovernor (Multisig) | Propositions on-chain, execution avec timelock |
| **Airdrop** | MerkleClaim | Airdrop par arbre de Merkle (verrouillages veHDROME de 4 ans) |

  Verifiez toujours les adresses des contrats avant d'interagir. N'utilisez que les adresses listees dans cette documentation officielle ou dans l'application Hyperdrome.

---

#### Sécurité

URL: https://docs.hyperdrome.finance/fr/tokenomics/security

Les mesures de sécurité d'Hyperdrome et l'historique des audits. Avec valeurs, flux et references HyperEVM.

# Sécurité

![${2}](${1})

## Héritage du code

Hyperdrome est construit sur la base de code **Velodrome/Solidly**, l'une des implémentations ve(3,3) les plus éprouvées en DeFi :

* **Solidly** — AMM ve(3,3) original par Andre Cronje sur Fantom
* **Velodrome** — Fork amélioré sur Optimism, le plus grand DEX par TVL sur OP

## Audits

| Audit | Portée | Rapport |
|-------|--------|---------|
| Audit Solidly | AMM Core, VotingEscrow, Minter | Disponible dans le repo |
| Audits Velodrome | Revue complète du protocole | Disponible dans le repo |

## Sécurité des contrats intelligents

### Contrôle d'accès

| Rôle | Permissions |
|------|------------|
| **Governor** | Mettre en liste blanche les tokens, créer des jauges, paramètres du protocole |
| **Emergency Council** | Désactiver/réactiver les jauges en cas d'urgence |
| **Fee Manager** | Ajuster les taux de frais de trading par pool |
| **Pauser** | Mettre en pause tous les swaps en cas d'urgence |

### Timelock

Le multisig **HyperdromeGovernor** inclut des timelocks par fonction :

* Délai personnalisé par combinaison sélecteur de fonction / destination
* Support de l'exécution de transactions groupées
* Basé sur le modèle ZeroExGovernor de 0x

### Propriétés de sécurité clés

* **Attribution immuable du Minter** — `setMinter()` ne peut être appelé qu'une seule fois sur le token HDROME
* **Déploiement déterministe CREATE2** — Les adresses des paires sont prévisibles et vérifiables
* **Système d'attachement des veNFT** — Empêche le transfert des veNFTs pendant le staking dans les jauges
* **Votes verrouillés par époque** — Les votes ne peuvent pas être modifiés en cours d'époque, empêchant la manipulation
* **Oracle TWAP** — Périodes d'observation de 30 minutes résistant à la manipulation des prix

## Version Solidity

Tous les contrats sont compilés avec **Solidity 0.8.13** avec les protections standard contre les dépassements arithmétiques.

## Suite de tests

Le protocole inclut **21 fichiers de tests Foundry** couvrant :

* Mécaniques des paires AMM et comptabilité des frais
* Opérations de verrouillage/déverrouillage/fusion des veNFT
* Calculs d'émissions et calendriers de décroissance
* Staking de jauges et distribution des récompenses
* Mécaniques de vote et transitions d'époques
* Désactivation/réactivation d'urgence des jauges
* Distribution d'airdrop par Merkle claim
* Propositions de gouvernance on-chain
* Protection anti-wash-trade
* Précision de l'oracle et cas limites

---

### Agentic

#### Apercu Agentique

URL: https://docs.hyperdrome.finance/fr/agentic/overview

L'agent Hyperdrome -- une interface IA native pour le DEX ve(3,3) sur Hyperliquid. Avec valeurs, flux et references HyperEVM.

# L'Agent Hyperdrome

![${2}](${1})

## Pas un DEX avec de l'IA -- C'est un Agent IA avec un DEX

Hyperdrome est construit IA d'abord. L'agent n'est pas un chatbot greffe sur une interface de trading -- il **est** l'interface. Chaque action DeFi (echange, LP, verrouillage, vote, reclamation) est accessible via une conversation en langage naturel ou des commandes slash. L'interface traditionnelle existe en secours, mais l'agent est le moyen principal par lequel les utilisateurs interagissent avec le protocole.

---

## Architecture

L'agent Hyperdrome utilise une couche de routage LLM pour interpreter l'intention de l'utilisateur et la mapper sur des actions on-chain. Lorsqu'un utilisateur envoie un message, l'agent :

1. **Analyse l'intention** -- Le LLM analyse le message pour determiner ce que l'utilisateur souhaite faire (echanger, LP, voter, consulter le portefeuille, etc.)
2. **Rassemble le contexte** -- Lit l'etat on-chain (soldes du portefeuille, donnees des pools, positions veNFT, recompenses en attente) et les donnees off-chain (prix, TVL, APRs)
3. **Genere la reponse** -- Produit une explication en langage naturel avec des cartes UI riches montrant l'action proposee, les parametres et les resultats attendus
4. **Execute sur confirmation** -- Lorsque l'utilisateur confirme, l'agent construit et soumet la ou les transactions

L'agent supporte plusieurs backends LLM (Claude, GPT-4, Gemini) sans cout pour l'utilisateur.

---

## Chat-vers-DeFi

Les utilisateurs interagissent avec l'ensemble du protocole via des prompts conversationnels :

* *"Echange 100 USDC en HYPE"*
* *"Quelles sont mes recompenses en attente ?"*
* *"Verrouille 1000 HDROME pour 4 ans"*
* *"Vote tout mon veHDROME sur le pool HYPE/USDC"*
* *"Quel est le meilleur rendement en ce moment ?"*

L'agent gere le routage, le slippage, l'estimation du gas et la construction des transactions en arriere-plan.

---

## Commandes Slash

| Commande | Action |
|----------|--------|
| `/swap` | Echanger des tokens avec un routage optimise |
| `/lp` | Ajouter ou retirer de la liquidite d'un pool |
| `/vote` | Allouer les votes veHDROME aux gauges |
| `/lock` | Verrouiller des HDROME pour creer ou prolonger un veNFT |
| `/claim` | Reclamer toutes les recompenses en attente (emissions, frais, pots-de-vin) |
| `/help` | Afficher les commandes disponibles et leur utilisation |

---

## Cartes UI Riches

L'agent affiche des cartes interactives pour chaque action -- pas seulement des reponses textuelles. Les cartes affichent :

* **Cartes d'echange** -- Paire de tokens, montant, impact sur le prix, chemin de routage, tolerance de slippage
* **Cartes LP** -- Paire de pool, TVL, APR, votre part, montants de depot
* **Cartes de vote** -- Liste des gauges, poids de vote actuels, revenus projetes de frais/pots-de-vin
* **Cartes de portefeuille** -- Soldes de tokens, positions LP, details veNFT, recompenses en attente
* **Cartes de recompenses** -- Ventilation des emissions, frais et pots-de-vin reclamables avec valeurs en USD

---

## Actions Executables

| Categorie | Actions |
|-----------|---------|
| **Trading** | Echanger des tokens, routage multi-sauts, definir le slippage |
| **Liquidite** | Ajouter de la liquidite, retirer de la liquidite, staker dans le gauge, unstaker du gauge |
| **Verrouillage** | Creer un veNFT, augmenter le montant verrouille, prolonger la duree du verrouillage, fusionner des veNFTs |
| **Vote** | Voter sur les gauges, reinitialiser les votes, poker les votes obsoletes |
| **Recompenses** | Reclamer les emissions, reclamer les frais, reclamer les pots-de-vin, reclamer les rebases |
| **Portefeuille** | Voir les soldes, voir les positions, voir les recompenses en attente, obtenir des recommandations de rendement |

---

## Suggestions Intelligentes

L'agent fait remonter proactivement les opportunites d'optimisation en fonction de l'etat du portefeuille :

| Priorite | Declencheur | Suggestion |
|----------|------------|------------|
| **Haute** | Tokens LP non stakes detectes | Staker dans le gauge pour gagner des emissions |
| **Haute** | Recompenses non reclamees > 10 $ | Reclamer et capitaliser les recompenses en attente |
| **Haute** | veNFT expirant dans 7 jours | Prolonger le verrouillage pour maintenir le pouvoir de vote |
| **Moyenne** | Tokens inactifs > 10 $ non en LP/verrouillage | Fournir de la liquidite ou verrouiller pour veHDROME |
| **Moyenne** | Allocation de vote sous-optimale | Reequilibrer les votes vers des gauges a rendement plus eleve |
| **Basse** | Nouveau pool a APR eleve disponible | Envisager le LP dans les pools tendance |

---

## Architecture LLM-Agnostique

L'agent Hyperdrome **n'est pas verrouille sur un seul fournisseur d'IA**. L'architecture separe l'analyse d'intention, la collecte de contexte et l'execution en couches independantes -- le backend LLM peut donc etre echange sans rien modifier d'autre.

| Couche | Role | LLM requis ? |
|--------|------|--------------|
| **Intent Parser** | Comprendre ce que l'utilisateur veut | Oui -- n'importe quel LLM |
| **Context Gatherer** | Lire les donnees on-chain + off-chain | Non |
| **Responder** | Generer l'explication + cartes UI | Oui -- n'importe quel LLM |
| **Executor** | Construire et soumettre les transactions | Non |

Supporte actuellement **Claude**, **GPT-4** et **Gemini** avec routage intelligent. Les modeles open-source (Llama, Mistral, Qwen) et Bring Your Own LLM sont sur la feuille de route.

  ### Integrations LLM
    Support multi-modeles, routage et Bring Your Own LLM
  

  ### Serveur MCP
    Connectez n'importe quel assistant IA a Hyperdrome via MCP
  

  ### Frameworks d'Agents
    GOAT SDK, Wayfinder, Eliza, Olas, REST API
  

---

## Support Multilingue

L'agent repond dans la langue de l'utilisateur. Les prompts en francais, anglais, chinois, japonais, coreen, espagnol, portugais, turc, russe, arabe et d'autres langues sont tous supportes nativement grace aux capacites LLM sous-jacentes. Les labels UI et les commandes slash restent en anglais, mais toutes les reponses conversationnelles s'adaptent a la langue de l'utilisateur.

---

#### Integrations LLM

URL: https://docs.hyperdrome.finance/fr/agentic/llm-integrations

Comment Hyperdrome se connecte a n'importe quel LLM -- Claude, GPT-4, Gemini, Llama, Mistral et plus. Avec valeurs, flux et references HyperEVM.

# Integrations LLM

![${2}](${1})

## LLM-Agnostique par conception

Hyperdrome n'est pas verrouille sur un seul fournisseur d'IA. L'architecture de l'agent separe l'**analyse d'intention**, la **collecte de contexte** et l'**execution** en couches independantes -- le backend LLM peut donc etre echange sans rien modifier d'autre.

Cela signifie qu'Hyperdrome fonctionne avec n'importe quel modele de langage aujourd'hui, et fonctionnera avec n'importe quel modele publie demain.

---

## Modeles supportes

  ### Claude
    Opus, Sonnet, Haiku — **En ligne**
  

  ### GPT-4
    GPT-4o, GPT-4, GPT-4 Turbo — **En ligne**
  

  ### Gemini
    Gemini 2.5 Pro, 2.5 Flash — **En ligne**
  

  ### Open Source
    Llama, Mistral, Qwen, DeepSeek — *Prevu*
  

  Tous les modeles sont disponibles a **0 $ de cout** pour les utilisateurs. Hyperdrome couvre les couts d'inference.

---

## Architecture

Le pipeline de l'agent est agnostique au modele a chaque etape :

```
User Input (natural language or /command)
        │
        ▼
┌──────────────────┐
│  Intent Parser   │ ← Any LLM (Claude, GPT-4, Gemini, Llama...)
│  "What does the  │
│   user want?"    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Context Gatherer │ ← On-chain + off-chain data (no LLM needed)
│  Wallet, pools,  │
│  prices, APRs    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Responder     │ ← Any LLM (generates explanation + UI cards)
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Executor      │ ← Transaction builder (no LLM needed)
│  Build tx, sign, │
│  submit on-chain │
└──────────────────┘
```

Le LLM n'intervient que dans deux etapes : comprendre ce que l'utilisateur veut, et expliquer le resultat. Tout le reste -- lire l'etat de la blockchain, construire les transactions, soumettre on-chain -- est du code deterministe.

---

## Routage Intelligent

Le backend selectionne automatiquement le meilleur modele pour chaque requete en fonction de :

| Factor | Logic |
|--------|-------|
| **Complexity** | Simple queries (price checks, balance) → fastest model. Complex multi-step actions → most capable model. |
| **Language** | Some models perform better in specific languages. The router optimizes for the user's detected language. |
| **Latency** | If the primary model is slow or unavailable, the router falls back to the next best option in < 500ms. |
| **Cost** | The router balances capability vs. cost to keep inference free for all users. |

---

## Bring Your Own LLM *(Bientot disponible)*

  Cette fonctionnalite est sur la feuille de route et n'est pas encore disponible.

Les utilisateurs pourront connecter leur propre fournisseur LLM :

* **API key** -- Branchez votre propre cle API OpenAI, Anthropic, Google, ou toute cle compatible OpenAI
* **Modeles auto-heberges** -- Pointez l'agent vers votre propre endpoint Ollama, vLLM ou TGI executant Llama, Mistral, Qwen ou tout modele open-source
* **System prompts personnalises** -- Personnalisez la personnalite de l'agent, la tolerance au risque et le style de reponse
* **Confidentialite totale** -- Lorsque vous utilisez votre propre modele, aucune donnee ne passe par les serveurs d'inference d'Hyperdrome

### Endpoints compatibles

Tout endpoint implementant le format OpenAI Chat Completions API fonctionnera :

| Runtime | Example Models |
|---------|---------------|
| **Ollama** | Llama 3.3, Mistral, Qwen 2.5, DeepSeek V3, Gemma |
| **vLLM** | Any HuggingFace model |
| **TGI** | Any HuggingFace model |
| **Together AI** | Llama, Mixtral, Qwen |
| **Groq** | Llama, Mixtral, Gemma |
| **Fireworks** | Llama, Mixtral, DeepSeek |

---

## Pourquoi le LLM-Agnostique est important

1. **Pas de verrouillage fournisseur** -- Si un fournisseur augmente ses prix, degrade la qualite ou ajoute des restrictions, Hyperdrome bascule en toute transparence.

2. **Le meilleur modele pour la tache** -- Differents modeles excellent dans differentes taches. Le routage permet a Hyperdrome d'utiliser le meilleur outil pour chaque requete.

3. **A l'epreuve du futur** -- De nouveaux modeles sortent chaque mois. L'architecture LLM-agnostique signifie qu'Hyperdrome les adopte immediatement sans reecriture.

4. **Souverainete de l'utilisateur** -- Avec Bring Your Own LLM, les utilisateurs controlent leurs donnees et leur inference. Aucune dependance envers des fournisseurs d'IA centralises.

5. **Resistance a la censure** -- Les modeles open-source ne peuvent pas etre arretes ou restreints. Les utilisateurs executant leur propre instance Llama ou Mistral ont une autonomie totale.

---

#### Serveur MCP

URL: https://docs.hyperdrome.finance/fr/agentic/mcp-server

Le serveur Model Context Protocol d'Hyperdrome -- connectez n'importe quel assistant IA au DEX ve(3,3). Avec valeurs, flux et references HyperEVM.

# Serveur MCP

![${2}](${1})

  Le serveur MCP d'Hyperdrome est sur la feuille de route et n'est pas encore en production. Cette page documente la specification prevue.

## Qu'est-ce que MCP ?

**Model Context Protocol (MCP)** est un standard ouvert d'Anthropic qui permet aux assistants IA de decouvrir et d'appeler des outils sur des serveurs externes. Il utilise JSON-RPC 2.0 -- l'assistant appelle `tools/list` pour decouvrir les actions disponibles, puis `tools/call` pour les executer.

MCP est supporte par **Claude Desktop**, **Cursor**, **Opencode**, **Windsurf**, et un nombre croissant d'outils IA de codage et de chat.

---

## Pourquoi MCP pour la DeFi ?

Aujourd'hui, interagir avec la DeFi necessite de :
1. Ouvrir un navigateur
2. Connecter un portefeuille
3. Naviguer dans une interface complexe
4. Comprendre le slippage, le routage, le gas

Avec le serveur MCP d'Hyperdrome, n'importe quel assistant IA peut **directement** echanger des tokens, consulter les rendements, voter sur les gauges et gerer les positions -- sans que l'utilisateur quitte jamais son outil prefere.

> *"Swap 500 USDC to HYPE on Hyperdrome"* -- tape dans Claude Desktop, Cursor, ou tout client MCP.

---

## Outils disponibles

Le serveur MCP expose l'ensemble du protocole Hyperdrome sous forme d'outils appelables :

### Trading

| Tool | Description | Parameters |
|------|-------------|------------|
| `swap` | Swap tokens with optimized multi-hop routing | `fromToken`, `toToken`, `amount`, `slippageBps?` |
| `get_quote` | Get a swap quote without executing | `fromToken`, `toToken`, `amount` |

### Liquidity

| Tool | Description | Parameters |
|------|-------------|------------|
| `add_liquidity` | Deposit token pair into a pool | `tokenA`, `tokenB`, `amountA`, `amountB`, `stable` |
| `remove_liquidity` | Withdraw from a pool | `tokenA`, `tokenB`, `stable`, `liquidity` |
| `stake_lp` | Stake LP tokens in a gauge | `pool`, `amount` |
| `unstake_lp` | Unstake LP tokens from a gauge | `pool`, `amount` |

### Locking & Voting

| Tool | Description | Parameters |
|------|-------------|------------|
| `lock` | Lock HDROME to create or extend a veNFT | `amount`, `duration` |
| `vote` | Allocate veHDROME votes across gauges | `tokenId`, `pools[]`, `weights[]` |
| `reset_votes` | Reset votes for a veNFT | `tokenId` |

### Rewards

| Tool | Description | Parameters |
|------|-------------|------------|
| `claim_rewards` | Claim all pending rewards | `tokenId?` |
| `claim_fees` | Claim trading fees for a specific gauge | `gauge` |
| `claim_bribes` | Claim external bribes | `gauge`, `tokens[]` |

### Read-Only

| Tool | Description | Parameters |
|------|-------------|------------|
| `get_pools` | List all pools with TVL, APR, volume | `sortBy?`, `limit?` |
| `get_portfolio` | Full wallet analysis | `address` |
| `get_yields` | Top yield opportunities | `limit?`, `minTvl?` |
| `get_venft` | Get veNFT details | `tokenId` |
| `get_pending_rewards` | Check unclaimed rewards | `address` |

---

## Exemple de schema d'outil

Chaque outil suit la specification MCP avec un JSON Schema pour les entrees :

```json
{
  "name": "swap",
  "description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromToken": {
        "type": "string",
        "description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
      },
      "toToken": {
        "type": "string",
        "description": "Token symbol or address to buy (e.g. 'HYPE')"
      },
      "amount": {
        "type": "string",
        "description": "Amount to swap in human-readable units (e.g. '100')"
      },
      "slippageBps": {
        "type": "number",
        "description": "Max slippage in basis points (default: 50 = 0.5%)"
      }
    },
    "required": ["fromToken", "toToken", "amount"]
  }
}
```

---

## Connexion

### Claude Desktop / Cursor / Opencode

Ajoutez a votre configuration MCP :

```json
{
  "mcpServers": {
    "hyperdrome": {
      "url": "https://mcp.hyperdrome.finance/sse"
    }
  }
}
```

### Auto-heberge

Le serveur MCP sera open-source. Executez votre propre instance :

```bash
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
```

---

## Modele de securite

| Property | Detail |
|----------|--------|
| **Read-only by default** | Portfolio queries and pool data require no wallet connection |
| **Transaction approval** | All write operations return unsigned transactions for the user to review and sign |
| **No private keys** | The hosted MCP server never touches private keys. Signing happens client-side. |
| **Rate limiting** | Per-IP and per-API-key rate limits to prevent abuse |
| **Audit trail** | Every tool call is logged with timestamp, parameters, and result |

  Le serveur MCP n'execute jamais de transactions en votre nom. Il construit la transaction et la renvoie pour votre approbation explicite -- comme n'importe quel frontend DeFi.

---

## Cas d'utilisation

| Scenario | Comment |
|----------|---------|
| **Developpeur construisant un dashboard DeFi** | Interroger les pools, rendements et positions via les outils MCP |
| **Assistant IA de codage** | "Aide-moi a ecrire un script qui reclame toutes mes recompenses Hyperdrome" -- l'assistant appelle `get_pending_rewards` puis `claim_rewards` |
| **Agent autonome** | Un agent de gestion de portefeuille verifie les rendements toutes les heures et reequilibre via `add_liquidity` / `remove_liquidity` |
| **Chat bot** | Un bot Telegram qui permet aux utilisateurs d'echanger, consulter leur portefeuille et voter en langage naturel |
| **Recherche** | Un analyste interroge `get_pools` pour construire une comparaison de rendements entre les DEX HyperEVM |

---

#### Integrations Frameworks d'Agents

URL: https://docs.hyperdrome.finance/fr/agentic/agent-frameworks

Comment Hyperdrome s'integre avec GOAT SDK, Wayfinder, Eliza, Olas et l'ecosysteme d'agents IA. Avec valeurs, flux et references HyperEVM.

# Integrations Frameworks d'Agents

![${2}](${1})

Hyperdrome est concu pour etre accessible depuis **n'importe quel agent IA**, pas seulement le notre. Le protocole expose ses fonctionnalites a travers plusieurs couches d'integration afin que les agents, frameworks et plateformes tiers puissent interagir avec Hyperdrome nativement.

  ### GOAT SDK
    200+ outils, 13+ adaptateurs de frameworks
  
  ### MCP
    Claude Desktop, Cursor, Opencode
  
  ### Wayfinder
    Terminal DeFi IA natif
  
  ### Eliza
    Agents autonomes sociaux + DeFi
  
  ### Olas
    Agents autonomes decentralises
  
  ### REST API
    Endpoints HTTP directs
  

---

## Architecture d'integration

```
┌─────────────────────────────────────────────────┐
│              AI Agent Frameworks                 │
│  Claude · GPT · Gemini · Llama · Mistral · ...  │
├─────────────────────────────────────────────────┤
│              Adapter Layer                       │
│  GOAT SDK · Wayfinder · Eliza · LangChain ·     │
│  Vercel AI · MCP · REST API                     │
├─────────────────────────────────────────────────┤
│           Hyperdrome Protocol Layer              │
│  Intent Parser → Context → Tx Builder → Chain   │
├─────────────────────────────────────────────────┤
│                 HyperEVM                         │
│  Router · Voter · Gauges · VotingEscrow · ...   │
└─────────────────────────────────────────────────┘
```

Tout framework supportant l'une des couches d'adaptation peut interagir avec Hyperdrome. Aucun code d'integration specifique necessaire.

---

## GOAT SDK Plugin

  Le GOAT SDK plugin est sur la feuille de route et n'est pas encore publie.

**GOAT SDK** est la plus grande boite a outils de finance agentique -- 200+ outils, 15+ chaines, 13+ adaptateurs de frameworks. Des protocoles comme Uniswap, Aave, 1inch et Balancer ont deja des plugins GOAT.

Hyperdrome publiera `@goat-sdk/plugin-hyperdrome` avec une couverture complete du protocole :

### Actions exposees

| Action | Description |
|--------|-------------|
| `swap` | Swap tokens with optimized routing |
| `addLiquidity` | Deposit into volatile or stable pools |
| `removeLiquidity` | Withdraw from pools |
| `stakeLp` | Stake LP tokens in gauges |
| `unstakeLp` | Unstake from gauges |
| `lock` | Lock HDROME → veHDROME (create/extend veNFT) |
| `vote` | Allocate votes across gauges |
| `claimRewards` | Claim emissions, fees, bribes, rebases |
| `getPools` | List pools with TVL, APR, volume |
| `getPortfolio` | Full wallet analysis |

### Portee des frameworks

Une fois le plugin GOAT publie, Hyperdrome sera automatiquement disponible dans :

| Framework | Type |
|-----------|------|
| **Vercel AI SDK** | Full-stack AI apps |
| **LangChain** | Agent orchestration (Python & JS) |
| **LlamaIndex** | Data-augmented agents |
| **MCP** | Claude Desktop, Cursor, Opencode |
| **Eliza** | Autonomous social + DeFi agents |
| **CrewAI** | Multi-agent systems |
| **Mastra** | TypeScript agent framework |
| **GAME (Virtuals)** | Gaming + DeFi agents |
| **OpenAI Agents SDK** | OpenAI's native agent runtime |
| **ZerePy** | Python agent framework |
| **AutoGen** | Microsoft's multi-agent framework |
| **Olas** | Decentralized autonomous agents |

---

## Wayfinder Paths

  L'integration Wayfinder est sur la feuille de route et n'est pas encore disponible.

**Wayfinder** est un terminal DeFi IA natif avec son propre SDK (Paths). Il supporte deja Hyperliquid perps, Aave V3, Morpho, Pendle et Uniswap V3.

Hyperdrome publiera un **adaptateur de protocole Wayfinder** permettant :

* Swap, LP, vote et verrouillage via Wayfinder Shells (interface de trading IA)
* Composition de strategies -- combiner le rendement Hyperdrome avec des strategies cross-protocole
* Pont MCP -- le serveur MCP integre de Wayfinder exposera les outils Hyperdrome

---

## Eliza (ElizaOS)

**Eliza** est le framework open-source de reference pour les agents crypto autonomes. Il alimente des bots sociaux + DeFi operant sur Twitter, Telegram et on-chain.

Integration Hyperdrome via le plugin GOAT (`@elizaos/plugin-goat`) :

* Les agents Eliza peuvent echanger, LP, voter et reclamer sur Hyperdrome
* Yield farming autonome -- des agents qui surveillent les APR et reequilibrent les positions
* Social + DeFi -- des agents qui publient des mises a jour de rendement, repondent aux questions de la communaute et executent des trades

---

## Olas (Autonolas)

**Olas** est une plateforme decentralisee pour co-posseder et executer des agents IA autonomes. 3 600+ agents deployes, 17M+ transactions.

Chemin d'integration Hyperdrome :

* Construire un **Olas agent service** qui gere les positions Hyperdrome
* S'enregistrer comme **Mech** dans le marketplace Olas -- d'autres agents peuvent engager des actions Hyperdrome
* Composer avec les agents Olas existants pour des strategies cross-protocole

---

## REST API

  La REST API publique est sur la feuille de route et n'est pas encore disponible.

Pour les developpeurs qui veulent une integration directe sans framework :

### Endpoints prevus

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/api/pools` | List all pools with TVL, APR, fees, volume |
| `GET` | `/api/pools/:address` | Pool details |
| `GET` | `/api/portfolio/:wallet` | Full portfolio analysis |
| `GET` | `/api/yields` | Top yield opportunities |
| `POST` | `/api/quote` | Get a swap quote |
| `POST` | `/api/swap` | Build a swap transaction |
| `POST` | `/api/liquidity/add` | Build an add-liquidity transaction |
| `POST` | `/api/liquidity/remove` | Build a remove-liquidity transaction |
| `POST` | `/api/lock` | Build a lock transaction |
| `POST` | `/api/vote` | Build a vote transaction |
| `POST` | `/api/claim` | Build a claim-all transaction |

### Format de reponse

Tous les endpoints d'ecriture renvoient des donnees de transaction non signees :

```json
{
  "tx": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "chainId": 999,
    "gasLimit": "250000"
  },
  "summary": {
    "action": "Swap 100 USDC → 1.62 HYPE",
    "priceImpact": "0.03%",
    "route": ["USDC", "HYPE"],
    "minReceived": "1.611 HYPE"
  }
}
```

  L'API ne requiert jamais de cles privees. Toutes les transactions sont renvoyees non signees pour signature cote client.

---

## LangChain Tool

Pour les developpeurs Python utilisant LangChain directement :

```python
from langchain.tools import tool

@tool
def hyperdrome_swap(from_token: str, to_token: str, amount: str) -> str:
    """Swap tokens on Hyperdrome (HyperEVM). Returns unsigned transaction."""
    # Calls Hyperdrome REST API
    ...
```

L'adaptateur GOAT SDK gere cela automatiquement, mais les developpeurs peuvent aussi construire des outils LangChain personnalises contre la REST API.

---

## Construire votre propre integration

Vous souhaitez integrer Hyperdrome dans votre agent, bot ou application ?

1. **Le plus rapide** -- Utilisez le GOAT SDK plugin. Fonctionne avec 13+ frameworks prets a l'emploi.
2. **Le plus flexible** -- Utilisez la REST API directement. Construisez et signez des transactions dans n'importe quel langage.
3. **IA natif** -- Connectez-vous via MCP. Fonctionne avec Claude Desktop, Cursor, Opencode et tout client MCP.
4. **Autonome** -- Construisez un Olas agent service pour une execution d'agent entierement decentralisee et on-chain.

Toutes les couches d'integration renvoient des transactions non signees -- votre application gere la signature et la soumission. Hyperdrome ne touche jamais aux cles privees.

---

#### Capacites de l'agent et feuille de route

URL: https://docs.hyperdrome.finance/fr/agentic/capabilities

Capacites completes, sources de donnees et fonctionnalites a venir de l'agent Hyperdrome. Avec valeurs, flux et references HyperEVM.

# Capacites de l'agent et feuille de route

## Sources de donnees en temps reel

| Source | Donnees | Mise a jour |
|--------|------|--------|
| **HyperEVM RPC** | Soldes du portefeuille, positions LP, details veNFT, stakes de gauge, recompenses en attente | Temps reel |
| **CoinGecko** | Prix HYPE, USDC, USDT, BTC, ETH, SOL + variation 24h + capitalisation + volume | Cache 60s |
| **DeFiLlama** | TVL de la chaine Hyperliquid L1, top 20 des protocoles avec TVL/categorie/variation 7j | Cache 60s |
| **Hyperliquid API** | Tous les jetons spot avec prix marks, volumes 24h, offre en circulation | Cache 60s |
| **Contrats du protocole** | Reserves des pools, TVL, APR, poids des votes, montants des pots-de-vin, taux d'emission | Temps reel |

## Analyse du portefeuille

L'agent effectue une analyse approfondie du portefeuille lorsque votre wallet est connecte :

* **Soldes de jetons** avec valeurs en USD (tries par valeur)
* **Detection de capital inactif** -- jetons > 10 $ non en LP/verrouillages
* **Positions LP** -- paire, stable/volatile, stake/non stake, TVL, APR, adresse du gauge
* **Detection des LP non stakes** -- LP ne generant aucune emission
* **veNFTs** -- montant verrouille, echeance, jours restants, indicateurs expire/expirant, pouvoir de vote, statut de vote
* **Recompenses en attente** -- emissions, pots-de-vin, frais -- detailles par paire avec totaux en USD
* **Top 10 des pools par APR** pour les recommandations

## Feuille de route

| Fonctionnalite | Statut |
|----------------|--------|
| Chat-to-DeFi (Web) | **Livre** |
| Commandes Slash | **Livre** |
| Cartes UI enrichies | **Livre** |
| Suggestions intelligentes | **Livre** |
| Multi-LLM Backend (Claude, GPT-4, Gemini) | **Livre** |
| Super-agent Telegram | **En cours** |
| MCP Server | Prevu |
| GOAT SDK Plugin | Prevu |
| Public REST API | Prevu |
| Wayfinder Integration | Prevu |
| Bring Your Own LLM | Prevu |
| Autopilot | Prevu |
| Machine a contenu | Prevu |
| PFP dynamiques veNFT | Prevu |
| Optimiseur de pots-de-vin | Prevu |
| Rapports de rendement | Prevu |
| Tresorerie IA | Prevu |

### Autopilot *(Bientot disponible)*

"Deposez et relaxez" -- l'agent gere automatiquement l'ensemble de votre position DeFi.

| Profil de risque | APY cible | Strategie |
|-------------|-----------|----------|
| **Conservateur** | 8-15 % | Pools stables, verrouillage max, paires blue-chip |
| **Equilibre** | 15-30 % | Mix stable/volatile, verrouillages moyens |
| **Agressif** | 30-80 % | Pools volatiles, farming de pots-de-vin, reequilibrage actif |
| **Degen** | 50-200 % | Nouveaux pools, capture maximale de pots-de-vin, verrouillages courts |

L'agent gere : la gestion des positions LP, le staking dans les gauges, le vote veHDROME, la reclamation des recompenses, le reinvestissement compose et le reequilibrage -- le tout 24h/24 et 7j/7 sans intervention de l'utilisateur.

**Modele de revenus** : frais de performance de 5 % sur le rendement Autopilot.

### Super-agent Telegram *(Bientot disponible)*

Un seul bot pour l'experience Hyperdrome complete :
* Echange, rendement, portefeuille, reclamation, autopilot
* Education, alertes, generation de memes
* Generation de PFP, analyse des pots-de-vin, rapports de rendement

### Optimiseur de pots-de-vin *(Bientot disponible)*

Outil B2B pour les protocoles :
* Entree : objectif de liquidite (ex. "500K $ de TVL pour TOKEN/HYPE")
* Sortie : montant exact du pot-de-vin, ROI projete, timing d'epoque recommande
* Suivi de l'efficacite des pots-de-vin dans le temps

### PFP dynamiques veNFT *(Bientot disponible)*

Photos de profil generees par IA qui evoluent selon :
* La duree et le montant du verrouillage
* L'activite de vote et la regularite
* Le rendement total gagne
* L'anciennete dans le protocole

### Tresorerie IA *(Bientot disponible)*

Gestion autonome de la tresorerie :
* L'IA alloue jusqu'a 30 % de la tresorerie par epoque
* Publie les decisions 12 heures avant execution
* Mecanisme de veto communautaire
* Transparence totale on-chain

## Confidentialite

* Ne lit que les donnees publiques on-chain de votre portefeuille connecte
* Aucune donnee de portefeuille stockee entre les sessions
* Les conversations ne sont pas conservees cote serveur

---

## de - German

### Erste Schritte

#### Einleitung

URL: https://docs.hyperdrome.finance/de/introduction

Willkommen bei Hyperdrome - Die agentische ve(3,3) DEX auf Hyperliquid. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

## Was ist Hyperdrome?

Hyperdrome ist die **agentische ve(3,3) DEX** auf Hyperliquid. Sie kombiniert einen kampferprobten AMM (geforkt von Aerodrome/Velodrome) mit einem KI-gesteuerten Agenten, der Swaps, Liquiditaet, Abstimmungen und Renditeoptimierung per natuerlicher Sprache uebernimmt.

Das Produkt ist **keine DEX mit KI -- es ist ein KI-Agent mit einer DEX.**

## Das ve(3,3)-System

Das ve(3,3)-Modell erzeugt ein nachhaltiges Schwungrad, bei dem jeder Teilnehmer von Kooperation profitiert:

![${2}](${1})

### Kernkomponenten

1. **Voting Escrow (ve)**
   * HDROME sperren, um veHDROME-Stimmrecht zu erhalten (bis zu 4 Jahre)
   * Laengere Sperrzeiten = mehr Stimmrecht, linear abnehmend
   * Gesperrte Position wird als ERC-721 NFT dargestellt

2. **(3,3) Spieltheorie**
   * Kooperation ist die dominante Strategie fuer alle Teilnehmer
   * Waehler erhalten 100% der Handelsgebuehren + externe Bestechungen
   * Anti-Verwaesserungs-Rebases schuetzen langfristige Sperrer

### Vorteile

* **Nachhaltige Emissionen**: ~1% woechentlicher Rueckgang mit 0,2% Mindestwert der umlaufenden Versorgung
* **Stimmrecht**: Direkte woechentliche Emissionsverteilung ueber Gauges
* **Gebuehrenverteilung**: 100% der Handelsgebuehren an veHDROME-Waehler
* **Bestechungsmarktplatz**: Protokolle erwerben Liquiditaet zu einem Bruchteil der direkten Anreizkosten

## Duales AMM-Design

| Pool-Typ | Kurve | Standard-Gebuehr | Ideal fuer |
|-----------|-------|-------------|----------|
| **Volatil (vAMM)** | `x * y = k` | 0,2% | HYPE/USDC, HDROME/HYPE |
| **Stabil (sAMM)** | `x³y + y³x = k` | 0,02% | USDC/USDT, gekoppelte Paare |

Jeder Pool enthaelt ein integriertes **TWAP-Orakel** mit 30-minuetigen Beobachtungszeitraeumen.

## Aufgebaut auf HyperEVM

| Eigenschaft | Wert |
|----------|-------|
| Chain | HyperEVM |
| Chain ID | 999 |
| Nativer Token | HYPE |
| RPC | `https://rpc.hyperliquid.xyz/evm` |
| Explorer | `https://explorer.hyperliquid.xyz` |

## Erste Schritte

  ### App starten
    Handeln, Liquiditaet bereitstellen und Belohnungen verdienen
  

  ### Token tauschen
    Token mit optimiertem Multi-Hop-Routing handeln
  

  ### Liquiditaet bereitstellen
    Token-Paare einzahlen und in Gauges staken fuer Emissionen
  

  ### Sperren & Abstimmen
    HDROME fuer veHDROME sperren und Protokoll-Emissionen steuern
  

## Warum Hyperdrome?

* **KI-nativ**: Integrierter Agent bewaeltigt DeFi-Komplexitaet per natuerlicher Sprache und Slash-Befehlen
* **Bewaehrte Codebasis**: Fork von Aerodrome/Velodrome -- die kampferprobteste ve(3,3)-Implementierung
* **Autopilot** *(bald verfuegbar)*: Einzahlen & Entspannen -- KI verwaltet LP, Staking, Abstimmung, Rebalancing, Compounding rund um die Uhr
* **$0 KI-Kosten**: Unbegrenzter Zugang zu Claude, GPT-4 und Gemini ohne marginale Kosten pro Nutzer
* **Bestechungs-Optimierer** *(bald verfuegbar)*: B2B-Tool -- Protokolle geben ein Liquiditaetsziel ein, KI liefert den genauen Bestechungsbetrag + prognostizierten ROI

---

### Tokenomics

#### HDROME Token

URL: https://docs.hyperdrome.finance/de/tokenomics/hdrome-token

Der HDROME-Token betreibt die Hyperdrome ve(3,3) DEX auf Hyperliquid -- sperren, abstimmen und verdienen. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# HDROME Token

![${2}](${1})

## Token-Details

| Eigenschaft | Wert |
|-------------|------|
| Symbol | HDROME |
| Dezimalstellen | 18 |
| Chain | HyperEVM (Chain ID 999) |
| Standard | ERC-20 |
| Gesamtangebot | 1.000.000.000 |

## Kernfunktionen

HDROME ist der native Token des Hyperdrome-Protokolls. Seine primaeren Funktionen:

* **Sperren fuer veHDROME** -- HDROME sperren, um veHDROME-Stimmrecht als ERC-721 NFT zu erhalten
* **Governance** -- veHDROME-Halter steuern Protokollparameter und Emissionsverteilung
* **Gauge-Abstimmung** -- Woechentliche HDROME-Emissionen auf Liquiditaetspools Ihrer Wahl lenken
* **100% Handelsgebuehren** -- Waehler erhalten 100% der Handelsgebuehren der Pools, fuer die sie gestimmt haben
* **Bestechungen** -- Externe Bestechungen verdienen, die von Protokollen hinterlegt werden, die Liquiditaet suchen
* **Rebases** -- Anti-Verwaesserungs-HDROME-Rebases schuetzen langfristige Sperrer vor Emissionsverwaesserung

---

## Sperrmechanismen

![${2}](${1})

Das Sperren von HDROME erzeugt eine **veHDROME**-Position, die als ERC-721 NFT (veNFT) dargestellt wird. Das Stimmrecht nimmt linear ueber die Sperrdauer ab.

### Sperrparameter

| Parameter | Wert |
|-----------|------|
| Mindestsperre | 1 Woche |
| Maximalsperre | 4 Jahre |
| Abnahme | Linear ueber die Sperrdauer |
| Darstellung | ERC-721 NFT (veNFT) |

### Stimmrecht-Formel

```
votingPower = (lockAmount × lockDuration) / maxDuration
```

Wobei `maxDuration` = 4 Jahre. Je laenger Sie sperren, desto mehr Stimmrecht erhalten Sie:

| Sperrdauer | Stimmrecht (% des gesperrten Betrags) |
|------------|--------------------------------------|
| 4 Jahre | 100% |
| 2 Jahre | 50% |
| 1 Jahr | 25% |
| 6 Monate | 12,5% |

### veNFT-Verwaltung

| Aktion | Beschreibung |
|--------|-------------|
| **Erstellen** | HDROME sperren, um ein neues veNFT mit gewaehlter Dauer zu pregen |
| **Betrag erhoehen** | Mehr HDROME zu einem bestehenden veNFT hinzufuegen |
| **Sperre verlaengern** | Sperrdauer verlaengern, um das Stimmrecht zu erhoehen |
| **Zusammenfuehren** | Zwei veNFTs zu einem kombinieren (Sperrdauern werden abgeglichen) |
| **Uebertragen** | Ihr veNFT an eine andere Wallet senden (ERC-721-Uebertragung) |
| **Abheben** | Entsperrte HDROME nach Ablauf der Sperre beanspruchen |

  Gesperrte HDROME koennen nicht vor Ablauf der Sperre abgehoben werden. Das Stimmrecht nimmt linear ab -- eine 4-Jahres-Sperre mit 1.000 HDROME beginnt bei 1.000 veHDROME und erreicht 0 bei Ablauf. Verlaengern Sie Ihre Sperre, um das volle Stimmrecht aufrechtzuerhalten.

---

#### Token-Verteilung & Emissionen

URL: https://docs.hyperdrome.finance/de/tokenomics/distribution-emissions

Detaillierte Aufschluesselung der HDROME-Token-Verteilung und des Emissionsplans. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# Token-Verteilung & Emissionen

## Gesamtangebot: 1.000.000.000 HDROME

![${2}](${1})

| Kategorie | Zuteilung | Menge | Form | Details |
|-----------|-----------|-------|------|---------|
| **Protokoll** | 65% | 650.000.000 | HDROME | Emissionen, Liquiditaet und Protokollwachstum |
| **Vorverkauf** | 20% | 200.000.000 | HDROME | Details folgen in Kuerze |
| **Team & Mitwirkende** | 5% | 50.000.000 | veHDROME | Vesting-Sperren |
| **Community-Airdrop** | 5% | 50.000.000 | veHDROME | 4-Jahres-Sperre ueber MerkleClaim |
| **Marketing** | 5% | 50.000.000 | HDROME | Wachstum, Partnerschaften und Anreize |

  
    Die groesste Zuteilung ist fuer das Protokoll selbst reserviert. Dies umfasst Gauge-Emissionen zur Belohnung von LPs, protokolleigene Liquiditaet und zukuenftige Wachstumsinitiativen. Die Zuteilung gewaehrleistet die langfristige Nachhaltigkeit des Hyperdrome-Oekosystems.
  
  
    200.000.000 HDROME sind fuer die Vorverkaufsrunde vorgesehen. Weitere Details werden in Kuerze bekannt gegeben.
  
  
    50.000.000 HDROME werden als **veHDROME** mit Vesting-Sperren verteilt. Dies bringt die Anreize des Teams mit dem langfristigen Protokollerfolg in Einklang -- das Team verdient durch Abstimmungsgebuehren und Bestechungen, nicht durch den Verkauf von Token.
  
  
    50.000.000 HDROME werden als **veHDROME** mit 4-Jahres-Sperren ueber den MerkleClaim-Vertrag verteilt. Empfaenger erhalten sofort ab dem ersten Tag Stimmrecht und Gebuehreneinnahmen.
  
  
    50.000.000 HDROME sind fuer Wachstumsinitiativen, strategische Partnerschaften, KOL-Kampagnen und Oekosystem-Anreize vorgesehen.
  

---

## Emissionsplan

![${2}](${1})

### Woechentliche Emissionen

Die Emissionen beginnen bei **15.000.000 HDROME pro Woche** und nehmen pro Epoche um etwa 1% ab:

```
weekly_emission(n) = weekly_emission(n-1) × 990 / 1000
```

| Zeitraum | Woechentliche Emission | Kumuliert Emittiert |
|----------|----------------------|---------------------|
| Woche 1 | 15.000.000 | 15.000.000 |
| Woche 13 (~3 Monate) | 13.100.000 | ~182.000.000 |
| Woche 26 (~6 Monate) | 11.600.000 | ~338.000.000 |
| Woche 52 (~1 Jahr) | 8.950.000 | ~573.000.000 |
| Woche 104 (~2 Jahre) | 5.340.000 | ~831.000.000 |

  Wenn die abnehmende Emission unter **0,2% des umlaufenden Angebots** faellt, wird die Tail-Emissions-Untergrenze aktiviert, um eine Mindestemissionsrate auf unbestimmte Zeit aufrechtzuerhalten.

### Woechentliche Verteilungsaufteilung

| Empfaenger | Anteil | Beschreibung |
|-----------|--------|-------------|
| **Gauges** | ~96,7% | Verteilung an Liquiditaetspools basierend auf veHDROME-Stimmgewichten |
| **Team** | ~3% | 30 Basispunkte an Team-Adresse (max. 50 Bp.) |
| **Rebases** | Variable | Anti-Verwaesserungs-HDROME fuer veHDROME-Halter ueber den RewardsDistributor |

---

## Epochenzyklus

Jede Epoche laeuft von **Donnerstag 00:00 UTC** bis zum naechsten Donnerstag:

![${2}](${1})

  
    Vorherige Stimmen werden ausgezaehlt. Der Minter berechnet die neue Emissionsmenge basierend auf der Abnahmeformel.
  
  
    Der Minter praegt HDROME. Der Voter-Vertrag verteilt an Gauges proportional zu den Stimmgewichten. Der RewardsDistributor sendet Rebases an veHDROME-Halter.
  
  
    veHDROME-Halter verteilen Stimmen auf Pools. Jedes veNFT kann einmal pro Epoche abstimmen.
  
  
    Handelsgebuehren und Bestechungen sammeln sich fuer Abstimmende an. LP-Emissionen fliessen kontinuierlich an Gauge-Staker.

---

#### veHDROME & Abstimmung

URL: https://docs.hyperdrome.finance/de/tokenomics/vehdrome-voting

Wie die veHDROME-Abstimmung funktioniert -- Gauge-Zuteilung, Einnahmequellen und Abstimmungsstrategien. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# veHDROME & Abstimmung

![${2}](${1})

## Abstimmungsablauf

In jeder Epoche (Donnerstag 00:00 UTC bis Donnerstag 00:00 UTC) verteilen veHDROME-Halter ihr Stimmrecht auf Liquiditaetspool-Gauges. Der Ablauf funktioniert wie folgt:

1. **veHDROME-Halter** waehlen einen oder mehrere Pools aus und weisen Stimmgewichte zu (prozentbasiert).
2. Der **Voter-Vertrag** zaehlt alle Stimmen beim Epochenwechsel aus.
3. Der **Minter** praegt die woechentliche HDROME-Emission und verteilt sie proportional zum Stimmanteil an die Gauges.
4. **In Gauges gestakte LPs** verdienen HDROME-Emissionen ueber die folgende Epoche auf Sekundenbasis.
5. **Waehler** erhalten 100% der Handelsgebuehren und externen Bestechungen der Pools, fuer die sie gestimmt haben.

## Gauge-System

| Parameter | Wert |
|-----------|------|
| Max. Belohnungstoken pro Gauge | 16 |
| Epochendauer | 7 Tage (Donnerstag bis Donnerstag UTC) |
| Emissionsansammlung | Pro Sekunde, proportional zum gestakten LP-Anteil |

---

## Einnahmequellen

![${2}](${1})

veHDROME-Waehler verdienen aus drei verschiedenen Einnahmequellen:

| Quelle | Herkunft | Verteilung |
|--------|----------|-----------|
| **Handelsgebuehren** | 100% der Swap-Gebuehren der gewaehlten Pools | Beanspruchbar nach Epochenwechsel |
| **Externe Bestechungen** | Von Protokollen hinterlegt, die Stimmen suchen | Beanspruchbar nach Epochenwechsel |
| **Rebases** | Anti-Verwaesserungs-HDROME vom Minter | Automatisch an veHDROME-Halter ueber den RewardsDistributor verteilt |

---

## Abstimmungsregeln

| Regel | Detail |
|-------|--------|
| **Einmal pro Epoche** | Jedes veNFT kann einmal pro Epoche abstimmen |
| **Gesperrt bis zum Wechsel** | Stimmen sind fuer die gesamte Epoche gesperrt, sobald sie abgegeben wurden |
| **Zuruecksetzen erforderlich** | Stimmen muessen zurueckgesetzt werden, bevor veNFTs uebertragen oder zusammengefuehrt werden |
| **Poke** | Jeder kann ein veNFT poken, um sein abgenommenes Stimmrecht in bestehenden Zuteilungen zu aktualisieren |

## Abstimmungsstrategien

  
    Stimmen Sie fuer Pools mit dem hoechsten Handelsvolumen im Verhaeltnis zu ihrem aktuellen Stimmgewicht. Pools mit hohem Volumen und weniger Stimmen generieren mehr Gebuehren pro zugeteiltem veHDROME. Pruefen Sie das Gebuehr/Stimm-Verhaeltnis in jeder Epoche, um untergewichtete Pools zu identifizieren.
  
  
    Stimmen Sie fuer Pools mit aktiven externen Bestechungen. Protokolle hinterlegen Bestechungen, um Stimmen anzuziehen, und das Bestechung-pro-Stimme-Verhaeltnis kann die Gebuehreneinnahmen deutlich uebersteigen. Vergleichen Sie den gesamten Bestechungswert mit dem aktuellen Stimmgewicht, um die besten Gelegenheiten zu finden.
  
  
    Wenn Sie die Liquiditaet fuer den Token eines bestimmten Protokolls vertiefen moechten, konzentrieren Sie Stimmen auf dessen Gauge. Dies lenkt mehr HDROME-Emissionen an die LPs dieses Pools, zieht mehr Liquiditaet an und verringert die Spreads fuer den Token.
  

  Stimmen sind fuer die gesamte Epoche gesperrt, sobald sie abgegeben wurden. Sie koennen Ihre Stimme nicht aendern oder zurueckziehen, bis zum naechsten Epochenwechsel. Planen Sie Ihre Zuteilung sorgfaeltig vor der Abstimmung.

---

#### Pools & Liquiditaet

URL: https://docs.hyperdrome.finance/de/tokenomics/pools-liquidity

Hyperdromes duale AMM-Pool-Architektur, Gebuehrenstruktur und Liquiditaetsbereitstellung. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# Pools & Liquiditaet

![${2}](${1})

## Pool-Architektur

Hyperdrome verwendet ein **duales AMM**-Design mit zwei Pool-Typen, die fuer verschiedene Anlageklassen optimiert sind. Die PairFactory deployt Pools deterministisch ueber CREATE2. Jeder Pool hat seinen eigenen Gebuehrensammlungsvertrag (PairFees) und kann einen Gauge fuer HDROME-Emissionen erhalten. Jeder Pool enthaelt ausserdem ein integriertes TWAP-Orakel mit 30-minuetigen Beobachtungszeitraeumen.

### Volatile Pools (vAMM)

| Eigenschaft | Wert |
|-------------|------|
| Kurve | `x * y = k` (Konstantes Produkt) |
| Standard-Gebuehr | 0,2% |
| Namenskonvention | vAMM-TOKEN0/TOKEN1 |
| Ideal fuer | Unkorrelierte Paare (HYPE/USDC, HDROME/HYPE) |

### Stabile Pools (sAMM)

| Eigenschaft | Wert |
|-------------|------|
| Kurve | `x³y + y³x = k` (StableSwap-Variante) |
| Standard-Gebuehr | 0,02% |
| Namenskonvention | sAMM-TOKEN0/TOKEN1 |
| Ideal fuer | Gekoppelte/korrelierte Paare (USDC/USDT, HYPE/stHYPE) |

---

## Gebuehrenstruktur

| Parameter | Detail |
|-----------|--------|
| Volatile-Pool-Gebuehr | 0,2% (anpassbar durch Fee Manager) |
| Stabile-Pool-Gebuehr | 0,02% (anpassbar durch Fee Manager) |
| Gebuehrenempfaenger | 100% an veHDROME-Waehler des Pool-Gauges |
| Gebuehrenerhebung | Pro Swap in den PairFees-Vertrag erhoben |

---

## Swap-Routing

Der Router-Vertrag findet den optimalen Pfad fuer jeden Token-Swap. Er prueft alle verfuegbaren Pools (sowohl volatil als auch stabil) und konstruiert Multi-Hop-Routen, wenn kein direktes Paar existiert oder ein Multi-Hop-Pfad bessere Ausfuehrung bietet. Zum Beispiel koennte ein TOKEN_A-zu-TOKEN_B-Swap ueber TOKEN_A → HYPE → TOKEN_B geroutet werden, wenn dies weniger Slippage ergibt.

---

## Liquiditaet bereitstellen

![${2}](${1})

  
    Waehlen Sie ein volatiles (vAMM) oder stabiles (sAMM) Pool-Paar. Volatile Pools eignen sich fuer unkorrelierte Assets; stabile Pools fuer gekoppelte Paare.
  
  
    Stellen Sie beide Token des Paares im aktuellen Pool-Verhaeltnis bereit. Der Router uebernimmt die Berechnung, um Restbetraege zu minimieren.
  
  
    Sie erhalten LP-Token, die Ihren Anteil am Pool repraesentieren. Diese sammeln automatisch Handelsgebuehren an.
  
  
    Zahlen Sie Ihre LP-Token in den Gauge des Pools ein, um HDROME-Emissionen zu verdienen. Nicht gestakte LPs erhalten keine Emissionen.
  

  Staken Sie Ihre LP-Token immer im Gauge nach der Einzahlung. Nicht gestakte LP-Positionen verdienen Handelsgebuehren, verpassen aber HDROME-Emissionen -- die oft den Grossteil der Rendite ausmachen.

---

## Integriertes Orakel

Jeder Hyperdrome-Pool enthaelt ein **TWAP-Orakel (zeitgewichteter Durchschnittspreis)** mit 30-minuetigen Beobachtungszeitraeumen. Dies liefert manipulationsresistente Preis-Feeds, die von anderen Protokollen auf HyperEVM genutzt werden koennen. Das Orakel speichert kumulative Preisbeobachtungen und kann fuer jedes Zeitfenster bis zur maximalen Beobachtungshistorie abgefragt werden.

---

#### Bestechungen & Belohnungen

URL: https://docs.hyperdrome.finance/de/tokenomics/bribes-rewards

Wie Bestechungen, Handelsgebuehren, Emissionen und Rebases durch das Hyperdrome-Oekosystem fliessen. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# Bestechungen & Belohnungen

![${2}](${1})

## Belohnungsfluss

Das Hyperdrome-Belohnungssystem hat drei verschiedene Stroeme, die an unterschiedliche Teilnehmer fliessen:

1. **LP-Emissionen** -- Der Minter erzeugt HDROME in jeder Epoche. Der Voter-Vertrag verteilt sie an Gauges basierend auf veHDROME-Stimmgewichten. In Gauges gestakte LPs verdienen diese Emissionen auf Sekundenbasis proportional zu ihrem Anteil am Gauge.

2. **Handelsgebuehren + Externe Bestechungen → Waehler** -- 100% der Handelsgebuehren jedes Pools und alle externen Bestechungen, die fuer den Gauge dieses Pools hinterlegt wurden, fliessen an die veHDROME-Halter, die dafuer gestimmt haben. Diese sind nach jedem Epochenwechsel beanspruchbar.

3. **Rebases → veHDROME-Halter** -- Der RewardsDistributor sendet Anti-Verwaesserungs-HDROME-Rebases an alle veHDROME-Halter proportional zu ihrem Stimmrecht und schuetzt Sperrer vor Emissionsverwaesserung.

---

## Belohnungstypen

| Belohnung | Empfaenger | Quelle | Zeitpunkt |
|-----------|-----------|--------|-----------|
| **LP-Emissionen** | In Gauges gestakte LPs | Woechentliche HDROME-Praegung | Pro-Sekunde-Ansammlung |
| **Handelsgebuehren** | veHDROME-Waehler | 100% der Swap-Gebuehren | Beanspruchbar nach Epochenwechsel |
| **Externe Bestechungen** | veHDROME-Waehler | Protokoll-Einzahlungen | Beanspruchbar nach Epochenwechsel |
| **Rebases** | Alle veHDROME-Halter | Minter Anti-Verwaesserung | Verteilt beim Epochenwechsel |

---

## Externe Bestechungen

![${2}](${1})

Externe Bestechungen ermoeglichen es Protokollen, veHDROME-Waehler zu motivieren, Emissionen auf bestimmte Pools zu lenken. Dies ist der primaere Mechanismus, mit dem Protokolle tiefe Liquiditaet auf Hyperdrome erwerben.

  
    Ein Protokoll zahlt Token in den ExternalBribe-Vertrag fuer einen bestimmten Gauge vor dem Epochenwechsel ein.
  
  
    Beim Epochenwechsel wird die Bestechung fuer Waehler sichtbar. veHDROME-Halter beruecksichtigen den Bestechungswert bei ihren Abstimmungsentscheidungen fuer die aktuelle Epoche.
  
  
    Nach Ende der Epoche koennen Waehler, die Stimmen fuer diesen Gauge zugeteilt haben, ihren proportionalen Anteil an der Bestechung basierend auf ihrem Stimmgewicht beanspruchen.
  

### Bestechungseffizienz

* Protokolle erwerben typischerweise 2-5 $ Liquiditaet fuer jeden 1 $ an Bestechungen
* Die Bestechungs-ROI variiert pro Epoche -- niedrigeres Gesamtstimmgewicht bedeutet hoehere Rendite pro Stimme
* Konsistentes Bestechen ueber mehrere Epochen hinweg baut nachhaltige Liquiditaetstiefe auf
* Bis zu 16 verschiedene Belohnungstoken koennen als Bestechungen pro Gauge verwendet werden

---

## Interne Bestechungen (Handelsgebuehren)

Interne Bestechungen werden nicht von externen Parteien hinterlegt -- sie sind die **Handelsgebuehren**, die von jedem Pool generiert werden. 100% der Swap-Gebuehren werden automatisch an den InternalBribe-Vertrag fuer den Gauge dieses Pools geleitet. veHDROME-Waehler, die fuer den Gauge gestimmt haben, beanspruchen diese Gebuehren nach jedem Epochenwechsel. Pools mit hoeherem Volumen generieren mehr interne Bestechungen, was sie zu attraktiven Abstimmungszielen macht.

---

## Rebases

Rebases sind Anti-Verwaesserungs-Belohnungen, die an alle veHDROME-Halter ueber den RewardsDistributor-Vertrag verteilt werden. Wenn in jeder Epoche neues HDROME gepraegt wird, wird ein proportionaler Betrag als Rebases verteilt, um eine Verwaesserung des Stimmrechts zu verhindern. Der Rebase-Betrag skaliert mit dem Verhaeltnis von gesperrtem HDROME zum gesamten umlaufenden Angebot -- mehr Sperrungen bedeuten hoehere Rebases.

---

## Belohnungen beanspruchen

| Belohnungstyp | Wo beanspruchen | Haeufigkeit |
|---------------|----------------|-------------|
| LP-Emissionen | Gauge-Vertrag | Jederzeit (Ansammlung pro Sekunde) |
| Handelsgebuehren | InternalBribe-Vertrag | Nach jedem Epochenwechsel |
| Externe Bestechungen | ExternalBribe-Vertrag | Nach jedem Epochenwechsel |
| Rebases | RewardsDistributor | Nach jedem Epochenwechsel |

  Verwenden Sie den `/claim`-Slash-Befehl im Hyperdrome-Agenten, um alle ausstehenden Belohnungen ueber alle Positionen in einer einzigen Transaktion zu beanspruchen.

---

#### Bereitgestellte Vertraege

URL: https://docs.hyperdrome.finance/de/tokenomics/deployed-contracts

Liste der bereitgestellten Smart Contracts und ihrer Funktionen im Hyperdrome-Oekosystem. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# Bereitgestellte Vertraege

## Netzwerkinformationen

| Parameter | Wert |
|-----------|-------|
| Netzwerk | Hyperliquid EVM |
| Chain ID | `999` |
| RPC URL | `https://rpc.hyperliquid.xyz/evm` |
| Explorer | `https://explorer.hyperliquid.xyz` |
| Nativer Token | HYPE |

## Kernvertraege (HyperEVM Mainnet)

| Vertrag | Adresse |
|----------|---------|
| HDROME Token | `TBD` |
| VotingEscrow (veHDROME) | `TBD` |
| Voter | `TBD` |
| Router | `TBD` |
| PairFactory | `TBD` |
| GaugeFactory | `TBD` |
| BribeFactory | `TBD` |
| Minter | `TBD` |
| RewardsDistributor | `TBD` |
| MerkleClaim | `TBD` |
| VeArtProxy | `TBD` |
| HyperdromeLibrary | `TBD` |

  Vertragsadressen werden hier nach dem Mainnet-Deployment veroeffentlicht. Alle Vertraege werden im Hyperliquid Explorer verifiziert.

## Bekannte Token-Adressen

| Token | Adresse | Dezimalstellen |
|-------|---------|----------|
| WHYPE (Wrapped HYPE) | `0x5555555555555555555555555555555555555555` | 18 |
| USDC | `0xb88339CB7199b77E23DB6E890353E22632Ba630f` | 6 |
| USDT0 | `0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb` | 6 |

## Vertragsarchitektur

| Schicht | Vertraege | Zweck |
|-------|-----------|---------|
| **AMM-Kern** | Pair, PairFees, PairFactory, Router | Token-Swaps, Liquiditaet, Gebuehreneinzug |
| **Token & Sperrung** | Hyperdrome, VotingEscrow, VeArtProxy | HDROME-Token, veNFT-Erstellung und -Verwaltung |
| **Abstimmung & Gauges** | Voter, Gauge, InternalBribe, ExternalBribe | Emissionsabstimmung, LP-Staking, Bestechungsverteilung |
| **Emissionen** | Minter, RewardsDistributor | Woechentliche Praegung, Rebase-Verteilung |
| **Fabriken** | PairFactory, GaugeFactory, BribeFactory | Deterministische Vertragsbereitstellung |
| **Governance** | L2Governor, HyperdromeGovernor (Multisig) | On-Chain-Vorschlaege, zeitgesperrte Ausfuehrung |
| **Airdrop** | MerkleClaim | Merkle-Tree-Airdrop (4-Jahres-veHDROME-Sperren) |

  Ueberpruefen Sie Vertragsadressen immer vor der Interaktion. Verwenden Sie nur Adressen, die in dieser offiziellen Dokumentation oder der Hyperdrome-App aufgefuehrt sind.

---

#### Sicherheit

URL: https://docs.hyperdrome.finance/de/tokenomics/security

Hyperdromes Sicherheitsmaßnahmen und Audit-Historie. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# Sicherheit

![${2}](${1})

## Codebase-Herkunft

Hyperdrome basiert auf der **Velodrome/Solidly**-Codebase, einer der kampferprobtesten ve(3,3)-Implementierungen im DeFi-Bereich:

* **Solidly** — Originales ve(3,3)-AMM von Andre Cronje auf Fantom
* **Velodrome** — Verfeinerter Fork auf Optimism, die größte DEX nach TVL auf OP

## Audits

| Audit | Umfang | Bericht |
|-------|--------|---------|
| Solidly Audit | Kern-AMM, VotingEscrow, Minter | Im Repository verfügbar |
| Velodrome Audits | Vollständige Protokoll-Überprüfung | Im Repository verfügbar |

## Smart-Contract-Sicherheit

### Zugangskontrolle

| Rolle | Berechtigungen |
|-------|---------------|
| **Governor** | Token whitelisten, Gauges erstellen, Protokollparameter |
| **Emergency Council** | Gauges im Notfall deaktivieren/reaktivieren |
| **Fee Manager** | Handelsgebühren pro Pool anpassen |
| **Pauser** | Alle Swaps im Notfall pausieren |

### Timelock

Der **HyperdromeGovernor**-Multisig beinhaltet funktionsspezifische Timelocks:

* Individuelle Verzögerung pro Funktions-Selektor / Ziel-Kombination
* Unterstützung für Batch-Transaktionsausführung
* Basiert auf dem ZeroExGovernor-Muster von 0x

### Wichtige Sicherheitseigenschaften

* **Unveränderliche Minter-Zuweisung** — `setMinter()` kann nur einmal auf dem HDROME-Token aufgerufen werden
* **CREATE2-deterministisches Deployment** — Paar-Adressen sind vorhersagbar und verifizierbar
* **veNFT-Anbindungssystem** — Verhindert die Übertragung von veNFTs während des Stakings in Gauges
* **Epochen-gesperrte Stimmen** — Stimmen können während einer Epoche nicht geändert werden, um Manipulation zu verhindern
* **TWAP-Orakel** — 30-minütige Beobachtungszeiträume widerstehen Preismanipulation

## Solidity-Version

Alle Contracts kompiliert mit **Solidity 0.8.13** mit Standard-Overflow/Underflow-Schutzmaßnahmen.

## Test-Suite

Das Protokoll umfasst **21 Foundry-Testdateien**, die Folgendes abdecken:

* AMM-Paar-Mechaniken und Gebühren-Buchhaltung
* veNFT-Sperr-/Entsperr-/Zusammenführungsoperationen
* Emissionsberechnungen und Rückgangsverläufe
* Gauge-Staking und Belohnungsverteilung
* Abstimmungsmechaniken und Epochen-Übergänge
* Notfall-Gauge-Deaktivierung/-Reaktivierung
* Merkle-Claim-Airdrop-Verteilung
* On-Chain-Governance-Vorschläge
* Anti-Wash-Trade-Schutz
* Orakel-Genauigkeit und Grenzfälle

---

### Agentic

#### Agentischer Ueberblick

URL: https://docs.hyperdrome.finance/de/agentic/overview

Der Hyperdrome-Agent -- eine KI-native Schnittstelle fuer die ve(3,3) DEX auf Hyperliquid. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# Der Hyperdrome-Agent

![${2}](${1})

## Keine DEX mit KI -- Es ist ein KI-Agent mit einer DEX

Hyperdrome ist KI-zuerst gebaut. Der Agent ist kein Chatbot, der an eine Handelsoberflaeche angeschraubt wurde -- er **ist** die Schnittstelle. Jede DeFi-Aktion (Tauschen, LP, Sperren, Abstimmen, Beanspruchen) ist ueber natuerlichsprachliche Konversation oder Slash-Befehle zugaenglich. Die traditionelle UI existiert als Fallback, aber der Agent ist die primaere Art, wie Nutzer mit dem Protokoll interagieren.

---

## Architektur

Der Hyperdrome-Agent verwendet eine LLM-Routing-Schicht, um Nutzerabsichten zu interpretieren und auf On-Chain-Aktionen abzubilden. Wenn ein Nutzer eine Nachricht sendet, macht der Agent Folgendes:

1. **Absicht erkennen** -- Das LLM analysiert die Nachricht, um festzustellen, was der Nutzer tun moechte (tauschen, LP, abstimmen, Portfolio pruefen usw.)
2. **Kontext sammeln** -- Liest On-Chain-Zustand (Wallet-Guthaben, Pool-Daten, veNFT-Positionen, ausstehende Belohnungen) und Off-Chain-Daten (Preise, TVL, APRs)
3. **Antwort generieren** -- Erzeugt eine natuerlichsprachliche Erklaerung mit Rich-UI-Karten, die die vorgeschlagene Aktion, Parameter und erwartete Ergebnisse zeigen
4. **Bei Bestaetigung ausfuehren** -- Wenn der Nutzer bestaetigt, konstruiert und sendet der Agent die Transaktion(en)

Der Agent unterstuetzt mehrere LLM-Backends (Claude, GPT-4, Gemini) ohne Kosten fuer den Nutzer.

---

## Chat-zu-DeFi

Nutzer interagieren mit dem gesamten Protokoll ueber konversationelle Eingaben:

* *"Tausche 100 USDC in HYPE"*
* *"Was sind meine ausstehenden Belohnungen?"*
* *"Sperre 1000 HDROME fuer 4 Jahre"*
* *"Stimme mit all meinem veHDROME fuer den HYPE/USDC-Pool"*
* *"Was ist die beste Rendite gerade?"*

Der Agent uebernimmt Routing, Slippage, Gas-Schaetzung und Transaktionskonstruktion im Hintergrund.

---

## Slash-Befehle

| Befehl | Aktion |
|--------|--------|
| `/swap` | Token mit optimiertem Routing tauschen |
| `/lp` | Liquiditaet zu einem Pool hinzufuegen oder entfernen |
| `/vote` | veHDROME-Stimmen auf Gauges verteilen |
| `/lock` | HDROME sperren, um ein veNFT zu erstellen oder zu verlaengern |
| `/claim` | Alle ausstehenden Belohnungen beanspruchen (Emissionen, Gebuehren, Bestechungen) |
| `/help` | Verfuegbare Befehle und Nutzung anzeigen |

---

## Rich-UI-Karten

Der Agent rendert interaktive Karten fuer jede Aktion -- nicht nur Textantworten. Karten zeigen:

* **Swap-Karten** -- Token-Paar, Betrag, Preisauswirkung, Routenpfad, Slippage-Toleranz
* **LP-Karten** -- Pool-Paar, TVL, APR, Ihr Anteil, Einzahlungsbetraege
* **Abstimmungskarten** -- Gauge-Liste, aktuelle Stimmgewichte, prognostizierte Gebuehren-/Bestechungseinnahmen
* **Portfolio-Karten** -- Token-Guthaben, LP-Positionen, veNFT-Details, ausstehende Belohnungen
* **Belohnungskarten** -- Aufschluesselung der beanspruchbaren Emissionen, Gebuehren und Bestechungen mit USD-Werten

---

## Ausfuehrbare Aktionen

| Kategorie | Aktionen |
|-----------|----------|
| **Handel** | Token tauschen, Multi-Hop-Routing, Slippage einstellen |
| **Liquiditaet** | Liquiditaet hinzufuegen, Liquiditaet entfernen, in Gauge staken, aus Gauge unstaken |
| **Sperren** | veNFT erstellen, Sperrbetrag erhoehen, Sperrdauer verlaengern, veNFTs zusammenfuehren |
| **Abstimmung** | Fuer Gauges abstimmen, Stimmen zuruecksetzen, veraltete Stimmen poken |
| **Belohnungen** | Emissionen beanspruchen, Gebuehren beanspruchen, Bestechungen beanspruchen, Rebases beanspruchen |
| **Portfolio** | Guthaben anzeigen, Positionen anzeigen, ausstehende Belohnungen anzeigen, Renditeempfehlungen erhalten |

---

## Intelligente Vorschlaege

Der Agent zeigt proaktiv Optimierungsmoeglichkeiten basierend auf dem Wallet-Zustand:

| Prioritaet | Ausloeser | Vorschlag |
|-----------|-----------|-----------|
| **Hoch** | Nicht gestakte LP-Token erkannt | In Gauge staken, um Emissionen zu verdienen |
| **Hoch** | Nicht beanspruchte Belohnungen > $10 | Ausstehende Belohnungen beanspruchen und reinvestieren |
| **Hoch** | veNFT laeuft innerhalb von 7 Tagen ab | Sperre verlaengern, um Stimmrecht zu erhalten |
| **Mittel** | Ungenutzte Token > $10 nicht in LP/Sperre | Liquiditaet bereitstellen oder fuer veHDROME sperren |
| **Mittel** | Suboptimale Stimmverteilung | Stimmen auf ertragreichere Gauges umverteilen |
| **Niedrig** | Neuer Pool mit hohem APR verfuegbar | LPing in trendigen Pools in Betracht ziehen |

---

## LLM-agnostische Architektur

Der Hyperdrome-Agent ist **nicht an einen einzelnen KI-Anbieter gebunden**. Die Architektur trennt Absichtserkennung, Kontextsammlung und Ausfuehrung in unabhaengige Schichten — so kann das LLM-Backend ausgetauscht werden, ohne etwas anderes zu aendern.

| Schicht | Rolle | LLM erforderlich? |
|-------|------|---------------|
| **Intent Parser** | Verstehen, was der Nutzer will | Ja — beliebiges LLM |
| **Context Gatherer** | On-Chain- + Off-Chain-Daten lesen | Nein |
| **Responder** | Erklaerung + UI-Karten generieren | Ja — beliebiges LLM |
| **Executor** | Transaktionen bauen und senden | Nein |

Aktuell werden **Claude**, **GPT-4** und **Gemini** mit intelligentem Routing unterstuetzt. Open-Source-Modelle (Llama, Mistral, Qwen) und Bring Your Own LLM stehen auf der Roadmap.

  ### LLM-Integrationen
    Multi-Modell-Unterstuetzung, Routing und Bring Your Own LLM
  

  ### MCP-Server
    Jeden KI-Assistenten ueber MCP mit Hyperdrome verbinden
  

  ### Agent-Frameworks
    GOAT SDK, Wayfinder, Eliza, Olas, REST API
  

---

## Mehrsprachige Unterstuetzung

Der Agent antwortet in der Sprache des Nutzers. Eingaben auf Deutsch, Englisch, Chinesisch, Japanisch, Koreanisch, Spanisch, Franzoesisch, Portugiesisch, Tuerkisch, Russisch, Arabisch und anderen Sprachen werden nativ ueber die zugrunde liegenden LLM-Faehigkeiten unterstuetzt. Die UI-Labels und Slash-Befehle bleiben auf Englisch, aber alle konversationellen Antworten passen sich der Sprache des Nutzers an.

---

#### LLM-Integrationen

URL: https://docs.hyperdrome.finance/de/agentic/llm-integrations

Wie Hyperdrome sich mit jedem LLM verbindet — Claude, GPT-4, Gemini, Llama, Mistral und mehr. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# LLM-Integrationen

![${2}](${1})

## LLM-agnostisch von Grund auf

Hyperdrome ist nicht an einen einzelnen KI-Anbieter gebunden. Die Agent-Architektur trennt **Absichtserkennung**, **Kontextsammlung** und **Ausfuehrung** in unabhaengige Schichten — so kann das LLM-Backend ausgetauscht werden, ohne etwas anderes zu aendern.

Das bedeutet, Hyperdrome funktioniert mit jedem grossen Sprachmodell heute und wird mit jedem Modell funktionieren, das morgen veroeffentlicht wird.

---

## Unterstuetzte Modelle

  ### Claude
    Opus, Sonnet, Haiku — **Live**
  

  ### GPT-4
    GPT-4o, GPT-4, GPT-4 Turbo — **Live**
  

  ### Gemini
    Gemini 2.5 Pro, 2.5 Flash — **Live**
  

  ### Open Source
    Llama, Mistral, Qwen, DeepSeek — *Geplant*
  

  Alle Modelle sind fuer Nutzer **kostenlos** verfuegbar. Hyperdrome uebernimmt die Inferenzkosten.

---

## Architektur

Die Agent-Pipeline ist in jeder Phase modell-agnostisch:

```
User Input (natural language or /command)
        │
        ▼
┌──────────────────┐
│  Intent Parser   │ ← Any LLM (Claude, GPT-4, Gemini, Llama...)
│  "What does the  │
│   user want?"    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Context Gatherer │ ← On-chain + off-chain data (no LLM needed)
│  Wallet, pools,  │
│  prices, APRs    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Responder     │ ← Any LLM (generates explanation + UI cards)
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Executor      │ ← Transaction builder (no LLM needed)
│  Build tx, sign, │
│  submit on-chain │
└──────────────────┘
```

Das LLM ist nur an zwei Schritten beteiligt: Verstehen, was der Nutzer will, und Erklaerung des Ergebnisses. Alles andere — Blockchain-Zustand lesen, Transaktionen bauen, On-Chain einreichen — ist deterministischer Code.

---

## Intelligentes Routing

Das Backend waehlt automatisch das beste Modell fuer jede Anfrage basierend auf:

| Faktor | Logik |
|--------|-------|
| **Komplexitaet** | Einfache Abfragen (Preisueberpruefungen, Guthaben) → schnellstes Modell. Komplexe Mehrstufenaktionen → leistungsfaehigstes Modell. |
| **Sprache** | Einige Modelle performen besser in bestimmten Sprachen. Der Router optimiert fuer die erkannte Sprache des Nutzers. |
| **Latenz** | Wenn das primaere Modell langsam oder nicht verfuegbar ist, faellt der Router in < 500ms auf die naechstbeste Option zurueck. |
| **Kosten** | Der Router balanciert Leistung vs. Kosten, um Inferenz fuer alle Nutzer kostenlos zu halten. |

---

## Bring Your Own LLM *(Bald verfuegbar)*

  Diese Funktion steht auf der Roadmap und ist noch nicht verfuegbar.

Nutzer werden in der Lage sein, ihren eigenen LLM-Anbieter zu verbinden:

* **API Key** — Eigenen OpenAI-, Anthropic-, Google- oder einen beliebigen OpenAI-kompatiblen API-Schluessel einbinden
* **Selbst gehostete Modelle** — Den Agenten auf den eigenen Ollama-, vLLM- oder TGI-Endpunkt richten, der Llama, Mistral, Qwen oder ein anderes Open-Source-Modell ausfuehrt
* **Benutzerdefinierte System-Prompts** — Persoenlichkeit, Risikotoleranz und Antwortstil des Agenten anpassen
* **Volle Privatsphaere** — Bei Verwendung des eigenen Modells werden keine Daten ueber die Inferenz-Server von Hyperdrome geleitet

### Kompatible Endpunkte

Jeder Endpunkt, der das OpenAI Chat Completions API-Format implementiert, funktioniert:

| Runtime | Example Models |
|---------|---------------|
| **Ollama** | Llama 3.3, Mistral, Qwen 2.5, DeepSeek V3, Gemma |
| **vLLM** | Any HuggingFace model |
| **TGI** | Any HuggingFace model |
| **Together AI** | Llama, Mixtral, Qwen |
| **Groq** | Llama, Mixtral, Gemma |
| **Fireworks** | Llama, Mixtral, DeepSeek |

---

## Warum LLM-agnostisch wichtig ist

1. **Kein Vendor-Lock-in** — Wenn ein Anbieter Preise erhoeht, Qualitaet verschlechtert oder Einschraenkungen hinzufuegt, wechselt Hyperdrome nahtlos.

2. **Bestes Modell fuer den Job** — Verschiedene Modelle glaenzen bei verschiedenen Aufgaben. Routing laesst Hyperdrome das beste Werkzeug fuer jede Anfrage nutzen.

3. **Zukunftssicher** — Neue Modelle werden monatlich veroeffentlicht. LLM-agnostische Architektur bedeutet, dass Hyperdrome sie sofort ohne Umschreibungen uebernimmt.

4. **Nutzersouveraenitaet** — Mit Bring Your Own LLM kontrollieren Nutzer ihre Daten und Inferenz. Keine Abhaengigkeit von zentralisierten KI-Anbietern.

5. **Zensurresistenz** — Open-Source-Modelle koennen nicht abgeschaltet oder eingeschraenkt werden. Nutzer, die ihre eigene Llama- oder Mistral-Instanz betreiben, haben volle Autonomie.

---

#### MCP-Server

URL: https://docs.hyperdrome.finance/de/agentic/mcp-server

Der Model Context Protocol-Server von Hyperdrome — verbindet jeden KI-Assistenten mit der ve(3,3) DEX. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# MCP-Server

![${2}](${1})

  Der Hyperdrome MCP-Server steht auf der Roadmap und ist noch nicht live. Diese Seite dokumentiert die geplante Spezifikation.

## Was ist MCP?

**Model Context Protocol (MCP)** ist ein offener Standard von Anthropic, der KI-Assistenten ermoeglicht, Tools auf externen Servern zu entdecken und aufzurufen. Es verwendet JSON-RPC 2.0 — der Assistent ruft `tools/list` auf, um verfuegbare Aktionen zu entdecken, dann `tools/call`, um sie auszufuehren.

MCP wird von **Claude Desktop**, **Cursor**, **Opencode**, **Windsurf** und einer wachsenden Zahl von KI-Coding- und Chat-Tools unterstuetzt.

---

## Warum MCP fuer DeFi?

Heute erfordert die Interaktion mit DeFi:
1. Browser oeffnen
2. Wallet verbinden
3. Komplexe UI navigieren
4. Slippage, Routing, Gas verstehen

Mit dem MCP-Server von Hyperdrome kann jeder KI-Assistent **direkt** Token tauschen, Renditen pruefen, ueber Gauges abstimmen und Positionen verwalten — ohne dass der Nutzer jemals sein bevorzugtes Tool verlassen muss.

> *"Tausche 500 USDC in HYPE auf Hyperdrome"* — eingegeben in Claude Desktop, Cursor oder einen beliebigen MCP-Client.

---

## Verfuegbare Tools

Der MCP-Server stellt das gesamte Hyperdrome-Protokoll als aufrufbare Tools bereit:

### Trading

| Tool | Description | Parameters |
|------|-------------|------------|
| `swap` | Swap tokens with optimized multi-hop routing | `fromToken`, `toToken`, `amount`, `slippageBps?` |
| `get_quote` | Get a swap quote without executing | `fromToken`, `toToken`, `amount` |

### Liquidity

| Tool | Description | Parameters |
|------|-------------|------------|
| `add_liquidity` | Deposit token pair into a pool | `tokenA`, `tokenB`, `amountA`, `amountB`, `stable` |
| `remove_liquidity` | Withdraw from a pool | `tokenA`, `tokenB`, `stable`, `liquidity` |
| `stake_lp` | Stake LP tokens in a gauge | `pool`, `amount` |
| `unstake_lp` | Unstake LP tokens from a gauge | `pool`, `amount` |

### Locking & Voting

| Tool | Description | Parameters |
|------|-------------|------------|
| `lock` | Lock HDROME to create or extend a veNFT | `amount`, `duration` |
| `vote` | Allocate veHDROME votes across gauges | `tokenId`, `pools[]`, `weights[]` |
| `reset_votes` | Reset votes for a veNFT | `tokenId` |

### Rewards

| Tool | Description | Parameters |
|------|-------------|------------|
| `claim_rewards` | Claim all pending rewards | `tokenId?` |
| `claim_fees` | Claim trading fees for a specific gauge | `gauge` |
| `claim_bribes` | Claim external bribes | `gauge`, `tokens[]` |

### Read-Only

| Tool | Description | Parameters |
|------|-------------|------------|
| `get_pools` | List all pools with TVL, APR, volume | `sortBy?`, `limit?` |
| `get_portfolio` | Full wallet analysis | `address` |
| `get_yields` | Top yield opportunities | `limit?`, `minTvl?` |
| `get_venft` | Get veNFT details | `tokenId` |
| `get_pending_rewards` | Check unclaimed rewards | `address` |

---

## Tool-Schema-Beispiel

Jedes Tool folgt der MCP-Spezifikation mit einem JSON Schema fuer Eingaben:

```json
{
  "name": "swap",
  "description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromToken": {
        "type": "string",
        "description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
      },
      "toToken": {
        "type": "string",
        "description": "Token symbol or address to buy (e.g. 'HYPE')"
      },
      "amount": {
        "type": "string",
        "description": "Amount to swap in human-readable units (e.g. '100')"
      },
      "slippageBps": {
        "type": "number",
        "description": "Max slippage in basis points (default: 50 = 0.5%)"
      }
    },
    "required": ["fromToken", "toToken", "amount"]
  }
}
```

---

## Verbindung

### Claude Desktop / Cursor / Opencode

Zur MCP-Konfiguration hinzufuegen:

```json
{
  "mcpServers": {
    "hyperdrome": {
      "url": "https://mcp.hyperdrome.finance/sse"
    }
  }
}
```

### Selbst gehostet

Der MCP-Server wird Open-Source sein. Eigene Instanz betreiben:

```bash
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
```

---

## Sicherheitsmodell

| Eigenschaft | Detail |
|----------|--------|
| **Standardmaessig schreibgeschuetzt** | Portfolio-Abfragen und Pool-Daten benoetigen keine Wallet-Verbindung |
| **Transaktionsgenehmigung** | Alle Schreiboperationen geben unsignierte Transaktionen zur Ueberpruefung und Signierung durch den Nutzer zurueck |
| **Keine Private Keys** | Der gehostete MCP-Server beruehrt niemals Private Keys. Die Signierung erfolgt clientseitig. |
| **Rate Limiting** | Rate Limits pro IP und pro API-Key zur Missbrauchspraevention |
| **Audit Trail** | Jeder Tool-Aufruf wird mit Zeitstempel, Parametern und Ergebnis protokolliert |

  Der MCP-Server fuehrt niemals Transaktionen in Ihrem Namen aus. Er baut die Transaktion und gibt sie zur Ihrer ausdruecklichen Genehmigung zurueck — genau wie jedes DeFi-Frontend.

---

## Anwendungsfaelle

| Szenario | Wie |
|----------|-----|
| **Entwickler baut ein DeFi-Dashboard** | Pools, Renditen und Positionen ueber MCP-Tools abfragen |
| **KI-Coding-Assistent** | "Hilf mir ein Skript zu schreiben, das alle meine Hyperdrome-Belohnungen einfordert" — der Assistent ruft `get_pending_rewards` dann `claim_rewards` auf |
| **Autonomer Agent** | Ein Portfolio-Management-Agent prueft stuendlich Renditen und rebalanciert ueber `add_liquidity` / `remove_liquidity` |
| **Chat-Bot** | Ein Telegram-Bot, der Nutzern ermoeglicht, ueber natuerliche Sprache zu tauschen, Portfolios zu pruefen und abzustimmen |
| **Research** | Ein Analyst fragt `get_pools` ab, um einen Renditevergleich ueber HyperEVM-DEXes zu erstellen |

---

#### Agent-Framework-Integrationen

URL: https://docs.hyperdrome.finance/de/agentic/agent-frameworks

Wie Hyperdrome sich mit GOAT SDK, Wayfinder, Eliza, Olas und dem breiteren KI-Agent-Oekosystem integriert. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# Agent-Framework-Integrationen

![${2}](${1})

Hyperdrome ist so konzipiert, dass es von **jedem KI-Agenten** aus zugaenglich ist, nicht nur von unserem eigenen. Das Protokoll stellt seine Funktionalitaet ueber mehrere Integrationsschichten bereit, sodass Drittanbieter-Agenten, Frameworks und Plattformen nativ mit Hyperdrome interagieren koennen.

  ### GOAT SDK
    200+ Tools, 13+ Framework-Adapter
  
  ### MCP
    Claude Desktop, Cursor, Opencode
  
  ### Wayfinder
    KI-natives DeFi-Terminal
  
  ### Eliza
    Autonome Social- + DeFi-Agenten
  
  ### Olas
    Dezentrale autonome Agenten
  
  ### REST API
    Direkte HTTP-Endpunkte
  

---

## Integrationsarchitektur

```
┌─────────────────────────────────────────────────┐
│              AI Agent Frameworks                 │
│  Claude · GPT · Gemini · Llama · Mistral · ...  │
├─────────────────────────────────────────────────┤
│              Adapter Layer                       │
│  GOAT SDK · Wayfinder · Eliza · LangChain ·     │
│  Vercel AI · MCP · REST API                     │
├─────────────────────────────────────────────────┤
│           Hyperdrome Protocol Layer              │
│  Intent Parser → Context → Tx Builder → Chain   │
├─────────────────────────────────────────────────┤
│                 HyperEVM                         │
│  Router · Voter · Gauges · VotingEscrow · ...   │
└─────────────────────────────────────────────────┘
```

Jedes Framework, das eine der Adapter-Schichten unterstuetzt, kann mit Hyperdrome interagieren. Kein benutzerdefinierter Integrationscode noetig.

---

## GOAT SDK Plugin

  Das GOAT SDK Plugin steht auf der Roadmap und ist noch nicht veroeffentlicht.

**GOAT SDK** ist das groesste agentische Finanz-Toolkit — 200+ Tools, 15+ Chains, 13+ Framework-Adapter. Protokolle wie Uniswap, Aave, 1inch und Balancer haben bereits GOAT-Plugins.

Hyperdrome wird `@goat-sdk/plugin-hyperdrome` mit vollstaendiger Protokollabdeckung veroeffentlichen:

### Bereitgestellte Aktionen

| Action | Description |
|--------|-------------|
| `swap` | Swap tokens with optimized routing |
| `addLiquidity` | Deposit into volatile or stable pools |
| `removeLiquidity` | Withdraw from pools |
| `stakeLp` | Stake LP tokens in gauges |
| `unstakeLp` | Unstake from gauges |
| `lock` | Lock HDROME → veHDROME (create/extend veNFT) |
| `vote` | Allocate votes across gauges |
| `claimRewards` | Claim emissions, fees, bribes, rebases |
| `getPools` | List pools with TVL, APR, volume |
| `getPortfolio` | Full wallet analysis |

### Framework-Reichweite

Sobald das GOAT-Plugin veroeffentlicht ist, ist Hyperdrome automatisch in folgenden Frameworks verfuegbar:

| Framework | Type |
|-----------|------|
| **Vercel AI SDK** | Full-stack AI apps |
| **LangChain** | Agent orchestration (Python & JS) |
| **LlamaIndex** | Data-augmented agents |
| **MCP** | Claude Desktop, Cursor, Opencode |
| **Eliza** | Autonomous social + DeFi agents |
| **CrewAI** | Multi-agent systems |
| **Mastra** | TypeScript agent framework |
| **GAME (Virtuals)** | Gaming + DeFi agents |
| **OpenAI Agents SDK** | OpenAI's native agent runtime |
| **ZerePy** | Python agent framework |
| **AutoGen** | Microsoft's multi-agent framework |
| **Olas** | Decentralized autonomous agents |

---

## Wayfinder Paths

  Die Wayfinder-Integration steht auf der Roadmap und ist noch nicht verfuegbar.

**Wayfinder** ist ein KI-natives DeFi-Terminal mit eigenem SDK (Paths). Es unterstuetzt bereits Hyperliquid Perps, Aave V3, Morpho, Pendle und Uniswap V3.

Hyperdrome wird einen **Wayfinder-Protokolladapter** veroeffentlichen, der Folgendes ermoeglicht:

* Swap, LP, Abstimmung und Lock ueber Wayfinder Shells (KI-Handelsoberflaeche)
* Strategie-Komposition — Hyperdrome-Rendite mit protokolluebergreifenden Strategien kombinieren
* MCP-Bruecke — Wayfinders eingebauter MCP-Server wird Hyperdrome-Tools bereitstellen

---

## Eliza (ElizaOS)

**Eliza** ist das fuehrende Open-Source-Framework fuer autonome Krypto-Agenten. Es betreibt Social- und DeFi-Bots, die auf Twitter, Telegram und On-Chain operieren.

Hyperdrome-Integration ueber das GOAT-Plugin (`@elizaos/plugin-goat`):

* Eliza-Agenten koennen auf Hyperdrome tauschen, LP bereitstellen, abstimmen und beanspruchen
* Autonomes Yield Farming — Agenten, die APRs ueberwachen und Positionen rebalancieren
* Social + DeFi — Agenten, die Rendite-Updates posten, Community-Fragen beantworten und Trades ausfuehren

---

## Olas (Autonolas)

**Olas** ist eine dezentrale Plattform zum gemeinsamen Besitz und Betrieb autonomer KI-Agenten. 3.600+ Agenten deployed, 17M+ Transaktionen.

Integrationspfad fuer Hyperdrome:

* Einen **Olas Agent Service** bauen, der Hyperdrome-Positionen verwaltet
* Als **Mech** im Olas-Marktplatz registrieren — andere Agenten koennen Hyperdrome-Aktionen beauftragen
* Mit bestehenden Olas-Agenten fuer protokolluebergreifende Strategien kombinieren

---

## REST API

  Die oeffentliche REST API steht auf der Roadmap und ist noch nicht verfuegbar.

Fuer Entwickler, die eine direkte Integration ohne Framework wuenschen:

### Geplante Endpunkte

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/api/pools` | List all pools with TVL, APR, fees, volume |
| `GET` | `/api/pools/:address` | Pool details |
| `GET` | `/api/portfolio/:wallet` | Full portfolio analysis |
| `GET` | `/api/yields` | Top yield opportunities |
| `POST` | `/api/quote` | Get a swap quote |
| `POST` | `/api/swap` | Build a swap transaction |
| `POST` | `/api/liquidity/add` | Build an add-liquidity transaction |
| `POST` | `/api/liquidity/remove` | Build a remove-liquidity transaction |
| `POST` | `/api/lock` | Build a lock transaction |
| `POST` | `/api/vote` | Build a vote transaction |
| `POST` | `/api/claim` | Build a claim-all transaction |

### Antwortformat

Alle Schreib-Endpunkte geben unsignierte Transaktionsdaten zurueck:

```json
{
  "tx": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "chainId": 999,
    "gasLimit": "250000"
  },
  "summary": {
    "action": "Swap 100 USDC → 1.62 HYPE",
    "priceImpact": "0.03%",
    "route": ["USDC", "HYPE"],
    "minReceived": "1.611 HYPE"
  }
}
```

  Die API benoetigt niemals Private Keys. Alle Transaktionen werden unsigniert fuer die clientseitige Signierung zurueckgegeben.

---

## LangChain Tool

Fuer Python-Entwickler, die LangChain direkt verwenden:

```python
from langchain.tools import tool

@tool
def hyperdrome_swap(from_token: str, to_token: str, amount: str) -> str:
    """Swap tokens on Hyperdrome (HyperEVM). Returns unsigned transaction."""
    # Calls Hyperdrome REST API
    ...
```

Der GOAT SDK-Adapter erledigt dies automatisch, aber Entwickler koennen auch benutzerdefinierte LangChain-Tools gegen die REST API bauen.

---

## Eigene Integration bauen

Moechten Sie Hyperdrome in Ihren Agenten, Bot oder Ihre App integrieren?

1. **Schnellster Weg** — GOAT SDK Plugin verwenden. Funktioniert mit 13+ Frameworks sofort einsatzbereit.
2. **Flexibelster Weg** — REST API direkt nutzen. Transaktionen in jeder Sprache bauen und signieren.
3. **KI-nativ** — Ueber MCP verbinden. Funktioniert mit Claude Desktop, Cursor, Opencode und jedem MCP-Client.
4. **Autonom** — Einen Olas Agent Service bauen fuer vollstaendig dezentrale, On-Chain-Agent-Ausfuehrung.

Alle Integrationsschichten geben unsignierte Transaktionen zurueck — Ihre App uebernimmt die Signierung und das Einreichen. Hyperdrome beruehrt niemals Private Keys.

---

#### Agentenfaehigkeiten & Roadmap

URL: https://docs.hyperdrome.finance/de/agentic/capabilities

Vollstaendige Faehigkeiten, Datenquellen und kommende Funktionen des Hyperdrome-Agenten. Mit Werten, Ablaeufen und HyperEVM-Referenzen.

# Agentenfaehigkeiten & Roadmap

## Live-Datenquellen

| Quelle | Daten | Aktualisierung |
|--------|------|--------|
| **HyperEVM RPC** | Wallet-Salden, LP-Positionen, veNFT-Details, Gauge-Stakes, ausstehende Belohnungen | Echtzeit |
| **CoinGecko** | HYPE, USDC, USDT, BTC, ETH, SOL Preise + 24h-Aenderung + Marktkapitalisierung + Volumen | 60s Cache |
| **DeFiLlama** | Hyperliquid-L1-Chain-TVL, Top-20-Protokolle mit TVL/Kategorie/7-Tage-Aenderung | 60s Cache |
| **Hyperliquid API** | Alle Spot-Token mit Mark-Preisen, 24h-Volumen, umlaufender Versorgung | 60s Cache |
| **Protokoll-Vertraege** | Pool-Reserven, TVL, APRs, Stimmgewichte, Bestechungsbetraege, Emissionsraten | Echtzeit |

## Wallet-Analyse

Der Agent fuehrt eine tiefgehende Portfolio-Analyse durch, wenn Ihre Wallet verbunden ist:

* **Token-Salden** mit USD-Werten (nach Wert sortiert)
* **Erkennung ungenutzten Kapitals** -- Token > $10, die nicht in LP/Sperren sind
* **LP-Positionen** -- Paar, stabil/volatil, gestakt/nicht gestakt, TVL, APR, Gauge-Adresse
* **Erkennung nicht gestakter LPs** -- LPs, die keine Emissionen verdienen
* **veNFTs** -- Sperrbetrag, Ablauf, verbleibende Tage, Abgelaufen/Ablaufend-Markierungen, Stimmrecht, Abstimmungsstatus
* **Ausstehende Belohnungen** -- Emissionen, Bestechungen, Gebuehren -- aufgeschluesselt pro Paar mit USD-Gesamtsummen
* **Top-10-Pools nach APR** fuer Empfehlungen

## Roadmap

| Funktion | Status |
|----------|--------|
| Chat-to-DeFi (Web) | **Ausgeliefert** |
| Slash-Befehle | **Ausgeliefert** |
| Rich-UI-Karten | **Ausgeliefert** |
| Intelligente Vorschlaege | **Ausgeliefert** |
| Multi-LLM Backend (Claude, GPT-4, Gemini) | **Ausgeliefert** |
| Telegram Super-Agent | **In Arbeit** |
| MCP Server | Geplant |
| GOAT SDK Plugin | Geplant |
| Public REST API | Geplant |
| Wayfinder Integration | Geplant |
| Bring Your Own LLM | Geplant |
| Autopilot | Geplant |
| Content Machine | Geplant |
| Dynamische veNFT-PFPs | Geplant |
| Bestechungs-Optimierer | Geplant |
| Renditeberichte | Geplant |
| KI-Treasury | Geplant |

### Autopilot *(Bald verfuegbar)*

"Einzahlen & Entspannen" -- der Agent verwaltet Ihre gesamte DeFi-Position automatisch.

| Risikoprofil | Ziel-APY | Strategie |
|-------------|-----------|----------|
| **Konservativ** | 8-15% | Stabile Pools, maximale Sperre, Blue-Chip-Paare |
| **Ausgewogen** | 15-30% | Gemischte stabile/volatile Pools, mittlere Sperren |
| **Aggressiv** | 30-80% | Volatile Pools, Bestechungs-Farming, aktives Rebalancing |
| **Degen** | 50-200% | Neue Pools, maximale Bestechungsabschoepfung, kurze Sperren |

Der Agent uebernimmt: LP-Positionsmanagement, Gauge-Staking, veHDROME-Abstimmung, Belohnungseinzug, Reinvestition mit Zinseszins und Rebalancing -- alles rund um die Uhr ohne Nutzereingriff.

**Erloesmodell**: 5% Performance-Gebuehr auf Autopilot-Rendite.

### Telegram Super-Agent *(Bald verfuegbar)*

Ein einzelner Bot fuer das gesamte Hyperdrome-Erlebnis:
* Tausch, Rendite, Portfolio, Einfordern, Autopilot
* Bildung, Benachrichtigungen, Meme-Generierung
* PFP-Generierung, Bestechungsanalyse, Renditeberichte

### Bestechungs-Optimierer *(Bald verfuegbar)*

B2B-Tool fuer Protokolle:
* Eingabe: Liquiditaetsziel (z.B. "$500K TVL fuer TOKEN/HYPE")
* Ausgabe: Genauer Bestechungsbetrag, prognostizierter ROI, empfohlenes Epochen-Timing
* Verfolgt Bestechungseffizienz ueber die Zeit

### Dynamische veNFT-PFPs *(Bald verfuegbar)*

KI-generierte Profilbilder, die sich basierend auf folgenden Faktoren entwickeln:
* Sperrdauer und -betrag
* Abstimmungsaktivitaet und -serie
* Gesamte verdiente Rendite
* Protokollzugehoerigkeit

### KI-Treasury *(Bald verfuegbar)*

Autonomes Treasury-Management:
* KI allokiert bis zu 30% des Treasurys pro Epoche
* Veroeffentlicht Entscheidungen 12 Stunden vor Ausfuehrung
* Community-Veto-Mechanismus
* Vollstaendige On-Chain-Transparenz

## Datenschutz

* Liest nur oeffentliche On-Chain-Daten Ihrer verbundenen Wallet
* Keine Wallet-Daten werden zwischen Sitzungen gespeichert
* Konversationen werden serverseitig nicht persistiert

---

## ko - Korean

### 시작하기

#### 소개

URL: https://docs.hyperdrome.finance/ko/introduction

Hyperdrome에 오신 것을 환영합니다 - Hyperliquid 기반 에이전틱 ve(3,3) DEX 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

## Hyperdrome이란?

Hyperdrome은 Hyperliquid 기반 **에이전틱 ve(3,3) DEX**입니다. 검증된 AMM(Aerodrome/Velodrome 포크)과 자연어를 통해 스왑, 유동성, 투표, 수익 최적화를 처리하는 AI 에이전트를 결합했습니다.

이 제품은 **AI가 달린 DEX가 아닙니다 — DEX를 가진 AI 에이전트입니다.**

## ve(3,3) 시스템

ve(3,3) 모델은 모든 참여자가 협력을 통해 이익을 얻는 지속 가능한 플라이휠을 만듭니다:

![${2}](${1})

### 핵심 구성 요소

1. **투표 에스크로 (ve)**
   * HDROME을 잠가 veHDROME 투표권을 받으세요 (최대 4년)
   * 더 긴 잠금 = 더 많은 투표권, 선형적으로 감소
   * 잠금 포지션은 ERC-721 NFT로 표현

2. **(3,3) 게임 이론**
   * 협력이 모든 참여자에게 지배적 전략
   * 투표자는 거래 수수료의 100% + 외부 뇌물 수령
   * 희석 방지 리베이스로 장기 잠금자 보호

### 혜택

* **지속 가능한 배출**: 주간 ~1% 감소, 순환 공급량의 0.2% 최저 한도
* **투표권**: 게이지 전반에 걸친 주간 배출 직접 배분
* **수수료 배분**: 거래 수수료의 100%가 veHDROME 투표자에게
* **뇌물 마켓플레이스**: 프로토콜이 직접 인센티브 비용의 일부로 유동성 확보

## 듀얼 AMM 설계

| 풀 유형 | 곡선 | 기본 수수료 | 최적 용도 |
|-----------|-------|-------------|----------|
| **변동성 (vAMM)** | `x * y = k` | 0.2% | HYPE/USDC, HDROME/HYPE |
| **안정 (sAMM)** | `x³y + y³x = k` | 0.02% | USDC/USDT, 페그 페어 |

모든 풀에는 30분 관측 주기의 내장 **TWAP 오라클**이 포함되어 있습니다.

## HyperEVM 기반

| 속성 | 값 |
|----------|-------|
| 체인 | HyperEVM |
| 체인 ID | 999 |
| 네이티브 토큰 | HYPE |
| RPC | `https://rpc.hyperliquid.xyz/evm` |
| 익스플로러 | `https://explorer.hyperliquid.xyz` |

## 시작하기

  ### 앱 실행
    거래, 유동성 제공, 보상 획득을 시작하세요
  

  ### 토큰 스왑
    최적화된 멀티홉 라우팅으로 토큰을 거래하세요
  

  ### 유동성 제공
    토큰 페어를 예치하고 게이지에 스테이킹하여 배출 보상을 받으세요
  

  ### 잠금 및 투표
    HDROME을 잠가 veHDROME을 받고 프로토콜 배출을 결정하세요
  

## 왜 Hyperdrome인가?

* **AI 네이티브**: 내장 에이전트가 자연어와 슬래시 명령어로 DeFi 복잡성을 처리
* **검증된 코드베이스**: Aerodrome/Velodrome 포크 — 가장 검증된 ve(3,3) 구현
* **오토파일럿** *(출시 예정)*: 예치하고 쉬세요 — AI가 LP, 스테이킹, 투표, 리밸런싱, 복리 운용을 24/7 관리
* **$0 AI 비용**: Claude, GPT-4, Gemini에 대한 무제한 접근, 사용자당 한계 비용 제로
* **뇌물 옵티마이저** *(출시 예정)*: B2B 도구 — 프로토콜이 유동성 목표를 입력하면 AI가 정확한 뇌물 금액 + 예상 ROI를 출력

---

### 토크노믹스

#### HDROME 토큰

URL: https://docs.hyperdrome.finance/ko/tokenomics/hdrome-token

HDROME 토큰은 Hyperliquid 기반 Hyperdrome ve(3,3) DEX를 구동합니다 — 잠금, 투표, 수익 획득 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# HDROME 토큰

![${2}](${1})

## 토큰 세부사항

| 속성 | 값 |
|----------|-------|
| 심볼 | HDROME |
| 소수점 | 18 |
| 체인 | HyperEVM (Chain ID 999) |
| 표준 | ERC-20 |
| 총 공급량 | 1,000,000,000 |

## 핵심 유틸리티

HDROME은 Hyperdrome 프로토콜의 네이티브 토큰입니다. 주요 유틸리티:

* **veHDROME으로 잠금** — HDROME을 잠가 ERC-721 NFT로 veHDROME 투표권을 받으세요
* **거버넌스** — veHDROME 보유자가 프로토콜 매개변수 및 배출 배분을 관리합니다
* **게이지 투표** — 원하는 유동성 풀에 주간 HDROME 배출을 배분하세요
* **거래 수수료 100%** — 투표자가 투표한 풀의 거래 수수료 100%를 획득합니다
* **뇌물** — 유동성을 확보하려는 프로토콜이 예치한 외부 뇌물을 획득합니다
* **리베이스** — 희석 방지 HDROME 리베이스로 장기 잠금자를 배출 희석으로부터 보호합니다

---

## 잠금 메커니즘

![${2}](${1})

HDROME을 잠그면 ERC-721 NFT(veNFT)로 표현되는 **veHDROME** 포지션이 생성됩니다. 투표권은 잠금 기간 동안 선형적으로 감소합니다.

### 잠금 매개변수

| 매개변수 | 값 |
|-----------|-------|
| 최소 잠금 | 1주 |
| 최대 잠금 | 4년 |
| 감소 | 잠금 기간 동안 선형 |
| 표현 | ERC-721 NFT (veNFT) |

### 투표권 공식

```
votingPower = (lockAmount × lockDuration) / maxDuration
```

여기서 `maxDuration` = 4년입니다. 더 오래 잠글수록 더 많은 투표권을 받습니다:

| 잠금 기간 | 투표권 (잠금 금액의 %) |
|---------------|----------------------------------|
| 4년 | 100% |
| 2년 | 50% |
| 1년 | 25% |
| 6개월 | 12.5% |

### veNFT 관리

| 작업 | 설명 |
|--------|-------------|
| **생성** | HDROME을 잠가 선택한 기간으로 새 veNFT를 발행 |
| **금액 증가** | 기존 veNFT에 더 많은 HDROME 추가 |
| **잠금 연장** | 잠금 기간을 연장하여 투표권 증가 |
| **병합** | 두 개의 veNFT를 하나로 결합 (기간 조정) |
| **전송** | veNFT를 다른 지갑으로 전송 (ERC-721 전송) |
| **출금** | 잠금 만료 후 잠금 해제된 HDROME 청구 |

  잠긴 HDROME은 잠금이 만료될 때까지 출금할 수 없습니다. 투표권은 선형적으로 감소합니다 — 1,000 HDROME의 4년 잠금은 1,000 veHDROME으로 시작하여 만료 시 0에 도달합니다. 완전한 투표권을 유지하려면 잠금을 연장하세요.

---

#### 토큰 배분 및 배출

URL: https://docs.hyperdrome.finance/ko/tokenomics/distribution-emissions

HDROME 토큰 배분 및 배출 일정의 상세 분류 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# 토큰 배분 및 배출

## 총 공급량: 1,000,000,000 HDROME

![${2}](${1})

| 카테고리 | 배분율 | 수량 | 형태 | 세부사항 |
|----------|-----------|--------|------|---------|
| **프로토콜** | 65% | 650,000,000 | HDROME | 배출, 유동성, 프로토콜 성장 |
| **프리세일** | 20% | 200,000,000 | HDROME | 세부사항 추후 공개 |
| **팀 및 기여자** | 5% | 50,000,000 | veHDROME | 베스팅 잠금 |
| **커뮤니티 에어드롭** | 5% | 50,000,000 | veHDROME | MerkleClaim을 통한 4년 잠금 |
| **마케팅** | 5% | 50,000,000 | HDROME | 성장, 파트너십, 인센티브 |

  
    가장 큰 배분은 프로토콜 자체에 예약되어 있습니다. 여기에는 LP에 보상하기 위한 게이지 배출, 프로토콜 소유 유동성, 향후 프로토콜 성장 이니셔티브가 포함됩니다. 이 배분은 Hyperdrome 생태계의 장기적 지속 가능성을 보장합니다.
  
  
    200,000,000 HDROME이 프리세일 라운드에 배분됩니다. 추가 세부사항은 곧 발표됩니다.
  
  
    50,000,000 HDROME이 베스팅 잠금이 있는 **veHDROME**으로 배분됩니다. 이를 통해 팀의 인센티브가 장기적 프로토콜 성공에 맞춰집니다 — 팀은 토큰 판매가 아닌 투표 수수료와 뇌물을 통해 수익을 얻습니다.
  
  
    50,000,000 HDROME이 MerkleClaim 컨트랙트를 통해 4년 잠금 **veHDROME**으로 배분됩니다. 수령자는 첫날부터 투표권과 수수료 수익을 즉시 얻습니다.
  
  
    50,000,000 HDROME이 성장 이니셔티브, 전략적 파트너십, KOL 캠페인, 생태계 인센티브에 배분됩니다.
  

---

## 배출 일정

![${2}](${1})

### 주간 배출

배출은 **주당 15,000,000 HDROME**으로 시작하며 각 에폭마다 약 1% 감소합니다:

```
weekly_emission(n) = weekly_emission(n-1) × 990 / 1000
```

| 기간 | 주간 배출 | 누적 배출 |
|--------|----------------|--------------------|
| 1주차 | 15,000,000 | 15,000,000 |
| 13주차 (~3개월) | 13,100,000 | ~182,000,000 |
| 26주차 (~6개월) | 11,600,000 | ~338,000,000 |
| 52주차 (~1년) | 8,950,000 | ~573,000,000 |
| 104주차 (~2년) | 5,340,000 | ~831,000,000 |

  감소된 배출이 **순환 공급량의 0.2%** 미만으로 떨어지면, 최소 배출 비율을 무기한 유지하기 위해 테일 배출 하한선이 활성화됩니다.

### 주간 배분 비율

| 수령자 | 비율 | 설명 |
|-----------|-------|-------------|
| **게이지** | ~96.7% | veHDROME 투표 가중치에 따라 유동성 풀에 배분 |
| **팀** | ~3% | 팀 주소에 30 베이시스 포인트 (최대 50 bps) |
| **리베이스** | 가변 | RewardsDistributor를 통해 veHDROME 보유자에게 희석 방지 HDROME |

---

## 에폭 사이클

![${2}](${1})

각 에폭은 **목요일 00:00 UTC**부터 다음 목요일까지 진행됩니다:

  
    이전 투표가 집계됩니다. Minter가 감소 공식에 기반하여 새로운 배출량을 계산합니다.
  
  
    Minter가 HDROME을 발행합니다. Voter 컨트랙트가 투표 가중치에 비례하여 게이지에 배분합니다. RewardsDistributor가 veHDROME 보유자에게 리베이스를 전송합니다.
  
  
    veHDROME 보유자가 풀 전반에 투표를 배분합니다. 각 veNFT는 에폭당 한 번 투표할 수 있습니다.
  
  
    거래 수수료와 뇌물이 투표자에게 누적됩니다. LP 배출은 게이지 스테이커에게 지속적으로 스트리밍됩니다.

---

#### veHDROME 및 투표

URL: https://docs.hyperdrome.finance/ko/tokenomics/vehdrome-voting

veHDROME 투표 작동 방식 — 게이지 배분, 수익 스트림, 투표 전략 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# veHDROME 및 투표

![${2}](${1})

## 투표 흐름

각 에폭(목요일 00:00 UTC ~ 목요일 00:00 UTC)마다 veHDROME 보유자는 유동성 풀 게이지에 투표권을 배분합니다. 흐름은 다음과 같습니다:

1. **veHDROME 보유자**가 하나 이상의 풀을 선택하고 투표 가중치(백분율 기반)를 지정합니다.
2. **Voter 컨트랙트**가 에폭 전환 시 모든 투표를 집계합니다.
3. **Minter**가 주간 HDROME 배출을 발행하고 투표 비율에 비례하여 게이지에 배분합니다.
4. **게이지에 스테이킹된 LP**가 다음 에폭 동안 초당 기준으로 HDROME 배출을 획득합니다.
5. **투표자**가 투표한 풀의 거래 수수료 100%와 외부 뇌물을 획득합니다.

## 게이지 시스템

| 매개변수 | 값 |
|-----------|-------|
| 게이지당 최대 보상 토큰 | 16 |
| 에폭 기간 | 7일 (목요일~목요일 UTC) |
| 배출 누적 | 초당, 스테이킹된 LP 지분에 비례 |

---

## 수익 스트림

![${2}](${1})

veHDROME 투표자는 세 가지 별도의 수익 스트림에서 수익을 얻습니다:

| 스트림 | 출처 | 배분 |
|--------|--------|-------------|
| **거래 수수료** | 투표한 풀의 스왑 수수료 100% | 에폭 전환 후 청구 가능 |
| **외부 뇌물** | 투표를 유치하려는 프로토콜이 예치 | 에폭 전환 후 청구 가능 |
| **리베이스** | Minter의 희석 방지 HDROME | RewardsDistributor를 통해 veHDROME 보유자에게 자동 배분 |

---

## 투표 규칙

| 규칙 | 세부사항 |
|------|--------|
| **에폭당 1회** | 각 veNFT는 에폭당 한 번 투표 가능 |
| **전환까지 잠금** | 투표 후 해당 에폭 전체 동안 잠금 |
| **초기화 필요** | veNFT 전송 또는 병합 전 투표 초기화 필수 |
| **갱신** | 누구나 veNFT를 갱신하여 기존 배분에서 감소된 투표권을 업데이트 가능 |

## 투표 전략

  
    현재 투표 가중치 대비 거래량이 가장 높은 풀에 투표하세요. 투표가 적은 고거래량 풀은 배분된 veHDROME당 더 많은 수수료를 생성합니다. 각 에폭마다 수수료/투표 비율을 확인하여 가중치가 낮은 풀을 식별하세요.
  
  
    활성 외부 뇌물이 있는 풀에 투표하세요. 프로토콜이 투표를 유치하기 위해 뇌물을 예치하며, 투표당 뇌물 비율이 수수료 수익을 크게 초과할 수 있습니다. 최적의 기회를 찾기 위해 총 뇌물 가치와 현재 투표 가중치를 비교하세요.
  
  
    특정 프로토콜의 토큰 유동성을 심화하려면 해당 게이지에 투표를 집중하세요. 이렇게 하면 해당 풀의 LP에 더 많은 HDROME 배출이 배분되어 더 많은 유동성을 유치하고 토큰의 스프레드를 줄일 수 있습니다.
  

  투표는 한번 행사되면 해당 에폭 전체 동안 잠금됩니다. 다음 에폭 전환까지 투표를 변경하거나 철회할 수 없습니다. 투표 전에 배분을 신중하게 계획하세요.

---

#### 풀 및 유동성

URL: https://docs.hyperdrome.finance/ko/tokenomics/pools-liquidity

Hyperdrome의 듀얼 AMM 풀 아키텍처, 수수료 구조, 유동성 제공 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# 풀 및 유동성

![${2}](${1})

## 풀 아키텍처

Hyperdrome은 서로 다른 자산 클래스에 최적화된 두 가지 풀 유형으로 **듀얼 AMM** 설계를 사용합니다. PairFactory는 CREATE2를 통해 풀을 결정론적으로 배포합니다. 각 풀은 자체 수수료 수집 컨트랙트(PairFees)를 가지며 HDROME 배출을 위한 게이지가 연결될 수 있습니다. 모든 풀에는 30분 관측 주기의 내장 TWAP 오라클도 포함되어 있습니다.

### 변동성 풀 (vAMM)

| 속성 | 값 |
|----------|-------|
| 곡선 | `x * y = k` (상수곱) |
| 기본 수수료 | 0.2% |
| 명명 규칙 | vAMM-TOKEN0/TOKEN1 |
| 최적 용도 | 비상관 페어 (HYPE/USDC, HDROME/HYPE) |

### 안정 풀 (sAMM)

| 속성 | 값 |
|----------|-------|
| 곡선 | `x³y + y³x = k` (StableSwap 변형) |
| 기본 수수료 | 0.02% |
| 명명 규칙 | sAMM-TOKEN0/TOKEN1 |
| 최적 용도 | 페그/상관 페어 (USDC/USDT, HYPE/stHYPE) |

---

## 수수료 구조

| 매개변수 | 세부사항 |
|-----------|--------|
| 변동성 풀 수수료 | 0.2% (Fee Manager가 조정 가능) |
| 안정 풀 수수료 | 0.02% (Fee Manager가 조정 가능) |
| 수수료 수령자 | 해당 풀 게이지의 veHDROME 투표자 100% |
| 수수료 수집 | 스왑당 PairFees 컨트랙트로 수집 |

---

## 스왑 라우팅

Router 컨트랙트는 모든 토큰 스왑에 대한 최적 경로를 찾습니다. 모든 사용 가능한 풀(변동성 및 안정 모두)을 확인하고 직접 페어가 없거나 멀티홉 경로가 더 나은 실행을 제공할 때 멀티홉 라우트를 구성합니다. 예를 들어, TOKEN_A에서 TOKEN_B로의 스왑이 TOKEN_A → HYPE → TOKEN_B를 통해 라우팅되면 슬리피지가 줄어들 수 있습니다.

---

## 유동성 제공

![${2}](${1})

  
    변동성(vAMM) 또는 안정(sAMM) 풀 페어를 선택하세요. 변동성 풀은 비상관 자산에, 안정 풀은 페그 페어에 적합합니다.
  
  
    현재 풀 비율로 페어의 두 토큰을 제공하세요. Router가 남은 더스트를 최소화하기 위한 계산을 처리합니다.
  
  
    풀 내 지분을 나타내는 LP 토큰을 받습니다. 이 토큰은 거래 수수료를 자동으로 누적합니다.
  
  
    HDROME 배출을 획득하기 위해 LP 토큰을 풀의 게이지에 예치하세요. 스테이킹되지 않은 LP는 배출 보상이 제로입니다.
  

  예치 후 항상 LP 토큰을 게이지에 스테이킹하세요. 스테이킹되지 않은 LP 포지션은 거래 수수료를 획득하지만 HDROME 배출을 놓치게 됩니다 — 이는 종종 수익률의 대부분을 차지합니다.

---

## 내장 오라클

모든 Hyperdrome 풀에는 30분 관측 주기의 **TWAP (시간 가중 평균 가격) 오라클**이 포함되어 있습니다. 이는 HyperEVM의 다른 프로토콜이 소비할 수 있는 조작 저항 가격 피드를 제공합니다. 오라클은 누적 가격 관측을 저장하며 최대 관측 이력까지 모든 기간에 대해 쿼리할 수 있습니다.

---

#### 뇌물 및 보상

URL: https://docs.hyperdrome.finance/ko/tokenomics/bribes-rewards

뇌물, 거래 수수료, 배출, 리베이스가 Hyperdrome 생태계를 통해 흐르는 방식 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# 뇌물 및 보상

![${2}](${1})

## 보상 흐름

Hyperdrome 보상 시스템은 서로 다른 참여자에게 흐르는 세 가지 별개의 스트림을 가지고 있습니다:

1. **LP 배출** — Minter가 각 에폭마다 HDROME을 생성합니다. Voter 컨트랙트가 veHDROME 투표 가중치에 따라 게이지에 배분합니다. 게이지에 스테이킹된 LP는 게이지 내 자신의 지분에 비례하여 초당 기준으로 이 배출을 획득합니다.

2. **거래 수수료 + 외부 뇌물 → 투표자** — 각 풀의 거래 수수료 100%와 해당 풀 게이지에 예치된 외부 뇌물이 투표한 veHDROME 보유자에게 흐릅니다. 각 에폭 전환 후 청구할 수 있습니다.

3. **리베이스 → veHDROME 보유자** — RewardsDistributor가 모든 veHDROME 보유자에게 투표권에 비례하여 희석 방지 HDROME 리베이스를 전송하여 잠금자를 배출 희석으로부터 보호합니다.

---

## 보상 유형

| 보상 | 수령자 | 출처 | 타이밍 |
|--------|-----------|--------|--------|
| **LP 배출** | 게이지 스테이킹 LP | 주간 HDROME 발행 | 초당 누적 |
| **거래 수수료** | veHDROME 투표자 | 스왑 수수료 100% | 에폭 전환 후 청구 가능 |
| **외부 뇌물** | veHDROME 투표자 | 프로토콜 예치 | 에폭 전환 후 청구 가능 |
| **리베이스** | 모든 veHDROME 보유자 | Minter 희석 방지 | 에폭 전환 시 배분 |

---

## 외부 뇌물

![${2}](${1})

외부 뇌물은 프로토콜이 veHDROME 투표자에게 특정 풀로 배출을 배분하도록 인센티브를 제공하는 방식입니다. 이것은 프로토콜이 Hyperdrome에서 깊은 유동성을 확보하기 위한 주요 메커니즘입니다.

  
    프로토콜이 에폭 전환 전에 특정 게이지의 ExternalBribe 컨트랙트에 토큰을 예치합니다.
  
  
    에폭 전환 시 뇌물이 투표자에게 표시됩니다. veHDROME 보유자가 현재 에폭의 투표 결정에 뇌물 가치를 반영합니다.
  
  
    에폭 종료 후 해당 게이지에 투표를 배분한 투표자가 투표 가중치에 따라 뇌물의 비례 몫을 청구할 수 있습니다.
  

### 뇌물 효율성

* 프로토콜은 일반적으로 뇌물에 지출한 $1당 $2-5의 유동성을 확보합니다
* 뇌물 ROI는 에폭에 따라 다릅니다 — 총 투표 가중치가 낮을수록 투표당 수익이 높습니다
* 여러 에폭에 걸친 지속적 뇌물 지급이 지속적인 유동성 깊이를 구축합니다
* 게이지당 최대 16개의 서로 다른 보상 토큰을 뇌물로 사용할 수 있습니다

---

## 내부 뇌물 (거래 수수료)

내부 뇌물은 외부 당사자가 예치하는 것이 아닙니다 — 각 풀이 생성하는 **거래 수수료**입니다. 스왑 수수료의 100%가 해당 풀 게이지의 InternalBribe 컨트랙트로 자동 라우팅됩니다. 해당 게이지에 투표한 veHDROME 투표자가 각 에폭 전환 후 이 수수료를 청구합니다. 거래량이 높은 풀일수록 더 많은 내부 뇌물을 생성하여 매력적인 투표 대상이 됩니다.

---

## 리베이스

리베이스는 RewardsDistributor 컨트랙트를 통해 모든 veHDROME 보유자에게 배분되는 희석 방지 보상입니다. 각 에폭마다 새로운 HDROME이 발행될 때, 투표권 희석을 방지하기 위해 비례하는 금액이 리베이스로 배분됩니다. 리베이스 금액은 잠긴 HDROME과 총 순환 공급량의 비율에 따라 조정됩니다 — 잠금이 많을수록 리베이스가 높아집니다.

---

## 보상 청구

| 보상 유형 | 청구 위치 | 빈도 |
|-------------|---------------|-----------|
| LP 배출 | Gauge 컨트랙트 | 언제든지 (초당 누적) |
| 거래 수수료 | InternalBribe 컨트랙트 | 각 에폭 전환 후 |
| 외부 뇌물 | ExternalBribe 컨트랙트 | 각 에폭 전환 후 |
| 리베이스 | RewardsDistributor | 각 에폭 전환 후 |

  Hyperdrome 에이전트의 `/claim` 슬래시 명령어를 사용하면 모든 포지션의 대기 보상을 단일 트랜잭션으로 청구할 수 있습니다.

---

#### 배포된 컨트랙트

URL: https://docs.hyperdrome.finance/ko/tokenomics/deployed-contracts

Hyperdrome 생태계에 배포된 스마트 컨트랙트 목록 및 기능 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# 배포된 컨트랙트

## 네트워크 정보

| 매개변수 | 값 |
|-----------|-------|
| 네트워크 | Hyperliquid EVM |
| 체인 ID | `999` |
| RPC URL | `https://rpc.hyperliquid.xyz/evm` |
| 익스플로러 | `https://explorer.hyperliquid.xyz` |
| 네이티브 토큰 | HYPE |

## 코어 컨트랙트 (HyperEVM 메인넷)

| 컨트랙트 | 주소 |
|----------|---------|
| HDROME Token | `TBD` |
| VotingEscrow (veHDROME) | `TBD` |
| Voter | `TBD` |
| Router | `TBD` |
| PairFactory | `TBD` |
| GaugeFactory | `TBD` |
| BribeFactory | `TBD` |
| Minter | `TBD` |
| RewardsDistributor | `TBD` |
| MerkleClaim | `TBD` |
| VeArtProxy | `TBD` |
| HyperdromeLibrary | `TBD` |

  컨트랙트 주소는 메인넷 배포 후 여기에 게시됩니다. 모든 컨트랙트는 Hyperliquid Explorer에서 검증됩니다.

## 알려진 토큰 주소

| 토큰 | 주소 | 소수점 |
|-------|---------|----------|
| WHYPE (Wrapped HYPE) | `0x5555555555555555555555555555555555555555` | 18 |
| USDC | `0xb88339CB7199b77E23DB6E890353E22632Ba630f` | 6 |
| USDT0 | `0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb` | 6 |

## 컨트랙트 아키텍처

| 레이어 | 컨트랙트 | 목적 |
|-------|-----------|---------|
| **AMM 코어** | Pair, PairFees, PairFactory, Router | 토큰 스왑, 유동성, 수수료 수집 |
| **토큰 및 잠금** | Hyperdrome, VotingEscrow, VeArtProxy | HDROME 토큰, veNFT 생성 및 관리 |
| **투표 및 게이지** | Voter, Gauge, InternalBribe, ExternalBribe | 배출 투표, LP 스테이킹, 뇌물 배분 |
| **배출** | Minter, RewardsDistributor | 주간 발행, 리베이스 배분 |
| **팩토리** | PairFactory, GaugeFactory, BribeFactory | 결정론적 컨트랙트 배포 |
| **거버넌스** | L2Governor, HyperdromeGovernor (Multisig) | 온체인 제안, 타임락 실행 |
| **에어드롭** | MerkleClaim | 머클 트리 에어드롭 (4년 veHDROME 잠금) |

  상호작용 전에 항상 컨트랙트 주소를 검증하세요. 이 공식 문서 또는 Hyperdrome 앱에 나열된 주소만 사용하세요.

---

#### 보안

URL: https://docs.hyperdrome.finance/ko/tokenomics/security

Hyperdrome의 보안 조치 및 감사 이력 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# 보안

![${2}](${1})

## 코드베이스 계보

Hyperdrome은 DeFi에서 가장 검증된 ve(3,3) 구현 중 하나인 **Velodrome/Solidly** 코드베이스를 기반으로 구축되었습니다:

* **Solidly** — Andre Cronje가 Fantom에서 만든 최초의 ve(3,3) AMM
* **Velodrome** — Optimism의 개선된 포크, OP에서 TVL 기준 최대 DEX

## 감사

| 감사 | 범위 | 보고서 |
|-------|-------|--------|
| Solidly 감사 | 코어 AMM, VotingEscrow, Minter | 저장소에서 확인 가능 |
| Velodrome 감사 | 전체 프로토콜 리뷰 | 저장소에서 확인 가능 |

## 스마트 컨트랙트 보안

### 접근 제어

| 역할 | 권한 |
|------|------------|
| **Governor** | 토큰 화이트리스트, 게이지 생성, 프로토콜 매개변수 |
| **Emergency Council** | 긴급 상황 시 게이지 중지/복구 |
| **Fee Manager** | 풀별 거래 수수료율 조정 |
| **Pauser** | 긴급 상황 시 모든 스왑 일시 중지 |

### 타임락

**HyperdromeGovernor** 멀티시그는 함수별 타임락을 포함합니다:

* 함수 셀렉터 / 대상 콤보별 맞춤 지연
* 배치 트랜잭션 실행 지원
* 0x의 ZeroExGovernor 패턴 기반

### 핵심 보안 속성

* **불변 Minter 할당** — `setMinter()`는 HDROME 토큰에서 한 번만 호출 가능
* **CREATE2 결정론적 배포** — Pair 주소가 예측 가능하고 검증 가능
* **veNFT 첨부 시스템** — 게이지에 스테이킹된 동안 veNFT 전송 방지
* **에폭 잠금 투표** — 에폭 중 투표 변경 불가, 조작 방지
* **TWAP 오라클** — 30분 관측 주기로 가격 조작 저항

## Solidity 버전

모든 컨트랙트는 표준 오버플로/언더플로 보호가 포함된 **Solidity 0.8.13**으로 컴파일되었습니다.

## 테스트 스위트

프로토콜은 다음을 포함하는 **21개의 Foundry 테스트 파일**을 포함합니다:

* AMM 페어 메커니즘 및 수수료 회계
* veNFT 잠금/해제/병합 작업
* 배출 계산 및 감소 일정
* 게이지 스테이킹 및 보상 배분
* 투표 메커니즘 및 에폭 전환
* 긴급 게이지 중지/복구
* 머클 클레임 에어드롭 배분
* 온체인 거버넌스 제안
* 워시 트레이딩 방지 보호
* 오라클 정확성 및 에지 케이스

---

### 에이전트

#### 에이전틱 개요

URL: https://docs.hyperdrome.finance/ko/agentic/overview

Hyperdrome 에이전트 — Hyperliquid 기반 ve(3,3) DEX를 위한 AI 네이티브 인터페이스 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# Hyperdrome 에이전트

![${2}](${1})

## AI가 달린 DEX가 아닙니다 — DEX를 가진 AI 에이전트입니다

Hyperdrome은 AI 퍼스트로 구축되었습니다. 에이전트는 거래 인터페이스에 볼트된 챗봇이 아닙니다 — 에이전트 자체**가** 인터페이스입니다. 모든 DeFi 작업(스왑, LP, 잠금, 투표, 청구)은 자연어 대화 또는 슬래시 명령어를 통해 접근할 수 있습니다. 기존 UI는 대체 수단으로 존재하지만, 에이전트가 사용자가 프로토콜과 상호작용하는 주요 방법입니다.

---

## 아키텍처

Hyperdrome 에이전트는 LLM 라우팅 레이어를 사용하여 사용자 의도를 해석하고 온체인 작업에 매핑합니다. 사용자가 메시지를 보내면 에이전트는:

1. **의도 분석** — LLM이 메시지를 분석하여 사용자가 원하는 작업을 파악합니다 (스왑, LP, 투표, 포트폴리오 확인 등)
2. **컨텍스트 수집** — 온체인 상태(지갑 잔액, 풀 데이터, veNFT 포지션, 대기 보상)와 오프체인 데이터(가격, TVL, APR)를 읽습니다
3. **응답 생성** — 제안된 작업, 매개변수, 예상 결과를 보여주는 리치 UI 카드와 함께 자연어 설명을 생성합니다
4. **승인 시 실행** — 사용자가 확인하면 에이전트가 트랜잭션을 구성하고 제출합니다

에이전트는 여러 LLM 백엔드(Claude, GPT-4, Gemini)를 사용자에게 비용 없이 지원합니다.

---

## 채팅으로 DeFi

사용자는 대화형 프롬프트를 통해 전체 프로토콜과 상호작용합니다:

* *"100 USDC를 HYPE로 스왑해줘"*
* *"대기 중인 보상이 뭐야?"*
* *"1000 HDROME을 4년간 잠가줘"*
* *"내 veHDROME 전부를 HYPE/USDC 풀에 투표해줘"*
* *"지금 최고 수익률은 뭐야?"*

에이전트가 라우팅, 슬리피지, 가스 추정, 트랜잭션 구성을 백그라운드에서 처리합니다.

---

## 슬래시 명령어

| 명령어 | 작업 |
|---------|--------|
| `/swap` | 최적화된 라우팅으로 토큰 스왑 |
| `/lp` | 풀에서 유동성 추가 또는 제거 |
| `/vote` | 게이지 전반에 veHDROME 투표 배분 |
| `/lock` | HDROME을 잠가 veNFT 생성 또는 연장 |
| `/claim` | 모든 대기 보상 청구 (배출, 수수료, 뇌물) |
| `/help` | 사용 가능한 명령어 및 사용법 표시 |

---

## 리치 UI 카드

에이전트는 모든 작업에 대해 인터랙티브 카드를 렌더링합니다 — 단순한 텍스트 응답이 아닙니다. 카드가 표시하는 내용:

* **스왑 카드** — 토큰 페어, 수량, 가격 영향, 경로, 슬리피지 허용 범위
* **LP 카드** — 풀 페어, TVL, APR, 내 지분, 예치 금액
* **투표 카드** — 게이지 목록, 현재 투표 가중치, 예상 수수료/뇌물 수익
* **포트폴리오 카드** — 토큰 잔액, LP 포지션, veNFT 세부사항, 대기 보상
* **보상 카드** — 청구 가능한 배출, 수수료, 뇌물의 USD 가치 분류

---

## 실행 가능한 작업

| 카테고리 | 작업 |
|----------|---------|
| **거래** | 토큰 스왑, 멀티홉 라우팅, 슬리피지 설정 |
| **유동성** | 유동성 추가, 유동성 제거, 게이지에 스테이킹, 게이지에서 언스테이킹 |
| **잠금** | veNFT 생성, 잠금 금액 증가, 잠금 기간 연장, veNFT 병합 |
| **투표** | 게이지 투표, 투표 초기화, 오래된 투표 갱신 |
| **보상** | 배출 청구, 수수료 청구, 뇌물 청구, 리베이스 청구 |
| **포트폴리오** | 잔액 확인, 포지션 확인, 대기 보상 확인, 수익률 추천 받기 |

---

## 스마트 제안

에이전트는 지갑 상태에 따라 최적화 기회를 사전에 제시합니다:

| 우선순위 | 트리거 | 제안 |
|----------|---------|------------|
| **높음** | 스테이킹되지 않은 LP 토큰 감지 | 게이지에 스테이킹하여 배출 보상 획득 |
| **높음** | 미청구 보상 > $10 | 대기 보상 청구 및 복리 운용 |
| **높음** | 7일 이내 만료 예정 veNFT | 투표권 유지를 위해 잠금 연장 |
| **중간** | LP/잠금에 없는 유휴 토큰 > $10 | 유동성 제공 또는 veHDROME으로 잠금 |
| **중간** | 비최적 투표 배분 | 더 높은 수익률의 게이지로 투표 재배분 |
| **낮음** | 새로운 고APR 풀 이용 가능 | 트렌딩 풀에 LP 고려 |

---

## LLM 비종속적 아키텍처

Hyperdrome 에이전트는 **단일 AI 제공자에 종속되지 않습니다**. 아키텍처는 의도 분석, 컨텍스트 수집, 실행을 독립적인 레이어로 분리합니다 — 따라서 LLM 백엔드를 다른 것을 변경하지 않고도 교체할 수 있습니다.

| 레이어 | 역할 | LLM 필요? |
|-------|------|---------------|
| **Intent Parser** | 사용자의 의도 이해 | 예 — 모든 LLM |
| **Context Gatherer** | 온체인 + 오프체인 데이터 읽기 | 아니오 |
| **Responder** | 설명 + UI 카드 생성 | 예 — 모든 LLM |
| **Executor** | 트랜잭션 구성 및 제출 | 아니오 |

현재 **Claude**, **GPT-4**, **Gemini**를 지능형 라우팅으로 지원합니다. 오픈소스 모델(Llama, Mistral, Qwen)과 Bring Your Own LLM은 로드맵에 있습니다.

  ### LLM 통합
    멀티 모델 지원, 라우팅, Bring Your Own LLM
  

  ### MCP 서버
    MCP를 통해 모든 AI 어시스턴트를 Hyperdrome에 연결
  

  ### 에이전트 프레임워크
    GOAT SDK, Wayfinder, Eliza, Olas, REST API
  

---

## 다국어 지원

에이전트는 사용자의 언어로 응답합니다. 영어, 중국어, 일본어, 한국어, 스페인어, 프랑스어, 포르투갈어, 터키어, 러시아어, 아랍어 및 기타 언어의 프롬프트가 기본 LLM 기능을 통해 네이티브하게 지원됩니다. UI 라벨과 슬래시 명령어는 영어로 유지되지만, 모든 대화형 응답은 사용자의 언어에 맞게 적응합니다.

---

#### LLM 통합

URL: https://docs.hyperdrome.finance/ko/agentic/llm-integrations

Hyperdrome이 모든 LLM에 연결하는 방법 — Claude, GPT-4, Gemini, Llama, Mistral 등 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# LLM 통합

![${2}](${1})

## 설계부터 LLM 비종속적

Hyperdrome은 단일 AI 제공자에 종속되지 않습니다. 에이전트 아키텍처는 **의도 분석**, **컨텍스트 수집**, **실행**을 독립적인 레이어로 분리합니다 — 따라서 LLM 백엔드를 다른 것을 변경하지 않고도 교체할 수 있습니다.

이는 Hyperdrome이 오늘날 모든 대규모 언어 모델과 작동하며, 내일 출시될 모든 모델과도 작동할 것임을 의미합니다.

---

## 지원 모델

  ### Claude
    Opus, Sonnet, Haiku — **운영 중**
  

  ### GPT-4
    GPT-4o, GPT-4, GPT-4 Turbo — **운영 중**
  

  ### Gemini
    Gemini 2.5 Pro, 2.5 Flash — **운영 중**
  

  ### 오픈소스
    Llama, Mistral, Qwen, DeepSeek — *계획 중*
  

  모든 모델은 사용자에게 **무료**로 제공됩니다. Hyperdrome이 추론 비용을 부담합니다.

---

## 아키텍처

에이전트 파이프라인은 모든 단계에서 모델 비종속적입니다:

```
User Input (natural language or /command)
        │
        ▼
┌──────────────────┐
│  Intent Parser   │ ← Any LLM (Claude, GPT-4, Gemini, Llama...)
│  "What does the  │
│   user want?"    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Context Gatherer │ ← On-chain + off-chain data (no LLM needed)
│  Wallet, pools,  │
│  prices, APRs    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Responder     │ ← Any LLM (generates explanation + UI cards)
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Executor      │ ← Transaction builder (no LLM needed)
│  Build tx, sign, │
│  submit on-chain │
└──────────────────┘
```

LLM은 두 단계에서만 관여합니다: 사용자가 원하는 것을 이해하는 것과 결과를 설명하는 것. 나머지 — 블록체인 상태 읽기, 트랜잭션 구성, 온체인 제출 — 는 모두 결정론적 코드입니다.

---

## 지능형 라우팅

백엔드는 다음 요소를 기반으로 각 요청에 최적의 모델을 자동 선택합니다:

| 요소 | 로직 |
|--------|-------|
| **복잡도** | 단순 쿼리(가격 확인, 잔액) → 가장 빠른 모델. 복잡한 다단계 작업 → 가장 강력한 모델. |
| **언어** | 일부 모델은 특정 언어에서 더 뛰어납니다. 라우터는 감지된 사용자 언어에 맞게 최적화합니다. |
| **지연 시간** | 기본 모델이 느리거나 사용 불가한 경우, 라우터가 500ms 이내에 차선 옵션으로 전환합니다. |
| **비용** | 라우터는 모든 사용자에게 추론을 무료로 유지하기 위해 성능 대 비용의 균형을 맞춥니다. |

---

## Bring Your Own LLM *(출시 예정)*

  이 기능은 로드맵에 있으며 아직 사용할 수 없습니다.

사용자가 자체 LLM 제공자를 연결할 수 있게 됩니다:

* **API Key** — 자체 OpenAI, Anthropic, Google 또는 OpenAI 호환 API 키 연결
* **자체 호스팅 모델** — Llama, Mistral, Qwen 또는 기타 오픈소스 모델을 실행하는 자체 Ollama, vLLM 또는 TGI 엔드포인트로 에이전트를 연결
* **커스텀 시스템 프롬프트** — 에이전트의 성격, 위험 허용도, 응답 스타일 조정
* **완전한 프라이버시** — 자체 모델 사용 시, 데이터가 Hyperdrome의 추론 서버를 거치지 않음

### 호환 엔드포인트

OpenAI Chat Completions API 형식을 구현하는 모든 엔드포인트가 작동합니다:

| Runtime | Example Models |
|---------|---------------|
| **Ollama** | Llama 3.3, Mistral, Qwen 2.5, DeepSeek V3, Gemma |
| **vLLM** | Any HuggingFace model |
| **TGI** | Any HuggingFace model |
| **Together AI** | Llama, Mixtral, Qwen |
| **Groq** | Llama, Mixtral, Gemma |
| **Fireworks** | Llama, Mixtral, DeepSeek |

---

## LLM 비종속성이 중요한 이유

1. **벤더 종속 없음** — 제공자가 가격을 올리거나, 품질을 저하시키거나, 제한을 추가하면 Hyperdrome이 원활하게 전환합니다.

2. **작업에 최적의 모델** — 모델마다 잘하는 작업이 다릅니다. 라우팅을 통해 Hyperdrome은 각 요청에 최적의 도구를 사용합니다.

3. **미래 대비** — 새로운 모델이 매달 출시됩니다. LLM 비종속적 아키텍처는 Hyperdrome이 재작성 없이 즉시 도입할 수 있음을 의미합니다.

4. **사용자 주권** — Bring Your Own LLM으로 사용자가 데이터와 추론을 통제합니다. 중앙화된 AI 제공자에 대한 의존성이 없습니다.

5. **검열 저항성** — 오픈소스 모델은 폐쇄되거나 제한될 수 없습니다. 자체 Llama 또는 Mistral 인스턴스를 운영하는 사용자는 완전한 자율성을 갖습니다.

---

#### MCP 서버

URL: https://docs.hyperdrome.finance/ko/agentic/mcp-server

Hyperdrome의 Model Context Protocol 서버 — 모든 AI 어시스턴트를 ve(3,3) DEX에 연결 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# MCP 서버

![${2}](${1})

  Hyperdrome MCP 서버는 로드맵에 있으며 아직 라이브가 아닙니다. 이 페이지는 계획된 사양을 문서화합니다.

## MCP란?

**Model Context Protocol (MCP)** 은 Anthropic이 만든 오픈 표준으로, AI 어시스턴트가 외부 서버의 도구를 탐색하고 호출할 수 있게 합니다. JSON-RPC 2.0을 사용합니다 — 어시스턴트가 `tools/list`를 호출하여 사용 가능한 액션을 탐색한 다음, `tools/call`로 실행합니다.

MCP는 **Claude Desktop**, **Cursor**, **Opencode**, **Windsurf** 및 점점 늘어나는 AI 코딩 및 채팅 도구에서 지원됩니다.

---

## 왜 DeFi에 MCP를?

현재 DeFi와 상호작용하려면 다음이 필요합니다:
1. 브라우저 열기
2. 지갑 연결
3. 복잡한 UI 탐색
4. 슬리피지, 라우팅, 가스 이해

Hyperdrome의 MCP 서버를 사용하면 모든 AI 어시스턴트가 **직접** 토큰을 스왑하고, 수익률을 확인하고, 게이지에 투표하고, 포지션을 관리할 수 있습니다 — 사용자가 선호하는 도구를 벗어나지 않고도.

> *"Hyperdrome에서 500 USDC를 HYPE로 스왑해줘"* — Claude Desktop, Cursor 또는 모든 MCP 클라이언트에서 입력.

---

## 사용 가능한 도구

MCP 서버는 전체 Hyperdrome 프로토콜을 호출 가능한 도구로 노출합니다:

### Trading

| Tool | Description | Parameters |
|------|-------------|------------|
| `swap` | Swap tokens with optimized multi-hop routing | `fromToken`, `toToken`, `amount`, `slippageBps?` |
| `get_quote` | Get a swap quote without executing | `fromToken`, `toToken`, `amount` |

### Liquidity

| Tool | Description | Parameters |
|------|-------------|------------|
| `add_liquidity` | Deposit token pair into a pool | `tokenA`, `tokenB`, `amountA`, `amountB`, `stable` |
| `remove_liquidity` | Withdraw from a pool | `tokenA`, `tokenB`, `stable`, `liquidity` |
| `stake_lp` | Stake LP tokens in a gauge | `pool`, `amount` |
| `unstake_lp` | Unstake LP tokens from a gauge | `pool`, `amount` |

### Locking & Voting

| Tool | Description | Parameters |
|------|-------------|------------|
| `lock` | Lock HDROME to create or extend a veNFT | `amount`, `duration` |
| `vote` | Allocate veHDROME votes across gauges | `tokenId`, `pools[]`, `weights[]` |
| `reset_votes` | Reset votes for a veNFT | `tokenId` |

### Rewards

| Tool | Description | Parameters |
|------|-------------|------------|
| `claim_rewards` | Claim all pending rewards | `tokenId?` |
| `claim_fees` | Claim trading fees for a specific gauge | `gauge` |
| `claim_bribes` | Claim external bribes | `gauge`, `tokens[]` |

### Read-Only

| Tool | Description | Parameters |
|------|-------------|------------|
| `get_pools` | List all pools with TVL, APR, volume | `sortBy?`, `limit?` |
| `get_portfolio` | Full wallet analysis | `address` |
| `get_yields` | Top yield opportunities | `limit?`, `minTvl?` |
| `get_venft` | Get veNFT details | `tokenId` |
| `get_pending_rewards` | Check unclaimed rewards | `address` |

---

## 도구 스키마 예시

각 도구는 입력에 대한 JSON Schema와 함께 MCP 사양을 따릅니다:

```json
{
  "name": "swap",
  "description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromToken": {
        "type": "string",
        "description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
      },
      "toToken": {
        "type": "string",
        "description": "Token symbol or address to buy (e.g. 'HYPE')"
      },
      "amount": {
        "type": "string",
        "description": "Amount to swap in human-readable units (e.g. '100')"
      },
      "slippageBps": {
        "type": "number",
        "description": "Max slippage in basis points (default: 50 = 0.5%)"
      }
    },
    "required": ["fromToken", "toToken", "amount"]
  }
}
```

---

## 연결

### Claude Desktop / Cursor / Opencode

MCP 설정에 추가:

```json
{
  "mcpServers": {
    "hyperdrome": {
      "url": "https://mcp.hyperdrome.finance/sse"
    }
  }
}
```

### 자체 호스팅

MCP 서버는 오픈소스가 될 예정입니다. 자체 인스턴스 실행:

```bash
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
```

---

## 보안 모델

| 속성 | 세부사항 |
|----------|--------|
| **기본 읽기 전용** | 포트폴리오 조회 및 풀 데이터는 지갑 연결이 필요하지 않음 |
| **트랜잭션 승인** | 모든 쓰기 작업은 사용자가 검토하고 서명할 미서명 트랜잭션을 반환 |
| **프라이빗 키 없음** | 호스팅된 MCP 서버는 프라이빗 키에 접근하지 않음. 서명은 클라이언트 측에서 수행 |
| **Rate Limiting** | 남용 방지를 위한 IP별 및 API 키별 속도 제한 |
| **Audit Trail** | 모든 도구 호출은 타임스탬프, 매개변수, 결과와 함께 기록 |

  MCP 서버는 절대 사용자를 대신하여 트랜잭션을 실행하지 않습니다. 트랜잭션을 구성하고 명시적 승인을 위해 반환합니다 — 다른 DeFi 프론트엔드와 동일합니다.

---

## 활용 사례

| 시나리오 | 방법 |
|----------|-----|
| **DeFi 대시보드를 개발하는 개발자** | MCP 도구를 통해 풀, 수익률, 포지션 조회 |
| **AI 코딩 어시스턴트** | "내 Hyperdrome 보상을 모두 청구하는 스크립트를 작성해줘" — 어시스턴트가 `get_pending_rewards` 후 `claim_rewards`를 호출 |
| **자율 에이전트** | 포트폴리오 관리 에이전트가 매시간 수익률을 확인하고 `add_liquidity` / `remove_liquidity`를 통해 리밸런싱 |
| **채팅 봇** | Telegram 봇으로 사용자가 자연어를 통해 스왑, 포트폴리오 확인, 투표 가능 |
| **리서치** | 분석가가 `get_pools`를 조회하여 HyperEVM DEX 간 수익률 비교 구성 |

---

#### 에이전트 프레임워크 통합

URL: https://docs.hyperdrome.finance/ko/agentic/agent-frameworks

Hyperdrome이 GOAT SDK, Wayfinder, Eliza, Olas 및 더 넓은 AI 에이전트 생태계와 통합하는 방법 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# 에이전트 프레임워크 통합

![${2}](${1})

Hyperdrome은 우리 자체 에이전트뿐만 아니라 **모든 AI 에이전트**에서 접근할 수 있도록 설계되었습니다. 프로토콜은 여러 통합 레이어를 통해 기능을 노출하여, 서드파티 에이전트, 프레임워크, 플랫폼이 Hyperdrome과 네이티브하게 상호작용할 수 있습니다.

  ### GOAT SDK
    200+ 도구, 13+ 프레임워크 어댑터
  
  ### MCP
    Claude Desktop, Cursor, Opencode
  
  ### Wayfinder
    AI 네이티브 DeFi 터미널
  
  ### Eliza
    자율 소셜 + DeFi 에이전트
  
  ### Olas
    탈중앙화 자율 에이전트
  
  ### REST API
    직접 HTTP 엔드포인트
  

---

## 통합 아키텍처

```
┌─────────────────────────────────────────────────┐
│              AI Agent Frameworks                 │
│  Claude · GPT · Gemini · Llama · Mistral · ...  │
├─────────────────────────────────────────────────┤
│              Adapter Layer                       │
│  GOAT SDK · Wayfinder · Eliza · LangChain ·     │
│  Vercel AI · MCP · REST API                     │
├─────────────────────────────────────────────────┤
│           Hyperdrome Protocol Layer              │
│  Intent Parser → Context → Tx Builder → Chain   │
├─────────────────────────────────────────────────┤
│                 HyperEVM                         │
│  Router · Voter · Gauges · VotingEscrow · ...   │
└─────────────────────────────────────────────────┘
```

어댑터 레이어 중 하나를 지원하는 모든 프레임워크가 Hyperdrome과 상호작용할 수 있습니다. 커스텀 통합 코드가 필요하지 않습니다.

---

## GOAT SDK Plugin

  GOAT SDK 플러그인은 로드맵에 있으며 아직 출시되지 않았습니다.

**GOAT SDK**는 최대 규모의 에이전틱 금융 도구 키트입니다 — 200+ 도구, 15+ 체인, 13+ 프레임워크 어댑터. Uniswap, Aave, 1inch, Balancer와 같은 프로토콜이 이미 GOAT 플러그인을 보유하고 있습니다.

Hyperdrome은 전체 프로토콜을 커버하는 `@goat-sdk/plugin-hyperdrome`을 출시할 예정입니다:

### 제공 액션

| Action | Description |
|--------|-------------|
| `swap` | Swap tokens with optimized routing |
| `addLiquidity` | Deposit into volatile or stable pools |
| `removeLiquidity` | Withdraw from pools |
| `stakeLp` | Stake LP tokens in gauges |
| `unstakeLp` | Unstake from gauges |
| `lock` | Lock HDROME → veHDROME (create/extend veNFT) |
| `vote` | Allocate votes across gauges |
| `claimRewards` | Claim emissions, fees, bribes, rebases |
| `getPools` | List pools with TVL, APR, volume |
| `getPortfolio` | Full wallet analysis |

### 프레임워크 범위

GOAT 플러그인이 출시되면 Hyperdrome은 다음 프레임워크에서 자동으로 사용 가능합니다:

| Framework | Type |
|-----------|------|
| **Vercel AI SDK** | Full-stack AI apps |
| **LangChain** | Agent orchestration (Python & JS) |
| **LlamaIndex** | Data-augmented agents |
| **MCP** | Claude Desktop, Cursor, Opencode |
| **Eliza** | Autonomous social + DeFi agents |
| **CrewAI** | Multi-agent systems |
| **Mastra** | TypeScript agent framework |
| **GAME (Virtuals)** | Gaming + DeFi agents |
| **OpenAI Agents SDK** | OpenAI's native agent runtime |
| **ZerePy** | Python agent framework |
| **AutoGen** | Microsoft's multi-agent framework |
| **Olas** | Decentralized autonomous agents |

---

## Wayfinder Paths

  Wayfinder 통합은 로드맵에 있으며 아직 사용할 수 없습니다.

**Wayfinder**는 자체 SDK(Paths)를 갖춘 AI 네이티브 DeFi 터미널입니다. 이미 Hyperliquid 무기한 선물, Aave V3, Morpho, Pendle, Uniswap V3를 지원합니다.

Hyperdrome은 다음을 가능하게 하는 **Wayfinder 프로토콜 어댑터**를 출시할 예정입니다:

* Wayfinder Shells(AI 거래 인터페이스)를 통한 스왑, LP, 투표, 잠금
* 전략 구성 — Hyperdrome 수익률을 크로스 프로토콜 전략과 결합
* MCP 브릿지 — Wayfinder의 내장 MCP 서버가 Hyperdrome 도구를 노출

---

## Eliza (ElizaOS)

**Eliza**는 자율 암호화폐 에이전트를 위한 선도적인 오픈소스 프레임워크입니다. Twitter, Telegram 및 온체인에서 작동하는 소셜 및 DeFi 봇을 구동합니다.

GOAT 플러그인을 통한 Hyperdrome 통합 (`@elizaos/plugin-goat`):

* Eliza 에이전트가 Hyperdrome에서 스왑, LP, 투표, 청구 가능
* 자율 이자 농사 — APR을 모니터링하고 포지션을 리밸런싱하는 에이전트
* 소셜 + DeFi — 수익률 업데이트를 게시하고, 커뮤니티 질문에 답하고, 거래를 실행하는 에이전트

---

## Olas (Autonolas)

**Olas**는 자율 AI 에이전트를 공동 소유 및 운영하기 위한 탈중앙화 플랫폼입니다. 3,600+ 에이전트 배포, 17M+ 트랜잭션.

Hyperdrome 통합 경로:

* Hyperdrome 포지션을 관리하는 **Olas Agent Service** 구축
* Olas 마켓플레이스에서 **Mech**로 등록 — 다른 에이전트가 Hyperdrome 액션을 의뢰 가능
* 기존 Olas 에이전트와 결합하여 크로스 프로토콜 전략 구성

---

## REST API

  공개 REST API는 로드맵에 있으며 아직 사용할 수 없습니다.

프레임워크 없이 직접 통합을 원하는 개발자를 위해:

### 계획된 엔드포인트

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/api/pools` | List all pools with TVL, APR, fees, volume |
| `GET` | `/api/pools/:address` | Pool details |
| `GET` | `/api/portfolio/:wallet` | Full portfolio analysis |
| `GET` | `/api/yields` | Top yield opportunities |
| `POST` | `/api/quote` | Get a swap quote |
| `POST` | `/api/swap` | Build a swap transaction |
| `POST` | `/api/liquidity/add` | Build an add-liquidity transaction |
| `POST` | `/api/liquidity/remove` | Build a remove-liquidity transaction |
| `POST` | `/api/lock` | Build a lock transaction |
| `POST` | `/api/vote` | Build a vote transaction |
| `POST` | `/api/claim` | Build a claim-all transaction |

### 응답 형식

모든 쓰기 엔드포인트는 미서명 트랜잭션 데이터를 반환합니다:

```json
{
  "tx": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "chainId": 999,
    "gasLimit": "250000"
  },
  "summary": {
    "action": "Swap 100 USDC → 1.62 HYPE",
    "priceImpact": "0.03%",
    "route": ["USDC", "HYPE"],
    "minReceived": "1.611 HYPE"
  }
}
```

  API는 프라이빗 키를 절대 요구하지 않습니다. 모든 트랜잭션은 클라이언트 측 서명을 위해 미서명 상태로 반환됩니다.

---

## LangChain Tool

LangChain을 직접 사용하는 Python 개발자를 위해:

```python
from langchain.tools import tool

@tool
def hyperdrome_swap(from_token: str, to_token: str, amount: str) -> str:
    """Swap tokens on Hyperdrome (HyperEVM). Returns unsigned transaction."""
    # Calls Hyperdrome REST API
    ...
```

GOAT SDK 어댑터가 이를 자동으로 처리하지만, 개발자는 REST API에 대한 커스텀 LangChain 도구를 직접 구축할 수도 있습니다.

---

## 자체 통합 구축

Hyperdrome을 에이전트, 봇 또는 앱에 통합하고 싶으신가요?

1. **가장 빠른 방법** — GOAT SDK 플러그인 사용. 13+ 프레임워크에서 즉시 작동.
2. **가장 유연한 방법** — REST API 직접 사용. 어떤 언어로든 트랜잭션 구성 및 서명.
3. **AI 네이티브** — MCP로 연결. Claude Desktop, Cursor, Opencode 및 모든 MCP 클라이언트에서 작동.
4. **자율형** — 완전히 탈중앙화된 온체인 에이전트 실행을 위한 Olas Agent Service 구축.

모든 통합 레이어는 미서명 트랜잭션을 반환합니다 — 앱이 서명과 제출을 처리합니다. Hyperdrome은 절대 프라이빗 키에 접근하지 않습니다.

---

#### 에이전트 기능 및 로드맵

URL: https://docs.hyperdrome.finance/ko/agentic/capabilities

Hyperdrome 에이전트의 전체 기능, 데이터 소스, 출시 예정 기능 정확한 값, 실행 흐름, HyperEVM 참고 정보를 Hyperdrome 사용자를 위해 포함합니다.

# 에이전트 기능 및 로드맵

## 라이브 데이터 소스

| 소스 | 데이터 | 업데이트 |
|--------|------|--------|
| **HyperEVM RPC** | 지갑 잔액, LP 포지션, veNFT 세부사항, 게이지 스테이크, 대기 보상 | 실시간 |
| **CoinGecko** | HYPE, USDC, USDT, BTC, ETH, SOL 가격 + 24시간 변동 + 시가총액 + 거래량 | 60초 캐시 |
| **DeFiLlama** | Hyperliquid L1 체인 TVL, TVL/카테고리/7일 변동 기준 상위 20개 프로토콜 | 60초 캐시 |
| **Hyperliquid API** | 마크 가격, 24시간 거래량, 순환 공급량을 포함한 모든 현물 토큰 | 60초 캐시 |
| **프로토콜 컨트랙트** | 풀 리저브, TVL, APR, 투표 가중치, 뇌물 금액, 배출 비율 | 실시간 |

## 지갑 분석

에이전트는 지갑이 연결되면 심층 포트폴리오 분석을 수행합니다:

* **토큰 잔액** — USD 가치 포함 (가치순 정렬)
* **유휴 자본 감지** — LP/잠금에 없는 $10 초과 토큰
* **LP 포지션** — 페어, 안정/변동, 스테이킹/비스테이킹, TVL, APR, 게이지 주소
* **비스테이킹 LP 감지** — 배출 보상 제로인 LP
* **veNFT** — 잠금 금액, 만기, 남은 일수, 만료/만료 임박 플래그, 투표권, 투표 상태
* **대기 보상** — 배출, 뇌물, 수수료 — 페어별 분류 및 USD 총액
* **APR 기준 상위 10개 풀** 추천용

## 로드맵

| 기능 | 상태 |
|---------|--------|
| 채팅으로 DeFi (웹) | **출시 완료** |
| 슬래시 명령어 | **출시 완료** |
| 리치 UI 카드 | **출시 완료** |
| 스마트 제안 | **출시 완료** |
| Multi-LLM Backend (Claude, GPT-4, Gemini) | **출시 완료** |
| 텔레그램 슈퍼 에이전트 | **진행 중** |
| MCP Server | 계획 중 |
| GOAT SDK Plugin | 계획 중 |
| Public REST API | 계획 중 |
| Wayfinder Integration | 계획 중 |
| Bring Your Own LLM | 계획 중 |
| 오토파일럿 | 계획 중 |
| 콘텐츠 머신 | 계획 중 |
| 동적 veNFT PFP | 계획 중 |
| 뇌물 옵티마이저 | 계획 중 |
| 수익률 리포트 | 계획 중 |
| AI 트레저리 | 계획 중 |

### 오토파일럿 *(출시 예정)*

"예치하고 쉬세요" — 에이전트가 전체 DeFi 포지션을 자동으로 관리합니다.

| 리스크 프로필 | 목표 APY | 전략 |
|-------------|-----------|----------|
| **보수적** | 8-15% | 안정 풀, 최대 잠금, 블루칩 페어 |
| **균형** | 15-30% | 안정/변동 혼합, 중간 잠금 |
| **공격적** | 30-80% | 변동 풀, 뇌물 파밍, 적극적 리밸런싱 |
| **디젠** | 50-200% | 신규 풀, 최대 뇌물 포착, 단기 잠금 |

에이전트가 처리하는 항목: LP 포지션 관리, 게이지 스테이킹, veHDROME 투표, 보상 청구, 복리 재투자, 리밸런싱 — 모두 사용자 개입 없이 24/7.

**수익 모델**: 오토파일럿 수익에 대한 5% 성과 수수료.

### 텔레그램 슈퍼 에이전트 *(출시 예정)*

전체 Hyperdrome 경험을 위한 단일 봇:
* 스왑, 수익률, 포트폴리오, 청구, 오토파일럿
* 교육, 알림, 밈 생성
* PFP 생성, 뇌물 분석, 수익률 리포트

### 뇌물 옵티마이저 *(출시 예정)*

프로토콜을 위한 B2B 도구:
* 입력: 유동성 목표 (예: "TOKEN/HYPE에 $500K TVL")
* 출력: 정확한 뇌물 금액, 예상 ROI, 추천 에폭 타이밍
* 시간에 따른 뇌물 효율성 추적

### 동적 veNFT PFP *(출시 예정)*

다음 항목에 기반하여 진화하는 AI 생성 프로필 사진:
* 잠금 기간 및 금액
* 투표 활동 및 연속 기록
* 총 수익
* 프로토콜 사용 기간

### AI 트레저리 *(출시 예정)*

자율 트레저리 관리:
* AI가 에폭당 최대 30%의 트레저리 배분
* 실행 12시간 전 결정 사항 공개
* 커뮤니티 거부권 메커니즘
* 완전한 온체인 투명성

## 개인정보 보호

* 연결된 지갑의 공개 온체인 데이터만 읽습니다
* 세션 간 지갑 데이터 저장 없음
* 서버 측 대화 내용 유지 없음

---

## ja - Japanese

### はじめに

#### はじめに

URL: https://docs.hyperdrome.finance/ja/introduction

Hyperdromeへようこそ — Hyperliquid上のエージェント型 ve(3,3) DEX 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

## Hyperdromeとは？

Hyperdromeは、Hyperliquid上の**エージェント型 ve(3,3) DEX**です。実績のあるAMM（Aerodrome/Velodromeのフォーク）と、スワップ、流動性提供、投票、利回り最適化を自然言語で処理するAIエージェントを組み合わせています。

このプロダクトは**AIを搭載したDEXではなく、DEXを持つAIエージェント**です。

## ve(3,3) システム

ve(3,3)モデルは、すべての参加者が協力することで利益を得る持続可能なフライホイールを構築します。

![${2}](${1})

### コアコンポーネント

1. **Voting Escrow (ve)**
   * HDROMEをロックしてveHDROMEの投票権を取得（最大4年間）
   * ロック期間が長いほど投票権が多く、線形に減衰
   * ロックポジションはERC-721 NFTとして表現

2. **(3,3) ゲーム理論**
   * すべての参加者にとって協力が支配戦略
   * 投票者は取引手数料の100% + 外部賄賂を獲得
   * 希薄化防止リベースが長期ロッカーを保護

### メリット

* **持続可能なエミッション**: 週次約1%の減衰、循環供給量の0.2%を下限に設定
* **投票権**: ゲージ間の週次エミッション配分を直接決定
* **手数料分配**: 取引手数料の100%がveHDROME投票者へ
* **賄賂マーケットプレイス**: プロトコルが直接インセンティブコストの数分の一で流動性を獲得

## デュアルAMM設計

| プールタイプ | カーブ | デフォルト手数料 | 最適な用途 |
|-----------|-------|-------------|----------|
| **Volatile (vAMM)** | `x * y = k` | 0.2% | HYPE/USDC, HDROME/HYPE |
| **Stable (sAMM)** | `x³y + y³x = k` | 0.02% | USDC/USDT, ペッグペア |

すべてのプールには30分間の観測期間を持つ組み込み**TWAPオラクル**が含まれています。

## HyperEVM上に構築

| プロパティ | 値 |
|----------|-------|
| チェーン | HyperEVM |
| Chain ID | 999 |
| ネイティブトークン | HYPE |
| RPC | `https://rpc.hyperliquid.xyz/evm` |
| エクスプローラー | `https://explorer.hyperliquid.xyz` |

## はじめましょう

  ### アプリを起動
    取引、流動性提供、報酬獲得を始めましょう
  

  ### トークンをスワップ
    最適化されたマルチホップルーティングでトークンを取引
  

  ### 流動性を提供
    トークンペアを預けてゲージにステーキングしエミッションを獲得
  

  ### ロック & 投票
    HDROMEをロックしてveHDROMEを取得し、プロトコルエミッションを制御
  

## なぜHyperdrome？

* **AI ネイティブ**: 自然言語とスラッシュコマンドでDeFiの複雑さを処理する組み込みエージェント
* **実績あるコードベース**: Aerodrome/Velodromeのフォーク — 最も実戦検証されたve(3,3)実装
* **Autopilot** *（近日公開）*: 預けて放置 — AIがLP、ステーキング、投票、リバランス、複利運用を24時間365日管理
* **AI利用料$0**: Claude、GPT-4、Geminiへの無制限アクセス、ユーザーあたりの限界費用ゼロ
* **Bribe Optimizer** *（近日公開）*: B2Bツール — プロトコルが流動性目標を入力すると、AIが正確な賄賂額 + 予測ROIを出力

---

### トークノミクス

#### HDROMEトークン

URL: https://docs.hyperdrome.finance/ja/tokenomics/hdrome-token

HDROMEトークンはHyperliquid上のHyperdrome ve(3,3) DEXを支える — ロック、投票、獲得 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# HDROMEトークン

![${2}](${1})

## トークン詳細

| プロパティ | 値 |
|----------|-------|
| シンボル | HDROME |
| 小数点 | 18 |
| チェーン | HyperEVM (Chain ID 999) |
| 規格 | ERC-20 |
| 総供給量 | 1,000,000,000 |

## コアユーティリティ

HDROMEはHyperdromeプロトコルのネイティブトークンです。主なユーティリティ：

* **veHDROMEのためにロック** — HDROMEをロックしてERC-721 NFTとしてveHDROME投票権を取得
* **ガバナンス** — veHDROME保有者がプロトコルパラメータとエミッション配分を管理
* **ゲージ投票** — 週次HDROMEエミッションを選択した流動性プールに配分
* **取引手数料100%** — 投票者は投票したプールの取引手数料の100%を獲得
* **賄賂** — 流動性を求めるプロトコルが預けた外部賄賂を獲得
* **リベース** — 希薄化防止HDROMEリベースが長期ロッカーのエミッション希薄化を防止

---

## ロックメカニクス

![${2}](${1})

HDROMEをロックすると、ERC-721 NFT（veNFT）として表現される**veHDROME**ポジションが作成されます。投票権はロック期間にわたり線形に減衰します。

### ロックパラメータ

| パラメータ | 値 |
|-----------|-------|
| 最小ロック | 1週間 |
| 最大ロック | 4年間 |
| 減衰 | ロック期間にわたり線形 |
| 表現 | ERC-721 NFT (veNFT) |

### 投票権の計算式

```
votingPower = (lockAmount × lockDuration) / maxDuration
```

`maxDuration` = 4年間。ロック期間が長いほど、より多くの投票権を取得できます：

| ロック期間 | 投票権（ロック額に対する%） |
|---------------|----------------------------------|
| 4年間 | 100% |
| 2年間 | 50% |
| 1年間 | 25% |
| 6ヶ月 | 12.5% |

### veNFT管理

| アクション | 説明 |
|--------|-------------|
| **作成** | HDROMEをロックして選択した期間で新しいveNFTを発行 |
| **額の増加** | 既存のveNFTにHDROMEを追加 |
| **ロック延長** | ロック期間を延長して投票権を増加 |
| **統合** | 2つのveNFTを1つに統合（期間は調整） |
| **転送** | veNFTを別のウォレットに送信（ERC-721転送） |
| **引き出し** | ロック期限後にロック解除されたHDROMEを請求 |

  ロックされたHDROMEはロック期限が切れるまで引き出せません。投票権は線形に減衰します — 1,000 HDROMEの4年ロックは1,000 veHDROMEから始まり、期限切れ時に0に達します。完全な投票権を維持するためにロックを延長してください。

---

#### トークン配布とエミッション

URL: https://docs.hyperdrome.finance/ja/tokenomics/distribution-emissions

HDROMEトークンの配布とエミッションスケジュールの詳細 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# トークン配布とエミッション

## 総供給量: 1,000,000,000 HDROME

![${2}](${1})

| カテゴリ | 配分 | 数量 | 形式 | 詳細 |
|----------|-----------|--------|------|---------|
| **プロトコル** | 65% | 650,000,000 | HDROME | エミッション、流動性、プロトコル成長 |
| **プレセール** | 20% | 200,000,000 | HDROME | 詳細は近日公開 |
| **チーム＆コントリビューター** | 5% | 50,000,000 | veHDROME | ベスティングロック |
| **コミュニティエアドロップ** | 5% | 50,000,000 | veHDROME | MerkleClaimによる4年ロック |
| **マーケティング** | 5% | 50,000,000 | HDROME | 成長、パートナーシップ、インセンティブ |

  
    最大の配分はプロトコル自体のために確保されています。これにはLPに報酬を与えるゲージエミッション、プロトコル所有の流動性、将来のプロトコル成長イニシアチブが含まれます。この配分によりHyperdromeエコシステムの長期的な持続可能性が確保されます。
  
  
    プレセールラウンドに200,000,000 HDROMEが配分されています。詳細は近日発表されます。
  
  
    50,000,000 HDROMEがベスティングロック付きの**veHDROME**として配布されます。これによりチームのインセンティブが長期的なプロトコルの成功と一致します — チームはトークン売却ではなく、投票手数料と賄賂を通じて収益を得ます。
  
  
    50,000,000 HDROMEがMerkleClaimコントラクトによる4年ロック付きの**veHDROME**として配布されます。受取人は初日から即座に投票権と手数料収益を獲得します。
  
  
    50,000,000 HDROMEが成長イニシアチブ、戦略的パートナーシップ、KOLキャンペーン、エコシステムインセンティブに配分されています。
  

---

## エミッションスケジュール

![${2}](${1})

### 週次エミッション

エミッションは**週15,000,000 HDROME**から開始し、各エポックで約1%ずつ減衰します：

```
weekly_emission(n) = weekly_emission(n-1) × 990 / 1000
```

| 期間 | 週次エミッション | 累計発行量 |
|--------|----------------|--------------------|
| 第1週 | 15,000,000 | 15,000,000 |
| 第13週（約3ヶ月） | 13,100,000 | 約182,000,000 |
| 第26週（約6ヶ月） | 11,600,000 | 約338,000,000 |
| 第52週（約1年） | 8,950,000 | 約573,000,000 |
| 第104週（約2年） | 5,340,000 | 約831,000,000 |

  減衰後のエミッションが**循環供給量の0.2%**を下回ると、テールエミッションフロアが有効になり、最低エミッションレートを無期限に維持します。

### 週次配分の内訳

| 受取先 | シェア | 説明 |
|-----------|-------|-------------|
| **ゲージ** | 約96.7% | veHDROME投票ウェイトに基づき流動性プールに配布 |
| **チーム** | 約3% | チームアドレスに30ベーシスポイント（最大50 bps） |
| **リベース** | 変動 | RewardsDistributorを通じてveHDROME保有者への希薄化防止HDROME |

---

## エポックサイクル

![${2}](${1})

各エポックは**毎週木曜日 00:00 UTC**から次の木曜日まで実行されます：

  
    前回の投票が集計されます。Minterが減衰式に基づいて新しいエミッション量を計算します。
  
  
    MinterがHDROMEを発行します。Voterコントラクトが投票ウェイトに比例してゲージに配布します。RewardsDistributorがveHDROME保有者にリベースを送信します。
  
  
    veHDROME保有者がプール間で投票を配分します。各veNFTはエポックごとに1回投票できます。
  
  
    取引手数料と賄賂が投票者のために蓄積されます。LPエミッションはゲージステーカーに継続的にストリーミングされます。

---

#### veHDROMEと投票

URL: https://docs.hyperdrome.finance/ja/tokenomics/vehdrome-voting

veHDROME投票の仕組み — ゲージ配分、収益ストリーム、投票戦略 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# veHDROMEと投票

![${2}](${1})

## 投票フロー

各エポック（木曜日 00:00 UTCから木曜日 00:00 UTC）で、veHDROME保有者は流動性プールゲージに投票権を配分します。フローは以下の通りです：

1. **veHDROME保有者**が1つ以上のプールを選択し、投票ウェイト（パーセンテージベース）を割り当てます。
2. **Voterコントラクト**がエポック切替時にすべての投票を集計します。
3. **Minter**が週次HDROMEエミッションを発行し、投票シェアに比例してゲージに配布します。
4. **ゲージにステーキングされたLP**は、次のエポック中にHDROMEエミッションを秒単位で獲得します。
5. **投票者**は投票したプールの取引手数料の100%と外部賄賂を獲得します。

## ゲージシステム

| パラメータ | 値 |
|-----------|-------|
| ゲージあたりの最大リワードトークン数 | 16 |
| エポック期間 | 7日間（木曜日から木曜日 UTC） |
| エミッション発生 | 秒単位、ステーキングされたLPシェアに比例 |

---

## 収益ストリーム

![${2}](${1})

veHDROME投票者は3つの異なる収益ストリームから獲得します：

| ストリーム | ソース | 配布 |
|--------|--------|-------------|
| **取引手数料** | 投票したプールのスワップ手数料の100% | エポック切替後に請求可能 |
| **外部賄賂** | 投票を求めるプロトコルが預入 | エポック切替後に請求可能 |
| **リベース** | Minterからの希薄化防止HDROME | RewardsDistributorを通じてveHDROME保有者に自動配布 |

---

## 投票ルール

| ルール | 詳細 |
|------|--------|
| **エポックごとに1回** | 各veNFTはエポックごとに1回投票可能 |
| **切替まで固定** | 投票は一度行うとエポック全体でロックされる |
| **リセット必須** | veNFTの転送または統合前に投票をリセットする必要あり |
| **ポーク** | 誰でもveNFTをポークして既存の配分における減衰した投票権を更新可能 |

## 投票戦略

  
    現在の投票ウェイトに対して取引量が最も多いプールに投票してください。投票が少ない高取引量プールは、配分されたveHDROMEあたりの手数料がより多く発生します。各エポックで手数料/投票比率を確認し、ウェイトの低いプールを特定しましょう。
  
  
    アクティブな外部賄賂があるプールに投票してください。プロトコルは投票を集めるために賄賂を預入し、投票あたりの賄賂比率は手数料収入を大幅に上回る可能性があります。最良の機会を見つけるために、賄賂総額と現在の投票ウェイトを比較しましょう。
  
  
    特定のプロトコルのトークンの流動性を深めたい場合は、そのゲージに投票を集中させてください。これによりそのプールのLPへのHDROMEエミッションが増加し、より多くの流動性を引き付け、トークンのスプレッドが縮小します。
  

  投票は一度行うとエポック全体でロックされます。次のエポック切替まで投票を変更または取り消すことはできません。投票前に配分を慎重に計画してください。

---

#### プールと流動性

URL: https://docs.hyperdrome.finance/ja/tokenomics/pools-liquidity

HyperdromeのデュアルAMMプールアーキテクチャ、手数料構造、流動性提供 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# プールと流動性

![${2}](${1})

## プールアーキテクチャ

Hyperdromeは、異なる資産クラスに最適化された2種類のプールを持つ**デュアルAMM**設計を使用しています。PairFactoryはCREATE2により決定論的にプールをデプロイします。各プールには独自の手数料収集コントラクト（PairFees）があり、HDROMEエミッションのためのゲージを接続できます。すべてのプールには30分間の観測期間を持つ組み込みTWAPオラクルも含まれています。

### Volatileプール (vAMM)

| プロパティ | 値 |
|----------|-------|
| カーブ | `x * y = k`（コンスタントプロダクト） |
| デフォルト手数料 | 0.2% |
| 命名規則 | vAMM-TOKEN0/TOKEN1 |
| 最適な用途 | 非相関ペア（HYPE/USDC, HDROME/HYPE） |

### Stableプール (sAMM)

| プロパティ | 値 |
|----------|-------|
| カーブ | `x³y + y³x = k`（StableSwapバリアント） |
| デフォルト手数料 | 0.02% |
| 命名規則 | sAMM-TOKEN0/TOKEN1 |
| 最適な用途 | ペッグ/相関ペア（USDC/USDT, HYPE/stHYPE） |

---

## 手数料構造

| パラメータ | 詳細 |
|-----------|--------|
| Volatileプール手数料 | 0.2%（Fee Managerにより調整可能） |
| Stableプール手数料 | 0.02%（Fee Managerにより調整可能） |
| 手数料受取先 | そのプールのゲージのveHDROME投票者に100% |
| 手数料収集 | スワップごとにPairFeesコントラクトに収集 |

---

## スワップルーティング

Routerコントラクトは、あらゆるトークンスワップの最適パスを見つけます。利用可能なすべてのプール（VolatileとStableの両方）をチェックし、直接ペアが存在しない場合やマルチホップパスの方が良い執行を提供する場合にマルチホップルートを構築します。例えば、TOKEN_AからTOKEN_Bへのスワップは、スリッページが少ない場合TOKEN_A → HYPE → TOKEN_Bを経由してルーティングされる可能性があります。

---

## 流動性の提供

![${2}](${1})

  
    Volatile (vAMM) またはStable (sAMM) プールペアを選択します。Volatileプールは非相関資産に、Stableプールはペッグペアに適しています。
  
  
    現在のプール比率で両方のトークンを提供します。Routerが残余ダストを最小化するための計算を処理します。
  
  
    プールにおけるシェアを表すLPトークンを受け取ります。これらは自動的に取引手数料を蓄積します。
  
  
    LPトークンをプールのゲージに預け入れてHDROMEエミッションを獲得します。未ステーキングのLPはエミッションを獲得できません。
  

  預入後は必ずLPトークンをゲージにステーキングしてください。未ステーキングのLPポジションは取引手数料を獲得しますが、HDROMEエミッションを逃します — これが利回りの大部分を占めることが多いです。

---

## 組み込みオラクル

すべてのHyperdromeプールには30分間の観測期間を持つ**TWAP（時間加重平均価格）オラクル**が含まれています。これによりHyperEVM上の他のプロトコルが利用できる操作耐性のある価格フィードが提供されます。オラクルは累積価格観測を保存し、最大観測履歴までの任意のウィンドウでクエリできます。

---

#### 賄賂と報酬

URL: https://docs.hyperdrome.finance/ja/tokenomics/bribes-rewards

Hyperdromeエコシステムにおける賄賂、取引手数料、エミッション、リベースの流れ 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# 賄賂と報酬

![${2}](${1})

## 報酬フロー

Hyperdromeの報酬システムには、異なる参加者に流れる3つの異なるストリームがあります：

1. **LPエミッション** — Minterが各エポックでHDROMEを作成します。VoterコントラクトがveHDROME投票ウェイトに基づいてゲージに配布します。ゲージにステーキングされたLPは、ゲージにおけるシェアに比例して秒単位でこれらのエミッションを獲得します。

2. **取引手数料 + 外部賄賂 → 投票者** — 各プールの取引手数料の100%とそのプールのゲージに預入された外部賄賂は、投票したveHDROME保有者に流れます。各エポック切替後に請求可能です。

3. **リベース → veHDROME保有者** — RewardsDistributorが投票権に比例して、すべてのveHDROME保有者に希薄化防止HDROMEリベースを送信し、ロッカーのエミッション希薄化を防ぎます。

---

## 報酬タイプ

| 報酬 | 受取人 | ソース | タイミング |
|--------|-----------|--------|--------|
| **LPエミッション** | ゲージステーキングLP | 週次HDROME発行 | 秒単位で発生 |
| **取引手数料** | veHDROME投票者 | スワップ手数料の100% | エポック切替後に請求可能 |
| **外部賄賂** | veHDROME投票者 | プロトコル預入 | エポック切替後に請求可能 |
| **リベース** | 全veHDROME保有者 | Minter希薄化防止 | エポック切替時に配布 |

---

## 外部賄賂

![${2}](${1})

外部賄賂により、プロトコルはveHDROME投票者に特定のプールへのエミッション誘導を促すインセンティブを提供できます。これがプロトコルがHyperdrome上で深い流動性を獲得する主要なメカニズムです。

  
    プロトコルがエポック切替前に特定のゲージのExternalBribeコントラクトにトークンを預入します。
  
  
    エポック切替時に賄賂が投票者に見えるようになります。veHDROME保有者は現在のエポックの投票判断に賄賂の価値を考慮します。
  
  
    エポック終了後、そのゲージに投票を配分した投票者は、投票ウェイトに基づいて賄賂の比例配分を請求できます。
  

### 賄賂効率

* プロトコルは通常、賄賂に費やした$1ごとに$2-5の流動性を獲得
* 賄賂ROIはエポックにより変動 — 総投票ウェイトが低いほど投票あたりのリターンが高い
* 複数エポックにわたる一貫した賄賂提供が持続的な流動性の深さを構築
* ゲージあたり最大16種類のリワードトークンを賄賂として使用可能

---

## インターナル賄賂（取引手数料）

インターナル賄賂は外部当事者が預入するものではなく、各プールが生成する**取引手数料**です。スワップ手数料の100%がそのプールのゲージのInternalBribeコントラクトに自動的にルーティングされます。そのゲージに投票したveHDROME投票者が各エポック切替後にこれらの手数料を請求します。取引量の多いプールはより多くのインターナル賄賂を生成し、魅力的な投票先となります。

---

## リベース

リベースはRewardsDistributorコントラクトを通じてすべてのveHDROME保有者に配布される希薄化防止報酬です。各エポックで新しいHDROMEが発行されると、投票権の希薄化を防ぐため、比例した量がリベースとして配布されます。リベース量はロックされたHDROMEと総循環供給量の比率に応じてスケールします — ロックが多いほどリベースが高くなります。

---

## 報酬の請求

| 報酬タイプ | 請求先 | 頻度 |
|-------------|---------------|-----------|
| LPエミッション | Gaugeコントラクト | いつでも（秒単位で発生） |
| 取引手数料 | InternalBribeコントラクト | 各エポック切替後 |
| 外部賄賂 | ExternalBribeコントラクト | 各エポック切替後 |
| リベース | RewardsDistributor | 各エポック切替後 |

  Hyperdromeエージェントの`/claim`スラッシュコマンドを使用して、すべてのポジションの保留中の報酬を単一のトランザクションで請求できます。

---

#### デプロイ済みコントラクト

URL: https://docs.hyperdrome.finance/ja/tokenomics/deployed-contracts

Hyperdromeエコシステムのデプロイ済みスマートコントラクトとその機能一覧 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# デプロイ済みコントラクト

## ネットワーク情報

| パラメータ | 値 |
|-----------|-------|
| ネットワーク | Hyperliquid EVM |
| Chain ID | `999` |
| RPC URL | `https://rpc.hyperliquid.xyz/evm` |
| エクスプローラー | `https://explorer.hyperliquid.xyz` |
| ネイティブトークン | HYPE |

## コアコントラクト（HyperEVMメインネット）

| コントラクト | アドレス |
|----------|---------|
| HDROME Token | `TBD` |
| VotingEscrow (veHDROME) | `TBD` |
| Voter | `TBD` |
| Router | `TBD` |
| PairFactory | `TBD` |
| GaugeFactory | `TBD` |
| BribeFactory | `TBD` |
| Minter | `TBD` |
| RewardsDistributor | `TBD` |
| MerkleClaim | `TBD` |
| VeArtProxy | `TBD` |
| HyperdromeLibrary | `TBD` |

  コントラクトアドレスはメインネットデプロイ後にここに公開されます。すべてのコントラクトはHyperliquid Explorerで検証されます。

## 既知のトークンアドレス

| トークン | アドレス | 小数点 |
|-------|---------|----------|
| WHYPE (Wrapped HYPE) | `0x5555555555555555555555555555555555555555` | 18 |
| USDC | `0xb88339CB7199b77E23DB6E890353E22632Ba630f` | 6 |
| USDT0 | `0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb` | 6 |

## コントラクトアーキテクチャ

| レイヤー | コントラクト | 目的 |
|-------|-----------|---------|
| **AMMコア** | Pair, PairFees, PairFactory, Router | トークンスワップ、流動性、手数料収集 |
| **トークン＆ロック** | Hyperdrome, VotingEscrow, VeArtProxy | HDROMEトークン、veNFTの作成と管理 |
| **投票＆ゲージ** | Voter, Gauge, InternalBribe, ExternalBribe | エミッション投票、LPステーキング、賄賂配布 |
| **エミッション** | Minter, RewardsDistributor | 週次発行、リベース配布 |
| **ファクトリー** | PairFactory, GaugeFactory, BribeFactory | 決定論的コントラクトデプロイ |
| **ガバナンス** | L2Governor, HyperdromeGovernor (Multisig) | オンチェーン提案、タイムロック実行 |
| **エアドロップ** | MerkleClaim | マークルツリーエアドロップ（4年間veHDROMEロック） |

  やり取りする前に必ずコントラクトアドレスを確認してください。この公式ドキュメントまたはHyperdromeアプリに記載されているアドレスのみを使用してください。

---

#### セキュリティ

URL: https://docs.hyperdrome.finance/ja/tokenomics/security

Hyperdromeのセキュリティ対策と監査履歴 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# セキュリティ

![${2}](${1})

## コードベースの継承

Hyperdromeは、DeFiにおいて最も実戦検証されたve(3,3)実装の一つである**Velodrome/Solidly**コードベース上に構築されています：

* **Solidly** — Andre CronjeによるFantom上のオリジナルve(3,3) AMM
* **Velodrome** — Optimism上の改良版フォーク、OP上でTVL最大のDEX

## 監査

| 監査 | スコープ | レポート |
|-------|-------|--------|
| Solidly監査 | コアAMM、VotingEscrow、Minter | リポジトリで公開 |
| Velodrome監査 | プロトコル全体のレビュー | リポジトリで公開 |

## スマートコントラクトセキュリティ

### アクセス制御

| ロール | 権限 |
|------|------------|
| **Governor** | トークンのホワイトリスト登録、ゲージの作成、プロトコルパラメータ設定 |
| **Emergency Council** | 緊急時のゲージの停止/復活 |
| **Fee Manager** | プールごとの取引手数料率の調整 |
| **Pauser** | 緊急時の全スワップの一時停止 |

### タイムロック

**HyperdromeGovernor**マルチシグには関数ごとのタイムロックが含まれています：

* 関数セレクター/宛先コンボごとのカスタム遅延
* バッチトランザクション実行のサポート
* 0xのZeroExGovernorパターンに基づく

### 主要なセキュリティ特性

* **不変のMinter割り当て** — `setMinter()`はHDROMEトークンで1回のみ呼び出し可能
* **CREATE2決定論的デプロイ** — Pairアドレスが予測可能かつ検証可能
* **veNFTアタッチメントシステム** — ゲージにステーキング中のveNFTの転送を防止
* **エポックロック投票** — エポック中の投票変更不可、操作を防止
* **TWAPオラクル** — 30分間の観測期間が価格操作に耐性

## Solidityバージョン

すべてのコントラクトは標準的なオーバーフロー/アンダーフロー保護付きの**Solidity 0.8.13**でコンパイルされています。

## テストスイート

プロトコルには以下をカバーする**21個のFoundryテストファイル**が含まれています：

* AMMペアのメカニクスと手数料会計
* veNFTのロック/アンロック/統合操作
* エミッション計算と減衰スケジュール
* ゲージステーキングと報酬配布
* 投票メカニクスとエポック遷移
* 緊急時のゲージ停止/復活
* マークルクレームのエアドロップ配布
* オンチェーンガバナンス提案
* ウォッシュトレード防止
* オラクルの精度とエッジケース

---

### エージェント

#### エージェント概要

URL: https://docs.hyperdrome.finance/ja/agentic/overview

Hyperdromeエージェント — Hyperliquid上のve(3,3) DEXのためのAIネイティブインターフェース 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# Hyperdromeエージェント

![${2}](${1})

## AIを搭載したDEXではない — DEXを持つAIエージェント

HyperdromeはAIファーストに構築されています。エージェントは取引インターフェースに後付けされたチャットボットではなく、エージェント**そのもの**がインターフェースです。すべてのDeFiアクション（スワップ、LP、ロック、投票、請求）は、自然言語の会話またはスラッシュコマンドでアクセスできます。従来のUIはフォールバックとして存在しますが、エージェントがユーザーがプロトコルとやり取りする主要な方法です。

---

## アーキテクチャ

Hyperdromeエージェントは、LLMルーティングレイヤーを使用してユーザーの意図を解釈し、オンチェーンアクションにマッピングします。ユーザーがメッセージを送信すると、エージェントは：

1. **意図を解析** — LLMがメッセージを分析し、ユーザーが何をしたいかを判断（スワップ、LP、投票、ポートフォリオ確認など）
2. **コンテキストを収集** — オンチェーン状態（ウォレット残高、プールデータ、veNFTポジション、保留中の報酬）とオフチェーンデータ（価格、TVL、APR）を読み取る
3. **レスポンスを生成** — 提案されるアクション、パラメータ、期待される結果を示すリッチUIカード付きの自然言語説明を生成
4. **承認後に実行** — ユーザーが確認すると、エージェントがトランザクションを構築し送信

エージェントは複数のLLMバックエンド（Claude、GPT-4、Gemini）をユーザーへの費用なしでサポートしています。

---

## Chat-to-DeFi

ユーザーは会話形式のプロンプトでプロトコル全体と対話できます：

* *「100 USDCをHYPEにスワップして」*
* *「保留中の報酬は？」*
* *「1000 HDROMEを4年間ロックして」*
* *「すべてのveHDROMEをHYPE/USDCプールに投票して」*
* *「今一番利回りが良いのは？」*

エージェントがルーティング、スリッページ、ガス見積もり、トランザクション構築をバックグラウンドで処理します。

---

## スラッシュコマンド

| コマンド | アクション |
|---------|--------|
| `/swap` | 最適化されたルーティングでトークンをスワップ |
| `/lp` | プールへの流動性追加または削除 |
| `/vote` | ゲージ間でveHDROME投票を配分 |
| `/lock` | HDROMEをロックしてveNFTを作成または延長 |
| `/claim` | 保留中の全報酬を請求（エミッション、手数料、賄賂） |
| `/help` | 利用可能なコマンドと使い方を表示 |

---

## リッチUIカード

エージェントはすべてのアクションにインタラクティブなカードを表示します — テキストだけのレスポンスではありません。カードには以下が表示されます：

* **スワップカード** — トークンペア、数量、プライスインパクト、ルートパス、スリッページ許容値
* **LPカード** — プールペア、TVL、APR、自分のシェア、預入額
* **投票カード** — ゲージリスト、現在の投票ウェイト、予測される手数料/賄賂収益
* **ポートフォリオカード** — トークン残高、LPポジション、veNFT詳細、保留中の報酬
* **報酬カード** — 請求可能なエミッション、手数料、賄賂のUSD値を含む内訳

---

## 実行可能なアクション

| カテゴリ | アクション |
|----------|---------|
| **取引** | トークンスワップ、マルチホップルーティング、スリッページ設定 |
| **流動性** | 流動性追加、流動性削除、ゲージにステーキング、ゲージからアンステーキング |
| **ロック** | veNFT作成、ロック額増加、ロック期間延長、veNFT統合 |
| **投票** | ゲージへの投票、投票リセット、古い投票のポーク |
| **報酬** | エミッション請求、手数料請求、賄賂請求、リベース請求 |
| **ポートフォリオ** | 残高確認、ポジション確認、保留中の報酬確認、利回り推奨の取得 |

---

## スマートサジェスション

エージェントはウォレットの状態に基づき、最適化の機会を積極的に提示します：

| 優先度 | トリガー | 提案 |
|----------|---------|------------|
| **高** | 未ステーキングのLPトークンを検出 | エミッション獲得のためゲージにステーキング |
| **高** | 未請求の報酬 > $10 | 保留中の報酬を請求して複利運用 |
| **高** | veNFTが7日以内に期限切れ | 投票権維持のためロックを延長 |
| **中** | LP/ロック外の遊休トークン > $10 | 流動性提供またはveHDROMEのためにロック |
| **中** | 投票配分が最適でない | より高利回りのゲージへ投票をリバランス |
| **低** | 新しい高APRプールが利用可能 | トレンドプールへのLP検討 |

---

## LLM非依存アーキテクチャ

Hyperdromeエージェントは**単一のAIプロバイダーに縛られていません**。アーキテクチャは意図解析、コンテキスト収集、実行を独立したレイヤーに分離しています — そのためLLMバックエンドは他を変更せずに交換できます。

| レイヤー | 役割 | LLM必要？ |
|-------|------|---------------|
| **Intent Parser** | ユーザーの意図を理解 | はい — 任意のLLM |
| **Context Gatherer** | オンチェーン＋オフチェーンデータの読み取り | いいえ |
| **Responder** | 説明＋UIカードの生成 | はい — 任意のLLM |
| **Executor** | トランザクションの構築と送信 | いいえ |

現在**Claude**、**GPT-4**、**Gemini**をインテリジェントルーティングでサポート。オープンソースモデル（Llama、Mistral、Qwen）とBring Your Own LLMはロードマップにあります。

  ### LLM 統合
    マルチモデルサポート、ルーティング、Bring Your Own LLM
  

  ### MCP サーバー
    MCPであらゆるAIアシスタントをHyperdromeに接続
  

  ### エージェントフレームワーク
    GOAT SDK, Wayfinder, Eliza, Olas, REST API
  

---

## 多言語サポート

エージェントはユーザーの言語でレスポンスします。英語、中国語、日本語、韓国語、スペイン語、フランス語、ポルトガル語、トルコ語、ロシア語、アラビア語、その他の言語でのプロンプトは、基盤となるLLMの機能によりネイティブにサポートされています。UIラベルとスラッシュコマンドは英語のままですが、すべての会話レスポンスはユーザーの言語に適応します。

---

#### LLM 統合

URL: https://docs.hyperdrome.finance/ja/agentic/llm-integrations

HyperdromeがあらゆるLLMに接続する方法 — Claude、GPT-4、Gemini、Llama、Mistralなど 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# LLM 統合

![${2}](${1})

## 設計からLLM非依存

Hyperdromeは単一のAIプロバイダーに縛られていません。エージェントアーキテクチャは**意図解析**、**コンテキスト収集**、**実行**を独立したレイヤーに分離しています — そのためLLMバックエンドは他を変更せずに交換できます。

これは、Hyperdromeが今日のあらゆる大規模言語モデルで動作し、明日リリースされるあらゆるモデルでも動作することを意味します。

---

## サポートモデル

  ### Claude
    Opus, Sonnet, Haiku — **稼働中**
  

  ### GPT-4
    GPT-4o, GPT-4, GPT-4 Turbo — **稼働中**
  

  ### Gemini
    Gemini 2.5 Pro, 2.5 Flash — **稼働中**
  

  ### オープンソース
    Llama, Mistral, Qwen, DeepSeek — *予定*
  

  すべてのモデルはユーザーに**無料**で提供されます。Hyperdromeが推論コストを負担します。

---

## アーキテクチャ

エージェントパイプラインはすべてのステージでモデル非依存です：

```
User Input (natural language or /command)
        │
        ▼
┌──────────────────┐
│  Intent Parser   │ ← Any LLM (Claude, GPT-4, Gemini, Llama...)
│  "What does the  │
│   user want?"    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Context Gatherer │ ← On-chain + off-chain data (no LLM needed)
│  Wallet, pools,  │
│  prices, APRs    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Responder     │ ← Any LLM (generates explanation + UI cards)
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Executor      │ ← Transaction builder (no LLM needed)
│  Build tx, sign, │
│  submit on-chain │
└──────────────────┘
```

LLMが関与するのは2つのステップのみです：ユーザーが何を望んでいるかの理解と、結果の説明。それ以外のすべて — ブロックチェーン状態の読み取り、トランザクション構築、オンチェーン送信 — は決定論的なコードです。

---

## インテリジェントルーティング

バックエンドは以下の要素に基づいて各リクエストに最適なモデルを自動選択します：

| 要素 | ロジック |
|--------|-------|
| **複雑さ** | シンプルなクエリ（価格確認、残高）→ 最速モデル。複雑なマルチステップアクション → 最高性能モデル。 |
| **言語** | 一部のモデルは特定の言語でより優れたパフォーマンスを発揮。ルーターはユーザーの検出された言語に最適化。 |
| **レイテンシ** | プライマリモデルが遅いか利用不可の場合、ルーターは500ms以内に次善のオプションにフォールバック。 |
| **コスト** | ルーターはすべてのユーザーに推論を無料で維持するため、性能とコストのバランスを取る。 |

---

## Bring Your Own LLM *（近日公開）*

  この機能はロードマップにあり、まだ利用できません。

ユーザーが自身のLLMプロバイダーを接続できるようになります：

* **API Key** — 自身のOpenAI、Anthropic、Google、またはOpenAI互換APIキーを接続
* **セルフホストモデル** — Llama、Mistral、Qwen、その他のオープンソースモデルを実行する自身のOllama、vLLM、またはTGIエンドポイントにエージェントを接続
* **カスタムシステムプロンプト** — エージェントの性格、リスク許容度、レスポンススタイルをカスタマイズ
* **完全なプライバシー** — 自身のモデル使用時、データはHyperdromeの推論サーバーを通過しない

### 互換エンドポイント

OpenAI Chat Completions API形式を実装するすべてのエンドポイントが動作します：

| Runtime | Example Models |
|---------|---------------|
| **Ollama** | Llama 3.3, Mistral, Qwen 2.5, DeepSeek V3, Gemma |
| **vLLM** | Any HuggingFace model |
| **TGI** | Any HuggingFace model |
| **Together AI** | Llama, Mixtral, Qwen |
| **Groq** | Llama, Mixtral, Gemma |
| **Fireworks** | Llama, Mixtral, DeepSeek |

---

## LLM非依存が重要な理由

1. **ベンダーロックインなし** — プロバイダーが価格を上げたり、品質を低下させたり、制限を追加しても、Hyperdromeはシームレスに切り替えます。

2. **最適なモデルを適材適所で** — モデルごとに得意な分野が異なります。ルーティングにより、Hyperdromeは各リクエストに最適なツールを使用できます。

3. **将来への対応** — 新しいモデルは毎月リリースされます。LLM非依存アーキテクチャにより、Hyperdromeは書き換えなしに即座に導入できます。

4. **ユーザー主権** — Bring Your Own LLMにより、ユーザーがデータと推論を制御。中央集権的なAIプロバイダーへの依存なし。

5. **検閲耐性** — オープンソースモデルは停止や制限ができません。自身のLlamaやMistralインスタンスを運用するユーザーは完全な自律性を持ちます。

---

#### MCP サーバー

URL: https://docs.hyperdrome.finance/ja/agentic/mcp-server

HyperdromeのModel Context Protocolサーバー — あらゆるAIアシスタントをve(3,3) DEXに接続 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# MCP サーバー

![${2}](${1})

  Hyperdrome MCPサーバーはロードマップにあり、まだライブではありません。このページは計画中の仕様を文書化しています。

## MCPとは？

**Model Context Protocol (MCP)** はAnthropicによるオープンスタンダードで、AIアシスタントが外部サーバー上のツールを発見して呼び出すことを可能にします。JSON-RPC 2.0を使用します — アシスタントが`tools/list`を呼び出して利用可能なアクションを発見し、`tools/call`で実行します。

MCPは**Claude Desktop**、**Cursor**、**Opencode**、**Windsurf**、および増加中のAIコーディング・チャットツールでサポートされています。

---

## なぜDeFiにMCPか？

現在、DeFiとのインタラクションには以下が必要です：
1. ブラウザを開く
2. ウォレットを接続
3. 複雑なUIをナビゲート
4. スリッページ、ルーティング、ガスを理解

HyperdromeのMCPサーバーを使用すれば、あらゆるAIアシスタントが**直接**トークンをスワップし、利回りを確認し、ゲージに投票し、ポジションを管理できます — ユーザーが好みのツールを離れることなく。

> *「Hyperdromeで500 USDCをHYPEにスワップして」* — Claude Desktop、Cursor、またはあらゆるMCPクライアントに入力。

---

## 利用可能なツール

MCPサーバーはHyperdromeプロトコル全体を呼び出し可能なツールとして公開します：

### Trading

| Tool | Description | Parameters |
|------|-------------|------------|
| `swap` | Swap tokens with optimized multi-hop routing | `fromToken`, `toToken`, `amount`, `slippageBps?` |
| `get_quote` | Get a swap quote without executing | `fromToken`, `toToken`, `amount` |

### Liquidity

| Tool | Description | Parameters |
|------|-------------|------------|
| `add_liquidity` | Deposit token pair into a pool | `tokenA`, `tokenB`, `amountA`, `amountB`, `stable` |
| `remove_liquidity` | Withdraw from a pool | `tokenA`, `tokenB`, `stable`, `liquidity` |
| `stake_lp` | Stake LP tokens in a gauge | `pool`, `amount` |
| `unstake_lp` | Unstake LP tokens from a gauge | `pool`, `amount` |

### Locking & Voting

| Tool | Description | Parameters |
|------|-------------|------------|
| `lock` | Lock HDROME to create or extend a veNFT | `amount`, `duration` |
| `vote` | Allocate veHDROME votes across gauges | `tokenId`, `pools[]`, `weights[]` |
| `reset_votes` | Reset votes for a veNFT | `tokenId` |

### Rewards

| Tool | Description | Parameters |
|------|-------------|------------|
| `claim_rewards` | Claim all pending rewards | `tokenId?` |
| `claim_fees` | Claim trading fees for a specific gauge | `gauge` |
| `claim_bribes` | Claim external bribes | `gauge`, `tokens[]` |

### Read-Only

| Tool | Description | Parameters |
|------|-------------|------------|
| `get_pools` | List all pools with TVL, APR, volume | `sortBy?`, `limit?` |
| `get_portfolio` | Full wallet analysis | `address` |
| `get_yields` | Top yield opportunities | `limit?`, `minTvl?` |
| `get_venft` | Get veNFT details | `tokenId` |
| `get_pending_rewards` | Check unclaimed rewards | `address` |

---

## ツールスキーマの例

各ツールは入力用のJSON Schemaと共にMCP仕様に従います：

```json
{
  "name": "swap",
  "description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromToken": {
        "type": "string",
        "description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
      },
      "toToken": {
        "type": "string",
        "description": "Token symbol or address to buy (e.g. 'HYPE')"
      },
      "amount": {
        "type": "string",
        "description": "Amount to swap in human-readable units (e.g. '100')"
      },
      "slippageBps": {
        "type": "number",
        "description": "Max slippage in basis points (default: 50 = 0.5%)"
      }
    },
    "required": ["fromToken", "toToken", "amount"]
  }
}
```

---

## 接続

### Claude Desktop / Cursor / Opencode

MCP設定に追加：

```json
{
  "mcpServers": {
    "hyperdrome": {
      "url": "https://mcp.hyperdrome.finance/sse"
    }
  }
}
```

### セルフホスト

MCPサーバーはオープンソースになる予定です。自身のインスタンスを実行：

```bash
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
```

---

## セキュリティモデル

| 特性 | 詳細 |
|----------|--------|
| **デフォルトで読み取り専用** | ポートフォリオクエリとプールデータはウォレット接続不要 |
| **トランザクション承認** | すべての書き込み操作はユーザーがレビューし署名する未署名トランザクションを返却 |
| **秘密鍵なし** | ホストされたMCPサーバーは秘密鍵に触れない。署名はクライアント側で実行 |
| **Rate Limiting** | 不正利用防止のためのIP別およびAPIキー別のレート制限 |
| **Audit Trail** | すべてのツール呼び出しはタイムスタンプ、パラメータ、結果と共に記録 |

  MCPサーバーはユーザーに代わってトランザクションを実行することはありません。トランザクションを構築し、明示的な承認のために返却します — 他のDeFiフロントエンドと同様です。

---

## ユースケース

| シナリオ | 方法 |
|----------|-----|
| **DeFiダッシュボードを構築する開発者** | MCPツールでプール、利回り、ポジションをクエリ |
| **AIコーディングアシスタント** | 「Hyperdromeの全報酬を請求するスクリプトを書いて」 — アシスタントが`get_pending_rewards`の後に`claim_rewards`を呼び出し |
| **自律エージェント** | ポートフォリオ管理エージェントが毎時利回りを確認し、`add_liquidity` / `remove_liquidity`でリバランス |
| **チャットボット** | Telegramボットでユーザーが自然言語でスワップ、ポートフォリオ確認、投票が可能 |
| **リサーチ** | アナリストが`get_pools`をクエリしてHyperEVM DEX間の利回り比較を構築 |

---

#### エージェントフレームワーク統合

URL: https://docs.hyperdrome.finance/ja/agentic/agent-frameworks

HyperdromeがGOAT SDK、Wayfinder、Eliza、Olas、およびより広いAIエージェントエコシステムと統合する方法 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# エージェントフレームワーク統合

![${2}](${1})

Hyperdromeは、自社のエージェントだけでなく、**あらゆるAIエージェント**からアクセスできるよう設計されています。プロトコルは複数の統合レイヤーを通じて機能を公開し、サードパーティのエージェント、フレームワーク、プラットフォームがHyperdromeとネイティブにインタラクションできるようにしています。

  ### GOAT SDK
    200以上のツール、13以上のフレームワークアダプター
  
  ### MCP
    Claude Desktop, Cursor, Opencode
  
  ### Wayfinder
    AIネイティブDeFiターミナル
  
  ### Eliza
    自律型ソーシャル + DeFiエージェント
  
  ### Olas
    分散型自律エージェント
  
  ### REST API
    直接HTTPエンドポイント
  

---

## 統合アーキテクチャ

```
┌─────────────────────────────────────────────────┐
│              AI Agent Frameworks                 │
│  Claude · GPT · Gemini · Llama · Mistral · ...  │
├─────────────────────────────────────────────────┤
│              Adapter Layer                       │
│  GOAT SDK · Wayfinder · Eliza · LangChain ·     │
│  Vercel AI · MCP · REST API                     │
├─────────────────────────────────────────────────┤
│           Hyperdrome Protocol Layer              │
│  Intent Parser → Context → Tx Builder → Chain   │
├─────────────────────────────────────────────────┤
│                 HyperEVM                         │
│  Router · Voter · Gauges · VotingEscrow · ...   │
└─────────────────────────────────────────────────┘
```

アダプターレイヤーのいずれかをサポートするフレームワークであれば、Hyperdromeとインタラクションできます。カスタム統合コードは不要です。

---

## GOAT SDK Plugin

  GOAT SDK Pluginはロードマップにあり、まだ公開されていません。

**GOAT SDK**は最大のエージェンティック金融ツールキットです — 200以上のツール、15以上のチェーン、13以上のフレームワークアダプター。Uniswap、Aave、1inch、BalancerなどのプロトコルがすでにGOATプラグインを持っています。

Hyperdromeはプロトコル全体をカバーする`@goat-sdk/plugin-hyperdrome`を公開予定です：

### 提供アクション

| Action | Description |
|--------|-------------|
| `swap` | Swap tokens with optimized routing |
| `addLiquidity` | Deposit into volatile or stable pools |
| `removeLiquidity` | Withdraw from pools |
| `stakeLp` | Stake LP tokens in gauges |
| `unstakeLp` | Unstake from gauges |
| `lock` | Lock HDROME → veHDROME (create/extend veNFT) |
| `vote` | Allocate votes across gauges |
| `claimRewards` | Claim emissions, fees, bribes, rebases |
| `getPools` | List pools with TVL, APR, volume |
| `getPortfolio` | Full wallet analysis |

### フレームワークリーチ

GOATプラグイン公開後、Hyperdromeは以下のフレームワークで自動的に利用可能になります：

| Framework | Type |
|-----------|------|
| **Vercel AI SDK** | Full-stack AI apps |
| **LangChain** | Agent orchestration (Python & JS) |
| **LlamaIndex** | Data-augmented agents |
| **MCP** | Claude Desktop, Cursor, Opencode |
| **Eliza** | Autonomous social + DeFi agents |
| **CrewAI** | Multi-agent systems |
| **Mastra** | TypeScript agent framework |
| **GAME (Virtuals)** | Gaming + DeFi agents |
| **OpenAI Agents SDK** | OpenAI's native agent runtime |
| **ZerePy** | Python agent framework |
| **AutoGen** | Microsoft's multi-agent framework |
| **Olas** | Decentralized autonomous agents |

---

## Wayfinder Paths

  Wayfinder統合はロードマップにあり、まだ利用できません。

**Wayfinder**は独自SDK（Paths）を持つAIネイティブDeFiターミナルです。すでにHyperliquid無期限先物、Aave V3、Morpho、Pendle、Uniswap V3をサポートしています。

Hyperdromeは以下を可能にする**Wayfinder Protocolアダプター**を公開予定です：

* Wayfinder Shells（AI取引インターフェース）を通じたスワップ、LP、投票、ロック
* 戦略コンポジション — Hyperdrome利回りをクロスプロトコル戦略と組み合わせ
* MCPブリッジ — Wayfinder内蔵のMCPサーバーがHyperdromeツールを公開

---

## Eliza (ElizaOS)

**Eliza**は自律型暗号資産エージェントのための主要なオープンソースフレームワークです。Twitter、Telegram、オンチェーンで動作するソーシャル＋DeFiボットを駆動します。

GOATプラグインを通じたHyperdrome統合（`@elizaos/plugin-goat`）：

* ElizaエージェントがHyperdromeでスワップ、LP、投票、請求が可能
* 自律型イールドファーミング — APRを監視しポジションをリバランスするエージェント
* ソーシャル＋DeFi — 利回りアップデートを投稿し、コミュニティの質問に答え、取引を実行するエージェント

---

## Olas (Autonolas)

**Olas**は自律型AIエージェントを共同所有・運用するための分散型プラットフォームです。3,600以上のエージェントがデプロイ済み、1,700万以上のトランザクション。

Hyperdrome統合パス：

* Hyperdromeポジションを管理する**Olas Agent Service**の構築
* Olasマーケットプレイスで**Mech**として登録 — 他のエージェントがHyperdromeアクションを依頼可能
* 既存のOlasエージェントと組み合わせてクロスプロトコル戦略を構成

---

## REST API

  公開REST APIはロードマップにあり、まだ利用できません。

フレームワークなしで直接統合したい開発者向け：

### 計画中のエンドポイント

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/api/pools` | List all pools with TVL, APR, fees, volume |
| `GET` | `/api/pools/:address` | Pool details |
| `GET` | `/api/portfolio/:wallet` | Full portfolio analysis |
| `GET` | `/api/yields` | Top yield opportunities |
| `POST` | `/api/quote` | Get a swap quote |
| `POST` | `/api/swap` | Build a swap transaction |
| `POST` | `/api/liquidity/add` | Build an add-liquidity transaction |
| `POST` | `/api/liquidity/remove` | Build a remove-liquidity transaction |
| `POST` | `/api/lock` | Build a lock transaction |
| `POST` | `/api/vote` | Build a vote transaction |
| `POST` | `/api/claim` | Build a claim-all transaction |

### レスポンス形式

すべての書き込みエンドポイントは未署名のトランザクションデータを返却します：

```json
{
  "tx": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "chainId": 999,
    "gasLimit": "250000"
  },
  "summary": {
    "action": "Swap 100 USDC → 1.62 HYPE",
    "priceImpact": "0.03%",
    "route": ["USDC", "HYPE"],
    "minReceived": "1.611 HYPE"
  }
}
```

  APIは秘密鍵を必要としません。すべてのトランザクションはクライアント側での署名のために未署名で返却されます。

---

## LangChain Tool

LangChainを直接使用するPython開発者向け：

```python
from langchain.tools import tool

@tool
def hyperdrome_swap(from_token: str, to_token: str, amount: str) -> str:
    """Swap tokens on Hyperdrome (HyperEVM). Returns unsigned transaction."""
    # Calls Hyperdrome REST API
    ...
```

GOAT SDKアダプターがこれを自動的に処理しますが、開発者はREST APIに対するカスタムLangChainツールを構築することもできます。

---

## 独自統合の構築

Hyperdromeをエージェント、ボット、アプリに統合したいですか？

1. **最速** — GOAT SDK Pluginを使用。13以上のフレームワークですぐに動作。
2. **最も柔軟** — REST APIを直接使用。あらゆる言語でトランザクションを構築し署名。
3. **AIネイティブ** — MCPで接続。Claude Desktop、Cursor、Opencode、あらゆるMCPクライアントで動作。
4. **自律型** — 完全に分散化されたオンチェーンエージェント実行のためのOlas Agent Serviceを構築。

すべての統合レイヤーは未署名トランザクションを返却します — アプリが署名と送信を処理。Hyperdromeは秘密鍵に触れることはありません。

---

#### エージェントの機能とロードマップ

URL: https://docs.hyperdrome.finance/ja/agentic/capabilities

Hyperdromeエージェントの全機能、データソース、今後のリリース予定 正確な値、実行フロー、HyperEVM の参照情報を Hyperdrome ユーザー向けに含みます。

# エージェントの機能とロードマップ

## ライブデータソース

| ソース | データ | 更新頻度 |
|--------|------|--------|
| **HyperEVM RPC** | ウォレット残高、LPポジション、veNFT詳細、ゲージステーキング、保留中の報酬 | リアルタイム |
| **CoinGecko** | HYPE、USDC、USDT、BTC、ETH、SOLの価格 + 24時間変動 + 時価総額 + 取引量 | 60秒キャッシュ |
| **DeFiLlama** | Hyperliquid L1チェーンTVL、TVL/カテゴリ/7日間変動の上位20プロトコル | 60秒キャッシュ |
| **Hyperliquid API** | 全スポットトークンのマーク価格、24時間取引量、循環供給量 | 60秒キャッシュ |
| **プロトコルコントラクト** | プールリザーブ、TVL、APR、投票ウェイト、賄賂額、エミッションレート | リアルタイム |

## ウォレット分析

ウォレット接続時に、エージェントが詳細なポートフォリオ分析を実行します：

* **トークン残高**とUSD値（価値順にソート）
* **遊休資本の検出** — LP/ロック外のトークン > $10
* **LPポジション** — ペア、Stable/Volatile、ステーキング済み/未ステーキング、TVL、APR、ゲージアドレス
* **未ステーキングLPの検出** — エミッションを獲得していないLP
* **veNFT** — ロック額、期限、残日数、期限切れ/期限切れ間近フラグ、投票権、投票状態
* **保留中の報酬** — エミッション、賄賂、手数料 — ペアごとの内訳とUSD合計
* **APR上位10プール**（推奨用）

## ロードマップ

| 機能 | ステータス |
|---------|--------|
| Chat-to-DeFi（Web） | **リリース済み** |
| スラッシュコマンド | **リリース済み** |
| リッチUIカード | **リリース済み** |
| スマートサジェスション | **リリース済み** |
| Multi-LLM Backend (Claude, GPT-4, Gemini) | **リリース済み** |
| Telegram Super-Agent | **開発中** |
| MCP Server | 計画中 |
| GOAT SDK Plugin | 計画中 |
| Public REST API | 計画中 |
| Wayfinder Integration | 計画中 |
| Bring Your Own LLM | 計画中 |
| Autopilot | 計画中 |
| Content Machine | 計画中 |
| ダイナミック veNFT PFP | 計画中 |
| Bribe Optimizer | 計画中 |
| Yield Reports | 計画中 |
| AI Treasury | 計画中 |

### Autopilot *（近日公開）*

「預けて放置」 — エージェントがDeFiポジション全体を自動管理します。

| リスクプロファイル | 目標APY | 戦略 |
|-------------|-----------|----------|
| **保守的** | 8-15% | Stableプール、最大ロック、優良ペア |
| **バランス** | 15-30% | Stable/Volatileミックス、中期ロック |
| **積極的** | 30-80% | Volatileプール、賄賂ファーミング、アクティブリバランス |
| **Degen** | 50-200% | 新規プール、最大賄賂キャプチャ、短期ロック |

エージェントが処理する内容：LPポジション管理、ゲージステーキング、veHDROME投票、報酬請求、複利再投資、リバランス — すべてユーザーの介入なしに24時間365日稼働。

**収益モデル**: Autopilot利回りに対する5%のパフォーマンスフィー。

### Telegram Super-Agent *（近日公開）*

Hyperdromeの全機能を提供する単一ボット：
* スワップ、利回り、ポートフォリオ、請求、Autopilot
* 教育、アラート、ミーム生成
* PFP生成、賄賂分析、利回りレポート

### Bribe Optimizer *（近日公開）*

プロトコル向けB2Bツール：
* 入力：流動性目標（例：「TOKEN/HYPEに$500K TVL」）
* 出力：正確な賄賂額、予測ROI、推奨エポックタイミング
* 賄賂効率を時系列で追跡

### ダイナミック veNFT PFP *（近日公開）*

以下に基づいて進化するAI生成プロフィール画像：
* ロック期間と金額
* 投票活動と連続投票
* 獲得した総利回り
* プロトコル在籍期間

### AI Treasury *（近日公開）*

自律的なトレジャリー管理：
* AIがエポックごとにトレジャリーの最大30%を配分
* 実行の12時間前に意思決定を公開
* コミュニティ拒否権メカニズム
* 完全なオンチェーン透明性

## プライバシー

* 接続されたウォレットの公開オンチェーンデータのみを読み取り
* セッション間でウォレットデータを保存しない
* 会話はサーバー側で保持されない

---

## ar - Arabic

### البداية

#### مقدمة

URL: https://docs.hyperdrome.finance/ar/introduction

مرحباً بكم في Hyperdrome - منصة التداول اللامركزية الذكية ve(3,3) على Hyperliquid يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

## ما هو Hyperdrome؟

Hyperdrome هو **منصة التداول اللامركزية الذكية ve(3,3)** على Hyperliquid. يجمع بين صانع سوق آلي مُجرّب (مُشتق من Aerodrome/Velodrome) ووكيل ذكاء اصطناعي يتولى عمليات التبديل والسيولة والتصويت وتحسين العائدات من خلال اللغة الطبيعية.

المنتج **ليس منصة تداول لامركزية مع ذكاء اصطناعي — بل هو وكيل ذكاء اصطناعي مع منصة تداول لامركزية.**

## نظام ve(3,3)

يُنشئ نموذج ve(3,3) دورة مستدامة يستفيد فيها كل مشارك من التعاون:

![${2}](${1})

### المكونات الأساسية

1. **التصويت المُقفل (ve)**
   * قفل HDROME للحصول على قوة تصويت veHDROME (حتى 4 سنوات)
   * فترة قفل أطول = قوة تصويت أكبر، تتناقص خطياً
   * يُمثَّل المركز المُقفل كرمز NFT بمعيار ERC-721

2. **نظرية الألعاب (3,3)**
   * التعاون هو الاستراتيجية المُثلى لجميع المشاركين
   * يكسب المصوّتون 100% من رسوم التداول + الحوافز الخارجية
   * إعادة التوازن المضادة للتخفيف تحمي المُقفلين على المدى الطويل

### الفوائد

* **انبعاثات مستدامة**: تناقص أسبوعي بنسبة ~1% مع حد أدنى عند 0.2% من العرض المتداول
* **قوة التصويت**: توزيع أسبوعي مباشر للانبعاثات عبر المقاييس
* **توزيع الرسوم**: 100% من رسوم التداول لمصوّتي veHDROME
* **سوق الحوافز**: تحصل البروتوكولات على السيولة بجزء بسيط من تكاليف التحفيز المباشر

## تصميم AMM المزدوج

| نوع المجمع | المنحنى | الرسوم الافتراضية | الأفضل لـ |
|-----------|-------|-------------|----------|
| **متقلب (vAMM)** | `x * y = k` | 0.2% | HYPE/USDC, HDROME/HYPE |
| **مستقر (sAMM)** | `x³y + y³x = k` | 0.02% | USDC/USDT, الأزواج المرتبطة |

يتضمن كل مجمع **أوراكل TWAP** مدمج مع فترات مراقبة مدتها 30 دقيقة.

## مبني على HyperEVM

| الخاصية | القيمة |
|----------|-------|
| السلسلة | HyperEVM |
| معرّف السلسلة | 999 |
| الرمز الأصلي | HYPE |
| RPC | `https://rpc.hyperliquid.xyz/evm` |
| المستكشف | `https://explorer.hyperliquid.xyz` |

## البدء

  ### تشغيل التطبيق
    ابدأ التداول وتوفير السيولة وكسب المكافآت
  

  ### تبديل الرموز
    تداول الرموز مع توجيه مُحسَّن متعدد القفزات
  

  ### توفير السيولة
    أودع أزواج الرموز وقم بالتخزين في المقاييس للحصول على الانبعاثات
  

  ### القفل والتصويت
    اقفل HDROME للحصول على veHDROME وتوجيه انبعاثات البروتوكول
  

## لماذا Hyperdrome؟

* **أصلي للذكاء الاصطناعي**: وكيل مدمج يتعامل مع تعقيدات DeFi عبر اللغة الطبيعية وأوامر الشرطة المائلة
* **قاعدة شفرة مُجرّبة**: مُشتق من Aerodrome/Velodrome — أكثر تطبيقات ve(3,3) اختباراً
* **الطيار الآلي** *(قريباً)*: أودع واسترخِ — الذكاء الاصطناعي يدير LP والتخزين والتصويت وإعادة التوازن والمضاعفة على مدار الساعة
* **تكلفة ذكاء اصطناعي $0**: وصول غير محدود إلى Claude و GPT-4 و Gemini بتكلفة هامشية صفرية لكل مستخدم
* **مُحسّن الحوافز** *(قريباً)*: أداة B2B — تُدخل البروتوكولات هدف السيولة، ويُخرج الذكاء الاصطناعي مبلغ الحافز الدقيق + العائد المتوقع على الاستثمار

---

### اقتصاد الرمز

#### رمز HDROME

URL: https://docs.hyperdrome.finance/ar/tokenomics/hdrome-token

يُشغّل رمز HDROME منصة التداول اللامركزية ve(3,3) على Hyperliquid — اقفل وصوّت واكسب يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# رمز HDROME

![${2}](${1})

## تفاصيل الرمز

| الخاصية | القيمة |
|----------|-------|
| الرمز | HDROME |
| الكسور العشرية | 18 |
| السلسلة | HyperEVM (Chain ID 999) |
| المعيار | ERC-20 |
| العرض الإجمالي | 1,000,000,000 |

## الاستخدامات الأساسية

HDROME هو الرمز الأصلي لبروتوكول Hyperdrome. استخداماته الرئيسية:

* **القفل للحصول على veHDROME** — اقفل HDROME للحصول على قوة تصويت veHDROME كرمز NFT بمعيار ERC-721
* **الحوكمة** — يحكم حاملو veHDROME معايير البروتوكول وتخصيص الانبعاثات
* **التصويت على المقاييس** — وجّه انبعاثات HDROME الأسبوعية إلى مجمعات السيولة التي تختارها
* **100% من رسوم التداول** — يكسب المصوّتون 100% من رسوم التداول من المجمعات التي صوّتوا لها
* **الحوافز** — اكسب حوافز خارجية تودعها البروتوكولات الباحثة عن السيولة
* **إعادة التوازن** — إعادة توازن HDROME المضادة للتخفيف تحمي المُقفلين على المدى الطويل من تخفيف الانبعاثات

---

## آليات القفل

![${2}](${1})

يُنشئ قفل HDROME مركز **veHDROME** مُمثّلاً كرمز NFT بمعيار ERC-721 (veNFT). تتناقص قوة التصويت خطياً على مدار فترة القفل.

### معايير القفل

| المعيار | القيمة |
|-----------|-------|
| الحد الأدنى للقفل | أسبوع واحد |
| الحد الأقصى للقفل | 4 سنوات |
| التناقص | خطي على مدار فترة القفل |
| التمثيل | ERC-721 NFT (veNFT) |

### معادلة قوة التصويت

```
votingPower = (lockAmount × lockDuration) / maxDuration
```

حيث `maxDuration` = 4 سنوات. كلما طالت فترة القفل، زادت قوة التصويت التي تحصل عليها:

| فترة القفل | قوة التصويت (% من المبلغ المُقفل) |
|---------------|----------------------------------|
| 4 سنوات | 100% |
| سنتان | 50% |
| سنة واحدة | 25% |
| 6 أشهر | 12.5% |

### إدارة veNFT

| الإجراء | الوصف |
|--------|-------------|
| **إنشاء** | اقفل HDROME لسكّ veNFT جديد بالمدة المختارة |
| **زيادة المبلغ** | أضف المزيد من HDROME إلى veNFT موجود |
| **تمديد القفل** | مدّد فترة القفل لزيادة قوة التصويت |
| **الدمج** | ادمج اثنين من veNFTs في واحد (يتم توفيق الفترات) |
| **النقل** | أرسل veNFT الخاص بك إلى محفظة أخرى (نقل ERC-721) |
| **السحب** | اطلب HDROME المُفتقل بعد انتهاء فترة القفل |

  لا يمكن سحب HDROME المُقفل حتى انتهاء فترة القفل. تتناقص قوة التصويت خطياً — قفل لمدة 4 سنوات بقيمة 1,000 HDROME يبدأ عند 1,000 veHDROME ويصل إلى 0 عند الانتهاء. مدّد قفلك للحفاظ على قوة التصويت الكاملة.

---

#### توزيع الرموز والانبعاثات

URL: https://docs.hyperdrome.finance/ar/tokenomics/distribution-emissions

تفصيل مُفصّل لتوزيع رمز HDROME وجدول الانبعاثات يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# توزيع الرموز والانبعاثات

## العرض الإجمالي: 1,000,000,000 HDROME

![${2}](${1})

| الفئة | التخصيص | المبلغ | الشكل | التفاصيل |
|----------|-----------|--------|------|---------|
| **البروتوكول** | 65% | 650,000,000 | HDROME | الانبعاثات والسيولة ونمو البروتوكول |
| **البيع المسبق** | 20% | 200,000,000 | HDROME | التفاصيل قريباً |
| **الفريق والمساهمون** | 5% | 50,000,000 | veHDROME | أقفال استحقاق |
| **الإسقاط الجوي للمجتمع** | 5% | 50,000,000 | veHDROME | قفل 4 سنوات عبر MerkleClaim |
| **التسويق** | 5% | 50,000,000 | HDROME | النمو والشراكات والحوافز |

  
    أكبر تخصيص محجوز للبروتوكول نفسه. يشمل ذلك انبعاثات المقاييس لمكافأة مزودي السيولة، والسيولة المملوكة للبروتوكول، ومبادرات نمو البروتوكول المستقبلية. يضمن هذا التخصيص الاستدامة طويلة الأمد لنظام Hyperdrome البيئي.
  
  
    200,000,000 HDROME مخصصة لجولة البيع المسبق. سيتم الإعلان عن مزيد من التفاصيل قريباً.
  
  
    50,000,000 HDROME موزعة كـ **veHDROME** مع أقفال استحقاق. هذا يُوائم حوافز الفريق مع نجاح البروتوكول على المدى الطويل — يكسب الفريق من خلال رسوم التصويت والحوافز، وليس من خلال بيع الرموز.
  
  
    50,000,000 HDROME موزعة كـ **veHDROME** مع أقفال لمدة 4 سنوات عبر عقد MerkleClaim. يحصل المستلمون فوراً على قوة التصويت وإيرادات الرسوم من اليوم الأول.
  
  
    50,000,000 HDROME مخصصة لمبادرات النمو والشراكات الاستراتيجية وحملات صناع الرأي وحوافز النظام البيئي.
  

---

## جدول الانبعاثات

![${2}](${1})

### الانبعاثات الأسبوعية

تبدأ الانبعاثات عند **15,000,000 HDROME في الأسبوع** وتتناقص بنسبة 1% تقريباً كل حقبة:

```
weekly_emission(n) = weekly_emission(n-1) × 990 / 1000
```

| الفترة | الانبعاث الأسبوعي | الإجمالي التراكمي |
|--------|----------------|--------------------|
| الأسبوع 1 | 15,000,000 | 15,000,000 |
| الأسبوع 13 (~3 أشهر) | 13,100,000 | ~182,000,000 |
| الأسبوع 26 (~6 أشهر) | 11,600,000 | ~338,000,000 |
| الأسبوع 52 (~سنة واحدة) | 8,950,000 | ~573,000,000 |
| الأسبوع 104 (~سنتان) | 5,340,000 | ~831,000,000 |

  عندما ينخفض الانبعاث المتناقص إلى أقل من **0.2% من العرض المتداول**، يتم تفعيل الحد الأدنى للانبعاث الذيلي للحفاظ على معدل انبعاث أدنى إلى أجل غير مسمى.

### تقسيم التوزيع الأسبوعي

| المستلم | الحصة | الوصف |
|-----------|-------|-------------|
| **المقاييس** | ~96.7% | يُوزّع على مجمعات السيولة بناءً على أوزان تصويت veHDROME |
| **الفريق** | ~3% | 30 نقطة أساس لعنوان الفريق (بحد أقصى 50 نقطة أساس) |
| **إعادة التوازن** | متغير | HDROME مضاد للتخفيف لحاملي veHDROME عبر RewardsDistributor |

---

## دورة الحقبة

![${2}](${1})

تمتد كل حقبة من **الخميس 00:00 بتوقيت UTC** إلى الخميس التالي:

  
    يتم حصر الأصوات السابقة. يحسب عقد Minter مبلغ الانبعاث الجديد بناءً على معادلة التناقص.
  
  
    يسكّ عقد Minter رموز HDROME. يوزّع عقد Voter على المقاييس بما يتناسب مع أوزان التصويت. يرسل RewardsDistributor إعادة التوازن لحاملي veHDROME.
  
  
    يخصص حاملو veHDROME أصواتهم عبر المجمعات. يمكن لكل veNFT التصويت مرة واحدة لكل حقبة.
  
  
    تتراكم رسوم التداول والحوافز للمصوّتين. تتدفق انبعاثات LP باستمرار إلى المُخزّنين في المقاييس.

---

#### veHDROME والتصويت

URL: https://docs.hyperdrome.finance/ar/tokenomics/vehdrome-voting

كيف يعمل تصويت veHDROME — تخصيص المقاييس، تدفقات الإيرادات، واستراتيجيات التصويت يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# veHDROME والتصويت

![${2}](${1})

## تدفق التصويت

في كل حقبة (من الخميس 00:00 UTC إلى الخميس 00:00 UTC)، يخصص حاملو veHDROME قوتهم التصويتية عبر مقاييس مجمعات السيولة. يعمل التدفق كالتالي:

1. **حاملو veHDROME** يختارون مجمعاً واحداً أو أكثر ويحددون أوزان التصويت (على أساس النسبة المئوية).
2. يحصر **عقد Voter** جميع الأصوات عند تحوّل الحقبة.
3. يسكّ **عقد Minter** انبعاث HDROME الأسبوعي ويوزّعه على المقاييس بما يتناسب مع حصة أصواتها.
4. **مزودو السيولة المُخزّنون في المقاييس** يكسبون انبعاثات HDROME خلال الحقبة التالية على أساس كل ثانية.
5. **المصوّتون** يكسبون 100% من رسوم التداول والحوافز الخارجية من المجمعات التي صوّتوا لها.

## نظام المقاييس

| المعيار | القيمة |
|-----------|-------|
| الحد الأقصى لرموز المكافآت لكل مقياس | 16 |
| مدة الحقبة | 7 أيام (من الخميس إلى الخميس بتوقيت UTC) |
| تراكم الانبعاثات | كل ثانية، بما يتناسب مع حصة LP المُخزّنة |

---

## تدفقات الإيرادات

![${2}](${1})

يكسب مصوّتو veHDROME من ثلاثة تدفقات إيرادات مختلفة:

| التدفق | المصدر | التوزيع |
|--------|--------|-------------|
| **رسوم التداول** | 100% من رسوم التبديل من المجمعات المُصوَّت لها | قابلة للمطالبة بعد تحوّل الحقبة |
| **الحوافز الخارجية** | مُودَعة من البروتوكولات الباحثة عن أصوات | قابلة للمطالبة بعد تحوّل الحقبة |
| **إعادة التوازن** | HDROME مضاد للتخفيف من عقد Minter | يُوزّع تلقائياً لحاملي veHDROME عبر RewardsDistributor |

---

## قواعد التصويت

| القاعدة | التفاصيل |
|------|--------|
| **مرة واحدة لكل حقبة** | يمكن لكل veNFT التصويت مرة واحدة لكل حقبة |
| **مُقفل حتى التحوّل** | الأصوات مُقفلة طوال الحقبة بمجرد الإدلاء بها |
| **إعادة التعيين مطلوبة** | يجب إعادة تعيين الأصوات قبل نقل أو دمج veNFTs |
| **التحديث** | يمكن لأي شخص تحديث veNFT لتحديث قوة التصويت المتناقصة في التخصيصات الحالية |

## استراتيجيات التصويت

  
    صوّت للمجمعات ذات أعلى حجم تداول مقارنة بوزن التصويت الحالي. المجمعات ذات الحجم العالي وعدد الأصوات الأقل تُولّد رسوماً أكثر لكل veHDROME مُخصص. تحقق من نسبة الرسوم/التصويت في كل حقبة لتحديد المجمعات ذات الوزن المنخفض.
  
  
    صوّت للمجمعات ذات الحوافز الخارجية النشطة. تودع البروتوكولات حوافز لجذب الأصوات، ويمكن أن تتجاوز نسبة الحافز لكل صوت إيرادات الرسوم بشكل كبير. قارن إجمالي قيمة الحوافز بوزن التصويت الحالي لإيجاد أفضل الفرص.
  
  
    إذا كنت تريد تعميق السيولة لرمز بروتوكول معين، ركّز الأصوات على مقياسه. هذا يوجّه المزيد من انبعاثات HDROME إلى مزودي سيولة ذلك المجمع، مما يجذب المزيد من السيولة ويُضيّق الفارق السعري للرمز.
  

  الأصوات مُقفلة طوال الحقبة بمجرد الإدلاء بها. لا يمكنك تغيير أو سحب تصويتك حتى تحوّل الحقبة التالية. خطط لتخصيصك بعناية قبل التصويت.

---

#### المجمعات والسيولة

URL: https://docs.hyperdrome.finance/ar/tokenomics/pools-liquidity

بنية مجمعات AMM المزدوجة في Hyperdrome، هيكل الرسوم، وتوفير السيولة يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# المجمعات والسيولة

![${2}](${1})

## بنية المجمعات

يستخدم Hyperdrome تصميم **AMM مزدوج** مع نوعين من المجمعات مُحسَّنين لفئات أصول مختلفة. ينشر PairFactory المجمعات بشكل حتمي عبر CREATE2. لكل مجمع عقد تحصيل رسوم خاص به (PairFees) ويمكن أن يُرفق به مقياس لانبعاثات HDROME. يتضمن كل مجمع أيضاً أوراكل TWAP مدمج مع فترات مراقبة مدتها 30 دقيقة.

### المجمعات المتقلبة (vAMM)

| الخاصية | القيمة |
|----------|-------|
| المنحنى | `x * y = k` (حاصل ضرب ثابت) |
| الرسوم الافتراضية | 0.2% |
| اصطلاح التسمية | vAMM-TOKEN0/TOKEN1 |
| الأفضل لـ | الأزواج غير المترابطة (HYPE/USDC, HDROME/HYPE) |

### المجمعات المستقرة (sAMM)

| الخاصية | القيمة |
|----------|-------|
| المنحنى | `x³y + y³x = k` (متغير StableSwap) |
| الرسوم الافتراضية | 0.02% |
| اصطلاح التسمية | sAMM-TOKEN0/TOKEN1 |
| الأفضل لـ | الأزواج المرتبطة/المتلازمة (USDC/USDT, HYPE/stHYPE) |

---

## هيكل الرسوم

| المعيار | التفاصيل |
|-----------|--------|
| رسوم المجمع المتقلب | 0.2% (قابلة للتعديل من قبل مدير الرسوم) |
| رسوم المجمع المستقر | 0.02% (قابلة للتعديل من قبل مدير الرسوم) |
| مستلم الرسوم | 100% لمصوّتي veHDROME لمقياس ذلك المجمع |
| تحصيل الرسوم | يتم تحصيلها لكل عملية تبديل في عقد PairFees |

---

## توجيه التبديل

يجد عقد Router المسار الأمثل لأي عملية تبديل رموز. يفحص جميع المجمعات المتاحة (المتقلبة والمستقرة) ويبني مسارات متعددة القفزات عندما لا يوجد زوج مباشر أو عندما يوفّر المسار متعدد القفزات تنفيذاً أفضل. على سبيل المثال، قد يتم توجيه تبديل TOKEN_A إلى TOKEN_B عبر TOKEN_A → HYPE → TOKEN_B إذا نتج عنه انزلاق سعري أقل.

---

## توفير السيولة

![${2}](${1})

  
    اختر زوج مجمع متقلب (vAMM) أو مستقر (sAMM). المجمعات المتقلبة تناسب الأصول غير المترابطة؛ المجمعات المستقرة تناسب الأزواج المرتبطة.
  
  
    وفّر كلا الرمزين في الزوج بنسبة المجمع الحالية. يتعامل Router مع الحسابات لتقليل البقايا.
  
  
    تحصل على رموز LP تمثل حصتك من المجمع. تتراكم رسوم التداول تلقائياً.
  
  
    أودع رموز LP الخاصة بك في مقياس المجمع لكسب انبعاثات HDROME. مراكز LP غير المُخزّنة لا تكسب أي انبعاثات.
  

  قم دائماً بتخزين رموز LP الخاصة بك في المقياس بعد الإيداع. مراكز LP غير المُخزّنة تكسب رسوم تداول لكنها تفوّت انبعاثات HDROME — التي غالباً ما تمثل غالبية العائد.

---

## الأوراكل المدمج

يتضمن كل مجمع في Hyperdrome **أوراكل TWAP (متوسط السعر المرجح بالوقت)** مع فترات مراقبة مدتها 30 دقيقة. يوفّر هذا تغذيات أسعار مقاومة للتلاعب يمكن أن تستهلكها بروتوكولات أخرى على HyperEVM. يخزّن الأوراكل ملاحظات الأسعار التراكمية ويمكن الاستعلام عنه لأي نافذة تصل إلى الحد الأقصى لسجل الملاحظات.

---

#### الحوافز والمكافآت

URL: https://docs.hyperdrome.finance/ar/tokenomics/bribes-rewards

كيف تتدفق الحوافز ورسوم التداول والانبعاثات وإعادة التوازن عبر نظام Hyperdrome البيئي يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# الحوافز والمكافآت

![${2}](${1})

## تدفق المكافآت

يمتلك نظام مكافآت Hyperdrome ثلاثة تدفقات مختلفة تصل إلى مشاركين مختلفين:

1. **انبعاثات LP** — يُنشئ عقد Minter رموز HDROME كل حقبة. يوزّعها عقد Voter على المقاييس بناءً على أوزان تصويت veHDROME. يكسب مزودو السيولة المُخزّنون في المقاييس هذه الانبعاثات على أساس كل ثانية بما يتناسب مع حصتهم من المقياس.

2. **رسوم التداول + الحوافز الخارجية ← المصوّتون** — 100% من رسوم التداول من كل مجمع وأي حوافز خارجية مُودَعة لمقياس ذلك المجمع تتدفق إلى حاملي veHDROME الذين صوّتوا لها. وهي قابلة للمطالبة بعد كل تحوّل حقبة.

3. **إعادة التوازن ← حاملو veHDROME** — يرسل RewardsDistributor إعادة توازن HDROME المضادة للتخفيف لجميع حاملي veHDROME بما يتناسب مع قوتهم التصويتية، مما يحمي المُقفلين من تخفيف الانبعاثات.

---

## أنواع المكافآت

| المكافأة | المستلم | المصدر | التوقيت |
|--------|-----------|--------|--------|
| **انبعاثات LP** | مزودو السيولة المُخزّنون في المقاييس | سكّ HDROME الأسبوعي | تراكم كل ثانية |
| **رسوم التداول** | مصوّتو veHDROME | 100% من رسوم التبديل | قابلة للمطالبة بعد تحوّل الحقبة |
| **الحوافز الخارجية** | مصوّتو veHDROME | إيداعات البروتوكولات | قابلة للمطالبة بعد تحوّل الحقبة |
| **إعادة التوازن** | جميع حاملي veHDROME | مضاد تخفيف من Minter | يُوزّع عند تحوّل الحقبة |

---

## الحوافز الخارجية

![${2}](${1})

تسمح الحوافز الخارجية للبروتوكولات بتحفيز مصوّتي veHDROME لتوجيه الانبعاثات نحو مجمعات محددة. هذه هي الآلية الأساسية للبروتوكولات للحصول على سيولة عميقة على Hyperdrome.

  
    يودع بروتوكول رموزاً في عقد ExternalBribe لمقياس محدد قبل تحوّل الحقبة.
  
  
    عند تحوّل الحقبة، يصبح الحافز مرئياً للمصوّتين. يأخذ حاملو veHDROME قيمة الحافز في الاعتبار عند اتخاذ قرارات التصويت للحقبة الحالية.
  
  
    بعد انتهاء الحقبة، يمكن للمصوّتين الذين خصصوا أصواتاً لذلك المقياس المطالبة بحصتهم النسبية من الحافز بناءً على وزن تصويتهم.
  

### كفاءة الحوافز

* تحصل البروتوكولات عادةً على $2-5 من السيولة مقابل كل $1 يُنفق على الحوافز
* يختلف عائد الاستثمار على الحوافز حسب الحقبة — وزن تصويت إجمالي أقل يعني عوائد أعلى لكل صوت
* التحفيز المستمر عبر عدة حقب يبني عمق سيولة مستدام
* يمكن استخدام ما يصل إلى 16 رمز مكافأة مختلف كحوافز لكل مقياس

---

## الحوافز الداخلية (رسوم التداول)

الحوافز الداخلية لا تُودَع من أطراف خارجية — بل هي **رسوم التداول** التي يولّدها كل مجمع. يتم توجيه 100% من رسوم التبديل تلقائياً إلى عقد InternalBribe لمقياس ذلك المجمع. يطالب مصوّتو veHDROME الذين صوّتوا للمقياس بهذه الرسوم بعد كل تحوّل حقبة. المجمعات ذات الحجم الأعلى تولّد حوافز داخلية أكثر، مما يجعلها أهدافاً جذابة للتصويت.

---

## إعادة التوازن

إعادة التوازن هي مكافآت مضادة للتخفيف تُوزّع على جميع حاملي veHDROME عبر عقد RewardsDistributor. عندما يتم سكّ HDROME جديد كل حقبة، يتم توزيع مبلغ نسبي كإعادة توازن لمنع تخفيف قوة التصويت. يتناسب مبلغ إعادة التوازن مع نسبة HDROME المُقفل إلى إجمالي العرض المتداول — المزيد من القفل يعني إعادة توازن أعلى.

---

## المطالبة بالمكافآت

| نوع المكافأة | مكان المطالبة | التكرار |
|-------------|---------------|-----------|
| انبعاثات LP | عقد المقياس | في أي وقت (تتراكم كل ثانية) |
| رسوم التداول | عقد InternalBribe | بعد كل تحوّل حقبة |
| الحوافز الخارجية | عقد ExternalBribe | بعد كل تحوّل حقبة |
| إعادة التوازن | RewardsDistributor | بعد كل تحوّل حقبة |

  استخدم أمر الشرطة المائلة `/claim` في وكيل Hyperdrome للمطالبة بجميع المكافآت المعلقة عبر جميع المراكز في معاملة واحدة.

---

#### العقود المنشورة

URL: https://docs.hyperdrome.finance/ar/tokenomics/deployed-contracts

قائمة العقود الذكية المنشورة ووظائفها في نظام Hyperdrome البيئي يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# العقود المنشورة

## معلومات الشبكة

| المعيار | القيمة |
|-----------|-------|
| الشبكة | Hyperliquid EVM |
| معرّف السلسلة | `999` |
| عنوان RPC | `https://rpc.hyperliquid.xyz/evm` |
| المستكشف | `https://explorer.hyperliquid.xyz` |
| الرمز الأصلي | HYPE |

## العقود الأساسية (شبكة HyperEVM الرئيسية)

| العقد | العنوان |
|----------|---------|
| HDROME Token | `TBD` |
| VotingEscrow (veHDROME) | `TBD` |
| Voter | `TBD` |
| Router | `TBD` |
| PairFactory | `TBD` |
| GaugeFactory | `TBD` |
| BribeFactory | `TBD` |
| Minter | `TBD` |
| RewardsDistributor | `TBD` |
| MerkleClaim | `TBD` |
| VeArtProxy | `TBD` |
| HyperdromeLibrary | `TBD` |

  سيتم نشر عناوين العقود هنا بعد النشر على الشبكة الرئيسية. سيتم التحقق من جميع العقود على مستكشف Hyperliquid.

## عناوين الرموز المعروفة

| الرمز | العنوان | الكسور العشرية |
|-------|---------|----------|
| WHYPE (Wrapped HYPE) | `0x5555555555555555555555555555555555555555` | 18 |
| USDC | `0xb88339CB7199b77E23DB6E890353E22632Ba630f` | 6 |
| USDT0 | `0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb` | 6 |

## بنية العقود

| الطبقة | العقود | الغرض |
|-------|-----------|---------|
| **نواة AMM** | Pair, PairFees, PairFactory, Router | تبديل الرموز، السيولة، تحصيل الرسوم |
| **الرمز والقفل** | Hyperdrome, VotingEscrow, VeArtProxy | رمز HDROME، إنشاء وإدارة veNFT |
| **التصويت والمقاييس** | Voter, Gauge, InternalBribe, ExternalBribe | تصويت الانبعاثات، تخزين LP، توزيع الحوافز |
| **الانبعاثات** | Minter, RewardsDistributor | السكّ الأسبوعي، توزيع إعادة التوازن |
| **المصانع** | PairFactory, GaugeFactory, BribeFactory | نشر العقود الحتمي |
| **الحوكمة** | L2Governor, HyperdromeGovernor (Multisig) | المقترحات على السلسلة، التنفيذ المؤجل |
| **الإسقاط الجوي** | MerkleClaim | إسقاط جوي بشجرة Merkle (أقفال veHDROME لمدة 4 سنوات) |

  تحقق دائماً من عناوين العقود قبل التفاعل. استخدم فقط العناوين المدرجة في هذه الوثائق الرسمية أو تطبيق Hyperdrome.

---

#### الأمان

URL: https://docs.hyperdrome.finance/ar/tokenomics/security

تدابير الأمان في Hyperdrome وسجل التدقيق يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# الأمان

![${2}](${1})

## إرث قاعدة الشفرة

بُني Hyperdrome على قاعدة شفرة **Velodrome/Solidly**، إحدى أكثر تطبيقات ve(3,3) اختباراً في DeFi:

* **Solidly** — أول AMM بنظام ve(3,3) من Andre Cronje على Fantom
* **Velodrome** — نسخة مُحسّنة على Optimism، أكبر منصة تداول لامركزية من حيث TVL على OP

## التدقيقات

| التدقيق | النطاق | التقرير |
|-------|-------|--------|
| تدقيق Solidly | نواة AMM، VotingEscrow، Minter | متاح في المستودع |
| تدقيقات Velodrome | مراجعة كاملة للبروتوكول | متاح في المستودع |

## أمان العقود الذكية

### التحكم في الوصول

| الدور | الصلاحيات |
|------|------------|
| **الحاكم** | إدراج الرموز في القائمة البيضاء، إنشاء المقاييس، معايير البروتوكول |
| **مجلس الطوارئ** | إيقاف/إحياء المقاييس في حالات الطوارئ |
| **مدير الرسوم** | تعديل معدلات رسوم التداول لكل مجمع |
| **المُوقف** | إيقاف جميع عمليات التبديل في حالة الطوارئ |

### القفل الزمني

يتضمن **HyperdromeGovernor** متعدد التوقيعات أقفالاً زمنية لكل وظيفة:

* تأخير مُخصص لكل مُحدد وظيفة / وجهة
* دعم تنفيذ المعاملات المُجمّعة
* مبني على نمط ZeroExGovernor من 0x

### خصائص الأمان الرئيسية

* **تعيين Minter غير قابل للتغيير** — يمكن استدعاء `setMinter()` مرة واحدة فقط على رمز HDROME
* **نشر حتمي عبر CREATE2** — عناوين الأزواج قابلة للتنبؤ والتحقق
* **نظام ربط veNFT** — يمنع نقل veNFTs أثناء التخزين في المقاييس
* **أصوات مُقفلة بالحقبة** — لا يمكن تغيير الأصوات أثناء الحقبة، مما يمنع التلاعب
* **أوراكل TWAP** — فترات مراقبة مدتها 30 دقيقة تقاوم التلاعب بالأسعار

## إصدار Solidity

جميع العقود مُجمّعة باستخدام **Solidity 0.8.13** مع حماية قياسية من الفيض الحسابي.

## مجموعة الاختبارات

يتضمن البروتوكول **21 ملف اختبار Foundry** تغطي:

* آليات أزواج AMM ومحاسبة الرسوم
* عمليات قفل/فتح/دمج veNFT
* حسابات الانبعاثات وجداول التناقص
* التخزين في المقاييس وتوزيع المكافآت
* آليات التصويت وانتقالات الحقب
* إيقاف/إحياء المقاييس في حالات الطوارئ
* توزيع الإسقاط الجوي عبر شجرة Merkle
* مقترحات الحوكمة على السلسلة
* الحماية من التداول الوهمي
* دقة الأوراكل والحالات الحدية

---

### الوكيل الذكي

#### نظرة عامة على الوكيل الذكي

URL: https://docs.hyperdrome.finance/ar/agentic/overview

وكيل Hyperdrome — واجهة أصلية للذكاء الاصطناعي لمنصة التداول اللامركزية ve(3,3) على Hyperliquid يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# وكيل Hyperdrome

![${2}](${1})

## ليس منصة تداول لامركزية مع ذكاء اصطناعي — بل وكيل ذكاء اصطناعي مع منصة تداول لامركزية

بُني Hyperdrome بأولوية الذكاء الاصطناعي. الوكيل ليس روبوت محادثة مُلحقاً بواجهة تداول — بل **هو** الواجهة. كل إجراء في DeFi (التبديل، توفير السيولة، القفل، التصويت، المطالبة) متاح من خلال محادثة باللغة الطبيعية أو أوامر الشرطة المائلة. الواجهة التقليدية موجودة كبديل احتياطي، لكن الوكيل هو الطريقة الأساسية التي يتفاعل بها المستخدمون مع البروتوكول.

---

## البنية المعمارية

يستخدم وكيل Hyperdrome طبقة توجيه LLM لتفسير نية المستخدم وربطها بإجراءات على السلسلة. عندما يرسل المستخدم رسالة، يقوم الوكيل بـ:

1. **تحليل النية** — يحلل LLM الرسالة لتحديد ما يريد المستخدم فعله (تبديل، توفير سيولة، تصويت، فحص المحفظة، إلخ.)
2. **جمع السياق** — يقرأ حالة السلسلة (أرصدة المحفظة، بيانات المجمعات، مراكز veNFT، المكافآت المعلقة) والبيانات خارج السلسلة (الأسعار، TVL، معدلات العائد السنوي)
3. **توليد الاستجابة** — ينتج شرحاً باللغة الطبيعية مع بطاقات واجهة غنية تعرض الإجراء المقترح والمعايير والنتائج المتوقعة
4. **التنفيذ عند الموافقة** — عندما يؤكد المستخدم، يبني الوكيل المعاملة (المعاملات) ويرسلها

يدعم الوكيل عدة خلفيات LLM (Claude، GPT-4، Gemini) بتكلفة صفرية على المستخدم.

---

## من المحادثة إلى DeFi

يتفاعل المستخدمون مع البروتوكول الكامل من خلال أوامر محادثة:

* *"بدّل 100 USDC إلى HYPE"*
* *"ما هي مكافآتي المعلقة؟"*
* *"اقفل 1000 HDROME لمدة 4 سنوات"*
* *"صوّت بكل veHDROME الخاص بي على مجمع HYPE/USDC"*
* *"ما هو أفضل عائد حالياً؟"*

يتعامل الوكيل مع التوجيه والانزلاق السعري وتقدير الغاز وبناء المعاملات خلف الكواليس.

---

## أوامر الشرطة المائلة

| الأمر | الإجراء |
|---------|--------|
| `/swap` | تبديل الرموز مع توجيه مُحسَّن |
| `/lp` | إضافة أو إزالة السيولة من مجمع |
| `/vote` | تخصيص أصوات veHDROME عبر المقاييس |
| `/lock` | قفل HDROME لإنشاء أو تمديد veNFT |
| `/claim` | المطالبة بجميع المكافآت المعلقة (الانبعاثات، الرسوم، الحوافز) |
| `/help` | عرض الأوامر المتاحة وطريقة الاستخدام |

---

## بطاقات واجهة غنية

يعرض الوكيل بطاقات تفاعلية لكل إجراء — وليس مجرد ردود نصية. تعرض البطاقات:

* **بطاقات التبديل** — زوج الرموز، المبلغ، تأثير السعر، مسار التوجيه، تحمّل الانزلاق
* **بطاقات السيولة** — زوج المجمع، TVL، معدل العائد السنوي، حصتك، مبالغ الإيداع
* **بطاقات التصويت** — قائمة المقاييس، أوزان التصويت الحالية، الإيرادات المتوقعة من الرسوم/الحوافز
* **بطاقات المحفظة** — أرصدة الرموز، مراكز السيولة، تفاصيل veNFT، المكافآت المعلقة
* **بطاقات المكافآت** — تفصيل الانبعاثات والرسوم والحوافز القابلة للمطالبة بقيم بالدولار

---

## الإجراءات القابلة للتنفيذ

| الفئة | الإجراءات |
|----------|---------|
| **التداول** | تبديل الرموز، توجيه متعدد القفزات، تعيين الانزلاق |
| **السيولة** | إضافة سيولة، إزالة سيولة، التخزين في المقياس، إلغاء التخزين من المقياس |
| **القفل** | إنشاء veNFT، زيادة مبلغ القفل، تمديد فترة القفل، دمج veNFTs |
| **التصويت** | التصويت على المقاييس، إعادة تعيين الأصوات، تحديث الأصوات القديمة |
| **المكافآت** | المطالبة بالانبعاثات، المطالبة بالرسوم، المطالبة بالحوافز، المطالبة بإعادة التوازن |
| **المحفظة** | عرض الأرصدة، عرض المراكز، عرض المكافآت المعلقة، الحصول على توصيات العائد |

---

## اقتراحات ذكية

يُظهر الوكيل بشكل استباقي فرص التحسين بناءً على حالة المحفظة:

| الأولوية | المُحفّز | الاقتراح |
|----------|---------|------------|
| **عالية** | اكتشاف رموز LP غير مُخزّنة | التخزين في المقياس لكسب الانبعاثات |
| **عالية** | مكافآت غير مُطالَب بها > $10 | المطالبة بالمكافآت المعلقة ومضاعفتها |
| **عالية** | veNFT ينتهي خلال 7 أيام | تمديد القفل للحفاظ على قوة التصويت |
| **متوسطة** | رموز خاملة > $10 ليست في LP/قفل | توفير السيولة أو القفل للحصول على veHDROME |
| **متوسطة** | تخصيص تصويت غير مثالي | إعادة توازن الأصوات نحو مقاييس ذات عائد أعلى |
| **منخفضة** | مجمع جديد بمعدل عائد عالي متاح | النظر في توفير السيولة في المجمعات الرائجة |

---

## بنية غير مرتبطة بنموذج لغوي واحد

وكيل Hyperdrome **غير مرتبط بمزوّد ذكاء اصطناعي واحد**. تفصل البنية بين تحليل النية وجمع السياق والتنفيذ في طبقات مستقلة — لذا يمكن تبديل خلفية LLM دون تغيير أي شيء آخر.

| الطبقة | الدور | مطلوب LLM؟ |
|-------|------|---------------|
| **Intent Parser** | فهم ما يريده المستخدم | نعم — أي LLM |
| **Context Gatherer** | قراءة البيانات على السلسلة + خارجها | لا |
| **Responder** | توليد الشرح + بطاقات الواجهة | نعم — أي LLM |
| **Executor** | بناء وإرسال المعاملات | لا |

يدعم حالياً **Claude** و**GPT-4** و**Gemini** مع توجيه ذكي. النماذج مفتوحة المصدر (Llama، Mistral، Qwen) وأحضر نموذجك الخاص في خريطة الطريق.

  ### تكامل نماذج اللغة
    دعم متعدد النماذج، التوجيه، أحضر نموذجك الخاص
  

  ### خادم MCP
    ربط أي مساعد ذكاء اصطناعي بـ Hyperdrome عبر MCP
  

  ### أطر الوكلاء
    GOAT SDK, Wayfinder, Eliza, Olas, REST API
  

---

## دعم متعدد اللغات

يستجيب الوكيل بلغة المستخدم. الأوامر باللغة العربية والإنجليزية والصينية واليابانية والكورية والإسبانية والفرنسية والبرتغالية والتركية والروسية وغيرها من اللغات مدعومة بشكل أصلي من خلال قدرات LLM الأساسية. تبقى تسميات الواجهة وأوامر الشرطة المائلة بالإنجليزية، لكن جميع الردود المحادثية تتكيف مع لغة المستخدم.

---

#### تكامل نماذج اللغة

URL: https://docs.hyperdrome.finance/ar/agentic/llm-integrations

كيف يتصل Hyperdrome بأي نموذج لغوي كبير — Claude، GPT-4، Gemini، Llama، Mistral والمزيد يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# تكامل نماذج اللغة

![${2}](${1})

## غير مرتبط بنموذج لغوي واحد بالتصميم

لا يرتبط Hyperdrome بمزوّد ذكاء اصطناعي واحد. تفصل بنية الوكيل بين **تحليل النية** و**جمع السياق** و**التنفيذ** في طبقات مستقلة — لذا يمكن تبديل خلفية LLM دون تغيير أي شيء آخر.

هذا يعني أن Hyperdrome يعمل مع أي نموذج لغوي كبير اليوم، وسيعمل مع أي نموذج يُصدر غداً.

---

## النماذج المدعومة

  ### Claude
    Opus, Sonnet, Haiku — **مباشر**
  

  ### GPT-4
    GPT-4o, GPT-4, GPT-4 Turbo — **مباشر**
  

  ### Gemini
    Gemini 2.5 Pro, 2.5 Flash — **مباشر**
  

  ### مفتوح المصدر
    Llama, Mistral, Qwen, DeepSeek — *مخطط*
  

  جميع النماذج متاحة **مجاناً** للمستخدمين. يتحمل Hyperdrome تكاليف الاستدلال.

---

## البنية المعمارية

خط أنابيب الوكيل غير مرتبط بنموذج محدد في كل مرحلة:

```
User Input (natural language or /command)
        │
        ▼
┌──────────────────┐
│  Intent Parser   │ ← Any LLM (Claude, GPT-4, Gemini, Llama...)
│  "What does the  │
│   user want?"    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│ Context Gatherer │ ← On-chain + off-chain data (no LLM needed)
│  Wallet, pools,  │
│  prices, APRs    │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Responder     │ ← Any LLM (generates explanation + UI cards)
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│    Executor      │ ← Transaction builder (no LLM needed)
│  Build tx, sign, │
│  submit on-chain │
└──────────────────┘
```

يشارك LLM في خطوتين فقط: فهم ما يريده المستخدم، وشرح النتيجة. كل شيء آخر — قراءة حالة البلوكتشين، بناء المعاملات، الإرسال على السلسلة — هو كود حتمي.

---

## التوجيه الذكي

تختار الخلفية تلقائياً أفضل نموذج لكل طلب بناءً على:

| العامل | المنطق |
|--------|-------|
| **التعقيد** | الاستعلامات البسيطة (فحص الأسعار، الأرصدة) → النموذج الأسرع. الإجراءات المعقدة متعددة الخطوات → النموذج الأقوى. |
| **اللغة** | بعض النماذج تؤدي بشكل أفضل بلغات معينة. يُحسّن الموجّه للغة المكتشفة للمستخدم. |
| **زمن الاستجابة** | إذا كان النموذج الأساسي بطيئاً أو غير متاح، ينتقل الموجّه للخيار التالي الأفضل في أقل من 500 مللي ثانية. |
| **التكلفة** | يوازن الموجّه بين القدرة والتكلفة للحفاظ على الاستدلال مجانياً لجميع المستخدمين. |

---

## أحضر نموذجك الخاص *(قريباً)*

  هذه الميزة في خريطة الطريق وليست متاحة بعد.

سيتمكن المستخدمون من ربط مزوّد LLM الخاص بهم:

* **API Key** — توصيل مفتاح API خاص بك من OpenAI أو Anthropic أو Google أو أي مفتاح متوافق مع OpenAI
* **نماذج مستضافة ذاتياً** — توجيه الوكيل إلى نقطة نهاية Ollama أو vLLM أو TGI الخاصة بك التي تشغّل Llama أو Mistral أو Qwen أو أي نموذج مفتوح المصدر
* **موجّهات نظام مخصصة** — تخصيص شخصية الوكيل وتحمّل المخاطر وأسلوب الاستجابة
* **خصوصية كاملة** — عند استخدام نموذجك الخاص، لا تمر أي بيانات عبر خوادم استدلال Hyperdrome

### نقاط النهاية المتوافقة

أي نقطة نهاية تنفّذ تنسيق OpenAI Chat Completions API ستعمل:

| Runtime | Example Models |
|---------|---------------|
| **Ollama** | Llama 3.3, Mistral, Qwen 2.5, DeepSeek V3, Gemma |
| **vLLM** | Any HuggingFace model |
| **TGI** | Any HuggingFace model |
| **Together AI** | Llama, Mixtral, Qwen |
| **Groq** | Llama, Mixtral, Gemma |
| **Fireworks** | Llama, Mixtral, DeepSeek |

---

## لماذا عدم الارتباط بنموذج واحد مهم

1. **لا ارتباط بمورّد** — إذا رفع مزوّد الأسعار أو خفض الجودة أو أضاف قيوداً، ينتقل Hyperdrome بسلاسة.

2. **أفضل نموذج للمهمة** — النماذج المختلفة تتفوق في مهام مختلفة. التوجيه يتيح لـ Hyperdrome استخدام أفضل أداة لكل طلب.

3. **مقاوم للمستقبل** — تُصدر نماذج جديدة شهرياً. البنية غير المرتبطة بنموذج تعني أن Hyperdrome يتبناها فوراً دون إعادة كتابة.

4. **سيادة المستخدم** — مع "أحضر نموذجك الخاص"، يتحكم المستخدمون في بياناتهم واستدلالهم. لا اعتماد على مزوّدي ذكاء اصطناعي مركزيين.

5. **مقاومة الرقابة** — لا يمكن إيقاف النماذج مفتوحة المصدر أو تقييدها. المستخدمون الذين يشغّلون نسخة Llama أو Mistral الخاصة بهم يتمتعون باستقلالية كاملة.

---

#### خادم MCP

URL: https://docs.hyperdrome.finance/ar/agentic/mcp-server

خادم Model Context Protocol من Hyperdrome — ربط أي مساعد ذكاء اصطناعي بمنصة التداول اللامركزية ve(3,3) يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# خادم MCP

![${2}](${1})

  خادم MCP من Hyperdrome في خريطة الطريق وليس مباشراً بعد. تُوثّق هذه الصفحة المواصفات المُخطط لها.

## ما هو MCP؟

**Model Context Protocol (MCP)** هو معيار مفتوح من Anthropic يتيح لمساعدي الذكاء الاصطناعي اكتشاف واستدعاء الأدوات على خوادم خارجية. يستخدم JSON-RPC 2.0 — يستدعي المساعد `tools/list` لاكتشاف الإجراءات المتاحة، ثم `tools/call` لتنفيذها.

يُدعم MCP من **Claude Desktop** و**Cursor** و**Opencode** و**Windsurf** وعدد متزايد من أدوات البرمجة والمحادثة بالذكاء الاصطناعي.

---

## لماذا MCP لـ DeFi؟

يتطلب التفاعل مع DeFi اليوم:
1. فتح متصفح
2. ربط محفظة
3. التنقل في واجهة معقدة
4. فهم الانزلاق السعري والتوجيه والغاز

مع خادم MCP من Hyperdrome، يمكن لأي مساعد ذكاء اصطناعي **مباشرة** تبديل الرموز والتحقق من العوائد والتصويت على المقاييس وإدارة المراكز — دون أن يغادر المستخدم أداته المفضلة.

> *"بدّل 500 USDC إلى HYPE على Hyperdrome"* — مكتوبة في Claude Desktop أو Cursor أو أي عميل MCP.

---

## الأدوات المتاحة

يعرض خادم MCP بروتوكول Hyperdrome الكامل كأدوات قابلة للاستدعاء:

### Trading

| Tool | Description | Parameters |
|------|-------------|------------|
| `swap` | Swap tokens with optimized multi-hop routing | `fromToken`, `toToken`, `amount`, `slippageBps?` |
| `get_quote` | Get a swap quote without executing | `fromToken`, `toToken`, `amount` |

### Liquidity

| Tool | Description | Parameters |
|------|-------------|------------|
| `add_liquidity` | Deposit token pair into a pool | `tokenA`, `tokenB`, `amountA`, `amountB`, `stable` |
| `remove_liquidity` | Withdraw from a pool | `tokenA`, `tokenB`, `stable`, `liquidity` |
| `stake_lp` | Stake LP tokens in a gauge | `pool`, `amount` |
| `unstake_lp` | Unstake LP tokens from a gauge | `pool`, `amount` |

### Locking & Voting

| Tool | Description | Parameters |
|------|-------------|------------|
| `lock` | Lock HDROME to create or extend a veNFT | `amount`, `duration` |
| `vote` | Allocate veHDROME votes across gauges | `tokenId`, `pools[]`, `weights[]` |
| `reset_votes` | Reset votes for a veNFT | `tokenId` |

### Rewards

| Tool | Description | Parameters |
|------|-------------|------------|
| `claim_rewards` | Claim all pending rewards | `tokenId?` |
| `claim_fees` | Claim trading fees for a specific gauge | `gauge` |
| `claim_bribes` | Claim external bribes | `gauge`, `tokens[]` |

### Read-Only

| Tool | Description | Parameters |
|------|-------------|------------|
| `get_pools` | List all pools with TVL, APR, volume | `sortBy?`, `limit?` |
| `get_portfolio` | Full wallet analysis | `address` |
| `get_yields` | Top yield opportunities | `limit?`, `minTvl?` |
| `get_venft` | Get veNFT details | `tokenId` |
| `get_pending_rewards` | Check unclaimed rewards | `address` |

---

## مثال على مخطط الأداة

تتبع كل أداة مواصفات MCP مع JSON Schema للمدخلات:

```json
{
  "name": "swap",
  "description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fromToken": {
        "type": "string",
        "description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
      },
      "toToken": {
        "type": "string",
        "description": "Token symbol or address to buy (e.g. 'HYPE')"
      },
      "amount": {
        "type": "string",
        "description": "Amount to swap in human-readable units (e.g. '100')"
      },
      "slippageBps": {
        "type": "number",
        "description": "Max slippage in basis points (default: 50 = 0.5%)"
      }
    },
    "required": ["fromToken", "toToken", "amount"]
  }
}
```

---

## الاتصال

### Claude Desktop / Cursor / Opencode

أضف إلى تهيئة MCP:

```json
{
  "mcpServers": {
    "hyperdrome": {
      "url": "https://mcp.hyperdrome.finance/sse"
    }
  }
}
```

### الاستضافة الذاتية

سيكون خادم MCP مفتوح المصدر. شغّل نسختك الخاصة:

```bash
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
```

---

## نموذج الأمان

| الخاصية | التفاصيل |
|----------|--------|
| **قراءة فقط افتراضياً** | استعلامات المحفظة وبيانات المجمعات لا تتطلب ربط محفظة |
| **موافقة على المعاملات** | جميع عمليات الكتابة تُعيد معاملات غير موقّعة لمراجعة المستخدم وتوقيعه |
| **لا مفاتيح خاصة** | خادم MCP المُستضاف لا يلمس المفاتيح الخاصة أبداً. التوقيع يتم من جانب العميل. |
| **Rate Limiting** | حدود معدل لكل IP ولكل مفتاح API لمنع إساءة الاستخدام |
| **Audit Trail** | كل استدعاء أداة يُسجّل مع الطابع الزمني والمعايير والنتيجة |

  لا ينفّذ خادم MCP المعاملات نيابة عنك أبداً. يبني المعاملة ويُعيدها لموافقتك الصريحة — تماماً كأي واجهة DeFi أخرى.

---

## حالات الاستخدام

| السيناريو | الطريقة |
|----------|-----|
| **مطوّر يبني لوحة تحكم DeFi** | استعلام المجمعات والعوائد والمراكز عبر أدوات MCP |
| **مساعد برمجة بالذكاء الاصطناعي** | "ساعدني في كتابة سكريبت يطالب بجميع مكافآتي على Hyperdrome" — يستدعي المساعد `get_pending_rewards` ثم `claim_rewards` |
| **وكيل مستقل** | وكيل إدارة محفظة يفحص العوائد كل ساعة ويُعيد التوازن عبر `add_liquidity` / `remove_liquidity` |
| **روبوت محادثة** | روبوت Telegram يتيح للمستخدمين التبديل وفحص المحفظة والتصويت عبر اللغة الطبيعية |
| **بحث** | محلل يستعلم `get_pools` لبناء مقارنة عوائد عبر منصات HyperEVM |

---

#### تكامل أطر الوكلاء

URL: https://docs.hyperdrome.finance/ar/agentic/agent-frameworks

كيف يتكامل Hyperdrome مع GOAT SDK وWayfinder وEliza وOlas والنظام البيئي الأوسع لوكلاء الذكاء الاصطناعي يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# تكامل أطر الوكلاء

![${2}](${1})

صُمم Hyperdrome ليكون متاحاً من **أي وكيل ذكاء اصطناعي**، وليس فقط وكيلنا الخاص. يعرض البروتوكول وظائفه عبر طبقات تكامل متعددة حتى يتمكن الوكلاء والأطر والمنصات الخارجية من التفاعل مع Hyperdrome بشكل أصلي.

  ### GOAT SDK
    أكثر من 200 أداة، أكثر من 13 محوّل إطار عمل
  
  ### MCP
    Claude Desktop, Cursor, Opencode
  
  ### Wayfinder
    محطة DeFi أصلية للذكاء الاصطناعي
  
  ### Eliza
    وكلاء اجتماعيون + DeFi مستقلون
  
  ### Olas
    وكلاء مستقلون لامركزيون
  
  ### REST API
    نقاط نهاية HTTP مباشرة
  

---

## بنية التكامل

```
┌─────────────────────────────────────────────────┐
│              AI Agent Frameworks                 │
│  Claude · GPT · Gemini · Llama · Mistral · ...  │
├─────────────────────────────────────────────────┤
│              Adapter Layer                       │
│  GOAT SDK · Wayfinder · Eliza · LangChain ·     │
│  Vercel AI · MCP · REST API                     │
├─────────────────────────────────────────────────┤
│           Hyperdrome Protocol Layer              │
│  Intent Parser → Context → Tx Builder → Chain   │
├─────────────────────────────────────────────────┤
│                 HyperEVM                         │
│  Router · Voter · Gauges · VotingEscrow · ...   │
└─────────────────────────────────────────────────┘
```

أي إطار عمل يدعم إحدى طبقات المحوّل يمكنه التفاعل مع Hyperdrome. لا حاجة لكود تكامل مخصص.

---

## GOAT SDK Plugin

  إضافة GOAT SDK في خريطة الطريق ولم تُنشر بعد.

**GOAT SDK** هو أكبر مجموعة أدوات مالية للوكلاء — أكثر من 200 أداة، وأكثر من 15 سلسلة، وأكثر من 13 محوّل إطار عمل. بروتوكولات مثل Uniswap وAave و1inch وBalancer لديها بالفعل إضافات GOAT.

سينشر Hyperdrome `@goat-sdk/plugin-hyperdrome` بتغطية كاملة للبروتوكول:

### الإجراءات المتاحة

| Action | Description |
|--------|-------------|
| `swap` | Swap tokens with optimized routing |
| `addLiquidity` | Deposit into volatile or stable pools |
| `removeLiquidity` | Withdraw from pools |
| `stakeLp` | Stake LP tokens in gauges |
| `unstakeLp` | Unstake from gauges |
| `lock` | Lock HDROME → veHDROME (create/extend veNFT) |
| `vote` | Allocate votes across gauges |
| `claimRewards` | Claim emissions, fees, bribes, rebases |
| `getPools` | List pools with TVL, APR, volume |
| `getPortfolio` | Full wallet analysis |

### نطاق الأطر

بمجرد نشر إضافة GOAT، يصبح Hyperdrome متاحاً تلقائياً في:

| Framework | Type |
|-----------|------|
| **Vercel AI SDK** | Full-stack AI apps |
| **LangChain** | Agent orchestration (Python & JS) |
| **LlamaIndex** | Data-augmented agents |
| **MCP** | Claude Desktop, Cursor, Opencode |
| **Eliza** | Autonomous social + DeFi agents |
| **CrewAI** | Multi-agent systems |
| **Mastra** | TypeScript agent framework |
| **GAME (Virtuals)** | Gaming + DeFi agents |
| **OpenAI Agents SDK** | OpenAI's native agent runtime |
| **ZerePy** | Python agent framework |
| **AutoGen** | Microsoft's multi-agent framework |
| **Olas** | Decentralized autonomous agents |

---

## Wayfinder Paths

  تكامل Wayfinder في خريطة الطريق وليس متاحاً بعد.

**Wayfinder** هو محطة DeFi أصلية للذكاء الاصطناعي مع SDK خاص بها (Paths). تدعم بالفعل Hyperliquid للعقود الدائمة، وAave V3، وMorpho، وPendle، وUniswap V3.

سينشر Hyperdrome **محوّل بروتوكول Wayfinder** يتيح:

* التبديل والسيولة والتصويت والقفل عبر Wayfinder Shells (واجهة تداول بالذكاء الاصطناعي)
* تركيب الاستراتيجيات — دمج عائد Hyperdrome مع استراتيجيات عبر البروتوكولات
* جسر MCP — خادم MCP المدمج في Wayfinder سيعرض أدوات Hyperdrome

---

## Eliza (ElizaOS)

**Eliza** هو الإطار الرائد مفتوح المصدر للوكلاء المستقلين في العملات المشفرة. يشغّل روبوتات اجتماعية وDeFi تعمل على Twitter وTelegram وعلى السلسلة.

تكامل Hyperdrome عبر إضافة GOAT (`@elizaos/plugin-goat`):

* يمكن لوكلاء Eliza التبديل وتوفير السيولة والتصويت والمطالبة على Hyperdrome
* زراعة عائد مستقلة — وكلاء يراقبون معدلات العائد السنوي ويعيدون توازن المراكز
* اجتماعي + DeFi — وكلاء ينشرون تحديثات العائد ويجيبون على أسئلة المجتمع وينفذون الصفقات

---

## Olas (Autonolas)

**Olas** هي منصة لامركزية للملكية المشتركة وتشغيل وكلاء الذكاء الاصطناعي المستقلين. أكثر من 3,600 وكيل منشور، وأكثر من 17 مليون معاملة.

مسار تكامل Hyperdrome:

* بناء **خدمة وكيل Olas** تدير مراكز Hyperdrome
* التسجيل كـ **Mech** في سوق Olas — يمكن للوكلاء الآخرين استئجار إجراءات Hyperdrome
* التركيب مع وكلاء Olas الحاليين لاستراتيجيات عبر البروتوكولات

---

## REST API

  واجهة REST API العامة في خريطة الطريق وليست متاحة بعد.

للمطوّرين الذين يريدون تكاملاً مباشراً بدون إطار عمل:

### نقاط النهاية المُخطط لها

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/api/pools` | List all pools with TVL, APR, fees, volume |
| `GET` | `/api/pools/:address` | Pool details |
| `GET` | `/api/portfolio/:wallet` | Full portfolio analysis |
| `GET` | `/api/yields` | Top yield opportunities |
| `POST` | `/api/quote` | Get a swap quote |
| `POST` | `/api/swap` | Build a swap transaction |
| `POST` | `/api/liquidity/add` | Build an add-liquidity transaction |
| `POST` | `/api/liquidity/remove` | Build a remove-liquidity transaction |
| `POST` | `/api/lock` | Build a lock transaction |
| `POST` | `/api/vote` | Build a vote transaction |
| `POST` | `/api/claim` | Build a claim-all transaction |

### تنسيق الاستجابة

جميع نقاط نهاية الكتابة تُعيد بيانات معاملات غير موقّعة:

```json
{
  "tx": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "chainId": 999,
    "gasLimit": "250000"
  },
  "summary": {
    "action": "Swap 100 USDC → 1.62 HYPE",
    "priceImpact": "0.03%",
    "route": ["USDC", "HYPE"],
    "minReceived": "1.611 HYPE"
  }
}
```

  لا تتطلب API مفاتيح خاصة أبداً. جميع المعاملات تُعاد غير موقّعة للتوقيع من جانب العميل.

---

## LangChain Tool

لمطوّري Python الذين يستخدمون LangChain مباشرة:

```python
from langchain.tools import tool

@tool
def hyperdrome_swap(from_token: str, to_token: str, amount: str) -> str:
    """Swap tokens on Hyperdrome (HyperEVM). Returns unsigned transaction."""
    # Calls Hyperdrome REST API
    ...
```

محوّل GOAT SDK يتعامل مع هذا تلقائياً، لكن يمكن للمطوّرين أيضاً بناء أدوات LangChain مخصصة مقابل REST API.

---

## بناء تكاملك الخاص

تريد دمج Hyperdrome في وكيلك أو روبوتك أو تطبيقك؟

1. **الأسرع** — استخدم إضافة GOAT SDK. تعمل مع أكثر من 13 إطار عمل مباشرة.
2. **الأكثر مرونة** — استخدم REST API مباشرة. ابنِ ووقّع المعاملات بأي لغة.
3. **أصلي للذكاء الاصطناعي** — اتصل عبر MCP. يعمل مع Claude Desktop وCursor وOpencode وأي عميل MCP.
4. **مستقل** — ابنِ خدمة وكيل Olas للتنفيذ اللامركزي الكامل للوكيل على السلسلة.

جميع طبقات التكامل تُعيد معاملات غير موقّعة — تطبيقك يتعامل مع التوقيع والإرسال. لا يلمس Hyperdrome المفاتيح الخاصة أبداً.

---

#### قدرات الوكيل وخريطة الطريق

URL: https://docs.hyperdrome.finance/ar/agentic/capabilities

القدرات الكاملة ومصادر البيانات والميزات القادمة لوكيل Hyperdrome يشمل قيما دقيقة، خطوات عملية، ومراجع HyperEVM لمستخدمي Hyperdrome.

# قدرات الوكيل وخريطة الطريق

## مصادر البيانات الحية

| المصدر | البيانات | التحديث |
|--------|------|--------|
| **HyperEVM RPC** | أرصدة المحفظة، مراكز LP، تفاصيل veNFT، تخزينات المقاييس، المكافآت المعلقة | فوري |
| **CoinGecko** | أسعار HYPE, USDC, USDT, BTC, ETH, SOL + التغيير خلال 24 ساعة + القيمة السوقية + الحجم | تخزين مؤقت 60 ثانية |
| **DeFiLlama** | TVL لسلسلة Hyperliquid L1، أعلى 20 بروتوكول مع TVL/الفئة/التغيير خلال 7 أيام | تخزين مؤقت 60 ثانية |
| **Hyperliquid API** | جميع رموز السوق الفوري مع أسعار العلامة، أحجام 24 ساعة، العرض المتداول | تخزين مؤقت 60 ثانية |
| **عقود البروتوكول** | احتياطيات المجمعات، TVL، معدلات العائد السنوي، أوزان التصويت، مبالغ الحوافز، معدلات الانبعاث | فوري |

## تحليل المحفظة

يقوم الوكيل بتحليل عميق للمحفظة عند اتصال محفظتك:

* **أرصدة الرموز** بقيم بالدولار (مرتبة حسب القيمة)
* **اكتشاف رأس المال الخامل** — رموز > $10 ليست في LP/أقفال
* **مراكز LP** — الزوج، مستقر/متقلب، مُخزّن/غير مُخزّن، TVL، معدل العائد السنوي، عنوان المقياس
* **اكتشاف LP غير المُخزّن** — مراكز LP التي لا تكسب انبعاثات
* **veNFTs** — مبلغ القفل، تاريخ الانتهاء، الأيام المتبقية، علامات منتهية/تنتهي قريباً، قوة التصويت، حالة التصويت
* **المكافآت المعلقة** — الانبعاثات، الحوافز، الرسوم — مُفصّلة لكل زوج مع إجماليات بالدولار
* **أعلى 10 مجمعات حسب معدل العائد السنوي** للتوصيات

## خريطة الطريق

| الميزة | الحالة |
|---------|--------|
| من المحادثة إلى DeFi (الويب) | **تم الإطلاق** |
| أوامر الشرطة المائلة | **تم الإطلاق** |
| بطاقات واجهة غنية | **تم الإطلاق** |
| اقتراحات ذكية | **تم الإطلاق** |
| Multi-LLM Backend (Claude, GPT-4, Gemini) | **تم الإطلاق** |
| وكيل Telegram الخارق | **قيد التطوير** |
| MCP Server | مُخطط |
| GOAT SDK Plugin | مُخطط |
| Public REST API | مُخطط |
| Wayfinder Integration | مُخطط |
| Bring Your Own LLM | مُخطط |
| الطيار الآلي | مُخطط |
| آلة المحتوى | مُخطط |
| صور veNFT الديناميكية | مُخطط |
| مُحسّن الحوافز | مُخطط |
| تقارير العائد | مُخطط |
| خزينة الذكاء الاصطناعي | مُخطط |

### الطيار الآلي *(قريباً)*

"أودع واسترخِ" — يدير الوكيل مركزك الكامل في DeFi تلقائياً.

| ملف المخاطر | العائد السنوي المستهدف | الاستراتيجية |
|-------------|-----------|----------|
| **محافظ** | 8-15% | مجمعات مستقرة، قفل أقصى، أزواج رائدة |
| **متوازن** | 15-30% | مزيج مستقر/متقلب، أقفال متوسطة |
| **جريء** | 30-80% | مجمعات متقلبة، زراعة الحوافز، إعادة توازن نشطة |
| **مغامر** | 50-200% | مجمعات جديدة، التقاط أقصى للحوافز، أقفال قصيرة |

يتعامل الوكيل مع: إدارة مراكز LP، التخزين في المقاييس، تصويت veHDROME، المطالبة بالمكافآت، إعادة الاستثمار المُضاعف، وإعادة التوازن — كل ذلك على مدار الساعة دون تدخل المستخدم.

**نموذج الإيرادات**: رسوم أداء 5% على عائد الطيار الآلي.

### وكيل Telegram الخارق *(قريباً)*

بوت واحد لتجربة Hyperdrome الكاملة:
* التبديل، العائد، المحفظة، المطالبة، الطيار الآلي
* التعليم، التنبيهات، توليد الميمات
* توليد صور الملف الشخصي، تحليل الحوافز، تقارير العائد

### مُحسّن الحوافز *(قريباً)*

أداة B2B للبروتوكولات:
* المدخل: هدف السيولة (مثلاً "$500K TVL لـ TOKEN/HYPE")
* المخرج: مبلغ الحافز الدقيق، العائد المتوقع على الاستثمار، التوقيت الموصى به للحقبة
* تتبع كفاءة الحوافز عبر الزمن

### صور veNFT الديناميكية *(قريباً)*

صور ملف شخصي مُولّدة بالذكاء الاصطناعي تتطور بناءً على:
* مدة ومبلغ القفل
* نشاط التصويت والسلسلة المتتالية
* إجمالي العائد المكتسب
* مدة الانتماء للبروتوكول

### خزينة الذكاء الاصطناعي *(قريباً)*

إدارة خزينة ذاتية:
* يخصص الذكاء الاصطناعي حتى 30% من الخزينة لكل حقبة
* ينشر القرارات قبل 12 ساعة من التنفيذ
* آلية نقض مجتمعية
* شفافية كاملة على السلسلة

## الخصوصية

* يقرأ فقط البيانات العامة على السلسلة من محفظتك المتصلة
* لا يتم تخزين بيانات المحفظة بين الجلسات
* لا يتم حفظ المحادثات على الخادم

---