# The Compactor

> Consolidate scattered crypto tokens across Ethereum, Base, Optimism, Arbitrum, and Polygon into a single asset on one chain. One signature per chain via EIP-7702 batch execution.

The Compactor is a free web application that helps crypto users consolidate fragmented token balances across multiple blockchain networks. Instead of manually swapping and bridging tokens chain by chain, users connect their wallets and execute all consolidation in batched transactions — one signature per chain.

## Key Features

- **Multi-chain support**: Ethereum, Base, Optimism, Arbitrum, Polygon
- **Multiple wallets**: Connect and consolidate from several wallet addresses simultaneously
- **EIP-7702 batch execution**: Bundle multiple approve + swap/bridge calls into one signature per address per chain
- **Cross-chain routing**: Powered by LI.FI SDK for optimal swap and bridge routes
- **No smart contracts**: Pure frontend application — no additional trust assumptions
- **Gas-aware**: Reserves native token gas, warns about high-fee chains, filters dust amounts

## How It Works

1. **Connect** — Link one or more EVM wallets (MetaMask, Rabby, etc.)
2. **Review** — Dashboard shows all non-zero token balances across 5 chains for all connected addresses
3. **Choose target** — Select destination chain and token (e.g., USDC on Base)
4. **Select tokens** — Pick which scattered tokens to consolidate
5. **Review plan** — See quotes grouped by address and chain, skip or restore individual routes
6. **Execute** — Sign one transaction per chain; EIP-7702 batches all approvals and swaps together

## Technical Stack

- React + TypeScript + Vite
- wagmi + viem for EVM wallet connectivity
- LI.FI SDK for cross-chain quoting and routing
- TanStack Router for client-side routing
- TanStack Query for data fetching
- Zustand for state management
- Tailwind CSS v4 with Blueprint design system

## Links

- [Website](https://thecompactor.io)

## Optional

- [LI.FI SDK Documentation](https://docs.li.fi): Cross-chain routing and bridging provider
- [EIP-7702 Specification](https://eips.ethereum.org/EIPS/eip-7702): Batch execution standard used for one-signature consolidation

> Note: Solana support is temporarily disabled and will be re-enabled in a future release.