docs: Add contract, holders, logs to all documentation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: GrapeInTheTree

CHANGELOG.md

@@ -38,6 +38,12 @@ Format based on [Keep a Changelog](https://keepachangelog.com/).
 - **`CallContract()`** RPC function — `eth_call` wrapper
 - **`DecodeRawOutputs()`** — returns raw Go types (not strings) for programmatic use
 - **22 unit tests** for ABI helper functions (ParseCallSignature, ConvertArg, FormatValue, BuildCalldata)
+- **`butler contract <address>`** — contract source code, compiler, deployer, verification status via Chiliscan API
+- **`butler holders <token>`** — top token holders with balances + total holder count via Chiliscan API
+- **`butler logs`** — on-chain event log filtering via RPC `eth_getLogs`
+  - `--address`, `--event`, `--blocks`, `--from-block`, `--to-block` flags
+  - Event signature auto-hashed to topic0 via keccak256
+- **`butler address` internal transactions** — internal (trace) txns via Chiliscan API
 - **Contact name resolution** — all address commands accept names from `contacts.json`
   - Case-insensitive partial match: `butler address danial` → resolves to 0xef33...
   - Actionable error messages: "address or contact not found" with hint

CLAUDE.md

@@ -58,6 +58,9 @@ butler call <contract> <sig> [args] # Generic read-only contract call (eth_call)
 butler validators                   # Chiliz validator set + staking status
 butler staking <addr>               # Personal staking positions + rewards
 butler token <contract>             # Token metadata via Chiliscan API
+butler contract <addr>              # Contract source, compiler, deployer
+butler holders <token>              # Top token holders + count
+butler logs --address --event       # On-chain event logs (eth_getLogs)
 butler rpc <method> [params]        # Raw JSON-RPC escape hatch
 butler init                         # Initialize config in ~/.butler/
 butler version                      # Build version and commit hash

README.md

@@ -114,6 +114,9 @@ butler call <contract> <sig> [args] Read-only contract call (eth_call)
 butler validators                   Chiliz validator set and staking status
 butler staking <addr>               Personal staking positions and rewards
 butler token <contract>             Token metadata, price, and social links
+butler contract <addr>              Contract info: name, compiler, deployer, verified
+butler holders <token>              Top token holders and total holder count
+butler logs --address --event       On-chain event log filtering via eth_getLogs (RPC)
 butler rpc <method> [params]        Raw JSON-RPC escape hatch
 butler init                         Initialize config (~/.butler/)
 butler version                      Print version and build info