Network Configuration
Configure blockchain networks for Watch Tower monitoring.
Overview
The Watch Tower monitors multiple blockchain networks simultaneously. Each network is configured in the networks array in your config.json file.
Networks array structure
The configuration file contains a networks array where each element defines a blockchain network to monitor:
{
"networks": [
{
"name": "mainnet",
"rpc": "https://mainnet.infura.io/v3/YOUR_API_KEY",
"deploymentBlock": 17883049,
"filterPolicy": {
"defaultAction": "ACCEPT"
}
}
]
}
Per-network settings
Each network configuration supports the following fields:
name
Required - String identifier for the network.
Supported network names:
mainnet - Ethereum Mainnetsepolia - Ethereum Sepolia testnetarbitrum_one - Arbitrum Oneavalanche - Avalanche C-Chainbase - Basegnosis_chain - Gnosis Chainpolygon - Polygon PoSlinea - Lineaplasma - Plasmaink - Ink
rpc
Required - RPC endpoint URL for connecting to the blockchain. Supports both HTTP(S) and WebSocket protocols.
HTTP RPC:
"rpc": "https://mainnet.infura.io/v3/YOUR_API_KEY"
"rpc": "ws://172.20.0.5:8546"
Conditional order types may consume considerable RPC calls. Ensure your RPC provider has sufficient rate limits.
deploymentBlock
Required - Block number at which the ComposableCoW contract was deployed on the network.
This optimizes the watch-tower by only fetching events from the blockchain after this block number.
"deploymentBlock": 17883049
watchdogTimeout
Optional - Timeout in milliseconds for the watchdog timer. If the watch-tower doesn’t process a block within this time, it will restart.
"watchdogTimeout": 300000
processEveryNumBlocks
Optional - Throttle block processing to only process blocks every N blocks. Default is 1 (process every block).
Process every block:
"processEveryNumBlocks": 1
"processEveryNumBlocks": 2
orderBookApi
Optional - Custom URL for the CoW Protocol OrderBook API. If not specified, uses the default API for the network.
"orderBookApi": "https://api.cow.fi/mainnet/api/v1"
pageSize
Optional - Number of blocks to fetch when querying historical events (eth_getLogs).
Default is 5000, which is the maximum number of blocks that can be fetched in a single request from Infura.
Default (Infura-compatible):
No paging (own RPC node):
If running against your own RPC node, you may set pageSize to 0 to fetch all blocks in one request instead of paging.
filterPolicy
Required - Defines filtering rules for conditional orders. See Filter policy configuration for details.
Supported chains
Ethereum Mainnet:
{
"name": "mainnet",
"rpc": "https://mainnet.infura.io/v3/YOUR_API_KEY",
"deploymentBlock": 17883049
}
{
"name": "sepolia",
"rpc": "https://sepolia.drpc.org",
"deploymentBlock": 8468184
}
{
"name": "arbitrum_one",
"rpc": "https://arb1.arbitrum.io/rpc",
"deploymentBlock": 343493668
}
{
"name": "avalanche",
"rpc": "https://avax-mainnet.g.alchemy.com/v2/YOUR_API_KEY",
"deploymentBlock": 63235114
}
{
"name": "base",
"rpc": "https://mainnet.base.org",
"deploymentBlock": 31084679
}
{
"name": "gnosis_chain",
"rpc": "https://rpc.gnosischain.com",
"deploymentBlock": 40394915
}
{
"name": "polygon",
"rpc": "https://polygon-rpc.com",
"deploymentBlock": 72315184
}
{
"name": "linea",
"rpc": "https://rpc.linea.build",
"deploymentBlock": 25028604
}
{
"name": "plasma",
"rpc": "https://rpc.plasma.to",
"deploymentBlock": 4810535
}
{
"name": "ink",
"rpc": "https://rpc-ten.inkonchain.com",
"deploymentBlock": 37142449
}
Example configuration
Complete example with multiple networks:
{
"networks": [
{
"name": "mainnet",
"rpc": "ws://172.20.0.5:8546",
"deploymentBlock": 17883049,
"pageSize": 5000,
"processEveryNumBlocks": 1,
"filterPolicy": {
"defaultAction": "ACCEPT"
}
},
{
"name": "arbitrum_one",
"rpc": "https://arb1.arbitrum.io/rpc",
"deploymentBlock": 343493668,
"filterPolicy": {
"defaultAction": "ACCEPT"
}
}
]
}
