您的位置:首頁 > 區(qū)塊鏈 >

本體的智能合約API分7個模塊 Blockchain API支持區(qū)塊鏈查詢操作

2019-09-10 08:18:30 來源: 區(qū)塊網(wǎng)

1 前言在之前的技術視點文章中,我們介紹了目前本體主網(wǎng)支持的智能合約體系以及相應的智能合約開發(fā)工具 SmartX。很多小伙伴都想上手練一練

1. 前言

在之前的技術視點文章中,我們介紹了目前本體主網(wǎng)支持的智能合約體系以及相應的智能合約開發(fā)工具 SmartX。很多小伙伴都想上手練一練。在本期的本體技術視點中,我們將正式開始講述智能合約語法部分。

本體的智能合約 API 分為7個模塊,分別是 Blockchain & Block API、Runtime API、Storage API、Native API、Upgrade API、Execution Engine API 以及 Static & Dynamic Call API。本期我們將介紹 Blockchain & Block API,這是本體智能合約體系中最基礎的部分。其中,Blockchain API 支持基本的區(qū)塊鏈查詢操作,如獲取當前塊高等;Block API 支持基本的區(qū)塊查詢操作,如查詢指定區(qū)塊交易數(shù)等。同時,文末將提供視頻講解。

在這之前,小伙伴們可以在本體智能合約開發(fā)工具 SmartX 中新建一個合約,跟著我們進行操作。

2. Blockchain API 使用方法

智能合約函數(shù)的引用與 Python 的引用如出一轍。開發(fā)者可以根據(jù)需要引入相應的函數(shù)。例如,下面語句引入了獲取當前最新塊高函數(shù) GetHeight 和獲取區(qū)塊頭函數(shù) GetHeader。

from ontology.interop.System.Blockchain import GetHeight, GetHeader

2.1 GetHeight

開發(fā)者可以使用 GetHeight 來獲取當前最新塊高,具體例子如下。在后面的例子中,為了節(jié)省空間,我們將省略 Main 函數(shù),小伙伴在練習的時候可以根據(jù)需要加入。

from ontology.interop.System.Runtime import Notify

from ontology.interop.System.Blockchain import GetHeight

def Main(operation):

if operation == 'demo':

return demo()

return False

def demo():

height=GetHeight()

Notify(height) # 打印height

return height #在函數(shù)運行結束后返回height

2.2 GetHeader

開發(fā)者可以使用 GetHeader 來獲取區(qū)塊頭,參數(shù)是某個塊的塊高。具體例子如下:

from ontology.interop.System.Runtime import Notify

from ontology.interop.System.Blockchain import GetHeader

def demo():

block_height=10

header=GetHeader(block_height)

Notify(header)

return header

2.3 GetTransactionByHash

開發(fā)者可以使用 GetTransactionByHash 函數(shù)通過交易哈希獲取交易。交易哈希以 bytearray 的格式,作為參數(shù)傳入 GetTransactionByHash。這個函數(shù)的關鍵在于如何轉換將十六進制格式的交易哈希轉變?yōu)?bytearray 格式的交易哈希。

我們以16進制格式的交易哈希為例,實現(xiàn)將十六進制格式的交易哈希轉變?yōu)?bytearray 格式的交易哈希。示例哈希如下:

9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1

首先,將該交易哈希反序得到:

c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279

開發(fā)者可以通過 SmartX 提供的轉換工具 Hex Number(little endian) <--> Number 實現(xiàn)這一步。

然后,將其轉成 bytearray 格式:

{0xc1,0x89,0x0c,0x4d,0x73,0x06,0x26,0xdf,0xaa,0x94,0x49,0x41,0x9d,0x66,0x25,0x05,0xea,0xb3,0xbd,0xa2,0xe1,0xf0,0x1f,0x89,0x46,0x3c,0xc1,0xa4,0xa3,0x0a,0x27,0x9f}

開發(fā)者可以通過 SmartX 提供的轉換工具 String <--> Byte Array 實現(xiàn)這一步。

最后,將得到的 bytearray 轉換成相應的字符串:

