How it works Why WhaleHub Stellar-native About FAQ Contact Docs Launch app
Help center

Frequently asked questions

Everything about WhaleHub — BLUB, how the yield is earned, security and custody, staking, vaults, ICE governance, and troubleshooting.

Last updated April 2026. If your question isn't here, ask in Telegram and we'll add it.

No questions match your search. Try different words, or ask in Telegram.

The basics

What is WhaleHub?

WhaleHub is a yield optimization protocol on Stellar. You deposit AQUA, the protocol pools it with every other depositor's AQUA, and that combined position is used to earn the highest possible returns from the Aquarius liquidity network. Everything runs on Soroban smart contracts on Stellar mainnet.

The simplest real-world analogy is a professionally managed investment fund. You hand over capital, the fund deploys it across strategies most individuals can't efficiently access on their own, and you earn a share of the results. The difference here is that it's fully on-chain, non-custodial, and verifiable in real time.

Crypto-native analogy: WhaleHub is to Stellar what Convex is to Ethereum's Curve ecosystem. Same pattern, same purpose.

Who is WhaleHub for?

Anyone holding AQUA who wants meaningful yield without doing the manual work themselves. Managing a competitive AQUA position yourself means locking tokens for up to 3 years, voting every epoch, tracking bribe markets, and re-locking as ICE decays. WhaleHub does all of that for you at scale.

If you'd rather spend zero hours on your AQUA position and still earn an amplified rate, you're the target user.

Is WhaleHub live?

Yes. The staking contract has been through multiple on-chain upgrades. The protocol is actively managing an ICE position, voting every epoch, and auto-compounding rewards to stakers 24 times a day.

How do I start?
  1. Open app.whalehub.io
  2. Connect your wallet (Freighter, LOBSTR, or WalletConnect)
  3. Deposit AQUA
  4. Receive BLUB 1:1
  5. Stake BLUB to earn yield, or hold it liquid

The protocol handles everything after the deposit: ICE locking, voting, reward claiming, and compounding.

Is there a minimum deposit?

No hard minimum on the protocol side. Stellar has a small XLM reserve requirement per trustline (roughly 0.5 XLM per asset), so you'll want enough XLM in your wallet to cover network reserves plus transaction fees.

What does WhaleHub cost?

Two fee tiers depending on what you do with your AQUA:

  • Stake BLUB to earn POL yield: 70% to stakers, 30% to the protocol treasury.
  • Deposit into Vaults: 85% auto-compounded back into your LP position, 15% to treasury.

The treasury share is reinvested to grow the ICE position and buy BLUB from the open market. Both ultimately benefit users: a bigger ICE position means a larger share of future rewards, and treasury buys create ongoing demand for BLUB. There are no separate deposit fees, withdrawal fees, or subscription fees.

The BLUB token

What is BLUB?

BLUB is WhaleHub's liquid staking token. When you deposit AQUA, you receive BLUB at a 1:1 ratio. BLUB represents your share of the protocol's yield-generating position.

Closest precedents: stETH (Lido) on Ethereum, rETH (Rocket Pool), cvxCRV (Convex). Liquid staking tokens that you can hold, trade, or stake elsewhere while the underlying position does the work.

What's the difference between holding AQUA and holding BLUB?

AQUA on its own earns nothing unless you personally lock it into ICE, vote every epoch, and manually claim rewards. BLUB is AQUA already put to work. Holding BLUB gives you access to the pooled yield WhaleHub generates without any manual management on your part.

Why 1:1? Does the exchange rate drift?

BLUB mints 1:1 when you deposit AQUA, and that ratio stays fixed. Yield is distributed to stakers separately rather than accumulating inside the token's redemption value. This is a design choice: it keeps BLUB straightforward to account for, trade, and integrate elsewhere.

Can I redeem BLUB back for AQUA at 1:1?

No. 90% of the AQUA you deposit is committed to ICE governance to generate the yield. There's no native redemption path, and that's by design.

This is how every productive liquid staking token works. You can't directly redeem cvxCRV for CRV — the underlying CRV is vote-locked forever. The exit is always the open market.

