사용 가이드

옥텟은 기본적으로 이더리움, 비트코인에서 제공하는 JSON-RPC 를 모두 지원합니다.이외에 주소별 트랜잭션 목록을 가져오는 API 및 UTXO 목록을 가져올 수 있는 API를 추가적으로 제공합니다.

잠깐! 현재 이더리움의 경우 Websocket 은 지원하지 않으며 HTTP 프로토콜만 지원하고 있습니다.

1단계. Access Token

풀히스토리 API 를 사용하기 위해서는 Access Token이 필요합니다.

신청 시 입력한 이메일로 Access Token 발급되었습니다. 발급된 Access Token을 입력하여 명령어를 실행해주세요.

발급된 Access Token 은 아래와 같이 매 요청시 Http Header 에 Access Token 을 입력해주세요.

curl --request GET 'https://octet-fullhistory.hexlant.com' --header 'Content-Type: application/json' --header 'Authorization: YOUR_ACCESS_TOKEN'

2단계. 네트워크 선택

헥슬란트는 이더리움과 비트코인 메인넷 · 테스트넷 제공합니다. 필요한 환경에 따라 네트워크를 선택하여 사용해보세요.

이더리움 네트워크 안내

coin

network

description

url

ETH

Ropsten

JSON-RPC

준비중

ETH

Mainnet

JSON-RPC

https://octet-fullhistory.hexlant.com/v1/ETH

비트코인 네트워크 안내

coin

network

description

url

BTC

Testnet

JSON-RPC

준비중

BTC

Mainnet

JSON-RPC

https://octet-fullhistory.hexlant.com/v1/BTC

· 메인넷 : 블록체인 상에 기록되는 거래를 발생시키며 스마트 컨트랙트에도 실제 효력이 발생됩니다.

최초 네트워크 시작 시점부터 지금까지의 데이터를 가지고 있는 블록체인입니다. 트랜잭션 처리에 따라 실제 가상 자산이 수수료로 사용되며, 이로 인해 비용 발생이 생길 수 있습니다.

· 테스트넷 : 테스트 환경입니다. 발생된 거래가 스마트 컨트랙트에 영향을 미치지 않습니다. 따라서 메인넷에 준하는 환경에서 여러 사항들을 테스트해볼 수 있습니다.

메인넷과 유사한 환경으로 동작하는 블록체인 네트워크입니다. 네트워크의 안정성을 보장하지 않으며, 사전 고지 없이 네트워크가 업데이트 되거나 트랜잭션 이력에 변동이 있을 수 있습니다. 다음과 같은 서비스를 통해 테스트에 필요한 이더리움을 무료로 얻을 수 있습니다.

3단계. 이더리움 JSON-RPC 요청 테스트

이더리움 JSON-RPC를 테스트 해보세요.

curl --request POST 'https://octet-fullhistory.hexlant.com/v1/ETH/rpc' \
--header 'Content-Type: application/json' \
--header 'Authorization: YOUR_ACCESS_TOKEN' \
--data-raw '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

응답 결과

{
"jsonrpc": "2.0",
"id": 1,
"result": "0x9cb3ff"
}

4단계. 이더리움 트랜잭션 목록 요청 테스트

네트워크 상에서 발생한 트랜잭션 목록을 가져오는 API 입니다. 발생된 거래 이력과 상세 정보를 확인할 수 있습니다.

curl --request GET 'https://octet-fullhistory.hexlant.com/v1/ETH/addresses/0x9c7bcbc2d5eb57acadd487008f9dc793e7242e54/transactions' \
--header 'Content-Type: application/json' \
--header 'Authorization: YOUR_ACCESS_TOKEN' \

응답 결과

[
{
"type": "eth",
"status": "success",
"txid": "0xd4afb5c59d33ce2af761a1ecc98ff7e63ccf791fc9d8604c3c8e3f19f2dff0d1",
"blockHash": "0x6dca907b31bc0fdf78c0b043b510dab0b12e1a0d637aa70e40d869f453b556d2",
"blockHeight": 10268149,
"blockTime": "2020-06-15T04:27:40.000Z",
"confirmations": 1610,
"transactionIndex": 143,
"gasLimit": 21000,
"gasPrice": "25410000000",
"fee": "533610000000000",
"from": "0xc72fB5198583E639798f88D4c4593c85AF64Dc7E",
"to": "0x9C7bCBc2d5Eb57ACaDd487008f9dc793e7242E54",
"value": "8000000000000000",
"token": {}
},
...
]