{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}
Solana
Truy vấn dữ liệu chuỗi khối Solana với giá USD - số dư ví, danh mục mã thông báo có giá trị, chi tiết giao dịch, NFT, phát hiện cá voi và thống kê mạng trực tiếp. Sử dụng Solana RPC + CoinGecko. Không cần khóa API.
Siêu dữ liệu kỹ năng
| Nguồn | Tùy chọn — cài đặt với |
| `Hermes skills install official/blockchain/solana | |
| ` | |
| Đường dẫn |
optional-skills/blockchain/solana ` | | Phiên bản |
0.2.0 ` | | Tác giả | Deniz Alagoz (gizdusum), được tăng cường bởi Đặc vụ Hermes | | Giấy phép | MIT | | Nền tảng | Linux, macOS, Windows | | Thẻ |
Solana
, `Blockchain
, `Crypto
, `Web3
, `RPC
, `DeFi
,
NFT |
Tham khảo: đầy đủ SKILL.md
Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.
Kỹ năng chuỗi khối Solana
Truy vấn dữ liệu trên chuỗi của Solana được làm giàu bằng giá USD thông qua CoinGecko. 8 lệnh: danh mục ví, thông tin mã thông báo, giao dịch, hoạt động, NFT, phát hiện cá voi, thống kê mạng và tra cứu giá.
Không cần khóa API. Chỉ sử dụng thư viện chuẩn Python (urllib, JSON, argparse).
Khi nào nên sử dụng
- Người dùng yêu cầu số dư ví Solana, số lượng token nắm giữ hoặc giá trị danh mục đầu tư
- Người dùng muốn kiểm tra một giao dịch cụ thể bằng chữ ký
- Người dùng muốn siêu dữ liệu, giá, nguồn cung cấp hoặc chủ sở hữu mã thông báo SPL
- Người dùng muốn lịch sử giao dịch gần đây cho một địa chỉ
- Người dùng muốn NFT thuộc sở hữu của ví
- Người dùng muốn tìm chuyển SOL lớn (phát hiện cá voi)
- Người dùng muốn tình trạng mạng Solana, TPS, kỷ nguyên hoặc giá SOL
- Người dùng hỏi "giá BONK/JUP/SOL là bao nhiêu?"
Điều kiện tiên quyết
Tập lệnh trợ giúp chỉ sử dụng thư viện chuẩn Python (urllib, JSON, argparse). Không cần gói bên ngoài.
Dữ liệu về giá đến từ API miễn phí của CoinGecko (không cần khóa, giới hạn tỷ lệ đến ~10-30 yêu cầu/phút). Để tra cứu nhanh hơn, hãy sử dụng cờ
--no-prices
.
Tham khảo nhanh
Điểm cuối RPC (mặc định): https://API.mainnet-beta.solana.com Ghi đè: xuất SOLANA_RPC_URL=https://your-private-rpc.com
Đường dẫn tập lệnh trợ giúp: ~/.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
`
Thủ tục
0. Kiểm tra cài đặt
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. Danh mục Ví
Nhận số dư SOL, nắm giữ mã thông báo SPL với giá trị USD, số lượng NFT và
tổng danh mục đầu tư. Mã thông báo được sắp xếp theo giá trị, được lọc bụi, mã thông báo đã biết
được dán nhãn theo tên (BONK, JUP, USDC, v.v.).
`bash
Python3 ~/.Hermes/skills/blockchain/solana/scripts/solana_CLIent.py \
wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
`
``Cờ:
-
--limit N
- hiển thị N mã thông báo hàng đầu (mặc định: 20)
-
--all
- hiển thị tất cả các mã thông báo, không lọc bụi, không giới hạn
-
--no-prices
` — bỏ qua việc tra cứu giá CoinGecko (nhanh hơn, chỉ dành cho RPC)
Đầu ra bao gồm: Số dư SOL + giá trị USD, danh sách token với giá được sắp xếp
theo giá trị, số lượng bụi, tóm tắt NFT, tổng giá trị danh mục đầu tư bằng USD.
### 2. Chi tiết giao dịch
Kiểm tra giao dịch đầy đủ bằng chữ ký base58 của nó. Hiển thị thay đổi số dư
bằng cả SOL và USD.
``` bash
Python3 ~/.Hermes/skills/blockchain/solana/scripts/solana_CLIent.py \
tx 5j7s8K...your_signature_here
`
``Đầu ra: slot, dấu thời gian, phí, trạng thái, thay đổi số dư (SOL + USD),
lời gọi chương trình.
### 3. Thông tin về token
Nhận siêu dữ liệu về mã thông báo SPL, giá hiện tại, vốn hóa thị trường, nguồn cung, số thập phân,
cơ quan đúc tiền/đóng băng và 5 người nắm giữ hàng đầu.
`bash
Python3 ~/.Hermes/skills/blockchain/solana/scripts/solana_CLIent.py \
token DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
`
``Đầu ra: tên, ký hiệu, số thập phân, nguồn cung, giá, vốn hóa thị trường, top 5
người nắm giữ với tỷ lệ phần trăm.
### 4. Hoạt động gần đây
Liệt kê các giao dịch gần đây cho một địa chỉ (mặc định: 10 lần cuối, tối đa: 25).
`bash
Python3 ~/.Hermes/skills/blockchain/solana/scripts/solana_CLIent.py \
activity 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM --limit 25
`
### 5. Danh mục đầu tư NFT
Liệt kê các NFT do ví sở hữu (heuristic: Mã thông báo SPL có số lượng=1, số thập phân=0).
`bash
Python3 ~/.Hermes/skills/blockchain/solana/scripts/solana_CLIent.py \
nft 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
`
``Lưu ý: Phương pháp phỏng đoán này không phát hiện được NFT nén (cNFT).
### 6. Máy dò cá voi
Quét khối gần đây nhất để chuyển khoản SOL lớn với giá trị USD.
`bash
Python3 ~/.Hermes/skills/blockchain/solana/scripts/solana_CLIent.py \
whales --min-sol 500
`
``Lưu ý: chỉ quét khối mới nhất - ảnh chụp nhanh tại một thời điểm, không phải lịch sử.
### 7. Thống kê mạng
Tình trạng mạng Solana trực tiếp: vị trí hiện tại, kỷ nguyên, TPS, nguồn cung cấp, trình xác thực
phiên bản, giá SOL và vốn hóa thị trường.
`bash
Python3 ~/.Hermes/skills/blockchain/solana/scripts/solana_CLIent.py stats
`
### 8. Tra cứu giá
Kiểm tra giá nhanh chóng cho bất kỳ mã thông báo nào theo địa chỉ đúc tiền hoặc ký hiệu đã biết.
`bash
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
`
``Các ký hiệu đã biết: SOL, USDC, USDT, BONK, JUP, WETH, JTO, mSOL, stSOL,
PYTH, HNT, RNDR, WEN, W, TNSR, DRIFT, bSOL, JLP, WIF, MEW, BOME, PENGU.
---
## cạm bẫy- **Giới hạn tỷ lệ của CoinGecko** — bậc miễn phí cho phép ~10-30 yêu cầu/phút.
Tra cứu giá sử dụng 1 yêu cầu cho mỗi mã thông báo. Ví có nhiều token có thể
không nhận được giá cho tất cả chúng. Sử dụng
`
--no-prices
` để có tốc độ.
- **Giới hạn tỷ lệ RPC công khai** — Yêu cầu giới hạn RPC công khai trên mạng chính Solana.
Để sử dụng trong sản xuất, hãy đặt SOLANA_RPC_URL thành điểm cuối riêng tư
(Helius, QuickNode, Triton).
- **Phát hiện NFT là phương pháp phỏng đoán** — số lượng=1 + số thập phân=0. nén
NFT (cNFT) và NFT Token-2022 sẽ không xuất hiện.
- **Máy dò cá voi chỉ quét khối mới nhất** — không phải lịch sử. Kết quả
thay đổi tùy theo thời điểm bạn truy vấn.
- **Lịch sử giao dịch** — RPC công khai giữ ~2 ngày. Giao dịch cũ hơn
có thể không có sẵn.
- **Tên mã thông báo** — ~25 mã thông báo nổi tiếng được gắn nhãn theo tên. Khác
hiển thị địa chỉ đúc tiền viết tắt. Sử dụng lệnh
`token
` để biết thông tin đầy đủ.
- **Thử lại vào số 429** — cả lệnh gọi RPC và CoinGecko đều thử lại tối đa 2 lần
với độ lùi theo cấp số nhân đối với các lỗi giới hạn tỷ lệ.
---
## Xác minh
``` bash
# Should print current Solana slot, TPS, and SOL price
Python3 ~/.Hermes/skills/blockchain/solana/scripts/solana_CLIent.py stats
`
`