Practical overview
When it fits
Use Ton4J when building TON functionality into Java software and when you need to select specific modules for blockchain access, data handling, wallets, or smart-contract work.
Who it is for
- Java developers integrating TON into applications or backend services.
- Developers building or inspecting TON smart contracts and related workflows.
Documented uses
- Connect Java code to TON through Tonlib, an ADNL lite-client, or TonCenter API clients.
- Create and parse wallet addresses, generate deterministic keys, and work with accounts, transactions, messages, and balances.
- Construct and parse Bag of Cells and serialize or deserialize TON data structures.
- Create, deploy, and interact with smart contracts, including workflows involving NFTs and jettons.
- Export TON database data through the exporter module.
Requirements & limits
Requires Java 11 or later. The README documents Maven Central and JitPack dependency options. Ton4J is licensed under GPL-3.0.
- Choose among Tonlib shared-library, ADNL lite-client, and TonCenter API connection routes according to the integration you need.
- Tonlib, emulator, Fift, Func, and Tolk wrappers can require external libraries or precompiled binaries.
- The repository is modular, and its README says submodules can be used individually.
- The README recommends considering an API key for production use with TonCenter.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Add the ton4j smartcontract module with Maven
Declare the ton4j smartcontract module as a dependency in a Java project.
Before you start
- Java 11 or later
- A Maven project
Steps
Add the dependency with groupId
org.ton.ton4j, artifactIdsmartcontract, and version2.2.0to the project’s Maven configuration.Resolve the dependency through Maven Central.
Expected outcome
The project configuration declares ton4j’s smartcontract module as a dependency.
Guide limitations
- This guide covers dependency configuration only; it does not cover connecting to TON or executing blockchain operations.
- The README also documents a JitPack option, but this recipe uses the Maven Central dependency.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 11 October 2026
- Original website title
- ton-blockchain/ton4j · Official homepage title · retained in its source language

