pip Platform Docs

What is pip?

pip is a platform that lets anyone create an ERC-20 token for any X (Twitter) profile in seconds. The token is deployed on Base L2 through the Clanker v4 protocol, which handles liquidity pool creation, fee distribution, and token vesting automatically.

The key innovation is that the person the token is created for doesn't need to sign up or take any action beforehand. Anyone can create a token for any X handle, and the profile owner can later claim their vested tokens and trading fees by verifying ownership of the X account.

Key Concepts

How It Works

This section covers the complete lifecycle of a token — from creation through deployment to fee generation and distribution.

Token Creation Flow

When a user creates a token through pip, the following sequence happens:

Smart Contract Deployment

Under the hood, pip interacts with the Clanker v4 Factory contract to deploy tokens. Each deployment creates:

• A new ERC-20 token contract with the specified name and symbol
• A Uniswap V4 pool (token/WETH pair) via the V4 PoolManager singleton
• A locked liquidity position through the Clanker Locker contract
• Reward recipients configured in the fee locker (80% profile owner / 20% platform)
• A vesting allocation in the Clanker Vault for the profile owner (10% of supply)

// Simplified deployment flow (via clanker-sdk v4)
ClankerFactory.deployToken({
  name: "Token Name",
  symbol: "TICKER",
  image: "ipfs://...",
  pool: { pairedToken: "WETH" },
  fees: { type: "static", clankerFee: 125, pairedFee: 125 },
  rewards: {
    recipients: [
      { bps: 8000, token: "Paired" }, // 80% → profile owner
      { bps: 2000, token: "Paired" }, // 20% → platform
    ],
  },
  vault: {
    percentage: 10,           // 10% of supply
    lockupDuration: 2592000,  // 30-day lockup
    vestingDuration: 2592000, // 30-day linear vest
  },
})

Liquidity Pool

Every token launched through pip gets a Uniswap V4 pool paired with WETH (Wrapped Ether on Base). Uniswap V4 uses a singleton PoolManager contract rather than deploying individual pool contracts, which improves gas efficiency and enables hooks for custom pool behavior.

The liquidity position is locked in the Clanker Locker contract — it cannot be removed or rug-pulled. This is a core safety guarantee of the Clanker v4 protocol. Swap fees from the pool are distributed to reward recipients (the profile owner and the platform) via the fee locker.

Fee Structure

pip uses a transparent fee model where the vast majority of trading fees go directly to the profile owner the token was created for.

80/20 Fee Split

Each pool is configured with a static fee of 125 bps (1.25%) on both the token and WETH side. Fees generated from trading are distributed between two reward recipients:

Fee Collection

Fees accumulate in the Clanker Fee Locker contract as the token is traded. The locker holds the locked Uniswap V4 liquidity position and collects swap fees automatically. Neither party needs to do anything for fees to accumulate — they accrue with every trade.

The fee locker tracks unclaimed rewards for both the profile owner (80%) and the platform (20%). Rewards are configured as “Paired” token type, meaning fees are denominated in WETH (the paired token in the pool).

Claiming Fees

Profile owners can claim their accumulated trading fees at any time through the pip dashboard. The process requires authentication to verify X account ownership:

Token Vesting

A core feature of pip is automatic token vesting. When a token is created, 10% of the total supply is reserved and vested for the X profile owner.

Vesting Mechanism

The vesting is handled by the Clanker Vault contract. When a token is deployed, the factory contract automatically allocates 10% of the token supply to a vesting position in the vault, designated for the profile owner.

This creates a strong alignment between the profile owner and the token community — the profile owner benefits from long-term token appreciation rather than being able to dump immediately.

Vesting Schedule

Tokens vest linearly over time. After an initial lockup period, the vested tokens begin unlocking gradually. The profile owner can claim any unlocked tokens at any point during or after the vesting period.

Token Launch
  │
  ├──── 30-day Lockup ────┤──── 30-day Linear Vesting ────┤
  │     (tokens locked)    │    (tokens unlock gradually)   │
  │                        │                                │
  t=0                  Day 30                            Day 60
                           │                                │
                      First claim                     Fully vested
                      available                       (all 10%)

The amountAvailableToClaim function on the Clanker Vault contract returns the current amount of tokens that can be claimed at any given time, calculated based on the linear vesting formula.

Claiming Vested Tokens

To claim vested tokens and fees, the profile owner must first verify their X account on pip. Once verified, pip performs two on-chain transactions: it transfers the reward recipient (for the 80% fee share) to the profile owner's wallet, and transfers the vault allocation admin to their wallet — enabling them to claim both fees and vested tokens directly.

$PIPAI Token

$PIPAI is the native platform token of pip. It has a unique deflationary mechanism that ties its value directly to platform activity.

Buy & Burn Mechanics

The buy and burn mechanism is the core economic engine of $PIPAI. Here's how it works:

Deflationary Model

The buy & burn creates a flywheel effect: more tokens launched on pip means more trading volume, which means more fees collected, which means more $PIPAI bought and burned, which reduces supply.

More tokens launched on pip
       ↓
More trading volume across all tokens
       ↓
More fees collected (20% platform share)
       ↓
More $PIPAI bought on open market
       ↓
More $PIPAI permanently burned
       ↓
Decreasing $PIPAI supply
       ↓
Each remaining $PIPAI represents
a larger share of the ecosystem

Token Details

Technical Architecture

pip is built on a stack of battle-tested protocols and infrastructure. This section covers the key technical components.

Clanker v4 Protocol

Clanker v4 is the latest version of the Clanker token deployment protocol. It builds on Uniswap V4's singleton PoolManager and hooks architecture to provide a factory pattern for creating ERC-20 tokens with built-in liquidity, fee distribution, and token vesting. Key features include:

• Uniswap V4 native — Pools are created via the V4 PoolManager singleton with hook support, enabling custom fee logic and MEV protection
• Static & dynamic fees — Pools can use static fee configurations (e.g., 125 bps) or dynamic fee hooks that adjust based on market conditions
• Built-in vesting — Native support for token vesting through the ClankerVault contract with configurable lockup and vesting durations
• Liquidity locker — Permanent liquidity locking with configurable reward distribution between multiple recipients
• Admin controls — Transferable reward recipient and vault allocation admin roles for flexible claim management

Base L2 Network

All pip tokens are deployed on Base, an Ethereum Layer 2 built on the OP Stack. Base provides the security guarantees of Ethereum mainnet with significantly lower transaction costs and faster confirmation times.

Contract Addresses

All contracts are verified on Basescan. You can interact with them directly or through the pip interface.

For Creators

If someone has created a token for your X profile, here's everything you need to know about claiming your tokens and fees.

Getting Started

As a creator (the person a token was created for), you have two main benefits:

Claiming Your Token

To claim ownership and start receiving benefits, follow these steps:

Managing Fees

Trading fees accumulate continuously as your token is traded. You can monitor and claim your fees through the dashboard. Key things to know:

• Fees accumulate in real-time with every trade
• No minimum claim amount — claim any amount at any time
• Fees are paid in WETH (the paired token in the pool)
• Claiming requires a small gas fee on Base (typically fractions of a cent)
• Unclaimed fees remain safely in the fee locker contract indefinitely

Frequently Asked Questions