区块链中间件——BWMare V1.0C++SDK使用说明

BMWare向区块链应用提供统一的API接口，使得用户随时切换区块链底层技术平台，无需考虑它们的编程语言、设计风格、适用场景、后续发展、存在的风险和技术不确定性。

同时，BMWare还提供了开发的SDK，可以供开发者快速开发区块链应用。

以下是BMWareV1.0C++ SDK使用说明：

1.准备工作

1)     需要下载对中间件C++SDK包。

2)     以下代码都是示例代码,调用每个接口都会返回一个JSON数据,数据包含错误码等信息,错误码为0表示请求接口成功,否则失败.在范例中使用的UniValve是来源于开源项目(bitcoin)中的一种JSON解析包,如有更适合你的JSON解析包,可以将其替换。

3)     示例代码中各接口中的传入参数都是必须的,不能少,可以根据需求增加自定义参数。

2．加载动态库

首先需要加载中间件SDK对应平台的动态库,本例以Win10 + VS2015为例,示例代码如下:

static HINSTANCEg_hDll = 0;

if(!LoadDll("BLMWareDevSDK.dll", g_hDll)) //加载动态库"BLMWareDevSDK.dll"

{

printf("load BLMWareDevSDK failed!\n");

return false;

}

程序使用结束后,需要释放动态库资源

void UnLoadDll(HINSTANCE&hDll)

{

                  if(!hDll)

                           return;

                  FreeLibrary(hDll);

}

3获取Token

获取动态库中获取Token对应的函数指针,并调用该函数.示例代码如下:

typedef BLMWAREDEVSDK_APIstd::string(*getTokenFunc)(const std::string& strAppId, conststd::string& strAppKey); // "获取Token"的接口原型

static string g_strToken;

bool TestGetToken()

{

getTokenFunc func = NULL;

                   if(!g_hDll || !(func = (getTokenFunc)GetProcAddress(g_hDll,"getToken"))) //指向"获取Token"接口: getToken

                   {

                            printf("cann'tget function from dll\n");

                            returnfalse;

                   }

                  

                   stringstrResponse = func(g_strAppId, g_strAppKey); //调用"获取Token"接口,并保存返回的JSON数据

                   if(strResponse.empty())

                   {

                            printf("getTokenfailed\n");

                            returnfalse;

                   }

                   //printf("getToken: %s\n", strResponse.data());

                  

                   UniValuejResponse;

                   if(!jResponse.read(strResponse)) //解析JSON数据,可以根据个人方便更换JSON解析包

                   {

                            printf("parsegetToken result failed\n");

                            returnfalse;

                   }

                  

                   if(!CheckErrCode(jResponse)) //根据错误码判断请求"获取Token"接口是否成功

                            returnfalse;

                  

                   g_strToken= jResponse["data"]["token"].getValStr(); //保存全局的Token,方便下面的接口使用

                   if(g_strToken.empty())

                   {

                            printf("getTokenreturn error\n");

                            returnfalse;

                   }

                  

                   printf("token:%s\n", g_strToken.data());

                   returntrue;

}

资产管理包括资产发行、转让、查询等。有价值的、可转让的数据我们称之为资产，比如积分、数字货币、单据、征信、保险、贷款等等。目前有资产发行、资产转让这两种获得方式，开发者可以自行组合出许多种应用场景，如数字货币发行和转让；提货单发行与转让；甚至可以同时发行代币和积分，并且在一定汇率下进行兑换等。

4．发行资产

获取动态库中发行资产对应的函数指针,并调用该函数.示例代码如下:

typedefBLMWAREDEVSDK_API std::string(*issueFunc)(const std::string& strToken,const std::string& strBlockChainId, const std::string& strCallMode,const std::string& strPassword, const std::string& strBLAddress, conststd::string& strAssetName, const std::string& strAssetUnit, conststd::string& strAssetQuantity, const std::string& strAssetDesc, conststd::string& strMetadata); // "发行资产"的接口原型

boolTestIssue(const string& strToken, const string strBlockChainId, const string&strCallMode, const string& strPassword, const string& strAddress, conststring& strAssetName, const string& strAssetUnit, const string&strAssetQuantity, const string& strAssetDesc, const string& strMetadata, string& strAssetId, string& strTxId)

{

          issueFunc func = NULL;

          if (!g_hDll || !(func =(issueFunc)GetProcAddress(g_hDll, "issue"))) //指向"发行资产"接口: issue

          {

                    printf("cann't getfunction from dll\n");

                    return false;

          }

         

          string strResponse = func(strToken,strBlockChainId, strCallMode, strPassword, strAddress, strAssetName,strAssetUnit, strAssetQuantity, strAssetDesc, strMetadata); //调用"发行资产"接口,并保存返回的JSON数据

          if (strResponse.empty())

          {

                    printf("issuefailed\n");

                    return false;

          }

         

          UniValue jResponse;

          if (!jResponse.read(strResponse)) //解析JSON数据

          {

                    printf("parse issueresult failed\n");

                    return false;

          }

         

          if (!CheckErrCode(jResponse)) //根据错误码判断请求"发行资产"接口是否成功

                    return false;

         

          strAssetId =jResponse["data"]["assetId"].getValStr();

          strTxId = jResponse["data"]["txId"].getValStr();

          if (strAssetId.empty() ||strTxId.empty())

          {

                    printf("issue returnerror\n");

                    return false;

          }

 

          printf("asestId: %s\n",strAssetId.data());

          printf("txId: %s\n",strTxId.data());

          return true;

}

5.转让资产

获取动态库中转让资产对应的函数指针,并调用该函数.示例代码如下:

typedefBLMWAREDEVSDK_API std::string(*transferFunc)(const std::string& strToken,const std::string& strBlockChainId, const std::string& strCallMode,const std::string& strPassword, const std::string& strFromBLAddress, conststd::string& strToBLAddress, const std::string& strAssetId, conststd::string& strAssetQuantity, const std::string& strMetadata); //"转让资产"的接口原型

boolTestTransfer(const string& strToken, const string& strBlockChainId,const string& strCallMode, const string& strPassword, const string&strSenderAddress, const string& strRecverAddress, const string&strAssetId, const string& strAssetQuantity, const string& strMetadata,string& strTxId)

{

          transferFunc func = NULL;

          if (!g_hDll || !(func = (transferFunc)GetProcAddress(g_hDll,"transfer"))) //指向"转让资产"接口: transfer

          {

                    printf("cann't getfunction from dll\n");

                    return false;

          }

 

          string strResponse = func(strToken,strBlockChainId, strCallMode, strPassword, strSenderAddress, strRecverAddress,strAssetId, strAssetQuantity, strMetadata); //调用"转让资产"接口,并保存返回的JSON数据

          if (strResponse.empty())

          {

                    printf("transferfailed\n");

                    return false;

          }

         

          UniValue jResponse;

if (!jResponse.read(strResponse)) //解析JSON数据

          {

                    printf("parse transferresult failed\n");

                    return false;

          }

         

          if (!CheckErrCode(jResponse)) //根据错误码判断请求"转让资产"接口是否成功

                    return false;

         

          strTxId = jResponse["data"]["txId"].getValStr();

          if (strTxId.empty())

          {

                    printf("transfer returnerror\n");

                    return false;

          }

         

          printf("txId: %s\n",strTxId.data());

          return true;

}

想获取更多技术相关信息

欢迎关注官方微信：bankledger

扫码即可关注