跳到主要內容

Base

查詢 Base（以太坊 L2）區塊鏈數據並附帶 USD 定價——包括錢包餘額、代幣信息、交易詳情、Gas 分析、合約檢查、巨鯨檢測以及實時網絡統計。使用 Base RPC + CoinGecko。無需 API 密鑰。

技能元數據​

來源可選 — 使用 hermes skills install official/blockchain/base 安裝
路徑optional-skills/blockchain/base
版本0.1.0
作者youssefea
許可證MIT
標籤Base, Blockchain, Crypto, Web3, RPC, DeFi, EVM, L2, Ethereum

參考：完整 SKILL.md​

信息

以下是 Hermes 在觸發此技能時加載的完整技能定義。這是技能激活時代理所看到的指令。

Base 區塊鏈技能

查詢 Base（以太坊 L2）鏈上數據，並通過 CoinGecko enrich 以 USD 定價。 8 條命令：錢包投資組合、代幣信息、交易、Gas 分析、 合約檢查、巨鯨檢測、網絡統計和價格查詢。

無需 API 密鑰。僅使用 Python 標準庫（urllib, json, argparse）。

何時使用​

  • 用戶詢問 Base 錢包餘額、代幣持有情況或投資組合價值
  • 用戶希望通過哈希檢查特定交易
  • 用戶希望獲取 ERC-20 代幣元數據、價格、供應量或市值
  • 用戶希望瞭解 Base Gas 成本和 L1 數據費用
  • 用戶希望檢查合約（ERC 類型檢測、代理解析）
  • 用戶希望查找大額 ETH 轉賬（巨鯨檢測）
  • 用戶希望獲取 Base 網絡健康狀況、Gas 價格或 ETH 價格
  • 用戶詢問“USDC/AERO/DEGEN/ETH 的價格是多少？”

前提條件​

輔助腳本僅使用 Python 標準庫（urllib, json, argparse）。 無需外部包。

定價數據來自 CoinGecko 的免費 API（無需密鑰，速率限制 約為 ~10-30 次請求/分鐘）。為了更快的查詢，請使用 --no-prices 標誌。

快速參考​

RPC 端點（默認）：https://mainnet.base.org 覆蓋：export BASE_RPC_URL=https://your-private-rpc.com

輔助腳本路徑：~/.hermes/skills/blockchain/base/scripts/base_client.py

python3 base_client.py wallet   <address> [--limit N] [--all] [--no-prices]
python3 base_client.py tx       <hash>
python3 base_client.py token    <contract_address>
python3 base_client.py gas
python3 base_client.py contract <address>
python3 base_client.py whales   [--min-eth N]
python3 base_client.py stats
python3 base_client.py price    <contract_address_or_symbol>

流程​

0. 設置檢查​

python3 --version

# Optional: set a private RPC for better rate limits
export BASE_RPC_URL="https://mainnet.base.org"

# Confirm connectivity
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats

1. 錢包投資組合​

獲取 ETH 餘額和帶有 USD 價值的 ERC-20 代幣持有情況。 通過鏈上 balanceOf 調用檢查約 15 種知名的 Base 代幣（USDC, WETH, AERO, DEGEN 等）。 代幣按價值排序，過濾掉粉塵代幣（dust）。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

標誌：

  • --limit N — 顯示前 N 個代幣（默認：20）
  • --all — 顯示所有代幣，無粉塵過濾，無限制
  • --no-prices — 跳過 CoinGecko 價格查詢（更快，僅 RPC）

輸出包括：ETH 餘額 + USD 價值、按價值排序的帶價格代幣列表、粉塵代幣數量、以 USD 計的總投資組合價值。

注意：僅檢查已知代幣。不會發現未知的 ERC-20 代幣。 對於任何代幣，請使用帶有特定合約地址的 token 命令。

2. 交易詳情​

通過哈希檢查完整交易。顯示轉移的 ETH 價值、 使用的 Gas、ETH/USD 費用、狀態以及解碼後的 ERC-20/ERC-721 轉賬。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  tx 0xabc123...your_tx_hash_here

