Unveiling MyLocalTon: A Comprehensive Guide to Your Local TON Blockchain Application

Abstract:

With the advent of blockchain technology, numerous platforms have emerged, yet TON Blockchain stands out with its unique features and capabilities. This article delves into MyLocalTon, a cross-platform desktop application that brings the TON Blockchain to your fingertips. Through an in-depth analysis and comparison, we aim to provide a thorough understanding of this tool, its compatibility with different operating systems (OS) and Java versions, and guide users on installation, usage, and building from sources.


1. Introduction to MyLocalTon

MyLocalTon offers a personalized experience of the TON Blockchain (www.ton.org) in the form of a cross-platform desktop application. It encapsulates all necessary dependencies and binaries within an uber-jar, making it a versatile tool for developers and enthusiasts alike. Although currently in its alpha stage and not yet production-ready, MyLocalTon signifies a leap towards accessible and user-friendly blockchain interactions.

2. Compatibility Matrix

Understanding the compatibility of MyLocalTon with various operating systems and Java versions is crucial for users. The table below outlines the supported configurations, ensuring users can effectively match their system requirements:

OS \ Java Version 11 13 15 17 19
Linux x86_64 :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
Linux arm64/aarch64 :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
MacOS x86_64 (12+) :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
MacOS arm64/aarch64 :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
Windows x86_64 :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:

Note: Ensure your Java version is not headless and matches the OS/Java combination as per the table for optimal performance.


3. Installation Instructions

For MacOS Users: Special instructions for MacPorts users are provided to ensure compatibility.

Java Installation: A guide for installing OpenJDK 17 across different platforms (Ubuntu, Windows, MacOS) is included for users unfamiliar with Java setup.

Microsoft Visual C++ Redistributable: Windows users are instructed to install the Microsoft Visual C++ Redistributable 2015 or above to ensure the application runs smoothly.

Application Download and Execution: Users are directed to download MyLocalTon from the official GitHub releases page and execute it through the console with the appropriate command for their architecture.


4. Upgrade Process

Currently, MyLocalTon does not support direct upgrades. Users are advised to manually replace the application with its newer version and remove the existing MyLocalTon directory.


5. Building from Sources

A step-by-step guide for building MyLocalTon from sources is provided for all platforms, including common actions such as installing OpenJDK, IntelliJ IDEA Community Edition, and SceneBuilder. Specific instructions for compiling and running the application within IntelliJ IDEA are also detailed.


6. Optional: Manual TON-HTTP-API Installation

For users seeking to extend their MyLocalTon application, instructions for installing the TON-HTTP-API on Linux, MacOS, and Windows are provided. This addition enhances the application’s capabilities by integrating HTTP API functionalities.


Conclusion

MyLocalTon represents a significant advancement in making TON Blockchain accessible to a broader audience. By following the guidelines and utilizing the compatibility matrix provided, users can seamlessly integrate this powerful blockchain technology into their desktop environment, paving the way for innovative developments in the blockchain space.


References:

Through this tool, you can build a private network of the TON blockchain locally. Of course, I have also seen people connect mylocalton to the main network and test network.