Back to Projects

Filament Web3 Airdrop Platform

Decentralized Governance & Token Distribution

Overview

Full-stack Web3 platform with NestJS backend, SvelteKit frontend, and Ethers.js blockchain integrations. Adapter pattern for multi-chain support, event-driven WebSocket architecture, and Clerk Auth for secure user management.

Key Features

  • NestJS backend + SvelteKit frontend for Web3 airdrop governance platform
  • Adapter pattern for unified multi-chain transaction handling (Ethereum + Hub)
  • Event-driven WebSocket architecture with real-time UI updates
  • Ethers.js on-chain execution and automated token distribution
  • Clerk Auth integration across backend and frontend
  • Campaign lifecycle from creation through voting to token distribution

Tech Stack

Backend

NestJSNode.jsPostgreSQLRedisTypeScript

Frontend

SvelteKitTailwind CSSTypeScript

Blockchain

Ethers.jsWebSocketClerk Auth

Challenges & Solutions

Multi-Chain Transaction Handling

Problem

Ethereum and custom Hub blockchain have completely different transaction models, APIs, and signing mechanisms — UI needed to work with both without code duplication.

Solution

Adapter pattern with unified ITransaction interface — both EthereumTransaction and HubTransaction implement the same interface. Adding new blockchain = one new class, zero backend changes.

Real-Time Transaction State Sync

Problem

Transaction status needs to be tracked across the campaign lifecycle (pending, confirmed, failed) with real-time UI updates.

Solution

WebSocket-based event-driven architecture — backend emits transaction lifecycle events, frontend subscribes for optimistic UI updates across all components.

Key Achievements

Multi-Chain
Unified Adapter for Ethereum + Hub blockchain
Event-Driven
WebSocket real-time architecture
NestJS + SvelteKit
Full-stack Web3 platform
Ethers.js
On-chain execution and token distribution