Watch Contracts

Manage the contracts your workspace watches. Watched contracts appear on Overview, in the Contracts console and in Activity.

Requires contract.dev login.

`watch <address>`

Watch a contract.


# A contract on Ethereum (chain 1 is the default)
contract.dev watch 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --name "USDC"
 
# A contract on Avalanche
contract.dev watch 0xVault… --chain 43114 --name "Vault"


Watching USDC (0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) on chain 1

Flag	Description
`--chain <id\|name>`	Chain the contract lives on, by id or name (`ethereum`, `arbitrum`, `avalanche`, `sepolia`). Default: `1`.
`--name <label>`	Display name. Omit to use the app’s name for the address, else the token’s `name()`, else its verified name.
`--abi <file>`	ABI for a contract without verified source: a JSON array, or a Foundry or Hardhat artifact. Names its methods, events and reverts across the app. Ignored once the contract is verified.

Contracts are watched per (chain, address). Watching is available on Ethereum (1), Arbitrum (42161), Avalanche (43114) and Sepolia (11155111); a contract elsewhere is refused.

`watch list`


contract.dev watch list                  # everything
contract.dev watch list --chain 43114    # one chain


1        0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48  USDC                         $61.21B
43114    0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7  USDt                         $1.02B

The last column is the contract’s TVL: — when it is unknown, … while a just-watched contract’s first value is read.

`rename <address> <name>`

Rename a watched contract. Pass "" to clear the name and fall back to the detected one.


contract.dev rename 0xA0b8… "USDC (mainnet)"
contract.dev rename 0xVault… "Vault v3" --chain 43114

`unwatch <address>`

Stop watching a contract. It is removed from Overview, the console and Activity. Metrics and monitors on the address are unaffected.


contract.dev unwatch 0xVault… --chain 43114

--chain disambiguates contracts watched on several chains.

Nouns

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