Skip to content

feat(skills): add Solana blockchain skill#212

Merged
teknium1 merged 1 commit intoNousResearch:mainfrom
gizdusum:feat/convert-to-hermes-skill
Mar 9, 2026
Merged

feat(skills): add Solana blockchain skill#212
teknium1 merged 1 commit intoNousResearch:mainfrom
gizdusum:feat/convert-to-hermes-skill

Conversation

@gizdusum
Copy link
Copy Markdown
Contributor

What

Converts the Solana blockchain oracle from a Tool (tools/blockchain_oracle/) to a
Skill (skills/blockchain/solana/), as requested by @teknium1 in #164.

Changes

  • skills/blockchain/solana/SKILL.md — full skill documentation with frontmatter,
    7 query procedures, raw curl examples, pitfalls, and verification steps
  • skills/blockchain/solana/scripts/solana_client.py — standalone CLI helper using
    only Python standard library (urllib + argparse, no external deps)

7 Capabilities

Command Description
stats Slot, epoch, TPS, supply, validator version
wallet SOL balance + all SPL token holdings
tx Full transaction details by signature
token SPL token metadata, supply, top 5 holders
activity Recent transaction history (up to 25)
nft NFT portfolio (heuristic: amount=1, decimals=0)
whales Large SOL transfers in the latest block

Usage

python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py stats
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py wallet <address>
python3 ~/.hermes/skills/blockchain/solana/scripts/solana_client.py whales --min-sol 500

No external packages required. Uses public mainnet-beta RPC by default.
Set SOLANA_RPC_URL env var to use a private endpoint (Helius, QuickNode, etc.).

Closes #164

@teknium1 teknium1 merged commit 93c5997 into NousResearch:main Mar 9, 2026
teknium1 added a commit that referenced this pull request Mar 9, 2026
…t output

Enhancements to the Solana blockchain skill (PR #212 by gizdusum):

- CoinGecko price integration (free, no API key)
  - Wallet shows tokens with USD values, sorted by value
  - Token info includes price and market cap
  - Transaction details show USD amounts for balance changes
  - Whale detector shows USD alongside SOL amounts
  - Stats includes SOL price and market cap
  - New `price` command for quick lookups by symbol or mint

- Smart wallet output
  - Tokens sorted by USD value (highest first)
  - Default limit of 20 tokens (--limit N to adjust)
  - Dust filtering (< $0.01 tokens hidden, count shown)
  - --all flag to see everything
  - --no-prices flag for fast RPC-only mode
  - NFT summary (count + first 10)
  - Portfolio total in USD

- Token name resolution
  - 25+ well-known tokens mapped (SOL, USDC, BONK, JUP, etc.)
  - CoinGecko fallback for unknown tokens
  - Abbreviated mint addresses for unlabeled tokens

- Reliability
  - Retry with exponential backoff on 429 rate-limit (RPC + CoinGecko)
  - Graceful degradation when price data unavailable
  - Capped API calls to respect CoinGecko free-tier limits

- Updated SKILL.md with all new capabilities and flags
@teknium1
Copy link
Copy Markdown
Contributor

teknium1 commented Mar 9, 2026

Merged and enhanced! The skill has been:

  1. Moved to optional-skills/ — Solana is a niche use case, so it's installable via Skills Hub rather than bundled for everyone.

  2. Enhanced with USD pricing (CoinGecko, free, no API key):

    • Wallet shows tokens sorted by USD value with portfolio total
    • Token info includes price and market cap
    • Transactions show USD amounts
    • Whale detector shows USD alongside SOL
    • Stats includes SOL price and market cap
    • New price command for quick lookups (price BONK, price SOL)
  3. Smart wallet output:

    • Sorted by value, dust filtered (< $0.01)
    • Default 20 tokens, --limit N, --all, --no-prices flags
    • NFT summary, portfolio total
  4. Reliability: retry with backoff on 429 rate-limit (both RPC and CoinGecko)

  5. 25+ known token names mapped (SOL, USDC, BONK, JUP, WETH, etc.)

Thanks for the solid foundation @gizdusum! 🎉

@gizdusum
Copy link
Copy Markdown
Contributor Author

Thanks for reviewing and merging thisglad you found the Solana skill valuable @teknium1

I’ll keep building on Hermes ❤️

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants