클레이튼 네트워크 식별자
KNI(Klaytn 네트워크 식별자) 는 클레이튼 노드를 식별하기 위한 URL 체계입니다. 그 구문은 아래와 같습니다.
kni://<nodeID>@<hostname>:<port>?subport=<subport>&discport=<discport>
nodeID는 노드의 개인키에 해당하는 512비트 공개키입니다. P2P 네트워크에서 피어와의 통신을 확인하는 데 사용됩니다.
hostname은 @와 : 사이에 위치한 노드의 주소를 설명합니다. 주소 형식은 다음 중 하나일 수 있습니다:
- IPv4 점 소수점(
192.0.2.1) - IPv6(
[2001:db8::68]) - IPv4 매핑된 IPv6(
[2001:db8:3c4d:15::abcd:ef12]) - 도메인 이름(
your.node.com)
port는 TCP를 통해 피어 노드와 연결할 때 사용됩니다. 클레이튼에서 기본 port는 32323, 기본 subport는 32324입니다. 기본 subport는 kend.conf에서 port + 1로 설정되어 있음을 참고하세요. 클레이튼은 TCP 수신 포트의 수에 따라 두 가지 연결 유형을 제공합니다.
discport는 알려진 이웃이 도달 가능한 클레이튼 노드인지 확인하고 새로운 연결을 위해 이웃의 주소를 가져오는 데 사용됩니다. 이 포 트는 UDP 포트입니다.
기본적으로 UDP 포트, 즉 discport는 TCP 포트와 동일한 포트를 사용합니다.
노드가 discport에 다른 포트를 사용하는 경우 discport 쿼리 파라미터로 지정할 수 있습니다.
다음 두 URL은 IP 주소 10.0.0.1, TCP 수신 포트 32323과 32324를 가진 노드의 KNI 예시입니다.
discport가 생략된 경우 port의 값과 동일한 32323의 UDP 포트로 설정됩니다.
kni://a979...163c@10.0.0.1:32323 # either single-channel or multi-channel peer with omitted subportkni://a979...163c@10.0.0.1:32323?subport=32324 # multi-channel peer
다음 두 개는 discport가 30301인 노드의 KNI 예제입니다.
kni://a979...163c@10.0.0.1:32323?discport=30301 # either single-channel or multi-channel peer with omitted subportkni://a979...163c@10.0.0.1:32323?subport=32324&discport=30301 # multi-channel peer
노드의 KNI를 생성하는 방법은 노드 키 및 노드 URI 생성을 참고하시기 바랍니다.
The KNI scheme is used in node discovery protocol, setting static-nodes.json file, addPeer API, bootnodes option and etc.