Skip to Content
CLIWatch Contracts

Watch Contracts

Manage the contracts and wallets the workspace watches. See Watching.

Requires contract-dev login.

watch <address>

Watch a contract.

contract-dev watch <address> --chain <id|name> [--name <label>] [--abi <file>] [--about "<role>" | --no-about]
FlagDescription
--chain <id|name>Chain the contract lives on. Required: an address is on every chain.
--name <label>Display name. Omit to use the app’s name for the address, else the token’s name(), else its verified name. Change it later with rename.
--abi <file>ABI for a contract with no verified source: a JSON array, or a Foundry or Hardhat artifact (out/X.sol/X.json); - reads stdin. Names its methods, events and reverts across the app. Ignored once the contract is verified.
--about "<role>"One or two sentences on what the contract does in the protocol, read from its source. Added to the workspace’s brief under its name, or the group’s. See workspace brief.
--no-aboutWatch without adding to the brief: a setup that ends by writing the whole brief.
contract-dev watch 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --chain ethereum --name "USDC" contract-dev watch 0xVault… --chain arbitrum --abi out/Vault.sol/Vault.json
Watching USDC (0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) on chain 1

Contracts are watched per chain and address. A contract with no verified ABI is watched, and the CLI prints how to add one with --abi or contracts set-abi. An address with no code is refused, with the watch wallet command for it.

A coding agent gives --about, or --no-about; without either, an agent’s watch is refused and nothing is watched. A person at a terminal may leave both out. With --about, the output ends Added to the workspace's brief.

Several at once

contract-dev watch <address>[=<name>]… --chain <id|name> [--group <name>] [--about "<role>" | --no-about]

Several addresses, or one with --group, are watched in one call. Each is checked, a wallet is skipped, and the rest are tagged into the group when one is named. Name each address where it stands: 0xae7a…fE84=stETH, or "0x889e…F9B1=Withdrawal Queue" in quotes when the name has spaces. An address with no name takes the explorer’s. --abi goes with one address, without --group.

contract-dev watch 0xae7ab96520de3a18e5e111b5eaab095312d7fe84=stETH \ "0x889edc2edab5f40e902b864ad4d7ade8e412f9b1=Withdrawal Queue" --chain ethereum --group Lido
Watched 2 · already watched 0 · skipped 0 (not a contract) · failed 0

factory <address> --watch --group <name> does the same for everything a factory deployed.

watch list

List watched contracts: chain, address, name.

contract-dev watch list [--chain <id|name>]
1 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 USDC 42161 0x9a3f5c27d1e04b6a8f2c7e1d3b5a9c8e7f6d12cd Vault

watch wallet <address>

Watch a wallet: an address with no code, such as a treasury, a deployer or a market maker.

contract-dev watch wallet <address> --chain <id|name> [--name <label>] [--group <name>] [--about "<role>" | --no-about]
FlagDescription
--chain <id|name>Chain to watch it on. Required. Watch it on another chain with a second call.
--name <label>Display name.
--group <name>Put it in a group of wallets. A group holds contracts or wallets, never both.
--about "<role>", --no-aboutAs for watch.

An address with code is refused here, with the watch command for it. A wallet’s activity reads like a contract’s: query transactions --contract <name> for what it sent and received, query transfers --contract <name> --out for what left it. See Ask and Explore.

wallets

contract-dev wallets list [--chain <id|name>] # chain, address, name contract-dev wallets add <address> [flags] # the same as watch wallet contract-dev wallets rename <address> <name> [--chain <id>] # "" clears the name contract-dev wallets remove <address> [--chain <id>] # its monitors and tracked values go with it

rename <address> <name>

Rename a watched contract or wallet. The name is shown everywhere in the app. Pass "" to clear it.

contract-dev rename 0xA0b8… "USDC (mainnet)" contract-dev rename 0xVault… "Vault v3" --chain arbitrum
Renamed 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 to "USDC (mainnet)".

--chain picks between the same address watched on several chains.

contracts set-abi <address>

Set the ABI on a contract already watched, or remove it.

contract-dev contracts set-abi <address> --abi <file> [--chain <id>] contract-dev contracts set-abi <address> --clear [--chain <id>]
FlagDescription
--abi <file>The ABI to store: a JSON array or a Foundry or Hardhat artifact. - reads stdin.
--clearRemove the stored ABI, so the explorer’s is read again.
--chain <id|name>Picks between the same address watched on several chains.
jq '.abi' out/Vault.sol/Vault.json | contract-dev contracts set-abi 0xVault… --abi -
ABI saved for 0x9a3f5c27d1e04b6a8f2c7e1d3b5a9c8e7f6d12cd. Its methods, events and reverts are named across the app.

A verified contract’s explorer ABI always wins; an ABI set on it is never read.

contracts show <contract>

One watched contract at a glance: what it is (proxy, token, owner, deployer, ABI), its last 24 hours (transactions, wallets, a token’s own volume), its monitors and tracked metrics. <contract> is the contract’s address or name; an address the workspace does not watch is refused.

contract-dev contracts show USDC

unwatch <address>

Stop watching one or several contracts.

contract-dev unwatch <address> [<address|name>…] [--chain <id>]

Unwatching deletes the contract’s monitors and tracked values, with their history. One contract is named by its address; several by address or name, up to 25 at a time, and every one is matched before anything is removed.

contract-dev unwatch Vault "Withdrawal Queue"
Stopped watching Vault (0x9a3f5c27d1e04b6a8f2c7e1d3b5a9c8e7f6d12cd on chain 42161) · removed 1 monitor and 2 tracked values. Stopped watching Withdrawal Queue (0x889edc2edab5f40e902b864ad4d7ade8e412f9b1 on chain 1).

factory <address>

The contracts a factory deployed: how many, the newest with their dates, which are watched.

contract-dev factory <address> --event <Name> --field <arg> [--chain <id|name>] [--limit <n>] contract-dev factory <address> --event <Name> --field <arg> --watch --group <name>
FlagDescription
--event <Name>The factory’s event that announces a new contract: PoolCreated, MarketDeployed. Required.
--field <arg>The event’s address argument that is the new contract: pool, market. Required.
--chain <id|name>The factory’s chain. Without it, Ethereum is read.
--limit <n>How many of the newest to list: 20 unless set, up to 50.
--watch --group <name>Then watch the ones not yet watched, tagged into the group. Up to 150 at a time, newest first.

Both --event and --field are required: nothing is picked from names. contract-dev describe <factory> lists its events. The new contracts get no invented names: name them with group name-pattern. A long history is read as far as one call allows; the answer then says how far it got, and the total is a floor. On a factory with thousands of children, watch the ones that matter by address instead.

contract-dev factory 0x1F98431c8aD98523631AE4a59f267346ea31F984 --event PoolCreated --field pool --chain ethereum --limit 2
Read PoolCreated.pool 1,204 contracts · 37 watched · 1,167 not watched · the newest, back to 2024-03-11; older ones not read Address Deployed Watched 0x3416cf6c708da44db2624d63ea0aaef7113527c6 2026-10-27 yes 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 2026-10-26 no

A rule keeps a group filled from then on: group rule add.

Nouns

The same commands read as contracts: contracts list, contracts add <address>, contracts rename <address> <name>, contracts remove <address>.

Last updated on