MONOMA

Please Read Main details on Github : https://github.com/cadalt0/MONOMA
demo link : https://drive.google.com/drive/folders/1H0sRb6q_7dsU3lIwBAwCbccQAz2OyDk3?usp=sharing

# Monoma - Cross-Chain Stablecoin Settlement Platform

## 🧠 How It Works (Complete System Architecture)

```
┌─────────────────────────────────────────────────────────────────────────────────┐
│                                MONOMA PLATFORM                                 │
└─────────────────────────────────────────────────────────────────────────────────┘
                                        │
                                        ▼
┌─────────────────────────────────────────────────────────────────────────────────┐
│                              USER AUTHENTICATION                               │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │   Google OAuth  │───▶│  Session Store  │───▶│  User Database  │            │
│  │   (Frontend)    │    │  (LocalStorage) │    │  (PostgreSQL)   │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
└─────────────────────────────────────────────────────────────────────────────────┘
                                        │
                                        ▼
┌─────────────────────────────────────────────────────────────────────────────────┐
│                            SMART WALLET CREATION                               │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  User Input     │───▶│  Factory API    │───▶│  Wallet Address │            │
│  │  (Destination)  │    │  (Backend)      │    │  (Generated)    │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
│                                        │                                      │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  ETH Sepolia    │───▶│  Base Sepolia   │───▶│  Avalanche Fuji │            │
│  │  Factory        │    │  Factory        │    │  Factory        │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
│           │                       │                       │                  │
│           └───────────────────────┼───────────────────────┘                  │
│                                   │                                          │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  Source Chain   │───▶│  Arbitrum       │───▶│  Arbitrum Smart │            │
│  │  Smart Wallets  │    │  Factory        │    │  Wallets        │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
└─────────────────────────────────────────────────────────────────────────────────┘
                                        │
                                        ▼
┌─────────────────────────────────────────────────────────────────────────────────┐
│                           SETTLEMENT REQUEST SYSTEM                            │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  Amount & Desc  │───▶│  Generate ID    │───▶│  Store in DB    │            │
│  │  (User Input)   │    │  (Unique PayID) │    │  (PostgreSQL)   │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
│                                        │                                      │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  Shareable Link │◀───│  Payment URL    │◀───│  Request Data   │            │
│  │  (/pay/[payid]) │    │  (Generated)    │    │  (Stored)       │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
└─────────────────────────────────────────────────────────────────────────────────┘
                                        │
                                        ▼
┌─────────────────────────────────────────────────────────────────────────────────┐
│                             PAYMENT PROCESSING                                 │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  Recipient      │───▶│  MetaMask       │───▶│  Chain Selection│            │
│  │  Opens Link     │    │  Connection     │    │  (ETH/Base/AVAX)│            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
│                                        │                                      │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  USDC Transfer  │◀───│  Gas Estimation │◀───│  Network Check  │            │
│  │  (ERC-20)       │    │  (Dynamic)      │    │  (Validation)   │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
│                                        │                                      │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  Transaction    │───▶│  Confirmation   │───▶│  Success State  │            │
│  │  Monitoring     │    │  (Real-time)    │    │  (Clean UI)     │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
└─────────────────────────────────────────────────────────────────────────────────┘
                                        │
                                        ▼
┌─────────────────────────────────────────────────────────────────────────────────┐
│                            POST-PAYMENT BURN PROCESS                           │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  Burn API Call  │───▶│  burnUSDC()     │───▶│  USDC Burned    │            │
│  │  (Automatic)    │    │  (Smart Contract)│    │  (On Source)    │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
│                                        │                                      │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  Circle API     │◀───│  Attestation    │◀───│  Burn TX Hash   │            │
│  │  (Fetch Proof)  │    │  (Cryptographic)│    │  (Submitted)    │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
│                                        │                                      │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  Message        │───▶│  USDC Minted    │───▶│  Settlement     │            │
│  │  Transmitter    │    │  (On Arbitrum)  │    │  Complete       │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
└─────────────────────────────────────────────────────────────────────────────────┘
                                        │
                                        ▼
┌─────────────────────────────────────────────────────────────────────────────────┐
│                              BLOCKCHAIN NETWORKS                               │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  ETH Sepolia    │    │  Base Sepolia   │    │  Avalanche Fuji │            │
│  │  (Source)       │    │  (Source)       │    │  (Source)       │            │
│  │  Smart Wallets  │    │  Smart Wallets  │    │  Smart Wallets  │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
│           │                       │                       │                  │
│           └───────────────────────┼───────────────────────┘                  │
│                                   │                                          │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  USDC Contracts │───▶│  Cross-Chain    │───▶│  Arbitrum       │            │
│  │  (Native)       │    │  Bridge         │    │  (Destination)  │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
│                                        │                                      │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐            │
│  │  Burn Process   │───▶│  Attestation    │───▶│  Arbitrum Smart │            │
│  │  (Source Chain) │    │  (Circle API)   │    │  Wallets        │            │
│  └─────────────────┘    └─────────────────┘    └─────────────────┘            │
└─────────────────────────────────────────────────────────────────────────────────┘
```## 📋 Project Description

