Documentation

How Nexus works.

Nexus is a launch protocol on BNB Smart Chain for tokens that represent a declared value. It uses PancakeSwap V3 concentrated liquidity to shape each token's price curve, and permanently locks every position so that nobody — including Nexus — can pull liquidity.

Overview

There are two layers of assets and two kinds of quote currency.

  • Roots are the quote currencies everything is ultimately priced in: USDT and BNB (as WBNB).
  • Anchors are priced assets — a watch, a card, a skin, a company, an idea — launched with a declared USD valuation. Their curve keeps most of the supply at that value, so the price has a hard floor in the Nexus pool.
  • Memes are speculative tokens with a pump-shaped curve. A meme is quoted in an anchor, or directly in a root.

The maximum depth is root → anchor → meme. Memes cannot be parents. Every asset has exactly one PancakeSwap V3 pool (1% fee tier) against its parent, seeded single-sided with the full supply.

Asset model

PropertyAnchorMeme
Supply100,000,0001,000,000,000
ParentUSDT or BNBAny anchor, USDT or BNB
Launch priceDeclared USD value ÷ supply≈ $3,000 market cap
Curve top≈ 4.14× launch≈ 44.7× launch (≈ $134k cap)
Pool fee1%1%
Token contractImmutable EIP-1167 clone of a fixed ERC-20. No mint, no pause, no owner.

Anchors

An anchor turns a declaration — “this is worth $1,000,000” — into a token whose pool defends that number. The curve is a narrow band plus a tail:

SegmentWidthSupplyPrice range
Band200 ticks (2.02%)70%1.00× – 1.02× declared
Tail ×101,400 ticks each (≈15%)3% each1.02× – 4.14× declared

Because the pool is initialised exactly at the bottom of the band and holds only the token, the price can never trade below the declared value inside the Nexus pool: there is simply no liquidity there. Selling back into the band returns the same quote that went in, minus the 1% fee. Buying 70% of the supply moves the price by only 2%; going beyond that climbs the tail.

The declared value is a statement by the creator. Nexus does not appraise, verify or endorse it. The floor is a property of the pool, not a promise about the asset.

Memes

Memes use ten buckets of 3,800 ticks each (≈1.46× per bucket), holding supply in the ratio 1:2:3:…:10. Liquidity is thin at the start and thick at the top, so early buyers move price quickly and later buyers find depth.

  • Start: ≈ $3,000 market cap, set by protocol config at launch.
  • Fill: ≈ $50,000 of quote buys the entire curve; the end market cap is ≈ $134,000.
  • Priced under an anchor, the start price uses the anchor's floor (its band's lower tick), not its spot price — so pumping an anchor does not change where the next meme starts.

Pricing & valuation

  • USDT is treated as $1.
  • BNB is priced from the PancakeSwap V3 USDT/WBNB 0.05% pool using a 30-minute time-weighted average. Same-block trades cannot move it; sustaining a distortion for half an hour against the deepest BNB pool on chain costs far more than any launch is worth.
  • V3 prices live on a grid of ticks; the 1% tier uses steps of 200 ticks (≈2.02%). Declared values snap to the nearest step, so the on-chain floor differs from the typed number by at most ±1%. The launch form shows the snapped value before you sign.
  • Anchors quoted in BNB keep a fixed BNB floor; their USD floor drifts with BNB.

Trading

The Router executes buys and sells along the asset's path (root → anchor → meme at most). It clamps every swap to the curve's own bounds, so a swap that reaches the top or bottom of the curve fills partially and refunds the unused input in the same transaction instead of reverting or trading into empty space.

  • Buy with native BNB when the root is BNB; otherwise approve USDT to the Router.
  • Sells can unwrap to native BNB when the root is BNB.
  • Quotes on this site come from PancakeSwap's QuoterV2 over the same path.
  • The floor only exists in the Nexus pool. Anyone can create other pools for a token; prices there are unconstrained, and Nexus never routes through them.

Fees & creator revenue

Every pool uses PancakeSwap's 1% fee tier. Fees accrue to the locked position and are paid out on every collect: to the token's creator, to the anchor's creator when a meme is priced under an anchor, and to the protocol. Your pending amount is shown on the Fees page.

Lock.collect(pool) is permissionless. Anyone can call it for any pool; it pays every party and retains nothing. Creators choose at launch how their fees are delivered:

  • Pay to address — sent to the recipient given at launch (defaults to the creator).
  • Buy back & burn — the quote-side fees are swapped into the token in the pool and sent to 0x…dEaD. The swap is capped at the curve ceiling; if the price is already there the fees are paid out instead. Frequent, small collects are the safe pattern here; large infrequent buybacks are easier to front-run.

Token addresses

Every token address starts with 0x1111. The fifth hex digit encodes the layer: 8–f for anchors, 0–7 for memes. The Factory enforces this on-chain, together with the requirement that the token sorts below its parent (so it is always token0 in its pool). Addresses are mined in your browser from a salt before launch — about 130,000 hashes, a few seconds.

Trust model

ComponentMutabilityWhat it can do
Token (clone)ImmutablePlain ERC-20. Fixed supply minted once into the Lock.
LockImmutableHolds every LP position. Can only collect fees; cannot burn liquidity or move principal. Owner may only change the protocol treasury address.
FactoryUUPS upgradeableLaunch rules, curve pricing and fee routing for new launches. Cannot touch existing pools or locked liquidity.
RouterUUPS upgradeableConvenience for trading and launch-and-buy. Never custodies funds between transactions; tokens remain tradable directly on PancakeSwap without it.
PoolsPancakeSwap V3Standard, unmodified, permissionless pools.

Risks

  • A declared value is not an appraisal. Above the floor, price is set by trading and can fall to the floor.
  • The floor is defended by the Nexus pool only; other venues can trade below it.
  • Memes have no floor beyond their curve start and can lose nearly all value.
  • BNB-quoted assets carry BNB price risk.
  • Upgradeable Factory and Router are controlled by the protocol owner; upgrade events are public on chain.
  • Smart-contract risk applies to Nexus and to PancakeSwap V3.

Contracts

NameAddress (BSC)
NexusFactory0x2E6D8AEC38FDa048ba995Fbe379927438532D5ac
NexusRouter0x7AA8ef76F572572EEfd2447C419c391614dB4C0A
NexusLock0xE62F3564A8E3f754E9438351C7B61051C1d89330
NexusToken (implementation)0x63C39860c64BE3541C51fe0602288e39052F5157
PancakeSwap V3 Factory0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865
USDT / WBNB 0.05% (TWAP reference)0x36696169C63e42cd08ce11f5deeBbCeBae652050
USDT0x55d398326f99059fF775485246999027B3197955
WBNB0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c

Integrating

  • Factory.getAssets(offset, limit) — newest-first page of tokens with their pool, parent, creator, template and tick range. Factory.getAsset(token) for one.
  • Router.buy(token, amountIn, minOut, to) (payable for BNB roots) and Router.sell(token, amountIn, minOut, to, unwrap).
  • Router.launchAndBuy(params[], amountIn, minOut) — launches in order (a meme may name the anchor launched just before it) and buys the last one. An anchor + meme + buy in one transaction is ≈ 13.8M gas; set the limit explicitly, wallets' default padding exceeds the block cap.
  • Lock.collect(pool) returns (amount0, amount1); simulate it to preview pending fees.
  • Token metadata is an inline JSON string on the token: { description, image, socialMediaUrls[] }.
Documentation · Nexus