使用DAS API获取集合中的所有NFT

Helius
发布于 2023-05-28 17:19
阅读 954

本文介绍了如何使用数字资产标准（DAS）API从Solana的NFT集合中获取所有资产信息，提供了操作步骤和代码示例，包括环境设置、API请求和错误处理等关键要素。最终用户可以将获取的数据保存为JSON格式，方便进一步的分析和使用。

## 概述

**数字资产标准**(DAS) API 是一个新发布的接口，统一了 Solana 上的常规资产和压缩资产（代币、NFT 等）。随着压缩资产的引入，Solana 开发者现在可以更高效地检索与钱包、集合或授权相关的所有资产，消除了使用多个端点的需求。DAS API 也在后台进行索引，为作为开发者的你提供了最优性能的调用。利用 DAS，你可以通过消除冗长的 gPA 调用，简化检索信息的过程。在 getAssetsByOwner 端点中，你可以使用其链上集合 ID 访问属于特定集合的所有资产的元数据和离线信息。

在本教程中，我们将演示如何利用 DAS API 从 Mad Lads 集合中检索资产信息。要跟随我们当前的代码库，你可以查看 GitHub 仓库 [这里](https://github.com/solhosty/DAS-Collection)。你也可以在我们扩展的 DAS API 文档中查看更多内容 [这里](https://docs.helius.dev/compression-and-das-api/digital-asset-standard-das-api)。

## 先决条件

- 安装 [Node.js](https://nodejs.org/en)（使用内置 fetch 需要版本 18.0 或更高）。
- 基本的 JavaScript 理解能力。

### 设置你的环境

1. 创建一个名为 collection 的项目文件夹。
2. 在 **collection 文件夹** 中创建一个名为 **assetList.js** 的文件。我们将在此文件中编写函数。
3. 在我们的 [**开发者门户**](https://dev.helius.xyz/dashboard/app) 上创建一个 API 密钥。导航到 RPCs 并复制 Mainnet RPC 链接，这将在本教程中作为 URL 变量使用。
4. 获取一个演示集合的认证集合 ID 以进行测试。在本例中，我们将使用 Mad Lads，它的集合 ID 为 `J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w`。你可以在 Magic Eden 等市场上查看特定 NFT 时找到链上的集合地址。

![使用 Solana API 返回集合中的所有资产](https://img.learnblockchain.cn/2025/03/14/75909614_image.png)

##### 注意：

如果没有链上集合 ID，你需要使用替代的 DAS 方法来检索结果。

## 操作步骤

以下是如何使用 DAS API 从 NFT 集合中检索资产信息的步骤。

### 1. 创建 getAssetsByGroup 函数

首先，让我们创建一个函数来检索与集合相关的所有资产。我们将在此函数中嵌套对 DAS API 的 POST 请求。

首先建立一个异步函数：

```
const { promises : fs } = require("fs");
const url = `https://rpc.helius.xyz/?api-key=`;

const getAssetsByGroup = async () => {
// 代码写在这里。
};

getAssetsByGroup();
```

在这一部分中，我们导入了 **fs** 模块来处理文件系统操作，确定了 RPC URL，并声明了 `getAssetsByGroup` 函数。

确保将 `<api-key>` 替换为你在 [开发者门户](https://dev.helius.xyz/dashboard/app) 中的 API 密钥。

### 2. 创建对 DAS 的 POST 请求

让我们定义 `getAssetsByGroup` 函数，并指定起始页和请求返回参数。我们将使用 fetch 函数以与我们的 [**方法文档**](https://docs.helius.xyz/solana-rpc-nodes/digital-asset-standard-api/get-assets-by-group) **对齐。**

```
console.time('getAssetsByGroup');
let page = 1;
let assetList = [];
```

我们使用 `console.time('getAssetsByGroup')` 开始计时，并初始化当前页和一个空数组以存储获取的资产。

我们使用 `fetch` 和 `await` 发送对指定 URL 端点的异步 POST 请求：

```
try {
   while (page) {
    const response = await fetch(url, {
      method: 'POST',
```

接下来，我们进入一个 `while` 循环，只要 `page` 变量不为 false，就会继续从 API 中提取数据。

然后我们使用 `fetch` 和 `await`，这是一个用于发送 HTTP 请求的异步操作。我们指定了 API 端点的 `url`，并将方法设置为 'POST'。这意味着我们在请求的主体中向服务器发送数据。

```
headers: {
	'Content-Type': 'application/json',
},
```

在请求的头部，我们将 'Content-Type' 设置为 'application/json'。这告诉服务器我们正在发送 JSON 数据。

```
body: JSON.stringify({
	jsonrpc: '2.0',
	id: 'my-id',
	method: 'getAssetsByGroup',
	params: {
		groupKey: 'collection',
		groupValue: 'J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w',
		page: page,
		limit: 1000,
	},
}),
```

随后，我们配置请求的主体，这是一个 JSON 对象，我们将其字符串化成可以发送到我们的端点的格式。在这里我们定义了 groupKey（这将是“collection”），和 groupValue（这将代表链上集合 ID）。

```
if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }

const { result } = await response.json();
```

现在，如果服务器响应不是肯定的，我们会启动一个错误来捕获。在请求成功的情况下，它将以 JSON 格式呈现响应。

如果你在 URL 中没有设置有效的 API 密钥，可能会遇到错误。

### **3. 将新资产追加到列表中**

在上一个部分中，我们最初指示 `getAssetsByGroup` 在页面设置为 1 时操作。然而，它尚未配置为遍历所有可能的结果页面。让我们接下来建立这一点：

```
assetList.push(...result.items);
    if (result.total !== 1000) {
      page = false;
    } else {
      page++;
    }
  }
```

这段代码将响应中的项目添加到 `assetList` 数组中。如果结果的总数不等于 1,000 的限制，我们将 `page` 设置为 false，以退出循环。

### **4. 将资产记录到文件中**

要将检索到的资产信息保存到外部 JSON 文件中，请添加以下代码：

```
const resultData = {
    totalResults: assetList.length,
    results: assetList,
  };

await fs.writeFile('results.json', JSON.stringify(resultData, null, 2));
	console.log('结果已保存到 results.json')
  console.timeEnd('getAssetsByGroup');
```

这段代码构建了一个 `resultData` 对象，包含总结果数和 `assetList` 数组。我们应用 `fs.writeFile` 将数据写入名为 `results.json` 的 JSON 文件。最后，我们记录一条确认消息并使用 `console.timeEnd` 结束计时。

### **5. 实施错误处理**

现在，我们需要建立一个安全网来处理可能的服务器请求失败。这可以通过以下设置实现。如果在请求执行过程中出现问题，这段代码块将记录一条错误消息到我们的控制台。

```
} catch (error) {
    console.error('发生错误:', error);
}
```

如果你没有插入有效的链上集合 ID，你可能会在请求时遇到错误。

### 最终代码

你的 **assetList.js** 文件应类似于以下代码片段。

```
const { promises : fs } = require("fs");
const url = `https://rpc.helius.xyz/?api-key=`;

const getAssetsByGroup = async () => {
  console.time('getAssetsByGroup'); // 开始计时
  let page = 1;
  let assetList = [];

try {
   while (page) {
    const response = await fetch(url, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        jsonrpc: '2.0',
        id: 'my-id',
        method: 'getAssetsByGroup',
        params: {
          groupKey: 'collection',
          groupValue: 'J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w',
          page: page,
          limit: 1000,
        },
      }),
    });
		if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }
    const { result } = await response.json();

assetList.push(...result.items);
    if (result.total !== 1000) {
      page = false;
    } else {
      page++;
    }
  }

const resultData = {
    totalResults: assetList.length,
    results: assetList,
  };

await fs.writeFile('results.json', JSON.stringify(resultData, null, 2));
	console.log('结果已保存到 results.json')
  console.timeEnd('getAssetsByGroup');

} catch (error) {
    console.error('发生错误:', error);
  }

};

getAssetsByGroup();
```

### 结果

一旦你的文件类似于上述代码，你可以使用 `node assetList.js` 命令在终端中运行它以启动请求。这将生成一个 `results.json` 文件。

完成后，控制台将指示结果已保存到 `results.json` 文件中，并记录获取资产所需的时间。在我们的案例中，使用 Node.js 检索 Mad Lads 的链上集合资产信息的过程平均耗时 **9.27 秒**。

![使用 Solana NFT API 返回集合中所有资产的结果](https://img.learnblockchain.cn/2025/03/14/98898784_image.png)

当你打开 `results.json` 文件时，你将看到返回的结果总数以及资产的详细信息。这些将表示属于你查询的集合的单个 NFT。

为了进一步自定义返回的数据，你可以提取特定信息，例如图像、所有者和其他被认为有价值的元数据。

##### 注意：

该集合可能显示 9967 的总数而不是 10,000，这是由于计算被烧掉和链外资产的数量。

### results.json

```
{
  "totalResults": 9967,
  "results": [
    {
      "interface": "Custom",
      "id": "GVPX9rXRXo9SVGktJCzA3Qb9v263kQzEyAWsgX3LL8P5",
      "content": {
        "$schema": "https://schema.metaplex.com/nft1.0.json",
        "json_uri": "https://madlads.s3.us-west-2.amazonaws.com/json/859.json",
        "files": [
          {
            "uri": "https://madlads.s3.us-west-2.amazonaws.com/images/859.png",
            "cdn_uri": "https://cdn.helius.services/cdn-cgi/image//https://madlads.s3.us-west-2.amazonaws.com/images/859.png",
            "mime": "image/png"
          },
          {
            "uri": "https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/859.png",
            "cdn_uri": "https://cdn.helius.services/cdn-cgi/image//https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/859.png",
            "mime": "image/png"
          }
        ],
        "metadata": {
          "attributes": [
            {
              "value": "Male",
              "trait_type": "Gender"
            },
            {
              "value": "Galaxy",
              "trait_type": "Type"
            },
            {
              "value": "Galaxy",
              "trait_type": "Expression"
            },
            {
              "value": "Gambler",
              "trait_type": "Hat"
            },
            {
              "value": "Galaxy",
              "trait_type": "Eyes"
            },
            {
              "value": "Dark Windsor",
              "trait_type": "Clothing"
            },
            {
              "value": "Grey",
              "trait_type": "Background"
            }
          ],
          "description": "Fock it.",
          "name": "Mad Lads #859",
          "symbol": "MAD"
        },
        "links": {
          "external_url": null
        }
      },
      "authorities": [
        {
          "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",
          "scopes": [
            "full"
          ]
        }
      ],
      "compression": {
        "eligible": false,
        "compressed": false,
        "data_hash": "",
        "creator_hash": "",
        "asset_hash": "",
        "tree": "",
        "seq": 0,
        "leaf_id": 0
      },
      "grouping": [
        {
          "group_key": "collection",
          "group_value": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w"
        }
      ],
      "royalty": {
        "royalty_model": "creators",
        "target": null,
        "percent": 0.042,
        "basis_points": 420,
        "primary_sale_happened": true,
        "locked": false
      },
      "creators": [
        {
          "address": "5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv",
          "share": 0,
          "verified": true
        },
        {
          "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",
          "share": 100,
          "verified": true
        }
      ],
      "ownership": {
        "frozen": false,
        "delegated": false,
        "delegate": null,
        "ownership_model": "single",
        "owner": "GX6KFMFS6yZGJzuZ28Q5Cbk9RN8Wv8UmNP2abcC4kcM2"
      },
      "supply": null,
      "mutable": true
    }, ...
    // 其他项目
]
```

这将显示返回的所有资产。现在，你可以进一步拆分，只返回代币地址、所有者和各种其他元数据信息。

**注意：**

你会注意到该集合显示 9967 而不是 10,000。那是因为反映了被烧掉的金额和不再在链上的量。

## 结论

恭喜你！你已成功使用新发布的数字资产标准 (DAS) API 检索了一个 10k 大小的集合的所有资产。总的来说：

- DAS API 提供了一种简化的 Solana dApp 资产提取方法。
- 该方法适用于常规资产和压缩集合。
- 通过利用 DAS API，你可以在 15 秒以内访问有价值的元数据和所有权信息。

通过使用 DAS API，我们可以简化 Solana 上 dApp 的资产提取。我们只需要使用一个端点，而不必进行多个 API 调用来收集信息。

在未来的教程中，我们将讨论一些其他简化的选项，以返回参与的资产。

>- 原文链接： [helius.dev/blog/solana-d...](https://www.helius.dev/blog/solana-dev-101-using-das-to-return-all-collection-assets)
>- 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～

概述

数字资产标准(DAS) API 是一个新发布的接口，统一了 Solana 上的常规资产和压缩资产（代币、NFT 等）。随着压缩资产的引入，Solana 开发者现在可以更高效地检索与钱包、集合或授权相关的所有资产，消除了使用多个端点的需求。DAS API 也在后台进行索引，为作为开发者的你提供了最优性能的调用。利用 DAS，你可以通过消除冗长的 gPA 调用，简化检索信息的过程。在 getAssetsByOwner 端点中，你可以使用其链上集合 ID 访问属于特定集合的所有资产的元数据和离线信息。

在本教程中，我们将演示如何利用 DAS API 从 Mad Lads 集合中检索资产信息。要跟随我们当前的代码库，你可以查看 GitHub 仓库这里。你也可以在我们扩展的 DAS API 文档中查看更多内容这里。

先决条件

安装 Node.js（使用内置 fetch 需要版本 18.0 或更高）。
基本的 JavaScript 理解能力。

设置你的环境

创建一个名为 collection 的项目文件夹。
在 collection 文件夹 中创建一个名为 assetList.js 的文件。我们将在此文件中编写函数。
在我们的 开发者门户 上创建一个 API 密钥。导航到 RPCs 并复制 Mainnet RPC 链接，这将在本教程中作为 URL 变量使用。
获取一个演示集合的认证集合 ID 以进行测试。在本例中，我们将使用 Mad Lads，它的集合 ID 为 J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w。你可以在 Magic Eden 等市场上查看特定 NFT 时找到链上的集合地址。

注意：

如果没有链上集合 ID，你需要使用替代的 DAS 方法来检索结果。

操作步骤

以下是如何使用 DAS API 从 NFT 集合中检索资产信息的步骤。

1. 创建 getAssetsByGroup 函数

首先，让我们创建一个函数来检索与集合相关的所有资产。我们将在此函数中嵌套对 DAS API 的 POST 请求。

首先建立一个异步函数：

const { promises : fs } = require("fs");
const url = `https://rpc.helius.xyz/?api-key=`;

const getAssetsByGroup = async () => {
// 代码写在这里。
};

getAssetsByGroup();

在这一部分中，我们导入了 fs 模块来处理文件系统操作，确定了 RPC URL，并声明了 getAssetsByGroup 函数。

确保将 <api-key> 替换为你在开发者门户中的 API 密钥。

2. 创建对 DAS 的 POST 请求

让我们定义 getAssetsByGroup 函数，并指定起始页和请求返回参数。我们将使用 fetch 函数以与我们的 方法文档 对齐。

console.time('getAssetsByGroup');
let page = 1;
let assetList = [];

我们使用 console.time('getAssetsByGroup') 开始计时，并初始化当前页和一个空数组以存储获取的资产。

我们使用 fetch 和 await 发送对指定 URL 端点的异步 POST 请求：

try {
   while (page) {
    const response = await fetch(url, {
      method: 'POST',

接下来，我们进入一个 while 循环，只要 page 变量不为 false，就会继续从 API 中提取数据。

然后我们使用 fetch 和 await，这是一个用于发送 HTTP 请求的异步操作。我们指定了 API 端点的 url，并将方法设置为 'POST'。这意味着我们在请求的主体中向服务器发送数据。

headers: {
    'Content-Type': 'application/json',
},

在请求的头部，我们将 'Content-Type' 设置为 'application/json'。这告诉服务器我们正在发送 JSON 数据。

body: JSON.stringify({
    jsonrpc: '2.0',
    id: 'my-id',
    method: 'getAssetsByGroup',
    params: {
        groupKey: 'collection',
        groupValue: 'J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w',
        page: page,
        limit: 1000,
    },
}),

if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }

const { result } = await response.json();

现在，如果服务器响应不是肯定的，我们会启动一个错误来捕获。在请求成功的情况下，它将以 JSON 格式呈现响应。

如果你在 URL 中没有设置有效的 API 密钥，可能会遇到错误。

3. 将新资产追加到列表中

在上一个部分中，我们最初指示 getAssetsByGroup 在页面设置为 1 时操作。然而，它尚未配置为遍历所有可能的结果页面。让我们接下来建立这一点：

assetList.push(...result.items);
    if (result.total !== 1000) {
      page = false;
    } else {
      page++;
    }
  }

这段代码将响应中的项目添加到 assetList 数组中。如果结果的总数不等于 1,000 的限制，我们将 page 设置为 false，以退出循环。

4. 将资产记录到文件中

要将检索到的资产信息保存到外部 JSON 文件中，请添加以下代码：

const resultData = {
    totalResults: assetList.length,
    results: assetList,
  };

  await fs.writeFile('results.json', JSON.stringify(resultData, null, 2));
    console.log('结果已保存到 results.json')
  console.timeEnd('getAssetsByGroup');

这段代码构建了一个 resultData 对象，包含总结果数和 assetList 数组。我们应用 fs.writeFile 将数据写入名为 results.json 的 JSON 文件。最后，我们记录一条确认消息并使用 console.timeEnd 结束计时。

5. 实施错误处理

} catch (error) {
    console.error('发生错误:', error);
}

如果你没有插入有效的链上集合 ID，你可能会在请求时遇到错误。

最终代码

你的 assetList.js 文件应类似于以下代码片段。

const { promises : fs } = require("fs");
const url = `https://rpc.helius.xyz/?api-key=`;

const getAssetsByGroup = async () => {
  console.time('getAssetsByGroup'); // 开始计时
  let page = 1;
  let assetList = [];

try {
   while (page) {
    const response = await fetch(url, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        jsonrpc: '2.0',
        id: 'my-id',
        method: 'getAssetsByGroup',
        params: {
          groupKey: 'collection',
          groupValue: 'J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w',
          page: page,
          limit: 1000,
        },
      }),
    });
        if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }
    const { result } = await response.json();

    assetList.push(...result.items);
    if (result.total !== 1000) {
      page = false;
    } else {
      page++;
    }
  }

  const resultData = {
    totalResults: assetList.length,
    results: assetList,
  };

  await fs.writeFile('results.json', JSON.stringify(resultData, null, 2));
    console.log('结果已保存到 results.json')
  console.timeEnd('getAssetsByGroup');

    } catch (error) {
    console.error('发生错误:', error);
  }

};

getAssetsByGroup();

结果

一旦你的文件类似于上述代码，你可以使用 node assetList.js 命令在终端中运行它以启动请求。这将生成一个 results.json 文件。

完成后，控制台将指示结果已保存到 results.json 文件中，并记录获取资产所需的时间。在我们的案例中，使用 Node.js 检索 Mad Lads 的链上集合资产信息的过程平均耗时 9.27 秒。

当你打开 results.json 文件时，你将看到返回的结果总数以及资产的详细信息。这些将表示属于你查询的集合的单个 NFT。