\xc1\x89\x0c\x4d\x73\x06\x26\xdf\xaa\x94\x49\x41\x9d\x66\x25\x05\xea\xb3\xbd\xa2\xe1\xf0\x1f\x89\x46\x3c\xc1\xa4\xa3\x0a\x27\x9f

GetTransactionByHash 函數(shù)通過交易哈希獲取交易的例子如下:

from ontology.interop.System.Blockchain import GetTransactionByHash

def demo():

# tx_hash="9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1"

tx_hash=bytearray(b"\xc1\x89\x0c\x4d\x73\x06\x26\xdf\xaa\x94\x49\x41\x9d\x66\x25\x05\xea\xb3\xbd\xa2\xe1\xf0\x1f\x89\x46\x3c\xc1\xa4\xa3\x0a\x27\x9f")

tx=GetTransactionByHash(tx_hash)

return tx

2.4 GetTransactionHeight

開發(fā)者可以使用 GetTransactionHeight 函數(shù)通過交易哈希獲取交易高度。我們還是以上個例子中的哈希為例:

from ontology.interop.System.Blockchain import GetTransactionHeight

def demo():

# tx_hash="9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1"

tx_hash=bytearray(b"\xc1\x89\x0c\x4d\x73\x06\x26\xdf\xaa\x94\x49\x41\x9d\x66\x25\x05\xea\xb3\xbd\xa2\xe1\xf0\x1f\x89\x46\x3c\xc1\xa4\xa3\x0a\x27\x9f")

height=GetTransactionHeight(tx_hash)

return height

2.5 GetContract

開發(fā)者可以使用 GetContract 函數(shù)通過合約哈希獲取合約。其中,合約哈希的轉換過程與上面講到的交易哈希轉換過程一致。

from ontology.interop.System.Blockchain import GetContract

def demo():

# contract_hash="d81a75a5ff9b95effa91239ff0bb3232219698fa"

contract_hash=bytearray(b"\xfa\x98\x96\x21\x32\x32\xbb\xf0\x9f\x23\x91\xfa\xef\x95\x9b\xff\xa5\x75\x1a\xd8")

contract=GetContract(contract_hash)

return contract

2.6 GetBlock

開發(fā)者可以使用 GetBlock 函數(shù)獲取區(qū)塊。有兩種方法可以獲取指定區(qū)塊:

1. 通過塊高獲取區(qū)塊:

from ontology.interop.System.Blockchain import GetBlock

def demo():

block=GetBlock(1408)

return block

2. 通過區(qū)塊哈希獲取區(qū)塊:

from ontology.interop.System.Blockchain import GetBlock

def demo():

block_hash=bytearray(b'\x16\xe0\xc5\x40\x82\x79\x77\x30\x44\xea\x66\xc8\xc4\x5d\x17\xf7\x17\x73\x92\x33\x6d\x54\xe3\x48\x46\x0b\xc3\x2f\xe2\x15\x03\xe4')

block=GetBlock(block_hash)

3. Block API 使用方法

Block API 中可供引用的函數(shù)有三個,它們分別是 GetTransactions、GetTransactionCount 和 GetTransactionByIndex。我們依次介紹下這三個函數(shù)。

3.1 GetTransactionCount

開發(fā)者可以使用 GetTransactionCount 函數(shù)獲取指定區(qū)塊的交易數(shù)量。

from ontology.interop.System.Blockchain import GetBlock

from ontology.interop.System.Block import GetTransactionCount

def demo():

block=GetBlock(1408)

count=GetTransactionCount(block)

return count

3.2 GetTransactions

開發(fā)者可以使用 GetTransactions 函數(shù)獲取獲取指定區(qū)塊的所有交易。

from ontology.interop.System.Blockchain import GetBlock

from ontology.interop.System.Block import GetTransactions

def demo():

block=GetBlock(1408)

txs=GetTransactions(block)

return txs

3.3 GetTransactionByIndex

開發(fā)者可以使用 GetTransactionByIndex 函數(shù)獲取指定區(qū)塊的指定交易。

from ontology.interop.System.Blockchain import GetBlock

from ontology.interop.System.Block import GetTransactionByIndex

def demo():

block=GetBlock(1408)

tx=GetTransactionByIndex(block,0) # index starts from 0.

return tx

04 后記

