Documentation

Overview

Every token deployed through Liquid Protocol gets 100 billion supply (18 decimals), a Uniswap V4 pool, and permanently locked liquidity with configurable reward splits.

The protocol supports two hook types: Dynamic Fee (adaptive fees based on volatility) and Static Fee (fixed fee rate). Both integrate MEV protection via block delay and sniper auction modules.

Extensions allow tokens to include dev buys, vault lockups with linear vesting, and merkle-tree airdrops — all configured at deployment time.

Pools pair with WETH by default or DIEM(an agent-economy payment token) when explicitly requested at deploy. Three deploy paths: this site’s /launch form, the SDK, or the @launchonliquid bot on Farcaster + X.

Launcher Bot

Mention @launchonliquid on Farcaster or @launchonliquid on X with a $TICKER + name. The bot deploys the token on Base and replies with the contract address.

@launchonliquid launch $MYTKN called My Token

Cast / tweet syntax

• $TICKER — required. 1–32 chars, must start with a letter.
• called X / named X — set the token name (defaults to the ticker).
• paired in diem — pair the pool with DIEM instead of the default WETH. Also accepts paired with diem / paired $DIEM.
• to 0xAddress — route tokenAdmin + fee recipient to a specific wallet (override).
• vault 20% — lock a percentage of supply with linear vesting (max 90%).
• vault for 30 days — set the lockup duration (min 7 days, default 7).
• Attach an image to the cast/tweet — the bot pins it to IPFS as the token image (gifs work too).

Anti-spam: bot only replies to original posts (not retweets/recasts), enforces per-user daily limits, and uses a launch-intent classifier to ignore narrative posts that happen to contain a $TICKER.

SDK

liquid-sdk 1.7.4+ on npm. Single LiquidSDK class, Base only (chain 8453).

Default WETH-paired deploy

npm install liquid-sdk viem

import { LiquidSDK } from "liquid-sdk";
import { createPublicClient, createWalletClient, http } from "viem";
import { base } from "viem/chains";

const publicClient = createPublicClient({ chain: base, transport: http() });
const walletClient = createWalletClient({ chain: base, transport: http(), account });
const sdk = new LiquidSDK({ publicClient, walletClient });

const result = await sdk.deployToken({
  name: "My Token",
  symbol: "MTK",
  tokenAdmin: account.address,
  rewardAdmins: [account.address],
  rewardRecipients: [account.address],
});

console.log(result.tokenAddress, result.txHash);

DIEM-paired deploy

import { LiquidSDK, EXTERNAL, createLiquidPositionsUSD } from "liquid-sdk";

// Anchor the 5-position layout to land at a target starting MC.
// pairedTokenPriceUsd should be the live DIEM/USD price at deploy time.
const positions = createLiquidPositionsUSD(20_000, diemPriceUsd);

await sdk.deployToken({
  name: "Agent Token",
  symbol: "AGENT",
  pairedToken: EXTERNAL.DIEM,
  tickIfToken0IsLiquid: positions.tickIfToken0IsLiquid,
  tickLower:   positions.tickLower,
  tickUpper:   positions.tickUpper,
  positionBps: positions.positionBps,
  tokenAdmin: account.address,
  rewardAdmins: [account.address],
  rewardRecipients: [account.address],
});

Full SDK reference on GitHub or via the liquid-sdkpackage’s typed exports.

Relaunch Tool

Migrate a Solana $CLANKER (or other Bags token) to Base. Holders connect their Solana wallet, deposit the old token, and claim the new Liquid-deployed token at a fixed redemption ratio.

The relaunch flow is fully user-signed — no platform custody. Old supply burns to 0xdead; new supply is locked in a Base contract and claimed proportionally as users redeem.

[ TRY /relaunch ]

Mini App Embed

Token detail pages render as Farcaster Mini Apps. When a token URL is embedded in a cast, Farcaster clients display a tappable card with the token’s image, ticker, and name; tapping opens the page inside the Farcaster app.

The page emits both the canonical fc:miniapp meta tag and the legacy fc:frame fallback per the Mini App spec. The domain manifest lives at /.well-known/farcaster.json.

The @launchonliquid bot attaches the token URL on its reply casts so the Mini App card renders inline in the deploy thread.

Key Concepts

Factory

The main entry point for deploying tokens. Creates the ERC-20, initializes the Uniswap V4 pool, locks LP, and configures all modules in a single transaction.

Hook

Uniswap V4 hook contract that manages pool fees. Dynamic Fee adjusts based on volatility; Static Fee uses a fixed rate.

LP Locker

Holds the Uniswap V4 LP position permanently. Distributes trading fees to configured reward recipients by BPS splits.

Fee Locker

Accumulates protocol fees from trading. Fee owners can check available balances and claim.

MEV Block Delay

Prevents MEV extraction by locking the pool for a configurable number of blocks after deployment.

Sniper Auction

Prices early trading activity via a descending fee auction. Protects against sniping bots.

Vault

Extension for token lockup with linear vesting. Tokens are locked until a configurable end time, then vest linearly.

Dev Buy

Extension that swaps ETH for tokens through the pool in the same transaction as deployment.

Contract Addresses

All contracts on Base (chain ID 8453).

Socials

• Farcaster — @launchonliquid (bot + protocol updates)
• X — @launchonliquid (bot + protocol updates)
• GitHub — Liquid-Protocol-Ops

Fee Constants