MCPcopy Index your code
hub / github.com/TONresistor/Tonnet-Browser

github.com/TONresistor/Tonnet-Browser @v2.2.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.2.0 ↗ · + Follow
1,546 symbols 4,558 edges 318 files 186 documented · 12%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Tonnet Browser

Browse the TON Network, privately.

Windows   macOS   Linux   TON Blockchain   License

[!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

Windows macOS Linux
Installer DMG (Universal) AppImage · .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-2.2.0.exe
  2. Follow the installation prompts
  3. Launch TON Browser from the Start menu

One-line install: Open PowerShell and run:

irm https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-Setup-2.2.0.exe -OutFile TonBrowser.exe; Unblock-File TonBrowser.exe; .\TonBrowser.exe

macOS

Open the .dmg and drag TON Browser to Applications.

# If blocked by Gatekeeper
xattr -cr /Applications/TON\ Browser.app

One-line install: Open Terminal and run:

curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-2.2.0-universal.dmg && hdiutil attach TON-Browser-2.2.0-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

# AppImage
chmod +x TON-Browser-2.2.0.AppImage
./TON-Browser-2.2.0.AppImage

# Debian/Ubuntu
sudo dpkg -i TON-Browser-2.2.0.deb

One-line install: Open Terminal and run:

# AppImage
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-2.2.0.AppImage && chmod +x TON-Browser-2.2.0.AppImage && ./TON-Browser-2.2.0.AppImage

# Debian/Ubuntu
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-2.2.0.deb && sudo dpkg -i TON-Browser-2.2.0.deb

Building

Prerequisites

  • Node.js 22+
  • npm 9+
  • Go 1.24+

Development

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 - HTTP proxy, decentralized gateway
WS Bridge tonutils-bridge - JSON-RPC 2.0 over WebSocket
TON Storage tonutils-storage - P2P file storage daemon
Anonymity adnl-tunnel - garlic routing, DHT relay discovery
Transport RLDP over ADNL over UDP

Socials

License

MIT License. See LICENSE for details.

Acknowledgments

Extension points exported contracts — how you extend this code

ISecureStorage (Interface)
(no doc) [5 implementers]
src/main/ports/secure-storage.ts
ViteHotContext (Interface)
* Minimal ImportMeta.hot typing for Vite HMR cleanup. * * We intentionally do NOT `/// <reference types="vite/client"
src/renderer/src/vite-env.d.ts
Window (Interface)
(no doc)
src/preload/index.d.ts
CocoonStartParams (Interface)
(no doc)
src/shared/cocoon-types.ts
IDisposable (Interface)
(no doc) [2 implementers]
src/main/utils/disposable.ts
SettingRowProps (Interface)
* Ligne de paramètre réutilisable — style iOS (label/description ⟷ contrôle, hairline inset).
src/renderer/src/components/settings/shared/SettingRow.tsx
CocoonLogEvent (Interface)
(no doc)
src/shared/cocoon-types.ts
AddressScoped (Interface)
Value paired with the address it was fetched for, so switching wallets invalidates the cache.
src/main/wallet/ws-bridge-client.ts

Core symbols most depended-on inside this repo

getState
called by 285
src/main/wallet/manager.ts
on
called by 121
src/main/storage/daemon.ts
get
called by 107
src/main/tonconnect/session-store.ts
set
called by 87
resources/preload/tonsite.js
isBlocked
called by 85
src/main/content-filter/filter-manager.ts
emit
called by 78
src/main/storage/daemon.ts
secureHandle
called by 78
src/main/ipc/handlers/shared.ts
cn
called by 72
src/renderer/src/lib/utils.ts

Shape

Function 778
Method 451
Interface 229
Class 87
Enum 1

Languages

TypeScript100%

Modules by API surface

src/main/cocoon/contracts/wrappers/CocoonRoot.ts54 symbols
src/main/wallet/ws-bridge-client.ts50 symbols
src/main/wallet/manager.ts33 symbols
src/main/tonconnect/service.ts32 symbols
src/main/storage/daemon.ts31 symbols
src/main/wallet/key-storage.ts27 symbols
src/main/history/manager.ts24 symbols
src/main/windows/tabs.ts23 symbols
src/main/proxy/manager.ts23 symbols
src/main/cocoon/manager.ts21 symbols
src/main/windows/overlay-manager.ts19 symbols
src/main/wallet/payment-policy.ts19 symbols

For agents

$ claude mcp add Tonnet-Browser \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact