ft-john / csharp-sdk

FISCO BCOS client sdk for C#

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

有好的建议，请联系我！ 我的邮箱：[email protected]

软件架构

软件架构说明

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.6
2. vs code 安装solidity 插件，在vs code创建一个文件夹存放原始sol合约。
3. vs code 按 F5 执行编译命令 “compile current Solidity contract”,会生成合约对应的abi和bin。
4. 将上面编译得到abi和bin 放到你的项目中，进行相关操作。

参考：

使用说明

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。
5. 如果使用redis 发布订阅，请参考ConsoleTest 项目中的RedisThreadWorkTest，开启多个RedisSubClient 项目进行订阅。 （该功能可以根据实际情况拓展指定的合约、指定事件等获取解析操作）。

备注：通用的Json RPC API 相对简单，没有封装对应的DTO 实体，操作时候可以通过在线json 生成实体进行业务结合。

新增特性

1. 新增助记词、钱包模块
2. 新增BIP 32、新增EIP 55 等特性
3. 优化获取交易回执
4. 新增线程池拉取指定区块交易，新增Redis订阅发布

迭代计划

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