Version Detection

When you call StargateClient.connect() or connectComet(), CosmJS auto-detects the node’s CometBFT version so it can use the correct RPC protocol.

How Auto-Detection Works

Initial connection

CosmJS connects a Tendermint 0.37 client and calls status().

Version check

It reads nodeInfo.version from the response.

Client selection

If the version starts with 0.38., it disconnects and reconnects with Comet38Client. If it starts with 1., it reconnects with Comet1Client. Otherwise, it keeps the 0.37 client.

This costs one extra RPC round-trip on startup.

Skipping Auto-Detection

If you already know your chain’s CometBFT version, skip auto-detection by constructing the client directly:

import { StargateClient } from "@cosmjs/stargate";
import { Comet1Client, HttpClient } from "@cosmjs/tendermint-rpc";

const rpcClient = new HttpClient("https://rpc.my-chain.network");
const cometClient = Comet1Client.create(rpcClient);
const client = StargateClient.create(cometClient);

Skipping auto-detection saves one RPC round-trip on every client creation. This is worth doing in production when you know the chain’s CometBFT version.

Using `connectComet` Directly

You can also use connectComet on its own when you need a CometClient without a high-level wrapper:

import { connectComet } from "@cosmjs/tendermint-rpc";

const cometClient = await connectComet("https://rpc.my-chain.network");
const status = await cometClient.status();

Next Steps

Connect to a Chain

Return to the connection overview and transport selection table.

Custom Endpoints

Combine manual client construction with custom headers and batching.

Custom RPC Endpoints Connection Errors

⌘I

CosmJS

Concepts

Guides

API Reference

How Auto-Detection Works

Skipping Auto-Detection

Using `connectComet` Directly

Next Steps

Connect to a Chain

Custom Endpoints

​How Auto-Detection Works

​Skipping Auto-Detection

​Using connectComet Directly

​Next Steps

Connect to a Chain

Custom Endpoints

How Auto-Detection Works

Skipping Auto-Detection

Using `connectComet` Directly

Next Steps