A secure, read-only Ethereum query tool for inspecting blockchain state, balances, and contracts via RPC and Etherscan APIs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install eth-readonly
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install eth-readonly using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is eth-readonly: Ethereum Blockchain Explorer?
The eth-readonly skill is a specialized toolset designed for developers and researchers who need to interact with the Ethereum blockchain in a secure, non-transactional manner. By leveraging either Foundry's cast utility or standard curl commands, this component of Openclaw Skills allows for the seamless inspection of blocks, transactions, and smart contract states without the risks associated with private key management. It serves as a bridge to real-time on-chain data, providing a high-fidelity window into the Ethereum ecosystem.
This skill is built with safety as a primary focus, ensuring that users can explore historical data and current network status across Mainnet and Testnets. Whether you are debugging a smart contract, tracking a high-value wallet, or analyzing gas trends, the eth-readonly skill integrates directly into your AI workflow to provide technical insights with minimal overhead.
eth-readonly: Ethereum Blockchain Explorer Use Cases
- Resolving ENS names like vitalik.eth to hexadecimal addresses for verification.
- Checking account balances and nonces to debug transaction status on Mainnet or Sepolia.
- Retrieving and decoding smart contract source code and ABI data via Etherscan API.
- Monitoring real-time gas prices and base fees to optimize future transaction timing.
- Filtering historical event logs for specific contract interactions within narrow block ranges.
How eth-readonly: Ethereum Blockchain Explorer Works
- The user provides a query parameter, such as a wallet address, transaction hash, or contract function.
- The skill identifies the available toolset on the host system, preferring Foundry's cast for performance or falling back to raw JSON-RPC via curl.
- It connects to a configured Ethereum RPC endpoint (public or private) to fetch the requested state data.
- For metadata or history not easily available via RPC, the skill optionally calls the Etherscan API to retrieve verified source code or transaction lists.
- The resulting data is parsed and presented in a human-readable format, allowing for further analysis or integration into larger Openclaw Skills workflows.
eth-readonly: Ethereum Blockchain Explorer Setup
To get started with this skill in the Openclaw Skills environment, configure your RPC endpoint:
export ETH_RPC_URL="https://ethereum.publicnode.com"
For advanced features like contract source retrieval, set your Etherscan API key:
export ETHERSCAN_API_KEY="your_api_key_here"
Ensure either Foundry (cast) or curl is installed on your system path. Verify the installation:
cast --version || curl --version
eth-readonly: Ethereum Blockchain Explorer Data Schema & Taxonomy
The eth-readonly skill handles various data types returned from the EVM.
| Data Type | Description | Example Format |
|---|---|---|
| Balance | Account holdings in Wei | 2139127306712808209 |
| Transaction | Full JSON object of tx details | { "hash": "0x...", "value": "..." } |
| Logs | Filtered event data | { "address": "0x...", "topics": [...] } |
| Source Code | Verified Solidity contract code | String/JSON from Etherscan |
eth-readonly: Ethereum Blockchain Explorer Advanced Features
- Multi-network support allowing seamless switching between Mainnet, Sepolia, and Holesky via environment variables.
- Intelligent fallback mechanisms that switch from cast to curl if the Foundry toolkit is unavailable.
- Automated ABI decoding for 4-byte selectors and complex function outputs to simplify data interpretation.
- Optimized log querying with mandatory block range limits to prevent RPC rate-limiting and maximize efficiency.
- Direct integration with Etherscan Pro and Free tiers for comprehensive transaction history and gas oracles.
SKILL.md
Loading
Related Openclaw Skills
Ethereum Node Administration
A specialized toolset for managing, monitoring, and troubleshooting Ethereum execution layer nodes like Reth and Geth.
KitchenOwl CLI
A robust command-line interface for managing KitchenOwl recipes, shopping lists, and household data.
fal.ai Generative AI Suite
A powerful interface to browse and execute over 1,000 generative AI models for media creation via fal.ai.
Network Scan
A powerful networking utility that leverages nmap to scan ports and identify active devices across various IP target formats.
IPFS Server Operations
A comprehensive toolset for deploying and managing full IPFS nodes, including content pinning, IPNS publishing, and gateway services.
yt-dlp Video Downloader
A robust media downloader that leverages yt-dlp to fetch video, audio, and subtitles from thousands of websites.
Featured*
