Как да напиша интелигентен договор в Python в мрежата Ontology. Част 3: API за изпълнение

Това е част 3 от поредица от уроци за създаване на интелигентни договори в Python в блокчейн мрежата Ontology. В предишни статии видяхме

1. Blockchain & Block API
2. API за съхранение.

Сега, след като имате представа как да извикате подходящия API за постоянно съхранение, когато разработвате интелигентен договор с Python в мрежата Ontology, нека преминем към научаването как да използвате API за изпълнение (API за изпълнение на договори). Runtime API има 8 свързани API, които предоставят общи интерфейси за изпълнение на договори и помагат на разработчиците да получават, трансформират и валидират данни.

По-долу е дадено кратко описание на API за данни 8:

Нека да разгледаме по-отблизо как да използвате тези 8 API. Преди това можете да създадете нов договор в инструмента за разработка на интелигентни договори Ontology SmartX и следвайте инструкциите по-долу.

Как да използвате API за изпълнение

Има два начина за импортиране API за изпълнение: ontology.interop.System.Runtime и ontology.interop.Ontology.Runtime. Онтологичният път съдържа новодобавени API. Редовете по-долу импортират API данните.

from ontology.interop.System.Runtime import GetTime, CheckWitness, Log, Notify, Serialize, Deserialize
from ontology.interop.Ontology.Runtime import Base58ToAddress, AddressToBase58, GetCurrentBlockHash

API за известяване

Функцията Notify излъчва събитието в цялата мрежа. В примера по-долу функцията Notify ще върне шестнадесетичния низ "hello word" и ще го разпространи в цялата мрежа.

from ontology.interop.System.Runtime import Notify
def demo():
    Notify("hello world")

Можете да видите това в регистрационните файлове:

GetTime API

Функцията GetTime връща текущото времево клеймо, което връща Unix времето, в което е извикана функцията. Мерната единица е секундата.

from ontology.interop.System.Runtime import GetTime
def demo():
    time=GetTime()
    return time # return a uint num

GetCurrentBlockHash API

Функцията GetCurrentBlockHash връща хеша на текущия блок.

from ontology.interop.Ontology.Runtime import GetCurrentBlockHash
def demo():
    block_hash = GetCurrentBlockHash()
    return block_hash

Сериализиране и десериализиране

Това е двойка функции за сериализация и десериализация. Функцията Serialize преобразува обект в обект bytearray, а функцията Deserialize преобразува bytearray в оригиналния му обект. Следният примерен код преобразува входящите параметри и ги съхранява в постоянното хранилище на договора. Той също така извлича данните от постоянното хранилище на договора и ги преобразува в оригиналния обект.

from ontology.interop.System.Runtime import GetTime, CheckWitness, Log, 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)
    data = Deserialize(byte_data)
    return data

Base58ToAddress и AddressToBase58

Тази двойка функции за превод на адреси. Функцията Base58ToAddress преобразува base58 кодиран адрес в bytearray адрес, а AddressToBase58 преобразува bytearray адрес в base58 кодиран адрес.

from ontology.interop.Ontology.Runtime import Base58ToAddress, AddressToBase58
def demo():
    base58_addr="AV1GLfVzw28vtK3d1kVGxv5xuWU59P6Sgn"
    addr=Base58ToAddress(base58_addr)
    Log(addr)
    base58_addr=AddressToBase58(addr)
    Log(base58_addr)

Проверете свидетел

Функцията CheckWitness(fromAcct) има две функции:

• Проверете дали обектът, извикващ текущата функция, е fromAcct. Ако да (т.е. проверката на подписа е преминала), функцията се връща.
• Проверете дали обектът, извикващ текущата функция, е договор. Ако това е договор и функцията се изпълнява от договора, тогава проверката е преминала. Тоест проверете дали fromAcct е върнатата стойност на GetCallingScriptHash(). Функцията GetCallingScriptHash() може да вземе хеш стойността на договора на текущия интелигентен договор.

GetCallingScriptHash():

Прочетете повече на Guthub

from ontology.interop.System.Runtime import CheckWitness
from ontology.interop.Ontology.Runtime import Base58ToAddress
def demo():
    addr=Base58ToAddress("AW8hN1KhHE3fLDoPAwrhtjD1P7vfad3v8z")
    res=CheckWitness(addr)
    return res

Повече информация можете да намерите на Guthub. В следващата статия ще представим Роден APIза да научите как да прехвърляте активи в интелигентни договори на Ontology.

Статията е преведена от редакторите Хешрейт и споделяния специално за OntologyRussia.

Вие сте разработчик? Присъединете се към нашата техническа общност на раздор. Освен това разгледайте Център за разработчици Онтология за повече инструменти, документация и др.

Отворени задачи за разработчици. Затворете задачата - вземете награда.

Приложи за програмата за таланти Ontology за студенти

Онтология

Онтологичен уебсайт - GitHub - раздор - Телеграма руски - Twitter - Reddit

Източник: www.habr.com