enode url format

An Ethereum node can also be described with a URL scheme "enode".

The hexadecimal node ID is encoded in the username portion of the URL, separated from the host by an @ sign. The hostname can only be given as an IP address - DNS domain names are not allowed. The port in the hostname section is the TCP listening port. If the TCP and UDP (discovery) ports differ, the UDP port is specified as query parameter "discport".

In the following example, the node URL describes a node with IP address, TCP listening port 30303 and UDP discovery port 30301.


The enode url scheme is used by the Node discovery protocol and can be used in the bootnodes command line option of the client, or as the argument to suggestPeer(nodeURL) function in the JSRE.

See also

  • https://app.gitbook.com/o/-Mk6Zlnnii_J5l6U9prz/s/-MkOUPEi695BiHW808M2/c/0ShIG5TtkrFUCImKp9Zd/management-apis/command-line-options

  • https://app.gitbook.com/o/-Mk6Zlnnii_J5l6U9prz/s/-MkOUPEi695BiHW808M2/c/0ShIG5TtkrFUCImKp9Zd/management-apis/javascript-console

Last updated