Supports dynamic loading of more configurations
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- java
- Domain
- api, backend, networking, observability
Research direction
Start by tracing the existing dynamicConfig mechanism and how it applies node.active and node.passive. Then inspect the P2P, RPC/HTTP/gRPC, rate limiter, and metrics modules named in the scope. Done means the listed parameters reload without a restart, invalid values are rejected, existing sessions remain uninterrupted, and reloads are logged.
Written by the indexing model from the issue text.
Description
Background
Java-Tron already supports dynamic loading of the node.active and node.passive configurations through dynamicConfig, allowing these parameters to be modified at runtime without restarting the node.
To further improve operational flexibility, we propose extending the dynamic loading capability to more configuration items, including network connection strategies, RPC / HTTP / gRPC parameters, JSON-RPC parameters, dynamic rate limiting, and node monitoring switches.
Rationale
Why should this feature exist?
- Operators can adjust key parameters without restarting nodes, improving overall network stability and availability.
- In testing environments or large-scale node deployments, operators could dynamically tune RPC concurrency, P2P connection strategies, and rate-limiting strategies flexibly.
- It avoids service interruptions or temporary unavailability caused by frequent node restarts.
Use Cases
- Temporarily adjusting node connection limits to handle network fluctuations.
- Dynamically modifying RPC or HTTP parameters such as minimum effective connections or rate-limiting policies during high traffic periods.
- Enabling or disabling metrics collection without stopping the node.
- Quickly responding to operational needs or testing scenarios such as stress testing or traffic shaping.
Specification
The following configuration items are proposed to support dynamic loading.
Network / P2P Connection Strategy
node.maxConnectionsnode.minConnectionsnode.minActiveConnectionsnode.maxConnectionsWithSameIpnode.fastForwardnode.isOpenFullTcpDisconnectnode.inactiveThresholdnode.unsolidifiedBlockChecknode.maxUnsolidifiedBlocks
RPC / HTTP / gRPC Parameters
node.rpc.minEffectiveConnectionnode.walletExtensionApinode.disabledApi
JSON-RPC Parameters
node.jsonrpc.maxBlockRangenode.jsonrpc.maxSubTopicsnode.jsonrpc.maxBlockFilterNum
Dynamic Rate Limiting
rate.limiter.httprate.limiter.rpcrate.limiter.global.qpsrate.limiter.global.ip.qps
Node Monitoring (Metrics / Logging)
node.metricsEnablenode.openPrintLog
Test Specification
- Modify the configuration file and trigger dynamic reload to verify that the updated parameters take effect immediately without restarting the node.
- Ensure that dynamic updates do not interrupt existing P2P connections or RPC sessions.
- Verify that configuration change events are recorded in the logs.
- Validate that invalid configuration values are properly rejected to ensure node stability.
Scope Of Impact
- P2P module: connection limits, maximum connections per IP, fast-forward node lists.
- RPC / HTTP / gRPC modules: minimum effective connections, extension API switches.
- Rate limiter module: QPS limits for HTTP / RPC / P2P components and global QPS.
- Metrics module: node monitoring switch.
- Operations and testing environments: configuration changes can be applied without restarting the node.
Implementation
- The implementation could extend the existing dynamicConfig mechanism by adding logic to monitor and apply additional configuration parameters.
- Each time the configuration file is read, validate new values and atomically update the corresponding module parameters.
- Implement refresh methods for different modules, such as P2P, RPC, RateLimiter, and Metrics.
- Log every dynamic reload event to facilitate tracking and auditing.
- Dominant language
- Java
- Stars
- 4.2k
- Forks
- 1.8k
- Avg merge
- 3d 4h
- Merged PRs (30d)
- 51
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from tronprotocol/java-tron
-
Difficulty 3/5 1-2 days Newbie friendliness 70/100
tronprotocol/java-tron#7044 · 4 comments ·
Maintainers usually reply within 1 day
-
[Feature] Remove unused discovery message definitionsPossibly taken A pull request linked to this issue is open or already merged. Opentype:feature
Difficulty 4/5 3-5 days Newbie friendliness 35/100
tronprotocol/java-tron#7013 · 3 comments ·
Maintainers usually reply within 1 day
-
[Feature] Validate ECKey inputs and improve key handlingPossibly taken A pull request linked to this issue is open or already merged. Opentype:feature
Difficulty 4/5 3-5 days Newbie friendliness 40/100
tronprotocol/java-tron#6994 · 5 comments ·
Maintainers usually reply within 1 day
-
type:feature
Difficulty 5/5 Over a week Newbie friendliness 25/100
tronprotocol/java-tron#6989 · 7 comments ·
Maintainers usually reply within 1 day
-
[Feature] decouple json-rpc filter processing from ManagerPossibly taken A pull request linked to this issue is open or already merged. Opentype:feature
Difficulty 5/5 Over a week Newbie friendliness 48/100
tronprotocol/java-tron#6963 · 8 comments ·
Maintainers usually reply within 1 day
All issues in tronprotocol/java-tron
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
citrusframework/citrus#2044 ·
Maintainers usually reply within 1 day
-
[bug]打火石不能被放在厨具架上Open
Difficulty 2/5 1-3 hours Newbie friendliness 63/100
KaleidoscopeMods/KaleidoscopeCookery#237 · 1 comment ·
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
molgenis/molgenis-emx2#7059 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
quarkiverse/quarkus-flow#1169 ·
Maintainers usually reply within 1 day