Yellowstone gRPC

gRPC Unary Methods

Simple request/response gRPC methods for blockhash, block height, slot, and version queries.

Unary Methods

These are simple request/response gRPC methods (not streaming).

SubscribeReplayInfo

Returns information about the earliest slot available for replay subscriptions.

Parameters: None (empty request message)

first_availableuint64

The first slot available for replay (optional - may be absent if replay is not supported).

const response = await client.subscribeReplayInfo();console.log("First available slot:", response.firstAvailable);

Ping

Health check that echoes back a count value.

countint32required

A counter value to echo back.

countint32

The echoed counter value.

const response = await client.ping(1);console.log("Pong:", response);

GetLatestBlockhash

Returns the latest blockhash and last valid block height.

commitmentCommitmentLevel

Commitment level: PROCESSED, CONFIRMED, or FINALIZED.

slotuint64

Slot of the blockhash.

blockhashstring

Latest blockhash.

last_valid_block_heightuint64

Last block height at which the blockhash is valid.

const response = await client.getLatestBlockhash(CommitmentLevel.CONFIRMED);console.log(`Blockhash: ${response.blockhash}`);console.log(`Valid until block: ${response.lastValidBlockHeight}`);

GetBlockHeight

Returns the current block height.

commitmentCommitmentLevel

Commitment level.

block_heightuint64

Current block height.

const response = await client.getBlockHeight(CommitmentLevel.CONFIRMED);console.log(`Block height: ${response.blockHeight}`);

GetSlot

Returns the current slot.

commitmentCommitmentLevel

Commitment level.

slotuint64

Current slot number.

const response = await client.getSlot(CommitmentLevel.CONFIRMED);console.log(`Current slot: ${response.slot}`);

IsBlockhashValid

Checks whether a given blockhash is still valid.

blockhashstringrequired

The blockhash to validate.

commitmentCommitmentLevel

Commitment level.

slotuint64

Slot at which validity was checked.

validbool

true if the blockhash is still valid.

const response = await client.isBlockhashValid("YOUR_BLOCKHASH");console.log(`Valid: ${response.valid}, Slot: ${response.slot}`);

GetVersion

Returns the Yellowstone gRPC server version.

Parameters: None

versionstring

Server version string.

const response = await client.getVersion();console.log(`Version: ${response.version}`);