# Welcome to Alien Base

Welcome to Alien Base

## What is Alien Base?

Alien Base is a meta-DEX native to the Base chain. It combines new and existing DeFi technologies in an accessible interface to give seasoned and new DeFi users the best tools available for **trading**, **providing liquidity**, and **launching new projects**.

What does that mean? We don't really know — ChatGPT wrote it. But in plain Earth-language: Alien Base is a very cool DEX and aggregator on Base with an excellent UI/UX, an ambitious roadmap, a capable team of Aliens, and one of the most active and engaged communities in the Base ecosystem.

## What can you do on Alien Base?

* **Trade any token on Base** in a full trading terminal — Swaps, Limit orders, Take Profit, Stop Loss, Trailing Stops, and DCA, all executed on-chain by the Epsilon Router.
* **Provide liquidity** in Concentrated-Liquidity (V3) pools, or strategy Vaults to earn fees and ALB rewards.
* **Lock $ALB into esALB** for governance, single-staking, and Real Yield in WETH from protocol fees.
* **Launch a token** with the Token Generator — Simple, Mintable, Burnable, Mint/Burn, or Tax templates, ready for trading on Alien Base or any other DEX.
* **Discover and analyze** every token, pool, and trade on Base via the Explorer — our chain-wide analytics layer.
* **Vote on protocol decisions** as an esALB holder via Snapshot.

## Quick Stats

