# Shinami 核对已有 Sui 代付资金池：余额、预留与账单

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/shinami-sui-fund-record-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

从已有脱敏 gas_getFund 响应和资金池记录核对网络、可用量及费用，避免把余额总额都当作立即可用于新赞助的额度。

## 使用工具
- [Shinami Sui Gas Station](https://lianxiaozhi.com/tools/shinami) · [官方入口](https://docs.shinami.com/api-docs/sui/gas-station/api)

## 前置条件
- 准备有权查看的已有 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 与权限配置相符；不需要展示密钥值。
依据：[Shinami Sui Gas Station：余额与赞助状态方法](https://docs.shinami.com/api-docs/sui/gas-station/api.md)
依据：[Shinami Sui Gas Station：网络、资金与历史范围](https://docs.shinami.com/help-center/sui/gas-station-faq.md)
依据：[Shinami：Node 与 Invisible Wallet v1 停用公告](https://docs.shinami.com/changelog.md)

## 2. 先判断响应是否成功

gas_getFund 的 JSON-RPC 请求 params 应为空数组 []。核对响应 id 与已有请求 id，再检查有无 error；HTTP200 也可能承载 JSON-RPC 错误。

遇到401，保留权限、禁用状态和 allowlist 匹配待查；遇到 -32601/-32602，先比对方法名称及参数，不能把缺 result 解释成资金池余额为零。

核对结果：只有无错误且取得预期 result 的记录进入余额计算，失败记录保留原错误类型。
依据：[Shinami Sui Gas Station：余额与赞助状态方法](https://docs.shinami.com/api-docs/sui/gas-station/api.md)
依据：[Shinami：HTTP、JSON-RPC 与 Sui 错误](https://docs.shinami.com/developer-guides/core-integration-topics/error-reference.md)
依据：[Shinami：后端密钥、权限与配额](https://docs.shinami.com/developer-guides/core-integration-topics/authentication-and-api-keys.md)

## 3. 读取金额并统一单位

从 result 读取 network、name、balance、inFlight 和 depositAddress。balance 与 inFlight 均以 MIST 计，1,000,000,000 MIST 等于1 SUI；按整数或精确十进制处理，保留原值。

以文档示例理解换算即可，不复制示例地址或余额作为自己的记录。depositAddress 为 null 表示尚无该地址，不能推导余额不存在。

核对结果：原始 MIST 与换算 SUI 可追溯，null 地址保留为未知/未创建，网络未被忽略。
依据：[Shinami Sui Gas Station：余额与赞助状态方法](https://docs.shinami.com/api-docs/sui/gas-station/api.md)

## 4. 区分总额和已预留部分

官方 Funds 表将 Gas Credits Available 作为 fund 总量，Gas Credits in Flight 为活跃赞助占用；对同一时刻记录用 balance - inFlight 核对新赞助可用量。

若有多次快照，按时间分别计算。不能把不同时刻余额与预留拼在一起，也不能仅因 inFlight 高就判断服务多收费；等待赞助状态记录解释占用。

核对结果：总量、占用量、新赞助可用量分别记录，并注明快照时间；异常负值或时间缺失留待核查。
依据：[Shinami Sui Gas Station：网络、资金与历史范围](https://docs.shinami.com/help-center/sui/gas-station-faq.md)
依据：[Shinami Sui Gas Station：余额与赞助状态方法](https://docs.shinami.com/api-docs/sui/gas-station/api.md)

## 5. 核对费用与月账单范围

已有 Mainnet 月账单应区分 Sui transaction fees 与 Shinami fees；官方说明月份结束后3–4天才增加月汇总，可按 Fund(s) 分解并对应 FULL REPORT CSV。

Sponsorship Insights 的总赞助成本包含这两类费用，不能再将服务费重复相加。Wallet 免费层创建额度不免除 Gas Station 收费，公开正文也没有可照搬的固定服务单价。

核对结果：账单网络、月份、fund 和费用口径一致；未结束月份或缺账单不伪造已对账结果。
依据：[Shinami Sui 产品：赞助费用与月账单](https://docs.shinami.com/help-center/billing/sui-faq.md)
依据：[Shinami Sui Gas Station：网络、资金与历史范围](https://docs.shinami.com/help-center/sui/gas-station-faq.md)

## 6. 形成可复核的资金记录

整理网络、fund、时间、原始金额、可用量、错误和账单覆盖期。充值只能用于赞助且不能提现，因此余额核对不附带充值或试提建议。

不要为了补地址点击首次 View：官方说明该动作可能生成 depositAddress。已有记录不足时注明需管理员提供脱敏快照，保持当前信息缺口。

核对结果：获得字段与时间完整的记录或明确缺项；未把只读核对变成新建地址、充值或提现流程。
依据：[Shinami Sui Gas Station：网络、资金与历史范围](https://docs.shinami.com/help-center/sui/gas-station-faq.md)
依据：[Shinami Sui 产品：赞助费用与月账单](https://docs.shinami.com/help-center/billing/sui-faq.md)

## 常见错误
- 把 balance 与 inFlight 相加或将总余额全部当即时可用额。
- 引用 Testnet 的自动测试资金解释 Mainnet 余额；或把钱包免费层当赞助免费。
- 使用旧 Node Service URL 或控制台示例值判断自己的资金池。

## 完成检查
- 已明确同一网络、fund 和时间快照的金额与费用口径，缺失数据均标注待核。
- 验证等级为文档整理；没有认证请求、账户操作、充值或链上执行结果。

## 相关知识
- [Gas 怎么计算？交易失败为什么仍可能扣费](https://lianxiaozhi.com/learn/gas-and-failed-transactions)

## 官方依据
- [Shinami Sui Gas Station：余额与赞助状态方法](https://docs.shinami.com/api-docs/sui/gas-station/api.md)
- [Shinami Sui Gas Station：网络、资金与历史范围](https://docs.shinami.com/help-center/sui/gas-station-faq.md)
- [Shinami Sui 产品：赞助费用与月账单](https://docs.shinami.com/help-center/billing/sui-faq.md)
- [Shinami：HTTP、JSON-RPC 与 Sui 错误](https://docs.shinami.com/developer-guides/core-integration-topics/error-reference.md)
- [Shinami：后端密钥、权限与配额](https://docs.shinami.com/developer-guides/core-integration-topics/authentication-and-api-keys.md)
- [Shinami：Node 与 Invisible Wallet v1 停用公告](https://docs.shinami.com/changelog.md)