eth-readonly

What This Skill Does

The eth-readonly skill provides a robust, non-custodial interface for querying Ethereum blockchain data. It transforms an AI agent into a sophisticated block explorer, enabling it to retrieve real-time state, historical transaction data, account balances, and smart contract details. By leveraging Foundry's cast utility or fallback JSON-RPC cURL requests, this skill ensures consistent data retrieval without needing to store private keys or handle transactional payloads. This is a purely read-only utility designed for intelligence gathering, auditing, and research.

Installation

You can install the skill directly into your OpenClaw environment using the following command: clawhub install openclaw/skills/skills/apexfork/eth-readonly Once installed, ensure that your system has cast (part of the Foundry toolchain) installed for optimal performance. You can verify this by running command -v cast in your terminal.

Use Cases

• Contract Auditing: Quickly inspect bytecode of a deployed contract at a specific address to verify implementations.
• Portfolio Monitoring: Track ETH balances for specific addresses or ENS names in real-time.
• Transaction Verification: Look up receipt data, gas usage, and confirmation statuses for historical transactions.
• Network Research: Query the latest block number or verify the chain ID before proceeding with cross-chain interactions.
• ENS Integration: Seamlessly translate between human-readable ENS names and hexadecimal Ethereum addresses.

Example Prompts

1. "Check the current ETH balance for vitalik.eth and explain the output in human-readable terms."
2. "Look up the transaction receipt for 0x5c50... and tell me if it was successful and how much gas it consumed."
3. "Fetch the deployed bytecode for the USDC contract on Ethereum mainnet and check if it is verified."

Tips & Limitations

• Rate Limits: Always be mindful of public RPC rate limits. If your queries are failing, consider setting up a private Infura, Alchemy, or QuickNode project ID.
• Read-Only Guarantee: This skill does not store or utilize private keys. It is physically incapable of signing transactions, ensuring that your wallet assets remain secure regardless of the prompts provided.
• Environment Variables: For seamless operation, set your preferred RPC URL as an environment variable (ETH_RPC_URL).
• Performance: While cast is highly recommended, the skill includes logic to fall back to raw HTTP calls if Foundry tools are unavailable, ensuring the agent remains functional in various containerized environments.