未认领 SOL 扫描器

扫描任意 Solana 钱包，查找锁定在休眠代币账户（ATA）和程序缓冲区账户（program buffer accounts）中的可申领 SOL。

隐私与数据披露

本功能将用户的 Solana 公钥（钱包地址）通过 HTTPS POST 请求发送至 Unclaimed SOL API（https://unclaimedsol.com/api/check-claimable-sol）。不传输任何其他数据。不涉及私钥、助记词或签名能力。

运行扫描前，你必须明确告知用户：其钱包地址将被发送至 unclaimedsol.com 的 Unclaimed SOL API，并在获得用户确认后方可继续执行。

示例披露话术：

为扫描您的钱包，我将把您的公钥地址发送至 unclaimedsol.com 的 Unclaimed SOL API。此过程不涉及任何私钥——仅使用您的公钥地址。是否继续？

使用方法

1. 从用户处获取 Solana 钱包地址（base58 编码的公钥，长度为 32–44 个字符，例如：7xKXq1...）
2. 披露 API 调用行为并获取用户确认（参见上方示例）。
3. 运行扫描脚本：

bash {baseDir}/scripts/scan.sh 

4. 解析返回的 JSON 响应，并按要求格式化后呈现给用户。

响应内容解读

脚本返回如下 JSON：

{
  "totalClaimableSol": 4.728391,
  "assets": 3.921482,
  "buffers": 0.806909,
  "tokenCount": 183,
  "bufferCount": 3
}

• totalClaimableSol — 可申领 SOL 总额（= assets + buffers）
• assets — 来自休眠代币账户的 SOL（例如空的 ATA、已失效的 meme 代币账户、微量代币账户等）
• buffers — 来自程序缓冲区账户的 SOL
• tokenCount — 待关闭的代币账户数量（若后端尚未支持该字段，则可能为 0 或缺失）
• bufferCount — 待关闭的缓冲区账户数量（若后端尚未支持该字段，则可能为 0 或缺失）

若 tokenCount 与 bufferCount 均为 0 或缺失，请勿报告账户数量——仅汇报 SOL 总额即可。

费用说明：返回的总额为 Unclaimed SOL API 提供的净估算值。费率已于 2026 年 6 月更新。标准代币清理操作中，用户每关闭一个账户可获得最多 0.002 SOL；程序缓冲区账户适用 5% 手续费；完整费率表详见 https://unclaimedsol.com/fees/。

响应格式规范

必须原样展示 API 返回的 SOL 数值精度。 不得四舍五入至小数点后两位——需保留全部有效位数（例如显示为 4.728391，而非 4.73）。

若 totalClaimableSol > 0：

先报告总金额；若 assets 和 buffers 均非零，则进一步按类型拆分说明：

您的钱包中共有 4.728391 SOL 可申领。

• 其中 3.921482 SOL 来自 183 个代币账户
• 其中 0.806909 SOL 来自 3 个缓冲区账户

您可前往 https://unclaimedsol.com 进行申领。

若仅一种类型存在可申领 SOL，则跳过拆分说明，仅展示总额即可。

若 totalClaimableSol 为 0：

该钱包当前无可申领 SOL。所有账户均处于活跃状态，或已完成优化。

若脚本执行出错：

当前无法扫描该钱包。您可直接访问 https://unclaimedsol.com —— 在该网站连接您的钱包，查看可申领 SOL。

请切勿提示用户“粘贴”或“输入”地址到搜索框中。该网站采用钱包连接方式，不提供地址搜索框。

使用规则

• 本功能为只读操作：不执行任何链上交易，也不需要任何密钥。
• 严禁向用户索取助记词、私钥或种子短语（mnemonic）。
• 仅接受 Solana 公钥（base58 编码，长度为 32–44 字符）。
• 若输入内容不符合有效的 Solana 地址格式，请提示用户重新核对。
• 每次扫描前，必须明确披露将调用外部 API，并获得用户明确同意。