Docs

Aethra Docs

How trading, pools, fees and stock pools work on Aethra Fi, and where to find the SDK and API.

Overview

Aethra Fi is an experimental liquidity layer on Robinhood Chain. It puts three kinds of pool behind one router, prices fees from volatility, and lets stock-token pools follow an oracle. Everything runs on chain; the website only reads from an indexer and sends your transactions.

Venues: Uniswap v4 hook pools, DLMM bin pools and DAMM range pools.
Router: One quote across every venue, direct or two hops, settled in one transaction.
Fees: Base fee plus a volatility component that widens in fast markets and decays in calm ones.
Stock pools: Pools for stock tokens read a reference price and charge more for trades away from it.

Getting started

Click Connect wallet in the header and pick a wallet. Aethra asks to switch to Robinhood Chain (or its testnet).
On testnet, get ETH for gas from the Robinhood Chain faucet. Test tokens such as aUSD come from their own faucet functions.
Open Swap to trade, or Pools to find a pool and add liquidity.

Testnet: Robinhood Chain Testnet · chain ID 46630
Mainnet: Robinhood Chain · chain ID 4663
Gas token: ETH

Swap and smart router

The router quotes every pool that holds your pair, plus two-hop paths through a shared token, using eth_call. It picks the path with the best output and executes it in one transaction. ETH is wrapped and unwrapped for you.

Slippage: Set a tolerance on the swap card. The transaction reverts if the output falls below it.
Deadline: Every swap carries a deadline so a stuck transaction cannot fill at a stale price.
Route: The card shows each hop, its venue and its fee before you confirm.

Pools and venues

Pools lists every pool with TVL, volume, fee and a 24 hour price chart. Filter by trending, most traded, highest volume, fresh or stock pools, or by venue.

v4 hook pools: Uniswap v4 pools that share the Aethra hook. The hook sets the fee on every swap and runs the oracle guard.
DLMM: Liquidity sits in discrete price bins. Trades inside one bin have zero slippage. Pick a bin step from 1 to 100 bps.
DAMM: One price range per pool with fungible shares. An optional launch fee starts high and decays to the base fee.

To open a new pool, use Create pool, choose a venue, a token pair and a starting price, then seed it with liquidity.

Liquidity and positions

Add liquidity from a pool page. v4 positions are ERC-721 tokens, so they show up in your wallet and can be locked or vested. DLMM positions spread across bins using a shape: spot, curve or bid-ask. DAMM positions are fungible shares.

Positions shows what you hold on every venue, the amounts inside it, and the fees you can collect.

Limit orders

Limit orders park liquidity in a single DLMM bin. The order fills as the active bin crosses it. You can claim the proceeds yourself, or a keeper can claim for you. Cancel any time before it fills.

Dynamic fees

Each pool pays a base fee plus a variable part that grows with recent price movement. A volatility accumulator rises as the price moves and decays back over time, so the fee returns to the base fee once the market settles.

Base fee: 0.05% on default dynamic v4 pools, 0.30% on stock pools
Fee ceiling: 2% on default dynamic pools, 3% on stock pools; 10% hard protocol cap
Decay: 600 s window back toward the base fee
Where: v4 hook pools, DLMM and DAMM share the same fee model

Oracle guard and stock pools

Pools that hold a stock token read a reference price. A trade that moves the pool toward the oracle price pays the base fee. A trade that moves it away pays more. A circuit breaker reverts any swap that would push the pool too far from the oracle, and swaps revert while the feed is unavailable.

Open any stock pool to see the oracle price, the gap to the pool price and the breaker state. Use the Stocks filter on Pools to list them. Testnet stock tokens use mock oracles.

Analytics and events

Analytics charts TVL, volume and fees with a breakdown by venue. The Event feed lists every swap, deposit and order as it lands on chain. An indexer reads the chain every minute, so numbers can trail a block by up to a minute.

Developers

@aethra/sdk ships addresses, ABIs and route helpers for each network. The REST API is public and read only, and every response is shaped as { data }. See Developers for endpoints and examples, and Contracts for every deployed address.

All Aethra contracts are UUPS proxies. The address you read in the SDK stays the same when logic is upgraded.

FAQ

Is Aethra on mainnet?: Not yet. Aethra runs on Robinhood Chain Testnet, where tokens carry no value. Mainnet launch will be announced here.
Why did my swap revert?: The output fell below your slippage tolerance, or a stock pool circuit breaker blocked a swap that would push it too far from the oracle.
Why is a pool chart flat?: Charts move when trades move the price. A pool with no trades in the last 24 hours shows a steady line.
Where is my position?: Connect the wallet that opened it. Positions load by owner address across every venue.