https://github.com/tonresistor/tonnet-browser
Native browser for the TON Network with garlic routing and TON Storage integration
https://github.com/tonresistor/tonnet-browser
anti-fingerprinting blockchain browser cross-platform decentralized desktop-app electron garlic-routing open-source privacy privacy-browser ton ton-blockchain ton-network ton-proxy ton-storage web3
Last synced: about 1 month ago
JSON representation
Native browser for the TON Network with garlic routing and TON Storage integration
- Host: GitHub
- URL: https://github.com/tonresistor/tonnet-browser
- Owner: TONresistor
- License: mit
- Created: 2026-01-01T08:54:16.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-20T06:03:36.000Z (about 1 month ago)
- Last Synced: 2026-04-20T07:37:02.425Z (about 1 month ago)
- Topics: anti-fingerprinting, blockchain, browser, cross-platform, decentralized, desktop-app, electron, garlic-routing, open-source, privacy, privacy-browser, ton, ton-blockchain, ton-network, ton-proxy, ton-storage, web3
- Language: TypeScript
- Size: 30.3 MB
- Stars: 22
- Watchers: 0
- Forks: 2
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Tonnet Browser
Browse the TON Network, privately.
---
> [!CAUTION]
> **No external security audit.** This browser and its embedded wallet have not undergone a third-party audit. The code is open-source and subject to internal reviews, but has not been independently verified. Use at your own risk;
## About
Tonnet Browser is a native desktop browser for the TON Network. It resolves `.ton`, `.t.me`, `.adnl`, `.eth` (ENS), and `.sol` (SNS) through decentralized DNS and delivers content over RLDP directly from the network.
All traffic goes through ADNL, either peer-to-peer or via multi-hop tunnels. A WebSocket bridge connects directly to the TON blockchain, removing any dependency on centralized APIs like TonCenter or TonAPI. Anti-fingerprinting, per-domain isolation, and built-in TON Storage are included out of the box. No telemetry, no tracking, fully open source.
## Features
Browsing
.ton .t.me .adnl
TON Storage Bags
+ more TLDs
Wallet
W5 v5r1, send/receive
HTTP 402 micropayments
Privacy
Garlic routing
Anti-fingerprinting
Per-domain isolation
No telemetry
Storage
TON Storage P2P
File browser
Download & seed
Bridge
WebSocket JSON-RPC
Direct to TON
No centralized API dependency
Security
Process sandboxing
SSRF protection
IPC hardening
Encrypted history
Routing
DHT relay discovery
Direct or multi-hop
Censorship-resistant
Fingerprint
Canvas, WebGL, Audio
WebRTC leak blocking
Generic User-Agent
## Installation
|  |  |  |
|:---:|:---:|:---:|
| [Installer](https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-Setup-1.6.2.exe) | [DMG (Universal)](https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-1.6.2-universal.dmg) | [AppImage](https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-1.6.2.AppImage) · [.deb](https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-1.6.2.deb) |
### Windows
Your browser may warn that the file is from an unknown source. Click **"Keep"** to download.
1. Download and run **TON-Browser-Setup-1.6.2.exe**
2. Follow the installation prompts
3. Launch **TON Browser** from the Start menu
**One-line install:** Open PowerShell and run:
```powershell
irm https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-Setup-1.6.2.exe -OutFile TonBrowser.exe; Unblock-File TonBrowser.exe; .\TonBrowser.exe
```
### macOS
Open the `.dmg` and drag TON Browser to Applications.
```bash
# If blocked by Gatekeeper
xattr -cr /Applications/TON\ Browser.app
```
**One-line install:** Open Terminal and run:
```bash
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-1.6.2-universal.dmg && hdiutil attach TON-Browser-1.6.2-universal.dmg && cp -R "/Volumes/TON Browser/TON Browser.app" /Applications/ && hdiutil detach "/Volumes/TON Browser" && xattr -cr /Applications/TON\ Browser.app && open /Applications/TON\ Browser.app
```
### Linux
```bash
# AppImage
chmod +x TON-Browser-1.6.2.AppImage
./TON-Browser-1.6.2.AppImage
# Debian/Ubuntu
sudo dpkg -i TON-Browser-1.6.2.deb
```
**One-line install:** Open Terminal and run:
```bash
# AppImage
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-1.6.2.AppImage && chmod +x TON-Browser-1.6.2.AppImage && ./TON-Browser-1.6.2.AppImage
# Debian/Ubuntu
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-1.6.2.deb && sudo dpkg -i TON-Browser-1.6.2.deb
```
## Building
### Prerequisites
- Node.js 22+
- npm 9+
- Go 1.24+
### Development
```bash
git clone https://github.com/TONresistor/Tonnet-Browser.git
cd Tonnet-Browser
npm install
bash scripts/build-binaries-from-source.sh
npm run dev
```
## Tech Stack
| Component | Technology |
| ----------- | --------------------------------------------------------------------------------------------------- |
| Framework | Electron 41 |
| Frontend | React 19, TypeScript |
| Styling | Tailwind CSS v4 |
| State | Zustand |
| TON Proxy | [Tonutils-Proxy](https://github.com/TONresistor/Tonutils-Proxy) - HTTP proxy, decentralized gateway |
| WS Bridge | [tonutils-bridge](https://github.com/TONresistor/tonutils-bridge) - JSON-RPC 2.0 over WebSocket |
| TON Storage | [tonutils-storage](https://github.com/xssnick/tonutils-storage) - P2P file storage daemon |
| Anonymity | [adnl-tunnel](https://github.com/ton-blockchain/adnl-tunnel) - garlic routing, DHT relay discovery |
| Transport | RLDP over ADNL over UDP |
## Socials
- **Website**: [tonnet.resistance.dog](https://tonnet.resistance.dog)
- **Community**: [@ResistanceForum](https://t.me/ResistanceForum)
- **Channel**: [@ResistanceTools](https://t.me/ResistanceTools)
## License
MIT License. See [LICENSE](LICENSE) for details.
## Acknowledgments
- [Tor Project](https://www.torproject.org/) - Inspiration for anonymous browsing
- [BitTorrent](https://www.bittorrent.org/) - Inspiration for P2P file sharing
- [tonutils-go](https://github.com/xssnick/tonutils-go) - TON protocol implementation
- [Tonutils-Proxy](https://github.com/TONresistor/Tonutils-Proxy) - HTTP proxy for decentralized .ton site access
- [tonutils-bridge](https://github.com/TONresistor/tonutils-bridge) - WebSocket-ADNL bridge for wallet and blockchain queries
- [adnl-tunnel](https://github.com/ton-blockchain/adnl-tunnel) - Garlic routing relay for anonymous browsing
- [tonutils-storage](https://github.com/xssnick/tonutils-storage) - TON Storage daemon