2. Quick Start Guide

블로코에서는 웹브라우저 상에서 설치 없이 빠르게 코인스택 SDK를 경험해 볼 수 있는 웹플레이그라운드를 제공하고 있습니다. 본 문서에서는 플레이그라운드를 통해 비트코인 블록체인의 상태를 조회하고, 주소 생성 및 잔고를 조회하는 방법을 소개합니다. 각 과정에 대한 상세한 설명은 Coinstack Documentation의 다른 챕터들을 참조하시기 바랍니다. 코인스택을 활용하여 멋진 서비스를 개발해 보시기 바랍니다.

웹플레이그라운드 접속

크롬이나 인터넷익스플로러 등 웹브라우저를 통해 코인스택 웹플레이그라운드(https://playground.blocko.io/)에 접속합니다. 코드들은 웹페이지 상의 콘솔창에 입력하거나, 웹페이지 하단의 예제코드 항에 존재하는 RUN 버튼을 누르면 실행 가능합니다.

클라이언트 객체 생성

테스트용 API Access Key와 Secret Key를 사용하여 CoinStack 객체를 생성합니다. 실 사용을 위한 코인스택 API KEY 발급은 4장 Authentication을 참고 바랍니다.

var client = new CoinStack('c7dbfacbdf1510889b38c01b8440b1', '10e88e9904f29c98356fd2d12b26de');
console.log(client);

결과값은 JSON으로 리턴됩니다.

{  
   "apiKey":"c7dbfacbdf1510889b38c01b8440b1",
   "secretKey":"10e88e9904f29c98356fd2d12b26de",
   "protocol":"https://",
   "endpoint":"mainnet.cloudwallet.io",
   "isBrowser":true
}

최신 블록체인 상태 정보 조회

블록체인의 상태를 조회하여 최신 블록의 블록번호와 해시값을 출력해 봅니다.

client.getBlockchainStatus(function(err, status) {
    console.log(status);
});

결과값은 JSON으로 리턴됩니다.

{  
   "best_block_hash":"0000000000000000002f28ea6b32950216406511722839dd47752f3b06e1d025",
   "best_height":433116
}

새 비공개키 생성

임의의 비공개키를 생성해 봅니다. 본 예제의 결과에 나온 Secret Key는 테스트 용이며, 추후 본인의 개인 계정을 생성하고 발급받은 Secret Key는 절대 타인에게 공개되어서는 안됩니다.

var privateKey = CoinStack.ECKey.createKey();
console.log(privateKey);

결과값은 문자열로 리턴됩니다.

L3nkFqH4n9xoYFvEmEyg54utGogNdz1WA4fqRohMJ8VgkXpRvGs1

비공개키에서 주소 생성

지갑 주소를 생성해 봅니다. 이 주소는 외부에 공개 가능하며, 이 주소를 통해 비트코인을 전송받을 수 있습니다.

var address = CoinStack.ECKey.deriveAddress(privateKey);
console.log(address);

결과값은 문자열로 리턴됩니다.

1MVMj4Gr9e7U5D4ZLignuNLpv2cyKiHa2x

주소 잔고 조회

현재 주소의 비트코인 잔액을 조회하고 사토시 단위로 출력해 봅니다. (1 사토시 = 0.00000001 비트코인, 1 비트코인 = 1억 사토시) 본 예제의 주소는 새로 생성한 주소이므로 잔액이 0 비트코인(BTC)임을 확인할 수 있습니다.

client.getBalance(address,
function(err, balance) {
    console.log(CoinStack.Math.toBitcoin(balance) + ' BTC');
});

결과값은 문자열로 리턴됩니다.

0 BTC