跳到主要內容

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