VoID Electronic Identity (eID)

A modern web application integrating Discord authentication with Sui blockchain wallet verification, featuring a Rust backend and a React frontend.

Overview

Void eID provides a seamless way to link Discord identities with Sui Wallets. It uses a robust Rust backend for secure authentication and state management, and a modern React frontend for user interaction.

Project Structure

• Backend (src/backend):

  • Written in Rust using Axum.
  • Uses SQLite for data persistence via SQLx.
  • Implements OpenAPI documentation with Utoipa and Scalar.
  • Handles Discord OAuth2 flow and Sui Wallet signature verification.

• Frontend (src/frontend):

  • Built with Vite and React 19.
  • Integrates Sui dApp Kit for wallet connections.
  • Uses TanStack Router for type-safe routing.
  • Styled with a custom design system (see Design System).

Quick Start

Prerequisites

• Rust (latest stable)
• Node.js & Bun
• Just (optional, strictly recommended for task running if added later)
• Discord Application Credentials (see Discord Setup)

Backend Setup

1. Navigate to src/backend.
2. Copy .env.example to .env (create one if missing) and populate:

   DATABASE_URL=sqlite:void-eid.db
   DISCORD_CLIENT_ID=your_id
   DISCORD_CLIENT_SECRET=your_secret
   JWT_SECRET=your_jwt_secret
   PORT=5038

3. Run the backend:

   cargo run

   The API will be available at http://localhost:5038. API Documentation is available at http://localhost:5038/docs.

Frontend Setup

1. Navigate to src/frontend.
2. Install dependencies:

   bun install

3. Run the development server:

   bun run dev

   The app will be available at http://localhost:5173.

Documentation Index

• Backend Documentation - Detailed API and architecture info.
• Frontend Documentation - Component structure and state management.
• Deployment Guide - How to build and deploy.
• Release Process - Automated release workflow.
• Design System - UI styles and tokens.
• Contributing - Development guidelines.