6DGS云-即时链解决方案

为什么要用即时链?

速度

链上新纪录即时同步

实时

<0.2s完成数据同步

持久

通过心跳机制持久传输

接口

采用websocket接口

数据

采用json数据格式

token

一次连接独立token校验

安全

wss端到端加密传输

可信

区块链帐本见证可信商业

即时链-技术架构

即时链-应用场景

即时聊天

社群群聊

客服系统

系统消息

交易通知

实时交易

订阅数据

数据中台

AI机器人

大数据

如何使用6DGS云-即时链?

第1步:注册帐户


点击上面的按钮,如下图:

如果未注册帐户,请先注册帐户:

注意:一定要使用自己的手机号码注册,否则后续将无法改密。
其中英文名为您的nodeid(亦节点用户ID)--非常重要,建议填写与团队名、公司名相关。

第2步:创建G节点

我们使用第一步注册得到的帐号登录6DGS云控制台,登录后如下图:

我们看到有免费的1GB的G节点额度,这个额度可以立即使用,直接点击【创建G节点】或点击下图菜单:

点击创建G节点链接或菜单,进入创建G节点页面:

按上述内容填写(注意配置只能选择1GB,合约按流程我们先体验COIN-记帐型合约;
token命名可以直接使用自动生成的coin,如果已经创建过coin的G节点,须修改);
COIN币的数量上限可以随便选,这里因为我们仅仅是测试,设置为1个亿;
云服务商是指G节点集群托管所在地,推荐次序为:华为云-百度云-阿里云-腾讯云;
购买数量为月份数量,也就是这个G节点开通的月数,这里因为是免费额度只能选择1个月;
付款方式这里因为余额还没充值(充值了可以使用余额支付),只能选择会员特权(VIP0也是会员,特权为免费1个GB)
上述内容填写完成后,点击【确定购买】,出现下述弹窗:

可以看到需要支付60元,由于使用了会员特权,所以帐户没钱也是可以直接点击【确定购买】,如下图所未:

购买成功后,等待5秒钟,通过【刷新】按钮可刷新出下图数据,代表创建G节点成功:

至此,一个COIN-记帐型合约的G节点已经创建成功!

第3步:熟悉G节点的菜单功能

依据第2步创建了G节点,现在我们找到管理G节点的菜单:

因为刚才创建的这个G节点托管在了华为云,所以我们点击【G节点】华为云也可以找到它

找到它了,下面我们看一下G节点控制台页面的功能,如下图:

其中API接口和API接口密钥,在下页使用/fork等API接口时需要用到;
我们现在看一下如何管理数据,点击【管理】进入链数据管理操作台界面如下图:

注解:操作区【1】重启仅重启进程,【2】重启会更新代码逻辑并重启,
【3】清空cahe是清空状态缓存,清空数据是将链上的数据清除(会重新构建该G节点)
【4】会删除该G节点,删除后在G节点控制台就找不到它了。
对于数据区,我们看到token-id、height、txid、txjson、hash、sign、timestamp即为一个txid交易纪录在token-id这个高度为height上的一行链纪录;
这里值得注意的是,一个txid会分别出现在多个token-id上,代表了tx交易纪录在有关系的token上的六度共识同步!
下面我们使用G节点的API接口来实现helloworld功能,从而了解到G节点发挥作用的过程!

第4步,使用/fork接口API创建token帐户(token-id)

在使用/fork接口之前,先阅读API文档的接口规范,点击查看API接口文档
如下图所示:

这里可以看到,拼接一个可用的API接口,先在G节点控制台拿到API接口地址和接口密钥,如下图:

API接口地址复制到这里:https://c0.6dgs.opencom.cn/node.testphone.coin
API接口密钥复制到这里:appid=10001&secret_key=bfc51077860b2927be95c0807766ca56
按规范拼接API的接口URL:https://c0.6dgs.opencom.cn/node.testphone.coin/fork?appid=10001&secret_key=bfc51077860b2927be95c0807766ca56

这里在【API接口地址】后面添加了/fork?,还有API接口密钥,这样,一个有效的/fork接口地址就生产了。
我们看API文档,/fork接口需要哪些参数,如下图:

API接口拼接如下:
https://c0.6dgs.opencom.cn/node.testphone.coin/fork?appid=10001&secret_key=bfc51077860b2927be95c0807766ca56&token=coin_0000000000000000
返回结果:{"ret":true,"msg":"success","txid":"txid_21SBYbS4VctcPco6","token_x":"coin_xu7G8AM2G2ojrnSf","token_y":"coin_0000000000000000","x_state":{"token_state_p":"[\"coin_0000000000000000\"]","token_state_val":"0","token_height":0,"pre_txid":"null","private_key":"A1Rk2RzDenDWjdbeBoPDRNsxfyug68QmGyYLfAUyqf7A","public_key":"22Pqy6BD1S1ms5FajrVPDuYso3NgAKDV65QVPve6o8o55","token":"coin_xu7G8AM2G2ojrnSf"},"y_state":{"token_state_p":"[]","token_state_val":"30","token_height":233,"private_key":"8egL8ivrhE3KkpW639f1fXv1Qb97psiudMqs5Kfb2WmL","public_key":"yizNoHddKNvchoikGRdrTaqeDJptUh9XvpnRiDfb85vz","token":"coin_0000000000000000"}}
可以看到ret=true,代表fork新帐户调用成功,同时返回token_x=coin_xu7G8AM2G2ojrnSf

