feat(api): add peer management to admin RPC - #86

…l#7014)

…nprotocol#6978)

* fix(jsonrpc): handle null parameters consistently

Validate nullable JSON-RPC arguments before they are dereferenced.
Return stable protocol errors instead of jsonrpc4j's unhandled -32001
fallback, which exposes Java exception types.

Validate eth_call's required transaction argument before its block
selector. The double-null case now returns -32602 instead of -32600.

Align eth_uninstallFilter lookup misses with geth: null, unknown and
already removed IDs return false. Empty and non-hexadecimal strings
also return false when no filter matches, without new format checks.
Non-null lookup misses now return false instead of -32000.
Use the value returned by remove to report whether a filter was removed
and avoid the race between checking and removing the same entry.

Remove the obsolete uninstall ItemNotFoundException declaration and
error mapping. Java binaries remain compatible, but source callers
catching that checked exception, or implementations still declaring it,
may need adjustment when recompiled.
Keep getFilterChanges and getFilterLogs on their existing lookup-miss
errors, and preserve request-source precedence and filter isolation.

Treat null block-detail flags as false and retain DTO defaults for
explicitly null optional fields. Preserve filter wildcard semantics.

Add binding, service, wire and VM execution regressions for null
arguments, error contracts, filter removal, source isolation and
concurrent uninstall results.

* fix(jsonrpc): reject null required positional parameters

Return invalid params for an explicit null filter ID in
eth_uninstallFilter, eth_getFilterChanges and eth_getFilterLogs, and for
a null fullTransactionObjects flag in eth_getBlockByHash and
eth_getBlockByNumber. The block hash or selector is still validated
first, and the flag is checked before any block lookup, so the result
does not depend on whether the block exists. Unknown non-null filter
IDs keep their existing results.

This replaces the earlier null-as-false handling of the flag and the
filter ID. go-ethereum v1.17.6 rejects null for these required
arguments; earlier releases decoded it as a zero value.

* refactor(jsonrpc): share the null check for required parameters

Route the null checks for the ten required JSON-RPC parameter
positions through one requireParam helper instead of repeating the
same if/throw block at each site. The "invalid params" and "invalid
filter request" messages are unchanged and are now both private
constants in TronJsonRpcImpl.

Remove the null check from the LogFilter constructor. In production
code, LogFilter is only built through LogFilterWrapper from
eth_getLogs and eth_newFilter, and both reject a null filter request
before reaching it, so the constructor check and its unit test are
dropped. Null filter requests remain covered at the service and wire
level.

Extract getBlockByHash(byte[]) and use it from ethGetBlockByHash and
getBlockByJsonHash, so ethGetBlockByHash no longer inlines the block
lookup. The validation order is unchanged.

No behavior change.

* test(jsonrpc): use the three-argument TronJsonRpcImpl constructor

Adapt the tests added for null parameter handling to the constructor
that now takes the Manager, and drop the removed setManager call.
Tests built only from mocks pass a mocked Manager, and tests backed by
the shared database pass dbManager, matching the existing tests.

…col#6985)

Replace jsonrpc4j's unhandled -32001 fallback with a fixed -32603
response so unmapped exception types and raw messages no longer reach
clients. Keep the documented -32001 contract for net_version and
eth_chainId through explicit mappings with fixed message and data.

Propagate VirtualMachineError, ThreadDeath, LinkageError, and TronError
through the JSON-RPC boundary. Scan complete cause chains without
allocating a visited set, detecting cycles without missing fatal causes.
Classify Throwables escaping dispatch before logging or mapping them.

Before rethrowing an Error, make a best-effort attempt to commit an
empty HTTP 500 so the container does not render its default error page.
Preserve the original error if cleanup fails, and leave an already
committed response untouched.

Route single requests through handleRequest because the servlet handle
API catches Throwable. Catch RuntimeException, IOException, and Error at
both dispatch boundaries, then propagate a classified fatal cause or
return -32603 when a response is appropriate. This also covers non-fatal
Errors from interceptor hooks. Discard partial dispatch output on
failure.

Recover each failed batch element without discarding earlier results or
skipping later requests. Share internal-error construction across
serialization, dispatch, and response-parsing failures. Count only the
replacement when parsing fails, retaining existing overflow rules and
the current single/batch handling of requests without an id.

Log unmapped exceptions, chain-identity failures, and asynchronous
log-query failures and interruptions at DEBUG with the Throwable,
classifying fatal causes before logging the failures. Log batch
request-serialization and response-parsing recoveries at DEBUG with the
element index and the Throwable. Log the first escaped dispatch failure
in each batch at ERROR with the Throwable; repeats use DEBUG with only
the index and exception type. Restore interrupted status for
asynchronous log queries.

Reject Boolean, object, and array request IDs before dispatch with
-32600 and id:null. Reject non-null scalar params with -32600, preserve
valid IDs, and isolate invalid batch elements so their siblings run.
Missing, null, array, and object params keep their existing semantics.

Remove the obsolete request replay wrapper and HTTP status provider.
Add resolver, servlet, embedded-Jetty, chain-identity, asynchronous
failure, dispatch-contract, and request-envelope regression coverage.
Exercise the real HTTP interceptor chain and observe commitment without
performing it on the servlet's behalf.

Test interceptor Errors with a real server and preserve the existing
notification response-suppression rules with characterization tests.

