Oasis Sapphire tooling

​

Interaction tools

​

Geth

Interact with your Oasis Sapphire node using Geth.

geth attach YOUR_CHAINSTACK_ENDPOINT

Example below demonstrates how to get the balance of an address in wei value and convert it to ether value:

web3.fromWei(web3.eth.getBalance("0x4EA0911033792C93639bEd297B9289E136d86F89"))

​

MetaMask

On node access details, click Add to MetaMask.

​

Development tools

​

Hardhat

Configure Hardhat to deploy contracts and interact through your Oasis Sapphire nodes.

require("@nomicfoundation/hardhat-toolbox");
require('@oasisprotocol/sapphire-hardhat');
require('dotenv').config();

module.exports = {
  solidity: "0.8.18",
  defaultNetwork: "sapphire_testnet",
  networks: {
    sapphire_testnet: {
        url: `${process.env.YOUR_CHAINSTACK_ENDPOINT}`,
        accounts: [process.env.YOUR_PRIVATE_KEY],
				chainId: 0x5aff,
    },
},

};

​

web3.js

Build DApps using web3.js and Oasis Sapphire nodes deployed with Chainstack.

​

HTTPS

Use the HttpProvider object to connect to your node HTTPS endpoint and get the latest block number:

const Web3 = require('web3');

const web3 = new Web3(new Web3.providers.HttpProvider('YOUR_CHAINSTACK_ENDPOINT'));

web3.eth.getBlockNumber().then(console.log);

where YOUR_CHAINSTACK_ENDPOINT is your node HTTPS endpoint protected either with the key or password.

​

WSS

Use the WebsocketProvider object to connect to your node WSS endpoint and get the latest block number:

const Web3 = require('web3');

const web3 = new Web3(new Web3.providers.WebsocketProvider('YOUR_CHAINSTACK_ENDPOINT'));

web3.eth.getBlockNumber().then(console.log);

where YOUR_CHAINSTACK_ENDPOINT is your node WSS endpoint protected either with the key or password.

​

node.js

You can build a web app to query data using node.js and axios:

const axios = require("axios");

const payload = {
    jsonrpc: "2.0",
    id: 0,
    method: "query",
    params: []

};

(async () => {
    const response = await axios.post(`YOUR_CHAINSTACK_ENDPOINT`, payload)
    console.log(response.data)
})();

where

• YOUR_CHAINSTACK_ENDPOINT — your Chainstack node endpoint protected either with the key or password. See node access details.
• query — your JSON-RPC query. In this case, to get the latest block number.

​

ethers.js

Build DApps using ethers.js and Oasis Sapphire nodes deployed with Chainstack.

​

HTTPS

Use the JsonRpcProvider object to connect to your node endpoint and get the balance of any address:

const ethers = require('ethers');
const NODE_URL = "YOUR_CHAINSTACK_ENDPOINT ";
const provider = new ethers.JsonRpcProvider(NODE_URL, NETWORK_ID);
const eth_getBalance = async () => {
    const balance = await provider.getBalance("ACCOUNT_ADDRESS");
    console.log(balance);
  };
eth_getBalance()

where

• YOUR_CHAINSTACK_ENDPOINT — your node HTTPS endpoint protected either with the key or password

• NETWORK_ID — Oasis Sapphire network ID:

  • Mainnet: 23294
  • Testnet: 23295

• ACCOUNT_ADDRESS — the Oasis Sapphire account address

​

WebSocket

Use the WebSocketProvider object to connect to your node WSS endpoint and get the latest block number:

const ethers = require('ethers');
const NODE_URL = "YOUR_CHAINSTACK_ENDPOINT";
const provider = new ethers.WebSocketProvider(NODE_URL, NETWORK_ID);
const eth_getBalance = async () => {
    const balance = await provider.getBalance("ACCOUNT_ADDRESS");
    console.log(balance);
  };
eth_getBalance()

where

• YOUR_CHAINSTACK_ENDPOINT — your node WSS endpoint endpoint protected either with the key or password

• NETWORK_ID — Oasis Sapphire network ID:

  • Mainnet: 23294
  • Testnet: 23295

• ACCOUNT_ADDRESS — the Oasis Sapphire account address

​

Remix IDE

To make Remix IDE interact with the network through a zkEVM node deployed with Chainstack:

This will engage MetaMask and make Remix IDE interact with the network through a Chainstack node.