风险提示:理性看待区块链,提高风险意识!
技术视点 | Python智能合约执行API知多少?
首页 > 币界资讯 > 区块链新闻 2019-09-12 15:12:50
币界网报道:

01 导语

上一期我们介绍了本体智能合约存储 API,相信很多小伙伴都明白了在本体上进行 Python 智能合约开发时如何调用相关 API 进行持久化存储。本期我们讨论如何使用 Runtime API(合约执行 API)。Runtime API 共有8个相关的 API,提供了合约执行时常用的接口,帮助开发者获取数据、转换数据以及验证数据。这8个 API 的简单描述如下:

图 | 网络

下面我们具体讲述一下这8个 API 的使用方法。在这之前,小伙伴们可以在本体智能合约开发工具 SmartX 中新建一个合约,跟着我们进行操作。同样,在文章最后我们将给出这次讲解的所有源代码以及视频讲解。 

02 Runtime API 使用方法

Runtime API 的引用分为两个路径,分别是 ontology.interop.System.Runtime 和 ontology.interop.Ontology.Runtime。其中,Ontology 路径下包含了新增的 API。下列语句引用了这几个 API。

from ontology.interop.System.Runtime import GetTime, CheckWitness, Notify, Serialize, Deserialize
from ontology.interop.Ontology.Runtime import Base58ToAddress, AddressToBase58, GetCurrentBlockHas
2.1  Notify API

Notify 函数将事件推送到全网。如下例子中函数 Notify 将会返回 “hello world” 十六进制字符串,并将其推送全网。

from ontology.interop.System.Runtime import Notify
def demo():
    Notify("hello world")
小伙伴可以在 Logs 中查看:

2.2  GetTime API

GetTime 函数返回当前时间戳,即返回调用该函数的 Unix 时间,其单位是秒。
from ontology.interop.System.Runtime import GetTime
def demo():
    time=GetTime()
    return time # 返回时间戳, 单位是秒
2.3  GetCurrentBlockHash API

GetCurrentBlockHash 函数返回当前区块的哈希值。
from ontology.interop.Ontology.Runtime import GetCurrentBlockHash
def demo():
    block_hash = GetCurrentBlockHash()
    return block_hash
2.4  Serialize 和 Deserialize

这是一对序列化和反序列化函数。其中,Serialize 函数将一个对象序列化成 byte array 对象,而 Deserialize 函数将 byte array 反序列化成原先对象。下面的代码片段实现了将传入参数序列化并存入合约的持久化存储中,同时也实现了从合约的持久化存储中取出数据并把它进行反序列化。
from ontology.interop.System.Runtime import Notify, Serialize, Deserialize
from ontology.interop.System.Storage import Put, Get, GetContext
def Main(operation, args):
    if operation == 'serialize_to_bytearray':
        data = args[0]
        return serialize_to_bytearray(data)
    if operation == 'deserialize_from_bytearray':
        key = args[0]
        return deserialize_from_bytearray(key)
    return False
def serialize_to_bytearray(data):
    sc = GetContext()
    key = "1"
    byte_data = Serialize(data) # 序列化传入的参数
    Put(sc, key, byte_data) # 将序列化后的数据存入区块链

def deserialize_from_bytearray(key): sc = GetContext() byte_data = Get(sc, key) # 按key从区块链中取出数据 data = Deserialize(byte_data) # 将bytearray数据反序列化成原先类型数据 return data

2.5 Base58ToAddress & AdressToBase58
from ontology.interop.Ontology.Runtime import Base58ToAddress, AddressToBase58
def demo():
    base58_addr="AV1GLfVzw28vtK3d1kVGxv5xuWU59P6Sgn"
    addr=Base58ToAddress(base58_addr) # 将 base58 地址转成 bytearray形式地址
    Notify(addr)
    base58_addr=AddressToBase58(addr) #将bytearray地址转为base58地址
    Notify(base58_addr)

这是一对地址转换函数。其中,Base58ToAddress 函数将 base58 编码的地址转成 byte array 形式地址,而 AddressToBase58 则将 byte array 形式地址转成 base58 编码的地址。
2.6  CheckWitness

