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]| Flag | Description |
|---|---|
--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-about | Watch 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.jsonWatching USDC (0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) on chain 1Contracts 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 LidoWatched 2 · already watched 0 · skipped 0 (not a contract) · failed 0factory <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 Vaultwatch 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]| Flag | Description |
|---|---|
--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-about | As 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 itrename <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 arbitrumRenamed 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>]| Flag | Description |
|---|---|
--abi <file> | The ABI to store: a JSON array or a Foundry or Hardhat artifact. - reads stdin. |
--clear | Remove 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 USDCunwatch <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>| Flag | Description |
|---|---|
--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 2Read 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 noA 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>.