org.tron.trident.core

Class ApiWrapperBuilder

java.lang.Object

org.tron.trident.core.ApiWrapperBuilder

public class ApiWrapperBuilder
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
ApiWrapperBuilder(java.lang.String grpcEndpoint)
ApiWrapperBuilder(java.lang.String grpcEndpoint, java.lang.String grpcEndpointSolidity, java.lang.String hexPrivateKey)

Method Summary

Modifier and Type	Method and Description
ApiWrapperBuilder	addInterceptors(java.util.List<io.grpc.ClientInterceptor> interceptors) Add multiple custom interceptors.
ApiWrapper	build()
java.util.List<io.grpc.ClientInterceptor>	getCustomInterceptors() The custom interceptors added so far, as an unmodifiable view.
java.lang.String	toString()
ApiWrapperBuilder	withApiKey(java.lang.String apiKey) Set API key for TronGrid
ApiWrapperBuilder	withGrpcEndpointSolidity(java.lang.String grpcEndpointSolidity) set grpcEndpointSolidity
ApiWrapperBuilder	withPrivateKey(java.lang.String hexPrivateKey) set PrivateKey, an optional "0x" prefix is accepted
ApiWrapperBuilder	withTimeout(long timeoutMs) Set timeout in milliseconds for all requests
ApiWrapperBuilder	withTLS() Enable TLS using the system trust certificates.
ApiWrapperBuilder	withTLS(java.io.File certFile) Enable TLS with custom certificate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ApiWrapperBuilder

public ApiWrapperBuilder(java.lang.String grpcEndpoint,
                         java.lang.String grpcEndpointSolidity,
                         java.lang.String hexPrivateKey)

ApiWrapperBuilder

public ApiWrapperBuilder(java.lang.String grpcEndpoint)

Method Detail

withTLS

public ApiWrapperBuilder withTLS(java.io.File certFile)

Enable TLS with custom certificate

Recommend using TLS 1.2 or TLS 1.3 for better security. For generating self-signed certificates, tools like OpenSSL can be used (e.g., OpenSSL Req).

Parameters:

certFile - The certificate file

withTLS

public ApiWrapperBuilder withTLS()

Enable TLS using the system trust certificates.

A certificate previously set by withTLS(File) is cleared.

withApiKey

public ApiWrapperBuilder withApiKey(java.lang.String apiKey)

Set API key for TronGrid

withTimeout

public ApiWrapperBuilder withTimeout(long timeoutMs)

Set timeout in milliseconds for all requests

addInterceptors

public ApiWrapperBuilder addInterceptors(java.util.List<io.grpc.ClientInterceptor> interceptors)

Add multiple custom interceptors. Null elements are ignored.

Custom interceptors are applied outside the timeout interceptor, so they cannot change the deadline set by withTimeout(long).

withGrpcEndpointSolidity

public ApiWrapperBuilder withGrpcEndpointSolidity(java.lang.String grpcEndpointSolidity)

set grpcEndpointSolidity

withPrivateKey

public ApiWrapperBuilder withPrivateKey(java.lang.String hexPrivateKey)

set PrivateKey, an optional "0x" prefix is accepted

Throws:

java.lang.IllegalArgumentException - if the key is not 64 hex characters or its scalar is outside the valid secp256k1 range [1, n - 1]

getCustomInterceptors

public java.util.List<io.grpc.ClientInterceptor> getCustomInterceptors()

The custom interceptors added so far, as an unmodifiable view.

build

public ApiWrapper build()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object