Documentation Index
Fetch the complete documentation index at: https://docs.optimism.io/llms.txt
Use this file to discover all available pages before exploring further.
The p2p api provides methods for interacting with Kona’s P2P stack.
opp2p_self
Returns information about the local node in the form of PeerInfo.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_self"} |
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_self","params":[]}
{"jsonrpc":"2.0","id":1,"result":{"peerID":"16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x","nodeID":"0x311d8222ffc44e9c86f403d57f454bd823e7dc9d3c8e97171ddd862910352f31","userAgent":"kona","protocolVersion":"","ENR":"enr:-Jm4QBAdUpUqrpTj6yQor5mwif6RRmY11dlj-Um3TqKmJiYha4SUNqdJr2eM3pRsFVCwVikYcBk__5JVTwngUeimKxcCgmlkgnY0gmlwhC36_pOHb3BzdGFja4Xc76gFAIlzZWNwMjU2azGhA2WTa6OqvnWbRmoeuhRRu-BTPgP8y4_MY6snTsNW0gHBg3RjcIIj5oN1ZHCCn7U","addresses":["/ip4/127.0.0.1/tcp/9190/p2p/16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x","/ip4/172.18.0.9/tcp/9190/p2p/16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x"],"protocols":["/ipfs/id/push/1.0.0","/meshsub/1.1.0","/ipfs/ping/1.0.0","/meshsub/1.2.0","/ipfs/id/1.0.0","/opstack/req/payload_by_number/2151908/0/","/meshsub/1.0.0","/floodsub/1.0.0"],"connectedness":1,"direction":1,"protected":false,"chainID":11155420,"latency":0,"gossipBlocks":true,"scores":{"gossip":{"total":0.0,"blocks":{"timeInMesh":0.0,"firstMessageDeliveries":0.0,"meshMessageDeliveries":0.0,"invalidMessageDeliveries":0.0},"IPColocationFactor":0.0,"behavioralPenalty":0.0},"reqResp":{"validResponses":0.0,"errorResponses":0.0,"rejectedPayloads":0.0}}}}
opp2p_peerCount
Returns the count of connected peers for both discovery and gossip networks.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_peerCount"} |
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_peerCount","params":[]}
{"jsonrpc":"2.0","id":1,"result":{"connectedDiscovery":15,"connectedGossip":12}}
opp2p_peers
Returns information about peers. If connected parameter is true, only returns connected peers.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_peers", "params": [connected]} |
Parameters
connected (boolean): If true, only returns connected peers
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_peers","params":[true]}
{"jsonrpc":"2.0","id":1,"result":{"totalConnected":2,"peers":{"16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x":{"peerID":"16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x","nodeID":"0x311d8222ffc44e9c86f403d57f454bd823e7dc9d3c8e97171ddd862910352f31","userAgent":"kona","protocolVersion":"","addresses":["/ip4/127.0.0.1/tcp/9190"],"protocols":["/ipfs/ping/1.0.0","/meshsub/1.1.0"],"connectedness":1,"direction":2,"protected":false,"chainID":11155420,"latency":50000000,"gossipBlocks":true,"scores":{"gossip":{"total":1.5,"blocks":{"timeInMesh":100.0,"firstMessageDeliveries":10.0,"meshMessageDeliveries":5.0,"invalidMessageDeliveries":0.0},"IPColocationFactor":0.0,"behavioralPenalty":0.0},"reqResp":{"validResponses":25.0,"errorResponses":1.0,"rejectedPayloads":0.0}}}},"bannedPeers":[],"bannedIPS":[],"bannedSubnets":[]}}
opp2p_peerStats
Returns statistical information about peers including connection counts and topic subscriptions.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_peerStats"} |
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_peerStats","params":[]}
{"jsonrpc":"2.0","id":1,"result":{"connected":12,"table":50,"blocksTopic":8,"blocksTopicV2":10,"blocksTopicV3":5,"blocksTopicV4":2,"banned":3,"known":75}}
opp2p_discoveryTable
Returns the discovery table entries as a list of ENR strings.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_discoveryTable"} |
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_discoveryTable","params":[]}
{"jsonrpc":"2.0","id":1,"result":["enr:-Jm4QBAdUpUqrpTj6yQor5mwif6RRmY11dlj-Um3TqKmJiYha4SUNqdJr2eM3pRsFVCwVikYcBk__5JVTwngUeimKxcCgmlkgnY0gmlwhC36_pOHb3BzdGFja4Xc76gFAIlzZWNwMjU2azGhA2WTa6OqvnWbRmoeuhRRu-BTPgP8y4_MY6snTsNW0gHBg3RjcIIj5oN1ZHCCn7U","enr:-Km4QBqBrKNq7F5L1dSrWW8Y1k8k4V2L2nTsNtGuKPpPwp3L_rBVMaQCQpnc2sBB-c2yV_n4qgM2_2yfcNjVXr4OFgCgmlkgnY0gmlwhH8AAAGHb3BzdGFja4OFAoAE"]}
Peer Blocking Methods
opp2p_blockPeer
Blocks a specific peer by peer ID, preventing any connections to or from that peer.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_blockPeer", "params": [peerID]} |
Parameters
peerID (string): The peer ID to block
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_blockPeer","params":["16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x"]}
{"jsonrpc":"2.0","id":1,"result":null}
opp2p_unblockPeer
Unblocks a previously blocked peer by peer ID.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_unblockPeer", "params": [peerID]} |
Parameters
peerID (string): The peer ID to unblock
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_unblockPeer","params":["16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x"]}
{"jsonrpc":"2.0","id":1,"result":null}
opp2p_listBlockedPeers
Returns a list of all blocked peer IDs.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_listBlockedPeers"} |
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_listBlockedPeers","params":[]}
{"jsonrpc":"2.0","id":1,"result":["16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x","16Uiu2HAm7Th3s3C1VHmKrYzA9nPzV4b3vqL8z1x8WZzGk2t9DjRK"]}
Address Blocking Methods
opp2p_blockAddr
Blocks connections from a specific IP address.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_blockAddr", "params": [address]} |
Parameters
address (string): The IP address to block (IPv4 or IPv6)
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_blockAddr","params":["192.168.1.100"]}
{"jsonrpc":"2.0","id":1,"result":null}
opp2p_unblockAddr
Unblocks a previously blocked IP address.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_unblockAddr", "params": [address]} |
Parameters
address (string): The IP address to unblock (IPv4 or IPv6)
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_unblockAddr","params":["192.168.1.100"]}
{"jsonrpc":"2.0","id":1,"result":null}
opp2p_listBlockedAddrs
Returns a list of all blocked IP addresses.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_listBlockedAddrs"} |
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_listBlockedAddrs","params":[]}
{"jsonrpc":"2.0","id":1,"result":["192.168.1.100","10.0.0.50","2001:db8::1"]}
Subnet Blocking Methods
opp2p_blockSubnet
Blocks connections from an entire IP subnet using CIDR notation.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_blockSubnet", "params": [subnet]} |
Parameters
subnet (string): The subnet to block in CIDR notation (e.g., “192.168.1.0/24”)
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_blockSubnet","params":["192.168.1.0/24"]}
{"jsonrpc":"2.0","id":1,"result":null}
opp2p_unblockSubnet
Unblocks a previously blocked IP subnet.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_unblockSubnet", "params": [subnet]} |
Parameters
subnet (string): The subnet to unblock in CIDR notation
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_unblockSubnet","params":["192.168.1.0/24"]}
{"jsonrpc":"2.0","id":1,"result":null}
opp2p_listBlockedSubnets
Returns a list of all blocked IP subnets.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_listBlockedSubnets"} |
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_listBlockedSubnets","params":[]}
{"jsonrpc":"2.0","id":1,"result":["192.168.1.0/24","10.0.0.0/16","2001:db8::/32"]}
Peer Protection Methods
opp2p_protectPeer
Protects a peer from being disconnected due to connection limits or other automatic pruning mechanisms.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_protectPeer", "params": [peerID]} |
Parameters
peerID (string): The peer ID to protect
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_protectPeer","params":["16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x"]}
{"jsonrpc":"2.0","id":1,"result":null}
opp2p_unprotectPeer
Removes protection from a peer, allowing it to be disconnected by automatic pruning mechanisms.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_unprotectPeer", "params": [peerID]} |
Parameters
peerID (string): The peer ID to unprotect
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_unprotectPeer","params":["16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x"]}
{"jsonrpc":"2.0","id":1,"result":null}
Connection Management Methods
opp2p_connectPeer
Attempts to establish a connection to a specific peer using a multiaddress.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_connectPeer", "params": [multiaddr]} |
Parameters
multiaddr (string): The multiaddress of the peer to connect to
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_connectPeer","params":["/ip4/127.0.0.1/tcp/9190/p2p/16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x"]}
{"jsonrpc":"2.0","id":1,"result":null}
opp2p_disconnectPeer
Disconnects from a specific peer by peer ID.
| Client | Method invocation |
|---|
| RPC | {"method": "opp2p_disconnectPeer", "params": [peerID]} |
Parameters
peerID (string): The peer ID to disconnect from
Example
// > {"jsonrpc":"2.0","id":1,"method":"opp2p_disconnectPeer","params":["16Uiu2HAmKVVub7edwZ3RKDnqMpZVsusYW9TKRgbwpH54nvDWLE4x"]}
{"jsonrpc":"2.0","id":1,"result":null}
