java-tron Documentation

java-tron is the official Java implementation of the TRON network client, developed and maintained by the TRON protocol team and fully open source. It implements the complete TRON mainnet protocol, including DPoS consensus, the TVM, the account and resource models, smart contracts, the decentralized exchange, and multi-signature permission management — the foundational software for running full nodes, participating in Super Representative elections, deploying contracts, and building DApps.

This documentation is written for java-tron node operators, protocol researchers, DApp developers, and core contributors. It covers the full path from node deployment, network connectivity, and API usage to protocol mechanics and source contribution. Source and releases: github.com/tronprotocol/java-tron.

Choose your entry point

• Getting Started

  ---

  New to java-tron or the TRON protocol? Begin with the guided learning sequence, then use the consensus overview and glossary as references.

  • Get Started
  • Hands-on Getting Started Guide
  • TRON Consensus (DPoS)
  • Glossary

• Run a Node

  ---

  Guides for java-tron deployment, configuration, connectivity, logging, monitoring, storage, backup, and maintenance.

  • Node Operations Overview
  • Deploy java-tron
  • Node Configuration
  • Node Logging
  • Node Monitoring
  • Upgrade to a New Version
  • Private Network

• DApp Development

  ---

  Smart-contract development, java-tron APIs, and command-line tools for building DApps on TRON.

  • Build DApps with java-tron
  • Choose an API
  • HTTP API
  • JSON-RPC API
  • gRPC API
  • Smart Contracts
  • wallet-cli

• Contribute to Core

  ---

  Guides for contributing to java-tron, configuring a development environment, understanding CI and the codebase, and following issue, TIP, and network-governance processes.

  • Contributor Overview
  • Developer Guide
  • TIPs Workflow
  • Configure the IDE
  • Core Modules

Browse by topic

• Get started — A hands-on path for creating a TRON account, starting and verifying a java-tron node, and sending transactions or querying chain data with wallet-cli or cURL
• Operate a node — Guides for java-tron deployment, configuration, connectivity, logging, monitoring, storage, backup, and maintenance
• API reference — Guidance for choosing among the HTTP, JSON-RPC, and gRPC interfaces, plus reference indexes and machine-readable definitions
• wallet-cli — A command-line wallet for TRON and selected EVM networks — interactive in Java, agent-first in TypeScript
• Understand the protocol — Documentation about TRON consensus, Super Representatives, accounts and signatures, network resources, system contracts, and account permissions
• Contribute to java-tron — Guides for contributing to java-tron, configuring a development environment, understanding CI and the codebase, and following issue, TIP, and network-governance processes
• Build DApps — Smart-contract development and developer tools for building DApps on TRON
• Releases — Node upgrade procedures, release-package signature verification, and version history
• Appendix — Definitions of common TRON and java-tron terms

Other resources

• TRON Whitepaper — Official document on TRON's protocol design and vision
• TRON Improvement Proposals (TIPs) — Repository for submitting, discussing, and archiving protocol evolution proposals
• TRON Developer Hub — DApp developer documentation, SDKs, and tutorials
• TRON Official Site — Project updates, ecosystem partners, and community entry points

Documentation source of truth

This English repository (documentation-en) is the authoritative source for java-tron documentation. The Chinese documentation (documentation-zh) is a translation that follows it. When the two diverge, the English version takes precedence; content changes should be made against the English source first and then propagated to the translation.

---