**Monoma** is a non-custodial, decentralized platform that enables seamless stablecoin settlement from multiple blockchain networks to Arbitrum. The platform addresses the fragmentation of stablecoin liquidity across different chains by providing a unified interface for cross-chain transfers while maintaining complete user control over funds.

The system operates through a sophisticated multi-layer architecture combining frontend user interfaces, backend smart contract interactions, and cross-chain infrastructure. Users authenticate via Google OAuth and create smart wallets across Ethereum Sepolia, Base Sepolia, and Avalanche Fuji networks through factory contracts deployed on each chain. These factory contracts generate unique wallet addresses tied to a specific destination domain (Arbitrum) and recipient address, enabling seamless cross-chain settlement. The smart wallets created on source chains are specifically designed to receive USDC payments and automatically burn them for cross-chain transfer to Arbitrum smart wallets.

When a user creates a settlement request, the system generates a unique payment ID and stores the request details in a PostgreSQL database. Recipients receive a shareable payment link that displays the amount, description, and available payment chains. Upon payment, users connect their MetaMask wallet, select their preferred chain, and send USDC directly to the requester's smart wallet address. The platform validates network connections, estimates gas fees dynamically, and monitors transactions in real-time.

The most innovative aspect is the post-payment burn mechanism that automatically processes received stablecoins. When a payment is confirmed, the system calls the burn API which executes a `burnUSDC` function on the smart wallet contract, burning the received USDC tokens. This burn transaction is then submitted to Circle's attestation API, which provides cryptographic proof of the burn. Finally, the system uses this attestation to mint equivalent USDC tokens on Arbitrum through the Message Transmitter contract, completing the cross-chain settlement cycle.

Built specifically for the Arbitrum ecosystem, Monoma demonstrates how decentralized applications can provide complex cross-chain functionality while maintaining the core principles of user sovereignty and non-custodial design. The platform showcases seamless integration between traditional web authentication, Web3 wallet interactions, and advanced cross-chain infrastructure, making stablecoin settlement accessible to both crypto-native and mainstream users.

## 🎯 Key Features

- **Non-Custodial Design**: Users maintain full control of their funds and private keys
- **Multi-Chain Support**: Seamless integration with Ethereum, Base, and Avalanche networks
- **Real USDC Transfers**: Actual token transactions using native USDC contracts
- **Smart Wallet Generation**: Automated creation of chain-specific wallet addresses for source chains and Arbitrum destination
- **Burn Mechanism**: Automatic processing of received stablecoins post-payment
- **Google + MetaMask Integration**: Hybrid authentication combining Web2 and Web3
- **Real-Time Monitoring**: Live transaction confirmation and status updates
- **Explorer Integration**: Direct links to blockchain explorers for transaction verification

## 🔧 Technical Stack

### **Frontend Architecture**- **Next.js 14**: React framework with App Router and TypeScript
- **Tailwind CSS**: Utility-first styling with custom components
- **Framer Motion**: Smooth animations and transitions
- **Shadcn UI**: Modern component library
- **Google Identity Services**: OAuth 2.0 authentication
- **MetaMask Integration**: Web3 wallet connection and transaction signing

### **Backend Infrastructure**- **Express.js Server**: RESTful API endpoints with CORS support
- **PostgreSQL Database**: User and transaction data persistence
- **Ethers.js**: Blockchain interaction and smart contract calls
- **Circle Attestation API**: Cross-chain message verification
- **Retry Logic**: Exponential backoff for network reliability

### **Smart Contract Integration**- **Factory Contracts**: Deployed on ETH, Base, and Avalanche testnets
- **Smart Wallets**: Generated on source chains with burn capabilities
- **Arbitrum Smart Wallets**: Destination wallets for final settlement
- **USDC Contracts**: Native token integration on each chain
- **Message Transmitter**: Arbitrum cross-chain message processing
- **Burn Functions**: Automated USDC burning with attestation

### **Cross-Chain Infrastructure**- **Circle CCTP**: Cross-Chain Transfer Protocol for USDC
- **Attestation System**: Cryptographic proof of burn transactions
- **Message Relay**: Automated minting on destination chain
- **Domain Mapping**: Chain-specific destination domains

## 🚀 Innovation Impact

Monoma represents a significant step forward in cross-chain DeFi infrastructure by proving that complex multi-chain operations can be executed in a completely non-custodial manner. The platform eliminates the need for centralized bridges or custodial services while providing users with a seamless experience for stablecoin settlement across different blockchain ecosystems.