/csharp-sdk

FISCO BCOS client sdk for C#

Primary LanguageC#MIT LicenseMIT

FISCOBCOS C# Sdk

介绍

FISCOBCOS 区块链 C# Sdk，目前是采用Json RPC API 接口和区块链底层（标准版本）进行适配。

作者：林宣名

B站教学视频：

FISCO BCOS C#Sdk之交易解析（上）:https://www.bilibili.com/video/BV1av41147Lo

FISCO BCOS C#Sdk之交易解析（中）:https://www.bilibili.com/video/BV19z4y167zv

FISCO BCOS C#Sdk之交易解析（下）:https://www.bilibili.com/video/BV11K4y1L7SD

有好的建议，请联系我！ 我的邮箱：2594771947@qq.com

软件架构

软件架构说明

FISCOBCOS C# Sdk 采用 net core 3.1,配套开发工具是vs Code 和 Visual Studio 2019。

功能介绍

  1. 实现 RPC 同步/异步请求
  2. 实现FISCO BCOS公私钥、账户生成，拓展生成Webase Front导入用户json，可以直接导入Webase中间件。
  3. 实现合约操作封装，如：合约部署、请求参数构建、交易签名、RLP编码转换等。
  4. 实现合约部署、合约交易、合约Call操作、合约交易回执获取等。
  5. 实现合约input、output、event等解析。
  6. 所有操作配置对应的单元测试Demo。可以参考复制。

备注：发送交易并同步返回交易回执测试，有一定几率为空，那是因为底层交易在打包，还没完成共识。

安装教程

  1. 下载源码，vs2019 nuget包还原; 或使用 nuget包安装，安装命令如下： Install-Package FISCOBCOS.CSharpSdk -Version 1.0.0.4
  2. vs code 安装solidity 插件，在vs code创建一个文件夹存放原始sol合约。
  3. vs code 按 F5 执行编译命令 “compile current Solidity contract”,会生成合约对应的abi和bin。
  4. 将上面编译得到abi和bin 放到你的项目中，进行相关操作。

参考： vs Code 编译合约说明

使用说明

  1. 在 FISCOBCOS.CSharpSdk 类库配置 BaseConfig 文件，配置好对应的底层请求DefaultUrl，如：http://127.0.0.1:8545 。
  2. 使用ContractService 和QueryApiService进行相关业务操作。
  3. ContractService 主要是合约调用等操作封装，详细看对应的单元测试中的ContractTest.cs。
  4. QueryApiService是底层非交易的Json RPC API 封装，可参考单元测试ApiServiceTest.cs。 备注：通用的Json RPC API 相对简单，没有封装对应的DTO 实体，操作时候可以通过在线json 生成实体进行业务结合。

迭代计划

  1. 实现channel 协议。
  2. 实现国密版本适配。
  3. 业务归集等通用组件扩展。