DOCUMENTS

Documents of the BORA project.

BORA Explorer

BORA Explorer는 BORA Chain 상에 기록된 BORA Shell 계열 토큰의 거래 내역 정보를 제공합니다. BORA Explorer (Testnet)은 테스트 넷 환경에서 발생한 거래 내역 정보를 보여준다는 점에서 정식 출시 버전과 차이가 있습니다.

BORA Explorer 사용 방법

BORA Explorer는 다음과 같은 방법으로 사용할 수 있습니다.

Online Explorer

BORA 프로젝트가 제공하는 사이트에 접속, 직접 이용할 수 있습니다. https://testnet-explorer.boraecosystem.com/

Local Explorer

Front-End 모듈만을 설치하고 공개된 API를 이용하기: Front-End 관련된 모듈만 설치하고 API는 공개된 API를 이용하는 방법입니다.Front-End, Back-End, Crawler 및 개별 노드를 직접 설치하여 이용하기: BORA Explorer 관련 모든 구성요소를 직접 설치하여 운영하는 방법입니다.

구성 요소

BORA Explorer는 다음과 같은 모듈로 구성되어 있습니다.관련 Project는 BORA Ecosystem github에 공개되어 있습니다. Local Explorer 설치를 위해서 github의 세부 내용을 참조해주시기 바랍니다. PoA node를 직접 설치하려면, ‘BORA Lagoon network 구성’ 문서를 참고하시기 바랍니다.

BORA Explorer APIs

BORA Explorer는 별도 node 설치 없이, Transaction 정보를 가져와 활용할 수 있도록 REST API를 제공하고 있습니다.

1application 목록 조회

GET /apps
Content-Type: application/json
HOST: testnet-explorer-api.boraecosystem.com

Response

[
{ "appId": "1001", "appName": "Point Main", "tokenAddress": "0xe435d6d9a4321edd6835ac66b40432b58133cc8f" },
{ "appId": "100003", "appName": "Game App1", "tokenAddress": "0x9238b29278983b3eb2ad99147c0170a308c903df" }
]

2BORA Shell 블록 목록 조회

GET /points/{appId}/blocks?page={page}&pageSize={size}
Content-Type: application/json
HOST: testnet-explorer-api.boraecosystem.com

Parameters

ParameterRequiredValuesDescriptionParameter TypeData Type
appId*codeGiven Application Idpath variablestring
pageStarting pagequeryinteger
sizeSize per pagequeryinteger

Response

{ "content":
[
{ "blockNo": 4493172, "blockHash": "0x7716fcff67e6d6eb2f18128bb158a7c206aaa592d686b846d4e2a8af1bcd5d6d", "gasLimit": 900000000, "gasUsed": 0, "nonce": 0, "transactionCount": 0, "uncleCount": 0, "blockDate": "2018-10-16T10:24:31+09:00", "age": "2s ago" },
{ "blockNo": 4493171, "blockHash": "0x6d3c90a767b6439f8cb2b64e92bdbad26921622b2fa79f4a1eaecc442fce9f12", "gasLimit": 900000000, "gasUsed": 420000, "nonce": 0, "transactionCount": 20, "uncleCount": 0, "blockDate": "2018-10-16T10:24:28+09:00", "age": "5s ago" }
],
"pageable": {
"sort": { "sorted": false, "unsorted": true }, "offset": 0, "pageSize": 2, "pageNumber": 0, "paged": true, "unpaged": false }, "last": false, "totalPages": 211927, "totalElements": 423853, "size": 2, "number": 0, "numberOfElements": 2, "first": true, "sort": { "sorted": false, "unsorted": true }
}

3BORA Shell 블록 상세 조회

GET /points/{appId}/blocks/{blockNumber}
Content-Type: application/json
HOST: testnet-explorer-api.boraecosystem.com

Parameters

ParameterRequiredValuesDescriptionParameter TypeData Type
appId*codeGiven Application Idpath variablestring
blockNumberBlock numberpath variablebig integer

Response

