Ethers.js tutorial

🚀 Want a shortcut? 🚀

Start with our example code on GitHub.


  1. npm install oraqle-contracts ethers

  2. Use the following JavaScript code to request results from either oraqle.

const ethers = require("ethers");
const addresses = {
  kovan: "0x0792724900B551d200D954a5Ed709d9514d73A9F",
  mainnet: "0x3E961f9A77146F6230709D767d60025f1Ed3Bfef",
const positions = ["U.S. Senate Class II", "U.S. Senate Class III"];
const abi = require("oraqle-contracts/artifacts/contracts/associated-press/Jan2021SenateRunoffs.sol/Jan2021SenateRunoffs.json")
const checker = async (network: "kovan" | "mainnet") => {
  let provider = ethers.getDefaultProvider(network);
  const contractAddress = addresses[network];

  const contract = new ethers.Contract(contractAddress, abi, provider);

  const lastNames = await Promise.all( =>

  return lastNames;


3. Still having issues?

  1. Tweet to @dawsonbotsford and @everipedia any engineering questions (or send a DM on Twitter to @dawsonbotsford)

Last updated