Recently, ethers.js has introduced the ChainstackProvider, a new addition to its Community Providers.

Chainstack provider on the ethers.js documentation .

ChainstackProviderintegrates directly withethers.js, enabling developers to connect seamlessly to multiple blockchain networks supported by Chainstack via JSON-RPC endpoints. The ChainstackProvider enhances the development of decentralized applications by offering robust and scalable connections to blockchain networks such as Ethereum Mainnet, Arbitrum, BNB Smart Chain Mainnet, and Polygon.

​
Supported Networks

ChainstackProvider supports connections to:

  • Ethereum Mainnet (mainnet)
  • Arbitrum (arbitrum)
  • BNB Smart Chain Mainnet (bnb)
  • Polygon (matic)

​
Class Overview

​
ChainstackProvider

The ChainstackProvider extends JsonRpcProvider and implements the CommunityResourcable interface. It allows users to connect to Chainstack’s JSON-RPC endpoints.

This provider is particularly useful for developers needing reliable network access to test and prototype blockchain applications.

A default, highly-throttled node is used by default. Deploy a high performance node and use your authorization key to increase performance.

​
Constructor

JavaScript
new ChainstackProvider(network?: Networkish, apiKey?: null | string)

Parameters:

  • network: Optional. The network identifier.
  • apiKey: Optional. The authorization key from your deployed Chainstack node.

​
Getting Started

To start using the ChainstackProvideryou must first install ethers.js:

Bash
npm install ethers

​
Example Usage

Here’s an example of creating a ChainstackProvider instance and call the eth_chainId method:

ethers.js
const ethers = require("ethers");

// Create a ChainstackProvider instance for Ethereum mainnet
const chainstack = new ethers.ChainstackProvider("mainnet");

const chainId = async () => {
  // This will return the value in Hex
  const chainId = await chainstack.send("eth_chainId");
  console.log(\`Hex Chain ID: ${chainId}\`);
};

chainId();

​
API Key Configuration

For better performance and higher rate limits, deploy a node from Chainstack and use its authorization key to instantiate theChainstackProvider.

Follow these steps to sign up on Chainstack, deploy a node, and find your endpoint credentials:

1

2

3

You must deploy a Global Node to use the authorization key in ChainstackProvider.

Once deployed, your node RPC ULR will look like this:

https://ethereum-mainnet.core.chainstack.com/AUTH_KEY

Now you can add the AUTH_KEY to the ChainstackProvider instance:

ethers.js
const ethers = require("ethers");

// Create a ChainstackProvider instance for Ethereum mainnet
const chainstack = new ethers.ChainstackProvider("mainnet", "AUTH_KEY");