Merge branch 'develop' into develop

Author: FriendlyCM

README.md

@@ -16,16 +16,26 @@ Monitor the health and performance of your TRON nodes with integrated **Promethe
 ### 🛠️ Tools
 We also provide tools to facilitate the CI and testing process:
 - **Gradle Docker**: Automate the build and testing of the `java-tron` Docker image using Gradle.
-- **DBFork**: Launch a private java-tron network based on the Mainnet database state, enabling shadow fork testing.
+- **Toolkit**: This package contains a set of database tools for TRON:
+  - `mv, move`: Move db to pre-set new path. For example HDD,reduce storage
+  expenses.
+  - `archive`: A helper to rewrite leveldb manifest.
+  - `convert`: Covert leveldb to rocksdb.
+  - `lite`: Split lite data for java-tron.
+  - `cp, copy`: Quick copy leveldb or rocksdb data.
+  - `root`: compute merkle root for tiny db. NOTE: large db may GC overhead
+  limit exceeded.
+  - `fork`: Modify the database of java-tron for shadow fork testing.
+- **Stress Test**: Execute the stress test and evaluate the performance of the `java-tron` fullnode.
+
 
 ## Prerequisites
 Please ensure you have the latest versions of Docker and Docker Compose installed by downloading them from the official websites:
 
 - **For Mac:**
   Download Docker from [Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/install/).
-
-  *Note: Docker Compose is included in the Docker installation package for Mac.*
-
+  Docker Compose is included in the Docker installation package for Mac.
+  - After installation, open Docker application, navigate to Settings \-> Resources \-> Network, and check the option \`Use kernel networking for UDP\`. Then restart Docker to apply.
 
 - **For Linux:**
   Download and install both Docker and Docker Compose plugin from the official websites:
@@ -124,7 +134,8 @@ To start all available features, or you want more customized operations, navigat
 
 - **Tools**:
    - **Gradle Docker**: Automate Docker image builds and testing. Check the [gradle docker](./tools/docker/README.md) documentation.
-   - **DBFork**: Perform shadow fork testing. Follow the [DBFork guidance](./tools/dbfork/README.md).
+   - **Toolkit**: Perform a set of database related operations. Follow the [Toolkit guidance](./tools/toolkit/README.md).
+   - **Stress Test**: Execute the stress test. Follow the [stress test guidance](./tools/stress_test/README.md).
 
 ## Troubleshooting
 If you encounter any difficulties, please refer to the [Issue Work Flow](https://tronprotocol.github.io/documentation-en/developers/issue-workflow/#issue-work-flow), then raise an issue on [GitHub](https://github.com/tronprotocol/tron-docker/issues). For general questions, please use [Discord](https://discord.gg/cGKSsRVCGm) or [Telegram](https://t.me/TronOfficialDevelopersGroupEn).

single_node/README.md

@@ -170,6 +170,15 @@ If the following error cases do not cover your issue, please refer to [Issue Wor
 If the logs show `Peer stats: all 0, active 0, passive 0`, it means tron node cannot use **P2P Node Discovering Protocol** to find neighbors.
 This protocol operates over UDP through port 18888. Therefore, the most likely cause of this issue is a network problem.
 Try debugging with the following steps:
-- Use the command `docker ps` to check if the ports mapping includes `-p 18888:18888`.
+- Use the command `docker ps` to check if the port mapping includes `-p 18888:18888`.
 - Verify your local network settings to ensure that port 18888 is not blocked.
-- Open the Docker application, navigate to Settings -> Resources -> Network, and check the option 'Use kernel networking for UDP'. Then restart Docker and your container.
+- If you are using a cloud server, check the security group settings to ensure that port 18888 is open.
+- If you are using macOS, open the Docker application, navigate to Settings \-> Resources \-> Network, and check the option \`Use kernel networking for UDP\`. Then restart Docker and your container.
+- If you are using Linux, you may need to enable IP forwarding:
+  - Add \`net.ipv4.ip_forward=1\` to file \`/etc/sysctl.conf\`
+  - Then restarted the network service and validated the setting:
+  ```
+  [root@demo]# systemctl restart network
+  [root@demo]# sysctl net.ipv4.ip_forward
+  net. ipv4. ip_forward = 1 // expected output
+  ```