前言¶
在 DeepSeek Harness (DSH) 的插件生態中，讓模型代理直接訪問外部數據是常見需求。對於區塊鏈應用的開發者來說，需要頻繁查詢鏈上狀態、合約信息或交易詳情。xby-blockchain-data-service 插件封裝了 EVM 鏈的數據查詢接口，開發者無需直接處理底層的 RPC 請求，通過 DSH 的工具調用機制即可獲取鏈上數據。
插件概覽¶
該插件由 xby-skill 維護，屬於聯網工具類別。它本質上是一個爲 Vitruveo 網絡提供只讀區塊鏈服務的模型上下文協議 (MCP) 服務器。插件遵循 MIT 許可證，主要面向需要在本地開發調試環境中集成區塊鏈查詢能力的開發者。
核心功能¶
插件提供了以下核心能力：
- 密鑰管理：
set_xby_apikey—— 在聊天中設置 API 密鑰，該設置會自動持久化，重啓後依然有效。 - 鏈與區塊信息：
get_chain_info—— 獲取 EVM 網絡的基礎信息。get_supported_networks—— 獲取支持的 EVM 網絡列表。get_latest_block—— 獲取最新區塊號。get_block_by_number—— 根據區塊號獲取區塊詳情。
- 賬戶與代幣查詢：
get_balance—— 查詢原生代幣餘額（如 ETH, MATIC）。get_erc20_balance/get_token_balance—— 查詢 ERC20 代幣餘額。get_token_info—— 獲取代幣的元數據（名稱、符號、精度、總供應量等）。
- 合約交互：
read_contract—— 調用合約的只讀函數（view/pure），不消耗 Gas。is_contract—— 判斷一個地址是合約地址還是外部賬戶 (EOA)。
- 交易相關：
get_transaction—— 獲取交易詳情（發送方、接收方、數值、數據等）。get_transaction_receipt—— 獲取交易回執。estimate_gas—— 估算交易所需 Gas。
- NFT 與多代幣標準：
get_nft_info—— 獲取 ERC721 NFT 詳情。check_nft_ownership—— 檢查地址是否擁有特定 NFT。get_nft_balance—— 獲取地址在特定集合中的 NFT 總數。get_erc1155_token_uri—— 獲取 ERC1155 標準代幣的元數據 URI。get_erc1155_balance—— 獲取地址對特定 ERC1155 代幣 ID 的持有數量。
安裝與配置¶
使用前需準備 API 密鑰。請前往小笨羊官網註冊並獲取密鑰。
在終端中執行以下命令安裝插件：
dsh plugin --profile web add github:xby_skill/xby-blockchain-data-service
安裝完成後，在 DSH 的對話中通過 set_xby_apikey 命令傳入該密鑰，插件即可開始工作。
典型用法¶
安裝並配置好 API 密鑰後，可以通過以下步驟操作：
- 設置環境：在對話中輸入設置密鑰的指令，確保後續請求有權限訪問服務。
- 查詢網絡信息：調用
get_supported_networks確認當前連接的鏈，或使用get_chain_info獲取網絡參數。 - 查詢餘額：使用
get_balance查詢賬戶的原生代幣餘額，或使用get_token_balance查詢特定 ERC20 代幣餘額。 - 讀取合約：若需獲取合約存儲的數據，使用
read_contract函數，指定合約地址和方法名。 - NFT 查詢：通過
get_nft_info或check_nft_ownership快速分析 NFT 資產。
注意事項¶
- API 依賴：插件依賴小笨羊官網提供的 API 服務，必須先獲取密鑰。
- 本地調試：根據插件說明，該插件目前僅用於本地開發調試。
- 權限與安全：作爲本地調試工具，請確保在受控環境中使用，注意保管 API 密鑰。
結語¶
xby-blockchain-data-service 爲 DSH 用戶提供了標準化的區塊鏈數據查詢入口。通過將複雜的 RPC 操作封裝爲工具函數，降低了智能體開發中集成區塊鏈數據的門檻。相關代碼及文檔位於 GitHub：xby-skill/xby-blockchain-data-service。
