ZetaChain is an EVM-compatible Cosmos SDK-based L1 blockchain designed to enable Omnichain Smart Contracts and provide a unified application experience. Applications on ZetaChain can manage, read, and write state to/from any external chain - even non-smart chains such as Bitcoin network. Users can natively access these applications from any connected chain without requiring users to switch networks.

The ZetaChain API facilitates interaction with the ZetaChain network through a collection of JSON-RPC methods. Given its compatibility with the Ethereum ecosystem, developers familiar with Ethereum's JSON-RPC APIs will find working with ZetaChain both intuitive and straightforward.

Send Your First Request on Alchemy

Let's use the viem package to create a ZetaChain client connected to Alchemy and fetch the latest block number!

npm install --save viem

Create Client Connected to Alchemy

import { createPublicClient, http } from "viem"; 
import { zetachain } from "viem/chains";
 
const client = createPublicClient({
  chain: zetachain,
  transport: http("https://zetachain-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY"),
});

Now that you've created a client connected to Alchemy, you can continue with some basics:

Get Latest Block Number

const blockNumber = await client.getBlockNumber();
console.log("Current block number:", blockNumber);

Get an Address Balance

const balance = await client.getBalance({ address: "0xab5801a7d398351b8be11c439e05c5b3259aec9b" });
console.log("Balance (ZETA):", Number(balance) / 1e18);

Read Block Data

const block = await client.getBlock({
  blockNumber: blockNumber, // from previous example
});
console.log(block);

Fetch a Transaction by Hash

const tx = await client.getTransaction({ hash: "0xYOUR_TX_HASH" });
console.log(tx);

Fetch Transaction Receipt

const receipt = await client.getTransactionReceipt({
  hash: "0xYOUR_TX_HASH"
});
console.log(receipt);

ZetaChain APIs

For the full list of ZetaChain APIs, see the ZetaChain API Endpoints.