이번 포스팅에서는 eosio 블록체인의 javascript 라이브러리인 eosjs를 소개해보고자 합니다.
eosjs는 이더리움의 web3.js와 같은 “특정 블록체인에 대한 특정 언어(eosjs의 경우 javascript)로 접근 가능한 API” 입니다.
물론 SwiftyEOS(swift), eos-java-rpc-wrapper(java) 등 다른 언어들에 대한 구현체도 여럿 존재합니다. 여기서 eosjs는 eosio 측에서 직접 개발을 맡은 라이브러리입니다.
eosio는 이미 RPC가 지원되는데 굳이 필요한가요?
그렇습니다. eosio는 http 요청을 통한 정보 제공 및 트랜잭션 전송 기능을 훌륭히 수행합니다. 하지만 eosjs를 사용했을 때의 장점 또한 존재합니다. 아래의 설명은 eosio의 RPC를 통해 코인 전송을 하기위한 과정입니다.
*여기서 잠깐, RPC란? Remote Procedure Call 의 약자이며 네트워크 상의 다른 컴퓨터에 위치하고 있는 프로그램에 서비스를 요청하는데 사용되는 프로토콜
- /v1/chain/get_info 호출을 통한 last_irreversible_block_num 획득
- /v1/chain/get_block 호출을 통한 last_irreversible_block 정보 조회
- /v1/chain/push_transaction 호출을 통한 실제 트랜잭션 전송
위와 같이 EOS 코인을 전송하기 위해 http 요청이 필요하고, 각 요청에 대한 에러 처리도 고스란히 개발자의 몫이 됩니다. eosjs도 결국 eosio RPC 요청에 대한 wrapper라고 볼 수 있지만, 이러한 작업을 편하게 수행하기 위해 다양한 named action function을 제공합니다. 따라서 eosjs를 사용한다면 transfer 메서드 호출 한 번에 위 작업을 수행할 수 있습니다.
이제 eosjs를 이용해 EOS 코인을 전송해보도록 하겠습니다.
eosjs 설치
이제 eosjs를 사용하기 위한 설정 작업을 진행하겠습니다. 직접 html에 script 태그를 이용한 방법은 아래와 같습니다.
만약 node.js와 같이 javascript 모듈러를 사용할 수 있는 환경이라면 아래의 작업을 수행합니다. (nodejs / npm 기준)
eosjs 설정
무사히 eosjs를 설치하였다면 필요한 정보를 eosjs에게 알려 줄 차례입니다. 아래와 같이 chainID, 트랜잭션에 필요한 프라이빗 키, 접속할 nodeos의 주소를 입력합니다.
● chainId : 연결할 체인 ID를 명시해줍니다. 주요 체인들의 chain ID는 아래와 같습니다.
● keyProvider : 특정 계정에서 transfer를 하기 위해서, 해당 트랜잭션에 프라이빗 키 서명이 필요합니다. 따라서 필요한 프라이빗 키를 명시해 줍니다.
● httpEndpoint : 요청을 보낼 타겟 nodeos 주소입니다. 위 예제에서는 greymass의 퍼블릭 RPC 주소를 사용하였습니다.
eosjs로 EOS 전송
설정까지 무사히 끝났다면 실제 코인 전송을 진행해봅시다. 윗 단계에서 생성한 eos객체의 transfer 메서드를 사용합니다. 순서대로 보내는 이, 받는 이, 수량, 메모를 파라미터로 사용합니다.
transfer 메서드의 마지막 파라미터에 callback을 사용할 수 있습니다.
javascript의 특성 상 위 메서드의 callback은 비동기적으로 수행횝니다. 하지만 파라미터로 callback이 명시되지 않았다면 transfer 메서드는 promise를 반환합니다. 따라서 아래와 같이 메서드 호출 이후의 처리를 동기적으로 진행할 수 있습니다.
transfer 로그 확인
마지막으로 transfer 메서드 호출 시 출력되는 로그를 확인해봅시다.
● 1 : eos 객체 생성 시 자동으로 수행되는 부분입니다. 입력한 httpEndpoint에 get_info 요청을 보냅니다.
● 2 : transfer 메서드 호출 시 출력된 내용입니다. 내부적으로 여러 RPC 요청을 보내 transfer 액션을 수행함을 알 수 있습니다.
지금까지 기본적인 eosjs 사용법 및 EOS 코인 전송 방법에 대해 알아보았습니다. 다음 포스팅에서는 트랜잭션 메서드를 이용한 토큰 전송을 같이 해보는 시간을 갖도록 하겠습니다. 감사합니다!
원문 확인하기 >> https://bit.ly/2R3qQaq