MonadSwift

MonadSwift is the friendly path onto Monad: social login and an embedded wallet, one-tap yield, tipping by handle, and UX that surfaces how fast the chain is.

The problem

Crypto onboarding is broken in different ways:

1. Wallets — Asking a new user to install MetaMask and write down 12 words? You have already lost them.
2. Speed — On most chains, you wait many seconds for a transaction to confirm. That feels slow compared to tapping your bank app.
3. Complexity — DeFi is too complicated. Yield farming can mean many steps across several apps. Regular people are not doing that.

The solution

MonadSwift is built to fix that on Monad:

1. Login — Sign in with Google or email via Privy. An embedded wallet is created for you instantly — no MetaMask, no seed phrases.
2. Feel it — Every transaction shows a live speedometer proving Monad’s 1-second finality; it feels instant.
3. Earn — One-tap flow to deposit MON into a yield-bearing vault — no DEX routing, no multi-step flows.
4. Tip — Tip hackathon projects by handle; an on-chain leaderboard tracks contributions in real time.

How it works (architecture)

A simple path from sign-in to cash-out:

Step	What happens
Sign in	Email or Google via Privy
Fund	MoonPay on-ramp to MON
Earn / tip	Yield vault or social tipping
Cash out	MoonPay off-ramp to fiat

The experience is designed to stay fast (Monad), instant (funding and feedback), and direct (few hops to the thing you want to do).

Requirements

• Node.js 22+ (see frontend/package.json engines if specified)
• pnpm (lockfile: frontend/pnpm-lock.yaml)

Setup

1. Install dependencies

   cd frontend
   pnpm install

2. Environment

   Copy the example env file and fill in values from Privy and MoonPay (see comments in the example file):

   cp .env.example .env

   Do not commit .env; it is listed in .gitignore. Variable names and optional MoonPay tuning are documented in frontend/.env.example and frontend/vite.config.ts.

   Optional: for the handle → address resolver API, see resolver-service/.env.example and run that service if you use those features locally.

Scripts

From frontend/:

Command	Description
pnpm dev	Dev server (React Router + Vite)
pnpm build	Production build
pnpm start	Serve production build locally
pnpm typecheck	Route types + TypeScript check

Project layout

• frontend/ — React Router 7 application (routes, components, styles)
• resolver-service/ — optional backend for Privy-linked handle resolution (see its package.json for scripts)

Team

• Ahmed Makinde — @thatweb3gee
• Demilade Ayeku — @AgenttDefi