如何在 Solana 上获取代币持有者

<!--StartFragment-->

在本指南中，我们将介绍如何获取可替代代币（例如 USDC）的所有持有者。这在您想要追踪代币持有者或用空投奖励持有者的情况下非常有用。

<!--EndFragment--> <!--StartFragment-->

概述

让我们首先看看代币（尤其是非同质化代币）在 Solana 上是如何运作的。当开发人员创建代币时，他们使用代币程序创建一个铸币账户。这个铸币账户包含有关特定代币的信息，例如名称、代币地址和图像。一旦创建了铸币账户，就可以铸造代币并将其存储在代币账户中。代币账户是一个包含有关特定地址拥有的特定代币的信息的账户。这将包括铸币地址、所有者地址和账户中特定代币的数量等详细信息。例如，持有一些 USDC（[SPL 代币]的地址将有一个 USDC 的代币账户。

<!--EndFragment-->

<!--StartFragment-->

现在\ 我们了解了代币和代币账户的工作原理，我们可以看看如何获​​取给定代币的所有代币持有者。每个持有特定代币的钱包都会有一个该代币的代币账户。这意味着此代币将与持有该代币的所有钱包的代币账户相关联。这就是我们找出所有持有者的方法。如果我们能找到一种方法来获取与代币相关联的所有代币账户，然后获取这些账户的所有者，我们就会得到所有持有者的名单！

<!--EndFragment--> <!--StartFragment-->

getTokenAccounts 方法

幸运的是，[Helius getTokenAccounts API 方法]允许我们精确地做到这一点。我们能够在 API 调用参数中包含任何代币的铸币地址，我们将获得为该代币创建的所有代币帐户的列表。除此之外，API 还返回每个代币帐户的所有者；这个所有者就是我们通常所说的代币持有者。需要注意的一件小事是，一个帐户可以有多个针对同一代币的代币帐户。这不是什么大问题；我们只需要设置一些逻辑来处理共享所有者的代币帐户。 

<!--EndFragment--> <!--StartFragment-->

执行

现在让我们深入研究一些代码，看看我们实际上如何做到这一点。您需要一个 Helius API 密钥才能继续。您可以前往并注册一个帐户，免费获取一个。首先，我们必须创建一个名为getTokenHolders.js的 Javascript 文件。我们可以先添加我们的 Helius URL 并导入 fs 库，将结果保存到JSON文件中。

<!--EndFragment-->

