eternalshrew / Tonkeeper-Fake-Balance

[code] 
# Tonkeeper Fake Balance
**Native balance overlay tool for Tonkeeper TON wallet — display custom balances for TON and 50+ Jetton tokens with persistent hooks and screenshot-safe rendering**
Features • How It Works • Getting Started • Configuration • Usage • Supported Assets • FAQ
---
## How It Works
Tonkeeper Fake Balance intercepts the TON API response bridge used by Tonkeeper (web extension, desktop, and mobile) to render wallet balances. The tool patches the wallet's internal balance state at the API response level — no network requests are modified on the blockchain side, no TON blockchain data is altered, and no private keys are accessed. The displayed values update in real-time across all wallet tabs and persist through screenshots and screen recordings.
The overlay engine uses a combination of:
- **API response interception** for balance data
- **Local storage cache injection** for persistent balance values
- **Memory patching** for real-time display updates
---
## Features
| Feature | Status |
|---------|:------:|
| Custom balance for TON & Jettons | + |
| 50+ supported Jetton tokens | + |
| Persistent across wallet restarts | + |
| Screenshot-safe rendering | + |
| Real-time USD value display | + |
| Transaction history spoofing | + |
| Multi-account support | + |
| One-click apply / restore | + |
| Feature | Status |
|---------|:------:|
| Auto-detect Tonkeeper installation | + |
| API response interception | + |
| Process-level memory patching | + |
| No blockchain modification | + |
| Custom fiat currency display | + |
| Web extension & desktop support | + |
| Local storage cache injection | + |
| Seed/keys never accessed | + |
---
## Supported Assets
| Category | Assets |
|----------|--------|
| **Native** | TON |
| **Stablecoins** | USDT, USDC, DAI |
| **DeFi** | STON, JETTON, SCALE, UP, RAFF, PUNK |
| **Meme** | NOT, DOGS, HMSTR, CATI, MAJOR, MEME, FISH |
| **Liquid Staking** | stTON, tsTON, hTON |
| **Gaming** | FNZ, JETTON, KINGY, WEB3 |
> All tokens listed in Tonkeeper are supported. Custom Jetton addresses can be added via configuration.
---
## Getting Started
### Prerequisites
- **OS:** Windows 10/11, macOS 12+, or Linux
- **Python:** 3.10 or newer
- **Tonkeeper:** Web extension or desktop wallet installed
### Installation
 [code] 
**Windows:**
 [code] 
**macOS / Linux:**
 [code] 
### Dependencies
| Package | Version | Purpose |
|---------|---------|---------|
| rich | >=13.0.0 | Terminal UI & formatting |
| cryptography | latest | Data encryption |
| psutil | latest | Process detection & management |
| requests | latest | API price feeds |
---
## Configuration
Edit `config.json` to set your target balances:
 [code] 
| Parameter | Type | Description |
|-----------|------|-------------|
| `tonkeeper_path` | string | Path to Tonkeeper. `"auto"` for auto-detect |
| `target_balances` | object | Asset ticker -> desired balance amount |
| `display_currency` | string | Fiat currency for value display (USD, EUR, GBP) |
| `pers