井通区块链数据上链介绍
井通區(qū)塊鏈數據上鏈介紹
1、概述
本文主要描述井通區(qū)塊鏈上通過Memo的方式進行數據上鏈,以及進行數據上鏈之后的數據查詢等。 基本流程如下:
1) 創(chuàng)建錢包
2) 激活錢包
3) 抽取業(yè)務數據 4) 業(yè)務數據上鏈 5) 上鏈數據獲取
2、操作流程
操作流程采用井通區(qū)塊鏈 rest api的測試環(huán)境,api版本為V2。 測試環(huán)境API的地址為: https://tapi.jingtum.com/v2。 正式環(huán)境api的地址為: https://api.jingtum.com/v2 。
1)創(chuàng)建錢包 接口:/v2/wallet/new,GET方法
例子: https://tapi.jingtum.com/v2/wallet/new
返回結果:
返回結果說明:
注意:井通區(qū)塊鏈創(chuàng)建的錢包缺省沒有激活,不能正式使用。要激活錢包,需要轉入至少25個SWT。
2)激活錢包
激活錢包操作其實就是調用轉賬支付接口,向一個新錢包轉入超過25SWT就自動激活。 接口:/v2/accounts/{:source_address}/payments,POST方法
例子:https://tapi.jingtum.com/v2/accounts/jpLpucnjfX7ksggzc9Qw6hMSm1ATKJe3AF/payments
POST參數:
返回結果:
{ "success": true, "status_code": "0", "client_id": "fnwtest201803190001", "hash": "496FA965905628B46F50574B85B5FDCBA4367F236A8913E3C783B140D4804C9D", "result": "tesSUCCESS", "fee": 0.01 }返回參數說明:
3)抽取業(yè)務數據 用戶將業(yè)務系統(tǒng)里面需要上傳的數據轉化為字符串,以便存入字符數組中。如果抽取的業(yè)務數據比較復雜,可以用JSON格式進行封
裝,這樣原則上可以包含任意結構的數據。例如: 數據類型:string
數據內容:hello world
準備好數據之后,即可以調用接口進行數據上傳。詳細情況參見下文。
4)業(yè)務數據上鏈
業(yè)務數據上鏈也是調用轉賬支付接口,發(fā)送一筆交易,交易里面附帶備注信息(memos),在memos里面可以存放組織好的業(yè)務數 據。業(yè)務數據采用字符數組的形式傳入memos,字符數組里面可以定義JSON結構的數據。
備注信息memos的大小有限制,目前是2k大小。如果需要上傳大量數據,可以拆分成幾條交易。如果需要上傳文件,那么需要另外 的云存儲服務或者分布式文件存儲服務。
由于這里發(fā)送交易的目的是為了數據上鏈,所以發(fā)送的資產數量可以自定義一個合適的數量。 接口:/v2/accounts/{:source_address}/payments,POST方法 參數和上面激活錢包里面的一樣。只是具體提交的數據不同。 例子:https://tapi.jingtum.com/v2/accounts/jpLpucnjfX7ksggzc9Qw6hMSm1ATKJe3AF/payments POST參數:
5)獲取單個上鏈數據
獲取單個上鏈數據就是調用獲取交易記錄信息接口。從交易記錄信息里面獲取Memos,然后解析數據,從而得到上鏈數據。
接口:/v2/accounts/{:address}/transactions/{:id},GET方法 參數:
例子:
https://tapi.jingtum.com/v2/accounts/jpLpucnjfX7ksggzc9Qw6hMSm1ATKJe3AF/transactions/6689A95AD2EA0E7246434CD47B78DF6C7A 8134B70DA73541BB3F46743621F018
返回結果:
6)獲取上鏈數據記錄 獲取多條上鏈數據記錄就是調用獲取交易記錄接口。獲取交易記錄后,進行遍歷操作,取出每條交易記錄里面的Memos,然后解析
數據,從而得到上鏈數據。
接口:/v2/accounts/{:address}/transactions,GET方法
接口參數:
例子1:https://tapi.jingtum.com/v2/accounts/jpLpucnjfX7ksggzc9Qw6hMSm1ATKJe3AF/transactions 返回結果:
以上例子沒有帶可選參數,缺省獲取10條記錄。返回marker標記,代表本次查詢到了這個位置,應用程序可以保存下來,下次可以 從標記的地方繼續(xù)往下查詢。
作為一個開發(fā)者,有一個學習的氛圍跟一個交流的圈子特別重要,下面是我們的社區(qū)交流群,不管你是小白還是大牛歡迎入住,分享經驗、討論技術、社區(qū)開發(fā)。大家一起交流學習共同成長!希望開發(fā)者少走彎路。
1.社區(qū)開發(fā)者大賽 QQ 群:568285439
2.社區(qū)論壇:http://bbswtc.com
3.社區(qū)公眾號:SWTC 互動社區(qū)、SWTC 社區(qū)
4.github:https://github.com/swtcpro
總結
以上是生活随笔為你收集整理的井通区块链数据上链介绍的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: “火星人”马斯克推论:世界很大可能性是被
- 下一篇: 太阳系的绘制