💎Account Versions

Learn how to use Airstack to fetch certain versions of token-bound (ERC6551) accounts.

Currently, Airstack indexes all the official ERC6551 registry contracts on Ethereum and Base:

Version	Registry Address
0.2.0	0x02101dfB77FDE026414827Fdc604ddAF224F0921
0.3.0	0x284be69BaC8C983a749956D7320729EB24bc75f9
0.3.1	0x000000006551c19487814612e58FE06813775758

If you are deploying ERC6551 using a custom registry contract, please reach out to us to add it to the Airstack API by joining our Telegram.

By default, ERC721 NFTs can have multiple versions of ERC6551 accounts controlled by it.

Using the registry filter that is provided in the Accounts API, you can fetch only certain versions of ERC6551 accounts that your dapp supports.

Table Of Contents

In this guide you will learn how to use Airstack to:

• Get A Certain Version of ERC6551 Accounts

• Get A Certain Version of ERC6551 Accounts By NFT Collection

• Get A Certain Version of ERC6551 Accounts Owned By A User

Pre-requisites

• An Airstack account

• Basic knowledge of GraphQL

• Basic knowledge of ERC6551

Get Started

JavaScript/TypeScript/Python

If you are using JavaScript/TypeScript or Python, Install the Airstack SDK:

npm

React

npm install @airstack/airstack-react

Node

npm install @airstack/node

yarn

React

yarn add @airstack/airstack-react

Node

yarn add @airstack/node

pnpm

React

pnpm install @airstack/airstack-react

Node

pnpm install @airstack/node

pip

pip install airstack

Then, add the following snippets to your code:

React

import { init, useQuery } from "@airstack/airstack-react";

init("YOUR_AIRSTACK_API_KEY");

const query = `YOUR_QUERY`; // Replace with GraphQL Query

const Component = () => {
  const { data, loading, error } = useQuery(query);

  if (data) {
    return <p>Data: {JSON.stringify(data)}</p>;
  }

  if (loading) {
    return <p>Loading...</p>;
  }

  if (error) {
    return <p>Error: {error.message}</p>;
  }
};

Node

import { init, fetchQuery } from "@airstack/node";

init("YOUR_AIRSTACK_API_KEY");

const query = `YOUR_QUERY`; // Replace with GraphQL Query

const { data, error } = await fetchQuery(query);

console.log("data:", data);
console.log("error:", error);

Python

import asyncio
from airstack.execute_query import AirstackClient

api_client = AirstackClient(api_key="YOUR_AIRSTACK_API_KEY")

query = """YOUR_QUERY""" # Replace with GraphQL Query

async def main():
    execute_query_client = api_client.create_execute_query_object(
        query=query)

    query_response = await execute_query_client.execute_query()
    print(query_response.data)

asyncio.run(main())

Other Programming Languages

To access the Airstack APIs in other languages, you can use https://api.airstack.xyz/gql as your GraphQL endpoint.

🤖 AI Natural Language​

Airstack provides an AI solution for you to build GraphQL queries to fulfill your use case easily. You can find the AI prompt of each query in the demo's caption or title for yourself to try.

Airstack AI (Demo)

Get A Certain Version of ERC6551 Accounts

You can use the Accounts API to fetch certain version of the ERC6551 accounts, e.g. all v.0.3.1 ERC6551 accounts:

Try Demo

https://app.airstack.xyz/query/Y3vJiopHG3

Show me all ERC6551 with registry version 0.3.1 on Ethereum

Code

Query

