pugson/abi-data

Grab your smart contract’s ABI as JSON from Etherscan. Supports multiple chains and testnets.

ABI Data — grab your smart contract’s ABI as JSON from Etherscan, Polygonscan, Arbiscan, BaseScan, BscScan, FTMScan, Snowtrace, GnosisScan

Fetch smart contract ABI JSON to use with wagmi and ethers.js in your app. Records are cached for 365 days, so after the initial request for a contract, the API will respond very quickly from the CDN. This is just a simple wrapper around various *scan APIs.

General usage

Supported networks:

Network name	Network ID
Ethereum Mainnet	none (default)
Ethereum Goerli Testnet	goerli
Ethereum Sepolia Testnet	sepolia
Avalanche Mainnet	avalanche
Avalanche Fuji Testnet	avalancheFuji
Arbitrum Mainnet	arbitrum
Arbitrum Goerli Testnet	arbitrumGoerli
Arbitrum Nova	arbitrumNova
Base Mainnet	base
Base Goerli Testnet	baseGoerli
BSC Mainnet	bsc
BSC Testnet	bscTestnet
Fantom Mainnet	fantom
Fantom Testnet	fantomTestnet
Polygon Mainnet	polygon
Polygon Mumbai Testnet	polygonMumbai
Polygon zkEVM	polygonZkEvm
Polygon zkEVM Testnet	polygonZkEvmTestnet
Optimism Mainnet	optimism
Optimism Goerli Testnet	optimismGoerli
Gnosis Mainnet	gnosis

https://abidata.net/<contract_address>?network=<network_id>

Examples:

• USDT on Ethereum Mainnet: https://abidata.net/0xdAC17F958D2ee523a2206206994597C13D831ec7
• Chainlink LINK token on Ethereum Sepolia: https://abidata.net/0x779877a7b0d9e8603169ddbd7836e478b4624789?network=sepolia

React usage example

import { useState, useEffect } from "react";
import { useContractWrite, usePrepareContractWrite } from "wagmi";

const contractAddress = "0xecb504d39723b0be0e3a9aa33d646642d1051ee1";

const useContractABI = (contractAddress) => {
  const [contractABI, setContractABI] = useState(null);

  useEffect(() => {
    const fetchContractABI = async () => {
      const response = await fetch(`https://abidata.net/${contractAddress}`);
      const json = await response.json();
      setContractABI(json.abi);
    };

    fetchContractABI();
  }, [contractAddress]);

  return contractABI;
};

function App() {
  const contractABI = useContractABI(contractAddress);
  const { config } = usePrepareContractWrite({
    address: contractAddress,
    abi: contractABI,
    functionName: "feed",
  });

  const { data, isLoading, isSuccess, write } = useContractWrite(config);

  return (
    <div>
      <button disabled={!write} onClick={() => write?.()}>
        Feed
      </button>
      {isLoading && <div>Check Wallet</div>}
      {isSuccess && <div>Transaction: {JSON.stringify(data)}</div>}
    </div>
  );
}

Development

This is a Next.js app. First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev

Open http://localhost:3000 with your browser to see the result.

abi-data's Issues

In search of type safe working example.

Hi @pugson I'm interested in using this along wagmi, as the example shows, but want to ensure that I'm getting type safety and the auto complete features that come with declaring your ABI as a const.

Do you know of any examples in the wild that are successfully achieving this?

Support more networks

AFAIK after reading the source code, I found that the app only supports Ethereum Mainnet and Goerli testnet. Since the most used networks also have their etherscan-like explorers, like Polygon has polygonscan.com, etc. It should be possible to include the support for all of these.

I will be very happy to submit a PR if maintainers are interested.