# Frame Wallet

Privacy-focused, system-wide web3 wallet for Linux.

## What is Frame?

Frame is a native OS-level wallet that provides:
- Hardware wallet support (Ledger, Trezor, GridPlus Lattice)
- Multi-chain support (Ethereum, Optimism, Arbitrum, Polygon, etc.)
- System tray integration
- No browser extension required
- Open source and auditable

## Why Frame?

**Privacy Benefits:**
- No tracking or analytics
- Open source (MIT license)
- No account required
- Works offline for signing

**Security Benefits:**
- Hardware wallet isolation from browser
- Native OS process (not a browser extension)
- System-level permission model
- No extension attack surface

## Installation

```bash
./install.sh
```

This will:
1. Install Frame from official sources
2. Create X11-mode launcher at `~/bin/frame`
3. Create desktop entry with proper Electron flags

## Display Compatibility

Frame is an Electron app. The install script forces X11 mode for stability:

```bash
--ozone-platform=x11  # Force X11 (Wayland has issues)
```

If you want to try Wayland, edit `~/bin/frame` and use:
- Auto-detect: `--ozone-platform-hint=auto`
- Pure Wayland: `--enable-features=UseOzonePlatform --ozone-platform=wayland`

## Usage

```bash
frame                    # Launch Frame
```

Then:
1. Click the Frame icon in system tray
2. Add accounts (hot wallet or hardware)
3. Connect to dapps via Frame's injected provider

## Hardware Wallet Setup

### Ledger
1. Install Ledger Live and update firmware
2. Install Ethereum app on Ledger
3. Enable "Blind signing" in Ethereum app settings
4. Connect Ledger and unlock
5. Frame will detect it automatically

### Trezor
1. Update Trezor firmware via Trezor Suite
2. Connect Trezor
3. Frame will prompt for PIN

### GridPlus Lattice
1. Pair Lattice via Frame settings
2. Frame connects over network

## Resources

- [Frame Website](https://frame.sh/)
- [Documentation](https://docs.frame.sh/)
- [GitHub](https://github.com/floating/frame)
- [Discord](https://discord.gg/frame)