跳到主要内容

如何获取对象数据

首次开发 Sui 读取操作的开发者可以参考本教程。 使用 Node.js 编写一个脚本,从 Sui devnet 检索并检查原始对象数据。


概述​

在本教程中,您将使用 SuiClient 执行 读取操作。您将向 Sui devnet 查询一个链上的 非同质化代币 对象,然后检查其属性。

本教程将构建一个轻量级的 Node.js 脚本。该脚本会连接到网络,并输出您请求的对象的 JSON 数据。

先决条件​

  • Node.js: v18.0.0 或更高版本。
  • 包管理器: npm 或 yarn。
  • 能够使用终端并掌握基本的命令行操作技能。

1. 设置项目​

  1. 创建一个新目录并打开它:

    Terminal
    mkdir sui-data-fetcher && cd sui-data-fetcher
  2. 初始化一个 Node 项目并配置为支持 ES 模块:

    Terminal
    npm init -y
    npm pkg set type="module"
  3. 安装 Sui TypeScript SDK:

    Terminal
    npm install @mysten/sui

2. 初始化客户端​

创建一个名为 index.js 的文件。首先导入客户端并将其连接到 devnet。

index.js
import { SuiClient, getFullnodeUrl } from '@mysten/sui/client';

// Configuration
const NETWORK = 'devnet';

// 1. Initialize the client
// getFullnodeUrl automatically resolves the correct RPC endpoint for 'devnet'
const client = new SuiClient({
url: getFullnodeUrl(NETWORK),
});

console.log(`✅ Connected to Sui ${NETWORK}`);

3. 编写查询逻辑​

查询一个已知的“devnet 非同质化代币”对象。

备注

网络清理会频繁删除 devnet 上的对象。如果下面的 ID 无法使用,您可能需要从 Sui 浏览器 查找一个新的对象 ID。

将以下代码追加到 index.js 中:

index.js
// A known Object ID on devnet (Example NFT)
const TARGET_OBJECT_ID = '0x7d6539b7a423b035109b823e20c641c73defd23b8f3107b38d1d368688c2797c';

async function fetchObjectData() {
try {
console.log(`🔍 Querying object: ${TARGET_OBJECT_ID}...`);

// 2. Execute the fetch
const response = await client.getObject({
id: TARGET_OBJECT_ID,
// "options" determines how much data the node returns.
// We strictly request the content (fields) to keep the payload small.
options: {
showContent: true,
showType: true
}
});

// 3. Handle the response
if (response.error) {
throw new Error(`Object not found: ${response.error.code}`);
}

console.log('--- Object Data ---');
console.dir(response.data, { depth: null, colors: true });
} catch (err) {
console.error('❌ Query failed:', err.message);
}
}

fetchObjectData();

4. 运行并验证​

在终端中运行该脚本:

Terminal
node index.js

理解输出结果​

您应该会看到类似以下的 JSON 结构:

Output
{
"objectId": "0x7d...",
"version": "120",
"digest": "AuF...",
"type": "0x2::devnet_nft::DevNetNFT",
"content": {
"dataType": "moveObject",
"fields": {
"name": "Sui DevNet NFT",
"description": "An NFT created by the Sui DevNet",
"url": "ipfs://..."
}
}
}
  • digest:用于验证对象版本的哈希值。
  • type:具体的 Move 语言类型定义,例如 Package::Module::Type。
  • content.fields:存储在链上的数据,例如非同质化代币的名称、描述和图片网址。

后续步骤​

输出中显示了原始对象数据。options 参数用于控制查询返回的数据。请参考以下资源继续操作: