Перейти к основному содержимому

Solana

Запрос данных блокчейна Solana с ценами в USD — балансы кошельков, портфели токенов со стоимостью, детали транзакций, NFT, обнаружение «китов» и живые сетевые статистики. Использует Solana RPC + CoinGecko. API-ключ не требуется.

Метаданные навыка​

ИсточникОпционально — установка через vibeos skills install official/blockchain/solana
Путьoptional-skills/blockchain/solana
Версия0.2.0
АвторDeniz Alagoz (gizdusum), доработано VibeOS
ЛицензияMIT
Платформыlinux, macos, windows
ТегиSolana, Blockchain, Crypto, Web3, RPC, DeFi, NFT

Справочник: полный SKILL.md​

к сведению

Далее приведено полное определение навыка, которое VibeOS загружает при его активации. Это те инструкции, которые видит агент, когда навык активен.

Навык блокчейна Solana

Запрос ончейн-данных Solana, обогащённых ценами в USD через CoinGecko. 8 команд: портфель кошелька, информация о токене, транзакции, активность, NFT, обнаружение «китов», сетевая статистика и поиск цен.

API-ключ не нужен. Использует только стандартную библиотеку Python (urllib, json, argparse).

Когда использовать​

  • Пользователь запрашивает баланс кошелька Solana, токены или стоимость портфеля
  • Пользователь хочет просмотреть конкретную транзакцию по сигнатуре
  • Пользователь хочет метаданные SPL-токена, цену, эмиссию или крупнейших держателей
  • Пользователь хочет историю недавних транзакций для адреса
  • Пользователь хочет NFT, принадлежащие кошельку
  • Пользователь хочет найти крупные переводы SOL (обнаружение «китов»)
  • Пользователь хочет состояние сети Solana: TPS, эпоха, цена SOL
  • Пользователь спрашивает «какая цена BONK/JUP/SOL?»

Предварительные требования​

Вспомогательный скрипт использует только стандартную библиотеку Python (urllib, json, argparse). Внешние пакеты не требуются.

Ценовые данные поступают из бесплатного API CoinGecko (ключ не нужен, ограничение ~10–30 запросов/мин). Для ускорения используйте флаг --no-prices.

Краткая справка​

RPC-эндпоинт (по умолчанию): https://api.mainnet-beta.solana.com Переопределение: export SOLANA_RPC_URL=https://your-private-rpc.com

Путь к вспомогательному скрипту: ~/.vibeos/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

# Опционально: укажите приватный RPC для лучших лимитов
export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"

# Проверка соединения
python3 ~/.vibeos/skills/blockchain/solana/scripts/solana_client.py stats

1. Портфель кошелька​

Получить баланс SOL, SPL-токены со стоимостью в USD, количество NFT и общую стоимость портфеля. Токены отсортированы по стоимости, «пыль» отфильтрована, известные токены подписаны названиями (BONK, JUP, USDC и т.д.).

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

Флаги:

  • --limit N — показать топ N токенов (по умолчанию: 20)
  • --all — показать все токены, без фильтра «пыли», без лимита
  • --no-prices — пропустить запросы цен CoinGecko (быстрее, только RPC)

Вывод включает: баланс SOL + стоимость в USD, список токенов с ценами, отсортированный по стоимости, количество «пыли», сводка NFT, общая стоимость портфеля в USD.

2. Детали транзакции​

Просмотр полной транзакции по её base58-сигнатуре. Показывает изменения баланса как в SOL, так и в USD.

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

Вывод: слот, временная метка, комиссия, статус, изменения баланса (SOL + USD), вызовы программ.

3. Информация о токене​

Получить метаданные SPL-токена, текущую цену, рыночную капитализацию, эмиссию, десятичные знаки, mint/freeze-авторитеты и топ-5 держателей.

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

Вывод: название, символ, десятичные знаки, эмиссия, цена, рыночная капитализация, топ-5 держателей с процентами.

4. Недавняя активность​

Список недавних транзакций для адреса (по умолчанию: последние 10, макс: 25).

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

5. Портфель NFT​

Список NFT, принадлежащих кошельку (эвристика: SPL-токены с amount=1, decimals=0).

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

Примечание: сжатые NFT (cNFTs) этой эвристикой не обнаруживаются.

6. Детектор «китов»​

Сканирование последнего блока на предмет крупных переводов SOL со стоимостью в USD.

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

Примечание: сканируется только последний блок — моментальный снимок, не исторический.

7. Сетевая статистика​

Состояние сети Solana в реальном времени: текущий слот, эпоха, TPS, эмиссия, версия валидатора, цена SOL и рыночная капитализация.

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

8. Поиск цены​

Быстрая проверка цены любого токена по адресу mint или известному символу.

python3 ~/.vibeos/skills/blockchain/solana/scripts/solana_client.py price BONK
python3 ~/.vibeos/skills/blockchain/solana/scripts/solana_client.py price JUP
python3 ~/.vibeos/skills/blockchain/solana/scripts/solana_client.py price SOL
python3 ~/.vibeos/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 — публичный RPC основной сети Solana ограничивает запросы. Для продакшена установите SOLANA_RPC_URL на приватный эндпоинт (Helius, QuickNode, Triton).
  • Эвристика обнаружения NFT — amount=1 + decimals=0. Сжатые NFT (cNFTs) и Token-2022 NFT не отобразятся.
  • Детектор «китов» сканирует только последний блок — не исторический. Результаты зависят от момента запроса.
  • История транзакций — публичный RPC хранит ~2 дня. Более старые транзакции могут быть недоступны.
  • Названия токенов — ~25 известных токенов подписаны названиями. Остальные показывают сокращённые адреса mint. Используйте команду token для полной информации.
  • Повтор при 429 — как RPC, так и CoinGecko повторяют запросы до 2 раз с экспоненциальной задержкой при ошибках лимита.

Проверка​

# Должен вывести текущий слот Solana, TPS и цену SOL
python3 ~/.vibeos/skills/blockchain/solana/scripts/solana_client.py stats