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.

SDK

npm install liquid-sdk viem

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

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

// Deploy a token (requires walletClient)
const result = await sdk.deployToken({
  name: "My Token",
  symbol: "MTK",
});

console.log(result.tokenAddress);
console.log(result.event.poolId);

See the full SDK reference on GitHub.

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

• Twitter / X
• GitHub

Fee Constants