README.md

Tonutils Proxy

Your gateway to the new internet

This is a user-friendly TON Proxy implementation. It works on any platform with UDP support. It can be used with any internet connection, and any type of ip.

At this moment client multi-threaded proxy is implemented, reverse-proxy for web3 sites hosting coming soon!

Join our Telegram group to stay updated! More cool products on this basis are planned.

Support project ❤️

If you love this product and want to support its development you can donate any amount of coins to this ton address ☺️ EQBx6tZZWa2Tbv6BvgcvegoOQxkRrVaBVwBOoW85nbP37_Go

Download precompiled version

• Download Mac M1 (GUI)
• Download Mac Intel (GUI)
• Download Windows (GUI)
• Download Linux (CLI)
• Other binaries

See How to use.

Integrate into your mobile app

You could compile for IOS and Android by yourself using make build-ios-lib and make build-android-lib. To compile for IOS, XCode tools and Mac are required, for Android you need NDK toolchain.

Or you could use precompiled libs.

Precompilled

• Download iOS Library
• Download Android Library

Community projects

• Swift wrapper for iOS library by @0xstragner
• Kotlin example for Android by @andreypfau

Usage

Connect it as native library to you app, and use available methods:

extern char* StartProxy(unsigned short port);
extern char* StartProxyWithConfig(unsigned short port, char* configTextJSON);
extern char* StopProxy();

StartProxy will run local http proxy server on 127.0.0.1:port. Use this server as http proxy in your webview component or in any other way.

How to use

GUI

Start it

Click big blue button, it will configure your system automatically and open foundation.ton.

If TON sites not opens

If for some reason your system was not autoconfigured or you don't want to reconfigure it, you can enter HTTP proxy address manually in your browser. Follow CLI instructions starting from section 2.

HTTP proxy uses 127.0.0.1:8080 address.

CLI

1. Open it

Double click on it on windows, or run it using terminal on linux/mac.

HTTP proxy will start on 127.0.0.1:8080 address.

If you are using GUI version, it should configure your system automatically. If you are using CLI, or you want to do a manual connection, follow steps below.

2. Connect your browser to it

Open your browser network settings and configure http proxy.

3. Try to connect to some .ton sites

Your proxy is configured now, you can access TON sites!

Lets try to connect to some ton site, for example http://foundation.ton/

By the way, this proxy works fine also for Web2 sites, you can seamlessly use it to access both Web2 and Web3.

How to build from sources

CLI version has no external dependencies, just tonutils and pure Go 🤘

go build -o ton-proxy cmd/proxy-cli/main.go

Done!

To build GUI version you need Wails.