🐮 METACOW — SOCIAL DEFI TRADING WITH IDENTITY & REWARDS

MetaCow is a decentralized exchange that blends token swaps, liquidity provisioning, and social trading into a unified on-chain identity experience.
Built entirely during the MetaMask Card Dev Cook-Off hackathon, MetaCow aims to explore real-world card use cases through wallet-based reputation, USDC rewards, and copy trading.

Live Demo: https://metacow.vercel.app
Video Demo: https://youtu.be/mpHBX2n_N4s?feature=shared
Chain: Sepolia Testnet

Deployer Address: 0xF8A440f0c3912F42dF794983B8164cB6572fCBCC
Pair Logic Contract: 0x08B31808f3E5f3B2Ce90b4067D475F92D02ceE31
Factory Proxy Contract: 0x3048E6BFA6D505ad07D29284b6bA22521A80D06F
Circle USDC Token (Testnet): 0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238

🚀 WHAT WE BUILT

MetaCow is more than a DEX — it’s a social finance platform powered by on-chain identity.
It transforms every wallet into a reputation-based identity hub.

Key Capabilities:

• Swap tokens, including USDC

• Add liquidity and earn LP rewards

• Follow and copy top-performing wallets

• Build a reputation score

• Claim tokens via MetaCow Faucet and Circle USDC Faucet

🔐 INTEGRATION HIGHLIGHTS

• MetaMask SDK: Enables seamless wallet connection and transaction signing

• Circle USDC: Fully supported for stablecoin swaps and liquidity pairs

• Upgradeable Smart Contracts: Built using OpenZeppelin's proxy standard

🎯 REAL-WORLD RELEVANCE

• Card-linked Identity: Profiles with on-chain activity, avatar, and rep score

• Stablecoin Usage: Full USDC support for secure, real-world financial flows

• DeFi Rewards: LP participation contributes to rewards and user rank

• Copy Trade Triggers: Users can replicate successful trades in one click

• Social Finance Layer: Follow wallets, compare profiles, track reputations

🧩 CORE FEATURES

• Token Swapping: ETH ⇄ USDC and other ERC20 tokens

• Liquidity Provision: Add/remove liquidity and earn LP tokens

• Social Trading: View, follow, and copy trades from active wallets

• Reputation System: Score based on swaps, LP, and engagement

• Faucet Integration: Claim tokens from MetaCow or Circle USDC faucet

• MetaMask SDK: Full support for secure wallet-based identity

• Upgradeable Contracts: Transparent Proxy pattern using Hardhat

🔧 TECH STACK

• Frontend: React, Tailwind CSS, Ethers.js, MetaMask SDK

• Smart Contracts: Solidity, Hardhat, OpenZeppelin (Proxy, ERC20)

• Chain: Sepolia (Ethereum testnet)

• Backend: MongoDB (for tracking social graph, scores, and user data)

🧪 HOW TO RUN LOCALLY

1. Install Dependencies:

CopyEdit

npm install

2. Create a .env file:

CopyEdit

VITE_FACTORY_ADDRESS=0x3048E6BFA6D505ad07D29284b6bA22521A80D06F VITE_CHAIN_ID=11155111 VITE_CIRCLE_FAUCET_URL=https://faucet.circle.com/

3. Start the Frontend:

   npm run dev

4. (Optional) Deploy Contracts:

   npx hardhat deploy --network sepolia