輸出：哈希、區塊、from、to、價值（ETH + USD）、Gas 價格、使用的 Gas、 費用、狀態、合約創建地址（如果有）、代幣轉賬。

3. 代幣信息​

獲取 ERC-20 代幣元數據：名稱、符號、小數位數、總供應量、價格、 市值和合約代碼大小。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

輸出：名稱、符號、小數位數、總供應量、價格、市值。 通過 eth_call 直接從合約讀取名稱/符號/小數位數。

4. Gas 分析​

詳細的 Gas 分析及常見操作的成本估算。 顯示當前 Gas 價格、過去 10 個區塊的基礎費用趨勢、區塊 利用率，以及 ETH 轉賬、ERC-20 轉賬和交換的估算成本。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py gas

輸出：當前 Gas 價格、基礎費用、區塊利用率、10 區塊趨勢、 以 ETH 和 USD 計的成本估算。

注意：Base 是 L2 — 實際交易成本包括取決於 calldata 大小和 L1 Gas 價格的 L1 數據發佈費用。顯示的估算值僅針對 L2 執行。

5. 合約檢查​

檢查地址：確定它是 EOA 還是合約，檢測 ERC-20/ERC-721/ERC-1155 接口，解析 EIP-1967 代理 實現地址。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

輸出：is_contract、代碼大小、ETH 餘額、檢測到的接口 （ERC-20, ERC-721, ERC-1155）、ERC-20 元數據、代理實現地址。

6. 巨鯨檢測器​

掃描最新區塊中具有 USD 價值的大額 ETH 轉賬。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  whales --min-eth 1.0

注意：僅掃描最新區塊—時間點快照，非歷史數據。 默認閾值為 1.0 ETH（低於 Solana 的默認值，因為 ETH 價值較高）。

7. 網絡統計​

實時 Base 網絡健康狀況：最新區塊、鏈 ID、Gas 價格、基礎費用、 區塊利用率、交易計數和 ETH 價格。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats

8. 價格查詢​

通過合約地址或已知符號快速查詢任何代幣的價格。

python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price ETH
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price USDC
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price AERO
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price DEGEN
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

已知代幣符號：ETH、WETH、USDC、cbETH、AERO、DEGEN、TOSHI、BRETT、 WELL、wstETH、rETH、cbBTC。

注意事項​

  • CoinGecko 速率限制 — 免費層級允許每分鐘約 10-30 次請求。 價格查詢每個代幣消耗 1 次請求。使用 --no-prices 以提高速度。
  • 公共 RPC 速率限制 — Base 的公共 RPC 對請求有限制。 生產環境中，請將 BASE_RPC_URL 設置為私有端點 （Alchemy、QuickNode、Infura）。
  • 錢包僅顯示已知代幣 — 與 Solana 不同，EVM 鏈沒有內置的“獲取所有代幣”RPC。錢包命令通過 balanceOf 檢查約 15 種流行的 Base 代幣。未知的 ERC-20 代幣不會顯示。對任何特定合約使用 token 命令。
  • 從合約讀取代幣名稱 — 如果合約未實現 name() 或 symbol()，這些字段可能為空。已知代幣具有硬編碼標籤作為後備。
  • Gas 估算僅針對 L2 — Base 交易成本包括 L1 數據發佈費用（取決於 calldata 大小和 L1 Gas 價格）。gas 命令僅估算 L2 執行成本。
  • 巨鯨探測器僅掃描最新區塊 — 非歷史數據。結果因查詢時刻而異。默認閾值為 1.0 ETH。
  • 代理檢測 — 僅檢測 EIP-1967 代理。其他代理模式（EIP-1167 最小代理、自定義存儲槽）未被檢查。
  • 429 錯誤重試 — RPC 和 CoinGecko 調用在遇到速率限制錯誤時，最多重試 2 次，並採用指數退避策略。

驗證​

# Should print Base chain ID (8453), latest block, gas price, and ETH price
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats