3. 区块链浏览器

3.1. 概述

区块链浏览器提供了实时浏览、查询区块链信息和统计信息的功能。主要由前端(Web展示)、后端及数据库三部分组成。数据库采用的是MySQL,后端采用go语言开发,前端使用的是react框架。

3.2. 安装指南

3.2.1. 环境依赖

docker

docker版本为20.10.7或以上 docker-compose版本为1.29.2或以上

下载地址:

若已安装,请通过命令查看版本:

  $ docker -v
  $ docker-compose -v

3.2.2. 浏览器部署

3.2.2.1. 前置环境

浏览器部署需要依赖一个ChainMaker运行环境。具体的ChainMaker环境安装部署请参考对应的文档《通过命令行工具启动链》

3.2.2.2. 代码下载

下载地址: https://git.chainmaker.org.cn/chainmaker/chainmaker-explorer

代码版本:v2.1.0

下载代码:

$ git clone https://git.chainmaker.org.cn/chainmaker/chainmaker-explorer.git

3.2.2.3. 配置调整

浏览器配置文件:configs/config.yml,它的配置内容包括四部分,以下是详细说明:

web:
   address:  0.0.0.0
   port:     9999
   cross_domain:     true
 
 node:
   #  链和节点更新时间
   update_time: 30
   #  节点断开连接时间和新增链时间
   sync_time:   30
 
 db:
   host: localhost
   port: 3306
   database: chainmaker_explorer_dev
   user:   chainmaker
   passwd: Baec&chainmaker

3.2.2.4. 启动运行

3.2.2.4.1. docker启动

修改完config.yml文件后,启动容器,命令如下执行

docker-compose up

3.3. 使用手册

3.3.1. 初始化

  • 初始化时,需要先订阅一条链,请确保所填写的信息和要订阅的链是一致的,并且用来订阅的节点的网络连接是通畅的。

  • 订阅链时请根据您的链的实际情况,选择是否开启TLS。目前通过官方开源文档教程上起的链,默认TLS是开启的,且则默认的TLSHostname为chainmaker.org,如您自定义修改过,请按照实际情况填写。

  • 如需订阅多条链,后续可在区块链管理处继续添加订阅。

3.3.2. 首页

  • 通过右上角可以切换跳转到已经订阅的其他链的浏览器页面,也可继续添加订阅链。

  • 支持通过区块哈希/区块高度/交易id/合约名称直接搜索。

  • 点击左下角统计当前链的相关数据,如区块高度,交易数等,点击将跳转到对应的区块列表页、交易列表页、合约列表页、组织列表页、节点列表页、账户列表页等。

  • 首页将展示当前最新的区块信息,包含每个区块的区块高度、包含交易数、出块节点。

  • 首页将展示当前最新的区块信息,包含每笔交易的交易id、交易发起者、所调用的合约以及交易发起时间。

  • 首页将展示当前最新的区块信息,包含每个合约的合约名称、合约创建者、合约版本、合约部署时间。

3.3.3. 订阅区块链

  • 支持同时订阅多条链,再订阅链时,请确保所填写的信息和要订阅的链是一致的,并且用来订阅的节点的网络连接是通畅的。

  • 不允许同时订阅同一条链。

  • 如果订阅后,所订阅的节点运行出现异常,如停机了,或者被踢出网络了,则浏览器也将无法获取信息,您可以通过修改订阅信息,修改正常运行的节点,恢复订阅。

  • 支持取消订阅,取消后,将不会再获取该链的信息,如需获取,需要重新订阅。

3.3.4. 区块信息

  • 此处展示区块列表,点击查看,可以查看该区块的详情。

  • 支持查看某一区块的具体信息,包括区块哈希,读写集哈希,DAG信息,以及本区块内的交易信息。

3.3.5. 交易信息

  • 此处展示交易列表,支持通过实际时间维度筛选交易,点击查看,可以查看该交易的详情。

  • 支持查看某一条交易详情,包括交易的所属区块信息,交易发起人信息,交易所调用的合约执行情况。

3.3.6. 合约信息

  • 此处展示合约列表,点击查看,可以查看该合约的详情。

  • 支持查看合约信息,包括合约的创建者信息,以及合约调用的历史交易记录。

  • 支持查看合约调用过程中,产生的事件信息。

3.3.7. 组织信息

  • 此处展示参与该区块链的组织信息。

3.3.8. 节点信息

  • 此处展示参与该区块链的节点信息。

3.3.9. 链账户信息

  • 此处展示该区块链目前已经发送过或者接收过交易的用户信息。