@iov/tendermint-rpc

This package provides a type-safe wrapper around Tendermint RPC. Notably, all binary data is passed in and out as Uint8Array, and this module is reponsible for the hex/base64 encoding/decoding depending on the field and version of Tendermint. Also handles converting numbers to and from strings.

Getting started

The simplest possible use of the module is to assume it does everything automatically, and call:

import { Client } from "@iov/tendermint-rpc";

const client = await Client.connect(
  "ws://rpc-private-a-x-exchangenet.iov.one:16657",
);

const genesis = await client.genesis();
const status = await client.status();

A query to the ABCI application looks like this:

const results = await client.abciQuery({
  path: "/tokens?prefix",
  data: new Uint8Array([]),
});

Supported Tendermint versions

| IOV-Core version | Supported Tendermint versions | | ---------------- | ----------------------------- | | 1.1 | 0.31.x – 0.32.x | | 1.0 | 0.31.x | | 0.15 – 0.17 | 0.29.x – 0.31.x | | 0.12 – 0.14 | 0.25.x, 0.27.x – 0.29.x | | 0.11 | 0.25.x, 0.27.x | | 0.9 – 0.10 | 0.20.x, 0.21.x, 0.25.x | | 0.1 – 0.8 | 0.20.x, 0.21.x |

Support for Tendermint versions is determined by demand for IOV's own products. Please let us know if you need support for other versions of Tendermint or need long term support for one specific Tendermint version.

Code Overview

The main entry point is the Client.

The connection to the blockchain is defined by a flexible RpcClient interface, with implementations for HTTP (POST) and WebSockets. You can add your own connection type or just wrap one with custom retry rules, error handling, etc. The RPC client is just responsible for sending JSON-RPC requests and returning the responses.

The actual domain knowledge is embedded in the Adaptor, which defines a class for encoding Params and another for decoding Responses. The Tendermint version-specific functionality is implemented in global objects (like e.g. v0_31). This knowledge is mainly for those who want to add support for new versions, which should be added to the auto-detect method.

API Documentation

https://iov-one.github.io/iov-core-docs/latest/iov-tendermint-rpc/

License

This package is part of the IOV-Core repository, licensed under the Apache License 2.0 (see NOTICE and LICENSE).