ArbiPic 📸

On-Chain Verifiable Photo Capture System using Stylus and Arbitrum Orbit L3

A decentralized application that combats AI-generated fake images by enabling users to capture photos via webcam and cryptographically verify them on-chain. Using Arbitrum’s Stylus (Rust smart contracts) and Orbit L3, each photo is hashed, stored on IPFS, and verified on the blockchain with ZK-style ownership proofs.

🌟 Features

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         FRONTEND                                │
│  React 18 + TypeScript + Vite + Tailwind + Wagmi v2            │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
│  │ PhotoCapture│  │ VerifyPage  │  │ NetworkSwitcher        │  │
│  │ Enhanced    │  │             │  │ (Sepolia ↔ Orbit L3)   │  │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘  │
└───────────────────────────┬─────────────────────────────────────┘
                            │
        ┌───────────────────┼───────────────────┐
        ▼                   ▼                   ▼
┌───────────────┐  ┌────────────────┐  ┌────────────────────┐
│   IPFS        │  │  Arbitrum      │  │  Orbit L3          │
│   (Pinata)    │  │  Sepolia       │  │  (Local/Custom)    │
│               │  │  Chain: 421614 │  │  Chain: 333333     │
│  Images +     │  │                │  │                    │
│  Metadata     │  │  ┌──────────┐  │  │  ┌──────────┐      │
└───────────────┘  │  │ Stylus   │  │  │  │ Stylus   │      │
                   │  │ Contract │  │  │  │ Contract │      │
                   │  │ (Rust)   │  │  │  │ (Rust)   │      │
                   │  └──────────┘  │  │  └──────────┘      │
                   └────────────────┘  └────────────────────┘

📦 Multi-Network Deployment

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm

• Rust toolchain: rustup install stable

• Cargo Stylus CLI: cargo install cargo-stylus --locked

• Docker (for Orbit L3 local development)

• MetaMask wallet

• Testnet ETH: Get from Sepolia Faucet

1. Clone & Install

git clone https://github.com/yourusername/ArbiPic.git
cd ArbiPic

# Install frontend dependenciescd frontend && npm install

# Build Rust contractcd ../contracts && cargo build --release

2. Configure Environment

Create frontend/.env:

VITE_PINATA_JWT=your_pinata_jwt_token
VITE_PINATA_GATEWAY=your-gateway.mypinata.cloud
VITE_APP_URL=http://localhost:5173

3. Run Frontend

cd frontend
npm run dev

Visit http://localhost:5173

🟣 Orbit L3 Deployment

For ultra-low cost verification on your own L3 chain:

Start Local L3

# Clone nitro-testnode
git clone --recurse-submodules https://github.com/OffchainLabs/nitro-testnode.git
cd nitro-testnode

# Start L1 → L2 → L3 chainyes | ./test-node.bash --init --l3node --detach

Deploy Contract to L3

cd ArbiPic/contracts

cargo stylus deploy \
    --endpoint http://127.0.0.1:3347 \
    --private-key 0xb6b15c8cb491557369f3c7d2c287b053eb229daa9c22138887752191c9520659

Add L3 to MetaMask

Pre-funded test account:

• Address: 0x3f1Eae7D46d88F08fc2F8ed27FCb2AB183EB2d0E

• Private Key: 0xb6b15c8cb491557369f3c7d2c287b053eb229daa9c22138887752191c9520659

See docs/ORBIT_L3_DEPLOYMENT.md for detailed guide.

📝 Usage Guide

Capture & Verify a Photo

1. Connect Wallet: Click “Connect Wallet” and connect MetaMask

2. Select Network: Use the network switcher (🔵 Sepolia or 🟣 Orbit L3)

3. Capture Photo: Click “📸 Capture Photo”

4. Verify On-Chain: Click “🔐 Verify On-Chain” to submit

5. View Results: Get IPFS link, transaction hash, and verification ID

6. Share: Tweet your verified photo or copy the verification link

Verify Someone Else’s Photo

1. Go to /verify page

2. Upload the image or paste the verification ID

3. System checks on-chain if the photo was verified

4. See owner address, timestamp, and ZK proof status

Prove Ownership (ZK Proof)

If you verified a photo, you can prove ownership without revealing the image:

1. Click “🔐 Prove Ownership”

2. Your locally-stored secret is used to verify against on-chain commitment

3. Cryptographic proof confirms you’re the original owner

📊 Gas Benchmarks

See docs/GAS_BENCHMARKS.md for detailed benchmarks.

🛠️ Development

Contract Development

cd contracts
cargo stylus check
cargo build --release --target wasm32-unknown-unknown
cargo stylus deploy --endpoint https://sepolia-rollup.arbitrum.io/rpc --private-key $KEY

Frontend Development

cd frontend
npm run dev       # Start dev server
npm run build     # Build for production
npm run preview   # Preview production build

🎯 What we have Achieved

🔮 Future Roadmap

• Production Orbit Chain - Deploy on mainnet L3

• Full ZK Proofs - Implement SNARKs/STARKs for complete privacy

• Batch Verification - Verify multiple photos in one transaction

• AI Detection - Integrate deepfake detection algorithms

• Mobile App - React Native version

• Cross-Chain Bridge - Verify proofs across L2/L3

Built with ❤️ 🏆

Fighting AI fakes with blockchain technology