net_listening

net_listening returns a simple boolean telling you whether an OP Mainnet node — the OP Stack rollup that settles to Ethereum L1 and uses ETH for gas — is actively listening for incoming peer-to-peer connections. It is the lightest possible reachability probe: true means the client has its P2P listener open, false means it does not. Call it against https://optimism.therpc.io/YOUR_API_KEY (chain ID 10, 0xa) as a cheap liveness signal in scripts and uptime checks.

Use cases

• Use as a basic liveness check in monitoring scripts that ping your OP Mainnet endpoint on a schedule.
• Verify the node answers before kicking off automated operations such as batch reads or deployment jobs.

Parameters

此方法不需要任何参数，传入空数组 [] 即可。

Response

Example request

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "net_listening",
7    "params": [],
8    "id": 1
9  }'

Try it live in the Optimism playground.

Errors & troubleshooting

Common pitfalls

• true only means the P2P listener is open, not that the node has any connected peers — pair it with net_peerCount to confirm real connectivity.
• Managed RPC endpoints like optimism.therpc.io front a pool of nodes and typically return true regardless of any single backend's state, so this is not a substitute for checking sync progress with eth_syncing.

Supported networks

• Mainnet — Chain ID: 10
• Sepolia — Chain ID: 11155420

See also

• net_peerCount
• net_version

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"net_listening","params":[]}'