const url = \`https\://mainnet.helius-rpc.com/?api-key=\`; const fs = require("fs");

<!--StartFragment-->

接下来，我们将创建一种方法来获取与特定代币相关联的所有代币帐户。我们可以首先创建一个名为 findHolders 的方法，该方法将使用 getTokenAccounts 方法获取所需的数据。您可以getTokenAccounts方法的更多信息。需要注意的一件重要事情是，每次调用 API 最多只能返回 1000 个代币帐户。Solana 上的大多数大型代币都有超过 100,000 个代币帐户。为了解决这个问题，我们将使用分页浏览所有代币帐户并继续进行 API 调用，直到我们获取与所有现有代币帐户相关的数据。在该方法中，我们将在getTokenAccounts调用的参数中包含代币铸币厂。当我们循环遍历所有代币帐户时，我们会将每个唯一的代币帐户所有者添加到列表中。方法运行完成后，我们会将此列表保存到包含所有代币持有者的JSON文件中。 <!--EndFragment-->

const findHolders = async () => {
  // Pagination logic
  let page = 1;
    // allOwners will store all the addresses that hold the token
  let allOwners = new Set();

  while (true) {
    const response = await fetch(url, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        jsonrpc: "2.0",
        method: "getTokenAccounts",
        id: "helius-test",
        params: {
          page: page,
          limit: 1000,
          displayOptions: {},
                    //mint address for the token we are interested in
          mint: "CKfatsPMUf8SkiURsDXs7eK6GWb4Jsd6UDbs7twMCWxo",
        },
      }),
    });

        // Check if any error in the response
      if (!response.ok) {
        console.log(
          `Error: ${response.status}, ${response.statusText}`
        );
        break;
      }

    const data = await response.json();
    // Pagination logic. 
    if (!data.result || data.result.token_accounts.length === 0) {
      console.log(`No more results. Total pages: ${page - 1}`);
      break;
    }
    console.log(`Processing results from page ${page}`);
        // Adding unique owners to a list of token owners. 
    data.result.token_accounts.forEach((account) =>
      allOwners.add(account.owner)
    );
    page++;
  }

  fs.writeFileSync(
    "output.json",
    JSON.stringify(Array.from(allOwners), null, 2)
  );
};

<!--StartFragment-->

在上面的示例中，在分页浏览所有代币账户时，多次调用getTokenAccounts方法。API 响应将为每个代币账户提供以下数据： 

\ {

“地址”：“CVMR1nbxTcQ7Jpa1p137t5TyKFii3Y7Vazt9fFct3tk9”，

“薄荷”：“SHDWyBxihqiCj6YekG2GUr7wqKLeLAMK1gHZck9pL6y”，

“所有者”：“CckxW6C1CjsxYcXSiDbk7NYfPLhfqAm3kSB5LEZunnSE”，

“金额”：100000000，

“委托金额”：0，

“冻结”：错误

}，

我们从这些代币账户中提取了所有者并将其添加到我们的列表中。如果我们愿意，我们还可以存储每个代币账户持有的代币数量，以找出最大的持有者。 

一旦完成，我们需要做的就是调用该方法：

<!--EndFragment-->

findHolders();

我们的getTokenHolders.js文件中的完整代码应如下所示：

const url = `https://mainnet.helius-rpc.com/?api-key=`;
const fs = require("fs");

const findHolders = async () => {
  let page = 1;
  let allOwners = new Set();

  while (true) {
    const response = await fetch(url, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        jsonrpc: "2.0",
        method: "getTokenAccounts",
        id: "helius-test",
        params: {
          page: page,
          limit: 1000,
          displayOptions: {},
          mint: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        },
      }),
    });

        // Check if any error in the response
      if (!response.ok) {
        console.log(
          `Error: ${response.status}, ${response.statusText}`
        );
        break;
      }

    const data = await response.json();

    if (!data.result || data.result.token_accounts.length === 0) {
      console.log(`No more results. Total pages: ${page - 1}`);

      break;
    }
    console.log(`Processing results from page ${page}`);
    data.result.token_accounts.forEach((account) =>
      allOwners.add(account.owner)
    );
    page++;
  }

  fs.writeFileSync(
    "output.json",
    JSON.stringify(Array.from(allOwners), null, 2)
  );
};

findHolders();

<!--StartFragment-->

输出

我们的代码的输出将是所有持有者的列表，看起来类似于：

  “111An9SVxuPpgjnuXW9Ub7hcVmZpYNrYZF4edsGwJEW”，

  “11Mmng3DoMsq2Roq8LBcqdz6d4kw9oSD8oka9Pwfbj”，

  “112uNfcC8iwX9P2TkRdJKyPatg6a4GNcr9NC5mTc2z3”，

  “113uswn5HNgEfBUKfK4gVBmd2GpZYbxd1N6h1uUWReg”，

  “11CyvpdYTqFmCVWbJJeKFNX8F8RSjNSYW5VVUi8eX4P”，

  “11MANeaiHEy9S9pRQNu3nqKa2gpajzX2wrRJqWrf8dQ”，

<!--EndFragment--> 或者使用GTokenTool的代币快照功能，无需代码，方便快捷。

Solana代币燃烧 Solana靓号钱包生成 Solana批量归集 Solana批量生成钱包地址 Solana批量空投 Solana市值管理机器人