Skip to main content

Reading Blockchain State

Overview​

Push Chain is an EVM-compatible blockchain, so you can use familiar Ethereum tools to fetch on-chain data. This guide shows you how to:

  • Initialize HTTP client for one-off requests
  • Choose between default (pruned) and archive RPC endpoints
  • Fetch transactions and blocks
  • Initialize WebSocket client for real-time streaming
  • Subscribe to new blocks and filter for specific transactions

For full reference on each library, see:

Looking for state from other chains?

This page is about reading state over RPC from your frontend or backend, using standard tools like ethers and viem. If you need state from another chain (or from a web API) delivered on-chain to a Push Chain contract, with validators agreeing on the result and an optional callback, use Read Universal State.

Initialize HTTP Client​

VIRTUAL NODE IDE
Copy playground link
Copy code

Fetch a Transaction by Hash​

VIRTUAL NODE IDE
Copy playground link
Copy code

Fetch Blocks​

Latest Block​

VIRTUAL NODE IDE
Copy playground link
Copy code


Block by Hash​

VIRTUAL NODE IDE
Copy playground link
Copy code

Websocket Client​

Initialize WebSocket Client​

VIRTUAL NODE IDE
Copy playground link
Copy code


Subscribing to New Blocks​

VIRTUAL NODE IDE
Copy playground link
Copy code


Filtering New Blocks for Specific Transactions​

VIRTUAL NODE IDE
Copy playground link
Copy code

Next Steps​

  • Dive into our Contract Helpers to detect and work with both cross-chain accounts and native Push Chain smart accounts.
  • Use our UI Kit to abstract away wallet and chain logic and accelerate your front-end development.