whatisgithub

What is potatopad?

itsfriedpotato/potatopad — explained in plain English

Analysis updated 2026-05-18

10TypeScriptAudience · developerComplexity · 5/5LicenseSetup · hard

In one sentence

An open-source template for launching a cryptocurrency token with instantly tradable, permanently locked liquidity on Uniswap.

Mindmap

mindmap
  root((PotatoPad))
    What it does
      Launches tokens instantly
      Locks liquidity forever
      Shares trading fees
    Tech stack
      Solidity
      Next.js
      Hardhat
      Uniswap V3
    Use cases
      Learning launchpad design
      Forking for own launch
      Holder fee rewards
    Audience
      Web3 developers
      Crypto builders
      Smart contract learners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Study exactly how a direct-to-Uniswap token launchpad works end to end.

USE CASE 2

Fork and deploy a token launch system with permanently locked liquidity.

USE CASE 3

Launch a token that shares trading fees with holders instead of only the creator.

USE CASE 4

Test smart contract behavior against real Uniswap V3 contracts before deploying.

What is it built with?

SolidityTypeScriptNext.jsHardhatUniswap V3

How does it compare?

itsfriedpotato/potatopadcodee-sh/payload-training-appjeanmeche/riegler.fr
Stars101010
LanguageTypeScriptTypeScriptTypeScript
Last pushed2025-11-09
MaintenanceQuiet
Setup difficultyhardmoderateeasy
Complexity5/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Unaudited demo software requiring smart contract deployment, an env file, and a Next.js frontend to run the full loop.

MIT license with an added attribution requirement: use, modify, and ship it, but keep the license notice attached.

So what is it?

PotatoPad is an open source template for launching a new cryptocurrency token that immediately becomes tradable, without the staged bonding curve system many other launch tools use. When someone launches a token through this project, the entire supply is minted and placed directly as trading liquidity on Uniswap, a decentralized exchange, in a single transaction. This liquidity position is then locked permanently so it can never be withdrawn, meaning the token cannot later be rug pulled by draining its liquidity. The project explicitly describes itself as demo software that is unaudited and not ready for production use, meant to show how this style of launchpad works rather than to be relied on with real money. The README is written to be approachable for people comfortable running terminal commands and editing a configuration file, walking through running the whole system locally, deploying the smart contracts to a test network, and hosting the accompanying website. The project includes three main pieces. First, smart contracts written in Solidity that handle creating the token, minting the locked liquidity position, and permanently locking the associated fees, with variants that let trading fees get shared with everyone holding the token rather than only the creator. Second, a website built with modern web tools that lets people discover new tokens, launch a new one through a form, and view details like price and holder count for each token. Third, a set of scripts for demonstrations, deployment, and seeding a local test environment with sample tokens, along with 63 automated tests that run against the real Uniswap contracts rather than simplified stand ins. The project takes several measures to prevent common problems in this space, including making the token's contract address unpredictable until launch to stop pre launch manipulation, and a short window after launch that limits how much supply any single wallet can hold, aimed at slowing down automated bots. It is released under the MIT license with an additional attribution requirement.

Copy-paste prompts

Prompt 1
Walk me through running PotatoPad locally including deploying contracts and seeding sample tokens.
Prompt 2
Explain how the single-sided liquidity locking mechanism in PotatoPad prevents rug pulls.
Prompt 3
Help me understand the difference between createToken and createRewardToken in this project.
Prompt 4
Show me how to deploy PotatoPad's contracts to a testnet like Base Sepolia.

Frequently asked questions

What is potatopad?

An open-source template for launching a cryptocurrency token with instantly tradable, permanently locked liquidity on Uniswap.

What language is potatopad written in?

Mainly TypeScript. The stack also includes Solidity, TypeScript, Next.js.

What license does potatopad use?

MIT license with an added attribution requirement: use, modify, and ship it, but keep the license notice attached.

How hard is potatopad to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is potatopad for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.