Contract Tools
Herd combines verified source data, ABI analysis, proxy history, deployment records, and token metadata into agent-ready contract context.Available tools
contractMetadataTool follows proxy implementations and returns the complete known implementation history. Use its ABI before searching activity or building a HAL action.
getContractCodeTool accepts multiple addresses and can search implementation code, proxy code, or both. It only works when verified source is available.
getDeployedContractsTool covers direct creates, factory deployments, Safe deployments, and other traced creation paths. Results are paginated.
Recommended workflow
- Read the contract metadata and ABI.
- Search the source for the behavior or permission you need.
- On a fully indexed chain, inspect recent calls and event emissions.
- Use the observed call patterns to build and simulate a HAL action.
Source-backed tools work on registered EVM chains with a configured code explorer. Polygon zkEVM, Sophon, and Swell are currently excluded.

