# crpc

> Chain-aware RPC CLI — like cast, but better

A blockchain RPC command-line tool with auto ABI encode/decode, 2600+ chains via chainlist.org, Etherscan V2 integration, Multicall3 batching, smart RPC fallback, and offline encode/decode.

## Features

- Auto ABI encode/decode — no manual hex
- 2600+ chains via chainlist.org, zero config
- Etherscan V2 unified API for 60+ chains
- Batch Multicall3 — multiple calls in one RPC request
- Smart RPC fallback with L2 auto-detection
- Offline encode/decode without network
- 18 commands: call, balance, tx, logs, trace, gas, and more
- Built-in token aliases and chain name resolution
- Transaction decoding with event log parsing
- Storage slot reading and cross-block diff

## Commands

| Command | Description |
|---------|-------------|
| call | eth_call with auto ABI encode/decode |
| balance | ERC-20 token balance query |
| allowance | ERC-20 allowance check |
| abi | Fetch contract ABI from Etherscan |
| code | Get contract bytecode size/existence |
| slot | Read contract storage slot |
| block | Get block info |
| tx | Transaction details + receipt + decoded logs |
| logs | Query and decode event logs |
| trace | Debug trace a transaction |
| multi | Batch calls via Multicall3 |
| diff | Compare on-chain values across blocks |
| gas | Current gas prices |
| history | Transaction history |
| transfers | ERC-20 token transfer history |
| chains | List or search 2600+ chains |
| encode | ABI-encode (offline) |
| decode | ABI-decode (offline) |

## Supported Chains

Built-in aliases: eth, base, arb, bsc, polygon, op, avax, linea, scroll, zksync + 2600+ via chainlist.org

## Install

```
curl -fsSL crpc.agent-tools.org/install.sh | sh
# or: cargo install crpc
```

## Links

- Homepage: https://crpc.agent-tools.org
- Repo: https://github.com/sunoj/crpc
- License: MIT
- Parent: https://agent-tools.org