Case study

Ethereum Token Launch Studio

Reusable token operations platform

Next.jsTypeScriptSupabaseHardhatSolidityEthereum

Key outcomes

Verified token deployments bridged into a project contract registry
Protected token launch workflows with retry, recovery, and cancellation
Replayable Supabase infra boundary and solid CI/tooling

The Problem

Launching an ERC-20 token involves a deceptively short list of steps—write the contract, deploy, verify, register—but each step has failure modes that are painful to debug and expensive to retry if not handled correctly.

Most token launch implementations are one-off scripts. They work once, in a specific environment, with a specific wallet. They are not recoverable. They have no visibility. They are not reusable.

This client needed a platform to run repeatable, observable token launches across multiple projects with a team of operators.

What Was Built

Ethereum Token Launch Studio is a monorepo with three workspaces working in concert:

  • apps/web — Next.js project dashboard with real-time launch status
  • worker — Node.js runtime that executes launches off the UI thread
  • contracts — Hardhat 3 workspace with ERC-20 contract and deployment scripts

The launch workflow is worker-driven: the UI submits a launch request and displays a live activity feed. The worker picks it up, deploys, verifies on Etherscan, and writes the result to a project contract registry in Supabase.

Why Worker-Driven

On-chain operations cannot run in a Next.js API route. A typical token deployment takes 30–60 seconds and a network hiccup can cause the HTTP request to time out mid-broadcast. If the transaction was broadcast before the timeout, you now have a deployed contract with no record of it.

The worker solves this by:

  1. Persisting the launch intent before touching the chain
  2. Broadcasting and waiting for confirmation independently of any HTTP connection
  3. Writing the confirmed deployment to the registry atomically
  4. Supporting retry and cancellation via status flags

The UI subscribes to status updates via Supabase Realtime—no polling required.

Contract Registry

Every verified deployment is registered in a project-scoped contract registry: address, chain ID, deployer wallet, block number, Etherscan verification status, and deploy timestamp. This makes the registry the single source of truth for what contracts exist and who owns them—not a Hardhat artifacts folder that only exists locally.

Replayable Infrastructure

The most underrated feature: every migration and validation step is replayable. Before a launch, the system runs a sequence of checks—schema validation, contract compilation, environment variable completeness, previous registry state. If any check fails, the launch is blocked before touching the chain.

This "preflight" pattern catches the common mistakes (wrong RPC URL, missing private key, stale artifact) before they cause a stuck deployment.

Key Engineering Decisions

Hardhat 3 over Foundry for this project—the client's team was more familiar with JavaScript tooling, and the Hardhat task system integrated cleanly with the Node.js worker.

Supabase as the infra boundary. Auth, realtime, and the contract registry all live in Supabase. This means a new team member needs one set of credentials to get full visibility into the system, not four different services.

Protected workspace routes. Project isolation is owner-enforced at the API level—not just in the UI. A user cannot read or write to a project they do not belong to, even with a valid session token.

Scope

  • Monorepo with Next.js web app, Node worker runtime, and Hardhat 3 contracts workspace.
  • Protected workspace and project routes with owner-aware membership management.
  • Worker-driven token launch workflow with activity feed and live status.
  • Replayable database validation and migration checks for safer deployments.
  • End-to-end verification commands for contracts, DB, lint, tests, and build.
Like what you see?

Waqas Raza

AI-Native Full-Stack Engineer. Top Rated on Upwork · $180K+ earned · 93% job success. I build production AI agents, LLM systems, Web3 platforms, and full-stack applications.

Hire me on Upwork