第5步,使用/op接口wslisten指令获取websocket服务端地址

在使用/op接口之前,先阅读接口API文档,点击查看/op的API接口文档
如下图所示:

交易纪录数据结构为:token_x op(sms) token_y opval(phone and code) extra_data ;(非转帐推荐使用assert、config、notice等指令)
一般情况下,除非是send消息,令token_x=coin_0000000000000000(即token_root)
令token_y=coin_xu7G8AM2G2ojrnSf(我们使用上面fork接口API创建的token-id)
获取websocket服务端须使用wslisten指令,并且令opval=test(随便填写非空内容)
接口API的URL拼接如下:
https://c0.6dgs.opencom.cn/node.testphone.coin/op?appid=10001&secret_key=bfc51077860b2927be95c0807766ca56&token_x=coin_0000000000000000&token_y=coin_xu7G8AM2G2ojrnSf&opcode=wslisten&opval=test&extra_data=wslisten-helloworld
得到的返回结果如下:
{"ret":true,"msg":"success","txid":"txid_28PmpqS1DTzfnrda","token_x":"coin_0000000000000000","token_y":"coin_xu7G8AM2G2ojrnSf","x_state":{"token_state_p":"[]","token_state_val":"30","token_height":234,"pre_txid":"txid_z4qz1uWSGJ8w4cG4","public_key":"yizNoHddKNvchoikGRdrTaqeDJptUh9XvpnRiDfb85vz","token":"coin_0000000000000000"},"y_state":{"token_state_p":"[\"coin_0000000000000000\"]","token_state_val":"0","token_height":1,"public_key":"22Pqy6BD1S1ms5FajrVPDuYso3NgAKDV65QVPve6o8o55","token":"coin_xu7G8AM2G2ojrnSf"},"x6dgs_cloud_func_ret":{"ret":true,"msg":"success","listen_token":"e90562720a5be8c366376cab2699d28c6b5bb7e2f50202ff1509af17178e260f","listen_url":"wss://cloud.6dgs.opencom.cn/cloud/ws/svr?token=e90562720a5be8c366376cab2699d28c6b5bb7e2f50202ff1509af17178e260f"}}
ret=true代表op接口调用和写入数据成功,这里判断短信是否发送成功是通过x6dgs_cloud_func_ret的回参数判断:
如这里所示:"x6dgs_cloud_func_ret":{"ret":true,"msg":"success","listen_token":"e90562720a5be8c366376cab2699d28c6b5bb7e2f50202ff1509af17178e260f","listen_url":"wss://cloud.6dgs.opencom.cn/cloud/ws/svr?token=e90562720a5be8c366376cab2699d28c6b5bb7e2f50202ff1509af17178e260f"}

可以看到,"x6dgs_cloud_func_ret":{"ret":true,"msg":"success"}代表已经获取Websocket服务器地址成功。
其中listen_url代表了websocket服务端地址为:wss://cloud.6dgs.opencom.cn/cloud/ws/svr?token=e90562720a5be8c366376cab2699d28c6b5bb7e2f50202ff1509af17178e260f

案例:websocket客户端收到数据

通过上述/op指令(opcode=wslisten)成功获得了websocket的listen_url,封装websocket客户端请求数据之后,再次执行第3步/fork指令可以得到如下数据:
{"user_name":"testphone","token_name":"coin","appid":"10001","list":[{"token":"coin_33WCeyvcBoqeXHBt","height":0,"token_relate":"token_x","token_x":"coin_33WCeyvcBoqeXHBt","token_y":"coin_0000000000000000","opcode":"fork","opval":"22vQHS2RBYMBHL5fXTmmy37D5RxZcZdytRpWgif8gip8k","opval_len":45},{"token":"coin_0000000000000000","height":236,"token_relate":"token_y","token_x":"coin_33WCeyvcBoqeXHBt","token_y":"coin_0000000000000000","opcode":"fork","opval":"22vQHS2RBYMBHL5fXTmmy37D5RxZcZdytRpWgif8gip8k","opval_len":45}],"count":"2"}
websocket参考demo网址,请点击【即时链websocket网页客户端示例】
截图如下:

由上图可以看到,可以实时收到链上最新纪录。

【指引】帮助您分析错误原因的客服联系方式

客服联系方式:
QQ:251499600
手机:17324139805



Copyright © 2012-2019 广州六度共识科技有限公司. All Rights Reserved.
粤ICP备14035184号