For BLUB, you exit via the AQUA/BLUB pool on Aquarius AMM, or via LOBSTR, or via Stellar's DEX. The peg holds because of three things working together: protocol-owned liquidity, constant treasury buying pressure, and real yield that makes BLUB worth accumulating.

What if BLUB trades below AQUA on the market?

Three mechanisms push the peg back toward 1:1:

  1. Protocol-owned liquidity in the AQUA/BLUB pool provides deep, permanent backstop liquidity. This liquidity is never pulled.
  2. Treasury earnings (30% of all earned AQUA) are used to buy BLUB from the open market, creating a constant bid.
  3. Real staking yield makes BLUB an accumulating asset, not a pass-through. Holders are incentivized to stake and earn rather than dump.
Is BLUB the same whether I staked AQUA or bought it on the market?

Yes, identical. BLUB is fully fungible. Whether you acquired it by depositing AQUA or by buying it on the DEX, you can stake it, earn yield, and exit the same way. There is no second class of BLUB.

Can I hold BLUB without staking?

Yes. Unstaked BLUB is fully liquid. You can trade it, transfer it, or hold it. Yield only accrues to BLUB that's actively staked in the WhaleHub staking contract.

How yield works

Where does the yield actually come from?

Three real sources, all earned from actual protocol activity:

  1. ICE voting rewards. The protocol's ICE position earns AQUA rewards every epoch for directing votes to liquidity pools. Because we lock at maximum duration, we get the full 10x voting multiplier, meaning our share of the reward pool is outsized relative to our AQUA position.
  2. Bribe revenue. Projects that want their pools to rank higher in the Aquarius reward zone pay bribes to ICE holders. WhaleHub aggregates these bribes and routes the proceeds to stakers.
  3. Protocol-owned liquidity. The 10% of every deposit that enters the AQUA/BLUB pool earns swap fees and additional AQUA rewards.

No token emissions. No inflationary printing. Yield is earned, not manufactured.

How often is yield distributed?

Auto-compounding runs 24 times per day, every hour. You don't need to claim, restake, or do anything manually. Rewards get reinvested into your position before you'd even notice they arrived, which is why the effective (compounded) APY is meaningfully higher than the base APY.

How is the yield split?

Stakers receive 70% of POL yield (30% to treasury). Vault depositors receive 85% auto-compounded (15% to treasury).

Is the APY guaranteed?

No. APY is a function of total ICE in circulation, voting participation, bribe market health, and pool performance. It moves with market conditions. We publish live APY figures in the app rather than promising fixed rates, because honest DeFi yield is variable yield.

Why is the effective APY higher than the base APY?

Compounding frequency. A rate that compounds 24 times a day produces materially higher returns over a year than the same rate claimed once a month. WhaleHub's automation captures this compounding advantage for every staker, regardless of position size. A solo staker would have to pay gas to claim and redeploy that often, which would eat the benefit. The pooled model makes it economical for everyone.

Is WhaleHub's yield sustainable?

Yes. It comes from real economic activity: governance reward distributions, bribe market payments, and trading fees. None of it is emissions-based or dependent on new deposits to pay old ones.

Security, custody & risk

Is WhaleHub custodial?

No. WhaleHub is fully non-custodial. Every user deposit lives in a Soroban smart contract on Stellar mainnet. You can verify the contract address and balances on stellar.expert at any time. No team member can unilaterally move user funds.

Who controls the contract?

The contract uses a split admin/manager multisig architecture. Critical operations (upgrades, parameter changes) require multiple signatures. No single key can change core logic, drain funds, or pause the protocol unilaterally.

What are the main risks?

Honest list, in order of priority:

  1. Smart contract risk. The code has been in production through multiple upgrade cycles, but all smart contracts carry residual risk.
  2. Aquarius dependency. Yield depends on Aquarius continuing to operate, distribute rewards, and maintain reward zone mechanics.
  3. Peg risk. BLUB's market price can deviate from AQUA in stressed market conditions, though POL and treasury buying work to stabilize it.
  4. AQUA token risk. BLUB's underlying value is tied to AQUA. If AQUA's price or utility collapses, BLUB tracks down with it.
  5. Soroban ecosystem risk. As a newer smart contract platform, Soroban carries some platform-level maturity risk compared to more battle-tested environments.