Add a package-private server injection seam for servlet tests without
changing production initialization.

…ocol#7019)

…col#6946)

…ts (tronprotocol#7021)

…protocol#7025)

The node.rpc.maxRstStream and secondsPerWindow options defaulted to
0, which left the HTTP/2 RST_STREAM frame limit unset, and the limit
was configured only when both values were positive. Give them
sensible defaults, validate them at load time, and apply the limit
unconditionally so the configuration behaves consistently.

- NodeConfig: default maxRstStream/secondsPerWindow to 1000/5.
  In postProcess, reject negative values for either option and reject
  Integer.MAX_VALUE specifically for maxRstStream, which grpc-java
  treats as disabling the limit. Independently replace each zero with
  its default and log a warning.
- RpcService: always configure maxRstFramesPerWindow from the config
  values; validation stays solely in NodeConfig, consistent with the
  neighboring maxConcurrentCallsPerConnection option.
- reference.conf, docs/configuration.md and config/README.md:
  document the new defaults and the 0 fallback for compatibility.
- Tests: pin the Java and reference defaults, preserve positive
  overrides, and verify PING at the RST limit followed by GOAWAY
  after one additional reset using a prebuilt HTTP/2 frame burst.

Note: an explicit 0 now falls back to the default instead of leaving
the limit unset, and maxRstStream = 2147483647 is rejected at startup.

…tocol#7020)

…l#6871)

…ain (tronprotocol#6986)

1. bump jsonrpc4j to 1.7, the latest release
2. add jakarta.servlet-api 5.0.0 as a test dependency; jsonrpc4j
   declares it optional, and Mockito needs it on the classpath to mock
   JsonRpcServer, whose new handle overload takes jakarta servlet
   types; the servlet dispatches through handleRequest and never
   calls that overload
3. drop javax.jws-api; jsonrpc4j 1.7 logs a missing
   javax.jws.WebParam at debug level instead of error, and no code
   uses @WebParam
4. accept one wire-level behavior change: when a positional parameter
   cannot be converted to the declared Java type (for example an
   object or array where a string is expected), the response changes
   from -32700 "JSON parse error" with id "null" to -32602 "Failed
   to read method parameter at index N" with the request id preserved
   and no data field; this also applies to batch entries, and a
   request without an id still gets this error with id null; the
   error is produced inside jsonrpc4j and does not pass through the
   error resolver
5. transitive changes on the runtime classpath: commons-codec 1.15 ->
   1.16.1, httpcore 4.4.13 -> 4.4.16, httpcore-nio 4.4.5 -> 4.4.16,
   jakarta.jws-api 3.0.0 added, net.iharder:base64 removed; slf4j-api
   and jackson keep resolving to 2.0.17 and 2.18.10
6. update the dispatch contract test, extend the error integration
   test with conversion errors in single, batch and id-less requests,
   and update the dependency verification metadata accordingly

…col#7031)

…ronprotocol#7028)

…ol#6979)

…nprotocol#6980)

# Conflicts:
#	common/src/main/resources/reference.conf
#	framework/build.gradle
#	framework/src/main/java/org/tron/core/config/args/Args.java
#	framework/src/main/java/org/tron/core/config/args/CommandLineArguments.java
#	framework/src/main/java/org/tron/core/services/admin/AdminJsonRpc.java
#	framework/src/main/java/org/tron/core/services/admin/AdminJsonRpcImpl.java
#	framework/src/main/java/org/tron/core/services/admin/AdminJsonRpcRequestHandler.java
#	framework/src/main/java/org/tron/core/services/admin/http/AdminRpcHttpService.java
#	framework/src/main/java/org/tron/core/services/admin/http/AdminRpcServlet.java
#	framework/src/main/java/org/tron/core/services/admin/http/VirtualHostValidator.java
#	framework/src/main/java/org/tron/core/services/admin/ipc/client/IpcClient.java
#	framework/src/main/java/org/tron/core/services/admin/ipc/client/IpcConsoleCommands.java
#	framework/src/main/java/org/tron/core/services/admin/ipc/client/IpcResponse.java
#	framework/src/main/java/org/tron/core/services/admin/ipc/server/IpcRequestHandler.java
#	framework/src/main/java/org/tron/core/services/admin/ipc/server/IpcSocketFiles.java
#	framework/src/main/java/org/tron/core/services/jsonrpc/JsonRpcServlet.java
#	framework/src/main/java/org/tron/program/FullNode.java
#	framework/src/test/java/org/tron/core/services/admin/http/AdminRpcServletTest.java
#	framework/src/test/java/org/tron/core/services/admin/ipc/client/IpcClientTest.java
#	framework/src/test/java/org/tron/core/services/admin/ipc/client/IpcConsoleCommandsTest.java
#	framework/src/test/java/org/tron/core/services/admin/ipc/client/IpcResponseTest.java
#	framework/src/test/java/org/tron/core/services/admin/ipc/server/AdminJsonRpcRequestTest.java
#	framework/src/test/java/org/tron/core/services/admin/ipc/server/IpcRequestHandlerTest.java
#	framework/src/test/java/org/tron/core/services/admin/ipc/server/IpcServiceTest.java
#	framework/src/test/java/org/tron/core/services/admin/ipc/server/IpcSocketFilesTest.java
#	framework/src/test/java/org/tron/program/FullNodeTest.java
#	gradle/verification-metadata.xml