Skip to content
ReferenceTestnet: yesMainnet: Not availableSoftware: Core bad4a06ea · protocol pqwerai-v8-testnet/1Updated

net namespace

Network identity and peer count.

3 public methods. Operator, disabled and unsupported methods of this namespace are listed in Operator interfaces. $RPC is your node URL (see quickstart).

Method Access Summary
net_listening Public · read-only Returns an indication if the node is listening for network connections.
net_peerCount Public · read-only Returns the number of connected peers
net_version Public · read-only Returns the current ethereum protocol version.

net_listening

Returns an indication if the node is listening for network connections.
Access Public · read-only · playground
Network private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software protocol pqwerai-v8-testnet/1
Verified source core/source/internal/ethapi/api.go:2295 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns boolean

Parameters: none

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "net_listening",
  "params": []
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "net_listening", "params": []}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": true
}

Errors and edge cases

  • -32602 invalid or missing parameter (e.g. missing value for required argument 0).
  • -32000 execution or validation error with a message from the node.

net_peerCount

Returns the number of connected peers
Access Public · read-only · playground
Network private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software protocol pqwerai-v8-testnet/1
Verified source core/source/internal/ethapi/api.go:2300 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns quantity (hex)

Parameters: none

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "net_peerCount",
  "params": []
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "net_peerCount", "params": []}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x3"
}

Errors and edge cases

  • -32602 invalid or missing parameter (e.g. missing value for required argument 0).
  • -32000 execution or validation error with a message from the node.

net_version

Returns the current ethereum protocol version.
Access Public · read-only · playground
Network private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software protocol pqwerai-v8-testnet/1
Verified source core/source/internal/ethapi/api.go:2305 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns string

Parameters: none

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "net_version",
  "params": []
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "net_version", "params": []}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "77240"
}

Errors and edge cases

  • -32602 invalid or missing parameter (e.g. missing value for required argument 0).
  • -32000 execution or validation error with a message from the node.

Sources at 72057fe3ec: core/source/internal/ethapi/api.go

Found a problem? Report a documentation issue · Build testnet-rc1+72057fe3ec