Class JsonRpc

java.lang.Object

com.codename1.crypto.rpc.JsonRpc

Direct Known Subclasses:

EvmRpc, SolanaRpc

public class JsonRpc
extends Object

JSON-RPC 2.0 over an RpcTransport: what Ethereum and Solana nodes speak. Parameters and results are the values JSONParser.parseStrict(String, boolean) reads and JSONParser.toJson(Object) writes: Map, List, String, Boolean, Long, Double, and an integer past a long as a JSONParser.RawJson holding its exact digits.

Constructor Summary

Constructors

Constructor	Description
JsonRpc(RpcTransport transport, String url)	A client for an endpoint.

Method Summary

Modifier and Type	Method	Description
protected static List<?>	asList(Object o, String what)	A result that must be a JSON array.
protected static long	asLong(Object o, String what)	A result that must be a JSON integer within long range.
protected static Map<?,?>	asMap(Object o, String what)	A result that must be a JSON object.
protected static String	asString(Object o, String what)	A result that must be a JSON string.
Object	call(String method, Object... params)	Calls a method and answers its result, which may be null.
Object	callWith(String method, Object params)	Calls a method with a parameter list, or a parameter object when params is a Map.
RpcTransport	getTransport()	The transport.
String	getUrl()	The endpoint.

Methods inherited from class Object

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

Constructor Details

JsonRpc

public JsonRpc(RpcTransport transport,
 String url)

A client for an endpoint.

Method Details

getUrl

public String getUrl()

The endpoint.

getTransport

public RpcTransport getTransport()

The transport.

call

public Object call(String method,
 Object... params)
            throws IOException

Calls a method and answers its result, which may be null.

Throws

• RpcException: for an error reply or an HTTP failure
• IOException: when the endpoint could not be reached, or answered something that is not a JSON-RPC response

Throws:

IOException

callWith

public Object callWith(String method,
 Object params)
                throws IOException

Calls a method with a parameter list, or a parameter object when params is a Map. It is not an overload of call(String, Object...), which would take a single parameter for the whole list.

Throws:

IOException

asMap

protected static Map<?,?> asMap(Object o,
 String what)
                         throws IOException

A result that must be a JSON object.

Throws:

IOException

asList

protected static List<?> asList(Object o,
 String what)
                         throws IOException

A result that must be a JSON array.

Throws:

IOException

asString

protected static String asString(Object o,
 String what)
                          throws IOException

A result that must be a JSON string.

Throws:

IOException

asLong

protected static long asLong(Object o,
 String what)
                      throws IOException

A result that must be a JSON integer within long range.

Throws:

IOException