DOCUMENTS

Documents of the BORA project.

BORA Explorer

The BORA Explorer provides transaction details of BORA Shell series tokens recorded on the BORA Chain. The BORA Explorer is different from the official release version in that it shows the transaction history information which occurred in the BORA Lagoon Testnet environment.

How to use BORA Explorer

The BORA Explorer can be used in the following ways.

Online Explorer

You can access the site provided by the BORA project and use it directly. https://testnet-explorer.bora-lagoon.com/

Local Explorer

Only installing Front-End module and using the open API: This is the method by installing module that related to Front-End and using the API that is open to public.Utililizing by installing Front-End, Back-End, Crawler and individual node directly: This is the method of operation by installing every related components of BORA Explorer.

Components of the BORA Explorer

The BORA Explorer consists of the following modules.Related Projects are available on the BORA platform github. Please see github's details for installing the Local ExplorerTo install the PoA node directly, please see the ‘BORA Lagoon network’ document.

BORA Explorer APIs

The BORA Explorer provides the REST API to retrieve and use transaction information without installing your seperate node.

1Getting application list

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" }
]

2Getting BORA Shell Block list

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 }
}

3Getting BORA Shell Block detail

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"
}

4Getting BORA Shell transaction list

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 }
}

5Getting BORA Shell transaction detail

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"
}