跳到主要内容

Solana

查询带有美元定价的 Solana 区块链数据——钱包余额、带价值的代币投资组合、交易详情、NFT、巨鲸检测以及实时网络统计。使用 Solana RPC + CoinGecko。无需 API 密钥。

技能元数据​

来源可选 — 使用 hermes skills install official/blockchain/solana 安装
路径optional-skills/blockchain/solana
版本0.2.0
作者Deniz Alagoz (gizdusum)，由 Hermes Agent 增强
许可证MIT
标签Solana, Blockchain, Crypto, Web3, RPC, DeFi, NFT

参考：完整 SKILL.md​

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理看到的指令。

Solana 区块链技能

查询通过 CoinGecko enriched with USD pricing 的 Solana 链上数据。 8 条命令：钱包投资组合、代币信息、交易、活动、NFT、 巨鲸检测、网络统计和价格查询。

无需 API 密钥。仅使用 Python 标准库（urllib, json, argparse）。

何时使用​

  • 用户询问 Solana 钱包余额、代币持有情况或投资组合价值
  • 用户希望通过签名检查特定交易
  • 用户希望获取 SPL 代币元数据、价格、供应量或主要持有者
  • 用户希望获取地址的近期交易历史
  • 用户希望获取钱包拥有的 NFT
  • 用户希望查找大额 SOL 转账（巨鲸检测）
  • 用户希望获取 Solana 网络健康状况、TPS、纪元或 SOL 价格
  • 用户询问“BONK/JUP/SOL 的价格是多少？”

前提条件​

辅助脚本仅使用 Python 标准库（urllib, json, argparse）。 无需外部包。

定价数据来自 CoinGecko 的免费 API（无需密钥，速率限制为 ~10-30 次请求/分钟）。为了更快的查询，请使用 --no-prices 标志。

快速参考​

RPC 端点（默认）：https://api.mainnet-beta.solana.com 覆盖：export SOLANA_RPC_URL=https://your-private-rpc.com

辅助脚本路径：~/.hermes/skills/blockchain/solana/scripts/solana_client.py

python3 solana_client.py wallet   <address> [--limit N] [--all] [--no-prices]
python3 solana_client.py tx       <signature>
python3 solana_client.py token    <mint_address>
python3 solana_client.py activity <address> [--limit N]
python3 solana_client.py nft      <address>
python3 solana_client.py whales   [--min-sol N]
python3 solana_client.py stats
python3 solana_client.py price    <mint_or_symbol>

过程​

0. 设置检查​

python3 --version

# Optional: set a private RPC for better rate limits
export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"

# Confirm connectivity
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats

1. 钱包投资组合​

获取 SOL 余额、带有美元价值的 SPL 代币持有情况、NFT 数量以及 投资组合总额。代币按价值排序，过滤掉粉尘代币，已知代币 标记名称（BONK, JUP, USDC 等）。

python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

标志：

  • --limit N — 显示前 N 个代币（默认：20）
  • --all — 显示所有代币，无粉尘过滤，无限制
  • --no-prices — 跳过 CoinGecko 价格查询（更快，仅 RPC）

输出包括：SOL 余额 + 美元价值、按价值排序的带价格代币列表、粉尘代币数量、NFT 摘要、以美元计的投资组合总价值。

2. 交易详情​

通过其 base58 签名检查完整交易。显示 SOL 和美元的双重余额变化。

python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  tx 5j7s8K...your_signature_here

输出：槽位、时间戳、费用、状态、余额变化（SOL + 美元）、 程序调用。

3. 代币信息​

获取 SPL 代币元数据、当前价格、市值、供应量、小数位数、 铸造/冻结权限以及前 5 名持有者。

python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  token DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

输出：名称、符号、小数位数、供应量、价格、市值、前 5 名 持有者及其百分比。

4. 近期活动​

列出地址的近期交易（默认：最近 10 笔，最大：25 笔）。

python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  activity 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM --limit 25

5. NFT 投资组合​

列出钱包拥有的 NFT（启发式方法：数量为 1、小数位数为 0 的 SPL 代币）。

python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  nft 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

注意：此启发式方法无法检测压缩 NFT (cNFT)。

6. 巨鲸检测器​

扫描最新区块中的大额 SOL 转账及其美元价值。

python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py \
  whales --min-sol 500

注意：仅扫描最新区块——时间点快照，非历史记录。

7. 网络统计​

实时 Solana 网络健康状况：当前槽位、纪元、TPS、供应量、验证者 版本、SOL 价格和市值。

python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats

8. 价格查询​

通过铸造地址或已知符号快速查询任何代币的价格。

python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price BONK
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price JUP
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price SOL
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py price DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

已知符号：SOL, USDC, USDT, BONK, JUP, WETH, JTO, mSOL, stSOL, PYTH, HNT, RNDR, WEN, W, TNSR, DRIFT, bSOL, JLP, WIF, MEW, BOME, PENGU。

陷阱​

  • CoinGecko 速率限制 — 免费层级允许每分钟约 10-30 次请求。 价格查询每个代币使用 1 次请求。拥有大量代币的钱包可能无法获取所有代币的价格。使用 --no-prices 以提高速度。
  • 公共 RPC 速率限制 — Solana 主网公共 RPC 对请求有限制。 对于生产环境使用，请将 SOLANA_RPC_URL 设置为私有端点（Helius、QuickNode、Triton）。
  • NFT 检测基于启发式规则 — 数量为 1 + 小数位为 0。压缩 NFT（cNFT）和 Token-2022 NFT 不会显示。
  • 巨鲸探测器仅扫描最新区块 — 非历史数据。结果因查询时刻不同而异。
  • 交易历史 — 公共 RPC 保留约 2 天的数据。较早的交易可能不可用。
  • 代币名称 — 约 25 种知名代币会显示名称标签。其他代币显示缩写后的铸造地址。使用 token 命令获取完整信息。
  • 429 错误重试 — RPC 和 CoinGecko 调用在遇到速率限制错误时，均采用指数退避策略最多重试 2 次。

验证​

# Should print current Solana slot, TPS, and SOL price
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats