SuiVision 账户活动核对:从 digest 找到真实资产变化
链小知 · 入门 · 核验 · 依官方文档整理
用Sui主网账户历史与BlockVision官方API,对齐交易digest、coinType、NFT对象和分页范围。
开始前准备
- 准备Sui主网32字节0x公开地址、预期交易digest与资产coinType或objectId。
- 适用BlockVision Sui account activities v2,只支持本页声明的Sui Mainnet;SuiVision界面变化时使用原字段核对。
- 网页读取不需钱包;API使用本人已有x-api-key与相应方案,当前文档有Pro/试用额度,实际费用需查最新。
1. 固定账户与主网范围
在suivision.xyz按公开地址查看账户,把地址与钱包发送/接收记录对照;若当前页面不能提供所需活动,不先推断账户没有资产。
官方活动API只声明Sui Mainnet,测试网数据不能使用这个端点验证。准备的objectId、packageId与账户地址虽都可能以0x开头,含义分别确认。
检查结果:地址是目标账户且网络属于接口支持范围。
2. 读取活动并保留分页信息
已有API权限时GET https://api.blockvision.org/v2/sui/account/activities?address=完整账户地址&limit=20,使用x-api-key头。初次不传cursor,后续使用真实nextPageCursor。
limit默认20、最大50;第一页没有目标digest不能判断全历史没有。nextPageCursor空字符串才表示到达末页,分页期间保存请求游标避免重读/漏读。
检查结果:读取范围、cursor和目标digest定位状态明确。
3. 读状态与时间而非项目标签
对目标活动记录digest、status、sender和timestampMs;success/fail与项目名称和type标签不是同一字段。交互地址可能是package或account,根据interactAddresses.type分清。
遇到fail保留digest与失败状态,不用gas已消耗或某项目logo判断交换成功。API无数据或400时先检查输入和权限,不能补造正常结果。
检查结果:同一digest的状态、发送者与时间可重查。
4. 核对币类型和对象身份
币变化读取coinChanges中的coinAddress完整coinType、amount和decimal;NFT变化读objectId、objectType与packageId。symbol、图片、名称只做辅助。
amount可能为负,保留符号并按decimal解释。发现同名不同coinType或对象不一致,先标不匹配,不把名称相似的垃圾资产当预期收款。
检查结果:得到资产完整标识、数量原值及精度,或缺失项。
5. 记录费用和索引限制
gasFee按官方定义单位MIST记录,不能直接当SUI或美元。API活动是索引结果,失败读取、未完成分页、范围不支持都属于证据缺口。
整理账户、digest、资产类型、数量、状态、时间和分页边界。权限问题查询当前套餐与密钥配置,不为读取历史发起任何链上动作。
检查结果:交付具体活动核对表,并注明未读到的范围。
怎样确认完成
- 在明确分页范围内定位digest与资产变化,并正确标注MIST费用。
- 依据官方文档整理,尚未完成真实账户查询或交易行为验收。
常见错误与边界
- packageId不是最终收款地址。
- 第一页空/无目标记录不能替代完整历史核对。