Blockchain & Block API 在智能合約中起到查詢區(qū)塊鏈數(shù)據(jù)和區(qū)塊數(shù)據(jù)的作用,是智能合約最不可缺少的一部分。(Sheldon)

關鍵詞: 智能合約API Blockchain API 查詢

精選 導讀

募資55億港元萬物云啟動招股 預計9月29日登陸港交所主板

萬科9月19日早間公告,萬物云當日啟動招股,預計發(fā)行價介乎每股47 1港元至52 7港元,預計9月29日登陸港交所主板。按發(fā)行1 167億股計算,萬

發(fā)布時間: 2022-09-20 10:39
管理   2022-09-20

公募基金二季度持股情況曝光 隱形重倉股多為高端制造業(yè)

隨著半年報披露收官,公募基金二季度持股情況曝光。截至今年二季度末,公募基金全市場基金總數(shù)為9794只,資產(chǎn)凈值為269454 75億元,同比上

發(fā)布時間: 2022-09-02 10:45
資訊   2022-09-02

又有上市公司宣布變賣房產(chǎn) 上市公司粉飾財報動作不斷

再有上市公司宣布變賣房產(chǎn)。四川長虹25日稱,擬以1 66億元的轉讓底價掛牌出售31套房產(chǎn)。今年以來,A股公司出售房產(chǎn)不斷。根據(jù)記者不完全統(tǒng)

發(fā)布時間: 2022-08-26 09:44
資訊   2022-08-26

16天12連板大港股份回復深交所關注函 股份繼續(xù)沖高

回復交易所關注函后,大港股份繼續(xù)沖高。8月11日大港股份高開,隨后震蕩走高,接近收盤時觸及漲停,報20 2元 股。值得一提的是,在7月21日

發(fā)布時間: 2022-08-12 09:56
資訊   2022-08-12

萬家基金再添第二大股東 中泰證券擬受讓11%基金股權

7月13日,中泰證券發(fā)布公告,擬受讓齊河眾鑫投資有限公司(以下簡稱齊河眾鑫)所持有的萬家基金11%的股權,交易雙方共同確定本次交易的標的資

發(fā)布時間: 2022-07-14 09:39
管理   2022-07-14

央行連續(xù)7日每天30億元逆回購 對債市影響如何?

央行12日再次開展了30億元逆回購操作,中標利率2 10%。這已是央行連續(xù)7日每天僅進行30億元的逆回購縮量投放,創(chuàng)下去年1月以來的最低操作規(guī)

發(fā)布時間: 2022-07-13 09:38
資訊   2022-07-13

美元指數(shù)創(chuàng)近20年新高 黃金期貨創(chuàng)出逾9個月新低

由于對美聯(lián)儲激進加息的擔憂,美元指數(shù)11日大漲近1%創(chuàng)出近20年新高。受此影響,歐美股市、大宗商品均走弱,而黃金期貨創(chuàng)出逾9個月新低。美

發(fā)布時間: 2022-07-13 09:36
資訊   2022-07-13

美股三大股指全線下跌 納斯達克跌幅創(chuàng)下記錄以來最大跌幅

今年上半年,美股持續(xù)回落。數(shù)據(jù)顯示,道瓊斯指數(shù)上半年下跌15 3%,納斯達克綜合指數(shù)下跌29 5%,標普500指數(shù)下跌20 6%。其中,納斯達克連續(xù)

發(fā)布時間: 2022-07-04 09:51
推薦   2022-07-04

融資客熱情回升 兩市融資余額月內(nèi)增加超344億元

近期A股走強,滬指6月以來上漲4%,融資客熱情明顯回升。數(shù)據(jù)顯示,截至6月16日,兩市融資余額1 479萬億元,月內(nèi)增加344 67億元,最近一個半

發(fā)布時間: 2022-06-20 09:41
資訊   2022-06-20

4個交易日凈買入超百億元 北向資金持續(xù)流入A股市場

北向資金凈流入態(tài)勢延續(xù)。繼6月15日凈買入133 59億元后,北向資金6月16日凈買入44 52億元。自5月27日至今,除6月13日以外,北向資金累計凈

發(fā)布時間: 2022-06-17 09:37
推薦   2022-06-17