From d2966450e1f5ef8a19bf2a8a257fe93b82b426fd Mon Sep 17 00:00:00 2001
From: Leem <leem.yang@tron.network>
Date: Thu, 5 Mar 2026 16:07:18 +0800
Subject: [PATCH 1/5] fix issues template

---
 .github/ISSUE_TEMPLATE/ask-a-question.md    |  46 +++++++-
 .github/ISSUE_TEMPLATE/report-a-bug.md      |  89 +++++++++++-----
 .github/ISSUE_TEMPLATE/request-a-feature.md | 110 ++++++++++++++++++--
 3 files changed, 203 insertions(+), 42 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/ask-a-question.md b/.github/ISSUE_TEMPLATE/ask-a-question.md
index e503998b477..12d3d3452b9 100644
--- a/.github/ISSUE_TEMPLATE/ask-a-question.md
+++ b/.github/ISSUE_TEMPLATE/ask-a-question.md
@@ -1,10 +1,50 @@
 ---
 name: Ask a question
-about: Something is unclear
-title: ''
+about: Something is unclear or needs clarification
+title: '[QUESTION] '
 labels: 'type:docs'
 assignees: ''
 
 ---
-This should only be used in very rare cases e.g. if you are not 100% sure if something is a bug or asking a question that leads to improving the documentation. For general questions please use [Discord](https://discord.gg/cGKSsRVCGm) or [Telegram](https://t.me/TronOfficialDevelopersGroupEn).
 
+<!-- 
+⚠️ IMPORTANT: Please read before submitting
+
+This template should only be used in rare cases, such as:
+- You're unsure if something is a bug or expected behavior
+- Your question could lead to documentation improvements
+- You need clarification on technical implementation details
+
+For general questions, please use our community channels:
+- Discord: https://discord.gg/cGKSsRVCGm
+- Telegram: https://t.me/TronOfficialDevelopersGroupEn
+
+These channels provide faster responses for general inquiries.
+-->
+
+## Question
+
+<!-- Clearly describe what you need clarification on -->
+
+## Context
+
+<!-- Provide relevant context that helps us understand your question -->
+
+**What are you trying to achieve?**
+<!-- Describe your goal or use case -->
+
+**What have you tried so far?**
+<!-- List any approaches or solutions you've attempted -->
+
+**Relevant documentation or code**
+<!-- Link to relevant documentation, code sections, or examples -->
+
+## Environment (if applicable)
+
+- Java-tron version: <!-- e.g., 4.7.4 -->
+- Operating System: <!-- e.g., Ubuntu 20.04 -->
+- Java version: <!-- e.g., OpenJDK 1.8.0_161 -->
+
+## Additional Information
+
+<!-- Any other details that might be helpful -->
diff --git a/.github/ISSUE_TEMPLATE/report-a-bug.md b/.github/ISSUE_TEMPLATE/report-a-bug.md
index a0d68121565..3ef08a0dee2 100644
--- a/.github/ISSUE_TEMPLATE/report-a-bug.md
+++ b/.github/ISSUE_TEMPLATE/report-a-bug.md
@@ -1,50 +1,83 @@
 ---
 name: Report a bug
 about: Create a report to help us improve
-title: ''
+title: '[BUG] '
 labels: 'type:bug'
 assignees: ''
 
 ---
 
-<!-- Have you done the following? -->
-<!--   * Reproduced the issue in the latest version of the software -->
-<!--   * Duplicate Issue check:  https://github.com/search?q=+is%3Aissue+repo%3Atronprotocol/java-tron -->
+<!-- 
+⚠️ Before submitting, please ensure you have:
+✓ Reproduced the issue in the latest version of java-tron
+✓ Checked for duplicate issues: https://github.com/search?q=+is%3Aissue+repo%3Atronprotocol/java-tron
+✓ Reviewed the documentation: https://tronprotocol.github.io/documentation-en/introduction/
+-->
 
-#### Software Versions
-<!-- `java -jar FullNode.jar -v` -->
+## Bug Description
+
+<!-- Provide a clear and concise description of the bug -->
+
+## Environment
+
+**Software Versions**
+<!-- Run `java -jar FullNode.jar -v` to get version information -->
 
-<!-- 
 ```
-OS : Linux
-JVM : Oracle Corporation 1.8.0_161 amd64
-Git : b1fc2f0f2bd79527099bc3027b9aba165c2e20c2
-Version : 4.7.4
-Code : 18260
+OS: <!-- e.g., Ubuntu 20.04, macOS 12.0, Windows 11 -->
+JVM: <!-- e.g., Oracle Corporation 1.8.0_161 amd64 -->
+Git Commit: <!-- e.g., b1fc2f0f2bd79527099bc3027b9aba165c2e20c2 -->
+Version: <!-- e.g., 4.7.4 -->
+Code: <!-- e.g., 18260 -->
 ```
--->
 
-#### Expected behaviour
-<!--[What you expect to happen] -->
+**Configuration**
+<!-- If relevant, describe your node configuration (e.g., FullNode, SolidityNode, witness settings) -->
+
+## Expected Behavior
+
+<!-- Describe what you expected to happen -->
+
+## Actual Behavior
 
+<!-- Describe what actually happened -->
 
-#### Actual behaviour
-<!--[What you expect to happen] -->
+## Frequency
 
+<!-- How often does this issue occur? -->
+- [ ] Always (100%)
+- [ ] Frequently (>50%)
+- [ ] Sometimes (10-50%)
+- [ ] Rarely (<10%)
 
-#### Frequency
-<!-- [What percentage of the time does it occur?] -->
+## Steps to Reproduce
+
+<!-- Provide detailed steps to reproduce the issue -->
+
+1. 
+2. 
+3. 
+
+## Logs and Error Messages
+
+<!-- 
+⚠️ IMPORTANT: Submit logs as text, not screenshots
+Include relevant logs from FullNode.jar or other components
+-->
+
+```
+[Paste error messages, stack traces, or relevant logs here]
+```
 
-#### Steps to reproduce the behaviour
+## Additional Context
 
-1. [Step 1]
-2. [Step 2]
-3. [Step ...]
+<!-- Add any other context about the problem -->
 
-#### Backtrace
+**Screenshots**
+<!-- If applicable, add screenshots to help explain the problem -->
 
-````
-[backtrace]
-````
+**Related Issues**
+<!-- Link to any related issues or pull requests -->
 
-When submitting logs: please submit them as text and not screenshots.
+**Possible Solution**
+<!-- If you have suggestions on how to fix the bug, describe them here -->
diff --git a/.github/ISSUE_TEMPLATE/request-a-feature.md b/.github/ISSUE_TEMPLATE/request-a-feature.md
index 261f1088ded..0b8d3b3289d 100644
--- a/.github/ISSUE_TEMPLATE/request-a-feature.md
+++ b/.github/ISSUE_TEMPLATE/request-a-feature.md
@@ -1,28 +1,116 @@
 ---
 name: Request a feature
 about: Suggest an idea for this project
-title: ''
+title: '[FEATURE] '
 labels: 'type:feature'
 assignees: ''
 
 ---
-# Background
 
-# Rationale
+<!-- 
+Thank you for contributing to java-tron! 
+Please provide as much detail as possible to help us evaluate your feature request.
+-->
 
-Why should this feature exist?
+## Background
 
-What are the use-cases?
+<!-- Describe the context and motivation for this feature request -->
 
-# Specification
+## Problem Statement
 
-# Test Specification
+<!-- What problem does this feature solve? What pain points does it address? -->
 
-# Scope Of Impact
+## Rationale
 
+**Why should this feature exist?**
+<!-- Explain the benefits and value this feature would provide -->
 
-# Implementation
+**What are the use cases?**
+<!-- Describe specific scenarios where this feature would be useful -->
 
-Do you have ideas regarding the implementation of this feature?
+1. 
+2. 
+3. 
 
-Are you willing to implement this feature?
+**Who would benefit from this feature?**
+<!-- e.g., node operators, developers, end users, validators -->
+
+## Proposed Solution
+
+<!-- Describe your proposed solution in detail -->
+
+### Specification
+
+<!-- Provide technical specifications or requirements -->
+
+**API Changes** (if applicable)
+<!-- Describe any new or modified APIs -->
+
+**Configuration Changes** (if applicable)
+<!-- Describe any new configuration options -->
+
+**Protocol Changes** (if applicable)
+<!-- Describe any changes to the TRON protocol -->
+
+## Testing Strategy
+
+<!-- How should this feature be tested? -->
+
+**Test Scenarios**
+1. 
+2. 
+3. 
+
+**Performance Considerations**
+<!-- Describe any performance implications -->
+
+## Scope of Impact
+
+<!-- What parts of the system will be affected? -->
+
+- [ ] Core protocol
+- [ ] API/RPC
+- [ ] Database
+- [ ] Network layer
+- [ ] Smart contracts
+- [ ] Documentation
+- [ ] Other: <!-- specify -->
+
+**Breaking Changes**
+<!-- Will this feature introduce any breaking changes? -->
+
+**Backward Compatibility**
+<!-- How will this feature maintain backward compatibility? -->
+
+## Implementation
+
+**Do you have ideas regarding the implementation?**
+<!-- Share any technical approaches or implementation details -->
+
+**Are you willing to implement this feature?**
+<!-- Let us know if you'd like to contribute the implementation -->
+- [ ] Yes, I can implement this feature
+- [ ] I can help with implementation
+- [ ] I need help with implementation
+- [ ] I'm just suggesting the idea
+
+**Estimated Complexity**
+<!-- Your assessment of implementation complexity -->
+- [ ] Low (minor changes)
+- [ ] Medium (moderate changes)
+- [ ] High (significant changes)
+- [ ] Unknown
+
+## Alternatives Considered
+
+<!-- Describe any alternative solutions or features you've considered -->
+
+## Additional Context
+
+<!-- Add any other context, mockups, diagrams, or examples -->
+
+**Related Issues/PRs**
+<!-- Link to any related issues or pull requests -->
+
+**References**
+<!-- Link to any relevant documentation, specifications, or discussions -->

From de848ce8f141c031e9d023a1d5239338f4246138 Mon Sep 17 00:00:00 2001
From: Leem <leem.yang@tron.network>
Date: Thu, 5 Mar 2026 17:44:19 +0800
Subject: [PATCH 2/5] fix java version example

---
 .github/ISSUE_TEMPLATE/ask-a-question.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/ask-a-question.md b/.github/ISSUE_TEMPLATE/ask-a-question.md
index 12d3d3452b9..c5fe429563f 100644
--- a/.github/ISSUE_TEMPLATE/ask-a-question.md
+++ b/.github/ISSUE_TEMPLATE/ask-a-question.md
@@ -43,7 +43,7 @@ These channels provide faster responses for general inquiries.
 
 - Java-tron version: <!-- e.g., 4.7.4 -->
 - Operating System: <!-- e.g., Ubuntu 20.04 -->
-- Java version: <!-- e.g., OpenJDK 1.8.0_161 -->
+- Java version: <!-- e.g., java version "1.8.0_391" -->
 
 ## Additional Information
 

From 32589257bf5bc540cddef27bc8a943df177bc30c Mon Sep 17 00:00:00 2001
From: Leem <leem.yang@tron.network>
Date: Thu, 5 Mar 2026 17:49:11 +0800
Subject: [PATCH 3/5] Standardize the writing style of java-tron

---
 .github/ISSUE_TEMPLATE/ask-a-question.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/ask-a-question.md b/.github/ISSUE_TEMPLATE/ask-a-question.md
index c5fe429563f..25062860ddd 100644
--- a/.github/ISSUE_TEMPLATE/ask-a-question.md
+++ b/.github/ISSUE_TEMPLATE/ask-a-question.md
@@ -41,7 +41,7 @@ These channels provide faster responses for general inquiries.
 
 ## Environment (if applicable)
 
-- Java-tron version: <!-- e.g., 4.7.4 -->
+- java-tron version: <!-- e.g., 4.7.4 -->
 - Operating System: <!-- e.g., Ubuntu 20.04 -->
 - Java version: <!-- e.g., java version "1.8.0_391" -->
 

From 087ea6ce575a8bb0d505fc8a1d684009faca96be Mon Sep 17 00:00:00 2001
From: Leem <leem.yang@tron.network>
Date: Fri, 6 Mar 2026 11:36:57 +0800
Subject: [PATCH 4/5] add network type in Environment

---
 .github/ISSUE_TEMPLATE/ask-a-question.md | 1 +
 .github/ISSUE_TEMPLATE/report-a-bug.md   | 3 +++
 2 files changed, 4 insertions(+)

diff --git a/.github/ISSUE_TEMPLATE/ask-a-question.md b/.github/ISSUE_TEMPLATE/ask-a-question.md
index 25062860ddd..70c957fe92f 100644
--- a/.github/ISSUE_TEMPLATE/ask-a-question.md
+++ b/.github/ISSUE_TEMPLATE/ask-a-question.md
@@ -41,6 +41,7 @@ These channels provide faster responses for general inquiries.
 
 ## Environment (if applicable)
 
+- Network: <!-- e.g., Mainnet -->
 - java-tron version: <!-- e.g., 4.7.4 -->
 - Operating System: <!-- e.g., Ubuntu 20.04 -->
 - Java version: <!-- e.g., java version "1.8.0_391" -->
diff --git a/.github/ISSUE_TEMPLATE/report-a-bug.md b/.github/ISSUE_TEMPLATE/report-a-bug.md
index 3ef08a0dee2..a00d6a51dee 100644
--- a/.github/ISSUE_TEMPLATE/report-a-bug.md
+++ b/.github/ISSUE_TEMPLATE/report-a-bug.md
@@ -20,6 +20,9 @@ assignees: ''
 
 ## Environment
 
+**Network**
+<!-- Specify the network type: Mainnet, Testnet, or Private network -->
+
 **Software Versions**
 <!-- Run `java -jar FullNode.jar -v` to get version information -->
 

From f1ed84664115dd3195a9e9d92a0eb70a323f4cc9 Mon Sep 17 00:00:00 2001
From: Leem <leem.yang@tron.network>
Date: Fri, 6 Mar 2026 11:38:13 +0800
Subject: [PATCH 5/5] fix format of "Test Scenarios"

---
 .github/ISSUE_TEMPLATE/request-a-feature.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/ISSUE_TEMPLATE/request-a-feature.md b/.github/ISSUE_TEMPLATE/request-a-feature.md
index 0b8d3b3289d..b7f456cf263 100644
--- a/.github/ISSUE_TEMPLATE/request-a-feature.md
+++ b/.github/ISSUE_TEMPLATE/request-a-feature.md
@@ -57,6 +57,7 @@ Please provide as much detail as possible to help us evaluate your feature reque
 <!-- How should this feature be tested? -->
 
 **Test Scenarios**
+
 1. 
 2. 
 3.