好奇心花园🪴

搜索

SearchSearch

最近的笔记

Solana

2026年5月24日7分钟阅读

{/* 此页面由 website/scripts/generate-skill-docs.py 从技能的 SKILL.md 自动生成。请编辑源文件 SKILL.md，而非此页面。 */}

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
平台linux, macos, windows
标签Solana, Blockchain, Crypto, Web3, RPC, DeFi, NFT

参考：完整 SKILL.md

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

Solana 区块链技能

查询 Solana 链上数据，并通过 CoinGecko 获取美元定价。 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   <地址> [--limit N] [--all] [--no-prices]
python3 solana_client.py tx       <签名>
python3 solana_client.py token    <铸币地址>
python3 solana_client.py activity <地址> [--limit N]
python3 solana_client.py nft      <地址>
python3 solana_client.py whales   [--min-sol N]
python3 solana_client.py stats
python3 solana_client.py price    <铸币地址或符号>

操作步骤

0. 安装检查

python3 --version
 
# 可选：设置私有 RPC 以获得更好的速率限制
export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"
 
# 确认连接
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...你的签名

输出：插槽、时间戳、手续费、状态、余额变化（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（启发式方法：amount=1, decimals=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 检测为启发式 —— amount=1 + decimals=0。压缩 NFT（cNFT）和 Token-2022 NFT 不会显示。
  • 大户检测器仅扫描最新区块 —— 非历史数据。结果因查询时刻而异。
  • 交易历史 —— 公共 RPC 保留约 2 天。较早的交易可能不可用。
  • 代币名称 —— 约 25 种知名代商标注了名称。其他代币显示缩写的铸币地址。使用 token 命令获取完整信息。
  • 429 错误重试 —— RPC 和 CoinGecko 调用在遇到速率限制错误时会重试最多 2 次，采用指数退避。

验证

# 应该打印当前 Solana 插槽、TPS 和 SOL 价格
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats

关系图谱

反向链接