SuperAPI AI 工具集

ts-sdk-view-and-query

数据与分析

查看项目

更新于 10-15 19:57

技能介绍

用途:指导在 TypeScript SDK(@aptos-labs/ts-sdk)中只读访问链上数据,包括 view 函数、余额、账户信息、资源与模块查询。

主要能力与用法:查询 APT 余额使用 aptos.getBalance({ accountAddress }),不要使用已废弃的 getAccountCoinAmount 或 getAccountAPTAmount;余额为 bigint 的 octas(1 APT = 100_000_000 octas)。查询账户信息用 getAccountInfo,返回 sequence_number、authentication_key 等。调用 Move view 函数用 aptos.view(),传入 function、functionArguments,可选 typeArguments;返回类型多样,u128/u256 需用 BigInt(...) 转换以免精度丢失。查询资源用 getAccountResources 或单类型 getAccountResource(resource.data 含结构体字段);查询模块用 getAccountModules 或按名 getModule。资源与模块支持游标分页,如 getAccountResourcesPage 配合 options: { limit, cursor }。

适用场景:读取链上状态、集成前端或脚本查询账户与合约数据。

限制与常见错误:view 返回值类型不固定(number、bigint、string、boolean、array),不可假设均为字符串;u128/u256 不要用 number;泛型 view 需提供 typeArguments。地址可传字符串或 AccountAddress(AccountAddressInput)。