mmjazzar91/main

AWA Server

镜像概述和主要用途

AWA Server是一个NodeJS服务器项目，旨在与运行中的HyperLedger Fabric网络进行交互，支持链码部署状态检查、管理员用户注册与交互等功能，适用于需要与HyperLedger Fabric网络集成的应用开发场景。

核心功能和特性

• 与HyperLedger Fabric网络交互，支持管理员用户注册和身份管理
• 提供链码部署状态检查功能，验证链码是否正常运行
• 支持开发模式和正常模式两种服务器启动方式
• 需通过环境变量和连接配置文件进行网络连接配置

使用场景和适用范围

适用于基于HyperLedger Fabric平台开发的应用，需要通过NodeJS服务器与网络进行交互的场景，如链码调用、用户身份管理、***数据查询等。

详细的使用方法和配置说明

前置条件

• 安装Node.js v12
• 已部署并运行HyperLedger Fabric网络（包含awa***code项目）

安装步骤

1. 确保awa***code项目已启动并运行
2. 克隆仓库：

   shell
   git clone https://gitlab.com/Fagr/awa-server.git
   

3. 安装依赖：

   shell
   npm i
   

4. 复制连接配置文件到指定目录（确保在服务器根目录执行）：

   shell
   cp /<path to awa-chaincode>/connection-org* ./fabric/secure/
   

5. 创建.env文件，配置所需环境变量
6. 注册管理员并登记用户以与***交互：

   shell
   npm run register:fabric
   

检查已部署的合约

验证链码是否正常运行且可访问：

shell
npm run checkCC:fabric

启动服务器

• 开发模式启动：

  shell
  npm run dev
  

• 正常模式启动：

  shell
  npm start
  

文档

• Postman接口文档

清理

停止网络时，删除用户***和连接配置文件：

shell
cd fabric/secure && rm wallet/*.id && rm connection-org*

可能的问题及解决方法

• 问题：管理员用户注册失败：TypeError: Cannot read property 'tlsCACerts' of undefined
  解决：检查连接配置文件是否正确复制到./fabric/secure/目录，确保文件路径和内容正确。

• 问题：需要添加IBM ***平台的默认从属关系
  解决：添加默认从属关系为ibp。

• 问题：无法与智能合约交互
  解决：为身份添加必要属性：

  • hf.Revoker = true
  • hf.Registrar.Roles = peer,client,admin,orderer