{
"blockNo": 4493172,
"blockHash": "0x7716fcff67e6d6eb2f18128bb158a7c206aaa592d686b846d4e2a8af1bcd5d6d",
"gasUsed": 0,
"gasLimit": 900000000,
"nonce": 0,
"difficulty": 2,
"totalDifficulty": 8986345,
"miner": "0x0000000000000000000000000000000000000000",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"parentHash": "0x6d3c90a767b6439f8cb2b64e92bdbad26921622b2fa79f4a1eaecc442fce9f12",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": 610,
"stateRoot": "0x0e82a7c11016e3197551a0bdb9545127e046c8fca19cda1373e2f6283d518c7f",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"transactionCount": 0,
"unclesCount": 0,
"extraData": "0xd783010807846765746887676f312e392e35856c696e757800000000000000003a82b36293a46006c86c9cc1ae02861d0225d6f8b25bfb2c2ae27f2653731bd916359aa751e4183bc83aa561080032b171695737c7baaa7474b3c1ff621f453601", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"blockDate": "2018-10-16T01:24:31Z",
"age": "43s ago"
}

4BORA Shell 트랜잭션 목록 조회

GET /points/{appId}/txs?page={page}&pageSize={size}
Content-Type: application/json
HOST: testnet-explorer-api.boraecosystem.com

Parameters

ParameterRequiredValuesDescriptionParameter TypeData Type
appId*codeGiven Application Idpath variablestring
pageStarting pagequeryinteger
sizeSize per pagequeryinteger

Response

{ "content":
[
{ "transactionHash": "0xfe8dd92d3d53eb77fad030c40900535f08c25356245dd72097cb0f6ba98f4bff", "transactionIndex": 0, "blockNo": 4480076, "fromAddress": "0x1792cdd2529716bc4b403c720884afe92673ff15", "toAddress": "0x1792cdd2529716bc4b403c720884afe92673ff15", "contractAddress": "0xe435d6d9a4321edd6835ac66b40432b58133cc8f", "method": "BURN", "status": "FAIL", "nonce": 21, "amount": 20, "txId": 1643, "data": null, "blockDate": "2018-10-15T23:29:43+09:00", "age": "10h 57m 5s ago" },
{ "transactionHash": "0x582bbea4d1eb548edad743a46bc3c11b2a2a32415b0132be237bb0c19a50c481", "transactionIndex": 0, "blockNo": 4480010, "fromAddress": "0x1792cdd2529716bc4b403c720884afe92673ff15", "toAddress": "0x1792cdd2529716bc4b403c720884afe92673ff15", "contractAddress": "0xe435d6d9a4321edd6835ac66b40432b58133cc8f", "method": "BURN", "status": "SUCCESS", "nonce": 20, "amount": 4096, "txId": 1642, "data": null, "blockDate": "2018-10-15T23:26:25+09:00", "age": "11h 23s ago" }
],
"pageable": { "sort": { "sorted": false, "unsorted": true }, "offset": 0, "pageSize": 2, "pageNumber": 0, "paged": true, "unpaged": false }, "last": false, "totalPages": 698, "totalElements": 1395, "size": 2, "number": 0, "numberOfElements": 2, "first": true, "sort": { "sorted": false, "unsorted": true }
}

5BORA Shell 트랜잭션 상세 조회

GET /points/{appId}/txs/{transactionHash}
Content-Type: application/json
HOST: testnet-explorer-api.boraecosystem.com

Parameters

ParameterRequiredValuesDescriptionParameter TypeData Type
appId*codeGiven Application Idpath variablestring
transactionHashTransaction Hashpath variablestring

Response

{
"transactionHash": "0x582bbea4d1eb548edad743a46bc3c11b2a2a32415b0132be237bb0c19a50c481",
"transactionIndex": 0,
"blockNo": 4480010,
"fromAddress": "0x1792cdd2529716bc4b403c720884afe92673ff15",
"toAddress": "0x1792cdd2529716bc4b403c720884afe92673ff15",
"contractAddress": "0xe435d6d9a4321edd6835ac66b40432b58133cc8f",
"method": "BURN",
"status": "SUCCESS",
"nonce": 20,
"amount": 4096,
"txId": 1642,
"data": null,
"blockDate": "2018-10-15T23:26:25+09:00",
"age": "11h 1m 53s ago"
}