query MyQuery {
  Accounts(
    input: {
      blockchain: ethereum,
      filter: {
        # set registry to v.0.3.1 registry address
        registry: {_eq: "0x000000006551c19487814612e58FE06813775758"}
      },
      limit: 200,
      order: {createdAtBlockTimestamp: DESC}
    }
  ) {
    Account {
      address {
        addresses
      }
      nft {
        address
        tokenId
        token {
          name
        }
        contentValue {
          image {
            medium
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "Accounts": {
      "Account": [
        {
          "address": {
            "addresses": [
              // This is the ERC6551 account address
              "0xcdcbeb24ddc70c869ad7279569a6cfdb9f978d67"
            ]
          },
          // NFT address, token ID, name, images
          "nft": {
            "address": "0xda4128a4fc209df510e9e4483acd059d84620419",
            "tokenId": "14753",
            "token": {
              "name": "Spooky Boys Mansion Party"
            },
            "contentValue": {
              "image": {
                "medium": "https://assets.airstack.xyz/image/nft/unphxhbTvBWE8tj4Zl7uHPwvSpFxr0XTTudcSwOrqcxZ1h/Uifxg/1nGez6IlPgkQOn3Aa124ipSq50cn/5KAw==/medium.png"
              }
            }
          }
        },
        // Other v0.3.1 ERC6551 accounts on Ethereum
      ]
    }
  }
}

Get A Certain Version of ERC6551 Accounts By NFT Collection

You can use the Accounts API to fetch certain version of the ERC6551 accounts of an NFT Collection, e.g. all v.0.3.1 ERC6551 accounts of Sapienz NFT:

Try Demo

https://app.airstack.xyz/query/kYjqzOl1DU

Show me all v0.3.1 ERC6551 accounts on @Sapienz NFT

Code

Query

query MyQuery {
  Accounts(
    input: {
      blockchain: ethereum,
      filter: {
        # set registry to v.0.3.1 registry address
        registry: {_eq: "0x000000006551c19487814612e58FE06813775758"},
        # ERC721 NFT Collection address
        tokenAddress: {_eq: "0x26727ed4f5ba61d3772d1575bca011ae3aef5d36"}
      },
      limit: 200,
      order: {createdAtBlockTimestamp: DESC}
    }
  ) {
    Account {
      address {
        addresses
      }
      nft {
        tokenId
        contentValue {
          image {
            medium
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "Accounts": {
      "Account": [
        {
          "address": {
            "addresses": [
              // ERC6551 account address
              "0xfcdb9fa208a44dcbf44bee781a843e3a110e5a6d"
            ]
          },
          // Sapienz NFT's token ID & image that owned the ERC6551 account
          "nft": {
            "tokenId": "5016",
            "contentValue": {
              "image": {
                "medium": "https://assets.airstack.xyz/image/nft/5kd+4a7IJ5/FRcsd89DlfK94FmP9mMPaWE6lJEEFcv8k7Uysylj9VPfwtBG/4Coqfgt+T8NjIvnl3Ens3pPcpg==/medium.aaf"
              }
            }
          }
        },
        // Other v0.3.1 ERC6551 accounts on Sapienz NFT
      ]
    }
  }
}

Get A Certain Version of ERC6551 Accounts Owned By A User

You can use the TokenBalances API to fetch certain version of the ERC6551 accounts owned by a user, e.g. all v.0.3.1 ERC6551 accounts owned by 0xjw.eth:

Try Demo

https://app.airstack.xyz/query/67x9qr9ggJ

Show all v0.3.1 ERC6551 accounts owned by 0xjw.eth on Ethereum

Code

Query

query MyQuery {
  TokenBalances(
    input: {
      filter: {
        # Owner of ERC6551 accounts
        owner: {_eq: "0xjw.eth"},
        # Filter out only ERC721 NFTs
        tokenType: {_eq: ERC721}
      },
      blockchain: ethereum,
      limit: 200
    }
  ) {
    TokenBalance {
      tokenNfts {
        erc6551Accounts(
          input: {
            filter: {
              # set registry to v.0.3.1
              registry: {_eq: "0x000000006551c19487814612e58FE06813775758"}
            }
          }
        ) {
          address {
            addresses
          }
          nft {
            address
            tokenId
            token {
              name
            }
            contentValue {
              image {
                medium
              }
            }
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "TokenBalances": {
      "TokenBalance": [
        {
          "tokenNfts": {
            "erc6551Accounts": [
              {
                "address": {
                  "addresses": [
                    // This is the ERC6551 account address of the NFT
                    "0xb5307cb1ae1385f64de8442d5d48ff86479f4f8c"
                  ]
                },
                "nft": {
                  "address": "0x26727ed4f5ba61d3772d1575bca011ae3aef5d36",
                  "tokenId": "0",
                  "token": {
                    "name": "Sapienz"
                  },
                  "contentValue": {
                    "image": {
                      "medium": "https://assets.airstack.xyz/image/nft/5kd+4a7IJ5/FRcsd89DlfK94FmP9mMPaWE6lJEEFcv89IrV05wFbp2CuATN2RB0a/medium.gif"
                    }
                  }
                }
              }
            ]
          }
        },
        {
          "tokenNfts": {
            "erc6551Accounts": [] // This NFT has no ERC6551 accounts
          }
        },
        // Other ERC721 NFTs that is owned by 0xjw.eth
      ]
    }
  }
}

Developer Support

If you have any questions or need help regarding fetching certain versions of ERC6551 token bound accounts data, please join our Airstack's Telegram group.

More Resources

• Accounts API Reference

• TokenBalances API References