BlueHook

Programmable, hold-weighted liquidity for Uniswap V4.

One contract. ERC20 + hook. Swap tax in ETH flows to holders by weight — and a restore stream that keeps the system alive.

Uniswap V4 Hook Ethereum Mainnet $BLUE · 100,000 supply

Protocol

A unified execution layer

One system for discovery, on-chain hold/tax configuration, and value flow — baked into BlueHook itself.

1

Discovery and trade

Inspect the live hook token, its fee path, and hold weight — then trade $BLUE through the Uniswap v4 pool it powers.

2

On-chain config

Hold ramp, tax split, and restore rules live in the contract. No separate marketplace deploy — the module set is the token.

3

Value to holders

3% ETH on swaps routes 70% to holders by weight and 30% to the restore stream. Claim with claimRewards().

Marketplace · Live modules

The Hook Economy

Not a third-party hook store — BlueHook ships as a fixed module set. Configure nothing; read the params that already run on-chain.

BlueHook · fee path Interface preview

          
Read-only params · address pending deploy Open App

Why V4 Matters

Pools are programmable now

V4 gave pools pluggable logic at lifecycle stages. BlueHook is the ERC20 + hook that sits there — fee, weight, and restore in one transaction.

V2 · 2020

Constant product

Permissionless swaps. It just worked — but pools had no programmable behavior.

V3 · 2021

Concentrated liquidity

More capital efficient. Pools stayed rigid; logic still lived outside the pool.

V4 · 2024 · Now

Hooks

Lifecycle hooks fire inside the swap. This is where BlueHook fits — and stays.

Shared PoolManager

One manager, external hooks. Attach BlueHook when the pool is created — behavior is native, not bolted on later.

beforeSwap / afterSwap

Fee capture and accounting run in the same tx as the trade. Holders accrue without a separate indexer hop.

Flash accounting

Balances settle once per transaction. Hook gas is the cost of computation — not a second settlement layer.

Alignment

The BlueHook stack

Three layers. Execution is mandatory. Identity and rewards sit on top of the same contract.

L0 · Mandatory

Execution

Uniswap v4 hook + ERC20 in one contract. Fee path, soft sell, sync, and claim all live here.

L1 · Identity

Identity

$BLUE on Ethereum mainnet. Fixed supply. Discoverable as the pool’s hook token — not a separate registry NFT.

L2 · Rewards

Rewards

Hold longer → higher multiplier (×1.00 → ×2.00). ETH fees drip by weight; restore stream for eligible balances.

Protocol Token

$BLUE: hold the hook

Not a stake-and-forget emission farm. Hold $BLUE; your weight grows with time. Swaps pay ETH — 70% to holders, 30% to restore.

Hold multiplier ETH fee capture claimRewards() sync(address)
  • 3% ETH tax on swaps — no sell-the-token diversion for rewards.
  • Weight = balance × hold multiplier; ramp +5%/hour up to ×2.00.
  • Soft sell keeps 50% of hold credit so depth doesn’t punish every exit.
  • Fixed supply: 100,000 BLUE. Ethereum mainnet only.
Fee
3%
FEE_BPS 300 · ETH
Holder share
70%
By hold weight
Restore
30%
RESTORE stream
Multiplier
×2.00
Cap · +5% / hour

Protocol Updates

Roadmap & milestones

From deploy to surface — the hook is the product.

Phase 0

Mainnet deploy

ERC20 + v4 hook live. Contract address published. Pool seeded on Ethereum.

Phase 1

App surface

Claim, sync, hold-weight dashboard and Uniswap trade links — live in #app (demo until deploy).

Phase 2

Docs & transparency

Full mechanics, params table, and on-chain API live in #docs on this site.

Ongoing

Audit & hardening

Security review cadence. No multi-chain promise until mainnet proves the loop.

Docs

How BlueHook works

ERC20 + Uniswap v4 hook in one contract. Swaps fund continuous ETH rewards. Hold time compounds your weight.

Overview

BlueHook ($BLUE) is a fixed-supply token on Ethereum mainnet that is also its own Uniswap v4 hook. There is no separate fee router: every swap through the hooked pool pays a 3% ETH tax inside the trade. That ETH feeds two continuous streams — holders and restore — weighted by how long you hold.

  • Supply: 100,000 BLUE (fixed)
  • Token address = hook address (CREATE2)
  • Rewards asset: ETH (not the token)

Tax & streams

Every buy and sell that routes through the hooked pool pays FEE_BPS = 300 (3%) in ETH:

  • 70% → holder stream, distributed by balance × hold multiplier
  • 30% → restore stream (RESTORE_BPS = 3000), same weight model when eligible (≥100 BLUE)

Nothing sits waiting for a keeper. Accrual updates as people trade; you claim when ready.

Hold multiplier

Hold credit starts at ×1.00 (10,000 bps) and ramps +500 bps per hour (+5%/hour) up to a hard cap of ×2.00. Longer holds mean more weight on each drip — same balance, higher share.

// continuous ramp RAMP_BPS_PER_HOUR = 500 MAX_BONUS_BPS = 10_000 // → ×2.00 weight = balance × (10_000 + bonus) / 10_000

Soft sells

Selling does not wipe your hold clock. Soft decay keeps 50% of elapsed hold credit (SELL_KEEP_NUM / SELL_KEEP_DEN = 1/2. Patience still compounds after an exit — the system remembers what you kept.

Claim & sync

  • claimRewards() — withdraw combined holder + restore ETH to msg.sender
  • sync(address) — settle accruals and refresh tracked weight without claiming
  • Unclaimed rewards can be purged after the contract’s purge window (24h) — claim on schedule

Use the App to connect, read claimable ETH, and submit claim/sync txs.

Parameters

ConstantValueMeaning
SUPPLY100,000e18Fixed total supply
FEE_BPS3003% ETH tax on swaps
RESTORE_BPS300030% of tax → restore
MIN_RESTORE_BAL100e18Min BLUE for restore weight
RAMP_BPS_PER_HOUR500+5% mult / hour
MAX_BONUS_BPS10_000Cap at ×2.00
SELL_KEEP1/2Soft sell keep ratio
SPACING60Pool tick spacing

On-chain API (read)

multiplierBps(who) → uint256 holdSeconds(who) → uint256 claimableOf(who) → uint256 ETH wei holderRewardsOf(who) → uint256 restoreClaimableOf(who)→ uint256 balanceOf(who) → uint256 dripBuffer() / totalWeight() / launchTime()

Writes: claimRewards(), sync(address), owner-only boot(sqrtPriceX96).

Adding liquidity

After boot, spot is set for a ~10 ETH FDV (0.0001 ETH per BLUE). LP is typically added via Uniswap UI as token-only below spot:

  • Min: 0 BLUE/ETH
  • Max: ~9,900 BLUE/ETH (must be < 10,000)
  • Deposit: full supply 100,000 BLUE · 0 ETH

App

Hold-weighted liquidity, one contract.

Connect a wallet to read claimable ETH, multiplier, hold time, and balance — then claim, sync, or trade on Uniswap.

Position DEMO

Not connected
Claimable ETH
0.0000
Multiplier
×1.00
Hold time
Balance
Holder drip
Drip buffer
Total weight
Launch

Trade

ETH
BLUE

Via Uniswap v4 · 3% hook tax