Skip to content

README.md

Latest commit

 

History

History
73 lines (50 loc) · 1.61 KB

README.md

File metadata and controls

73 lines (50 loc) · 1.61 KB

Helios Testnet App

This app guides users into the Helios ecosystem via wallet connection, XP-based progression, faucet claiming, NFT rewards, and leaderboard tracking — all with the help of Phaeton, our official mascot.

Features

  • Wallet Connection (EVM-compatible)
  • Guided Onboarding Flow with Mascot Dialog
  • Network Setup (Auto-add Helios Testnet to MetaMask)
  • Faucet Claim Integration
  • XP System & Progress Tracker
  • NFT Badge Minting
  • Leaderboard & Rank Display
  • Contributor Role Application

Tech Stack

  • React 18
  • Vite
  • TypeScript
  • wagmi v1 + viem
  • ethers.js
  • Zustand (state)
  • Framer Motion (animations)
  • tsparticles / react-particles (visual effects)
  • TanStack React Query (data fetching)

Installation

git clone https://github.com/helios-network/helios-testnet-app.git
cd helios-testnet-app
npm run install  # or yarn / npm install
npm run dev      # start local dev server

Environment Setup

Create a .env file based on .env.example and set your environment variables:

VITE_HELIOS_CHAIN_ID=0xA11
VITE_HELIOS_RPC_URL=https://rpc.testnet.helios.xyz
VITE_FAUCET_API_URL=https://api.testnet.helios.xyz/faucet

Development Notes

  • XP, badge, and step progress are tracked in frontend state and sync to backend via REST API.
  • All wallet interactions are via wagmi + viem or ethers.js where needed.

Contributing

Pull requests are welcome!
To apply as a community contributor, you can also submit your GitHub or social links directly in the dashboard via the "Apply as Contributor" form.

License

MIT — Helios Foundation 2025