Shinami 核对已有 Sui 代付资金池:余额、预留与账单
链小知 · 进阶 · 核验 · 依官方文档整理
从已有脱敏 gas_getFund 响应和资金池记录核对网络、可用量及费用,避免把余额总额都当作立即可用于新赞助的额度。
开始前准备
- 准备有权查看的已有 Sui Gas Station 脱敏记录:请求时间、网络、资金池名称、gas_getFund JSON 响应及可选月账单;记录不得含 API key、签名或用户秘密。
- 了解本教程仅分析现有记录,不登录控制台、不新建基金或充值;若没有记录,可读文档示例理解字段,但不能用示例余额评价自己的账户。
1. 确认服务、网络与资金池对应
查记录的请求路径是否为 /sui/gas/v1,方法是否为 gas_getFund。它是 Gas Station 专用方法,不是已退役 Node Service 的节点读取方法。
按已有权限配置记录核对 key 的 Gas Station 网络与绑定 fund。官方说明 key 指向一个 fund;同名 fund 或仅凭 depositAddress 不能替代这组对应关系。
检查结果:服务明确为 Sui Gas Station,记录的网络、fund 与权限配置相符;不需要展示密钥值。
2. 先判断响应是否成功
gas_getFund 的 JSON-RPC 请求 params 应为空数组 []。核对响应 id 与已有请求 id,再检查有无 error;HTTP200 也可能承载 JSON-RPC 错误。
遇到401,保留权限、禁用状态和 allowlist 匹配待查;遇到 -32601/-32602,先比对方法名称及参数,不能把缺 result 解释成资金池余额为零。
检查结果:只有无错误且取得预期 result 的记录进入余额计算,失败记录保留原错误类型。
3. 读取金额并统一单位
从 result 读取 network、name、balance、inFlight 和 depositAddress。balance 与 inFlight 均以 MIST 计,1,000,000,000 MIST 等于1 SUI;按整数或精确十进制处理,保留原值。
以文档示例理解换算即可,不复制示例地址或余额作为自己的记录。depositAddress 为 null 表示尚无该地址,不能推导余额不存在。
检查结果:原始 MIST 与换算 SUI 可追溯,null 地址保留为未知/未创建,网络未被忽略。
4. 区分总额和已预留部分
官方 Funds 表将 Gas Credits Available 作为 fund 总量,Gas Credits in Flight 为活跃赞助占用;对同一时刻记录用 balance - inFlight 核对新赞助可用量。
若有多次快照,按时间分别计算。不能把不同时刻余额与预留拼在一起,也不能仅因 inFlight 高就判断服务多收费;等待赞助状态记录解释占用。
检查结果:总量、占用量、新赞助可用量分别记录,并注明快照时间;异常负值或时间缺失留待核查。
5. 核对费用与月账单范围
已有 Mainnet 月账单应区分 Sui transaction fees 与 Shinami fees;官方说明月份结束后3–4天才增加月汇总,可按 Fund(s) 分解并对应 FULL REPORT CSV。
Sponsorship Insights 的总赞助成本包含这两类费用,不能再将服务费重复相加。Wallet 免费层创建额度不免除 Gas Station 收费,公开正文也没有可照搬的固定服务单价。
检查结果:账单网络、月份、fund 和费用口径一致;未结束月份或缺账单不伪造已对账结果。
6. 形成可复核的资金记录
整理网络、fund、时间、原始金额、可用量、错误和账单覆盖期。充值只能用于赞助且不能提现,因此余额核对不附带充值或试提建议。
不要为了补地址点击首次 View:官方说明该动作可能生成 depositAddress。已有记录不足时注明需管理员提供脱敏快照,保持当前信息缺口。
检查结果:获得字段与时间完整的记录或明确缺项;未把只读核对变成新建地址、充值或提现流程。
怎样确认完成
- 已明确同一网络、fund 和时间快照的金额与费用口径,缺失数据均标注待核。
- 验证等级为文档整理;没有认证请求、账户操作、充值或链上执行结果。
常见错误与边界
- 把 balance 与 inFlight 相加或将总余额全部当即时可用额。
- 引用 Testnet 的自动测试资金解释 Mainnet 余额;或把钱包免费层当赞助免费。
- 使用旧 Node Service URL 或控制台示例值判断自己的资金池。