如何获取对象数据
首次开发 Sui 读取操作的开发者可以参考本教程。
使用 Node.js 编写一个脚本,从 Sui devnet 检索并检查原始对象数据。
概述
在本教程中,您将使用 SuiClient 执行 读取操作。您将向 Sui devnet 查询一个链上的 非同质化代币 对象,然后检查其属性。
本教程将构建一个轻量级的 Node.js 脚本。该脚本会连接到网络,并输出您请求的对象的 JSON 数据。
先决条件
- Node.js: v18.0.0 或更高版本。
- 包管理器:
npm或yarn。 - 能够使用终端并掌握基本的命令行操作技能。
1. 设置项目
-
创建一个新目录并打开它:
Terminalmkdir sui-data-fetcher && cd sui-data-fetcher -
初始化一个 Node 项目并配置为支持 ES 模块:
Terminalnpm init -ynpm pkg set type="module" -
安装 Sui TypeScript SDK:
Terminalnpm 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 参数用于控制查询返回的数据。请参考以下资源继续操作:
- 查阅
getObjectAPI 参考文档,了解所有可用的响应选项和过滤条件。 - 查阅 如何批量获取对象 和 如何获取自有对象,了解批量查询方法。
- 继续学习下一节教程 使用写入操作发送交易,以构建并提交链上状态变更。