Teucer documentation

Teucer — named for the greatest archer of the Trojan War — is a concentrated-liquidity platform in the style of Meteora's DLMM, built for the Robinhood Chain ecosystem and powered by Uniswap v3.

You provide liquidity into a range of prices you choose, visualized as bins. While the market trades inside your range, your capital earns swap fees; outside it, your position sits idle in a single token. Teucer gives you the tools to aim well: a bin-level liquidity map, a draggable range, distribution shapes, single-token zap-in, and one-click position management.

Every action is a real on-chain transaction against audited, battle-tested Uniswap v3 contracts. Teucer deploys no custody contracts — your positions are standard Uniswap v3 NFTs in your own wallet, visible and manageable from any Uniswap interface too.

Bins & ranges

Uniswap v3 divides each pool's price axis into ticks; each pool has a tick spacing set by its fee tier. Teucer groups the price axis into bins of one tick-spacing each— the same mental model as Meteora's DLMM. One tick ≈ 0.01% of price, so a bin in a 0.05% pool (spacing 10) covers ≈ 0.10% of price movement.

The bin chart on the Create tab shows how much liquidity other LPs have placed in every bin around the current price. Indigo bins sit below the current price (they hold the quote token); bronze bins sit above it (they hold the base token); the white bin is the active bin, where trading happens right now — only liquidity in the active bin earns fees at any given moment.

Your range is a contiguous run of bins. Narrow ranges concentrate your capital — more fees per dollar while price stays inside, but the position falls out of range sooner. Wide ranges earn less per dollar but stay active through bigger moves.

Creating a position

  1. Pick a pool on the Discover tab (ranked by 24h volume, with TVL, fees, and estimated APR) or search on the Create tab. This opens the pool page: stats on the left, price chart in the middle, deposit panel on the right.
  2. Draw your range. Drag the bronze Min Bin / Max Bin lines directly on the candlestick chart (they snap to bin boundaries), drag the handles or slider on the bin histogram, use the +/− steppers, or type exact min/max prices. Hover any bin for its price range and liquidity share. Everything stays in sync, and handles also move one bin at a time with the arrow keys.
  3. Choose a shape — how your liquidity is distributed across the range (see below).
  4. Deposit.Enter one amount and Teucer computes the other side from the range math. If your range sits entirely above or below the current price, the deposit is single-token. Approve each token once (“nock”), then confirm the mint (“loose”).

Multi-slice shapes are minted in one transactionvia the position manager's multicall, so Curve and Bid-Ask don't cost you extra confirmations.

Liquidity shapes

A Uniswap v3 position is uniform across its range. Teucer approximates Meteora's shapes by splitting your range into up to five weighted sub-positions:

  • Spot — one uniform position across the whole range. Lowest gas, simplest to manage. The default.
  • Curve— weights follow a bell curve centered on your range's middle. Maximum fee capture while price trades near the center; ideal for stable pairs and calm markets.
  • Bid-Ask — weights are heaviest at the edges of your range. It effectively scales into dips and out of rips — a two-sided DCA that profits from volatility passing through your range.

The dashed outline on the bin chart previews the chosen shape before you deposit. Each sub-position appears in your portfolio as its own entry (they share the pool and can be closed individually or together).

Zap in

Hold only one of the pair's tokens? Zap-in computes the exact portion that must be swapped so your deposit matches the range's required ratio, quotes it via Uniswap's QuoterV2, executes the swap through SwapRouter02 with your slippage limit, then mints the position — swap and mint as separate confirmations, deposit itself always as one multicall.

Note: the swap pays the pool's fee tier and moves the price slightly, so zap-in on thin pools with large size will shift your own entry. For size, prefer depositing both tokens.

Fees & APR

Swappers pay the pool's fee tier (0.01%–1%) on every trade. Fees accrue to positions whose range covers the active bin at the moment of each swap, pro-rata to their share of that bin's liquidity. Fees are not auto-compounded — claim them from the Portfolio tab whenever you like.

