메인 체인에 연결

이 페이지에서는 서비스 체인을 메인 체인에 연결하는 단계를 설명합니다.

EN 구성 - 메인 브리지 활성화

kend.conf를 구성하여 메인 브리지를 활성화해야 합니다.

구성 파일 업데이트

kend.conf에는 다음과 같은 주요 브리지 속성이 포함되어 있습니다.

이름	설명
MAIN_BRIDGE	브리지 서비스를 서비스 체인의 메인 브리지로 활성화합니다. 1을 입력하면 활성화됩니다.
MAIN_BRIDGE_PORT	브리지 수신 포트. 기본값: 50505
MAIN_BRIDGE_INDEXING	서비스 체인 데이터에 빠르게 액세스할 수 있도록 서비스 체인 트랜잭션 해시의 인덱싱을 활성화합니다. 1을 입력하면 활성화됩니다.

EN에서 메인 브리지를 활성화하려면 아래와 같이 해야 합니다.

MAIN_BRIDGE 정의
RPC/WS를 활성화합니다.
아래 예제와 같이 RPC용 mainbridge API를 추가합니다.


# Configuration file for the kend
...
# rpc options setting
RPC_ENABLE=1 # if this is set, the following options will be used
RPC_API="klay,mainbridge" # available apis: admin,debug,klay,miner,net,personal,rpc,txpool,web3,mainbridge,subbridge
RPC_PORT=8551
RPC_ADDR="0.0.0.0"
RPC_CORSDOMAIN="*"
RPC_VHOSTS="*"
# ws options setting
WS_ENABLE=1 # if this is set, the following options will be used
WS_API="klay" 
WS_ADDR="0.0.0.0"
WS_PORT=8552
WS_ORIGINS="*"
...
# service chain options setting
MAIN_BRIDGE=1
MAIN_BRIDGE_PORT=50505
MAIN_BRIDGE_INDEXING=1
...

SCN을 메인 체인에 연결

메인 체인의 EN을 메인 브리지로 실행해야 합니다. 또한 서브 브리지로 어떤 SCN(서비스 체인 합의 노드)을 EN과 연결할지 결정해야 합니다.

EN(메인 브리지) 정보 확인

EN 콘솔 열기

EN 프로세스에 연결하는 방법은 여러 가지가 있습니다. 사용 가능한 명령어는 ken CLI 명령어에서 확인할 수 있습니다. 이 페이지는 IPC(프로세스 간 통신)를 통해 프로세스에 연결하는 방법을 설명합니다. 노드의 데이터 디렉터리에 klay.ipc라는 IPC 파일이 있습니다.

다음 명령어를 실행하여 결과를 확인해 주세요. (RPC에 mainbridge API를 추가한 경우 아래와 같이 브리지 API를 확인할 수 있습니다. mainbridge API가 없는 경우, EN 설정 - 메인 브리지 활성화를 다시 확인해야 합니다. )


$ ken attach ~/kend_home/klay.ipc
Welcome to the Klaytn JavaScript console!
instance: Klaytn/vX.X.X/XXXX-XXXX/goX.X.X
at block: 11573551 (Wed, 13 Feb 2019 07:12:52 UTC)
 datadir: ~/kend_home
 modules: admin:1.0 mainbridge:1.0 debug:1.0 istanbul:1.0 klay:1.0 miner:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0
 >

EN의 KNI 받기

IPC를 통해 프로세스에 연결한 후 아래와 같이 EN의 메인 브리지 KNI를 확인할 수 있습니다. You can refer to Service Chain API.


> mainbridge.nodeInfo
{
  kni: "kni://08b99d2297e0a27ddeb33f3a81b59ea1c065b9adbaff9fefab0d16f65b1a8db22939a104c24447e9aca521c158922ca912476b544baf48995a382d88886e0a37@[::]:50505?discport=0",
  id: "08b99d2297e0a27ddeb33f3a81b59ea1c065b9adbaff9fefab0d16f65b1a8db22939a104c24447e9aca521c158922ca912476b544baf48995a382d88886e0a37",
  ip: "::",
  listenAddr: "[::]:50505",
  name: "-2",
  ports: {
    discovery: 0,
    listener: 50505
  },
  protocols: {
    servicechain: {
      config: {
        chainId: 2018,
        deriveShaImpl: 0,
        isBFT: true,
        istanbul: {...},
        unitPrice: 0
      },
      difficulty: 87860,
      genesis: "0x711ce9865492659977abb2758d29f68c2b0c82862d9376f25953579f64f95b58",
      head: "0x0d4b130731f1e7560e4531ac73d55ac8c6daccb178abd86af0d96b7aafded7c5",
      network: 1
    }
  }
}

메인 브리지 kni를 주목해야 합니다.