|                      |                                                                                             |
| -------------------- | ------------------------------------------------------------------------------------------- |
| Token                | $ALB ([0x1dd2…50c4](https://basescan.org/token/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4)) |
| Network              | Base (ChainId 8453)                                                                         |
| Launch               | August 8, 2023                                                                              |
| Lifetime swap volume | \~$2.86 B                                                                                   |

For up-to-date market data, see our [Dune dashboard](https://dune.com/sealaunch/alienbase) (the canonical source, built with Sealaunch), [CoinGecko](https://www.coingecko.com/en/coins/alienbase), or [DefiLlama](https://defillama.com/protocol/alien-base). For full contract addresses, see [Contracts](/reference/contracts). For the full data-source map, see [Data & Analytics](/reference/data-and-analytics).

## Where can I start?

1. **Track ALB and Alien Base** on [CoinGecko](https://www.coingecko.com/en/coins/alienbase), [CoinMarketCap](https://coinmarketcap.com/currencies/alien-base/), [DexScreener](https://dexscreener.com/base/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4), and inside [Coinbase Wallet](https://www.coinbase.com/wallet). Add us to your watchlist.
2. **Join our community** — [Discord](https://discord.gg/alienbase) is the main hub. Real humans, real Aliens, lively debate on Alien Base, Base in general, memecoins, and beyond.
3. **Explore the dApp** at [app.alienbase.xyz](https://app.alienbase.xyz). If anything breaks, ping the team on Discord — someone will respond.
4. **Read these docs** — tutorials and reference material for every product.
5. **Follow us on socials** — [X / Twitter](https://twitter.com/AlienBaseDEX), [Medium](https://medium.com/@alienbase) for long-form articles, and [Reddit r/Alienbase](https://www.reddit.com/r/Alienbase).

## Quick Start (Q\&A)

We know humans don't like to read. Maybe we Aliens can read your mind. Either way, here are the questions everybody asks.

### What can I do on Alien Base?

Trade, provide liquidity, lock ALB for governance + Real Yield, launch a token, and analyze the Base ecosystem. The bullets at the top of this page are the canonical list.

### Is Alien Base audited?

The contracts that Alien Base wrote from scratch are split between **audited**, **audit upcoming**, and **inherited audits** from the upstream protocols we fork.

* **Epsilon Router** (the on-chain order engine + meta-aggregator integration) — **audited by Hexens** (final report June 2026); live in production since July 2026.
* **Mothership** — audit upcoming. Pre-audit hardening visible in the public repo (fuzz tests, audit-scope commit from January 2026); the audit will run before the MVP is publicly accessible without supply caps.
* **All other native contracts** (V2 Factory/Router, BasedDistributorV2 farm, esALB / EsProxyMaster / EsTokenController, Token Generator, etc.) **rely on inherited audits** from the protocols they fork. Specifically:
  * **Uniswap V2 / V3 core** — audited by Trail of Bits, ABDK, and the Uniswap V3 Code4rena contest. Applies to the unchanged V2 + V3 cores.
  * **PancakeSwap MasterChef** — applies to the V2 farm contracts.
  * **Bunni / Timeless Finance** — applies to BunniHub and (mostly) BunniZap. Our BunniZap was lightly adapted.
  * **PancakeSwap SmartRouter** — applies to the V3 SmartRouter (lightly adapted).
  * **Bancor Carbon** — audited by PeckShield (May & July 2024) and ChainSecurity. Applies to the deployed CarbonController.
  * **Camelot xGRAIL escrow model** — the lineage of the esALB locking system.

Full breakdown with auditor names, dates, scopes, and report links: [Audits & Security](/reference/audits-and-security).

### What are the protocol fees?

| Product                                            | Fee                                                                             | Where it goes                       |
| -------------------------------------------------- | ------------------------------------------------------------------------------- | ----------------------------------- |
| **V2 swap** (pool fee)                             | **0.16%**                                                                       | **LPs (50%) + esALB stakers (50%)** |
| **V3 swap** (pool fee)                             | **0.01% / 0.02% / 0.03% / 0.04% / 0.075% / 0.30% / 1.00%** (per fee tier)       | **LPs (50%) + esALB stakers (50%)** |
| **Epsilon Router** protocol fee                    | **0.05% flat fee on any swap**                                                  | esALB stakers                       |
| **Limit / Take Profit** orders                     | **0.01% / 0.05% / 0.10%** (stables / blue chips / other) (+ 0.05% Protocol Fee) | Keeper                              |
| **Stop Loss / Trailing Stop / Trigger DCA** orders | **0.10% / 0.20% / 0.45%** (stables / blue chips / other) (+ 0.05% Protocol Fee) | Keeper                              |
| **Regular DCA** orders                             | **0.01% / 0.10% / 0.20%** (stables / blue chips / other) (+ 0.05% Protocol Fee) | Keeper                              |
| **Token Generator**                                | 0.015 ETH per token mint                                                        | Operating budget                    |

Full breakdown — including per-tier rationale, historical changes, and how each share is routed — on the [Fees](/reference/fees) page.

### What is esALB?

esALB ("escrowed ALB") is a non-transferable lock-wrapped form of ALB. You convert ALB → esALB 1:1 via **Lock & Earn** on the [Dashboard](https://app.alienbase.xyz/dashboard). esALB is what earns governance voting power, single-staking APR (paid in ALB), and **Real Yield** (paid in WETH from protocol fees).

You can convert back at any time via two paths, mixable: 100% after a 30-day cooldown (no penalty), or 1% instantly every 12 hours. [Full guide](/alb-and-esalb/escrowed-alb-esalb).

### How do I stake ALB?

1. Acquire ALB on the [Swap](https://app.alienbase.xyz/swap) page (any pair routed through Epsilon will give the best price).
2. Open the [Dashboard](https://app.alienbase.xyz/dashboard) and click **Lock & Earn** (or use **Lock & Stake** under Vaults → Locked earn).
3. Pick the **esALB** farm, choose how much to lock, and confirm. Your ALB converts 1:1 to non-transferable esALB and is staked automatically — rewards start accruing immediately.

### Is the team doxxed?

Alien Base was founded and built by entrepreneurs and DeFi enthusiasts who chose to remain pseudonymous. There are no clear regulatory rules in many jurisdictions for DeFi projects: the rulebooks of classical or centralized finance don't translate cleanly (e.g., the entire concept of KYCing every user). Until that changes, we stay anonymous — even though the protocol is now governed by the DAO and not exclusively by the founding team. This lets us focus on building rather than litigating bureaucracy.

The team and its operating companies are doxxed to the **Base** and **Coinbase** teams and to multiple partners. The DAO Multisig signers, on the other hand, are public — see [DAO Multisig](/governance/dao-multisig).

### Where are the contracts?

Full canonical list in [Contracts](/reference/contracts). The headline ones:

* ALB token: [`0x1dd2…50c4`](https://basescan.org/token/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4)
* Epsilon Router (orders): [`0x303c…2580`](https://basescan.org/address/0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580)
* V2 Factory / Router / Farm: see [Contracts](/reference/contracts)
* V3 Factory / SmartRouter / NFTPositionManager / BunniHub: see [Contracts](/reference/contracts)
* esALB system (EsToken, EsProxyMaster, EsTokenController): see [Contracts](/reference/contracts)
* Token Generator orchestrator: [`0xBcE7…d08d`](https://basescan.org/address/0xBcE75497D72b25c3509B62ae1a47CCfb502AD08d)
* DAO Multisig (5-of-8 Safe): [`0x4ab9…71e5`](https://basescan.org/address/0x4ab9070b7680f802cbf8322e597a4409902171e5)

Source code lives in [github.com/alienbase-xyz](https://github.com/alienbase-xyz/) — note that not every deployed contract has a public repo for reasons of operational secrecy.

***

## Documentation map

* [**Get Started**](/get-started/bridging-to-base) — bridging, wallets, and buying ALB
* [**Trading**](/trading/swap) — the trading terminal, Epsilon, Limit / Stop / Trailing Stop / DCA orders
* [**Liquidity**](/liquidity/vaults) — Vaults, V3, Bunni, V2, Mothership
* [**ALB & esALB**](/alb-and-esalb/alb-token) — tokenomics, staking, vesting, Real Yield
* [**Governance**](/governance/alien-base-dao) — DAO, Foundation, Labs, AIP index
* [**Builders**](/builders/token-generator) — Token Generator and listing your project
* [**Reference**](/reference/contracts) — Contracts, Fees, Audits & Security, Glossary
* [**Roadmap**](/roadmap) + [**Changelog**](/changelog)
* [**Common Issues**](/common-issues/rpc-troubleshooting-guide)
* [**Archive**](/archive/archive) — deprecated products (Area 51, StableSwap, Carbon orders, B3, Predictions, Lottery)

> *Last updated: July 6, 2026. Found something out of date? Open an issue on* [*github.com/alienbase-xyz/docs*](https://github.com/alienbase-xyz/docs/issues) *or ping the team on Discord.*


# Bridging to Base

Move ETH or assets from Ethereum (or other chains) onto Base

To use Alien Base you need ETH on **Base**. This page covers the canonical and third-party bridging options.

> *Last updated: July 6, 2026.*

## TL;DR

* **From Ethereum mainnet:** Coinbase Wallet's built-in bridge or [bridge.base.org](https://bridge.base.org). Native, secure, slow on the way back.
* **From any other chain:** any reputable cross-chain bridge that supports Base. Faster but introduces a third-party trust assumption.
* **From a Coinbase account:** Coinbase exchange supports direct withdrawal to Base. The fastest path for most users.

## Native bridge (Ethereum ↔ Base)

The official Base bridge is at [bridge.base.org](https://bridge.base.org). Run by Coinbase, with no third-party intermediaries:

* **Deposits (Ethereum → Base):** \~1–10 minutes. Costs Ethereum gas.
* **Withdrawals (Base → Ethereum):** \~7-day challenge period before funds release on Ethereum. This is a property of how OP-stack rollups work, not an Alien Base or Base-specific delay.

Best for: large amounts you want to move with the lowest possible trust assumptions.

## Coinbase exchange direct withdrawal

If you already have an account on Coinbase, you can withdraw ETH directly to your wallet on Base. No bridge required. Fastest path for most users.

1. On Coinbase, choose Withdraw → ETH.
2. Network: **Base**.
3. Destination: your wallet address.

## Coinbase Wallet built-in bridge

If you use Coinbase Wallet (browser extension or mobile), the in-app bridge handles Ethereum → Base in a single flow. UX is significantly smoother than going to bridge.base.org manually.

## Third-party bridges

For chains other than Ethereum (or for users who want faster Base → Ethereum exits), use a reputable bridge. Common options that support Base:

* Across
* Stargate
* Synapse
* Hop Protocol
* LI.FI / Squid (cross-chain aggregators)

Each one has its own trust model and fees — read the docs before using a bridge with significant capital.

## What you need

* **Some ETH on Base for gas.** Even \~$1 worth is enough for many transactions.
* **The token you want to trade**, if it's not already available on Base. If a token only exists on Ethereum (or another chain), you'll need to bridge it specifically; bridging ETH alone won't bring your other tokens.

## After bridging

Once your funds are on Base, head to [Connecting your wallet](/get-started/connecting-your-wallet) and then [Buying ALB](/get-started/buying-alb) (or any other token you want to trade).

## Common issues

* **"Stuck deposit."** Deposits from Ethereum to Base take a few minutes. If yours is taking longer than 30 minutes, check the transaction on [Etherscan](https://etherscan.io/) — if it confirmed, the funds are on Base. The bridge just hasn't updated its UI.
* **"Withdrawal not showing on Ethereum."** If you used the native bridge (bridge.base.org), there's a 7-day challenge period. This is normal.
* **"Wrong network in wallet."** Most wallets auto-suggest switching to Base when you visit Alien Base. If yours doesn't, manually add Base (chain id 8453) — see [Connecting your wallet](/get-started/connecting-your-wallet).


# Connecting your wallet

Connect MetaMask, Coinbase Wallet, Rabby, or any other wallet to Alien Base

Alien Base works with any standard EVM wallet. There's nothing custom on the wallet side — the app supports the standard `wallet_connect` and WalletConnect flows.

> *Last updated: July 6, 2026.*

## Supported wallets

* **Coinbase Wallet** — extension, mobile, in-app browser. Widely used on Base; native fit.
* **MetaMask** — extension and mobile.
* **Rabby Wallet** — extension. Strong UX for advanced users; auto-detects networks.
* **WalletConnect-compatible wallets** — Trust Wallet, Phantom (with EVM support), Ledger, Keystone, etc.
* **Frame** — desktop signer; useful for hardware-wallet workflows.

## How to connect

![Dashboard prompts you to connect a wallet on first visit](/files/xk6Dv0PRhQABzQXxQJn6)

1. Visit [app.alienbase.xyz](https://app.alienbase.xyz/).
2. Click **Connect Wallet** (top right).
3. Pick your wallet from the list.
4. Approve the connection in your wallet.
5. Verify the **Base** network is selected. The app will prompt you to switch if needed.

![The wallet selector](/files/4vnyLJhJDGqqXKaFJ7iO)

Once connected, the Dashboard shows your full portfolio on Base — asset allocation, vault deposits, locked positions, and claimable rewards:

![Dashboard with a connected wallet](/files/reJI9OZSGeZoVxgrX2kf)

## Adding Base manually

If your wallet doesn't auto-suggest Base, add it manually:

| Field           | Value                                                  |
| --------------- | ------------------------------------------------------ |
| Network name    | Base                                                   |
| RPC URL         | `https://mainnet.base.org` (or any reputable Base RPC) |
| Chain ID        | `8453`                                                 |
| Currency symbol | `ETH`                                                  |
| Block explorer  | `https://basescan.org`                                 |

The official Base RPC is solid for casual use. For higher throughput or more reliability, consider a paid endpoint (Alchemy, QuickNode, Ankr). See the [RPC Troubleshooting Guide](/common-issues/rpc-troubleshooting-guide).

## Using a hardware wallet

Both Ledger and Keystone work with Alien Base via:

* **Coinbase Wallet** (Ledger via "Add Hardware Wallet" flow).
* **MetaMask** (Connect Hardware Wallet).
* **Rabby** (Connect Hardware Wallet).
* **Frame** (desktop signer that exposes the hardware wallet to dApps).

For the safest setup with significant balances: use a hardware wallet through Frame or Rabby, blind-sign disabled, every transaction reviewed on the device.

## Disconnecting

Click your wallet address in the top-right of the app and select **Disconnect**. The app cannot make any further requests to your wallet until you reconnect.

## Privacy / what the app sees

When you connect, Alien Base's frontend can:

* See your wallet address.
* Read your token balances and transaction history (this is on-chain anyway).
* Request signatures and transactions; your wallet always asks you to confirm.

It cannot:

* Move funds without your explicit signature.
* Drain your wallet by being "connected".

A "connected" wallet is just a session token. Approvals (token allowances) are separate — they are explicit transactions, and they're the actual mechanism by which a contract can spend your tokens. To audit and revoke them, see [Managing Token Allowance](/common-issues/managing-token-allowance-guide).

## Common issues

* **"Wrong network."** Switch to Base in your wallet's network selector.
* **"Wallet not detected."** Some browsers need the extension reloaded; some need you to disable competing wallet extensions.
* **"Connect button does nothing."** Pop-up blocker likely. Allow popups from `app.alienbase.xyz`.


# Buying ALB

How to acquire ALB on Base

ALB is the native token of Alien Base. The fastest path to acquire it is on Alien Base itself — but several other venues also have ALB liquidity.

> *Last updated: July 6, 2026.*

## On Alien Base (recommended)

1. Have ETH on Base. (See [Bridging to Base](/get-started/bridging-to-base) if you don't.)
2. Go to [app.alienbase.xyz/swap](https://app.alienbase.xyz/swap).
3. Sell ETH (or USDC, or any token you have on Base) → buy ALB.
4. Epsilon will route your trade through whichever pool gives the best price — almost always one of Alien Base's native ALB pools.

The deepest market is the V3 ALB-WETH pool ([`0xbcd27A43…6fcB`](https://basescan.org/address/0xbcd27A437eBe92555Cee6b5bBeDdAC639a1b6fcB)). For a guided walkthrough, see [Swap](/trading/swap).

## On other DEXes

ALB also has pools on:

* **Uniswap** (3 pools as of July 6, 2026)
* A few smaller venues

If you're already on one of those DEXes, ALB will be swappable there. But Epsilon will give you the best price by aggregating across all of them, so trading on Alien Base directly is almost always better.

## What address to use

Always verify the contract address before swapping:

* **ALB:** [`0x1dd2d631c92b1aCdFCDd51A0F7145A50130050C4`](https://basescan.org/token/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4)

Beware of scam tokens with similar names. The Alien Base swap UI loads the canonical token by default; if you paste an address into the token selector, double-check it matches the one above.

## What to do with ALB after buying

Most users do at least one of:

1. **Lock it as esALB** to earn single-stake APR + Real Yield. See [esALB](/alb-and-esalb/escrowed-alb-esalb).
2. **Provide liquidity** in V3 / Bunni Vaults (infinite or concentrated, capital-efficient). See [Vaults](/liquidity/vaults).
3. **Vote** on Snapshot proposals once locked as esALB. See [Alien Base DAO](/governance/alien-base-dao).

## Tracking ALB

* [**Dune dashboard**](https://dune.com/sealaunch/alienbase) — canonical, includes ALB price, supply, esALB lock state, holders, top pairs.
* [CoinGecko](https://www.coingecko.com/en/coins/alienbase) — price and market cap.
* [DexScreener](https://dexscreener.com/base/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4) — every pool, every trade.
* [DefiLlama](https://defillama.com/protocol/alien-base-v3) — TVL across the protocol.
* [GeckoTerminal](https://www.geckoterminal.com/) — alternative pool view.
* Inside Coinbase Wallet, search "ALB" to add to watchlist.

Full data-source map: [Data & Analytics](/reference/data-and-analytics).


# Trading Terminal & Swap

The Alien Base trading terminal — chart, swap, and every order type in one view

Trading on Alien Base happens in a full **trading terminal**: a live TradingView chart, chain-wide token search, your balances and open orders, and every order type — Swap, Limit, Take Profit, Stop Loss, Trailing Stop, and DCA — in a single view.

> *Last updated: July 6, 2026.*

![Trading terminal](/files/sKTve04oDbfr6Xh6CUYb)

## The layout

Open [app.alienbase.xyz/swap](https://app.alienbase.xyz/swap):

* **Pair header (top).** The token you're trading, its contract address, live price, 24h change, and a watchlist star.
* **Chart (center).** A full TradingView chart with indicators, drawing tools, timeframes, and USD/WETH denomination toggle.
* **Order form (right).** Tabs for **Swap**, **Limit**, and **Pro** (Trailing Stop and DCA). This is where you build and submit orders.
* **Positions panel (bottom).** Five tabs that track your activity: **Balances** (per-asset allocation, average entry price, unrealized P\&L), **Open orders**, **Active DCAs**, **Closed orders**, and **Trades**.
* **Trending ticker (bottom edge).** Live price change strip for the most active tokens on Base.

With a wallet connected, the **Balances** tab becomes a portfolio tracker: allocation percentages, balance, average entry price vs. current price, 24h change, USD value, and unrealized P\&L per asset.

![Balances tab with a connected wallet](/files/Zjd4zNT2GJgwKGvCifRi)

## Finding any token

Click **Search pools or tokens** in the top bar (or paste a contract address). Search covers every token and pool on Base — not just Alien Base's own list — with market cap, 24h volume, holders, and liquidity shown inline, so you can sanity-check a token before opening the chart.

![Token search](/files/7h3UgSi33R8gltXKbySk)

## Making a swap

1. Connect your wallet.
2. In the **Swap** tab, choose the token you're selling (top) and the token you're buying (bottom).
3. Enter an amount — or use the 25% / 50% / 75% / 100% buttons or the slider.
4. The quoted output appears in the bottom field. [Epsilon](/trading/epsilon) computes it by routing across every venue on Base.
5. (Optional) Adjust slippage tolerance (default 0.5%).
6. Click **Review** → check the summary → confirm in your wallet.

The review step shows everything you're agreeing to before you sign: price, minimum received after slippage, the aggregator route, the trading fee, and the price impact.

![Swap review — price, minimum received, fee, and price impact before signing](/files/PnTYV7GZoulZmGkd1i7z)

## Slippage

Slippage is the maximum acceptable difference between the quoted price and the executed price. If the price moves more than your tolerance during transaction submission, the swap reverts.

Sensible defaults:

* **0.1–0.5%** for stablecoin / blue-chip pairs.
* **0.5–1%** for typical token swaps.
* **2–5%+** for low-liquidity tokens or memecoins with on-trade fees.

If slippage is set too low for a volatile token, the swap will revert (and you'll burn gas). If set too high, your trade can be sandwich-attacked. Aim for the lowest value that lets the trade complete reliably.

## On-trade fees in tokens

Some Base tokens take an on-trade fee (a "tax" or "burn") inside their transfer logic. If you're trading one of these, set slippage high enough to cover the on-trade fee. The UI surfaces a warning when it detects a known fee-on-transfer token.

## What happens after Swap

* Transactions usually confirm in 1–3 seconds on Base.
* The trade appears immediately in the **Trades** tab of the positions panel; your **Balances** tab updates with the new allocation and average price.
* A success notification links to the Basescan transaction.

## Common issues

* **"Insufficient funds for gas."** Base needs a small amount of ETH for gas. Bridge or buy \~$1 worth.
* **"Price impact too high."** Liquidity is shallow for this pair. Try a smaller size, or split the entry with a [DCA order](/trading/dca-orders).
* **Pending transaction won't confirm.** See [Pending or failed transactions](/common-issues/pending-or-failed-transactions).

## See also

* [Epsilon](/trading/epsilon) — the routing + order-execution engine underneath every trade.
* [Limit, Take Profit & Stop Loss](/trading/limit-orders) — trade at your price, not the market's.
* [Trailing Stop](/trading/trailing-stop) — a stop that follows the price.
* [DCA Orders](/trading/dca-orders) — split a buy/sell over time.
* [Fees](/reference/fees)


# Limit, Take Profit & Stop Loss

Limit, Take Profit, and Stop Loss orders — executed on-chain by the Epsilon Router

The **Limit** tab of the trading terminal covers every "trade at my price, not the market's price" scenario. Four order modes, all executed on-chain by the [Epsilon Router](/trading/epsilon#the-epsilon-router):

| Mode            | Direction | Triggers when…                 | Typical use                       |
| --------------- | --------- | ------------------------------ | --------------------------------- |
| **Limit Buy**   | Buy       | Price **drops to** your level  | "Buy the dip at my price"         |
| **Stop Buy**    | Buy       | Price **climbs to** your level | "Buy the breakout confirmation"   |
| **Take Profit** | Sell      | Price **climbs to** your level | "Sell into strength at my target" |
| **Stop Loss**   | Sell      | Price **drops to** your level  | "Cut the loss automatically"      |

> *Last updated: July 6, 2026.*

## How the modes map to the UI

The form adapts to the direction of your trade:

* **Buying** (selling a quote asset like WETH/USDC for a token): the form shows **LIMIT BUY — "When price drops to …"**. Flip the **Stop buy** toggle to trigger on a rise instead.
* **Selling** (disposing of a token): the form shows **TAKE PROFIT — "When price climbs to …"**. Flip the **Stop sell** toggle to turn it into a **STOP SELL** (stop loss) that triggers on a drop.

Quick preset buttons (**±5% / ±10% / ±25%**) set the trigger relative to the current market price, or type an exact price.

![Limit buy](/files/7Kf6HqiMngfzebL5o76G)

## Creating an order

1. Open [app.alienbase.xyz/swap](https://app.alienbase.xyz/swap) and select the pair.
2. Switch the order form to **Limit**.
3. Enter the amount to sell (or use the 25% / 50% / Max buttons).
4. Set the trigger price — preset percentage or exact value.
5. If you want the stop variant, flip the **Stop buy** / **Stop sell** toggle.
6. Choose the expiry (default **1 week**) and slippage (default 0.5%).
7. Review → confirm in your wallet.

The order, if created via signature, will not be visible onchain. You'll find it under **Open orders** in the positions panel — with type, amount, trigger price, live distance to trigger, and time to expiry — and its trigger level is drawn directly on the chart. Filled and expired orders move to **Closed orders**.

![Open orders tab — a resting stop loss with its trigger line on the chart](/files/P2locNedArybWnMUqtGV)

## Take Profit and Stop Loss together

A common pattern is bracketing a position: a **Take Profit** at your target and a **Stop Loss** below your entry, each for the same balance. Whichever triggers first sells the position; cancel the other from **Open orders**.

![Take profit](/files/LGeBJuS8JobfB1xTuO5n)

![Stop loss](/files/jlT0b1lUGBplahTKIxLX)

## How execution works

Orders are not held by a centralized operator. They rest in the **Epsilon Router** contract on-chain ([`0x303c…2580`](https://basescan.org/address/0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580)), and the **Matcher** — Epsilon's execution engine — fills them when the trigger condition is met, routing the fill through whichever venue gives the best price at that moment (same engine as a regular swap).

Because triggering depends on observed market price and the fill routes through live liquidity, your slippage setting applies at execution time — exactly like a swap placed at that moment.

## Fees

Fees are tiered by asset class of the traded pair, plus a flat **0.05% Protocol execution fee** on every fill (see [Fees](/reference/fees) for the full schedule):

| Order type               | Stables | Blue chips | Everything else |
| ------------------------ | ------- | ---------- | --------------- |
| **Limit / Take Profit**  | 0.01%   | 0.05%      | 0.10%           |
| **Stop Loss / Stop Buy** | 0.10%   | 0.20%      | 0.45%           |
| *+ Protocol fee*         | *0.05%* | *0.05%*    | *0.05%*         |

Plus gas: you pay gas during approval, but not during order creation and cancellation; execution gas is handled by the Matcher.

## Expiry

Every order has an expiry (default **1 week**). If the trigger isn't hit before expiry, the order closes and will not be executed anymore. **Epsilon does not lock your funds.** Expired orders appear under **Closed orders**.

## What happened to Carbon Limit & Range orders?

Earlier versions of Alien Base offered Limit and Range orders powered by Bancor's Carbon protocol. Those are **deprecated** with the Epsilon Router upgrade: existing Carbon orders remain visible (and withdrawable) from your Dashboard, but new ones can't be created in the current app. See [Archive — Carbon Orders](/archive/carbon-orders).

## See also

* [Trailing Stop](/trading/trailing-stop) — a stop level that follows the price up.
* [DCA Orders](/trading/dca-orders) — split an entry/exit over time instead of one price.
* [Epsilon](/trading/epsilon) — the router + matcher underneath.
* [Fees](/reference/fees)


# Trailing Stop

A stop that follows the price up and fires on the way down

A **Trailing Stop** is a sell order whose trigger level follows the market price upward. Instead of a fixed stop price, you set a **trail percentage**; the stop rides the price up as it climbs and fires only when the price retraces by your trail amount from its peak.

It's the "let winners run, but lock in gains" order — previously only available on centralized exchanges, now fully on-chain via the [Epsilon Router](/trading/epsilon#the-epsilon-router).

> *Last updated: July 6, 2026.*

![Trailing stop](/files/4dkrhU8G9v2SVcnQiD7H)

## How it works

1. You place a sell order for a token and set **Trail by** — a percentage (e.g., 10%).
2. The order tracks the highest price observed since creation.
3. The **Fires at** level is always `peak price × (1 − trail%)`, shown live in the form.
4. If price keeps climbing, the fire level climbs with it — it never moves down.
5. When price retraces to the fire level, the **Matcher** executes the sell at the best available route.

```
   Price ▲
         │        peak ●
         │       ╱     ╲
         │  ●──╱        ╲ ← retrace hits trail % → SELL
         │ ╱    fire level rises with the peak
         │╱
         └──────────────────────▶ time
```

## Creating one

1. Open [app.alienbase.xyz/swap](https://app.alienbase.xyz/swap), pick the pair.
2. Order form → **Pro** → **Trailing Stop**.
3. Enter the amount to sell (25% / 50% / Max shortcuts available).
4. Set **Trail by** %. The form shows the current **Market** price and the resulting **Fires at** level.
5. Choose expiry (default **1 week**) and slippage (default 0.5%).
6. Confirm in your wallet. The order appears under **Open orders**.

## Choosing a trail percentage

* **Tight trails (2–5%)** lock in gains quickly but get stopped out by normal volatility — suited to stable pairs or short-horizon trades.
* **Medium trails (8–15%)** survive typical intraday noise on mid-caps.
* **Wide trails (20%+)** are for volatile small caps and memecoins, where 10% wicks are routine.

A useful rule: set the trail wider than the token's typical daily range, or ordinary chop will trigger the stop.

## Trailing stop vs. fixed stop loss

|          | Fixed [Stop Loss](/trading/limit-orders) | Trailing Stop                |
| -------- | ---------------------------------------- | ---------------------------- |
| Trigger  | Fixed price                              | Follows the peak             |
| Protects | Your entry / a chosen floor              | Accumulated unrealized gains |
| Best for | Defined invalidation level               | Riding trends                |

## Fees

Trailing Stops use the stop-order fee schedule, tiered by asset class, plus the flat 0.05% Protocol execution fee (full table on [Fees](/reference/fees)):

| Stables       | Blue chips    | Everything else |
| ------------- | ------------- | --------------- |
| 0.10% + 0.05% | 0.20% + 0.05% | 0.45% + 0.05%   |

Plus gas at creation and cancellation; execution gas is handled by the Matcher.

## See also

* [Limit, Take Profit & Stop Loss](/trading/limit-orders) — fixed-price triggers.
* [DCA Orders](/trading/dca-orders) — time-based selling instead of price-based.
* [Epsilon](/trading/epsilon) — the execution engine.


# DCA Orders

Split a trade across time — with optional trigger price and stop loss

A DCA (Dollar-Cost-Average) order splits a single buy or sell into many smaller trades executed at regular intervals. It's the simplest way to enter or exit a large position without timing the market and without taking the price impact in one shot — and with the Epsilon Router upgrade it gained **trigger prices** and **stop-loss protection**.

> *Last updated: July 6, 2026.*

![DCA order](/files/teUlNkULFsyWeuOTqAqp)

## Creating a DCA

1. Open [app.alienbase.xyz/swap](https://app.alienbase.xyz/swap), pick the pair.
2. Order form → **Pro** → **DCA**.
3. **Total to sell** — the full amount to be split (25% / 50% / Max shortcuts available).
4. **Finishes in** — the total duration (default **1 week**).
5. **Sells every** — the interval between chunks (default **1 hour**). Duration ÷ interval = number of trades.
6. (Optional) **+ Trigger price** — the DCA stays dormant until the market reaches this price, then starts executing.
7. Set slippage (default 0.5%) and confirm.

The order rests on-chain in the [Epsilon Router](/trading/epsilon#the-epsilon-router). At each interval the **Matcher** executes one chunk, routed through whichever venue gives the best price at that moment. Track progress in the **Active DCAs** tab of the positions panel: chunks completed, amount sold, average fill price, amount received, and countdown to the next order.

![Active DCAs tab — a running DCA with progress and next-order countdown](/files/oEqI1pGuyuvzUgt25AQO)

## Triggered & Short-circuit DCA

When using a trigger price, DCA orders act as gradual stop loss/take profit orders: they are only executed when the price reaches your pre-defined trigger. Through the "Keep Selling" setting you can also finetune its behavior: by default, DCAs are **short-circuiting** and will continue the full trade schedule as soon as the trigger is hit just once. By flipping the setting, you can ensure that each individual order is only executed if the trigger is currently active. This can be great to set up sturdy stop loss orders that do not get filled prematurely on wicks.

## When to use a DCA

* You're entering or exiting a large position and don't want to move the market in one trade.
* You're nervous about timing — DCA averages your entry across many ticks.
* You want "buy the breakout, slowly": set a trigger price above market and let the DCA start only if the level is claimed.

## When *not* to use a DCA

* You've decided this is the price you want — use a [Limit order](/trading/limit-orders) instead.
* You expect a binary event (catalyst, unlock) — DCA's averaging works against you here.
* You want to protect gains on an existing position — use a [Trailing Stop](/trading/trailing-stop).

## Fees

DCA fees are charged per executed chunk, tiered by asset class, plus a flat **0.05% Protocol execution fee** per fill (full table on [Fees](/reference/fees)):

| Order type                  | Stables | Blue chips | Everything else |
| --------------------------- | ------- | ---------- | --------------- |
| **DCA chunk**               | 0.01%   | 0.10%      | 0.20%           |
| **DCA stop-loss execution** | 0.10%   | 0.20%      | 0.45%           |
| *+ Protocol fee*            | *0.05%* | *0.05%*    | *0.05%*         |

Plus the underlying pool fee on whichever venue the chunk routes through, and gas for the initial approval step (placing orders is gasless, and execution gas is handled by the Matcher).

## See also

* [Limit, Take Profit & Stop Loss](/trading/limit-orders) — precise-price entries and exits.
* [Trailing Stop](/trading/trailing-stop) — price-based selling instead of time-based.
* [Epsilon](/trading/epsilon) — the router + matcher underneath.
* [Fees](/reference/fees)


# Epsilon

Alien Base's meta-aggregator and on-chain order engine

**Epsilon** is Alien Base's trading engine. It has two halves:

1. The **meta-aggregator** — the aggregator of aggregators. Every swap quote scans all supported venues on Base and routes through whichever combination delivers the best execution.
2. The **Epsilon Router** — the on-chain contract where resting orders (Limit, Take Profit, Stop Loss, Trailing Stop, DCA) live, paired with the **Matcher** that executes them.

> *Last updated: July 6, 2026.*

## The meta-aggregator

For each swap quote, Epsilon:

1. Pulls live quotes from every integrated DEX and aggregator on Base.
2. Considers single-hop, multi-hop, and split routes.
3. Subtracts the fee for each route (gas, pool fees, platform fee).
4. Returns the best net-of-fees price to the trader.

In nearly every case, the route Epsilon picks beats trading directly on any individual DEX — including Alien Base's own pools — because Epsilon can split a single trade across multiple pools to minimize price impact.

### Supported venues

DEX coverage (the venues whose pool liquidity Epsilon can route through):

| Venue                        | Type       |
| ---------------------------- | ---------- |
| Alien Base V2 / V3           | Native AMM |
| Uniswap                      | DEX        |
| Aerodrome                    | DEX        |
| PancakeSwap                  | DEX        |
| SushiSwap                    | DEX        |
| (Other DEXs via aggregators) |            |

Aggregator providers Epsilon can compare quotes against:

| Provider  | Type       |
| --------- | ---------- |
| OpenOcean | Aggregator |
| Odos      | Aggregator |
| 0x        | Aggregator |
| Bebop     | Aggregator |

Additional venues are added as Base's liquidity landscape evolves; the routing engine is configured server-side.

## The Epsilon Router

The Epsilon Router moves Epsilon's execution logic on-chain. Deployed at [`0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580`](https://basescan.org/address/0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580) (verified source on Basescan), it is the contract that holds and settles every resting order:

* [**Limit / Take Profit / Stop Loss / Stop Buy**](/trading/limit-orders) — fixed-price triggers, buy or sell side.
* [**Trailing Stop**](/trading/trailing-stop) — a stop level that follows the price up.
* [**DCA**](/trading/dca-orders) — time-sliced execution, with optional trigger price and stop-loss abort.

The Router has been **audited by** [**Hexens**](https://hexens.io/) (final report June 2026, before launch); the full report is published on [Audits & Security](/reference/audits-and-security#epsilon-router--audited-by-hexens).

### The Matcher

Resting orders don't execute themselves. The **Matcher** is Epsilon's execution engine: it watches trigger conditions and, when one is met, fills the order through the meta-aggregator — the same best-route logic as a live swap. You pay gas only for approvals, while order creation is gasless. Execution gas is the Matcher's problem.

## Fees

Every trade Epsilon executes — swap or resting order — pays a platform fee tiered by asset class, plus the flat **0.05% Protocol execution fee**, on top of the underlying pool fees of whichever venues the route touches:

| Trade type                                           | Stables | Blue chips | Everything else |
| ---------------------------------------------------- | ------- | ---------- | --------------- |
| Swap                                                 | 0.01%   | 0.05%      | 0.15%           |
| Limit / Take Profit                                  | 0.01%   | 0.05%      | 0.10%           |
| Stop Loss / Stop Buy / Trailing Stop / DCA stop-loss | 0.10%   | 0.20%      | 0.45%           |
| DCA chunk                                            | 0.01%   | 0.10%      | 0.20%           |
| *+ Matcher execution fee (all of the above)*         | *0.05%* | *0.05%*    | *0.05%*         |

Full breakdown: [Fees](/reference/fees).

All Epsilon fees accrue to the protocol share — routed to the Treasury and the esALB Real Yield stream.

## Explorer (Epsilon Analytics)

Epsilon's data layer also powers the chain-wide **Explorer**. See [Explorer](/trading/epsilon-analytics).

## See also

* [Trading Terminal & Swap](/trading/swap)
* [Limit, Take Profit & Stop Loss](/trading/limit-orders) · [Trailing Stop](/trading/trailing-stop) · [DCA Orders](/trading/dca-orders)
* [Fees](/reference/fees)
* [Audits & Security](/reference/audits-and-security)


# Explorer (Epsilon Analytics)

Chain-wide explorer for tokens, pools, and trades on Base

The **Explorer** (in the dApp sidebar) is Alien Base's chain-wide data explorer, powered by Epsilon's data layer. Every token on Base, every pool on every DEX, every trade — searchable, with safety checks built in.

![Explorer](/files/2A81mi0O6w7tcb4DUDCG)

> *Last updated: July 6, 2026.* Launched May 2025 as "Epsilon Analytics".

## What it does

Three core surfaces:

* **Overview** — top pairs by volume, liquidity, and price action across the whole of Base. Filterable by DEX (Alien Base / Uniswap / Aerodrome / PancakeSwap / Sushiswap / Others), with Trending / Gainers / Losers / New tokens highlights and a configurable time window (1h / 4h / 12h / 24h). Table columns include price change across five windows, volume, market cap, holders, liquidity, transaction count, trader count, pair age, and time since last trade.
* **Token detail** — for any token: live price, charts, holder distribution, top pools, top trades, and an automated **GoPlus safety check** flagging things like honeypot risk, owner-can-mint, blacklist functions, and so on.
* **Pool detail** — for any pool on any supported venue: TVL, 24h volume, fee tier, and recent trades.

![Token detail — chart, pool balance, live transactions, holders, and price scenarios (here a WETH/USDC pool on another DEX — the Explorer covers all of Base)](/files/M6mR9qLzgk6UlhLZMOgT)

Powerful filtering (Token Filters panel) lets you slice on price, liquidity, market cap, holder count, age, txn count, dev address, "show risky tokens" toggle, and more. Useful for systematic discovery; brutal for memecoin hunters.

Access via the **Explorer** entry in the dApp sidebar, or directly at [app.alienbase.xyz/info](https://app.alienbase.xyz/info).

## Why it exists

Most "DEX analytics" sites are surface-level — they list pairs, charts, maybe volumes. The Explorer is built on the same data layer that Epsilon uses for routing, which means:

* It sees **every** pool on Base, not just the most active ones.
* Token-safety signals are native; you don't need to open a separate site.
* Charts and pool stats are consistent with what the swap engine sees, so quoted prices and analytics prices match. The same data feeds the TradingView chart and token search inside the [trading terminal](/trading/swap).

## Roadmap

The next-phase Explorer work, called out on the [Roadmap](/roadmap):

* **On-chart order overlays + PnL tracking** on top of the TradingView integration already live in the terminal.
* **Wallet-cluster analysis** — multi-wallets per user, bot detection, whale activity, team-sell detection.

## See also

* [Epsilon](/trading/epsilon) — the routing engine that shares the Explorer's data layer.
* [Trading Terminal & Swap](/trading/swap) — where the same data surfaces per-pair.
* [GoPlus security API](https://gopluslabs.io/) — the third-party safety-signals provider.


# Vaults overview

One page for every yield-bearing position on Alien Base

The **Vaults** page ([app.alienbase.xyz/vaults](https://app.alienbase.xyz/vaults)) is the central UI surface for every yield-bearing position you hold on Alien Base. It has three tabs:

* **Vaults** — V3 strategy vaults (Bunni-wrapped concentrated liquidity), 130+ live.
* **Locked earn** — esALB and escrowed-LP single-stake positions.
* **Legacy farms** — the old V2 MasterChef farms, kept for withdrawal.

> *Last updated: July 6, 2026.* Vaults launched January 2026 (replacing the legacy Farms tab) and were redesigned with the July 2026 app upgrade.

![Vaults page](/files/J1A7WPRk6bNNdai7Pthp)

## Vaults tab

Each vault is a static-range V3 LP position wrapped as an ERC-20 by [Bunni](/liquidity/bunni), tagged with a named **strategy** that tells you how tight its range is:

| Strategy         | Range style                                            | Trade-off                                                       |
| ---------------- | ------------------------------------------------------ | --------------------------------------------------------------- |
| **Wide**         | Broad range, sized on up to \~2 years of price history | Lower APR, rarely goes out of range                             |
| **Narrow**       | Tighter range                                          | Higher fee capture, needs occasional migration                  |
| **Ultra Narrow** | Very tight range (stables, correlated pairs)           | Highest capital efficiency; out-of-range risk on volatile pairs |
| **Classic V3**   | Standard concentrated range                            | The original V3 vault style                                     |

The page header shows platform-wide **TVL / Volume / Fees**, plus your **Total deposited** and **Claimables** with a **Claim all** button. Each row shows the pool, fee tier, strategy tag, volume, fees, TVL, and APR — including the boosted ALB-rewards APR where active.

Filters: **All strategies / My positions / In range / Out of range / With rewards**, plus strategy-type tabs (All / Wide / Narrow / Ultra Narrow / Classic V3).

### Depositing

1. Connect wallet.
2. Find a vault (filter or search) → click **Add**.
3. Choose the asset and amount — the Zap flow takes a single asset (e.g., ETH or USDC), splits it appropriately, and creates the LP position in one transaction.
4. Approve (one-time per token) → confirm.
5. The position appears under **My positions**; rewards accrue immediately.

![My positions — deposited vaults with staked value, fees, and claimable rewards](/files/JJASooZC6tQ1NG8Ir1ZD)

### Range lifecycle

When a vault's range gets close to its bounds, a new vault is deployed with refreshed bounds. Old vaults remain available so existing depositors can decide whether to migrate — the **Out of range** filter surfaces positions that need attention.

## Locked earn tab

Single-stake escrowed positions (see [esALB](/alb-and-esalb/escrowed-alb-esalb) for the full mechanics):

| Position                   | What it is                                                                                  |
| -------------------------- | ------------------------------------------------------------------------------------------- |
| **esALB**                  | Locked ALB. Earns unlocked ALB emissions + Real Yield (WETH); APR is shown split by source. |
| **ALB-WETH LP (Infinite)** | Escrowed LP: lock ALB-WETH LP tokens for boosted rewards.                                   |
| **ALB-WETH LP (Backstop)** | Escrowed LP variant that acts as protocol backstop liquidity.                               |

The tab header tracks your **Total staking** and **Total earned**, with a **Harvest all** button.

![Locked earn](/files/4utQO0AWy85kQsMAl33n)

## Legacy farms tab

The pre-2026 V2 MasterChef farms (ALB-ETH, ETH-USDbC, and others). Emissions to these farms have wound down under [AIP-5](/alb-and-esalb/alien-base-2-0) — multipliers sit at 0x — so this tab exists mainly for **unstaking legacy positions**. New liquidity should go to the Vaults tab.

## New position (raw V2 / V3)

For LPs who want full control — pick your own pair, fee tier, and range — the **New position** button opens the manual flow with a **V2 / V3** selector. See [Concentrated Liquidity (V3)](/liquidity/v3) and [V2 Pools](/liquidity/v2-pools).

## Mothership

Actively-managed multi-range vaults arrive with [Mothership](/liquidity/mothership), Alien Base's in-house ALM (audit in flight). Mothership-managed vaults will appear on this same page.

## See also

* [Concentrated Liquidity (V3)](/liquidity/v3)
* [Bunni explainer](/liquidity/bunni)
* [V2 Pools (legacy)](/liquidity/v2-pools)
* [Mothership](/liquidity/mothership)
* [esALB](/alb-and-esalb/escrowed-alb-esalb)


# Concentrated Liquidity (V3)

Concentrated liquidity on Alien Base

Alien Base V3 implements Uniswap V3-style **concentrated liquidity**: instead of spreading your capital across the whole price curve, you pick a price range and concentrate your liquidity there. The result is much higher capital efficiency at the cost of being out-of-range when price moves outside your bounds.

> *Last updated: July 6, 2026.*

## Fee tiers

Alien Base V3 supports **seven fee tiers**. The right choice depends on the volatility of the pair:

| Fee        | Best for                                                |
| ---------- | ------------------------------------------------------- |
| **0.01%**  | Tightly-pegged stablecoin pairs (USDC/USDbC, USDC/USDT) |
| **0.02%**  | Standard stablecoin pairs                               |
| **0.03%**  | LSTs and very-blue-chip volatile pairs (ETH/cbETH)      |
| **0.04%**  | Wider-spread stable / LSD pairs                         |
| **0.075%** | Blue chips (ETH, BTC and wrapped variants)              |
| **0.30%**  | Mid-cap and standard tokens                             |
| **1.00%**  | Small-cap and memecoin pairs                            |

Each pool collects its tier on every swap. Pool fees are split **50% to LPs / 50% to esALB stakers** as Real Yield (paid in WETH and the underlying tokens). Full breakdown: [Fees](/reference/fees).

## How concentrated liquidity works

* Each LP position has a **lower price** and an **upper price**.
* While the market price is **inside** the range, the position earns trading fees and oscillates between the two assets.
* While **outside** the range, the position holds 100% of one asset and earns no fees.

A narrower range = more fees per dollar **when in range**, more frequent re-balancing needed. A wider range = fewer fees per dollar **but** less attention required.

Choose ranges that match your view of where the asset will trade.

## Two ways to provide V3 liquidity

### Option A — Vaults (Bunni-wrapped, recommended for most users)

Use the [Vaults](/liquidity/vaults) page. Pick a pre-configured strategy (Wide / Narrow / Ultra Narrow / Classic V3), deposit, and earn pool fees + ALB rewards. The position is wrapped as an ERC-20 share by [Bunni](/liquidity/bunni), which means:

* No NFT to manage.
* Composable — can be staked, locked, or used elsewhere.
* One-click Zap-in from any asset.

Range bounds are managed at the Vault level. When a Vault gets close to its bounds, a new Vault with refreshed bounds is deployed.

### Option B — Manual V3 (full control)

![New position page](/files/TM5qLYfFbYHRdidR2dOl)

Click **New position** on the [Vaults](/liquidity/vaults) or Dashboard page. Pick **V2 or V3** with the selector, choose your pair, fee tier, lower price, and upper price. The V3 position is created as a Uniswap-style NFT. You can:

* Choose any range you want.
* Add or remove liquidity at will.
* Collect fees independently.
* Re-balance manually as the market moves.

The trade-off: you get full flexibility but the position is **not** automatically eligible for ALB farm rewards (those are paid on Bunni-wrapped Vaults), and you have to actively manage the range.

## When out-of-range happens

If price exits your range:

* Your position holds 100% of whichever asset is on the "wrong" side.
* You stop earning fees.
* You're effectively long the asset (or paid in the asset) at your range boundary.

To re-engage, either:

* Wait for price to come back into range, or
* Withdraw and re-deposit into a new range.

For Bunni Vaults, the protocol manages this at the Vault level: if a Vault drifts toward its boundary, a fresh Vault is launched. You can migrate when convenient — but no automatic migration happens. (That's exactly the gap [Mothership](/liquidity/mothership) is designed to fill, with active strategies that re-balance on your behalf.)

## Source code

* V3 core: forked from Uniswap V3.
* ERC-20 wrapping: forked from Bunni / Timeless Finance.
* Repos: [`alienbase-xyz`](https://github.com/alienbase-xyz/) (see Bunni-\* repos).

Audit lineage: see [Audits & Security — V3 / Bunni](/reference/audits-and-security).

## See also

* [Vaults overview](/liquidity/vaults)
* [Bunni explainer](/liquidity/bunni)
* [V2 Pools (legacy)](/liquidity/v2-pools)
* [Mothership](/liquidity/mothership)


# Bunni explainer

Why Alien Base wraps V3 positions as ERC-20 share tokens

**Bunni** is a Uniswap V3 wrapper developed by [Timeless Finance](https://timelessfi.com/). It turns each V3 LP position from an NFT into an **ERC-20 share token** — making concentrated-liquidity positions composable, transferable, and farmable.

> *Last updated: July 6, 2026.* Alien Base ships a fork of Bunni alongside its V3 stack.

## Why wrap V3 positions

Native Uniswap V3 represents each LP position as an **ERC-721 NFT**. That's expressive (every position is unique) but it's a pain to compose with the rest of DeFi:

* Most farming contracts expect ERC-20 tokens, not NFTs.
* NFTs don't aggregate cleanly — you can't "pool" 100 different NFTs together.
* Per-user NFT positions mean the protocol can't farm on behalf of users, only on per-NFT bases.

Bunni solves this by deploying a single **Vault** per `(token0, token1, fee tier, range)` tuple. When you deposit into the Vault, the Vault holds the NFT and gives you an ERC-20 share token in return. Now:

* Many users share the same NFT, pooled by the Vault.
* The Vault's share token is a normal ERC-20 — farmable, transferable, composable.
* New ranges are simple: deploy a new Vault, users migrate at will.

## How Alien Base uses Bunni

Every Vault entry on the [Vaults](/liquidity/vaults) page that's labeled "V3" or "Bunni" uses this pattern. The flow is:

1. You Zap or Deposit into the Vault.
2. The Vault holds your share of the underlying V3 NFT.
3. You receive Bunni share tokens.
4. The share tokens need to be staked into the Alien Base farming distributor for ALB rewards (auto-staking is in the roadmap).

When you withdraw, the inverse happens: the share tokens redeem against the Vault's NFT, your share of the underlying liquidity is returned to your wallet.

## Range management

A Bunni Vault has a **fixed price range** for its underlying V3 NFT. Range design follows three categories:

* **Wide** — analyzed against up to 2 years of price history; designed to stay in range for another 1–2 years.
* **Narrow** — more aggressive; can drift out of range in weeks or months on volatile pairs.
* **Stable / LSD** — very tight ranges suited for pairs that rarely deviate (USDC/USDT, ETH/cbETH, etc.).

When a Vault drifts close to its boundary, a **new** Vault with refreshed bounds is deployed. Existing depositors can stay (and accept being out-of-range eventually) or migrate to the new Vault.

This is by design: predictable bounds let LPs reason about their position rather than being silently rebalanced. The trade-off — having to manually migrate — is what [Mothership](/liquidity/mothership) is built to automate.

## Source code

* Upstream: [`timeless-fi/bunni`](https://github.com/timeless-fi/bunni)
* Alien Base fork: [`alienbase-xyz/bunni`](https://github.com/alienbase-xyz/bunni) and [`alienbase-xyz/bunniv2`](https://github.com/alienbase-xyz/bunniv2)
* Zap helper: [`alienbase-xyz/BunniZap`](https://github.com/alienbase-xyz/BunniZap) (lightly adapted from upstream BunniZap)

## Audits

Alien Base's BunniHub code has slightly modified parameters and contains an important bug fix missing in the original protocol. The BunniZap is **lightly adapted** and shares most of its lineage with the audited upstream zap. Full lineage and links: [Audits & Security](/reference/audits-and-security).

## See also

* [Vaults overview](/liquidity/vaults)
* [Concentrated Liquidity (V3)](/liquidity/v3)
* [Mothership](/liquidity/mothership) — automates what Bunni Vaults leave manual.


# V2 Pools (legacy)

The original Alien Base AMM — Uniswap V2 fork

V2 pools are the original Alien Base liquidity venue. Built on Uniswap V2 contracts, launched at TGE in **August 2023**.

> *Last updated: July 6, 2026.*

## When to use V2

* **Trading any pair you can't (or won't) actively manage.** V2 is constant-product (`x * y = k`) — no ranges, no concentrated liquidity, no out-of-range states.
* **Memecoins and small caps.** V2 is forgiving of price discovery and has the simplest LP UX.
* **Set-and-forget LPing.** No active management, no rebalance, no out-of-range risk.

## Mechanics

* **50/50 deposit.** You provide both tokens in equal value at the current price.
* **Full-range exposure.** Your liquidity is active across every price point, from zero to infinity.
* **Pool fee.** **0.16%** per swap, paid by the taker and distributed to LPs. The V2 Factory's `feeToSetter` is the DAO Multisig — the protocol-side carve-out can be enabled by DAO vote.
* **LP token.** Standard ERC-20. Stakeable, transferable, farmable.

## Where to find them

* **Trade.** The [trading terminal](https://app.alienbase.xyz/swap) routes through V2 automatically when it's the best venue.
* **LP.** **New position** (on the [Vaults](https://app.alienbase.xyz/vaults) or Dashboard page) → select **V2** — add or remove V2 liquidity directly.
* **Farm.** The old V2 farms live under **Vaults → Legacy farms**; their emissions have wound down under AIP-5, so the tab is mainly for unstaking. See [Vaults](/liquidity/vaults#legacy-farms-tab).

## Why "legacy"?

By using a Bunni wrapper set to an infinite range, we can achieve the same effective impact of a traditional V2 position. Because of that, V2 vaults have been gradually deprecated over the years.

## See also

* [Concentrated Liquidity (V3)](/liquidity/v3) — the higher-efficiency alternative.
* [Vaults overview](/liquidity/vaults)
* [Token Generator](/builders/token-generator) — the easiest path from "I have an idea" to "my token has a V2 pool".
* [Contracts](/reference/contracts) — V2 Factory, Router, Farm addresses.


# Mothership (pre-launch)

Alien Base's automated liquidity manager — the next-gen Vault layer

**Mothership** is Alien Base's purpose-built **Automated Liquidity Manager (ALM)**. It's the first protocol Alien Base has written from scratch (no upstream fork). Mothership turns passive concentrated-liquidity Vaults into actively managed strategies that re-balance ranges and re-allocate capital on the fly.

> *Last updated: July 6, 2026.* Mothership is **pre-launch** as of the time of writing — audit in flight, alpha imminent. Everything below describes the design; details may shift before launch.

## What Mothership is

A modular ALM with a **strategy-plugin architecture**. Each plugin is a smart contract that implements a defined set of tools (e.g., "manage multiple V3 Positions in a single vault"). Mothership routes user deposits into the strategy of their choice, and the strategy actively manages the underlying V3 NFT(s) on the user's behalf.

Concretely:

* **Multi-range positions.** A single Mothership strategy can hold multiple V3 ranges simultaneously, with arbitrary weights.
* **Auto-rebalance.** The strategist defines the rebalancing logic. Users do not need to touch anything.
* **Signal-driven.** Strategies can use volatility data, time-of-day patterns, or external signals to allocate capital.
* **Composable.** Mothership shares are ERC-20 — fully composable in DeFi.

## How it differs from Bunni Vaults

|                 | Bunni Vault                                 | Mothership Vault                                            |
| --------------- | ------------------------------------------- | ----------------------------------------------------------- |
| Range           | Fixed at deploy time                        | Dynamic per strategy                                        |
| Rebalance       | User migrates manually when bounds drift    | Strategy rebalances automatically                           |
| Granularity     | Single range, single fee tier               | Multi-range, multi-tier possible                            |
| Strategy author | Protocol (range definition)                 | Anyone (in the future marketplace)                          |
| Best for        | LPs who want predictable bounds and low gas | LPs who want max-yield + are willing to delegate management |

Both will coexist on the [Vaults](/liquidity/vaults) page once Mothership ships. They're not competing; they serve different LP profiles.

## Public alpha — what to expect

The first public release will run with **strict supply caps** until the audit completes its formal review and the team is comfortable expanding capacity:

* A small number of curated strategies, single-pair to start.
* Capped per-Vault TVL.
* Conservative range parameters.
* Active monitoring; emergency-pause readiness.

The caps are not a permanent feature — they're a launch-safety mechanism. They'll lift as the team gains operational confidence and the audit closes.

## The marketplace vision

Mothership's strategy-plugin design is intentional. The end-state is a **marketplace of liquidity managers**:

* Third-party strategists publish their own strategies (separate contracts implementing the Mothership interface).
* Users browse, compare historical performance, and allocate capital to strategies they trust.
* Strategists earn fees on the assets under management.
* The protocol takes a small slice of those fees as Real Yield to esALB.

This is a long-term roadmap item — see [Roadmap](/roadmap). The MVP is single-strategy, team-published. The marketplace turns on after the protocol matures.

## Audit status

**Audit in flight.** Pre-audit hardening is visible in the public Mothership repo: extensive fuzz tests and an `audit-scope` commit dated January 2026 marking the contracts the auditor is reviewing. The audit will complete before the MVP is publicly accessible without supply caps. Full audit framing: [Audits & Security](/reference/audits-and-security).

## See also

* [Vaults overview](/liquidity/vaults)
* [Concentrated Liquidity (V3)](/liquidity/v3)
* [Bunni explainer](/liquidity/bunni) — Mothership builds on the same V3 substrate, but adds active management.
* [Roadmap](/roadmap)
* [Audits & Security](/reference/audits-and-security)


# ALB Token

ALB tokenomics, emission history, and value flow

ALB is the native token of Alien Base — used for governance, staking, liquidity incentives, and the platform's Real Yield rewards system.

> *Last updated: July 6, 2026.*

## At a glance

|                        |                                                                                                                       |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Token contract         | [`0x1dd2d631c92b1aCdFCDd51A0F7145A50130050C4`](https://basescan.org/token/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4) |
| Standard               | ERC-20 (18 decimals), OpenZeppelin AccessControl                                                                      |
| Network                | Base (chain id 8453)                                                                                                  |
| Token Generation Event | August 8, 2023                                                                                                        |
| Current max supply     | 510,000,000 ALB                                                                                                       |
| Currently minted       | \~465,000,000 ALB (\~91% of cap)                                                                                      |
| Circulating supply     | \~234,000,000 ALB (\~46% of cap)                                                                                      |
| Mint timelock          | 14 days (no insider mint without delay)                                                                               |

For up-to-date market data: [CoinGecko](https://www.coingecko.com/en/coins/alienbase) · [DexScreener](https://dexscreener.com/base/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4) · [DefiLlama](https://defillama.com/protocol/alien-base-v3).

## What ALB is for

* **Governance.** ALB locked into [esALB](/alb-and-esalb/escrowed-alb-esalb) carries voting power on Snapshot. Soon, [govALB](#alien-base-2-0-aip-5) will offer 10× voting weight in exchange for a 2-year lock.
* **Real Yield.** esALB stakers earn a share of protocol fees, paid in **WETH** and other liquid assets — not in extra ALB. This is the heart of the value-distribution model: the protocol's revenue goes back to long-term holders.
* **Liquidity incentives.** Active LPs in V2 and V3 vaults earn ALB emissions on top of pool fees. (Note: [AIP-5](https://snapshot.org/#/alienbase-dex.eth/proposal/0x9328ecc5a0d2527a1e73fd30085e7ba2120a985b7782ce843f15ee2ddf38ca63) replaces farming with a Protocol-Owned-Liquidity model — see below.)
* **Single-staking.** Lock ALB → esALB and stake esALB to earn unlocked ALB rewards.

## Emission history

Alien Base's emission schedule has changed several times since launch as the DAO matured. The numbers below are the actual schedule in effect, not the original launch-day plan.

| Date       | Rate                                            | Trigger                                                                                                                                                                                                              |
| ---------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 2023-08-08 | 15 ALB/sec (launch)                             | TGE                                                                                                                                                                                                                  |
| 2023-08-19 | **8 ALB/sec**                                   | [AIP-1 (de facto)](https://snapshot.org/#/alienbase-dex.eth/proposal/0x56c418fd7f7fd365b0beba44389807941e3150fb376179ac758fb497f04a999b) — emergency 46% cut after sniper bots captured the initial liquidity supply |
| 2023-11-27 | 10.5 ALB/sec (briefly), then tapered toward 7.5 | [AIP-2](https://snapshot.org/#/alienbase-dex.eth/proposal/0xea788bd0daf9fb61acb0199874abc56f9c871cc2e117c3c1c11a45ba1ced7f52) — V3 launch boost program                                                              |
| 2024-09    | **3.75 ALB/sec**                                | 2nd halving — confirmed in [AIP-3](https://medium.com/@alienbase/aip-3-establishing-dao-budget-for-2nd-halving-cycle-8092e0039cfd)                                                                                   |
| 2025-06    | \~1.875 ALB/sec (yearly inflation 30% → 15%)    | 3rd halving — confirmed in the [Oct 2025 roadmap retrospective](https://medium.com/@alienbase/alien-base-roadmap-plotting-the-next-phase-of-the-invasion-11ede525e2ea)                                               |
| 2026-04    | **Flexible emissions, no fixed halving**        | [AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2) — replaces farming with POL fund + buyback-and-burn                                                                                |

Today, **\~91% of the original 510M cap has been minted** (\~465M ALB, of which \~234M circulates and the rest is locked as esALB). The team cannot mint additional ALB without going through the 14-day timelock; farming emission parameters are also timelocked for 7 days.

> The original "halving every 9 months" schedule was a launch-time plan. As the project matured, the DAO adjusted the path twice (AIP-3, AIP-4) to align emissions with revenue, and finally replaced the halving model entirely (AIP-5) with a flexible system tied to protocol earnings.

## Value flow (Real Yield)

```
            Trading on Alien Base
                      │
                      ▼
              Pool fees (V2 / V3)
                      │
        ┌─────────────┼──────────────┐
        ▼             ▼              ▼
       LPs       Protocol share   Epsilon fees
        │             │           (swaps + orders)
        │             │              │
        │             ▼◄─────────────┘
        │     ┌───────┴─────────────────┐
        │     ▼               ▼         ▼
        │  esALB stakers    DAO     POL Fund
        │  (Real Yield in   treasury  (per AIP-5,
        │  WETH + tokens)             buyback & burn)
        ▼
      LP rewards (ALB emissions, ramping down per AIP-5)
```

V3 pool fees are split **50/50 between LPs and esALB stakers**; Epsilon swap and order fees accrue entirely to the protocol share, which funds the esALB Real Yield stream, the DAO treasury, and (under AIP-5) the POL fund.

The full fee table — V2, V3 tiers, Epsilon swaps, Epsilon Router orders (Limit / Stop / Trailing Stop / DCA), Token Generator — is on the [Fees](/reference/fees) page.

## Initial supply & distribution

The initial 26 million ALB (\~5.1% of the cap) was minted at launch, of which 1 million seeded the original V2 launch liquidity pool. The remaining 25 million was directed to a timelock contract because sniper-bot activity made the planned full liquidity-pool seed impossible at launch.

| Bucket                       | Size                                                                                                                                            | Use                                                                                                                            |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Initial mint                 | 26 M                                                                                                                                            | 1 M seeded V2 launch LP; 25 M sent to timelock                                                                                 |
| Timelock allocation — growth | 20 M                                                                                                                                            | Fundraising, marketing, market-making for ALB liquidity                                                                        |
| Timelock allocation — team   | 5 M                                                                                                                                             | Distributed to the team via vesting contracts (deployed as `VestingFactory` in 2025-06; see [Vesting](/alb-and-esalb/vesting)) |
| Farming emissions — team     | 15% of new emissions (lowered to 10% in AIP-3)                                                                                                  | Operating budget (salaries, infra, incentivization)                                                                            |
| Farming emissions — DAO      | 15% of new emissions (raised to 20% in [AIP-3](https://medium.com/@alienbase/aip-3-establishing-dao-budget-for-2nd-halving-cycle-8092e0039cfd)) | Long-term treasury & marketing                                                                                                 |

The original timelock transactions for the 25 M are at:

* [`0x44d3753e…aca9`](https://basescan.org/tx/0x44d3753e8e0e104f4751665af885c77fc8ee338abd377496cb33b1a35b10aca9)
* [`0x59365156…d278`](https://basescan.org/tx/0x5936515cc428ce9d66396d995b490f059da4152c182e1e8f42dc7ce6a38fd278)
* [`0x079a3f09…540d`](https://basescan.org/tx/0x079a3f09c533fd61768cfb88d2fdf21effd67c4311819974ddc446b342b5540d)

## DAO operating budget (current)

The team has a transparent monthly budget approved by DAO vote. The most recent published cycle was governed by [ADIP-01](https://snapshot.org/#/alienbase-dex.eth/proposal/0xae936ad8ddb58b90128ff8da95bb6edded6188ba4c87f2ea724d771cfcc17cac) (Sept 2025 → Feb 2026); team funding is transitioning to the [AIP-5 Line-of-Credit model](#alien-base-2-0-aip-5). The ADIP-01 structure:

* $200,000 USDC reserve, allocated as Infrastructure $48k / Liquidity & Incentives $40k / Strategic Savings $112k
* $42,500 revenue-funded growth: Dev & Security $15k, Legal $12.5k, Marketing $10k, Grants $5k
* 1,000,000 ALB/month dev allowance + 1,000,000 ALB/month POL contribution

The team uses bots to TWAP-sell its ALB allocation slowly — both to avoid impacting price and to keep sells unpredictable to MEV. There's no scheduled cliff and no surprise dump.

## Alien Base 2.0 (AIP-5)

[AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2) — passed April 2026 — is a full tokenomics rewrite. Highlights:

* **Replaces farming with a Protocol-Owned-Liquidity (POL) Fund.** Stablecoins, blue chips, Base-native assets, and Alien Base LPs. POL yield is used for buyback-and-burn ALB.
* **Replaces fixed halvings with flexible emissions** tied to protocol earnings.
* **Dev Line of Credit (LoC):** the dev allowance becomes tracked debt with interest paid to esALB holders. Price-tier grant tranches at $0.40, $1, and $2 (via moving averages) unlock dev funding only when ALB sustains those price levels.
* **Splits governance** into **Alien Base DAO** (governs onchain contracts) and **Alien Labs** (offchain product, frontend, revenue).
* **govALB:** a new staked-escrow form of esALB with **10× voting power**, 1× earning power, and a \~2-year effective lock.
* **Supply cap raised** (one-time) from **510,000,000 → 1,051,000,000** ALB. Direct allocation increase = 200M; remainder reserved for esALB protection program and strategic allocations. Expected actual supply post-rollout: ≤ 800M.

Implementation is rolling out now; see [Roadmap](/roadmap) and [Alien Base 2.0](/alb-and-esalb/alien-base-2-0) for current status.

## ALB liquidity

ALB is traded across multiple Base DEXes. As of July 6, 2026 there are \~27 ALB pairs across all venues, dominated by:

* **Alien Base** — Several pairs, primary liquidity source with ALB/WETH at [`0xbcd2…6fcB`](https://basescan.org/address/0xbcd27A437eBe92555Cee6b5bBeDdAC639a1b6fcB).
* **Uniswap** — 3 pools.
* **Aerodrome / others** — small parallel liquidity.

If you swap on Alien Base, [Epsilon](/trading/epsilon) routes through whichever venue gives the best price (almost always the native pools).

## Resources

* ALB on Basescan: [`0x1dd2d631…50c4`](https://basescan.org/token/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4)
* Source code: [`alienbase-xyz/alienbase-contracts`](https://github.com/alienbase-xyz/alienbase-contracts)
* Tokenomics articles on Medium:
  * [Strategic Roadmap Update for Alien Base](https://medium.com/@alienbase/strategic-roadmap-update-for-alien-base-c569f2bfcc46) — Sep 2023
  * [Introducing EsALB: The Next Phase of Alien Base Tokenomics](https://medium.com/@alienbase/introducing-esalb-the-next-phase-of-alien-base-tokenomics-e5bfa049486f) — Apr 2024
  * [AIP-3: Establishing DAO Budget for 2nd Halving Cycle](https://medium.com/@alienbase/aip-3-establishing-dao-budget-for-2nd-halving-cycle-8092e0039cfd) — Oct 2024
  * [AIP-5: Building Alien Base 2.0](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2) — Mar 2026


# Escrowed ALB (esALB)

Escrowed ALB — what it is, what it does, and how to use it

**esALB** is the locked, non-transferable form of ALB. It's the asset that earns governance voting power, single-staking APR, and **Real Yield** (WETH from protocol fees). If you plan to hold ALB long-term, you almost certainly want it as esALB.

> *Last updated: July 6, 2026.*

## In one paragraph

You convert ALB → esALB **1:1** via **Lock & Earn** on the [Dashboard](https://app.alienbase.xyz/dashboard). esALB is non-transferable. You can stake esALB to earn unlocked ALB, vote on Snapshot, and receive Real Yield in WETH. To convert back, you use one of two paths (mixable): **100% after a 30-day cooldown** with no penalty, or **1% instantly every 24 hours**. Both are documented below.

## At a glance

|                     |                                                                                              |
| ------------------- | -------------------------------------------------------------------------------------------- |
| esALB token         | [`0x365c6d58…4113`](https://basescan.org/address/0x365c6d588e8611125de3bea5b9280c304fa54113) |
| Lock ratio          | 1 ALB → 1 esALB (and back)                                                                   |
| Transferable?       | No. esALB is bound to the address that minted it.                                            |
| Voting weight       | 1× per esALB (10× per [govALB](#govalb-coming-via-aip-5) once AIP-5 ships)                   |
| Earn while staking? | Yes — unlocked ALB rewards from the esALB single-stake vault                                 |
| Real Yield?         | Yes — pro-rata share of WETH protocol fees                                                   |

## What esALB is for

* **Single-staking APR.** Stake esALB under **Locked earn** on the [Vaults](https://app.alienbase.xyz/vaults) page to farm unlocked ALB.
* **Real Yield.** Stakers earn a share of protocol fees, paid in **WETH**, **USDC**, and other liquid assets — not in extra ALB inflation. Details: [Real Yield](/alb-and-esalb/real-yield).
* **Governance.** Voting power on Snapshot is weighted by esALB. See [Alien Base DAO](/governance/alien-base-dao).
* **Airdrops & extra rewards.** Targeted distributions (partner tokens, special-event drops) generally land in esALB holders' wallets.

## How to lock ALB into esALB

1. Open the [Dashboard](https://app.alienbase.xyz/dashboard) and click **Lock & Earn** (also available from the **Locked earn** tab on the Vaults page via **Lock & Stake**).
2. Pick the **Escrowed ALB (esALB)** farm. A deposit modal opens.
3. Choose your input: **Zap (any token)**, **LP Tokens**, or **Lock existing** ALB.
4. Enter the amount. The modal previews each step (e.g., swap → convert to esALB → stake in farm).
5. Approve and confirm the transactions (batch zap isn't supported, so expect one transaction per step).

![Lock modal — converting ALB to esALB and staking in one flow](/files/hz6NJ0iWO8n77aoK8Bvn)

Your deposit is automatically staked in the esALB farm after conversion. You'll receive 1 esALB for every ALB locked. To see the esALB balance in your wallet, add the contract address [`0x365c6d58…4113`](https://basescan.org/address/0x365c6d588e8611125de3bea5b9280c304fa54113) as a custom token.

## Staking esALB

After locking, head to the [Vaults](https://app.alienbase.xyz/vaults) page → **Locked earn** tab. The **esALB** position is at the top, next to the escrowed ALB-WETH LP positions (Infinite and Backstop).

![Locked earn](/files/4utQO0AWy85kQsMAl33n)

1. Click **Enable** to authorize the staking contract to move esALB.
2. Click **Stake** and choose the amount.
3. Rewards (unlocked ALB) accrue continuously. The APR is shown split by source (ALB emissions vs. Real Yield). Click **Harvest** (or **Harvest all**) any time to claim.

Your staked esALB still counts for **governance voting** and **Real Yield**.

## How to unlock back to ALB

Open the **Locked earn** tab on the Dashboard, find your **Escrowed ALB (esALB)** farming position, and click the unstake icon. The unstake modal offers two redemption paths (mixable):

![Unstake modal — instant 1% redemption or 30-day unlock](/files/vmEtaUGqthh5L0heL48a)

### Path A — full unlock after a 30-day cooldown, no penalty

1. In the unstake modal, choose the **amount to unstake** (slider or 25/50/75/100% presets), leaving **Instant 1% Redemption** off.
2. Click **Start Unlock Process**. This is a multi-step transaction: unstake, then start the 30-day unlock period for the selected amount.
3. The position moves to **Locked → Vested** on the Dashboard, where you can track unlock progress. While vesting, **you continue to earn rewards at a 30% reduction**.
4. After 30 days, redeem the full amount as ALB.

>

> You have **7 days** to redeem after vesting completes. If you miss the window, the position re-locks and starts a new 30-day vesting cycle.

### Path B — 1% instant redemption, every 12 hours

1. In the unstake modal, toggle **Instant 1% Redemption** on.
2. Confirm the transaction. You instantly receive 1% of your staked esALB back as ALB.
3. You can repeat every 24 hours.

The 1% is computed against your **total** esALB position, including any portion currently in 30-day vesting. You can use both paths simultaneously — e.g., put half into 30-day redemption and drip the rest 1% per day.

## Common pitfalls

* **"I don't see my locked esALB on the Dashboard."** It's probably staked in the esALB Single Stake vault. Unstake first; it'll reappear under your portfolio.
* **"My approve transaction succeeded but Lock still says I need to approve."** Likely an allowance-cap quirk on Base. See [Changing allowance](/alb-and-esalb/escrowed-alb-esalb/changing-allowance).
* **"I missed the 7-day redeem window."** It auto-relocks. Re-trigger redemption to start a fresh 30-day cycle, or use Path B to drip out.
* **"Why is my staking APR lower than expected?"** APR includes the unlocked ALB stream from the vault. The Real Yield (WETH) is shown separately. Total economics is APR + WETH yield + governance optionality.

## govALB (coming via AIP-5)

[AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2) introduces **govALB** — a longer-locked variant of esALB that confers **10× voting weight**. The trade-off is a longer effective lock (\~2 years). It's designed for users who want maximum governance influence and are willing to commit time for it. Mechanics will be documented as it rolls out — see [Alien Base 2.0](/alb-and-esalb/alien-base-2-0).

## Live data

The [Dune dashboard](https://dune.com/sealaunch/alienbase) tracks esALB live:

* **esALB Holders** — current count and growth over time.
* **ALB locked on esALB** and **ALB in esALB** — the supply view.
* **ALB-esALB Lock/Unlock** — daily inflows/outflows between ALB and esALB.
* **Total Holders (ALB + esALB)** — combined holder count, useful for evaluating decentralization.

## See also

* [esLP](/alb-and-esalb/eslp) — locked LP positions (e.g., ALB-ETH).
* [Vesting](/alb-and-esalb/vesting) — long-form vesting schedules (team, advisors, contributors).
* [Real Yield (WETH)](/alb-and-esalb/real-yield) — the protocol-fee distribution mechanism.
* [Changing allowance](/alb-and-esalb/escrowed-alb-esalb/changing-allowance) — fixing the "approve but won't lock" issue.
* [Data & Analytics](/reference/data-and-analytics) — full data-source map.
* [Introducing EsALB: The Next Phase of Alien Base Tokenomics](https://medium.com/@alienbase/introducing-esalb-the-next-phase-of-alien-base-tokenomics-e5bfa049486f) — original launch article.


# Changing allowance

esALB uses a different allowance system for allocating to farms — this is what happens when you click **Enable** before staking esALB (today under **Vaults → Locked earn**).

In some cases, the allowance might be insufficient, or you may want to revoke it fully. Tools like revoke.cash don't support this kind of allowance (but also, no one can take esALB from you).

To fix allowance issues, for now you need to manually approve usage on Basescan. To do so, head over to this link: <https://basescan.org/token/0x365c6d588e8611125De3bEA5B9280C304FA54113#writeContract>

**Click 'Connect to Web3' to connect your wallet.**

<figure><img src="/files/kQNqJOHwohnII88LkuyX" alt=""><figcaption></figcaption></figure>

Then, find the "approveUsage" function and fill the following parameters:

* UsageAddress: 0xd3968A4a07d64C6E16982d45191b9A09a261Ec88
* Amount: 1000000000000000000000000000

Usage Address is the address of our EsMaster, a contract for farming with esALB and other locked tokens. The amount is equivalent to 1 billion ALB, which is more than the total supply and should be more than enough for any approval.

To revoke approval, just set the amount to 0

Next, click on 'Write', confirm the transaction, and your allowance should be fixed!

<figure><img src="/files/ye9tk29daV57GrEXIOQJ" alt=""><figcaption></figcaption></figure>


# esLP

Escrowed LP positions — locked liquidity that earns boosted yield

**esLP** ("escrowed LP") applies the esALB locking pattern to liquidity-pool tokens. The flagship esLP position is **esLP ALB-ETH** — a locked V2 LP token that earns boosted ALB rewards and protocol-fee yield, while remaining non-transferable.

> *Last updated: July 6, 2026.* esLP was introduced after esALB shipped (April 2024) and is referenced in the [Welcome page](/) and the AIP-2 fee-split structure.

## What esLP is

A non-transferable, lock-wrapped version of an LP token (currently ALB-ETH V2). The pattern is identical to esALB:

* Lock LP → esLP **1:1**.
* esLP earns higher emissions than the unlocked LP farm.
* esLP also receives a share of the **Real Yield** stream (WETH from protocol fees).
* Unlock paths mirror esALB: 100% after a 30-day cooldown (no penalty) or 1% instantly every 24 hours.

## Why use esLP

If you're providing the ALB-ETH liquidity that powers Alien Base's core market, esLP rewards you for committing to that role. It compresses the gap between "passive LP" and "long-term aligned holder" by giving committed LPs:

* A boost on top of the regular farm APR.
* A direct share of WETH Real Yield (the same stream that pays esALB stakers).
* Voting power on Snapshot proposals (esLP counts toward the esALB-equivalent voting strategy at a configured weight).

## How to lock

>

> The exact UI flow for esLP varies depending on whether the position lives in the legacy Farms tab or the new [Vaults](https://app.alienbase.xyz/vaults) page. Steps below describe the current Vaults flow.

1. Provide ALB-ETH liquidity on the [V2 pool](https://app.alienbase.xyz/swap) and receive your LP token.
2. Open the [Vaults](https://app.alienbase.xyz/vaults) page and find the **esLP ALB-ETH** vault.
3. Click **Lock** → choose the LP amount → approve the contract → confirm.
4. The LP token disappears from your wallet; an equivalent esLP balance appears in your portfolio.

To stake the esLP for boosted rewards, find the corresponding stake card in the same Vaults page, click **Stake**, and confirm.

## Unlocking

Same two paths as esALB:

* **100% in 30 days, no penalty.** The position enters a 30-day vesting state. You still farm at a 30% reduction during this window, then redeem within 7 days after the vest completes (or it re-locks).
* **1% every 24 hours, instant.** In the unstake modal, toggle "Instant 1% Redemption" → confirm.

You can mix the two paths as needed.

## Contracts

The esLP contracts on Base: `esLP-ALB-ETH` ("Infinite") at [`0x3d3a5ad6…8ea0`](https://basescan.org/address/0x3d3a5ad6d7beab234d7f0338a01e62b1d36d8ea0) and `esLP-B-ALB-ETH` ("Backstop") at [`0x4a023efe…6978`](https://basescan.org/address/0x4a023efe4b5cd304e800f29074186164fda36978). Both appear under **Vaults → Locked earn** in the dApp. ALB-WETH is currently the only pair with esLP positions.

## See also

* [Escrowed ALB (esALB)](/alb-and-esalb/escrowed-alb-esalb) — the underlying locking primitive.
* [Real Yield (WETH)](/alb-and-esalb/real-yield) — the protocol-fee distribution that esLP shares in.
* [V2 Pools (legacy)](/liquidity/v2-pools) — where the underlying LP token comes from.


# Vesting

Long-form ALB vesting via the VestingFactory contract

Some ALB allocations — to the team, contributors, advisors, and certain DAO-budgeted recipients — are released over multi-year schedules through the on-chain **VestingFactory** instead of via direct distribution.

> *Last updated: July 6, 2026.*

## What it is

`VestingFactory` is a contract deployed by the team in **June 2025** that creates per-recipient vesting contracts. Each per-recipient vesting contract holds an ALB allocation and releases it linearly over a configurable schedule.

This is distinct from the **esALB** locking system:

* **esALB** is short-term, holder-controlled, instantly mintable from ALB, and unlocks in 30 days or 1%/24h.
* **Vesting** is long-term, multi-year, and release schedules are fixed by the proposal that authorized them. The recipient cannot accelerate redemption.

The combination of the two ensures that long-tail contributor allocations reach circulating supply slowly while short-term holder behavior remains liquid via the esALB unlock paths.

## Origin

The team-facing 5 M ALB from the original timelock (see [ALB Token — Initial supply & distribution](/alb-and-esalb/alb-token#initial-supply--distribution)) was always intended to vest. At launch, the vesting infrastructure had not yet been built. `VestingFactory` is that deployed infrastructure.

[AIP-3](https://medium.com/@alienbase/aip-3-establishing-dao-budget-for-2nd-halving-cycle-8092e0039cfd) (Oct 2024) and [AIP-4](https://snapshot.org/#/alienbase-dex.eth/proposal/0x3e1f7e1841389638f6fda99baefd61331cf711fdc7f4649ad96713c25a747826) (Jun 2025) both authorized additional vested allocations:

* AIP-3 transferred 66% of the previous dev-team emissions rights into vested positions for DAO contributors, devs, and potential external investors.
* AIP-4 authorized esALB-style multi-year additional locks vesting over close to 5 years total since launch.

## Which addresses receive vesting

Vesting recipients include (non-exhaustive):

* Founding team members (the original 5 M ALB allocation).
* Long-term core developers and operators.
* Recipients of the AIP-3 / AIP-4 vested allocations.

The full list of recipient addresses is on-chain — every per-recipient vesting contract is created by `VestingFactory` ([`0x77ec0394…ed84`](https://basescan.org/address/0x77ec0394e4edea1997bdb1919bb354d880faed84), second deployment [`0xf61cc1ae…453d`](https://basescan.org/address/0xf61cc1aedd072784d8f133ba9409c538cfc9453d)) and is therefore visible on Basescan via the factory's contract-creation history.

## How it interacts with circulating supply

ALB held in vesting contracts is **non-circulating** until released. The "circulating supply" figure on CoinGecko / DefiLlama / DexScreener excludes:

* Tokens still in vesting contracts (not yet released to the recipient).
* Tokens locked as esALB (locked, but technically held by the user — counted as circulating in some methodologies).

Per the latest analytics, \~234 M ALB is reported as circulating against \~465 M minted. The gap is split between vesting contracts, the DAO multisig & treasury addresses, the team operations Safe, and unvested farm-emission accumulator state.

## See also

* [ALB Token — Initial supply & distribution](/alb-and-esalb/alb-token#initial-supply--distribution)
* [AIP-3](https://medium.com/@alienbase/aip-3-establishing-dao-budget-for-2nd-halving-cycle-8092e0039cfd) and [AIP-4](https://snapshot.org/#/alienbase-dex.eth/proposal/0x3e1f7e1841389638f6fda99baefd61331cf711fdc7f4649ad96713c25a747826)
* [Contracts — Vesting](/reference/contracts) for `VestingFactory` address and per-recipient instances.


# Real Yield (WETH)

How protocol fees are distributed to esALB stakers as WETH yield

**Real Yield** is the share of Alien Base's protocol fees that is paid out to esALB stakers in **WETH** (and other liquid assets), rather than as additional ALB inflation.

It's the central reason esALB exists: instead of diluting holders with emissions, the protocol returns a portion of its actual revenue to the people who lock long-term.

> *Last updated: July 6, 2026.*

## How it works

```
   Trade on Alien Base (V2 / V3 / Carbon / DCA)
                 │
                 ▼
        Pool fees (LP share + protocol share)
                 │
        ┌────────┴────────┐
        ▼                 ▼
       LPs          Protocol share
                          │
                          ▼
              ┌───────────┴────────────┐
              ▼                ▼       ▼
       esALB stakers       DAO     POL Fund
       (Real Yield in     treasury (per AIP-5)
       WETH + tokens)
```

Protocol-share collection mechanics:

* **V2 pools.** Pools charge **0.16%** per swap, paid to LPs in-pool. The V2 Factory's `feeToSetter` is the DAO Multisig — the protocol-side carve-out can be enabled by DAO vote.
* **V3 pools.** Each fee tier collects fees automatically; **50% goes to LPs and 50% goes to esALB stakers** as Real Yield. The seven tiers are 0.01% / 0.02% / 0.03% / 0.04% / 0.075% / 0.30% / 1.00%. (AIP-2 originated the LP/staker fee-sharing structure; the current split is 50/50.)
* **Epsilon platform fees** on every swap — **0.01%** stables / **0.05%** blue chips / **0.15%** everything else, plus the flat 0.05% Matcher execution fee. Routed to the Treasury / esALB stream.
* **Epsilon Router orders** — The 0.05% Protocol fee is routed to the esALB real yield stream. Full table: [Fees](/reference/fees).

The protocol share is converted into **WETH** (and select stablecoins / partner tokens) and distributed pro-rata to esALB stakers via the EsToken reward distributor (`EsTokenController` and the rewarder family — see [Contracts](/reference/contracts)).

## What you receive

When you stake esALB in the esALB Single Stake vault:

* **Unlocked ALB rewards** — the standard farm-style emissions stream.
* **Real Yield** — primarily WETH; some weeks may include USDC, ETH, or tokens received as fees.

Both streams are claimable from the same Vaults page UI ("Harvest" / "Claim All").

## Historical context

* Pre-esALB (Aug 2023 → Apr 2024): protocol fees accrued to the team / DAO; no direct user-share mechanism.
* esALB launch (Apr 2024) introduced single-staking with ALB rewards.
* AIP-2 (Nov 2023) established the V3 LP / staker fee-sharing structure that powers Real Yield today.
* AIP-3 (Oct 2024) noted that \~50% of trade-fee revenue was already being redistributed to esALB holders by that point.
* AIP-5 (Apr 2026) preserves Real Yield and adds the POL Fund's buyback-and-burn flywheel on top.

## See also

* [esALB](/alb-and-esalb/escrowed-alb-esalb)
* [Fees](/reference/fees) — full fee schedule and where each fee goes.
* [ALB Token — Value flow](/alb-and-esalb/alb-token#value-flow-real-yield)


# Alien Base 2.0 (AIP-5)

The AIP-5 tokenomics rewrite, in plain language

**Alien Base 2.0** is the package of tokenomics and governance changes authorized by [AIP-5](https://snapshot.org/#/alienbase-dex.eth/proposal/0x9328ecc5a0d2527a1e73fd30085e7ba2120a985b7782ce843f15ee2ddf38ca63) (passed April 2026). It replaces the old "halving farming model" with a new model built around Protocol-Owned Liquidity, a Dev Line of Credit, and a clearer DAO / Foundation / Labs split.

> *Last updated: July 6, 2026.* Onchain rollout is in progress. This page tracks the moving pieces.

## The five changes at a glance

1. **Farming → POL.** Farming emissions wind down. A Protocol-Owned-Liquidity (POL) Fund takes over as the primary liquidity-provision mechanism.
2. **Halvings → flexible emissions.** The old fixed-halving schedule retires. Emissions are sized to revenue, with headroom kept on the upside if needed.
3. **Dev allowance → Line of Credit.** Team funding becomes tracked debt with interest paid back to esALB holders. Price-tier grants at $0.40, $1, $2 unlock as ALB sustains those moving averages.
4. **govALB.** New staked-escrow tier with **10× voting power**, 1× earning power, \~2-year effective lock.
5. **Supply cap raised.** One-time bump from **510,000,000 → 1,051,000,000 ALB**. Direct allocation increase = 200M; remainder reserved for esALB protection program and strategic allocations. Expected actual supply post-rollout: ≤ 800M.

## Why each piece matters

### POL Fund

Farming subsidies are the most expensive form of liquidity a protocol can buy. Every block, the protocol prints ALB and gives it to LPs. As the price recovers, the LPs typically sell — extracting value from the protocol.

The POL Fund flips this:

* The DAO holds the liquidity itself (stablecoins, blue chips, Base-native assets, Alien Base LPs).
* Yield from POL is used for **buyback-and-burn ALB**.
* Net result: liquidity stays on the platform, ALB supply grows more slowly (or shrinks during high-volume periods), and the protocol keeps the value its trading volume generates.

### Flexible emissions

Halvings were a clean concept but rigid. They didn't respond to market conditions, treasury health, or demand. AIP-5 replaces them with **emissions that scale with protocol revenue** and that can be adjusted via governance more dynamically. Emissions never run away because they're capped by supply.

### Line of Credit

Treasury-to-team funding was previously a flat allowance — emit X ALB/month for the dev budget. Two issues:

* It was static. If ALB price 10x'd, the dev team got 10x the funding regardless of need.
* It was untracked. There was no formal accounting of what the DAO had funded.

The Line of Credit fixes both. Every ALB drawn for dev funding is **tracked debt**. esALB holders receive interest and dilution protection on the outstanding LoC — projected \~30–35% APR at expected operating volumes. Debt clears via **price-tier grants**: when ALB sustains $0.40, $1, or $2 (moving averages), a tranche unlocks as a grant rather than debt. This aligns Labs's funding with protocol value creation.

### govALB

esALB is great for one-eyed governance ("my voice matters" while my ALB is locked) — but it's still relatively short-term commitment. Many of the protocol's biggest decisions (tokenomics, multi-year roadmap) deserve input from holders with longer time horizons.

govALB is the long-time-horizon tier. **10× voting weight** in exchange for a roughly 2-year effective lock. Earning rate stays 1× — govALB doesn't print extra rewards, just amplifies governance weight.

### Supply cap raise

The old 510M cap was set in 2023 and has been \~90% emitted. Rather than letting issuance crash to zero (and starving the protocol of incentives at the moment Mothership and Epsilon Router go live), the cap is raised once to 1.051 B.

Important: the cap is a **ceiling**, not a target. The expected actual supply post-rollout is **≤ 800 M**. The 200 M direct allocation increase covers the next phase of growth; the remainder is reserved for the **esALB protection program** (preserving APR for esALB holders during the transition) and **strategic allocations** (POL seeding, partner integrations, future grants).

## DAO / Foundation / Labs split

AIP-5 also formalized the org structure:

* **Alien Base DAO** — the on-chain authority. Holds privileged roles on the protocol contracts. Ratifies major decisions via Snapshot.
* [**Alien Foundation**](/governance/alien-foundation) — Cayman-registered, ownerless legal entity. Holds offchain assets (USDC reserves, vendor relationships, audit engagements). Acts on behalf of the DAO when an offchain counterparty is required.
* [**Alien Labs**](/governance/alien-labs) — operational arm. Builds the dApp, designs and ships products, runs commercial operations. Funded via the LoC.

The DAO remains the supreme authority over the protocol contracts, while Labs takes care of user-facing and Web2-based portions of the protocol.

## Rollout timeline

| Phase                    | What happens                                                             | Status                                         |
| ------------------------ | ------------------------------------------------------------------------ | ---------------------------------------------- |
| Vote                     | AIP-5 passes Snapshot                                                    | Done (Apr 7, 2026)                             |
| Onchain deployments      | New contracts (POL Fund, LoC tracker, govALB) deployed via team deployer | In progress (Apr–May 2026)                     |
| Cap raise execution      | ALB token cap raised to 1.051 B via 14-day timelock                      | Pending — expected July 2026                   |
| Farming wind-down        | Existing farms deprecated, replaced by Vaults / POL flows                | In progress                                    |
| esALB protection program | APR-stabilization for esALB holders during transition                    | Pending — rolls out with the cap raise         |
| Public dashboards        | LoC drawdown tracker, POL holdings, buyback-and-burn cadence             | Planned — after the on-chain rollout completes |

## See also

* [AIP-5 — Building Alien Base 2.0](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2) — the full proposal.
* [Snapshot vote](https://snapshot.org/#/alienbase-dex.eth/proposal/0x9328ecc5a0d2527a1e73fd30085e7ba2120a985b7782ce843f15ee2ddf38ca63)
* [ALB Token](/alb-and-esalb/alb-token)
* [Roadmap](/roadmap)
* [Alien Foundation](/governance/alien-foundation) and [Alien Labs](/governance/alien-labs)


# Alien Base DAO

How Alien Base is governed

Alien Base is governed by the holders of $ALB through the Alien Base DAO. Decisions are made on Snapshot, executed by the [DAO Multisig](/governance/dao-multisig), and increasingly framed and stewarded by the [Alien Foundation](/governance/alien-foundation) and [Alien Labs](/governance/alien-labs) — see "How decisions move from idea to execution" below.

## Governance surfaces

| Layer                               | What it does                                                                                                                                                                           | Where it lives                                                                               |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **Snapshot space**                  | Off-chain weighted voting (esALB-weighted). Where every AIP and ADIP is voted on.                                                                                                      | [`alienbase-dex.eth`](https://snapshot.org/#/alienbase-dex.eth)                              |
| **DAO Multisig**                    | 5-of-8 Gnosis Safe. Executes the on-chain actions implied by passed proposals. Holds the protocol treasury.                                                                            | [`0x4ab9070b…71e5`](https://basescan.org/address/0x4ab9070b7680f802cbf8322e597a4409902171e5) |
| **Alien Foundation**                | Cayman-registered, ownerless legal entity. Provides offchain legal footing for DAO operations.                                                                                         | See [Alien Foundation](/governance/alien-foundation)                                         |
| **Alien Labs**                      | Offchain product/frontend/revenue arm introduced in [AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2). Builds the dApp and runs commercial operations. | See [Alien Labs](/governance/alien-labs)                                                     |
| **Discord forum + signal channels** | Public discussion, sentiment-checks, Q\&A on draft proposals.                                                                                                                          | [Discord](https://discord.gg/alienbase)                                                      |

## Voting power

Voting power is weighted by **esALB** holdings (and selected esLP variants), not raw ALB. The full strategy is implemented as a fork of Snapshot's strategies engine — see [`alienbase-xyz/snapshot-strategies`](https://github.com/alienbase-xyz/snapshot-strategies) and the on-chain `EsVoting` helpers ([`0x3f8d116e…ddc1`](https://basescan.org/address/0x3f8d116e99bce42b38989a62394fa9bb532dddc1) and [`0xd3cfcb52…2e7b`](https://basescan.org/address/0xd3cfcb52ec5715652c5096bdf99ea078c4df2e7b)).

Under [AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2), a new **govALB** token will offer **10× voting power** in exchange for a \~2-year effective lock — designed to align voting weight with long-term commitment. Mechanics will be documented as it goes live.

## How decisions move from idea to execution

```
Idea / discussion           →  Discord, Medium drafts
       │
       ▼
Snapshot proposal (AIP/ADIP) →  alienbase-dex.eth space
       │  (3-day vote, esALB-weighted)
       ▼
Pass / fail
       │
       ├─ Pass → on-chain actions executed by DAO Multisig (or scheduled via timelock)
       └─ Pass → off-chain actions executed by Alien Labs / Foundation (operating-budget items)
```

## Proposal requirements

To submit a proposal, you need at least **100,000 ALB** of voting power (esALB-weighted) at the snapshot block.

A proposal must cover three sections:

* **Motivation** — why we're doing this, with data and analysis where relevant.
* **Description** — concrete plan of action, including the specific on-chain functions the DAO Multisig is expected to execute (changes to smart-contract parameters, ALB disbursement, or new contract deployments).
* **Result** — how the proposal achieves the goals, with potential drawbacks and mitigations.

Step-by-step for first-time proposers: [How to Propose](/governance/how-to-propose).

## What the DAO controls today

Per [AIP-2](https://snapshot.org/#/alienbase-dex.eth/proposal/0xea788bd0daf9fb61acb0199874abc56f9c871cc2e117c3c1c11a45ba1ced7f52) and subsequent proposals, the DAO Multisig holds privileged roles on:

* V2 Factory `feeToSetter`
* V3 Factory `owner`
* `UniversalDistributorController` (active farm controller, since June 2025) `owner`
* BunniHubController `owner`

## Proposal history

A complete index with vote results: [AIP Index](/governance/aip-index).

Highlights:

* **AIP-1 (de facto, Aug 2023)** — emergency emission cut from 15 → 8 ALB/sec after sniper bots captured the initial liquidity.
* **AIP-2 (Nov 2023)** — V3 launch boost program; established the 50/40/10 fee split and the DAO Multisig.
* **AIP-3 (Oct 2024)** — second-halving DAO budget; raised DAO collection rate from 15% → 20%.
* **AIP-4 (Jun 2025)** — third-halving budget; community chose "prioritize DAO" path; authorized multi-year vesting.
* **ADIP-01 (Aug 2025)** — first proposal authored by "Alienbase Foundation (Proposed)"; six-month operating budget.
* **AIP-5 (Apr 2026)** — Alien Base 2.0: replaces farming with POL fund + buyback-and-burn; introduces govALB; raises supply cap to 1.051B.

Three smaller community-led proposals also passed in August 2025 (YouTube channel access, Academy pilot video, Academy thread channel).

## Treasury

The DAO Multisig holds the on-chain treasury. As of July 6, 2026:

* ETH: 0.032
* ALB: 5,963,076 (only the Safe's holding; the broader DAO-controlled treasury referenced in ADIP-01 is \~37M ALB distributed across multiple addresses)
* USDC: 6,993
* WETH: 2.74

The treasury composition is updated continuously as fees are collected and budget is spent. Live views: [Basescan](https://basescan.org/address/0x4ab9070b7680f802cbf8322e597a4409902171e5) (asset balances), [Safe](https://app.safe.global/home?safe=base:0x4ab9070b7680f802cbf8322e597a4409902171e5) (pending Safe transactions), [Dune dashboard](https://dune.com/sealaunch/alienbase) (fee accrual over time).

## Discord & forum etiquette

Big proposals go through community discussion before they hit Snapshot. The norm is:

1. Post a draft / motivation in Discord (`#governance` or equivalent channel).
2. Iterate based on feedback for at least a few days.
3. Cross-post to Medium once the structure is settled (helps non-Discord users find it).
4. Open the Snapshot vote.

Spammy, bad-faith, or copy-paste proposals from non-engaged community members tend to die quickly. The DAO is small enough that signal-to-noise is high but also that any well-reasoned proposal gets a real read. Joining [Discord](https://discord.gg/alienbase) is by far the easiest way to be part of the conversation.


# Alien Foundation

The legal entity behind Alien Base

The **Alien Foundation** is a Cayman-Islands-registered, ownerless legal entity established in **December 2024**. Its purpose is to give the Alien Base DAO a stable offchain legal footing — for partnerships, audits, fiat denominated services, and anything else that benefits from a real-world counterparty.

> *Last updated: July 6, 2026.*

## Why it exists

DAOs are powerful coordination mechanisms but they cannot, by themselves, enter into contracts, hold a bank account, or be sued / sue. As Alien Base scaled past a single-multisig operation, it became practical to wrap the DAO's offchain activity in a legal shell that:

* Lets the DAO sign agreements with auditors, infrastructure providers, exchanges, and partners.
* Holds non-crypto assets (USDC operating reserves, fiat invoicing, etc.).
* Provides a defined liability boundary for contributors and the DAO itself.
* Can interact with regulators in jurisdictions that require a counterparty.

A Cayman foundation is the standard pattern for this in DeFi (Uniswap Foundation, Optimism Foundation, etc.). Cayman foundations can be **ownerless** — there is no shareholder, only beneficiaries (the DAO members) and supervisors. This means the Foundation cannot be captured by an external party.

## What it does

* Holds the operating-budget USDC reserves authorized by [ADIP-01](https://snapshot.org/#/alienbase-dex.eth/proposal/0xae936ad8ddb58b90128ff8da95bb6edded6188ba4c87f2ea724d771cfcc17cac) and follow-up budget proposals.
* Engages auditors (currently Epsilon's audit; Mothership's audit is upcoming).
* Engages legal counsel for the DAO.

## What it does **not** do

* It does not control the DAO. Final say on every operating-budget decision still belongs to esALB voters.
* It does not own the protocol contracts. On-chain control surface is held by the DAO Multisig — see the [onchain control surface](/reference/audits-and-security#onchain-control-surface).
* It is not the team. Operating contributors (development, design, marketing, ops) are paid by the Foundation under the budget the DAO approved, but they are not Foundation officers.

## Relationship to Alien Labs

[AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2) introduced a clearer split:

* **Alien Base DAO** — onchain governance over protocol contracts. The supreme authority over the contracts.
* **Alien Foundation** — offchain legal entity, treasury custodian, counter-party for service contracts.
* **Alien Labs** — offchain product / frontend / revenue arm. Builds the dApp; runs commercial operations under the Foundation's umbrella.

See [Alien Labs](/governance/alien-labs) for detail on the Labs side.

## References

* [Alien Base 2025: Launching The Full Scale Invasion](https://medium.com/@alienbase/alien-base-2025-launching-the-full-scale-invasion-99d50163a5ed) — confirms Foundation established Dec 2024.
* [ADIP-01](https://snapshot.org/#/alienbase-dex.eth/proposal/0xae936ad8ddb58b90128ff8da95bb6edded6188ba4c87f2ea724d771cfcc17cac) — first proposal authored as "Alienbase Foundation (Proposed)".
* [AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2) — formalizes the DAO / Foundation / Labs split.


# Alien Labs

The product/build arm of Alien Base

**Alien Labs** is the offchain product, frontend, and revenue arm of Alien Base, formalized in [AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2) (April 2026).

> *Last updated: July 6, 2026.*

## What it is

Alien Labs is the entity that:

* Designs and builds the [app.alienbase.xyz](https://app.alienbase.xyz) frontend.
* Develops new on-chain products before they're handed off to the DAO (Mothership, Epsilon Router, Token Generator v2, etc.).
* Runs the commercial side of Alien Base — partnerships, integrations, listings, market making.
* Operates day-to-day infrastructure (RPC, indexers, frontends, analytics).

It operates under the [Alien Foundation](/governance/alien-foundation)'s legal umbrella but is structured as a distinct working unit so that builders, designers, and operators have clear contracts, deliverables, and accountability.

## How it's funded

Through a **Dev Line of Credit (LoC)** introduced in AIP-5. Mechanics:

* The LoC replaces the older "X ALB/month dev allowance" flat budget.
* Funding is treated as **tracked debt** with interest paid to esALB holders. Every ALB drawn from the LoC increases an outstanding-debt balance the Foundation owes back to the protocol.
* **Price-tier grants:** when ALB sustains a moving-average price of $0.40, $1, or $2, a tranche of the outstanding LoC unlocks as a grant — the debt at that tier is cleared. This aligns Labs's funding with the protocol's economic success.
* **esALB inflation coverage:** while the LoC is active, esALB holders receive a continuous APR designed to backstop dilution. Projected esALB yield from this mechanism: **30–35%** at expected operating volumes.

The full design is in the [AIP-5 proposal](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2).

## Why split DAO / Labs?

Three reasons:

1. **Cleaner accountability.** Builders sign normal employment / contractor agreements. The DAO holds the contracts and treasury; Labs holds the deliverables. If a build fails, the DAO can re-direct work without protocol-level disruption.
2. **Cleaner economics.** The DAO's incentive is protocol value (esALB yield, ALB price). Labs's incentive is delivery, with payouts tied to that value. The LoC mechanism makes the alignment formal.
3. **Cleaner governance.** Tokenomics decisions stay with the DAO. Product decisions stay with Labs (within the budget the DAO approved). This avoids the "every UI tweak goes to a Snapshot vote" failure mode.

## How Labs reports back

* **Quarterly Medium retrospectives** on what shipped vs. what was planned.
* **Monthly Discord updates** in the announcements channel.
* **The Public** [**Changelog**](/changelog) is updated continuously as features ship.


# DAO Multisig

The DAO Multisig — signers, threshold, and policy

The Alien Base DAO Multisig is the on-chain executor of every passed governance proposal that requires a contract action. It is also the protocol's primary treasury wallet.

> *Last updated: July 6, 2026.*

## At a glance

|                                  |                                                                                                                                                                       |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Address                          | [`0x4ab9070b7680f802cbf8322e597a4409902171e5`](https://basescan.org/address/0x4ab9070b7680f802cbf8322e597a4409902171e5)                                               |
| Type                             | Gnosis Safe (proxy via Safe Proxy Factory `0xC228…10BC`)                                                                                                              |
| Threshold                        | **5 of 8**                                                                                                                                                            |
| Created                          | November 2023, following the passage of [AIP-2](https://snapshot.org/#/alienbase-dex.eth/proposal/0xea788bd0daf9fb61acb0199874abc56f9c871cc2e117c3c1c11a45ba1ced7f52) |
| Total executed Safe transactions | 28 (Blockscout counter; reflects on-chain actions executed by the Safe)                                                                                               |

Inspect the Safe in your browser via [app.safe.global](https://app.safe.global/home?safe=base:0x4ab9070b7680f802cbf8322e597a4409902171e5).

## Signers (8)

> The signer composition was last updated as part of AIP-2 implementation in late 2023.

The eight signer addresses are public:

1. `0x9da3587a5209fc6ffc4ffe0f0803bb16fe03b7eb`
2. `0x2360404108db5626fb326fadf1669c9b4911e704` — also the author of the August 2025 community proposals and ADIP-01
3. `0xa7ec7de675f35b51d59faaf48d1e2dacf9fb0bc9`
4. `0xd9c14e5ad86d06de762f0d179109661e5b60cc4d` — the original AIP-2 "DAO treasury wallet" EOA
5. `0xbf31124f7adacf777bb52109941e789808fc65f3`
6. `0xa209b82b3719d4dfc1928d24ca5ba4f1123985e6`
7. `0x9a4d392edea94ff73f0452ab482a0437eae9cad3`
8. `0x3f9bea132fcde4886e277c43e94c9dd08e0c1d82`

Per AIP-2 the multisig is structured to balance team and community signers.

## What the multisig controls

Verified by direct `eth_call`:

| Contract                                                   | Privileged role |
| ---------------------------------------------------------- | --------------- |
| V2 Factory                                                 | `feeToSetter`   |
| V3 Factory                                                 | `owner`         |
| `UniversalDistributorController` (current farm controller) | `owner`         |
| BunniHubController                                         | `owner`         |

Migrating these to the DAO Multisig is on the [Roadmap](/roadmap). The full surface is documented on the [Audits & Security](/reference/audits-and-security#onchain-control-surface) page.

## Treasury balances

As of July 6, 2026:

* ETH: 0.032
* ALB: 5,963,076.89
* USDC: 6,993.51
* WETH: 2.74

The Safe's ALB balance is the on-chain "DAO Multisig" share. The broader DAO-controlled ALB pool referenced in [ADIP-01](https://snapshot.org/#/alienbase-dex.eth/proposal/0xae936ad8ddb58b90128ff8da95bb6edded6188ba4c87f2ea724d771cfcc17cac) (\~37 M ALB) is distributed across multiple addresses including the team deployer and the original AIP-2 treasury EOA `0xD9c14E5A…cC4d`.

## Operating policy

* **Threshold of 5 of 8** ensures no single faction can act unilaterally.
* **Proposed actions** are typically queued in the Safe UI by one signer and signed off-chain by others over the days following a Snapshot vote.
* **Sensitive parameter changes** (e.g., emission-rate updates on the farm) are additionally subject to on-chain timelocks: 7 days on the `DistributorController` for emission changes, 14 days on ALB minting.
* **Treasury moves** (ALB transfers, USDC operating spend) are executed against the budget approved by the DAO via a passed AIP/ADIP.


# How to Propose

How to submit a proposal to the Alien Base DAO

A practical guide for ALB holders who want to submit a proposal.

> *Last updated: July 6, 2026.*

## Before you start

You need:

* **At least 100,000 ALB of voting power**, in **esALB** form (or supported esLP variants), at the snapshot block.
* An **EVM wallet** that owns those tokens.
* A clear thesis. Vague proposals lose votes regardless of how good the underlying idea is.

If you don't have the threshold yourself, it's normal to **co-author with a larger holder**: draft your idea, get feedback in Discord, and either persuade a delegate to submit it on your behalf, or aggregate small holders into a delegation pattern. The DAO is small enough that this is a manual conversation, not a formal process — start in [Discord](https://discord.gg/alienbase) governance channels.

## Step 1 — Draft

Every Alien Base proposal has three sections:

1. **Motivation.** Why we're doing this. What problem the proposal solves. Data, on-chain references, or links to discussion threads.
2. **Description.** What concretely happens if the proposal passes. This is where you specify on-chain actions: contract calls (function name, parameters), ALB amounts to disburse, addresses involved. The clearer this section, the easier the DAO Multisig's job.
3. **Result.** How the proposal achieves its goal. Side effects, drawbacks, mitigations. If it changes tokenomics, model the impact.

Keep proposals **single-purpose** when possible. Combined proposals (e.g., "approve a budget *and* change emissions *and* deploy a new contract") tend to invite "yes to A, no to B" splits that are hard to interpret.

## Step 2 — Discuss

* Post the draft in Discord first, in `#governance` (or the active equivalent).
* Iterate for at least a few days. Most strong proposals go through 2–3 revisions.
* If the proposal is large or strategic, post a long-form version on Medium so non-Discord users see it.
* A proposal that hasn't been pre-discussed is significantly less likely to pass — even if its content is good.

## Step 3 — Submit on Snapshot

1. Go to the [Alien Base Snapshot space](https://snapshot.org/#/alienbase-dex.eth).
2. Click **New proposal**.
3. Title: short, descriptive, prefixed with `AIP-N:` if it's a major change. (Day-to-day operational asks can skip the AIP prefix.)
4. Body: paste your **Motivation / Description / Result** sections.
5. Choose the voting type:
   * **Single choice:** the default. Two options: `Yes` and `No`.
   * **Approval / weighted:** for proposals offering several mutually exclusive paths (AIP-4 used "Prioritize DAO" vs. "Prioritize holders").
6. Voting period: **3 days** is standard. Use 5–7 only for very high-impact proposals.
7. Voting strategy: leave the default — Snapshot is configured to use the [`alienbase-dex.eth` strategies](https://github.com/alienbase-xyz/snapshot-strategies) which weigh ALB, esALB, and selected esLP holdings.
8. Snapshot block: typically the current block. If you want to exclude very recent acquirers (e.g., to discourage vote-buying), choose a block from a few days back, but **say so explicitly** in the proposal.
9. Submit. The 100,000 ALB voting-power check is enforced at submission.

## Step 4 — Communicate while voting is open

* Pin the proposal in Discord.
* Cross-post on X (the Alien Base account will normally amplify well-formed proposals).
* Hold AMA / "office hours" if the topic is technical. AIP-2, AIP-4, and AIP-5 all had multiple Discord discussion sessions during the voting period.
* Be available to answer voter questions. Silence is a yellow flag.

## Step 5 — After it passes

If the proposal includes on-chain actions:

* The DAO Multisig signers (or, increasingly, the [Alien Foundation](/governance/alien-foundation)) queue the actions in the Safe.
* Time-locked actions (emission changes, ALB minting) wait out the timelock before execution.
* Track execution on the Safe's [Basescan page](https://basescan.org/address/0x4ab9070b7680f802cbf8322e597a4409902171e5) — every executed transaction is public.

If the proposal includes off-chain actions (operating budget, marketing, partnerships):

* Alien Labs (under the Foundation) executes within the approved budget.
* Status updates land in Discord and the next quarterly retrospective.

## Step 6 — If it doesn't pass

* Read the comments. Most rejected proposals have a fixable flaw — wrong scope, missing data, ambiguity.
* Iterate and re-submit. There's no cooldown.
* Don't take it personally. The DAO has rejected proposals from the founders too.

## Things that get proposals killed

* Numbers that don't add up. Run the math twice.
* Insufficient on-chain detail in the Description. "Pay the team" is not actionable; "transfer 1,000,000 ALB from the DAO Multisig to `0x…` over the next 6 months" is.
* Sneaking sub-items past voters by burying them in long sections.
* Conflicts of interest the proposer hasn't disclosed.
* Proposals that materially benefit a small group at the expense of the broader esALB base.

## Templates

We don't ship a heavyweight template. Read the existing AIPs (linked from the [AIP Index](/governance/aip-index)) and match their structure. AIP-2, AIP-3, ADIP-01, and AIP-5 are particularly good models for, respectively: emission tweaks, halving-cycle budgets, operating-budget proposals, and tokenomics overhauls.


# AIP Index

Index of every passed proposal in the Alien Base DAO

A complete index of every Alien Base governance proposal voted on at [`alienbase-dex.eth`](https://snapshot.org/#/alienbase-dex.eth) on Snapshot.

> *Last updated: July 6, 2026. 9 proposals total. All passed; none failed; none currently active.*

| #                | Date (UTC) | Title                                                                                                                                                                                     | State  | Result                                              | Tag                     |
| ---------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------- | ----------------------- |
| (de facto AIP-1) | 2023-08-19 | [Reduce ALB Emissions by 46% for the Remaining Distribution Period](https://snapshot.org/#/alienbase-dex.eth/proposal/0x56c418fd7f7fd365b0beba44389807941e3150fb376179ac758fb497f04a999b) | passed | Yes 7,127 vs No 15                                  | tokenomics              |
| AIP-2            | 2023-11-24 | [Emission schedule and tokenomics improvements](https://snapshot.org/#/alienbase-dex.eth/proposal/0xea788bd0daf9fb61acb0199874abc56f9c871cc2e117c3c1c11a45ba1ced7f52)                     | passed | Yes 14.35 M vs No 0                                 | tokenomics + governance |
| AIP-3            | 2024-10-07 | [Establishing DAO Budget for 2nd Halving Cycle](https://snapshot.org/#/alienbase-dex.eth/proposal/0x2f8f7d71af345928b7d0040553aa8f923c21865d2cd0bee226e3a12626b654fc)                     | passed | Yes 37.24 M vs No 0                                 | treasury                |
| AIP-4            | 2025-06-02 | [Empowering DAO & Optimizing Spending for Next Halving Cycle](https://snapshot.org/#/alienbase-dex.eth/proposal/0x3e1f7e1841389638f6fda99baefd61331cf711fdc7f4649ad96713c25a747826)       | passed | Prioritize DAO 71.14 M vs Prioritize holders 0.45 M | tokenomics + treasury   |
| (no AIP #)       | 2025-08-01 | [Grant Ben Access to Youtube Channel](https://snapshot.org/#/alienbase-dex.eth/proposal/0xca9bb55e6d793ec78044049df40b8f415c7ef729ae35e6717187c26f5d1b3a52)                               | passed | For 39.0 M                                          | community               |
| (no AIP #)       | 2025-08-01 | [Pilot Video Production — Alienbase Academy](https://snapshot.org/#/alienbase-dex.eth/proposal/0x5ef5e5a25c213cd6b679c315a0d32245f5a4644aa1babab04d53a8f2a93c7684)                        | passed | For 38.96 M vs Against 1.82                         | treasury (community)    |
| (no AIP #)       | 2025-08-01 | [Alienbase Academy Thread Chat Channel](https://snapshot.org/#/alienbase-dex.eth/proposal/0x19ae49a6bcce493d55870f9aa9aadd62664f3d5a99c9fef709376a06532916b8)                             | passed | For 39.41 M vs Against 1.82                         | governance (community)  |
| ADIP-01          | 2025-08-28 | [6-Month Operating Budget and Treasury Strategy](https://snapshot.org/#/alienbase-dex.eth/proposal/0xae936ad8ddb58b90128ff8da95bb6edded6188ba4c87f2ea724d771cfcc17cac)                    | passed | For 19.19 M                                         | treasury                |
| AIP-5            | 2026-04-07 | [Building Alien Base 2.0](https://snapshot.org/#/alienbase-dex.eth/proposal/0x9328ecc5a0d2527a1e73fd30085e7ba2120a985b7782ce843f15ee2ddf38ca63)                                           | passed | Yes (as is) 42.63 M; Keep halvings 0.36 M           | tokenomics + roadmap    |

## Proposal summaries

### AIP-1 — Emission emergency cut (2023-08-19)

Eleven days after launch, sniper bots had captured the intended initial liquidity-pool seed, leaving real circulating supply \~1 M instead of the planned 26 M and producing \~600% first-week relative inflation. The proposal cut emissions from **15 → 8 ALB/sec** (–46%) via a `prepareFunction()` then a 7-day-delayed `updateEmissionRate()` on the `DistributorController`. Although the proposal isn't titled "AIP-1", it is the chronological first DAO vote and established the AIP numbering used by everything since.

### AIP-2 — V3 launch + tokenomics improvements (2023-11-24)

Four-part proposal timed to the V3 (concentrated-liquidity) launch:

1. Raise emissions from 8 → 10.5 ALB/sec for two months before tapering.
2. Authorize up to **2 M ALB** from the DAO treasury at `0xD9c14E5A…cC4d` for a targeted V3 boost (ETH/USDC, tBTC/ETH, ALB pools).
3. Establish a uniform **50% team / 40% holders (Single-Stake + esALB) / 10% DAO-treasury** revenue split for both Alien Base and Area 51.
4. Spin up the **DAO Multisig** (now `0x4ab9070b…71e5`) with a 50/50 team-vs-top-holder structure.

### AIP-3 — 2nd halving cycle DAO budget (2024-10-07)

Sets the DAO operating budget for the period after the second halving (Sep 2024, when emissions dropped from 7.5 → 3.75 ALB/sec). Key changes:

* Dev team transfers 33% of its emissions rights to the DAO → **DAO collection rate rises from 15% to 20%** (\~1,944,000 ALB/mo).
* The remaining 66% of the dev team's emissions earmarked for **long-term vested positions** for DAO contributors, devs, and potential external investors.
* Dev operational allowance raised from **600k → 1.0M ALB/month** to cover salaries and infrastructure.

By this proposal, **>60% of circulating ALB was already locked as esALB** and **\~50% of trade fee revenue** was being redistributed to esALB holders.

### AIP-4 — Empowering DAO & Optimizing Spending (2025-06-02)

Halving-cycle proposal coinciding with the third halving (June 2025, \~30% → 15% yearly inflation). Highlights:

* An esALB-style **multi-year additional lock** vesting over close to 5 years total since launch.
* A plan to fund a "development company behind Alien Base" via the DAO under a standard R\&D contract (foreshadowing what AIP-5 later formalized as Alien Labs).
* An expected \~8% drop in esALB APR at then-current revenue levels.

The community chose the "**Prioritize DAO**" variant (71.14M for, 0.45M for "Prioritize holders").

### August 2025 community proposals

Three smaller proposals authored by an active community member (`0x2360…E704`, also a DAO Multisig signer) all passed:

* **YouTube channel access** ($0 budget) for community member "Ben" to upload videos and maintain playlists.
* **Pilot video production** ($300 USDC) for a 3–5 minute educational video on the DCA feature, produced by Nathan.
* **Academy thread chat channel** ($0 budget) for ongoing peer-led Q\&A and lectures.

These set a precedent for low-stakes operational proposals being decided by the DAO without requiring an AIP-format full proposal.

### ADIP-01 — 6-Month Operating Budget (2025-08-28)

The first **"ADIP" (Alienbase DAO Improvement Proposal)** — distinct from AIPs in that it's authored by the **Alienbase Foundation (Proposed)** rather than by an individual address. Adopts and incorporates AIP-4's terms.

Sets a six-month hybrid budget (Sept 2025 → Feb 2026):

* **$200,000 USDC reserve**: Infrastructure $48k / Liquidity & Incentives $40k / Strategic Savings $112k.
* **$42,500 revenue-funded growth**: Dev & Security $15k, Legal $12.5k, Marketing $10k, Grants $5k.
* Treasury also holds 37,000,000 ALB; net \~4M ALB deficit covered by reserves.
* Authorizes 1M ALB/month dev allowance and 1M ALB/month POL contribution.

### AIP-5 — Building Alien Base 2.0 (2026-04-07)

Full tokenomics rewrite. Replaces farming with a **Protocol-Owned-Liquidity (POL) Fund** and replaces fixed halvings with flexible emissions + persistent buyback-and-burn. Introduces:

* **Dev Line of Credit (LoC):** the dev allowance becomes tracked debt with interest paid to esALB holders. Price-tier grant tranches at $0.40, $1, and $2 unlock as ALB sustains those moving averages.
* **govALB:** new staked-escrow form of esALB with 10× voting power, 1× earning power, \~2-year effective lock.
* **Supply cap raised** (one-time): **510,000,000 → 1,051,000,000 ALB**. Direct allocation increase = 200M; remainder reserved for esALB protection program and strategic allocations. Expected actual supply post-rollout ≤ 800M.
* **Governance split** between Alien Base DAO (onchain contracts) and Alien Labs (offchain product/frontend/revenue).

The minority dissent (0.36 M for "keep halvings") is the only non-zero "no" vote in the project's history.

## Author concentration

Of nine proposals to date:

* `0xdD8B…0A390` (a founder-style address): 3 proposals — AIP-1 (de facto), AIP-2, AIP-5.
* `0xF277…20e9`: 2 proposals — AIP-3, AIP-4.
* `0x2360…E704` (also a DAO Multisig signer): 4 proposals — the three Aug 2025 community items + ADIP-01.

The transition from a single founder voice to multiple authors and finally to a "Foundation (Proposed)" voice mirrors the protocol's gradual decentralization.


# Token Generator

Deploy a token on Base in seconds, no code required

The **Token Generator** lets you deploy an ERC-20 on Base from a small set of battle-tested templates, without writing or compiling any Solidity. Tokens deploy verified on Basescan and are immediately tradeable on Alien Base or any other Base DEX.

> *Last updated: July 6, 2026.*

## Cost

A flat **0.015 ETH per token mint**, regardless of template. The fee is non-refundable and feeds the protocol operating budget.

## What you can configure

![Token Generator form](/files/LG3JTYHPfQeX7uxulbKv)

The dApp consolidates the underlying templates behind three toggles:

* **Minting support** — turns the contract into a Mintable (or Mint/Burn) variant. Owner can mint additional tokens after deployment.
* **Burning support** — turns the contract into a Burnable (or Mint/Burn) variant. Holders can call `burn(...)` to reduce supply.
* **Receive Fees** — turns the contract into a Tax token. Buy/sell taxes are charged on trades and routed to a configurable wallet and/or auto-added to LP. Activating this **disables** Minting and Burning, and the Tax token requires liquidity on Alien Base for fee collection to work.

| Configuration    | Underlying template | Best for                                                                                                                    |
| ---------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Both toggles off | Simple Token        | Memecoins, basic ERC-20 use cases. OpenZeppelin-based, no privileged owner. The safest pick for trader trust.               |
| Mint on          | Mintable Token      | Farm tokens, DeFi rewards tokens, project ecosystems. Often considered a red flag by traders unless ownership is renounced. |
| Burn on          | Burnable Token      | Deflationary tokenomics. Anyone can burn their own tokens; reduces circulating supply.                                      |
| Mint + Burn      | Mint/Burn Token     | Niche farming tokenomics.                                                                                                   |
| Receive Fees     | Tax Token           | Memecoin tokenomics with built-in fees. Lineage traces to Toshi, Mochi, TYBG, and the original SafeMoon / Shiba pattern.    |

## Factory contracts

All token deployments are routed through one of these factories. The factories themselves are non-upgradeable — once deployed, the templates they produce are immutable.

| Type                          | Address                                                                                      |
| ----------------------------- | -------------------------------------------------------------------------------------------- |
| Simple Token                  | [`0x3b014572…D176`](https://basescan.org/address/0x3b01457255bD6ec460D9Ab8f31CFabd8a710D176) |
| Mintable Token                | [`0x6a9668c2…8369`](https://basescan.org/address/0x6a9668c2C6E1FB107021375BaCD9d92e79cc8369) |
| Burnable Token                | [`0xF5A7A624…2c79`](https://basescan.org/address/0xF5A7A624f4c11F581eb5a2B12e9bcA327F692c79) |
| Mint/Burn Token               | [`0x872521B4…AF51`](https://basescan.org/address/0x872521B46095139e70A38AE3e8d95611649AAF51) |
| Tax Token                     | [`0x13De15f0…6373`](https://basescan.org/address/0x13De15f0c5E8CC78Ad3a7001bA2Cb882aaE96373) |
| Orchestrator (entry contract) | [`0xBcE75497…d08d`](https://basescan.org/address/0xBcE75497D72b25c3509B62ae1a47CCfb502AD08d) |

The orchestrator is currently owned by the team deployer EOA. Migrating it to the DAO Multisig is a roadmap item — see the [onchain control surface](/reference/audits-and-security#onchain-control-surface).

## How to deploy

1. Open [app.alienbase.xyz/tokenGenerator](https://app.alienbase.xyz/tokenGenerator).
2. Connect wallet (must be on Base, with at least 0.015 ETH for the deployment fee plus a small amount for gas).
3. Fill in:
   * **Ticker** (max 10 characters, e.g., "AWESOME")
   * **Name** (max 30 characters, e.g., "Awesome Token")
   * Toggle **Minting support** and/or **Burning support** as needed.
   * **Initial Token Supply** (e.g., 1,000,000)
   * (Optional) Toggle **Receive Fees** to deploy a Tax token; fill in fee percentage and recipient wallet.
4. Click **Deploy Token**. The token deploys and verifies automatically on Basescan.

Within a couple of minutes the token will appear on DexScreener, GeckoTerminal, etc., once you've added liquidity (see below).

## After deployment

The token is live but illiquid. Typical next steps:

1. **Create a liquidity pool.** **New position** on [app.alienbase.xyz/vaults](https://app.alienbase.xyz/vaults) → V2 (full-range, simplest) or V3 (concentrated).
2. **Lock or burn LP** to signal trust to early traders. (You can use Gempad, Team Finance, or burn to `0x…dEaD` for a hard burn.)
3. **Add token info on Basescan.** Logo, website, socials. Many other sites (DexScreener, MetaMask, GeckoTerminal) pick this up automatically.
4. **Renounce ownership** if applicable. For Mintable and Tax templates this is a strong trust signal once you're done configuring.

The [FAQ](/builders/token-generator/faq) covers all of these in more detail.

## Roadmap — Token Generator v2

Per the [Roadmap](/roadmap), Token Generator v2 is the next major iteration. Themes:

* Comprehensive launchpad with fair-launch tooling.
* More templates and configuration combinations (e.g., Tax + Mintable simultaneously).
* Native LP locking and trust scoring.
* Tighter integration with Alien Base's analytics and Vaults pages.

Until v2 ships, the current Token Generator (v1) remains the recommended path.

## See also

* [Token Generator FAQ](/builders/token-generator/faq)
* [V2 Pools (legacy)](/liquidity/v2-pools) — where most generated tokens get their first market.
* [Listing your token](/builders/listing-your-token) — DexScreener, CoinGecko, etc.
* [Audits & Security](/reference/audits-and-security) — note that the token-template factories rely on inherited audits (OpenZeppelin for Simple/Mintable/Burnable; the SafeMoon-lineage tax pattern is widely deployed but not formally audited at the Alien Base layer).


# FAQ

A list of questions and answers about the Token Generator

#### How much does it cost to generate a token?

The fee for deploying a token is a flat 0.015 ETH no matter the features. The fee is paid in ETH and is non-refundable.

#### What should I put as Initial Token Supply?

Any number of tokens that you like, the more tokens you mint, the less value each token will have. Good practice is to make it between a few millions and up to a few trillion.

#### What should I put as Max Token Supply?

This is the maximum number of tokens that can be minted. It should always be higher than the initial token supply.

#### Should I enable the Mintable Feature?

If you enable the Mintable feature, you can mint more tokens after the token is created. This can be useful if you want to create a farm or airdrop tokens to your community, but it is usually seen as a red flag by traders and automated sniffers.

#### Should I enable the Burnable Feature?

If you enable the Burnable feature, users can burn their tokens and remove them from the circulating supply by interacting directly with the contract. This can be useful to increase the value of the token in the long term and to sustain the price.

#### Can I activate Mintable and Burnable features with the fee feature?

No, once you activate the fee feature, you can't activate the Mintable and Burnable features. Soon, there will be more combinations of tokens to create.

#### Can I collect fees on other DEXes than Alien Base?

When you enable the fees feature, the pool is automatically created on AlienBase, but you still need to add liquidity to it. Due to how tax token contracts work, there will always need to be liquidity on Alien Base, but you can add other DEXs for collecting fees (as long as you didn't renounce ownership).

#### I generated my Token, now what?

You can now create a pool on AlienBase by going to <https://app.alienbase.xyz/add> and adding your token and ETH to pair it with. You can also add logo and social information on BaseScan (<https://basescan.org>) to make your token look more professional. You can also list your token on DexScreener, Coingecko, GeckoTerminal, and DexTools to increase visibility and trust with your community.

#### How do I create a pool for my token?

You can make a pool on AlienBase by going to <https://app.alienbase.xyz/add> and adding your token and ETH to pair it with. For most cases, a full range V2 pool will be the best choice. You can set the initial price and the amount of liquidity you want to provide. After creating the pool, you will receive LP tokens that represent your share of the pool. To create additional trust, you can lock the LP or burn them by sending them to the dead address: 0x000000000000000000000000000000000000dEaD.

#### Can I create a V3 pool for my token?

You can only create V3 pools with non-tax tokens, so just Simple, Mintable, and Burnable. V3 pools allow you to increase the fee that users pay up to 1%, set your own initial price, and liquidity within specific ranges.

#### How do I lock my LP tokens?

You can lock your LP token on <https://gempad.app> or other apps including Team Finance, Floki Locker, and many others. By locking your LP tokens, you can create trust with your community as it's a way to prevent rug pulls.

#### How do I make a farm with my token?

You have to enable the Mintable feature and transfer ownership to the farming contract (MasterChef) of the DEX you want to launch the farm with. If you want to make a farm with your token on Alien Base, open a ticket on our Discord, and we will help you.

#### How do I burn tokens?

You will need to enable the Burnable feature, which allows users to burn tokens by interacting with the contract on the explorer page. By calling the burn function, any user can burn their tokens, and they get removed from the circulating supply. Sending tokens to the burn address is also a way to burn tokens, but doesn't remove them from the circulating supply.

#### Where do the fees get collected?

Trading fees are either accumulated as liquidity or sent directly to the creator address you used to deploy the token. The liquidity is stored on the Token contract and cannot be withdrawn directly, but it increases the liquidity and attractiveness of the token.

#### How do I renounce ownership?

You can renounce ownership by calling the renounceOwnership function in the contract. This will remove the owner from the contract and make it impossible to change the owner address again.

#### Do I always need to renounce ownership?

The Simple and Burnable tokens have no ownership, so there's nothing to renounce. Mintable and Tax Tokens can be renounced, which is usually an additional sign of trust from the community, but it is best to do it when you know you won't need to change any of the parameters of the token.

#### Can I withdraw the fees that go to LP on the Tax Token?

No, fees that go to LP are automatically added to the liquidity pool and cannot be withdrawn by the owner.

#### How do I change the fees on the Tax Token?

If you didn't renounce ownership, you can change the fee percentages by calling the setBuyFees, setSellFees, and setFeeSplit functions in the contract. The fees are set in wei points, so a fee of 1% would be set as 10.000.000.000.000.000. Use the Basescan explorer to convert percentages to wei points.

#### How do I change the fee recipient address on the Tax Token?

You can change the recipient address by calling the setDevelopmentWallet function in the contract. This changes the address that receives the fees. It can be called by the creator of the contract or the existing recipient address. This is useful to change the fee recipient wallet, even if ownership is renounced.

#### How do I change the owner/creator address?

You can change the owner address by calling the transferOwnership function in the contract. The owner address is the address that can mint new tokens on Mintable tokens, and change the fee settings on the Tax Token.

#### How do I interact with the chain explorer?

You can interact with the chain explorer by connecting your wallet and interacting with the contract. You can view the contract code, read the contract state, and interact with the contract functions. You can also view the contract events and transactions on the explorer page. For Base, the chain explorer is <https://basescan.org>.

#### How do I add the token logo and social info in the chain explorer?

By logging in with the owner wallet, you can update the token logo and social info on the chain explorer. This information will be picked up by many other services like DexScreener, DexTools, and wallets like MetaMask. Visit <https://basescan.org> and make an account with the owner wallet to update the token info.

#### How do I list my token on DexScreener?

Tokens get picked up automatically as soon as there is at least one transaction on the blockchain. However, they don't show any logo or information about the token. To add your logo and social info, you can visit this page: <https://marketplace.dexscreener.com/product/token-info>. The standard listing fee is $300; tokens created on Alien Base can qualify for a discount — see [Listing your token](/builders/listing-your-token).

#### How do I list my token on CoinGecko?

You can request listing your token on CoinGecko by filling out this form: <https://www.coingecko.com/en/coins/new>.

#### How do I list my token on GeckoTerminal?

On GeckoTerminal, tokens get picked up automatically as soon as there is at least one transaction on the blockchain, but you can add token logo and social information for free by visiting the token page and clicking on the 'Update Token Info' button.

#### How do I list my token on DexTools?

On DexTools, tokens get picked up automatically as soon as there is at least one transaction on the blockchain. However, they don't show any logo or information about the token. To add your logo and social info, you can visit this page: <https://www.dextools.io/app/en/base/pairs> and click on the 'Update Token Info' button. By adding information about your token on CoinGecko or the Chain Explorer (BaseScan), you will also have the information updated on DexTools.

#### How do I list my token on CoinMarketCap?

Listing a token on CoinMarketCap is a bit more complicated than on other services. You can request listing your token on CoinMarketCap by filling out this form: <https://coinmarketcap.com/request>. For the vast majority of projects, the only realistic way to be listed is by paying a $5,000 fee for "priority" access.


# Listing your token

Get your token visible on the data sites and wallets that matter

Once your token has at least one trade and a liquidity pool, it's discoverable on Base — but it'll show up as a generic "unverified" entry until you fill in the metadata. This page is a checklist for getting your token properly listed across the sites traders actually use.

> *Last updated: July 6, 2026.*

## Prerequisites

Before any of the steps below:

* Token is deployed and verified on Basescan (the [Token Generator](/builders/token-generator) does this automatically).
* At least one liquidity pool exists (typically a V2 pool with WETH; see [V2 Pools](/liquidity/v2-pools)).
* At least one trade has happened on that pool.

## Basescan (the source of truth)

Most other sites pull from Basescan, so this is the most important step.

1. Open your token page on [Basescan](https://basescan.org/).
2. Sign in with the **owner wallet** (the address that deployed the token).
3. Click **Update** and fill in:
   * Logo (square, ≥256×256 PNG)
   * Website
   * X / Twitter
   * Telegram, Discord, Medium, etc. (whatever applies)
   * Description

Once approved, the metadata propagates to many other tools — DexScreener, GeckoTerminal, MetaMask, etc.

## DexScreener

[DexScreener](https://dexscreener.com/) picks up tokens automatically once they have a trade. To add the logo and socials directly (rather than waiting for Basescan to propagate), use the [token info marketplace](https://marketplace.dexscreener.com/product/token-info). Standard listing fee: $300. Tokens deployed via the Alien Base Token Generator can qualify for a discount — ask in [Discord](https://discord.gg/alienbase) for current terms.

## GeckoTerminal

[GeckoTerminal](https://www.geckoterminal.com/) auto-indexes after the first trade. To add logo / socials, click **Update Token Info** on your token page. Free.

## DexTools

[DexTools](https://www.dextools.io/app/en/base/pairs) auto-indexes. Click **Update Token Info** on your token page. Free, with optional paid promotion.

## CoinGecko

CoinGecko requires manual submission via [this form](https://www.coingecko.com/en/coins/new). Listing has minimum requirements (typically liquidity, age, holders, trading volume). It can take weeks to be reviewed.

## CoinMarketCap

CoinMarketCap is the slowest and strictest of the major listing sites. Submit via [this form](https://coinmarketcap.com/request). For most projects, the realistic path is the **$5,000 priority** option — without it, organic listings are heavily backlogged.

## Wallet integrations

* **MetaMask / Coinbase Wallet** automatically display the Basescan logo if it's set.
* For some wallets, getting on the **token list** (a curated registry like Coinbase's Base list) requires direct submission. See each wallet's developer docs.

## Trust signals to set up alongside listings

Listings make you visible. Trust signals make people trade. The high-impact ones:

* **Lock or burn LP.** Lock via Gempad, Team Finance, etc., or hard-burn by sending LP to `0x000000000000000000000000000000000000dEaD`.
* **Renounce ownership** if your token is Mintable or Tax. (Don't renounce if you actually need to keep tweaking parameters — this is a one-way action.)
* **Verify your contract** on Basescan. (Token Generator does this automatically.)
* **Public socials** with consistent branding across X, Telegram, Discord, the project website, and Basescan metadata.
* **A clear post on Discord / X** announcing the launch with the contract address. Pre-empts impostors.

## Fast-path for Token-Generator-deployed tokens

If you deployed via the [Token Generator](/builders/token-generator):

1. Token is already verified — skip the manual verification dance.
2. Add liquidity via **New position** on [app.alienbase.xyz/vaults](https://app.alienbase.xyz/vaults).
3. Update Basescan info while waiting for the first organic trade.
4. Apply to DexScreener / DexTools / GeckoTerminal in parallel.
5. Apply to CoinGecko after a few days of organic volume.
6. Apply to CMC last (it's the slowest).

## See also

* [Token Generator](/builders/token-generator)
* [Token Generator FAQ](/builders/token-generator/faq)
* [V2 Pools](/liquidity/v2-pools) — for adding the initial liquidity.


# Contracts

Canonical list of every Alien Base contract on Base

Every contract Alien Base has deployed on Base (chain id 8453). Each row links to Basescan and notes who controls it. Verification status, source repos, and audit coverage are tracked separately on the [Audits & Security](/reference/audits-and-security) page.

> *Last updated: July 6, 2026.* *Verification was performed against* [*Blockscout*](https://base.blockscout.com/) *and confirmed via `eth_call` on the public Base RPC.*

## How to read this page

* **Active** = the canonical address users and integrators should reference today.
* **Superseded** = an earlier deployment that has been replaced. Listed for transparency; do not interact.
* **Deprecated** = a product line that is no longer maintained. Listed for historical reference only — see [Archive](/archive/archive) for context.
* A row marked with `(DAO)` means the contract's owner / fee setter is the [DAO Multisig](/governance/dao-multisig). Rows marked `(team)` mean the role is still held by a team-controlled key — see the [Audits & Security](/reference/audits-and-security) page for our migration plan.

## Token

|                      |                                                                                                                                                                                              |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ALB token**        | [`0x1dd2d631c92b1aCdFCDd51A0F7145A50130050C4`](https://basescan.org/token/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4)                                                                        |
| Standard             | ERC-20, 18 decimals, OpenZeppelin AccessControl                                                                                                                                              |
| Max supply (current) | 510,000,000 ALB ([AIP-5](https://snapshot.org/#/alienbase-dex.eth/proposal/0x9328ecc5a0d2527a1e73fd30085e7ba2120a985b7782ce843f15ee2ddf38ca63) authorizes a one-time raise to 1,051,000,000) |
| Mint timelock        | 14 days                                                                                                                                                                                      |

## Alien Base V2

The original AMM. Stock Uniswap V2 plus a PancakeSwap-style farming layer.

| Component     | Address                                                                                                                 | Status | Owner                              |
| ------------- | ----------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| V2 Factory    | [`0x3e84d913803b02a4a7f027165e8ca42c14c0fde7`](https://basescan.org/address/0x3e84d913803b02a4a7f027165e8ca42c14c0fde7) | Active | `feeToSetter` = DAO Multisig (DAO) |
| V2 Router     | [`0x8c1A3cF8f83074169FE5D7aD50B978e1cD6b37c7`](https://basescan.org/address/0x8c1A3cF8f83074169FE5D7aD50B978e1cD6b37c7) | Active | (immutable)                        |
| V2 Zap helper | [`0xe0808b8e2bdd70d70e540f977cf40e26e5811054`](https://basescan.org/address/0xe0808b8e2bdd70d70e540f977cf40e26e5811054) | Active | (helper)                           |

## Farming (MasterChef-style)

| Component                                                                 | Address                                                                                                                 | Status     | Owner                                  |
| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------- | -------------------------------------- |
| Farm — `BasedDistributorV2`                                               | [`0x52eaecac2402633d98b95213d0b473e069d86590`](https://basescan.org/address/0x52eaecac2402633d98b95213d0b473e069d86590) | Active     | Controller below                       |
| **UniversalDistributorController** (current controller, since 2025-06-05) | [`0x62d58b4cdd96b590ff4174e272b5f41693c8fba9`](https://basescan.org/address/0x62d58b4cdd96b590ff4174e272b5f41693c8fba9) | **Active** | DAO Multisig (DAO)                     |
| `DistributorController` (original)                                        | [`0x16f1F80654F2FEA97293321675907CFA2e23e4fB`](https://basescan.org/address/0x16f1F80654F2FEA97293321675907CFA2e23e4fB) | Superseded | Team operations Safe `0x845e2f13…f543` |
| OpenZeppelin `TimelockController`                                         | [`0x1c7e4284423c1a2362c49b1ea223b73e38c81e21`](https://basescan.org/address/0x1c7e4284423c1a2362c49b1ea223b73e38c81e21) | Active     | (governance helper)                    |
| `ComplexRewarderPerSecV4` (dual rewards)                                  | multiple addresses, deployed 2023-08 → 2024-12                                                                          | Active     | per-farm                               |

> **Note on the docs migration:** The previous version of this page labelled `0x16f1F806…e4fB` as the "Farm Timelock Proxy". It is the **original** `DistributorController` itself — a thin contract that enforces a 7-day delay on emission changes — and as of 2025-06-05 it is no longer the active farm controller (replaced by `UniversalDistributorController`). The OZ-style `TimelockController` is a separate contract listed above.

## Alien Base V3 (Concentrated Liquidity + Bunni)

Stock Uniswap V3 plus a fork of Bunni for ERC-20-wrapped LP positions.

| Component                            | Address                                                                                                                 | Status                               | Owner              |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------ |
| V3 Factory                           | [`0x0Fd83557b2be93617c9C1C1B6fd549401C74558C`](https://basescan.org/address/0x0Fd83557b2be93617c9C1C1B6fd549401C74558C) | Active                               | DAO Multisig (DAO) |
| V3 NFTPositionManager (`ALB-V3-POS`) | [`0xB7996D1ECD07fB227e8DcA8CD5214bDfb04534E5`](https://basescan.org/address/0xB7996D1ECD07fB227e8DcA8CD5214bDfb04534E5) | Active                               | —                  |
| V3 SmartRouter (V2+V3 unified)       | [`0xB20C411FC84FBB27e78608C24d0056D974ea9411`](https://basescan.org/address/0xB20C411FC84FBB27e78608C24d0056D974ea9411) | Active                               | (immutable)        |
| QuoterV2                             | [`0x353b1bea…b23a`](https://basescan.org/address/0x353b1bea3a9b1a9b6e2a9c7e6e4a4d4d4d4d4d4d)                            | Active                               | —                  |
| MixedRouteQuoterV1                   | [`0xa54844d4…fde6`](https://basescan.org/address/0xa54844d4)                                                            | Active                               | —                  |
| TickLens                             | [`0xe3b6a547…fbd8e`](https://basescan.org/address/0xe3b6a547)                                                           | Active                               | —                  |
| Multicall                            | [`0x24fff20e…32fe`](https://basescan.org/address/0x24fff20e)                                                            | Active                               | —                  |
| **BunniHub** (active)                | [`0xd1fac4f51457e4a6d35bdc7311718e5d6de92bb9`](https://basescan.org/address/0xd1fac4f51457e4a6d35bdc7311718e5d6de92bb9) | **Active**                           | —                  |
| BunniHub (original)                  | [`0xDC53487e2a6eF468260Bc938F645f84caaccAC6F`](https://basescan.org/address/0xDC53487e2a6eF468260Bc938F645f84caaccAC6F) | Superseded by BunniHubA (2024-08-09) | —                  |
| BunniHubController                   | [`0x4bcc584979817219585b6a62a5bb6c15c1fa0f38`](https://basescan.org/address/0x4bcc584979817219585b6a62a5bb6c15c1fa0f38) | Active                               | DAO Multisig (DAO) |
| **BunniZap** (active)                | [`0x77c18d8aea11147b65d9e3ee7b3a9e89910ab7f0`](https://basescan.org/address/0x77c18d8aea11147b65d9e3ee7b3a9e89910ab7f0) | **Active**                           | —                  |
| BunniZap (original)                  | [`0x6947DA282E447a2e9d65ff00aAf80efB5116D75d`](https://basescan.org/address/0x6947DA282E447a2e9d65ff00aAf80efB5116D75d) | Superseded (2024-09-02)              | —                  |
| BunniLensV2                          | latest at [`0x1733c304…9c44`](https://basescan.org/address/0x1733c304)                                                  | Active                               | —                  |
| Sample BunniToken (LP)               | varies per pool — see the Vaults page in the app                                                                        | —                                    | —                  |

> **Note on the docs migration:** the previous version of this page listed `0x176ca19…08f0` as the "esALB-ETH pair". That contract is a `BunniToken` (a wrapped V3 LP position over the ALB/WETH pool), **not** a Uniswap V2 pair. Bunni LP tokens are minted by BunniHub, not by the team deployer.

## esALB & escrowed token system

The escrow / lock system follows Camelot's xGRAIL pattern.

| Component                                                             | Address                                                                                                                                                                                                                                          | Status                                                                                                  | Owner                |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | -------------------- |
| esALB (`EsToken`, name "Escrowed ALB", symbol `esALB`)                | [`0xe1afc637f41e05efe08d55296a2ccff0072a4587`](https://basescan.org/address/0xe1afc637f41e05efe08d55296a2ccff0072a4587)                                                                                                                          | Active                                                                                                  | —                    |
| esALB (alt — referenced in the historical "Changing allowance" guide) | [`0x365c6d588e8611125De3bEA5B9280C304FA54113`](https://basescan.org/address/0x365c6d588e8611125De3bEA5B9280C304FA54113)                                                                                                                          | Co-deployed 2024-04-25 — see [Changing allowance](/alb-and-esalb/escrowed-alb-esalb/changing-allowance) | —                    |
| `EsProxyMaster` (esALB system orchestrator)                           | [`0xd3968a4a07d64c6e16982d45191b9a09a261ec88`](https://basescan.org/address/0xd3968a4a07d64c6e16982d45191b9a09a261ec88)                                                                                                                          | Active                                                                                                  | Team deployer (team) |
| `EsTokenController` (refresh, 2025-06-05)                             | [`0x154d41a96ad37570a2ad6849063d0b480da1ea99`](https://basescan.org/address/0x154d41a96ad37570a2ad6849063d0b480da1ea99)                                                                                                                          | Active                                                                                                  | —                    |
| `esLP-ALB-ETH` (escrowed LP)                                          | [`0x3d3a5ad6d7beab234d7f0338a01e62b1d36d8ea0`](https://basescan.org/address/0x3d3a5ad6d7beab234d7f0338a01e62b1d36d8ea0)                                                                                                                          | Active                                                                                                  | —                    |
| `esLP-B-ALB-ETH` ("Backstop")                                         | [`0x4a023efe4b5cd304e800f29074186164fda36978`](https://basescan.org/address/0x4a023efe4b5cd304e800f29074186164fda36978)                                                                                                                          | Active                                                                                                  | —                    |
| `EsVoting` (governance weight helpers)                                | [`0x3f8d116e99bce42b38989a62394fa9bb532dddc1`](https://basescan.org/address/0x3f8d116e99bce42b38989a62394fa9bb532dddc1), [`0xd3cfcb52ec5715652c5096bdf99ea078c4df2e7b`](https://basescan.org/address/0xd3cfcb52ec5715652c5096bdf99ea078c4df2e7b) | Active                                                                                                  | —                    |
| `EsComplexRewarder` (dual rewards for escrowed LPs)                   | multiple, see the Farms page                                                                                                                                                                                                                     | Active                                                                                                  | —                    |

## Vesting

Multi-year vesting for team and DAO contributors authorized by [AIP-4](https://snapshot.org/#/alienbase-dex.eth/proposal/0x3e1f7e1841389638f6fda99baefd61331cf711fdc7f4649ad96713c25a747826).

| Component                                  | Address                                                                                                                                                                                                                                          | Status     | Owner |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | ----- |
| `VestingFactory`                           | [`0x77ec0394e4edea1997bdb1919bb354d880faed84`](https://basescan.org/address/0x77ec0394e4edea1997bdb1919bb354d880faed84), [`0xf61cc1aedd072784d8f133ba9409c538cfc9453d`](https://basescan.org/address/0xf61cc1aedd072784d8f133ba9409c538cfc9453d) | Active     | —     |
| `TokenLock` (legacy launch-time team lock) | [`0x329efd9209f1ae6f43568b85e9bdf69105fb8b0c`](https://basescan.org/address/0x329efd9209f1ae6f43568b85e9bdf69105fb8b0c)                                                                                                                          | Historical | —     |

## Epsilon Router (orders)

The on-chain order engine behind Limit / Take Profit / Stop Loss / Trailing Stop / DCA orders. See [Epsilon](/trading/epsilon).

| Component         | Address                                                                                                                 | Status                         | Owner |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------ | ----- |
| **EpsilonRouter** | [`0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580`](https://basescan.org/address/0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580) | **Active** (verified, audited) | —     |

## Carbon (deprecated Limit / Range / Recurring orders)

A direct integration of Bancor's Carbon protocol — Alien Base was the first DEX to integrate Carbon natively rather than via a license. Order creation was deprecated in July 2026 in favor of the Epsilon Router; contracts remain live and existing orders stay withdrawable. See [Archive — Carbon Orders](/archive/carbon-orders).

| Component                                                                 | Address                                                                                                                 | Status                           | Owner |
| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----- |
| `CarbonController`                                                        | [`0xe3763886bf91d5466b416b37fdf2b6337897716e`](https://basescan.org/address/0xe3763886bf91d5466b416b37fdf2b6337897716e) | Live (deprecated for new orders) | —     |
| `Voucher` (impl)                                                          | [`0x8377244a3521ff658e008df0dd40b50ca3ce534c`](https://basescan.org/address/0x8377244a3521ff658e008df0dd40b50ca3ce534c) | Live (deprecated for new orders) | —     |
| `Voucher` proxy ("Carbon Automated Trading Strategy" NFT, `CARBON-STRAT`) | [`0x2f3b0d35830b921fe7fcd08401c6cbbe29a72dc9`](https://basescan.org/address/0x2f3b0d35830b921fe7fcd08401c6cbbe29a72dc9) | Live (deprecated for new orders) | —     |

Source: [`alienbase-xyz/carbon-contracts`](https://github.com/alienbase-xyz/carbon-contracts) (a fork of `bancorprotocol/carbon-contracts`).

## Token Generator

Permissionless on-chain token launcher.

| Component                                                     | Address                                                                                                                 | Status     | Owner                |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------- | -------------------- |
| **TokenGenerator** orchestrator (collects 0.015 ETH per mint) | [`0xBcE75497D72b25c3509B62ae1a47CCfb502AD08d`](https://basescan.org/address/0xBcE75497D72b25c3509B62ae1a47CCfb502AD08d) | Active     | Team deployer (team) |
| `SimpleTokenFactory`                                          | [`0x3b01457255bD6ec460D9Ab8f31CFabd8a710D176`](https://basescan.org/address/0x3b01457255bD6ec460D9Ab8f31CFabd8a710D176) | Active     | —                    |
| `MintableTokenFactory`                                        | [`0x6a9668c2C6E1FB107021375BaCD9d92e79cc8369`](https://basescan.org/address/0x6a9668c2C6E1FB107021375BaCD9d92e79cc8369) | Active     | —                    |
| `BurnableTokenFactory`                                        | [`0xF5A7A624f4c11F581eb5a2B12e9bcA327F692c79`](https://basescan.org/address/0xF5A7A624f4c11F581eb5a2B12e9bcA327F692c79) | Active     | —                    |
| `MintBurnTokenFactory`                                        | [`0x872521B46095139e70A38AE3e8d95611649AAF51`](https://basescan.org/address/0x872521B46095139e70A38AE3e8d95611649AAF51) | Active     | —                    |
| `TaxTokenFactory`                                             | [`0x13De15f0c5E8CC78Ad3a7001bA2Cb882aaE96373`](https://basescan.org/address/0x13De15f0c5E8CC78Ad3a7001bA2Cb882aaE96373) | Active     | —                    |
| Earlier `TaxTokenFactory` builds                              | `0xcbac…8436`, `0x1b24…b484`, `0x9f36…2c9f`                                                                             | Superseded | Do not use           |

## Governance

| Component                                                      | Address                                                                                                                 | Status               | Owner           |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------- | --------------- |
| **DAO Multisig** (Gnosis Safe, 5-of-8)                         | [`0x4ab9070b7680f802cbf8322e597a4409902171e5`](https://basescan.org/address/0x4ab9070b7680f802cbf8322e597a4409902171e5) | Active               | Self (multisig) |
| Snapshot space                                                 | [`alienbase-dex.eth`](https://snapshot.org/#/alienbase-dex.eth)                                                         | Active               | —               |
| Original AIP-2 "DAO treasury wallet" (EOA, also a Safe signer) | [`0xD9c14E5Ad86d06de762F0D179109661E5B60cC4d`](https://basescan.org/address/0xD9c14E5Ad86d06de762F0D179109661E5B60cC4d) | Historical reference | EOA             |
| Snapshot strategies fork                                       | [`alienbase-xyz/snapshot-strategies`](https://github.com/alienbase-xyz/snapshot-strategies)                             | Active               | —               |

## Deployer

The team deployer EOA is publicly tagged on Basescan as **"AlienBase: Deployer"**:

> [`0xDD3705A1c50Fc84B6d31394aA8F4D568B98a8AD5`](https://basescan.org/address/0xDD3705A1c50Fc84B6d31394aA8F4D568B98a8AD5)

It's a gas wallet with a low ETH balance; almost all of Alien Base's contracts trace back to deployments by this address. The Token Generator orchestrator routes its 0.015 ETH per-mint fee here.

## Deprecated products

These contracts are still on-chain but are no longer actively maintained or recommended. See the [Archive](/archive/archive) for context.

| Product                       | Sample contract                                                                                                                                                                                           | Status                | Note                                                      |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | --------------------------------------------------------- |
| **Area 51** sub-DEX           | Factory [`0x2d5dd5fa…e51e`](https://basescan.org/address/0x2d5dd5fa7B8a1BFBDbB0916B42280208Ee6DE51e), Router [`0x3485F8E1…79e7`](https://basescan.org/address/0x3485F8E155973cC247CBEa9E77C0dBBB4BBb79E7) | Deprecated (Oct 2024) | The Token Generator product survives separately.          |
| **StableSwap** (Saddle-style) | `SwapFlashLoan` [`0x927860797d…bb27`](https://basescan.org/address/0x927860797d8CC9b94e3FdC6F1a4a3C42aDfFbb27)                                                                                            | Deprecated (Oct 2024) | Replaced by V3 stable-tier pools.                         |
| **PredictionETH**             | [`0xfbe87ee1ee62244a2df80a8093eab829c52863e8`](https://basescan.org/address/0xfbe87ee1ee62244a2df80a8093eab829c52863e8)                                                                                   | Discontinued          | Binary options MVP (2023).                                |
| **AlienbaseLottery**          | [`0x4384dcf974769f2e0e52cde92b6d5fc9be5248ff`](https://basescan.org/address/0x4384dcf974769f2e0e52cde92b6d5fc9be5248ff)                                                                                   | Discontinued          | ETH-ticket lottery (2023).                                |
| **B3 multi-chain deployment** | (B3 chain, addresses N/A)                                                                                                                                                                                 | Shelved (Oct 2025)    | First multi-chain expansion; partnership did not deliver. |

## Documentation errors fixed in this revision

If you're cross-referencing the previous version of this page, note:

1. **Area 51 Router label/link mismatch** — the previous label `0x837d9B41…3376` is not a contract. The correct address is the linked one, `0x3485F8E1…79e7`.
2. **"Farm Timelock Proxy"** — the address `0x16f1F806…e4fB` is the original `DistributorController` itself, not a proxy. As of 2025-06-05 it is also no longer the active controller (replaced by `UniversalDistributorController`).
3. **"esALB-ETH pair"** — the address `0x176ca19…08f0` is a Bunni V3 LP token, not a Uniswap V2 pair.
4. **"Sample BunniToken" example** — the previous example referenced an ALB/USDbC pair. USDbC is the deprecated Coinbase-bridged USDC variant; users should reference USDC pairs instead.

## Source code

| Repo                                                                                        | Coverage                                                          |
| ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [`alienbase-xyz/alienbase-contracts`](https://github.com/alienbase-xyz/alienbase-contracts) | V2 stack + ALB token (lags onchain — last public update Nov 2024) |
| [`alienbase-xyz/area51-contracts`](https://github.com/alienbase-xyz/area51-contracts)       | Area 51 V2 fork (deprecated)                                      |
| [`alienbase-xyz/carbon-contracts`](https://github.com/alienbase-xyz/carbon-contracts)       | Bancor Carbon fork                                                |
| [`alienbase-xyz/Mothership`](https://github.com/alienbase-xyz/Mothership)                   | Mothership ALM (under audit)                                      |
| [`alienbase-xyz/snapshot-strategies`](https://github.com/alienbase-xyz/snapshot-strategies) | Custom esALB voting strategies                                    |
| [`alienbase-xyz/DefiLlama-Adapters`](https://github.com/alienbase-xyz/DefiLlama-Adapters)   | TVL adapter contributions                                         |

Several deployed contracts (TokenGenerator, EsProxyMaster, EsTokenController, EsVoting, EsComplexRewarder, UniversalDistributorController, VestingFactory, AlienbaseLottery, PredictionETH, AlienbaseZapV1, the recent Alien Base 2.0 rollout) are **verified on Basescan** but their source repositories are not yet public. This is on the roadmap to fix.


# Fees

Single source of truth for every fee on Alien Base

This page lists every fee charged anywhere on Alien Base, what it pays for, and where the value flows.

> *Last updated: July 6, 2026.*

## TL;DR

* Alien Base charges **no buy/sell taxes** on the ALB token.
* Liquidity providers earn pool fees directly. **esALB stakers** earn a share of protocol fees as **Real Yield in WETH** and other liquid assets.
* The platform itself takes only what's needed to fund the operating budget approved by the DAO.

## At a glance

| Product                                         | Fee                                                                       | Where it goes                   |
| ----------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------- |
| **V2 swap** (pool fee)                          | **0.16%**                                                                 | LPs                             |
| **V3 swap** (pool fee)                          | **7 fee tiers** (see below)                                               | **50% LPs / 50% esALB stakers** |
| **Swap** (platform fee)                         | **0.01% / 0.05% / 0.15%** (stables / blue chips / other) + 0.05% Protocol | Treasury / esALB                |
| **Limit / Take Profit** orders                  | **0.01% / 0.05% / 0.10%** (stables / blue chips / other) + 0.05% Protocol | Treasury / esALB                |
| **Stop Loss / Stop Buy / Trailing Stop** orders | **0.10% / 0.20% / 0.45%** (stables / blue chips / other) + 0.05% Protocol | Treasury / esALB                |
| **DCA** orders (per chunk)                      | **0.01% / 0.10% / 0.20%** (stables / blue chips / other) + 0.05% Protocol | Treasury / esALB                |
| **Token Generator**                             | **0.015 ETH** per token mint                                              | Operating budget                |
| Liquidity ops (add / remove / claim)            | None                                                                      | —                               |
| Locking ALB → esALB                             | None                                                                      | —                               |
| Unlocking esALB → ALB                           | None                                                                      | —                               |

> The **Protocol execution fee** is a flat **0.05%** charged on top of the platform fee for every trade executed through Epsilon — swaps and resting orders alike.

## Trading fees

### V2 swaps

* **0.16% per swap** in standard V2 pools, paid by the taker.
* **Distribution:** flows to LPs in-pool and esALB holders.

### V3 (Concentrated Liquidity) swaps

V3 uses fee tiers. Each pool is created with a fixed tier:

| Tier       | Best for                                                |
| ---------- | ------------------------------------------------------- |
| **0.01%**  | Tightly-pegged stablecoin pairs (USDC/USDbC, USDC/USDT) |
| **0.02%**  | Standard stablecoin pairs                               |
| **0.03%**  | LSDs and very-blue-chip volatile pairs (ETH/cbETH)      |
| **0.04%**  | Wider-spread stable / LSD pairs                         |
| **0.075%** | Blue chips (ETH, BTC and wrapped variants)              |
| **0.30%**  | Mid-cap and standard tokens                             |
| **1.00%**  | Small-cap and memecoin pairs                            |

The wide tier ladder lets each pool choose the fee that matches its volatility. Tighter pegs use the lower tiers; volatile pairs use the higher tiers.

**Distribution:** **50% to LPs** in-pool, **50% to esALB stakers** as Real Yield. esALB Real Yield is paid in WETH (and select underlying tokens / stablecoins).

### Swap platform fee (Epsilon)

Every swap executed through [Epsilon](/trading/epsilon) pays a small platform fee on top of the underlying pool fees, tiered by asset class, plus the flat Matcher execution fee:

| Asset class                                | Platform fee | + Protocol | Total     |
| ------------------------------------------ | ------------ | ---------- | --------- |
| Stables                                    | 0.01%        | 0.05%      | **0.06%** |
| Blue chips (ETH, BTC and wrapped variants) | 0.05%        | 0.05%      | **0.10%** |
| Everything else                            | 0.15%        | 0.05%      | **0.20%** |

In nearly every case the fee is significantly less than the price improvement Epsilon captures by aggregating the entire chain.

**Distribution:** routed to the Treasury, with the bulk going to the esALB Real Yield stream.

### Epsilon Router orders (Limit / Stop / Trailing Stop / DCA)

Resting orders live in the on-chain [Epsilon Router](/trading/epsilon#the-epsilon-router) and are executed by the Matcher when their trigger fires. Fees are tiered by the asset class of the traded pair; every execution also pays the flat **0.05% Protocol fee**:

| Order type                                               | Stables | Blue chips (ETH, BTC) | Everything else |
| -------------------------------------------------------- | ------- | --------------------- | --------------- |
| **Limit / Take Profit**                                  | 0.01%   | 0.05%                 | 0.10%           |
| **Stop Loss / Stop Buy / Trailing Stop / DCA stop-loss** | 0.10%   | 0.20%                 | 0.45%           |
| **DCA chunk**                                            | 0.01%   | 0.10%                 | 0.20%           |
| *+ Protocol execution fee (all of the above)*            | *0.05%* | *0.05%*               | *0.05%*         |

Stop-style orders cost more than plain limit orders because the Matcher must monitor and execute them under adverse, fast-moving market conditions.

On top of the order fee, each fill pays the underlying pool fee of whichever venue the Matcher routes through (exactly like a swap placed at that moment), and your slippage setting applies at execution time.

**Gas:** you pay gas for approving token spend; order creation is gasless and execution gas is handled by the Matcher (funded by its fee).

**Distribution:** routed to the Treasury / esALB Real Yield stream.

### Deprecated: Carbon orders

Carbon-powered Limit / Range / Recurring orders (deprecated July 2026) charged **0.40% on the executed trade** on top of the maker's spread. Existing Carbon orders remain withdrawable; see [Archive — Carbon Orders](/archive/carbon-orders).

## Liquidity provision

There are no fees to add or remove liquidity beyond gas. Specifically:

* **No deposit fees** on V2 farms (the deposit-fee parameter is permanently set to zero post-launch).
* **No withdraw fees** on farms.
* **No performance fee** on Bunni-wrapped V3 positions.

Vaults that auto-compound (Bunni and future Mothership-managed vaults) collect fees inside the AMM pool and increase the LP token's redemption value over time; there is no on-claim performance fee taken at the vault layer.

## ALB locking & vesting

* **Locking ALB → esALB:** free. 1:1.
* **Unlocking esALB → ALB:**
  * 30-day full unlock: free, no penalty. Vested position continues to earn at a 30%-reduced APR until redemption.
  * 1% every 12 hours: free, instant.
  * Redemption window: 7 days after the 30-day vesting completes — if not claimed in 7 days, the position auto-relocks for another 30 days.
* **Vesting (multi-year):** the AIP-4 / VestingFactory streams have no user-facing fee; they are an internal accounting facility for team / DAO contributors.

## Token Generator

* **Deployment fee:** **0.015 ETH per token**, regardless of template.
* The fee is paid in ETH at deploy time and is non-refundable.
* The deployment fee funds the operating budget; an explicit per-template breakdown is not maintained.

If your generated token uses the **Tax** template, your token's own buy/sell taxes are independent of any Alien Base fee — the Tax token implements its own taxation logic, payable to the addresses you set.

## Where the protocol's share goes

Per **AIP-3** and **ADIP-01**, the protocol's share of fees (V3 50% staker share, Epsilon front-end, Epsilon Router order fees, Token Generator) flows to:

1. **Real Yield to esALB holders** in WETH and protocol tokens — this is the largest line.
2. **DAO operating budget** (audits, infrastructure, marketing, legal, dev allowances) — set as a USDC and ALB allocation per cycle, not as a percentage.
3. **Protocol-Owned Liquidity (POL)** — building treasury liquidity that earns yield → buyback-and-burn ALB (ramping under [AIP-5](https://snapshot.org/#/alienbase-dex.eth/proposal/0x9328ecc5a0d2527a1e73fd30085e7ba2120a985b7782ce843f15ee2ddf38ca63)).

The most recent published dollar allocations are defined in [ADIP-01](https://snapshot.org/#/alienbase-dex.eth/proposal/0xae936ad8ddb58b90128ff8da95bb6edded6188ba4c87f2ea724d771cfcc17cac) (Sept 2025 → Feb 2026); team funding is transitioning to the AIP-5 Line-of-Credit model.

## Historical fee changes

| Date       | Change                                                                                                                                                                                                                                                                        | Source                                                                                                                               |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| 2023-08-08 | Launch with **0.16% V2 swap fee**.                                                                                                                                                                                                                                            | [Roadmap for Aliens](https://medium.com/@alienbase/the-roadmap-for-aliens-c84a86d337cc)                                              |
| 2023-11-27 | V3 launches with concentrated-liquidity fee tiers; AIP-2 establishes the LP / staker fee-sharing structure (originally 60/40, later normalized to 50/50).                                                                                                                     | [AIP-2](https://snapshot.org/#/alienbase-dex.eth/proposal/0xea788bd0daf9fb61acb0199874abc56f9c871cc2e117c3c1c11a45ba1ced7f52)        |
| 2024-Q3    | Carbon Limit / Range / Recurring orders launch.                                                                                                                                                                                                                               | [Carbon DeFi blog](https://www.carbondefi.xyz/blog/alien-base-is-the-first-to-integrate-bancor-technologies-directly-into-its-dex)   |
| 2024-Q4    | Real Yield in WETH activated for esALB stakers.                                                                                                                                                                                                                               | [AIP-3](https://medium.com/@alienbase/aip-3-establishing-dao-budget-for-2nd-halving-cycle-8092e0039cfd)                              |
| 2024-11    | Epsilon adds Odos with a **0% Epsilon fee promo** for an initial period.                                                                                                                                                                                                      | [Epsilon Upgrade](https://medium.com/@alienbase/epsilon-upgrade-odos-integration-and-introduction-to-epsilon-analytics-66b779bf9912) |
| 2025-06    | Third halving — yearly inflation cut 30% → 15%; fee structure unchanged.                                                                                                                                                                                                      | [AIP-4](https://snapshot.org/#/alienbase-dex.eth/proposal/0x3e1f7e1841389638f6fda99baefd61331cf711fdc7f4649ad96713c25a747826)        |
| 2026-04    | AIP-5 ratifies replacing fixed halvings with flexible emissions + persistent buybacks.                                                                                                                                                                                        | [AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2)                                                    |
| Current    | Epsilon Router launch. Carbon orders (0.40%) deprecated. New tiered schedule: swaps 0.01/0.05/0.15%, Limit/TP 0.01/0.05/0.10%, Stop/Trailing 0.10/0.20/0.45%, DCA 0.01/0.10/0.20%, all + 0.05% Protocol. Former Epsilon front-end fee (0.03%/0.20%, non-native only) retired. | [Changelog](/changelog)                                                                                                              |


# Audits & Security

Audit status and security posture of Alien Base contracts

This page tracks the security posture of every contract Alien Base has deployed. It is updated whenever a new audit report is published, a new contract is deployed, or a permission boundary changes.

> *Last updated: July 6, 2026.*

## Summary

Alien Base contracts fall into three buckets:

| Bucket                        | What it means                                                                                                                                                                           | Examples                                                                     |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **Audited**                   | Contracts written by Alien Base, audited by a third party, report complete.                                                                                                             | Epsilon Router (+ off-chain meta-aggregator integration)                     |
| **Audit upcoming**            | Contracts written by Alien Base that have an audit scoped and in flight, but no report yet. The contract may be live on mainnet behind supply caps or feature flags during this period. | Mothership                                                                   |
| **Inherited upstream audits** | Forks of well-audited upstream protocols. Audit coverage applies only to the unchanged-core parts.                                                                                      | V2 / V3 core, BunniHub, SmartRouter, CarbonController, MasterChef-style farm |

We deliberately do not claim audit coverage we don't have. If you see a third-party article saying "Alien Base contracts have been audited by reputable firms" without naming the firm, date, scope, and report URL, treat it as marketing rather than evidence.

## Audited

### Epsilon Router — audited by Hexens

* **Auditor:** [Hexens](https://hexens.io/) — review led by Kasper Zwijsen, Head of Audits.
* **Scope:** the full Epsilon protocol — the on-chain Epsilon Router and Matcher (the contracts holding and settling all resting orders: Limit, Take Profit, Stop Loss, Trailing Stop, DCA), the TWAP / Redstone price-oracle layer, and the off-chain keeper + indexer infrastructure.
* **Contract:** [`0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580`](https://basescan.org/address/0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580) — verified source on Basescan.
* **Timeline:** audit started April 27, 2026; final report June 1, 2026 — before the July 2026 production launch.
* **Findings:** 37 total — 2 critical, 3 high, 14 medium, 12 low, 6 informational. Per the report: *"All reported issues were fixed or acknowledged by the development team and subsequently verified by us."*
* **Report:**

{% file src="/files/EyifMrJM1YywY9Gzj2oy" %}

* **What this means for users:** Epsilon is the path most swaps take, and the Router holds resting-order funds. Both critical issues (order registration without signature validation, keeper not bound into the signed order) were fixed and verified before any user funds touched the contract.

## Audit upcoming

### Mothership

* **Scope:** Alien Base's first ALM (Automated Liquidity Manager). Components include `MothershipVaultRouter`, `MothershipVaultPublic` (ERC-20 share vault), `UniManyDirectCore` (multi-range V3 position manager), and `UniManyDirectHelper`.
* **Status:** pre-audit hardening complete. The public [`Mothership`](https://github.com/alienbase-xyz/Mothership) repo includes an explicit `audit-scope` commit (Jan 15, 2026) and a fuzz-test suite. The audit firm and report will be published before the MVP is opened to the public without supply caps.
* **Pre-launch posture:** any Mothership contracts deployed before audit completion run with strict supply caps and gated access; see the [Vaults](/liquidity/vaults) page for the live status.
* **Report:** *to be linked here when published.*

## Inherited upstream audits

For unchanged-core forks, the upstream auditor's findings transfer. We list what we forked, who originally audited it, and which Alien Base address it corresponds to.

### Uniswap V2 — V2 Factory, V2 Router, Area 51 Factory + Router, Pair contracts

* **Upstream auditors:** Uniswap V2 was audited by **dapp.org** (formerly New Alchemy) and ABDK (parts).
* **Reports:** [Uniswap V2 Audit Report — dapp.org](https://github.com/Uniswap/v2-core/blob/master/audits/dapphub/v2-audit-report.pdf), additional security reviews on [uniswap.org/audits](https://uniswap.org/audits).
* **Coverage on Alien Base:** the V2 Factory, V2 Router, and the equivalent Area 51 Factory + Router are stock Uniswap V2 with no modifications to the audited core paths.

### Uniswap V3 — V3 Factory, NFTPositionManager, V3 Pools

* **Upstream auditors:** **Trail of Bits**, **ABDK**, plus the **Uniswap V3 Code4rena** contest (2021).
* **Reports:** [uniswap.org/audits](https://uniswap.org/audits).
* **Coverage on Alien Base:** the V3 Factory, NFTPositionManager, multicall, TickLens, and NFT renderer are stock Uniswap V3.

### PancakeSwap MasterChef — `BasedDistributorV2` farm

* **Upstream auditors:** PancakeSwap MasterChef (and MasterChefV2) audits by **PeckShield** and **CertiK**.
* **Reports:** linked from the PancakeSwap docs.
* **Coverage on Alien Base:** the `BasedDistributorV2` contract, the `DistributorController` family, the new `UniversalDistributorController` (active since June 5, 2025), and the dual-reward `ComplexRewarderPerSecV4` contracts use the MasterChef pattern.

### PancakeSwap SmartRouter — V3 SmartRouter

* **Upstream auditor:** **CertiK**.
* **Reports:** linked from the PancakeSwap docs.
* **Coverage on Alien Base:** the SmartRouter at `0xB20C411F…9411` is forked from PancakeSwap and **lightly adapted**. Adaptations (notably native-Carbon support and Alien-Base-specific routing) are not covered by the upstream report and fall under the Epsilon audit scope.

### Bunni / Timeless Finance — BunniHub, BunniZap, BunniToken

* **Upstream auditors:** Bunni V1 audited by Spearbit (commissioned by Timeless Finance).
* **Reports:** see [Bunni docs](https://docs.bunni.pro/).
* **Coverage on Alien Base:** the BunniHub at `0xDC53487e…aC6F`, BunniZap at `0x6947DA28…D75D`, and BunniLensV2 are upstream Bunni. **BunniZap is lightly adapted for Alien Base** — adaptations are not covered by the upstream report.

### Bancor Carbon — CarbonController + Voucher

* **Upstream auditors:** **PeckShield** (Carbon v1.0 — May 29, 2024; CarbonVortex v1.0.1 — July 31, 2024); **ChainSecurity** (Carbon, undated in upstream README).
* **Reports** (mirrored in our fork's `docs/audits/`):
  * [PeckShield — Carbon v1.0](https://github.com/alienbase-xyz/carbon-contracts/blob/dev/docs/audits/PeckShield-Audit-Report-Bancor-Carbon-v1.0.pdf)
  * [PeckShield — CarbonVortex v1.0.1](https://github.com/alienbase-xyz/carbon-contracts/blob/dev/docs/audits/PeckShield-Audit-Report-Bancor-CarbonVortex-v1.0.1.pdf)
  * [ChainSecurity — Carbon](https://github.com/alienbase-xyz/carbon-contracts/blob/dev/docs/audits/ChainSecurity_Carbon_Audit_Report.pdf)
* **Coverage on Alien Base:** the CarbonController at `0xe3763886…716e` (deployed Aug 12, 2024) and the Voucher proxy at `0x2f3b0d35…2dc9` ("CARBON-STRAT" NFT) are the unchanged Bancor implementation. Alien Base did not modify these contracts. Carbon order creation is [deprecated](/archive/carbon-orders) as of July 2026, but the contracts remain live and existing orders stay withdrawable.

### Camelot xGRAIL — esALB / EsToken family

* **Upstream pattern:** The escrow / lock model derives from Camelot's xGRAIL system.
* **Coverage on Alien Base:** the EsToken contracts (`0xe1afc637…4587` and others), EsProxyMaster (`0xd3968a4a…ec88`), EsTokenController (`0x154d41a9…ea99`), EsVoting helpers, and esLP wrappers are Alien-Base-implemented based on the xGRAIL pattern. They are not separately audited; we treat them as "inherited pattern" rather than "inherited audit". A dedicated audit may be commissioned as part of the AIP-5 / 2.0 rollout.

## Onchain control surface

A security review is incomplete without checking *who* can pull which lever. As of July 6, 2026:

| Contract                                                                            | Privileged role                         | Holder                                 | Type                   |
| ----------------------------------------------------------------------------------- | --------------------------------------- | -------------------------------------- | ---------------------- |
| ALB token                                                                           | DEFAULT\_ADMIN\_ROLE (OZ AccessControl) | Team Safe / DAO                        | Multisig               |
| V2 Factory                                                                          | `feeToSetter`                           | DAO Safe `0x4ab9070b…71e5`             | 5-of-8 Gnosis Safe     |
| V3 Factory                                                                          | `owner`                                 | DAO Safe                               | 5-of-8 Gnosis Safe     |
| `UniversalDistributorController` (current farm controller, active since 2025-06-05) | `owner`                                 | DAO Safe                               | 5-of-8 Gnosis Safe     |
| Original `DistributorController` (legacy)                                           | `owner`                                 | Team operations Safe `0x845e2f13…f543` | Separate Safe (legacy) |
| Token Generator orchestrator                                                        | `owner`                                 | Team deployer EOA `0xDD3705…0aD5`      | Single key             |
| EsProxyMaster                                                                       | `owner`                                 | Team deployer EOA                      | Single key             |

## Multisig & timelock

* **DAO Multisig**: [`0x4ab9070b7680f802cbf8322e597a4409902171e5`](https://basescan.org/address/0x4ab9070b7680f802cbf8322e597a4409902171e5) — 5-of-8 Gnosis Safe. Signers and policy: see [DAO Multisig](/governance/dao-multisig).
* **Timelock**: an OpenZeppelin `TimelockController` is deployed at [`0x1c7e4284…1e21`](https://basescan.org/address/0x1c7e4284423c1a2362c49b1ea223b73e38c81e21). The original `DistributorController` enforces a 7-day delay on emission-rate changes; ALB token mint changes go through a 14-day total time lock.

## Bug bounty

The DAO budget (per ADIP-01) includes a line item for "audits, bug bounties, hosting, nodes, and third-party development". A formal bug-bounty program with explicit severity tiers and contact channels is **on our list to formalize** but not yet live. In the meantime, please report security issues directly to the team via Discord (DM a team member) or email **<dex@alienbase.xyz>**.

## What to verify yourself

For any contract you interact with:

1. Open the Basescan link from [Contracts](/reference/contracts). Confirm the **"Contract"** tab is green ("Contract Source Code Verified").
2. Read the contract's deployer + creation tx. The vast majority of Alien Base contracts were deployed by [`0xDD3705A1c50Fc84B6d31394aA8F4D568B98a8AD5`](https://basescan.org/address/0xDD3705A1c50Fc84B6d31394aA8F4D568B98a8AD5) (publicly tagged "AlienBase: Deployer" on Basescan).
3. For owned contracts, call `owner()` from Basescan's Read tab to confirm who controls them.
4. For Safe-owned contracts, you can independently inspect the Safe at [app.safe.global/base:0x4ab9070b…71e5](https://app.safe.global/home?safe=base:0x4ab9070b7680f802cbf8322e597a4409902171e5).

## Reporting a vulnerability

Don't post a 0-day in public. Reach the team privately first:

* DM the team via [Discord](https://discord.gg/alienbase) — find a moderator with a "Team" or "Core" role.
* Email **<dex@alienbase.xyz>**.
* After the issue is patched and disclosed, we publish a postmortem on [Medium](https://medium.com/@alienbase) and link it from the [Changelog](/changelog).


# Data & Analytics

Where to find live data on Alien Base — token, trading, liquidity, holders

Alien Base data is published live across several venues. The **Dune dashboard maintained by Sealaunch** is the canonical, team-developed source — start there for anything that requires depth (per-pair volume, holder analysis, esALB lock/unlock flows, DEX benchmark comparisons). External market-data sites are still useful for headline numbers and price tracking.

> *Last updated: July 6, 2026.*

## Market snapshot

Point-in-time figures, refreshed manually. Treat these as a sanity check, not live data — click through to the source for the current number.

| Metric                  | Value                                     | As of      | Source                                                                                 |
| ----------------------- | ----------------------------------------- | ---------- | -------------------------------------------------------------------------------------- |
| ALB price               | \~$0.0047                                 | 2026-07-06 | [CoinGecko](https://www.coingecko.com/en/coins/alienbase)                              |
| Market cap              | \~$1.12M                                  | 2026-07-06 | [CoinGecko](https://www.coingecko.com/en/coins/alienbase)                              |
| Fully-diluted valuation | \~$2.23M                                  | 2026-07-06 | [CoinGecko](https://www.coingecko.com/en/coins/alienbase)                              |
| Circulating supply      | \~234M ALB                                | 2026-07-06 | [CoinGecko](https://www.coingecko.com/en/coins/alienbase)                              |
| Total minted supply     | \~465M ALB (\~91% of the 510M cap)        | 2026-07-06 | [Basescan](https://basescan.org/token/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4)      |
| All-time high           | $0.5724 on 2024-11-27 (−99% from ATH)     | 2026-07-06 | [CoinGecko](https://www.coingecko.com/en/coins/alienbase)                              |
| TVL                     | \~$1.63M pooled + \~$1.04M staked         | 2026-07-06 | [DefiLlama](https://defillama.com/protocol/alien-base)                                 |
| Deepest pool            | ALB/WETH on Alien Base, \~$172k liquidity | 2026-07-06 | [DexScreener](https://dexscreener.com/base/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4) |

> **esALB share, holder counts, per-pair volume, lifetime trades/users, and protocol-fee totals** are not exposed by these public APIs — read them off the [Dune dashboard](https://dune.com/sealaunch/alienbase) (`ALB Token & esALB` and `Alien Base Overview` panels) and update the [Welcome page](/) Quick Stats when they move materially.

## Canonical dashboard — Dune (Sealaunch)

[**dune.com/sealaunch/alienbase**](https://dune.com/sealaunch/alienbase) — the official Alien Base analytics dashboard, developed in partnership with [Sealaunch](https://www.sealaunch.xyz/).

What's on it:

| Section                     | Includes                                                                                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Alien Base Overview**     | 30-day trades, 30-day unique addresses, 30-day volume ($), cumulative trades, addresses trading, average trade value, average value per trader                                                          |
| **DEX Activity Benchmark**  | Cross-DEX comparison (3-month moving average via DefiLlama) — trades per user, average trade size, average volume per address, % low-value txs (< $0.10), % HFT addresses (>1,000 txs/day)              |
| **Top Traded Pairs**        | Per-pair: trades, volume in $, volume %, unique addresses trading. Includes a "Top DEX Token Pairs List" table; a `Δ = Infinity` flag indicates a newly-launched pair                                   |
| **ALB Token & esALB**       | $ALB price, ALB Max Supply, current Supply, Circulating (Supply − esALB), ALB in esALB, ALB locked on esALB, Mcap, ALB holders, esALB holders, Total Holders (ALB + esALB), Top 100 ALB + esALB holders |
| **esALB lock/unlock flows** | Daily ALB → esALB and esALB → ALB activity                                                                                                                                                              |
| **Fees**                    | Protocol fees collected over time                                                                                                                                                                       |

Best for: deep dives, cross-DEX benchmarking, token-distribution analysis, governance research, and "is the protocol healthy?" questions.

## In-app — Explorer

Inside [app.alienbase.xyz](https://app.alienbase.xyz) → **Explorer** in the sidebar ([/info](https://app.alienbase.xyz/info)). Chain-wide token & pool explorer powered by Alien Base's own data layer (the same one Epsilon uses for routing). Includes GoPlus-powered token safety checks per token.

Best for: live exploration of any token or pool on Base from inside the dApp. See [Explorer](/trading/epsilon-analytics).

## Headline numbers — DefiLlama

[**defillama.com/protocol/alien-base-v3**](https://defillama.com/protocol/alien-base-v3) — TVL, fees, trading volume per protocol entry. DefiLlama lists multiple Alien Base entries (V2, V3, deprecated Area 51 and StableSwap); roll them up if you want the headline TVL.

Best for: headline TVL, fees-collected, lifetime-volume figures.

## Token tracking

| Site                                                                                   | Use                                                                  |
| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [CoinGecko](https://www.coingecko.com/en/coins/alienbase)                              | Price, market cap, fully-diluted valuation, social links, watchlists |
| [DexScreener](https://dexscreener.com/base/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4) | Every ALB pool on every DEX on Base, live trade tape                 |
| [GeckoTerminal](https://www.geckoterminal.com/)                                        | Alternate pool view; cleaner charts on illiquid pairs                |
| [CoinMarketCap](https://coinmarketcap.com/currencies/alien-base/)                      | Price, supply, and market-cap tracking (listed since launch year)    |

## On-chain explorers

* [**Basescan**](https://basescan.org/token/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4) — primary explorer for Base. Token holders, transfers, contract reads/writes.
* [**Blockscout**](https://base.blockscout.com/) — alternative explorer; sometimes faster on read-only queries; native API isn't blocked by Cloudflare.

## Governance & treasury

* [**Snapshot space**](https://snapshot.org/#/alienbase-dex.eth) — every AIP / ADIP, vote results, current voting power.
* [**DAO Multisig on Safe**](https://app.safe.global/home?safe=base:0x4ab9070b7680f802cbf8322e597a4409902171e5) — live treasury composition and pending Safe transactions.

## Repos

* [**github.com/alienbase-xyz**](https://github.com/alienbase-xyz/) — public source code for the contracts + apps that have public repos. (Not every deployed contract has a public repo; we're working on improving this — see [Audits & Security](/reference/audits-and-security).)

## Choosing the right source

| If you need…                                                       | Use                                        |
| ------------------------------------------------------------------ | ------------------------------------------ |
| Headline TVL / volume to drop in a pitch deck                      | DefiLlama                                  |
| ALB price for a watchlist                                          | CoinGecko or DexScreener                   |
| Per-pair volume and trader counts                                  | Dune (Sealaunch)                           |
| Holder distribution / concentration                                | Dune (Sealaunch) "Top 100 ALB + esALB"     |
| esALB lock/unlock flow over time                                   | Dune (Sealaunch) "ALB–esALB Lock/Unlock"   |
| Cross-DEX benchmark (Alien Base vs. Aerodrome vs. Uniswap on Base) | Dune (Sealaunch) "DEX Activity Benchmark"  |
| Live in-app exploration of a Base token                            | Explorer                                   |
| Specific contract state (an `eth_call`)                            | Basescan or Blockscout                     |
| Governance proposal text and votes                                 | Snapshot                                   |
| Treasury composition right now                                     | Safe (live) or Dune Fees panel (over time) |

## See also

* [ALB Token](/alb-and-esalb/alb-token) — for context on the supply numbers shown in the Dune dashboard.
* [Explorer](/trading/epsilon-analytics) — the in-app data surface.
* [Audits & Security](/reference/audits-and-security) — what's verified vs. unverified.
* [Contracts](/reference/contracts) — addresses to plug into any explorer.


# Glossary

Quick definitions for terms used across Alien Base

A short reference for terms you'll see repeatedly in Alien Base's docs and UI.

> *Last updated: July 6, 2026.*

### ADIP

*Alienbase DAO Improvement Proposal.* A governance proposal authored by the [Alien Foundation](/governance/alien-foundation) (rather than an individual address). Used for operating-budget proposals and Foundation-administered actions. See [ADIP-01](https://snapshot.org/#/alienbase-dex.eth/proposal/0xae936ad8ddb58b90128ff8da95bb6edded6188ba4c87f2ea724d771cfcc17cac) for the canonical example.

### AIP

*Alienbase Improvement Proposal.* A governance proposal voted on at [`alienbase-dex.eth`](https://snapshot.org/#/alienbase-dex.eth). Anyone holding 100,000+ ALB of voting power can submit one. Index: [AIP Index](/governance/aip-index).

### ALB

The native token of Alien Base. ERC-20 on Base. [`0x1dd2…50c4`](https://basescan.org/token/0x1dd2d631c92b1acdfcdd51a0f7145a50130050c4). See [ALB Token](/alb-and-esalb/alb-token).

### ALM (Automated Liquidity Manager)

A protocol that actively manages V3 (concentrated-liquidity) positions on behalf of LPs. Alien Base's ALM is **Mothership** — see [Mothership](/liquidity/mothership).

### Area 51

The original umbrella name for Alien Base's developer-tooling suite. Also the name of a now-deprecated isolated fee-tier DEX. The dev-tooling concept lives on through products like the [Token Generator](/builders/token-generator). The deprecated DEX is documented in the [Archive](/archive/area-51).

### Base

The Coinbase-incubated, Optimism-stack, EVM-compatible L2 Alien Base lives on. Chain id: 8453. See [base.org](https://base.org).

### Bunni

A Uniswap V3 LP-position wrapper that turns NFT positions into ERC-20 tokens. Alien Base uses Bunni to make V3 positions composable, transferable, and farmable. See [Bunni explainer](/liquidity/bunni).

### Carbon

Alien Base's former integration of Bancor's Carbon DeFi technology, which powered Limit, Range, and Recurring (grid) orders until July 2026. Deprecated in favor of the Epsilon Router order system; existing Carbon orders remain withdrawable. See [Archive — Carbon Orders](/archive/carbon-orders).

### CEX-quality UI / UX

Shorthand the team uses for "trading and liquidity flows that feel like a CEX, but are still permissionless and self-custodial." It's the design north star for Alien Base.

### Concentrated Liquidity

A V3 LP design where LPs choose a price range for their liquidity rather than spreading it across the whole curve. Provides much higher capital efficiency at the cost of being out-of-range when price moves. See [V3](/liquidity/v3).

### DCA

Dollar-Cost Averaging. Splits a buy or sell into small chunks executed over time, with optional trigger price and stop loss. Fees per chunk are tiered by asset class (0.01% stables / 0.10% blue chips / 0.20% other). See [DCA Orders](/trading/dca-orders).

### Epsilon

Alien Base's trading engine: the meta-aggregator that routes swaps through whichever venue (Alien Base V2/V3, Aerodrome, Uniswap, etc.) gives the best price, plus the on-chain **Epsilon Router** that holds and settles resting orders (Limit, Take Profit, Stop Loss, Trailing Stop, DCA). The **Explorer** exposes the underlying data. See [Epsilon](/trading/epsilon).

### Epsilon Router

The on-chain contract ([`0x303c…2580`](https://basescan.org/address/0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580)) where Alien Base's resting orders live. Audited; live since July 2026. See [Epsilon](/trading/epsilon#the-epsilon-router).

### esALB / esLP

*Escrowed ALB / Escrowed LP.* Locked, non-transferable forms of ALB and select LP tokens that earn voting power, single-staking APR, and Real Yield. Convertible 1:1 with the underlying token; redemption paths are 100% after a 30-day cooldown or 1% instantly every 24 hours. See [esALB](/alb-and-esalb/escrowed-alb-esalb).

### Fair launch

A token launch with no pre-mine, no pre-sale, and no insider allocation released ahead of the public. Alien Base launched fair on August 8, 2023.

### Farming

Earning ALB rewards by staking LP tokens (or esALB / esLP) in the protocol's distributors. Historically the main user incentive; under [AIP-5](/alb-and-esalb/alien-base-2-0) farming is being phased out in favor of POL.

### Foundation

See [Alien Foundation](/governance/alien-foundation). The Cayman-registered, ownerless legal entity that gives the DAO offchain legal footing.

### govALB

A new staked-escrow form of esALB introduced by [AIP-5](/alb-and-esalb/alien-base-2-0): **10× voting power**, 1× earning power, \~2-year effective lock. Designed for users who want maximum governance influence and are willing to commit time.

### LoC (Line of Credit)

The Dev Line of Credit introduced by [AIP-5](/alb-and-esalb/alien-base-2-0): the team's funding becomes tracked debt with interest paid to esALB holders. Price-tier grant tranches at $0.40, $1, and $2 unlock as ALB sustains those moving averages. See [Alien Labs](/governance/alien-labs).

### Matcher

Epsilon's execution engine. Watches resting orders in the Epsilon Router and fills them through the meta-aggregator when their trigger condition is met, charging a flat 0.05% execution fee per fill. Users pay gas only at order creation/cancellation; the Matcher pays execution gas. See [Epsilon](/trading/epsilon#the-matcher).

### Meta-DEX

The umbrella term Alien Base uses for itself. Combines a native DEX (V2 + V3), a meta-aggregator + on-chain order engine (Epsilon), liquidity management (Mothership), and developer tools (Token Generator) — all on a single platform.

### Mothership

Alien Base's in-house Automated Liquidity Manager (ALM). First fully-original Alien Base protocol (not a fork). Public alpha launches with strict supply caps after audit completion. See [Mothership](/liquidity/mothership).

### POL (Protocol-Owned Liquidity)

Liquidity owned by the protocol itself — typically held in the DAO Multisig — rather than rented from individual LPs via emissions. AIP-5 establishes a POL Fund whose yield is used for buyback-and-burn ALB.

### Real Yield

Protocol fees redistributed to esALB stakers in WETH (and other liquid assets) — not in ALB inflation. See [Real Yield](/alb-and-esalb/real-yield).

### Snapshot

Off-chain governance voting platform. Alien Base's space: [`alienbase-dex.eth`](https://snapshot.org/#/alienbase-dex.eth).

### Stop Loss / Stop Buy

Orders that trigger when price crosses a level in the adverse direction: a Stop Loss sells when price drops to your level; a Stop Buy buys when price climbs to it. Executed on-chain by the Epsilon Router. See [Limit, Take Profit & Stop Loss](/trading/limit-orders).

### Take Profit

A sell order that triggers when price climbs to your target. See [Limit, Take Profit & Stop Loss](/trading/limit-orders).

### Timelock

A contract that delays execution of privileged actions (e.g., minting ALB, changing emission rates). Alien Base's farm controllers and ALB token use timelocks of 7 and 14 days respectively.

### Token Generator

A tool for deploying tokens on Base from preset templates (Simple, Mintable, Burnable, Mint/Burn, Tax). Charges a small ETH fee per mint, deposited to the team operating budget. See [Token Generator](/builders/token-generator).

### Trailing Stop

A sell order whose trigger follows the market price up by a fixed percentage and fires when price retraces by that amount from its peak. See [Trailing Stop](/trading/trailing-stop).

### TVL (Total Value Locked)

The dollar value of assets sitting in a protocol's pools and vaults. Tracked on [DefiLlama](https://defillama.com/protocol/alien-base-v3).

### Vaults

The successor to "Farms" in the Alien Base UI. The single page that aggregates V3 / Bunni / esALB / esLP / future Mothership-managed positions. See [Vaults overview](/liquidity/vaults).

### V2 / V3

Uniswap V2 and Uniswap V3 — the AMM architectures Alien Base implements. V2 is the original constant-product pool (50/50, full-range). V3 is concentrated-liquidity. See [Liquidity](/liquidity/v3).


# Brand Kit

{% file src="/files/mIMhmvxa8rzU27fIeP7d" %}

{% file src="/files/OmdetHgPfUizf3ukMYb6" %}


# Roadmap

What's shipping next on Alien Base

Alien Base's mission is to be the human-friendly trading hub on Base — a full-stack platform that aggregates the entire chain's liquidity behind a CEX-quality interface, with custom protocols built on top to push capital efficiency further than any single DEX could.

> *Last updated: July 6, 2026.* *For what already shipped, see the* [*Changelog*](/changelog)*. This page focuses on what's coming.*

## Right now

The active build cycle is the **Alien Base 2.0** rollout authorized by [AIP-5](https://snapshot.org/#/alienbase-dex.eth/proposal/0x9328ecc5a0d2527a1e73fd30085e7ba2120a985b7782ce843f15ee2ddf38ca63) (April 2026). The team is shipping the new tokenomics and the next product layer in parallel:

| Workstream                            | Status                                       | What's in it                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Trading terminal + Epsilon Router** | **Shipped — July 2026**                      | Full app redesign around a TradingView-powered trading terminal, plus the on-chain Epsilon Router ([`0x303c…2580`](https://basescan.org/address/0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580)) with native order types: Limit, Take Profit, Stop Loss, Trailing Stop, trigger-price DCA, stop-loss DCA. Audited. See [Epsilon](/trading/epsilon). |
| **Mothership** (ALM)                  | Pre-launch — audit in flight, alpha imminent | Custom-built Automated Liquidity Manager. First "from-scratch" Alien Base protocol. Multi-range V3 management with strategy-plugin architecture. Public alpha launches with strict supply caps.                                                                                                                                                 |
| **Alien Base 2.0 tokenomics**         | Onchain rollout in progress                  | POL Fund, Dev Line of Credit, govALB token, raised supply cap (cap raise not yet executed on-chain). See [ALB Token](/alb-and-esalb/alb-token#alien-base-2-0-aip-5).                                                                                                                                                                            |
| **Vaults**                            | Live since Jan 2026; redesigned July 2026    | Unifies V3 strategy vaults (Wide / Narrow / Ultra Narrow / Classic V3), Locked earn (esALB + esLP), and Legacy farms in one page.                                                                                                                                                                                                               |
| **Explorer** (Epsilon Analytics)      | Live since May 2025                          | Chain-wide Explorer, GoPlus-powered token safety checks, per-pool charts.                                                                                                                                                                                                                                                                       |

## Q3–Q4 2026

Themes for the rest of 2026 (subject to DAO and operating-budget refresh):

* **Mothership Beta** — wider access, multiple strategies, strategy marketplace where third-party LP managers earn fees on user capital.
* **Token Generator v2** — comprehensive launchpad with fair-launch tooling. Replaces and extends the current Token Generator MVP.
* **Analytics & Visualization Revamp** — on-chart order overlays + PnL tracking on top of the live TradingView terminal. Deeper Explorer insights including wallet-cluster analysis (multi-wallets per user, bot detection, whale activity, team-sell detection).
* **Automated esALB reward distribution** — modular fee payouts to esALB stakers, designed to plug into future ALM expansions.
* **Migration of remaining team-controlled contracts** to the DAO Multisig — see the [onchain control surface](/reference/audits-and-security#onchain-control-surface) for which contracts are still team-owned.

## Bigger horizons

Alien Base has consistently set ambitious long-term targets. The list below is honest about which ideas are active engineering and which are research / vision.

| Idea                                      | Status             | Notes                                                                                                                                                                                                                                                                                       |
| ----------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mothership marketplace**                | Active engineering | "Marketplace of liquidity managers": third-party strategists publish strategies, attract user capital, earn fees. The Mothership architecture was designed for this from day one.                                                                                                           |
| **Project Quasar** (lending / IL options) | Research / on hold | Originally pitched as the next product after V3; deprioritized in favor of Mothership and Epsilon Router. Reaffirmed in the [Oct 2025 roadmap](https://medium.com/@alienbase/alien-base-roadmap-plotting-the-next-phase-of-the-invasion-11ede525e2ea) for "2025+" but no shipped artifacts. |
| **Project Nebula** (next-gen AMM)         | Long-term vision   | The original "everything in one AMM" vision: 50× concentrated liquidity, single-sided LP, no forced 50/50 split, instant liquidity for derivatives. No active engineering yet; will follow Mothership maturity.                                                                             |
| **Multi-chain expansion**                 | On hold            | The 2025 B3 deployment was [explicitly classified as not having delivered](https://medium.com/@alienbase/alien-base-roadmap-plotting-the-next-phase-of-the-invasion-11ede525e2ea) in the Oct 2025 retro. The team is now more cautious about high-investment cross-chain partnerships.      |

## What we're not building

A short list of things we've explicitly decided against — not because they don't exist on Earth, but because they don't fit Alien Base's strategy:

* **Yet-another-launchpad** detached from a DEX. Token Generator v2 is integrated with the trading and liquidity stack, not a standalone fundraising venue.
* **Inflationary-only farming as a long-term mechanism.** AIP-5 retired the fixed-halving farming model in favor of POL + buyback-and-burn.
* **A copy-paste perp DEX.** Project Quasar is the leveraged-trading thesis, but only in a form that uses LP capital efficiently (impermanent-loss-as-options) — not as a generic GMX/dYdX clone.

## How decisions get made

Major direction shifts happen via Snapshot proposal in the [`alienbase-dex.eth`](https://snapshot.org/#/alienbase-dex.eth) space. Anyone holding 100,000+ ALB can submit a proposal; see [How to Propose](/governance/how-to-propose). The full history of past votes is on the [AIP Index](/governance/aip-index).

For day-to-day product priorities, the team posts updates on [Discord](https://discord.gg/alienbase) and longer-form articles on [Medium](https://medium.com/@alienbase).


# Changelog

Public, dated record of what shipped on Alien Base

A public, dated record of what shipped on Alien Base, source-cited where possible.

> *Last updated: July 6, 2026.*

## 2026

### July — Trading terminal + Epsilon Router launch

Full app redesign around a professional **trading terminal**: TradingView chart, chain-wide token search, position tracking (Balances / Open orders / Active DCAs / Closed orders / Trades), and a trending ticker — all on [app.alienbase.xyz/swap](https://app.alienbase.xyz/swap).

The **Epsilon Router** ([`0x303c…2580`](https://basescan.org/address/0x303ca5c65AabCb1CE242DF93F478c41E0E4D2580), audited by Hexens) goes live, bringing order execution on-chain and shipping new order types: **Limit / Take Profit / Stop Loss / Stop Buy**, **Trailing Stop**, and upgraded **DCA** with trigger prices and stop-loss aborts. Order fees are tiered by asset class — see [Fees](/reference/fees).

The **Vaults** page is redesigned around named strategies (Wide / Narrow / Ultra Narrow / Classic V3) with three tabs: Vaults, Locked earn (esALB + esLP staking), and Legacy farms. A **Dashboard** page aggregates positions, earnings, and rewards per wallet.

Carbon-powered Limit / Range / Recurring orders are **deprecated** in favor of the Router order system; existing Carbon orders remain visible from the Dashboard and withdrawable on-chain. See [Archive — Carbon Orders](/archive/carbon-orders).

### April — Alien Base 2.0 (AIP-5) approved

[AIP-5](https://medium.com/@alienbase/aip-5-building-alien-base-2-0-96dc24984cd2) passes (Yes 42.63 M / No 0.36 M / abstentions 0.05 M). Replaces farming with a Protocol-Owned-Liquidity (POL) Fund + buyback-and-burn. Replaces fixed halvings with flexible emissions. Introduces Dev Line of Credit, govALB (10× voting, 2-year lock), and a one-time supply-cap raise from 510 M → 1.051 B ALB. Splits governance between the Alien Base DAO (onchain) and Alien Labs (offchain). Onchain rollout begins immediately.

### March — Alien Base 2.0 design preview

Long-form preview article: [Alien Base 2.0 — Building Sustainable Tokenomics for Long-Term Growth](https://medium.com/@alienbase/alien-base-2-0-building-sustainable-tokenomics-for-long-term-growth). Sets the stage for the AIP-5 vote.

### January — Vaults page launches

The Vaults page replaces the legacy Farms tab. Unifies V3 / Bunni positions and esALB / esLP staking. Introduces Zap-in flow for one-click LP creation and a Claim All button across positions.

Mothership repo gets its `audit-scope` commit (see [Audits & Security](/reference/audits-and-security)).

## 2025

### October — Roadmap retrospective

[Alien Base Roadmap: Plotting the Next Phase of the Invasion](https://medium.com/@alienbase/alien-base-roadmap-plotting-the-next-phase-of-the-invasion-11ede525e2ea). Confirms the third halving (June 2025) cut yearly inflation from \~30% to \~15%. Reaffirms Mothership and Project Quasar as the next priorities; explicitly classifies the B3 multi-chain deployment as not having delivered.

### August — Foundation operating budget (ADIP-01)

[ADIP-01](https://snapshot.org/#/alienbase-dex.eth/proposal/0xae936ad8ddb58b90128ff8da95bb6edded6188ba4c87f2ea724d771cfcc17cac) passes — first proposal authored by "Alienbase Foundation (Proposed)". Sets the six-month operating budget (Sept 2025 → Feb 2026): $200k USDC reserve + $42.5k revenue-funded growth + 1M ALB/month dev allowance + 1M ALB/month POL contribution.

Three small community-led proposals also pass in early August: YouTube channel access, Pilot Video Production (Alienbase Academy), and an Academy thread chat channel.

### June — Third halving + AIP-4

Yearly inflation drops from \~30% to \~15% as the third halving fires. [AIP-4](https://snapshot.org/#/alienbase-dex.eth/proposal/0x3e1f7e1841389638f6fda99baefd61331cf711fdc7f4649ad96713c25a747826) passes; community chooses "Prioritize DAO" over "Prioritize holders". Authorizes additional multi-year vested allocations and foreshadows the dev-company structure later formalized as Alien Labs.

`VestingFactory` deployed and team allocations vested through it.

### May — Epsilon Analytics launches

The Explore page goes live. GoPlus-powered safety checks per token. Per-pool charts. Wallet activity views.

### Early year — multi-chain B3 deployment

Alien Base ships on B3 chain (deployment of an isolated V2 fork), announced January 31, 2025 as "our first multi-chain deployment", supporting the B3 token launch of February 10, 2025. The deployment was later flagged as having underperformed expectations and is no longer a strategic focus — see [Archive — B3](/archive/b3).

## 2024

### December — Alien Foundation established

The Cayman-registered ownerless legal entity is set up. See [Alien Foundation](/governance/alien-foundation).

### November — All-time high

ALB hits **$0.572** on November 27, 2024. Lifetime high to date.

### October — AIP-3

[AIP-3](https://snapshot.org/#/alienbase-dex.eth/proposal/0x2f8f7d71af345928b7d0040553aa8f923c21865d2cd0bee226e3a12626b654fc) passes. Establishes the second-halving DAO budget. Dev team transfers 33% of its emissions rights to the DAO (DAO collection rate 15% → 20%). Dev operational allowance raised 600k → 1M ALB/month. By this proposal, >60% of circulating ALB was already locked as esALB.

### September — Second halving

Emissions drop from 7.5 → 3.75 ALB/sec.

### April — esALB launches

[Introducing EsALB](https://medium.com/@alienbase/introducing-esalb-the-next-phase-of-alien-base-tokenomics-e5bfa049486f). Single-staking, governance, Real Yield. Initial reception was strong — esALB became the central long-term holder primitive on Alien Base.

### March 26 — Token Generator

The Token Generator MVP launches (orchestrator [`0xBcE7…d08d`](https://basescan.org/address/0xBcE75497D72b25c3509B62ae1a47CCfb502AD08d) deployed on-chain March 26, 2024). Simple / Mintable / Burnable / Mint+Burn / Tax templates. 0.015 ETH fee per mint.

## 2023

### November — V3 launch + AIP-2

V3 (concentrated liquidity) ships. [AIP-2](https://snapshot.org/#/alienbase-dex.eth/proposal/0xea788bd0daf9fb61acb0199874abc56f9c871cc2e117c3c1c11a45ba1ced7f52) passes (Yes 14.35 M / No 0). Establishes the 50% team / 40% holders / 10% DAO-treasury revenue split. Boosts emissions to 10.5 ALB/sec for two months. Authorizes 2 M ALB for V3 launch incentives. Sets up the DAO Multisig (now 5-of-8 at [`0x4ab9070b…71e5`](https://basescan.org/address/0x4ab9070b7680f802cbf8322e597a4409902171e5)).

### September — Roadmap update

[Strategic Roadmap Update for Alien Base](https://medium.com/@alienbase/strategic-roadmap-update-for-alien-base-c569f2bfcc46). First public projection of where Alien Base would go after the V2 launch.

### August 19 — AIP-1 (de facto)

Sniper bots had captured the launch liquidity, leaving real circulating supply \~1 M instead of the planned 26 M. [The first Snapshot vote](https://snapshot.org/#/alienbase-dex.eth/proposal/0x56c418fd7f7fd365b0beba44389807941e3150fb376179ac758fb497f04a999b) passes (Yes 7,127 / No 15) and emissions drop from 15 → 8 ALB/sec via the 7-day-delayed `updateEmissionRate()` flow.

### August 8 — Token Generation Event

Alien Base launches V2 (Uniswap V2-style AMM) on Base with 26 M ALB initial mint, of which 1 M seeds the launch LP. The remaining 25 M is sent to a timelock for staged release.

The original [Welcome to Alien Base](https://medium.com/@alienbase/welcome-to-alien-base-7ed4dc5da9a3) article is published.

***

## What's not in this changelog

Day-to-day frontend updates (UI tweaks, copy changes, partner-token list updates) and infrastructure work (RPC, indexers, etc.). These are tracked internally and called out in Discord; the changelog is for protocol-level changes worth a long-tail mention.


# RPC Troubleshooting

A detailed guide on how to identify and troubleshoot common RPC issues

#### Introduction

When using the AlienBase platform, you may occasionally encounter issues related to the RPC (Remote Procedure Call) connections. RPC issues can affect transactions, balance updates, and general interaction with the Base Chain. This guide provides steps to help you identify, troubleshoot, and resolve RPC issues.

#### **Step 1: Understand RPC and Its Importance**

RPC serves as the bridge between your wallet and the Base Chain. If the RPC server has issues, it can prevent your wallet from performing operations successfully.

#### **Step 2: Check the Base Chain Status**

First, ensure there are no ongoing issues with the Base Chain itself:

* **Official Status Page**: Visit the [Base Chain Status Page](https://status.base.org/) to check for any service disruptions, maintenance, or updates.

#### **Step 3: Identify and Verify Your RPC Server**

Knowing which RPC server your wallet uses is crucial for diagnosing issues:

* **Find the RPC URL in Your Wallet**: Typically located in the network or settings section of your wallet app.
* **Verify RPC Server**: Compare your RPC URL with the official list on [Chainlist for Base Chain](https://chainlist.org/chain/8453).

#### **Step 4: Change Your RPC Server If Needed**

If you suspect your current RPC server is problematic, you can switch to another:

* **Through Chainlist**: Visit Chainlist, locate Base Chain, and select another RPC server to automatically add to your wallet.
* **Manually Changing RPC in MetaMask**:
  1. Go to MetaMask, select Settings.
  2. Navigate to Networks, select Base Chain.
  3. Input a new RPC URL from the approved list on Chainlist.

#### **Step 5: Inspect Element and Check Console for Errors**

Understanding the specific RPC errors can help in diagnosing the issue:

* **Access Developer Tools**: Right-click on the AlienBase webpage, select "Inspect" (Chrome) or "Inspect Element" (Firefox), then click on the "Console" tab.
* **Look for Errors**: Identify any JSON RPC error messages, such as:
  * `Error: Failed to fetch`
  * `Internal JSON-RPC error.`
  * `net::ERR_CONNECTION_REFUSED`

#### **Step 6: Document and Report the Issue**

If issues persist after switching RPC servers:

* **Take Screenshots**: Capture any error messages or issues.
* **Contact Support**: Send a detailed report to AlienBase support by opening a ticket in the [dedicated Discord channel](https://discord.com/channels/1151515107587792896/1151602990860484618). Include screenshots, the RPC URL used, and a description of the issue for helping the team to identify the problem quickly


# Managing Token Allowance

A detailed guide on how to identify and troubleshoot common issues related to token allowance

#### Introduction

In decentralized finance (DeFi), "allowance" refers to the permission that token holders give to smart contracts to spend tokens on their behalf. Managing allowances properly is crucial for engaging with various features on DeFi platforms, including farming, staking, and swapping tokens.

#### **Step 1: Understanding Allowance**

Before adjusting allowances, it's important to understand why they are necessary:

* **Security Measure**: Allowances limit how much a contract can handle without requiring further authorization, protecting your funds.
* **Functionality**: For certain features like farming or trading on decentralized exchanges, setting the correct allowance ensures these functions work without interruption.

#### **Step 2: Identifying Insufficient Allowance Issues**

If you encounter transaction failures, it might be due to insufficient allowances:

* **Error Messages**: Look for error messages that indicate a failure due to allowance issues, such as "allowance not sufficient".
* **Checking Allowances**: Use blockchain explorers or tools like Basescan to check the current allowance settings for a particular contract.

#### **Step 3: Adjusting Allowance**

Here’s how you can adjust the allowances to ensure proper functionality of your interactions:

**Setting Allowance**:

* **Navigate to the Smart Contract**: Visit [Basescan's Contract Interaction Page](https://basescan.org/token/0x365c6d588e8611125De3bEA5B9280C304FA54113#writeContract).
* **Connect Your Wallet**: Click 'Connect to Web3' to interact with the blockchain.
* **Approve or Modify Allowance**:
  * **Approve New Allowance**:
    * Function: `approveUsage`
    * Parameters:
      * UsageAddress: Address of the contract requiring the allowance (e.g., `0xd3968A4a07d64C6E16982d45191b9A09a261Ec88` for EsMaster).
      * Amount: Desired amount in the smallest token unit (e.g., `1 billion ALB` expressed as `1000000000000000000000000000`).
  * **To Revoke Allowance**:
    * Set the `Amount` parameter to `0` to fully revoke permissions.
* **Confirm Transaction**: Click on 'Write', then confirm the transaction in your wallet.

#### **Step 4: Troubleshooting and Support**

If problems persist after adjusting allowances:

* **Documentation**: Keep records of attempted transactions and error messages.
* **Support**: Contact AlienBase support in the [dedicated Discord channel](https://discord.com/channels/1151515107587792896/1151602990860484618) with detailed information for further assistance.


# Pending or failed transactions

What to do when a transaction is stuck or reverted

> *Last updated: July 6, 2026.*

## My transaction is stuck "Pending"

Base normally confirms transactions in 1–3 seconds. Stuck pending almost always means one of:

1. **Underpriced gas.** Your wallet quoted a base fee from a moment of low demand; demand spiked before your tx was included. Bump priority and resubmit.
2. **Network congestion.** Base sees brief congestion spikes. Usually clears in minutes.
3. **Nonce gap.** A previous tx from your wallet is stuck and yours is queued behind it.

### How to fix a stuck transaction

**Option A — Speed up.** In MetaMask / Rabby / Coinbase Wallet, find the pending tx in your activity → click **Speed up** → confirm. The wallet replaces the original tx with a higher-fee version using the same nonce.

**Option B — Cancel.** Same flow, but use **Cancel**. The wallet submits a 0-value self-transfer at the same nonce, replacing the stuck tx.

**Option C — Manual replacement.** If the wallet's UI doesn't expose Speed up / Cancel:

1. Note the nonce of the stuck tx (Basescan → your address → tx detail).
2. Send a 0-value tx to yourself with that exact nonce and a higher gas price.
3. Once that confirms, the chain advances past the stuck tx.

If you have multiple stuck transactions (e.g., a queue of approvals), you'll need to clear them in nonce order.

## My transaction reverted

A reverted transaction means the EVM evaluated the call and decided it couldn't be executed. You paid gas; nothing else happened.

Common causes by transaction type:

### Swap reverted

* **Slippage exceeded.** Set higher slippage in Settings (most common cause for memecoins or fee-on-transfer tokens). See [Why my swap reverts](/common-issues/why-my-swap-reverts).
* **Insufficient allowance.** Approve the router for the token, then retry. See [Managing Token Allowance](/common-issues/managing-token-allowance-guide).
* **Insufficient balance.** You're trying to spend more than you have, or you don't have enough ETH for gas.
* **Pool liquidity moved.** Quote was based on a price that no longer exists. Retry with a fresh quote.

### Liquidity (LP) tx reverted

* **Slippage on add/remove.** Each LP action has its own slippage tolerance.
* **Out-of-range range parameters.** For V3, the lower price must be below the upper price; both must be on a valid tick spacing.
* **Approval missing for one of the two tokens.**

### Lock / esALB tx reverted

* **Approval missing.** Approve ALB for the EsToken contract, then retry. If approve "succeeded" but Lock still fails, see [Managing Token Allowance](/common-issues/managing-token-allowance-guide) and the [Changing allowance](/alb-and-esalb/escrowed-alb-esalb/changing-allowance) workaround.

### Generic — Basescan tells you why

Open the failed tx on Basescan. The "Revert reason" field often spells out exactly what happened in plain text (e.g., `Pancake: INSUFFICIENT_OUTPUT_AMOUNT`). When asking for help, paste the revert reason and the tx hash.

## I see a transaction I didn't make

If you see an unexplained transaction:

1. Check the `From` address. If it's not yours, you're seeing someone else's tx that touches your address (e.g., an airdrop, or someone sending tokens to you).
2. If `From` is your address and you didn't initiate it, you may have an unrevoked approval being abused. Immediately:
   * Move funds out of that address to a fresh wallet.
   * Revoke approvals on the compromised address using [revoke.cash](https://revoke.cash) or similar.
   * For esALB-specific approvals, see [Changing allowance](/alb-and-esalb/escrowed-alb-esalb/changing-allowance).

## See also

* [RPC Troubleshooting Guide](/common-issues/rpc-troubleshooting-guide)
* [Managing Token Allowance](/common-issues/managing-token-allowance-guide)
* [Why my swap reverts](/common-issues/why-my-swap-reverts)
* [Changing allowance (esALB-specific)](/alb-and-esalb/escrowed-alb-esalb/changing-allowance)


# Why my swap reverts

A focused guide to the four most common swap-revert causes

If your swap reverts (= the transaction goes through but the swap doesn't happen, and you pay gas), one of four things is almost always responsible. Walk through them in order.

> *Last updated: July 6, 2026.*

## 1. Slippage too low

By far the most common cause.

**What happened.** You set slippage at, say, 0.5%. Between the moment Alien Base quoted your trade and the moment the chain executed it, price moved more than 0.5%. The swap has a built-in safety check that aborts if price moves more than your tolerance — so it reverted.

**Fix.** Raise slippage in the swap UI Settings (gear icon).

| Pair type                    | Suggested slippage |
| ---------------------------- | ------------------ |
| Stablecoin / blue chip       | 0.1–0.5%           |
| Standard alts                | 0.5–1%             |
| Volatile / low liquidity     | 2–5%               |
| Memecoins with on-trade fees | 5–15%              |

**Don't go higher than you need.** Excessive slippage exposes you to MEV sandwich attacks. Find the lowest value that lets the trade execute reliably for the pair you're trading.

## 2. Token has a transfer fee (fee-on-transfer)

Many memecoin templates take a fee on every transfer. The fee silently reduces what arrives at the destination.

**What happened.** Alien Base quoted "you'll receive 1,000 TOKEN" but TOKEN takes a 5% transfer fee, so only 950 actually arrived — below your slippage threshold. Revert.

**Fix.** Increase slippage to cover the on-transfer fee plus a buffer. For a 5% fee, a slippage of 6–7% is typically enough.

The Alien Base swap UI shows a warning when it detects a known fee-on-transfer token, but it can't always detect them. If the contract is unfamiliar, check Basescan for `_taxFee` / `_buyFee` / `_sellFee` style state variables.

## 3. Insufficient allowance

**What happened.** You approved a router previously for some amount, but the current swap exceeds that approved amount. Or the approval transaction itself never landed.

**Fix.** Re-approve the router for the token (the swap UI will prompt you with an Approve button if it detects the issue). If your approve transaction succeeded but the swap still fails:

* For ALB → esALB specifically, see [Changing allowance](/alb-and-esalb/escrowed-alb-esalb/changing-allowance).
* For general allowance issues, see [Managing Token Allowance](/common-issues/managing-token-allowance-guide).

## 4. Liquidity moved between quote and execution

**What happened.** The pool you were going to swap against had its liquidity removed, or its price moved into a zone where the swap is no longer possible at your quote, between when the quote was computed and when the chain executed your tx.

**Fix.**

* Refresh the quote and try again.
* If the same pool keeps reverting, swap in a different size — sometimes a smaller amount can route through alternative pools.

## Other less-common causes

* **Insufficient ETH for gas.** You can't pay gas without ETH on Base. Bridge or buy \~$1 worth.
* **Insufficient balance.** Self-explanatory; double-check.
* **Wrong network.** You may be on Ethereum mainnet by mistake. The Alien Base UI will warn if so.
* **Deadline expired.** Some transactions have a deadline parameter; if your tx was pending in the mempool too long, the deadline can pass. Speed-up via the wallet, or just resubmit.

## How to read the actual revert reason

Open the failed tx on [Basescan](https://basescan.org/). The "Revert reason" field is usually populated. Common messages:

* `INSUFFICIENT_OUTPUT_AMOUNT` → slippage / fee-on-transfer (#1 or #2 above).
* `TRANSFER_FROM_FAILED` → allowance (#3) or fee-on-transfer behavior.
* `EXPIRED` → deadline passed.
* `UniswapV3: SPL` → V3 pool sub-tick computation issue, almost always slippage-adjacent on a low-liquidity pool.

If you can't figure it out, post the tx hash in [Discord](https://discord.gg/alienbase) and someone will look at it.


# My LP is out of range

What to do when your V3 / Bunni position drifts outside its range

Concentrated-liquidity positions only earn fees while the market price is **inside** the price range you (or the Vault) configured. When price exits the range, the position holds 100% of one asset and earns nothing until either price returns or you reposition.

This is normal and expected — concentrated liquidity is a trade-off — but it has a few wrinkles worth knowing.

> *Last updated: July 6, 2026.*

## How to tell

On the [Vaults](https://app.alienbase.xyz/vaults) or Liquidity page, an out-of-range position is flagged:

* **🟡 Out of range** badge on the position card.
* The asset breakdown shows \~100% of one token, \~0% of the other.
* The "Fees earned in last 24h" stat is \~0.

## What's actually happening

Imagine you set an ETH/USDC range from $2,800 to $3,200, and the market is at $3,000.

* While ETH is between $2,800 and $3,200, your position swings between holding more USDC (when price is high) and more ETH (when price is low). It earns fees on every trade in your range.
* If ETH moves to $3,500 (above your range), your position is 100% USDC. You "sold" your ETH on the way up, at progressively better prices, and now you're holding USDC. You earn no fees until ETH comes back to $3,200.
* If ETH moves to $2,500 (below your range), your position is 100% ETH. You "bought" ETH on the way down, at progressively better prices. No fees until ETH comes back to $2,800.

Importantly: this isn't a "loss" in the sense of money disappearing. You hold the same total value as a passive holder, minus impermanent-loss-style asymmetry — sometimes more, sometimes less, depending on price path. What you've lost is the **opportunity** of earning fees.

## Your three options

### 1. Wait for price to come back

If the price excursion is small and short-lived (the asset drifts a bit out of range, then mean-reverts), waiting is fine. You re-engage when price returns to your range.

### 2. Withdraw and re-deposit at a new range

For raw V3 positions: remove liquidity, swap to balance, redeposit at a fresh range. Two transactions plus the gas to swap. Expensive on Ethereum; tractable on Base.

For Bunni Vaults: most Vaults have a fixed range. If a particular Vault is consistently out of range, the protocol typically deploys a new Vault with refreshed bounds — migrate to it.

### 3. Let an active manager handle it

[Mothership](/liquidity/mothership) is exactly this — an automated liquidity manager that re-balances ranges as price moves. Once Mothership goes live, deposit there instead of into a static-range Vault.

## When to choose what

* **Stable / LSD pairs (USDC/USDT, ETH/cbETH).** Out of range is rare. Static ranges work fine.
* **Blue chip pairs (ETH/USDC, BTC/ETH).** Wide static ranges work fine; expect occasional repositioning during big moves.
* **Mid-cap / volatile.** Static ranges are high-effort. Wait for Mothership, or use V2 instead (full-range, no range management).
* **Memecoins.** Concentrated liquidity is mostly the wrong tool. Use V2.

## The math behind it

Capital efficiency in V3 scales roughly with how narrow your range is, but so does your risk of being out of range. A range that captures a 2× price move is much more capital-efficient than full-range — but if price moves 3×, you're stuck on one side.

Two practical heuristics:

* **Volatility-based range.** Set the range to \~2× the recent annualized volatility on either side of the current price. Lets price swing within a normal volatility window without exiting.
* **Time-based range.** Set the range to capture the price band you expect over the holding period. Wider for longer holds.

Neither is perfect. The honest answer is: predicting price ranges is hard, which is why ALMs (Mothership) exist.

## See also

* [Concentrated Liquidity (V3)](/liquidity/v3)
* [Vaults overview](/liquidity/vaults)
* [Bunni explainer](/liquidity/bunni)
* [Mothership](/liquidity/mothership) — the active-management answer.
* [V2 Pools (legacy)](/liquidity/v2-pools) — when concentrated liquidity is the wrong tool.


# Archive overview

Products and initiatives that are no longer active

This section documents Alien Base products and initiatives that are **no longer active**. Each page is preserved for historical context, contract verification, and to direct anyone with stranded funds to the relevant recovery / withdrawal path.

> *Last updated: July 6, 2026.*

## What's in here

| Item                                                                | Status                                            | Last active |
| ------------------------------------------------------------------- | ------------------------------------------------- | ----------- |
| [Carbon Orders (Limit / Range / Recurring)](/archive/carbon-orders) | Deprecated — replaced by Epsilon Router orders    | July 2026   |
| [Area 51](/archive/area-51)                                         | Deprecated                                        | 2024        |
| [StableSwap](/archive/stableswap)                                   | Deprecated                                        | —           |
| [B3 multi-chain](/archive/b3)                                       | Shelved (under-delivered, not strategic priority) | 2025        |
| [Predictions](/archive/predictions)                                 | Discontinued                                      | —           |
| [Lottery](/archive/lottery)                                         | Discontinued                                      | —           |

## A note on archival policy

A product lands here when:

* It's no longer maintained or featured in the dApp's primary surfaces.
* The team has explicitly decided not to continue developing it.
* Its functionality is fully superseded by another product, or the use case no longer makes business sense.

Archived products may still have on-chain state (active LPs, locked funds, open positions). Each page includes the **withdrawal / recovery instructions** for users who still have something there.

We don't take down archive pages. They stay as a public record of what shipped and why it didn't continue.


# Carbon Orders (deprecated)

Deprecated: Carbon-powered Limit, Range, and Recurring orders

> **Status: deprecated (July 2026).** Replaced by the [Epsilon Router](/trading/epsilon#the-epsilon-router) order system — Limit, Take Profit, Stop Loss, Trailing Stop, and DCA. Existing Carbon orders remain visible from your Dashboard and stay withdrawable on-chain.

> *Last updated: July 6, 2026.*

## What it was

From 2024 to mid-2026, Alien Base's resting orders were powered by Bancor's **Carbon DeFi** technology — Alien Base was the first DEX to integrate Carbon directly. The suite included:

* **Limit Orders** — one-time orders at a single price.
* **Range Orders** — one-time orders distributed across a price range, filling incrementally.
* **Recurring Orders** — paired buy + sell sub-orders that rotated automatically, like an on-chain grid-trading bot. Proceeds from a filled side rotated into the other side until withdrawn.

Carbon orders behaved like irreversible on-chain market-maker positions: the user was a **maker** defining a spread, and takers (aggregators, arbitrageurs) filled against them. They were MEV-resistant by construction — the order's irreversibility prevented sandwich attacks at fill time — and charged a 0.40% Alien Base fee on executed trades.

## Why it was deprecated

The Epsilon Router brought order execution in-house and unlocked order types Carbon couldn't express (trailing stops, stop-loss DCA, trigger-price DCA), with execution routed through Epsilon's meta-aggregation for best price at fill time. Running two parallel order systems added surface area without adding capability, so Carbon order creation was retired with the July 2026 trading terminal upgrade.

The trade-off: Epsilon Router orders are executed by the Matcher at market route (with slippage tolerance), whereas Carbon fills were zero-slippage maker fills. Users who specifically want maker-style, spread-capturing strategies can still provide concentrated liquidity via [Vaults](/liquidity/vaults).

## If you still have open Carbon orders

* Open orders remain visible in your **Dashboard**.
* Funds stay in the CarbonController contract ([`0xe376…716e`](https://basescan.org/address/0xe3763886bf91d5466b416b37fdf2b6337897716e)) — non-custodial, withdrawable at any time.
* A legacy interface for managing (or creating) Carbon orders may be made available; check the Discord announcements.

## See also

* [Limit, Take Profit & Stop Loss](/trading/limit-orders) — the replacement for Limit / Range orders.
* [DCA Orders](/trading/dca-orders) + [Trailing Stop](/trading/trailing-stop) — the replacement for automation strategies.
* [Contracts](/reference/contracts) — CarbonController address.


# Area 51 (deprecated)

Deprecated isolated-fee-tier DEX

**Status:** deprecated. Liquidity was migrated and the product was removed from the main UI in 2024.

> *Last updated: July 6, 2026.*

## What it was

Area 51 was an isolated, separately-deployed fork of Alien Base's V2 contracts — a standalone DEX with its own factory, router, and farm, built to host higher-fee or experimental pools without touching the main V2 deployment.

The original docs framed Area 51 as an "experimental fee-tier sandbox," which it largely was. It had limited adoption and was eventually phased out as Alien Base V3 (concentrated liquidity, configurable fee tiers natively) made an isolated experimental DEX redundant.

## The "Area 51" name today

Area 51 has been **rebranded internally** as the umbrella name for Alien Base's developer-tooling suite — the [Token Generator](/builders/token-generator) is part of this suite. So "Area 51" in current Alien Base communication usually refers to the dev tools, not the deprecated DEX.

## Contracts (historical)

For verification purposes — these contracts are still on-chain but no longer surfaced in the dApp:

* **Factory:** [`0xa0F4f3b13f5eE9b56cca59cB4F7CDd0b40fE9c50`](https://basescan.org/address/0xa0F4f3b13f5eE9b56cca59cB4F7CDd0b40fE9c50)
* **Router:** [`0xfa1AcA9d83fc6B4d6BCAC56de1ECd1c5b83AC110`](https://basescan.org/address/0xfa1AcA9d83fc6B4d6BCAC56de1ECd1c5b83AC110)
* **Farm:** see [Contracts — Deprecated section](/reference/contracts)

> Note: a previous version of these docs listed a different address for the Area 51 Router. Community PR #9 (UserIzanagi) flagged the mismatch; the address above is the verified one.

The Area 51 Factory `feeToSetter` is still controlled by a single team EOA (`0xa670…0166`) and was not migrated to the DAO Multisig before deprecation. As the contracts are no longer the venue of any meaningful activity, this is treated as low priority.

## If you have funds in Area 51

The contracts remain on-chain and remain functional. To withdraw:

1. Note your LP token address from the [Area 51 Factory's pairs](https://basescan.org/address/0xa0F4f3b13f5eE9b56cca59cB4F7CDd0b40fE9c50).
2. Call `removeLiquidity(...)` on the Area 51 Router directly via Basescan's "Write Contract" tab.
3. Or, if your LP is staked in the Area 51 Farm: `withdraw(pid, amount)` first, then remove liquidity.

If you can't figure it out, post in [Discord](https://discord.gg/alienbase) — the team can help walk through it.

## See also

* [Contracts — Deprecated section](/reference/contracts)
* [Token Generator](/builders/token-generator) — the current "Area 51" suite.


# StableSwap (deprecated)

Deprecated Saddle-style stableswap pools

**Status:** deprecated. No longer surfaced in the dApp's primary UI.

> *Last updated: July 6, 2026.*

## What it was

StableSwap was Alien Base's deployment of Saddle-style (Curve-derived) stablecoin AMM pools, listed as a separate protocol on DefiLlama. It was designed for low-slippage swaps between same-asset variants (e.g., stablecoin↔stablecoin, ETH↔cbETH, BTC↔cbBTC).

It launched as one of several attempts to specialize liquidity for tightly-pegged assets without forcing them through a generic V2 or V3 pool. In practice, it never gained meaningful TVL — Alien Base V3 supports dedicated low fee tiers (0.01% / 0.02% for stables, 0.03% / 0.04% for LSDs and very-blue-chip volatile pairs, 0.075% for ETH/BTC) which serve the same use case more efficiently and with better composability.

## Why it was deprecated

* TVL never grew to a level that justified maintenance overhead.
* V3 with the 0.01% / 0.02% / 0.03% / 0.04% / 0.075% fee tiers handles the same pairs more efficiently.
* DefiLlama still lists "Alien Base StableSwap" as a separate protocol entry, but the pools have minimal current activity and aren't featured in Alien Base's UI.

## Contracts

The Saddle-style `SwapFlashLoan` pool contract is at [`0x927860…bb27`](https://basescan.org/address/0x927860797d8CC9b94e3FdC6F1a4a3C42aDfFbb27) — see the [Contracts — Deprecated section](/reference/contracts#deprecated--historical).

## If you have funds in StableSwap

Pools remain on-chain and remain functional. To withdraw:

1. Identify the specific StableSwap pool you deposited into.
2. Call `removeLiquidity(...)` (or `remove_liquidity_one_coin` for single-asset withdrawal in Saddle-style pools) on the pool contract directly via Basescan.
3. If your LP is staked, `withdraw(...)` from the gauge / farm first.

If you can't figure it out, post in [Discord](https://discord.gg/alienbase) — the team can walk you through it.

## See also

* [Contracts — Deprecated section](/reference/contracts)
* [V3 — fee tiers](/liquidity/v3#fee-tiers) — the active replacement for stable / LSD pools.


# B3 multi-chain (shelved)

Multi-chain B3 deployment — under-delivered, no longer a strategic focus

**Status:** shelved. The B3 chain deployment did not deliver expected results and is no longer a strategic priority.

> *Last updated: July 6, 2026.*

## What it was

In early 2025, Alien Base deployed a fork of its V2 contracts on the [B3 chain](https://b3.fun/) (an L3 / app-chain in the Base ecosystem focused on gaming). It was framed as a multi-chain expansion play — replicate the Alien Base UX on a new chain that didn't yet have a strong DEX presence.

## What happened

The deployment shipped, but the chain itself was never fully launched. The team's [October 2025 roadmap retrospective](https://medium.com/@alienbase/alien-base-roadmap-plotting-the-next-phase-of-the-invasion-11ede525e2ea) explicitly classifies B3 among the items that "did not deliver." The takeaway, in the team's words: high-investment cross-chain partnerships need a much higher bar of evidence before being undertaken again.

## Implications for current strategy

* The team is not actively planning new multi-chain expansions.
* Future cross-chain footprints, if any, would likely come via aggregators / bridges integrating Alien Base — not via direct deployments.
* Effort that would have gone to multi-chain is now concentrated on the Base-native product depth: Mothership, Epsilon Router, Token Generator v2.

## See also

* [Roadmap](/roadmap) — current strategic focus.
* [Alien Base 2025: Launching The Full Scale Invasion](https://medium.com/@alienbase/alien-base-2025-launching-the-full-scale-invasion-99d50163a5ed) — the original 2025 expansion announcement.
* [Alien Base Roadmap: Plotting the Next Phase of the Invasion](https://medium.com/@alienbase/alien-base-roadmap-plotting-the-next-phase-of-the-invasion-11ede525e2ea) — the October 2025 retrospective that flagged B3 as under-delivered.


# Predictions (discontinued)

Discontinued price-prediction game

**Status:** discontinued. No longer offered.

> *Last updated: July 6, 2026.*

## What it was

A short-window price-prediction game inspired by PancakeSwap's Predictions feature. Users would bet ETH (or another asset) on whether the price of an asset would be higher or lower at the end of a fixed round (typically 5 minutes). Winners shared the round's pot pro-rata.

It was a fun engagement product but not a core part of Alien Base's value proposition. Maintenance and game-balance overhead exceeded the activity it generated, and the team chose to wind it down to focus on the trading and liquidity products.

## Contracts

The `PredictionETH` contract, deployed by the AlienBase Deployer, is at [`0xFBE87Ee1…63e8`](https://basescan.org/address/0xFBE87Ee1Ee62244A2dF80a8093Eab829C52863e8) (verified source). Even though the game is no longer surfaced in the dApp, you can verify the contract and claim any unclaimed winnings directly from the explorer's Write tab.

## If you have unclaimed winnings

If you participated and never claimed:

1. Find your address's Predictions transactions on Basescan.
2. Call `claim(...)` on the deployed Predictions contract directly.

If you need help, post in [Discord](https://discord.gg/alienbase).

## See also

* [Lottery (discontinued)](/archive/lottery) — the other engagement-focused product that was sunset.
* [Roadmap](/roadmap) — what the team is building instead.


# Lottery (discontinued)

Discontinued on-chain lottery

**Status:** discontinued. No longer offered.

> *Last updated: July 6, 2026.*

## What it was

A periodic on-chain lottery where users bought tickets in ALB and a randomized draw distributed the pot to winners. The product borrowed from PancakeSwap's lottery design and aimed to drive engagement and ALB demand.

Like Predictions, it was an engagement product rather than a core trading or liquidity feature. The team deprecated it to focus operational bandwidth on Mothership, Epsilon Router, and the Alien Base 2.0 rollout.

## Contracts

The `AlienbaseLottery` contract, deployed by the AlienBase Deployer, is at [`0x4384DCF9…48Ff`](https://basescan.org/address/0x4384DCF974769F2E0E52cdE92b6D5fC9be5248Ff) (verified source). If you have unclaimed positions, you can call the contract's claim functions directly from the explorer's Write tab.

## If you have unclaimed tickets / winnings

If you participated and never redeemed:

1. Find your address's Lottery-related transactions on Basescan.
2. Call the appropriate `claim` function on the Lottery contract.

If you need help, post in [Discord](https://discord.gg/alienbase).

## See also

* [Predictions (discontinued)](/archive/predictions)
* [Roadmap](/roadmap)


