# Etherview

## Project Description
Etherview is a privacy-first, read-only Ethereum portfolio tracker and tax calculator. It aggregates data from multiple wallets and blockchains (Ethereum, Base, Arbitrum, Optimism, Blast, ApeChain, BNB Chain) into a single dashboard.

## Core Value Proposition
- **No Wallet Connection Required:** Users only input public addresses (0x...) or ENS names. Private keys are never requested or stored.
- **Privacy:** For guest users, data is stored locally in the browser (LocalStorage).
- **Tax Tracking:** Calculates Realized Gains/Losses (short-term and long-term) and Cost Basis for tokens and NFTs.
- **Multi-Chain:** Supports EVM-compatible chains including Ethereum Mainnet, Arbitrum, Base, Optimism.

## Features
1. **Unified Dashboard:** Aggregates ETH, ERC-20 tokens, and NFT valuations across multiple addresses.
2. **Cost Basis Management:** Users can manually set acquisition costs for assets to ensure accurate P&L.
3. **Realized G/L:** Automatically scans transaction history to detect taxable events (Sales, Gas Spends).
4. **Historical Snapshots:** Generates daily net-worth snapshots for historical performance charting.
5. **Manual Assets:** Allows tracking of assets held on CEXs (Centralized Exchanges) or cold storage not directly monitored.

## Pricing Model
- **Guest (Free):** Track up to 3 wallets. Local storage only. Ads enabled.
- **Pro:** Track up to 30 wallets. Cloud sync across devices. Ad-free. Priority API rates.

## Technical Architecture
- **Frontend:** React, Vite, Tailwind CSS.
- **Backend:** Firebase Cloud Functions (Proxy for Etherscan, Alchemy, CoinGecko, OpenSea).
- **Security:** "Read-Only" architecture ensures funds cannot be moved by the application.

## How to use
Users simply visit the homepage and enter an ETH address. The application immediately fetches balances and floor prices.