If anyone is telling you a DeFi protocol has no risk, they're either lying or confused. We list these up front because that's how responsible DeFi operates.

Is my wallet safe?

WhaleHub never asks for your private keys or seed phrase. The app only requests transaction signatures through your wallet extension. Anyone asking for your seed phrase is a scammer, full stop.

Is my data private?

On-chain activity on Stellar is public, like every public blockchain. WhaleHub doesn't collect off-chain identifying data beyond what's needed for the app to function. We don't sell user data, we don't track off-chain behavior, we don't run analytics on individual wallets.

Staking & unstaking

How do I stake BLUB?

In the app, go to the staking section, enter the amount, and confirm the transaction in your wallet. Staked BLUB starts earning yield immediately.

What's the minimum lock period after staking?

7 days from the time of staking. Before 7 days elapse, you can't begin the unstake process.

How do I unstake?

After the 7-day minimum has elapsed, initiate an unstake in the app. There's then a 10-day cooldown before the tokens become withdrawable. Once the cooldown completes, you claim your BLUB back to your wallet.

Why is there a cooldown at all?

90% of your deposit's economic backing sits in ICE locks at maximum duration. The protocol needs predictability in how much BLUB is committed versus preparing to exit, so the cooldown prevents mass exits from destabilizing pool dynamics and voting positioning.

Real-world analogy: a notice-period savings account. You agree to give notice before withdrawing so the institution can manage liquidity on their side. The yield compensation is higher than an instant-access account because of that predictability.

Can I sell BLUB immediately without waiting for the unstake cooldown?

Yes. If you haven't staked, BLUB is fully liquid. You can trade it on the AQUA/BLUB pool or via LOBSTR at any time. The cooldown only applies when you're exiting a staked position. If you need immediate liquidity, the market path is always open.

How often can I claim rewards?

There's a 7-day cooldown between reward claims and a cap of 100K BLUB per claim call. For typical position sizes, this is invisible. Very large positions may spread claims across multiple transactions.

Can I stake more BLUB on top of an existing position?

Yes. Additional stakes add to your position without resetting any existing timers on already-staked tokens. Each stake has its own 7-day minimum lock from the time it was added.

Vaults & liquidity

What is a vault?

A vault is WhaleHub's auto-compounding liquidity wrapper. You deposit a token pair into an Aquarius AMM pool through WhaleHub, and instead of earning static fees and rewards that sit unclaimed, the vault automatically harvests and reinvests those earnings 24 times every day — every hour, around the clock.

The underlying pool is on Aquarius. The difference is everything that happens after your initial deposit: claiming, swapping, and redepositing runs automatically without you doing anything or paying gas.

What vaults are currently available?

Currently one vault: BLUB–AQUA (StableSwap pool). More vaults are coming soon — additional Stellar AMM pairs are actively being evaluated and will be added as the protocol expands.

What's the difference between staking BLUB and depositing into the AQUA/BLUB vault?

Two separate products with different mechanics and risk profiles:

BLUB Staking: You deposit BLUB into the staking contract. You earn yield from ICE rewards, bribes, and POL fees. No impermanent loss exposure. Your principal is denominated in BLUB.

AQUA/BLUB Vault: You deposit into the AMM pool. You earn swap fees plus AQUA pool rewards, auto-compounded 24x daily. This is LP exposure, so it carries impermanent loss dynamics.

Staking is simpler with no LP exposure. Vault LPing typically produces higher headline yield in exchange for carrying pool dynamics.

Why use WhaleHub vaults instead of providing liquidity directly on Aquarius?

Two layers: compounding mechanics and structural advantages.

Compounding math. The base APY shown on Aquarius represents what you'd earn if you claimed rewards once at the end of the year. WhaleHub reinvests those rewards 24 times per day. The same pool, the same rewards — but the reinvestment frequency multiplies your effective return significantly:

  • 20% base APY → 22.1% with WhaleHub (manual)
  • 50% base APY → 64.8% with WhaleHub vs 50% manual (+14.8%)
  • 100% base APY → 171.5% with WhaleHub vs 100% manual (+71.5%)
  • 150% base APY → 348.3% with WhaleHub vs 150% manual (+198.3%)

