BlockX Clients
Last updated
Last updated
BlockX supports different clients in order to support Cosmos and Ethereum transactions and queries:
Cosmos gRPC
Query or send BlockX transactions using gRPC
9090
Cosmos REST (gRPC-Gateway)
Query or send BlockX transactions using an HTTP RESTful API
9091
Ethereum JSON-RPC
Query Ethereum-formatted transactions and blocks or send Ethereum txs using JSON-RPC
8545
Ethereum Websocket
Subscribe to Ethereum logs and events emitted in smart contracts.
8586
Tendermint RPC
Subscribe to Ethereum logs and events emitted in smart contracts.
26657
Tendermint Websocket
Query transactions, blocks, consensus state, broadcast transactions, etc.
26657
Command Line Interface (CLI)
Query or send BlockX transactions using your Terminal or Console.
N/A
BlockX exposes gRPC endpoints for all the integrated Cosmos SDK modules. This makes it easier for wallets and block explorers to interact with the Proof-of-Stake logic and native Cosmos transactions and queries.
reads a gRPC service definition and generates a reverse-proxy server which translates RESTful JSON API into gRPC. With gRPC-Gateway, users can use REST to interact the Cosmos gRPC service.
BlockX supports most of the standard to connect with existing Ethereum-compatible web3 tooling.
Then, start a websocket subscription with
Tendermint Core provides a Websocket connection to subscribe or unsubscribe to Tendermint ABCI events.
The main events you can subscribe to are:
NewBlock
: Contains events
triggered during BeginBlock
and EndBlock
.
Tx
: Contains events
triggered during DeliverTx
(i.e. transaction processing).
ValidatorSetUpdates
: Contains validator set updates for the block.
List of all Tendermint event keys:
Subscribe to a specific event
"tm.event"
block
Subscribe to a specific transaction
"tx.hash"
block
Subscribe to transactions at a specific block height
"tx.height"
block
Index BeginBlock
and Endblock
events
"block.height"
block
Subscribe to ABCI BeginBlock
events
"begin_block"
block
Subscribe to ABCI EndBlock
events
"end_block"
consensus
Below is a list of values that you can use to subscribe for the tm.event
type:
New block
"NewBlock"
block
New block header
"NewBlockHeader"
block
New Byzantine Evidence
"NewEvidence"
block
New transaction
"Tx"
block
Validator set updated
"ValidatorSetUpdates"
block
Block sync status
"BlockSyncStatus"
consensus
lock
"Lock"
consensus
New consensus round
"NewRound"
consensus
Polka
"Polka"
consensus
Relock
"Relock"
consensus
State sync status
"StateSyncStatus"
consensus
Timeout propose
"TimeoutPropose"
consensus
Timeout wait
"TimeoutWait"
consensus
Unlock
"Unlock"
consensus
Block is valid
"ValidBlock"
consensus
Consensus vote
"Vote"
consensus
Example response:
Users can use the blockxd
binary to interact directly with an BlockX node though the CLI.
Transactions: blockxd tx
The list of available commands, as of v3.0.0
, are:
Queries: blockxd query
The list of available commands, as of v3.0.0
, are:
For more info about the how to subscribe to events, please refer to the official .