Hi 游客

更多精彩,请登录!

比特池塘 区块链技术 正文

Python智能合约开发?看这一篇就够了

黄河347
113 0 0
01 前言: H7 B: O0 T5 o: r
在之前的技术视点文章中,我们介绍了目前本体主网支持的智能合约体系以及相应的智能合约开发工具 SmartX。很多小伙伴都想上手练一练。在本期的本体技术视点中,我们将正式开始讲述智能合约语法部分。/ f4 ^6 H2 Y) j" \$ ~9 t, T# F
本体的智能合约 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 支持基本的区块链查询操作,如获取当前块高等;Block API 支持基本的区块查询操作,如查询指定区块交易数等。同时,文末将提供视频讲解。
+ |9 K. C. ]" l在这之前,小伙伴们可以在本体智能合约开发工具 SmartX 中新建一个合约,跟着我们进行操作。7 x6 j% G; u; r. @0 Y0 M: @
02 Blockchain API 使用方法
8 w8 s1 A+ G/ S智能合约函数的引用与 Python 的引用如出一辙。开发者可以根据需要引入相应的函数。例如,下面语句引入了获取当前最新块高函数 GetHeight 和获取区块头函数 GetHeader。  W% {) v: C9 r; P1 ]+ p$ J8 J
from ontology.interop.System.Blockchain import GetHeight, GetHeader
, H1 y( h0 v! @1 I5 e. u2.1 GetHeight; Z) D$ a" g" p$ k: U# a
开发者可以使用 GetHeight 来获取当前最新块高,具体例子如下。在后面的例子中,为了节省空间,我们将省略 Main 函数,小伙伴在练习的时候可以根据需要加入。, z: R, S7 k! u& @! z! B- Y' l
from ontology.interop.System.Runtime import Notify5 S0 w9 m$ x6 ^- ]: Y9 R
from ontology.interop.System.Blockchain import GetHeight
4 I9 i9 O9 y) T7 ?3 Ldef Main(operation):' j2 G& G3 z2 p
    if operation == 'demo':
7 O: i' S0 S3 m4 v% h4 Z  d        return demo()( L( A3 f3 @& n, J0 D) h, G
    return False
( z! a" G. j0 ^7 I- y$ _def demo():
, g  z" ~0 U! C" z4 e$ |; B, j    height=GetHeight()
% H8 w1 B, U8 Y8 O% c8 p: K    Notify(height) # 打印height- r/ G# m6 l7 i* i3 y* ^. ?
    return height #在函数运行结束后返回height& A3 ~' w* f$ a9 j7 g% i- K; d- s5 V
2.2 GetHeader
) W/ R8 c. m) P" ^; p开发者可以使用 GetHeader 来获取区块头,参数是某个块的块高。具体例子如下:. Q- n3 v- L) E* ]
from ontology.interop.System.Runtime import Notify
& _( }4 Y  F+ r8 T( x- yfrom ontology.interop.System.Blockchain import GetHeader
8 Y, M: |+ r; s) W2 F5 Edef demo():+ f" c+ ]1 }0 |! [
    block_height=10* k, t$ e8 F1 h6 V- w9 f
    header=GetHeader(block_height)
! O( [1 @/ M- `0 h7 H& ~! f    Notify(header)! N# ?4 C+ f: i) c
return header
, v# ~& }! A; D% B0 p2.3 GetTransactionByHash. i% `" n2 L+ x. X$ m' ]3 }+ a
开发者可以使用 GetTransactionByHash 函数通过交易哈希获取交易。交易哈希以 bytearray 的格式,作为参数传入 GetTransactionByHash。这个函数的关键在于如何转换将十六进制格式的交易哈希转变为 bytearray 格式的交易哈希。
% c( y4 A5 h3 ^6 ]我们以16进制格式的交易哈希为例,实现将十六进制格式的交易哈希转变为 bytearray 格式的交易哈希。示例哈希如下:
8 y0 A" b# |8 r2 @, a; i/ {6 G9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1# m8 ]. \8 L0 B2 h2 B1 j
首先,将该交易哈希反序得到:# {! Z) x# I7 Q6 n7 e
c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279
: k, ?8 c$ E! j! v- n1 ]开发者可以通过 SmartX 提供的转换工具 Hex Number(little endian)  Number 实现这一步。
5 V0 }+ p2 u. ^  o$ R  S* Y/ m然后,将其转成 bytearray 格式:0 a8 y: B! M4 o/ `- K* F
{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}
: C3 U  i$ X4 s6 W$ D# D( }$ v开发者可以通过 SmartX 提供的转换工具 String  Byte Array 实现这一步。
! p7 d9 X0 `0 t最后,将得到的 bytearray 转换成相应的字符串:9 _7 V! n3 O7 @( `- h6 M
\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
$ l' H3 s( I1 @% ~, L, x" M5 m; SGetTransactionByHash 函数通过交易哈希获取交易的例子如下:% k. d4 y4 X$ f' l0 d% ?
from ontology.interop.System.Blockchain import GetTransactionByHash
  P4 B. K  C( ]% B! B7 Xdef demo():  L* r1 j2 p. F( o, l5 l
    # tx_hash="9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1"    ! N( C/ F2 W6 T. w, d5 t; [$ n. ?
    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"), K7 R, M. x( g3 ~0 K
    tx=GetTransactionByHash(tx_hash)
; k/ y! f  F" ~5 O9 G    return tx8 K8 c% W/ u! v
2.4 GetTransactionHeight
$ i3 p) T9 }8 z8 _开发者可以使用 GetTransactionHeight 函数通过交易哈希获取交易高度。我们还是以上个例子中的哈希为例:8 W4 b4 l* S# H3 g) K
from ontology.interop.System.Blockchain import  GetTransactionHeight
: U: Q8 |, [: cdef demo():) S- ]4 s; o# g+ k% m% G% v7 ?& f& I
    # tx_hash="9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1"    / f- H' [/ N5 G/ `; n5 P: I. z- f$ X
    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")
4 m1 a  w' H5 t  j    height=GetTransactionHeight(tx_hash)
; [; l6 [9 W' [3 m% @) G    return height
! j  o* x. T8 z2.5 GetContract4 ?  }5 F! b' L6 |4 ~
开发者可以使用 GetContract 函数通过合约哈希获取合约。其中,合约哈希的转换过程与上面讲到的交易哈希转换过程一致。+ O5 E$ r) a4 A9 {2 I7 b) O
from ontology.interop.System.Blockchain import GetContract1 g, q/ q( D4 }' C' P6 A' a
def demo():
1 ^9 G: `" k& `+ Q5 X- e    # contract_hash="d81a75a5ff9b95effa91239ff0bb3232219698fa"    + [" @# K( }8 i. J- k
    contract_hash=bytearray(b"\xfa\x98\x96\x21\x32\x32\xbb\xf0\x9f\x23\x91\xfa\xef\x95\x9b\xff\xa5\x75\x1a\xd8")# s7 c4 {2 ]7 c, F
    contract=GetContract(contract_hash)( q% `1 c" N+ z! z! J6 J" e
    return contract6 }6 P% H: c. o3 s3 q
2.6 GetBlock$ I! n- P1 V3 @7 n0 k
开发者可以使用 GetBlock 函数获取区块。有两种方法可以获取指定区块:2 L: H! W8 S" W* N
通过块高获取区块:
  N" H  ^6 v& s; P  y& d9 V" ~6 y4 p
+ y1 _9 Q8 B( Jfrom ontology.interop.System.Blockchain import GetBlock& g& v- g; [+ `. `- U. c. m
def demo():
" ]; z& }! |0 m    block=GetBlock(1408)
0 B" Q1 o/ Q8 D. E/ H  ?: h9 |    return block* k' M2 j0 m' _% V, S8 u
2. 通过区块哈希获取区块:
/ y3 y6 p2 R' q% tfrom ontology.interop.System.Blockchain import GetBlock
* B6 w% z* a8 `/ |) Q2 Ydef demo():    ! w) W! B' ?0 ^4 D
    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')
