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 dependencies
cd frontend && npm install

# Build Rust contract
cd ../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 chain
yes | ./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

🔑 Smart Contract API

Stylus Contract (Rust)

fn verify_photo(photo_hash: U256, zk_commitment: U256) -> U256
fn get_attestation(photo_hash: U256) -> (U256, Address, U256)
fn is_verified(photo_hash: U256) -> bool
fn verify_zk_proof(photo_hash: U256, secret: U256) -> bool
fn get_owner_of(photo_hash: U256) -> Address
fn get_photo_count() -> U256

ABI (Solidity-compatible)

function verifyPhoto(uint256 photoHash, uint256 zkCommitment) returns (uint256)
function getAttestation(uint256 photoHash) view returns (uint256, address, uint256)
function isVerified(uint256 photoHash) view returns (bool)
function verifyZkProof(uint256 photoHash, uint256 secret) view returns (bool)
function getOwnerOf(uint256 photoHash) view returns (address)
function getPhotoCount() view returns (uint256)

📊 Gas Benchmarks

See docs/GAS_BENCHMARKS.md for detailed benchmarks.

📁 Project Structure

ArbiPic/
├── contracts/                    # Rust Stylus smart contract
│   ├── src/
│   │   ├── lib.rs               # Main contract code
│   │   └── main.rs              # ABI export
│   ├── solidity/
│   │   └── PhotoVerifierSolidity.sol
│   ├── Cargo.toml
│   └── Stylus.toml
├── frontend/                     # React frontend
│   ├── src/
│   │   ├── components/
│   │   │   ├── Header.tsx
│   │   │   ├── NetworkSwitcher.tsx
│   │   │   ├── PhotoCaptureEnhanced.tsx
│   │   │   └── VerifyPage.tsx
│   │   ├── utils/
│   │   │   ├── zkProof.ts
│   │   │   ├── ipfs.ts
│   │   │   ├── verification.ts
│   │   │   └── eas.ts
│   │   ├── config.ts
│   │   └── App.tsx
│   ├── package.json
│   └── vite.config.ts
├── docs/
│   ├── GAS_BENCHMARKS.md
│   └── ORBIT_L3_DEPLOYMENT.md
├── scripts/
│   ├── deploy.sh
│   └── benchmark.sh
└── README.md

🛠️ 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

💡 Why Stylus?

🎯 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

🔗 Resources

• Stylus Documentation
• Arbitrum Orbit
• Cargo Stylus CLI
• Wagmi Documentation
• Pinata IPFS

Built with ❤️ 🏆

Fighting AI fakes with blockchain technology