The gap widens dramatically as base rates increase. On high-APY pools, WhaleHub can more than double the effective return compared to leaving rewards unclaimed.

Why you can't just compound manually. Each compound cycle is 3-4 Stellar transactions: claim, swap, deposit. Doing this 24 times per day would cost real transaction fees and your time. WhaleHub's pooled model makes it economical for every depositor regardless of size, because the cost is shared across all vault participants.

Structural advantages:

  • Rewards don't sit unclaimed between manual sessions — they're reinvested every hour, every day, including nights and weekends.
  • Single-asset entry supported: deposit just AQUA or just BLUB and the vault handles the internal swap.
  • No operational overhead: no monitoring, no timing, no multi-step manual transactions.
  • Even after the 30% protocol fee, the compounding advantage puts you materially ahead of manual LP on active pools.
The compounding formula, if you want the math
Compounded APY = (1 + base_rate / 17,520)17,520 − 1

Where 17,520 = 48 compounds per day × 365 days.

Example: A 100% base APY pool: (1 + 1.0 / 17,520)17,520 − 1 = 1.715 = 171.5%.

That extra 71.5% is not from a higher base rate. It's purely from reinvestment frequency. Same pool, same rewards, same market — only the compounding frequency changes.

What is impermanent loss?

When you provide liquidity to a pool, your position rebalances as the two asset prices diverge. If AQUA moves significantly against BLUB, your pool position can end up worth less than if you'd held both tokens separately. This is impermanent loss — standard LP risk across all AMMs, including WhaleHub vaults.

Real-world analogy: LPing is like being a market maker on a currency pair. You profit from trading volume (fees) but bear the risk that the exchange rate moves against your inventory.

How is impermanent loss offset?

Swap fees and AQUA rewards flow continuously to LPs. For pairs with healthy trading volume and reward distribution, fee and reward income typically more than covers impermanent loss over reasonable time horizons. That said, impermanent loss can still outweigh earnings in extreme divergence scenarios. Know the risk before you deposit.

Can I deposit into the vault with just AQUA or just BLUB?

Yes. Single-sided deposits are supported. The protocol handles the internal swap to balance the pair.

Is there a lock period on vaults?

No. Vault deposits can be withdrawn at any time with no withdrawal fee and no cooldown. You receive both tokens in the current pool ratio.

Does my direct aqua.network LP position show up in the WhaleHub app?

No. The app only shows positions held inside WhaleHub contracts. If you want to move existing LP into the WhaleHub vault, withdraw from aqua.network first, then deposit via the WhaleHub app.

ICE, voting & governance

What is ICE?

ICE is Aquarius's governance token. You acquire ICE by locking AQUA, with more ICE granted for longer locks. ICE is used to vote on which liquidity pools earn AQUA rewards each epoch, and voting power scales with your ICE holdings.

Why does lock duration matter?

Longer locks produce more ICE per AQUA locked. A 5-year lock (the maximum on Aquarius) gives the full 10x voting multiplier. Short locks produce proportionally less ICE. WhaleHub locks at maximum duration every time, which is the entire reason our voting weight is disproportionately large for the AQUA we hold.

Does ICE ever unlock?

ICE decays over time. As the unlock date approaches, the ICE boost degrades. WhaleHub re-locks before decay matters, maintaining maximum-duration positions on a continuous basis. From the protocol's perspective, the AQUA is effectively committed indefinitely, always at peak boost.

Does WhaleHub vote responsibly?

Votes are directed to support the AQUA/BLUB pool's place in the reward zone. This is directly aligned with staker interests: more rewards flowing to the AQUA/BLUB pool means more AQUA earned by the protocol, which means more yield distributed to BLUB stakers.

Can WhaleHub vote against my interests?

The protocol's economic structure makes misaligned voting self-defeating. Voting for anything other than AQUA/BLUB pool support would reduce WhaleHub's own revenue and stakers' yield. The incentives are tightly aligned with staker outcomes by design.

