Multiplatform JSON RPC library facilitates creating and handling RPC 2.0 requests, requiring custom network driver implementation. Enables serialization and deserialization of requests and responses.
Multiplatform JSON RPC Library using Kotlin Serialization
RpcCore does not provide a multiplatform networking implementaion, you must provide your own by implementing the HttpNetworkingDriver interface:
class MyNetworkDriver : HttpNetworkDriver {
override suspend fun makeHttpRequest(request: HttpRequest): String {
val url = request.url
httpMethod = request.method (should be RPC requests)
requestHeaders = request.properties
requestBody = reqest.body
...
response string
}
}
// setup RPC driver
val rpcUrl = "https://api.endpoint.com"
val rpcDriver = Rpc20Driver(rpcUrl, MyNetworkDriver())
// build RPC request
requestId = UUID.generate()
requestMehtod =
requestParameters = buildJsonObject {
put(, )
put(, )
}
rpcRequest = JsonRpc20Request(requestId, requestParamaters, requestId)
rpcResponse = rpcDriver.makeRequest(rpcRequest, JsonElement.serializer())
Using the rpc-solana and rpc-ktordriver modules along with web3-solana, we can query the blockchain and deserialze encoded account data all in one step.
val accountPublicKey = SolanaPublicKey(/* public key of the account we wish to query */)
val rpcUrl = "https://api.mainnet-beta.solana.com"
val rpc = SolanaRpcClient(rpcUrl, KtorNetworkDriver()) // using prebuilt ktor driver from `rpc-ktordriver`
// Get basic AccountInfo with serialized account data as a ByteArray
val accountInfoResponse = rpc.getAccountInfo(accountPublicKey, commitment = Commitment.CONFIRMED)
accountInfoResponse.result?.let { accountInfo ->
// check account info: owner, space, lamports etc.
val owner = accountInfo.owner
}
By supplying out own deserialization strategy to the RPC client, we can receive an fully deserialized struct based on our on chain data. In this example, we will read anm SPL token mint account using a custom serializer from kotlinx-serialization.
This approach works for any on chain data that is stored on the chain with standard Borsh encoding as long as the provided serialization strategy matches the account data layout.
// declare account data struct representing the data we want to deserialize from the blockchain
data class MintAccountInfo(
val mintAuthorityOption: Int,
val mintAuthority: SolanaPublicKey,
val supply: Long,
val decimals: Byte,
val isInitialized: Boolean,
val freezeAuthorityOption: Int,
val freezeAuthority: SolanaPublicKey
)
// now we query the RPC as we did before
val mintAccountPublicKey = SolanaPublicKey(/* public key of the mint we wish to query */)
val rpcUrl = "https://api.mainnet-beta.solana.com"
val rpc = SolanaRpcClient(rpcUrl, KtorNetworkDriver()) // using prebuilt ktor driver from `rpc-ktordriver`
// Get AccountInfo with deserialized account data as MintAccountInfo
val accountInfoResponse = rpc.getAccountInfo(MintAccountInfo.serializer(),
mintPublicKey,
commitment = Commitment.CONFIRMED
)
accountInfoResponse.result?.data?.let { mintAccountInfo ->
// check mint account details
val mintAuthority = mintAccountInfo.authority
val mintSupply = mintAccountInfo.supply
val mintDecimals = mintAccountInfo.decimals
}
Surfaced from shared tags and platforms — no rankings paid for.