Universal Private

Universal Private is a revolutionary universal privacy solution built on ZetaChain and RAILGUN. It enables cross-chain privacy transactions, allowing users to interact with DeFi protocols, privacy pools, and transfers across any chain while maintaining complete anonymity.

We integrate the Railgun privacy system with ZetaChain's omnichain capabilities to create a unified privacy layer. This repository contains the core contracts, a web frontend demo, a backend/testing suite, and the Universal Private SDK for developers.

🌟 Key Features

Universal Privacy: Perform private transactions on any supported chain.
Cross-Chain Shielding: Move funds from Ethereum, BSC, Base, Arbitrum, Avalanche, Polygon, and more directly into the Railgun privacy system on ZetaChain.
0zk Address: Create a Zero-Knowledge address (0zk) to hold and manage funds privately.
Private DeFi: Interact with DeFi protocols (Swap, Liquidity Provision) anonymously.
Unshield Anywhere: Withdraw funds from your privacy account to a public address on any supported chain.
Developer SDK: A comprehensive Typescript SDK to integrate Universal Private features into your own dApps and wallets.

🏗 Architecture

Universal Private leverages ZetaChain for cross-chain messaging and interoperability, and Railgun for zero-knowledge privacy.

graph TD
    subgraph "External Chains (Source/Destination)"
        User[User / Public Address]
        EVMAdapt[EVM Adapt Contract]
    end

    subgraph "ZetaChain (Privacy Layer)"
        ZetaAdapt[Zetachain Adapt Contract]
        RelayAdapt["Relay Adapt (Execution Layer)"]
        RailgunWallet["Railgun Smart Wallet (0zk System)"]
        DeFi[DeFi Protocols]
    end

    User -- "1. Shield (Deposit)" --> EVMAdapt
    EVMAdapt -- "Cross-Chain Message" --> ZetaAdapt
    ZetaAdapt -- "Deposit" --> RailgunWallet
    
    User -- "2. Private Transfer / DeFi" --> RailgunWallet
    RailgunWallet -- "Zero-Knowledge Proof" --> RelayAdapt
    RelayAdapt -- "Interact" --> DeFi
    
    RailgunWallet -- "3. Unshield (Withdraw)" --> RelayAdapt
    RelayAdapt -- "Withdraw" --> ZetaAdapt
    ZetaAdapt -- "Cross-Chain Message" --> EVMAdapt
    EVMAdapt -- "Funds" --> User

    style ZetaChain fill:#e9f5ff,stroke:#005da0,stroke-width:2px

📂 Project Structure

contract/: Smart contracts including ZetaChainAdapt (ZetaChain) and EVMAdapt (Other EVM chains).
frontend/: A Next.js Web Application demonstrating the full capabilities of Universal Private.
test/: Node.js scripts for backend testing and command-line usage demos.
frontend/packages/sdk/: The Universal Private SDK source code.

🚀 Getting Started

Prerequisites

Node.js (v18 or higher recommended)
pnpm (for frontend)
npm (for test scripts)

Installation

Clone the repository:

git clone https://github.com/ZetachainHackathon/UniversalPrivate.git
cd UniversalPrivate

Run the Web Demo:
```
cd frontend
pnpm install
pnpm dev
```
Open http://localhost:3000 in your browser.

Note: The Web Demo creates a client-side wallet. You can generate a 0zk address using a mnemonic, or alternatively, generate a new 0zk address by signing with your connected wallet (no mnemonic required).

For more details, please refer to the Frontend README. Or try it out on Web Demo Page: UniversalPrivate Web Demo Page
Run Node.js Tests/Backend:
```
cd test
npm install
# Run specific tests
npm run test
```
This folder contains scripts to programmatically interact with the Shield, Unshield, and Transfer functions.

📜 Smart Contracts

For detailed deployment guides, architecture diagrams, and verified contract addresses, please refer to the Contract Documentation.

It covers:

Deployment: How to deploy to ZetaChain and and other EVM chains.
Architecture: Detailed system design and interaction flows.
Verification: Scripts to verify deployments.