CheckWitness(fromAcct) 函数有两个功能:
  • 验证当前的函数调用者是不是 fromAcct 。若是(即签名验证通过),则函数返回通过。
  • 检查当前函数调用者是不是一个合约。若是合约,且是从该合约发起去执行函数,则验证通过。即,验证 fromAcct 是不是 GetCallingScriptHash() 的返回值。其中,GetCallingScriptHash()  函数可以得到调用当前智能合约的合约哈希值。
GetCallingScriptHash():

https://github.com/ontio/ontology-python-compiler/blob/master/ontology/interop/System/ExecutionEngine.py

from ontology.interop.System.Runtime import CheckWitness
from ontology.interop.Ontology.Runtime import Base58ToAddress
def demo():
    addr=Base58ToAddress("AW8hN1KhHE3fLDoPAwrhtjD1P7vfad3v8z")
    res=CheckWitness(addr) # 验证调用者地址是否为AW8hN1KhHE3fLDoPAwrhtjD1P7vfad3v8z
    return res

03 总结

本次技术视点中我们介绍了本体区块链的 Runtime API,该类 API 在本体 Python 智能合约中用处十分巨大。在下一期技术视点中,我们将介绍 Native API,探讨如何在本体智能合约中进行转账等操作。本期讲述的所有语法部分我们提供了中文视频,小伙伴们可以观看学习。

上一篇: 你不得不看的PoS现状:热捧后腰斩,Staking还值得期待吗
下一篇: 区块链入门 | 跨链技术方案之哈希锁定
推荐专栏
Boss Wallet Web3 Econom Pass
专注币圈最新资讯
通俗浅显地聊透Web3大事小情
读懂区块链生态与未来,尽在币界网!
热门币种
更多
币种
美元价格
24H涨跌幅
BTC比特币
60,963.61 USDT
¥435,103.38
-2.72%
ETH以太坊
3,368.69 USDT
¥24,042.67
-0.3%
BNB币安币
570.68 USDT
¥4,073.00
-0.28%
USDT泰达币
1.02 USDT
¥7.25
-0.19%
SOL
135.96 USDT
¥970.36
+7.66%
USDC
1.00 USDT
¥7.15
-0.01%
TON
7.59 USDT
¥54.14
+4.55%
XRP瑞波币
0.47720 USDT
¥3.41
+0.48%
DOGE狗狗币
0.12210 USDT
¥0.87140
+2.43%
ADA艾达币
0.39050 USDT
¥2.79
+3.88%
热搜币种
更多
币种
美元价格
24H涨跌幅
比特币
60831.25 USDT
¥442,072.86
-1.68%
Solana
141.3 USDT
¥1,026.86
-4.66%
Curve
0.2797 USDT
¥2.03
-3.42%
Beta Finance
0.087037 USDT
¥0.63
-13.31%
Filecoin
4.4482 USDT
¥32.33
-1.04%
狗狗币
0.1235 USDT
¥0.90
-1.04%
柚子
0.5909 USDT
¥4.29
+1.27%
Conflux
0.1649 USDT
¥1.20
-3.57%
Shiba Inu
1.706E-5 USDT
¥0.00
-2.74%
dYdX
1.3664 USDT
¥9.93
-3.36%
波场
0.1233 USDT
¥0.90
+0.33%
Arweave
26.1722 USDT
¥190.20
-2.31%
最新快讯
更多
Consensys回应起诉:预料之中,坚信美SEC没有被授予监管MetaMask等的权力
2024-06-29 01:53:05
币界网最新行情晚报:NEAR价格达5.018美元/枚,日内跌幅-3.05%
2024-06-29 01:52:26
币界网最新行情晚报:MATIC价格达0.5576美元/枚,日内跌幅-2.00%
2024-06-29 01:50:39
Wormhole推出WormholeGovernorV2:流量取消调控器
2024-06-29 01:39:54
币界网最新行情晚报:PEOPLE价格达0.09038美元/枚,日内涨幅3.28%
2024-06-29 01:22:42
某鲸鱼于40分钟前向币安转入2200万枚CRV
2024-06-29 01:14:32
受美SEC指控影响,LDO、RPL24小时均跌超6%
2024-06-29 01:13:00
下载币界网APP