" A) j4 D* N! H2 ]% z/ @, ?    block=GetBlock(block_hash)8 W3 J" q$ o! W4 Q0 _
03 Block API 使用方法
( F. b0 C7 d! L6 M/ f& [Block API 中可供引用的函数有三个,它们分别是 GetTransactions、GetTransactionCount 和 GetTransactionByIndex。我们依次介绍下这三个函数。! H9 b0 N# g2 _0 @5 w! A( S
3.1 GetTransactionCount" T9 P: X5 h; }3 B# C
开发者可以使用 GetTransactionCount 函数获取指定区块的交易数量。; Q' d3 k: f2 I" T) }9 M. }
from ontology.interop.System.Block import GetTransactionCount
' @+ G% p9 l, ?4 I9 |. Udef demo():
# Z6 k  T: x% Q/ }+ S    block=GetBlock(1408)
7 V* W  i9 n% t) ^# A2 ]( F0 @    count=GetTransactionCount(block)' e8 E; j7 q9 B7 m
    return count2 U, q8 H" G; W& j3 |9 e+ p
**3 N; }5 g- l; K% w% {% n! c
3.2 GetTransactions**. W2 c6 l( a: Q4 T
开发者可以使用 GetTransactions 函数获取获取指定区块的所有交易。# }- \$ M3 S, ~  e
from ontology.interop.System.Blockchain import GetBlock
7 ~4 G% ^( t9 {7 n& u; s  Ufrom ontology.interop.System.Block import GetTransactions
2 a' w$ q+ M% F$ R3 x5 V8 Vdef demo():: T; o; ^* H4 Q! I$ _: B
    block=GetBlock(1408)
4 x  Q: |- e1 c0 Q, X* q" ~' i    txs=GetTransactions(block)7 T  i6 E# s# |9 H
    return txs
% U! D4 F/ n) U( @3.3 GetTransactionByIndex+ {; v* A& Z% }6 P
开发者可以使用 GetTransactionByIndex 函数获取指定区块的指定交易。  j3 E7 u0 z8 V/ l2 N1 s! u
from ontology.interop.System.Blockchain import GetBlock+ e7 z$ ^  Y. {' J
from ontology.interop.System.Block import GetTransactionByIndex4 ]2 M" T+ }% ?. ]
def demo():- l. u' a5 I9 f) w4 M$ Y" o3 u
    block=GetBlock(1408): t; W  Z/ N! w# u' H/ V
    tx=GetTransactionByIndex(block,0) # index starts from 0.: r) m( A- o; x
    return tx( ?4 S, }2 P6 V
04 后记' @/ V6 J& o, n* \9 w
Blockchain & Block API 在智能合约中起到查询区块链数据和区块数据的作用,是智能合约最不可缺少的一部分。在后面的技术视点中,我们将讨论如何使用其它 API,探讨它们和本体区块链的交互。、
BitMere.com 比特池塘系信息发布平台,比特池塘仅提供信息存储空间服务。
声明:该文观点仅代表作者本人,本文不代表比特池塘立场,且不构成建议,请谨慎对待。
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

成为第一个吐槽的人

黄河347 小学生
  • 粉丝

    0

  • 关注

    0

  • 主题

    1