15. Chainmaker ChainList 工具

ChainMaker ChainList 是长安链网络的列表，企业可以基于长安链开源的区块链底层技术平台，搭建自己的长安链网络，并申请加入长安链ChainList。用户通过此处可获取到长安链生态内已有的区块链网络信息，以便于将对应的网络添加到Web3插件内使用Web3应用，以及对相应的区块链网络提供区块链中间件服务。

15.1. 产品使用说明

立即体验chainlist

15.1.1. 整体说明

任意社区用户都可将自己通过长安链底层平台部署的长安链网络，添加到长安链ChainList上。
可通过区块链网络名称，或者chainid检索ChainList上已有的网络信息。
可将链网络直接添加到长安链Web3插件钱包内进行使用，添加前请先确保已经安装插件，如果未安装，请按照页面指引完成安装。
- 将链添加进插件后，请在插件内导入该链网络的链账户，之后可通过该链账户签名发起交易上链。
- 请确保所添加的长安链网络运行正常，网络通畅且所导入的链账户的可用，否则将导入失败。

15.1.2. 如何把您的长安链网络添加到ChainList

1、 fork chainmaker-chain-list 项目到个人仓库:

2、 checkout自己的开发分支

3、在 /chains.js文件的chainlist数组尾部中添加自己的区块链网络配置

配置规范

interface Chain {
  // 区块链网络名称，必填。
  chainName: string;
  // 区块链ID，必填。
  chainId: string;
  //此处用于设置该链的RPC服务信息，可设置多个，至少得设置一个，其中url为节点的RPC服务地址，orgName为提供该RPC服务的企业名称。
  rpcs: Array<{ url: string; orgName: string }>;
  //目前支持permissionedWithCert（证书模式）、public（公钥模式）两种长安链。必填。
  accountMode: 'permissionedWithCert' | 'public';
  //请添加该链的相关介绍描述，方便使用者了解该链，选填。
  description?: string;
  //请填写该链的logo所在的url，选填。
  logo?: string;
  //请填写该链是否开启TLS，如果开启了请填写ture，如果未开启请填写false。不填默认为false。
  tlsEnable?: boolean;
  //如果开启了TLS请填写该链的TLSHostName,默认为chainmaker.org，如果您自建了证书CA服务且修改了该字段，请按照实际情况填写，不填则按默认情况处理。
  hostName?: string;
  //此处用于设置将链填加到长安链Web3插件后，插件和链的通讯方式。长安链默认采用GRPC与链进行通讯，V2.3.0版本的底链支持采用HTTP通讯，如果您的链已开启该配置，可选择HTTP。不填则按默认情况处理。
  protocol?: 'GRPC' | 'HTTP';
  //此处可设置您的链对应的区块链浏览器地址，设置后Web3插件内发起的交易，可直接跳转到区块链浏览器内查看交易详情。选填。
  browserLink?: string;
}

4、提交代码后发起 merge request 合并请求，将个人仓库开发分支合并至 chainmakerlab/chainmaker-chain-list的master分支

5、等待merge request 完成后，可前往长安链ChainList查看

15.1.3. 如何为已添加进ChainList的链网络添加RPC服务

1、更正自己fork的chainList项目

git remote add source https://git.chainmaker.org.cn/chainmakerlab/chainmaker-chain-list
git pull source master

2、 checkout自己的开发分支

3、在 /chains.js文件的chainlist中找到自己添加的区块链网络，并在rpcs 数组中添加 rpc服务信息; rpc服务信息中需要包含：url（节点的RPC服务地址）与 orgName（为提供该RPC服务的企业名称）

4、提交代码后发起 merge request 合并请求，将个人仓库开发分支合并至 chainmakerlab/chainmaker-chain-list的master分支

5、等待merge request 完成后，可前往长安链ChainList查看

15.1.4. 长安链ChainList 区块链网络添加审核说明

长安链网络列表（ChainMaker ChainList）登记项目仅为底层平台使用长安链ChainMaker的项目，不代表社区任何立场。

功能层面，添加到网络列表的区块链网络涉及代币、Defi等将不被审核，数字藏品类当前暂缓审核；
业务层面，涉嫌非法集资、灰产、黑产等项目将不被审核；
您已确保所添加的区块链网络为原创，且不侵犯任何公司或个人知识产权（包括但不限于Logo、商标等）；
未通过审核的项目可发送邮件到operation@chainmaker.org进行申诉，邮件标题命名为：【ChainList审核申诉+所登记项目名】，正文说明项目具体信息及申诉原由。

15.1.5. 其他说明

如果已添加进ChainList上的长安链网络，长期无有效的RPC服务，官方将把该长安链网络移出ChainList。
所提供的长安链网络运行时，请遵守国家相关法律规定，若出现违规情况，官方将把对应的区块链网络移出ChainList。