Skip to main content

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.
  1. Read the contract metadata and ABI.
  2. Search the source for the behavior or permission you need.
  3. On a fully indexed chain, inspect recent calls and event emissions.
  4. 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.
For contracts on Base, Ethereum, or Monad, pair contract metadata with Transaction Tools to see real parameter and approval patterns.