The Est. APR column on Discover is fee tier × 24h volume × 365 ÷ TVL — a pool-wide, full-range estimate. A well-aimed concentrated position can earn a large multiple of it; an out-of-range position earns zero. Treat it as a compass, not a promise.

Managing positions

The Portfolio tab reads your position NFTs straight from the chain:

  • Status — in range (earning) or out of range (idle), with the range bar showing where price sits relative to your bounds.
  • Claim fees — collects accrued fees to your wallet. One transaction.
  • Remove — withdraw 25/50/75/100% of liquidity. Decrease and collect are batched into one transaction.
  • Close position — removes all liquidity, collects everything (principal + fees), and burns the empty NFT. One transaction, one click.
  • Add— jumps to the Create tab pre-loaded with the position's pool.

Architecture

Teucer is a thin, honest layer over public infrastructure:

  • Contracts — the official Uniswap v3 deployment on Robinhood Chain: Factory, NonfungiblePositionManager (mint/increase/decrease/collect/burn, multicall), SwapRouter02 (zap swaps), QuoterV2 (zap quotes), TickLens (bin liquidity map).
  • Market data— GeckoTerminal's public API for pool discovery, TVL/volume, and price history; all position math and liquidity state read directly from the chain via multicall.
  • No backend, no custody — the app is a static frontend; every write is signed by your wallet, every read is public data.

Robinhood Chain

Teucer runs on Robinhood Chain mainnet — an Arbitrum Orbit L2 (chain id 4663, ETH gas) focused on tokenized real-world assets — against the official Uniswap v3 deployment there. Transactions confirm in about a second and cost a fraction of a cent; the explorer is Blockscout (robinhoodchain.blockscout.com). As tokenized stocks come on-chain, the same bins, ranges, and shapes apply to them directly — concentrated liquidity on equities, with the same bow. Arbitrum One remains available as a config-flip fallback (NEXT_PUBLIC_ACTIVE_CHAIN=arbitrum).

Risks

  • Impermanent loss, amplified. Concentration multiplies fee income and divergence loss. A position that exits its range has fully converted into the less valuable token of the pair.
  • No auto-rebalancing. Teucer does not move your range for you. Out of range means zero fees until you reposition or price returns.
  • Estimates are estimates.APR figures derive from yesterday's volume; tomorrow disagrees routinely.
  • Smart-contract risk. Mitigated by using canonical, audited Uniswap v3 contracts — but never zero.

FAQ

Is Teucer a fork of Meteora?
No. Meteora's DLMM is Solana-native. Teucer brings the same UX — bins, shapes, a draggable range — to the EVM by mapping it onto Uniswap v3's tick model.
Why do I see positions I didn't open in Teucer?
Portfolio reads every Uniswap v3 position NFT in your wallet, wherever it was minted. Your Teucer positions are equally visible in other Uniswap frontends.
What does “1 bin ≈ 0.10%” mean?
Each tick is a 0.01% price step and this pool's tick spacing is 10, so one bin spans ten ticks ≈ 0.10% of price. Pools with other fee tiers have wider or narrower bins.
Are there protocol fees?
Teucer adds no fees in v1. You pay only Uniswap pool fees (when zapping) and gas.
Which wallets work?
Any injected EVM wallet — MetaMask, Rabby, OKX, Brave, and friends. WalletConnect lands with v2.
What about Uniswap v4 pools?
Discover lists both v3 and v4 pools (badged). v4 pool pages show live market data, token safety, and swaps; position creation currently mints on v3 — the v4 engine is next on the roadmap.
How does the Token Safety check work?
Each pool page checks the pair's non-major token via GMGN: honeypot detection, buy/sell tax, contract verification, renounced ownership, blacklist functions, liquidity lock/burn status, top-10 holder concentration, and launchpad origin. Discover also flags pools with many buys but zero sells — the classic honeypot pattern. Signals reduce risk; they never eliminate it.