Technical details

What smart contract platform does WhaleHub use?

Soroban, Stellar's Rust-based smart contract runtime. Contracts compile to WASM and run natively on Stellar mainnet. The staking contract has been through multiple production upgrades using Stellar's on-chain WASM upgrade mechanism with multisig authorization.

What wallets are supported?

Freighter, LOBSTR, and WalletConnect. These cover the major Stellar wallet providers. Hardware wallet support is available through the wallets themselves (Ledger integration through Freighter, for example).

What are the transaction fees?

Stellar transactions are extremely cheap, typically a fraction of a cent per operation. This is one of the reasons Stellar works well for auto-compounding strategies that would be uneconomic on high-fee chains.

How is the protocol upgraded?

Contract upgrades require multisig authorization and are executed on-chain. Every upgrade is publicly recorded and verifiable.

Can BLUB be used in other DeFi protocols?

Yes. BLUB is a standard Stellar asset. It can be traded on Stellar DEX, used in AMM pools on Aquarius, and integrated into other Stellar DeFi protocols.

Ecosystem & listings

Is WhaleHub affiliated with Aquarius?

WhaleHub is an independent third-party protocol that integrates with the Aquarius AMM and ICE governance system. Not operated by the Aquarius team.

Is WhaleHub affiliated with Stellar Development Foundation (SDF)?

WhaleHub is an independent project building on Stellar, pursuing SCF Build Award funding, but operated independently.

Where can I trade BLUB?

Primary liquidity is the AQUA/BLUB pool on Aquarius AMM. BLUB is also tradeable via LOBSTR (which routes through Aquarius and Stellar Classic DEX) and directly on Stellar's on-chain DEX.

How can I follow WhaleHub updates?
How do I propose a partnership or integration?

Reach out on Telegram or email. Be specific about what you're proposing. Protocol integrations that benefit BLUB holders and expand Stellar DeFi composability are actively welcomed.

Troubleshooting

My AQUA or BLUB balance in the app isn't updating. What's going on?

The app reads balance data from the Stellar network. Occasionally there can be a brief delay between a transaction confirming and the new balance appearing in the UI. Refreshing the page usually resolves it. If the issue persists after a hard refresh and cache clear, message us on Telegram with your wallet address and we'll investigate.

My transaction is failing. Why?

Most common causes, in order:

  1. Not enough XLM for fees and reserves. Stellar requires a small XLM balance to cover transaction fees and per-trustline reserves.
  2. Missing trustline. Stellar requires you to explicitly trust an asset before holding it. If you're receiving BLUB for the first time, add the BLUB trustline in your wallet.
  3. Insufficient balance. Your usable balance is your total balance minus Stellar's reserve requirements. Make sure you're not trying to send more than your spendable amount.
  4. Slippage. In vault or swap operations, extreme price moves during signing can cause transactions to fail. Try again with slightly higher slippage tolerance.
I deposited but don't see my BLUB. What happened?

Check that BLUB has a trustline set in your wallet. Stellar requires assets to be explicitly trusted before they can be held. Once the trustline is added, BLUB should appear.

The app is slow or not loading. What can I do?

Try a hard refresh (Ctrl+Shift+R or Cmd+Shift+R). Clear browser cache for app.whalehub.io. Try a different browser. If the problem persists, message us on Telegram so we can check for any ongoing issues.

I found a bug. How do I report it?

Telegram is fastest: t.me/whalehubdefi. Include:

  • What you did (step by step)
  • What you expected to happen
  • What actually happened
  • Your wallet address (if balance-related)
  • Browser, OS, and any error messages

Genuine bug reports get priority, especially from power users. We'll get back to you quickly.

My question isn't here.

Drop it in Telegram: t.me/whalehubdefi. We add new questions to this FAQ as they come up.

Still have questions?

If it's not answered here, the team responds fast. Ask in the community and we'll add it to the FAQ.

WhaleHub is live on Stellar mainnet. Nothing in this document constitutes financial advice. Understand what you're holding before you deposit.