Watching Contracts & Wallets
Watch the contracts and wallets behind your protocol to bring their on-chain data into your contract.dev workspace.
Once watched, contract.dev collects their activity and available contract information, allowing you to:
- Track metrics — Chart balances, contract values and activity over time.
- Build tables — Organise data into structured views, such as lending markets, liquidity positions or swaps.
- Set up notifications — Receive scheduled reports and alerts about important activity or conditions.
- Ask questions — Use your coding agent to investigate your protocol’s activity and data.
Watched contracts and wallets are available throughout your workspace, including its overview, metrics, tables and notifications.
Watch a contract or wallet
Watch a contract or wallet by its address and chain.
- Open Contracts or Wallets from your workspace sidebar.
- Select + Watch contract or + Watch wallet.
- Choose the chain and enter the address.
- Optionally give it a name, then select Watch contract or Watch wallet.
The address is added to your workspace, and contract.dev begins collecting its on-chain activity and history.
Contract information
For a contract, contract.dev retrieves publicly verified information where available, including its name and ABI. The ABI lets contract.dev decode its events.
A contract without a verified ABI can still be watched. Paste its ABI when watching it, or later under Settings on the contract’s page.
Watch with your agent or the CLI
Your coding agent can find and watch the contracts behind your protocol. See Agent Quickstart.
To watch an address from the CLI:
# Watch a contract on Base
contract-dev watch 0x9809480a33C0F341B08EdDBe937d383Bc6C31E8f --chain 8453Groups
Groups organise related contracts, or related wallets, within your workspace.
For example:
- Lending markets — Markets belonging to a lending protocol.
- Liquidity pools — Pools deployed by a DEX.
- Treasury wallets — Wallets holding your protocol’s assets.
Groups are used to analyse activity across several addresses, add up metrics, build tables and apply notification rules.
A group holds contracts or wallets, not both. An address can belong to more than one group.
Automatically discover contracts
contract.dev can discover contracts through a factory or a registry:
- Factory — Watch every pool a DEX factory deploys, found from its creation event.
- Registry — Watch every market a protocol’s registry lists, found by reading it.
Contracts deployed or registered so far are discovered and watched. With a group chosen, new contracts are then watched and added to the group every few minutes.
To set up discovery in the app:
- Select + Watch contract, then From a registry or factory.
- Choose A factory announces them or A registry lists them, and enter its address.
- Choose a group, then select Watch contracts.
Your coding agent can also set it up, or use group rule add.