როგორ დავწეროთ ჭკვიანი კონტრაქტი პითონში ონტოლოგიის ქსელში. ნაწილი 3: Runtime API

ეს არის მე-3 ნაწილი საგანმანათლებლო სტატიების სერიის შესახებ Python-ში ჭკვიანი კონტრაქტების შექმნის შესახებ Ontology blockchain ქსელში. წინა სტატიებში ჩვენ გავეცანით

1. Blockchain & Block API
2. შენახვის API.

ახლა, როდესაც თქვენ გაქვთ წარმოდგენა იმის შესახებ, თუ როგორ უნდა გამოძახოთ შესაბამისი მუდმივი შენახვის API ონტოლოგიის ქსელში Python-ის გამოყენებით ჭკვიანი კონტრაქტის შემუშავებისას, მოდით გადავიდეთ გამოყენების სწავლაზე. Runtime API (Contract Execution API). Runtime API-ს აქვს 8 დაკავშირებული API, რომლებიც უზრუნველყოფენ საერთო ინტერფეისებს კონტრაქტის შესასრულებლად და ეხმარება დეველოპერებს მონაცემების მოძიებაში, გარდაქმნასა და დამოწმებაში.

ქვემოთ მოცემულია 8 API მონაცემების მოკლე აღწერა:

მოდით უფრო დეტალურად განვიხილოთ, თუ როგორ გამოვიყენოთ 8 API მონაცემები. მანამდე, თქვენ შეგიძლიათ შექმნათ ახალი კონტრაქტი Ontology ჭკვიანი კონტრაქტის განვითარების ინსტრუმენტში SmartX და მიჰყევით ქვემოთ მოცემულ ინსტრუქციას.

როგორ გამოვიყენოთ Runtime API

იმპორტის ორი გზა არსებობს Runtime API: ontology.interop.System.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) ფუნქციას აქვს ორი ფუნქცია:

• გადაამოწმეთ, არის თუ არა მიმდინარე ფუნქციის დამრეკი Acct-დან. თუ კი (ანუ, ხელმოწერის გადამოწმება გაიარა), ფუნქცია ბრუნდება.
• შეამოწმეთ, არის თუ არა ობიექტი, რომელიც იწვევს მიმდინარე ფუნქციას, არის კონტრაქტი. თუ ეს არის ხელშეკრულება და ფუნქცია შესრულებულია ხელშეკრულებიდან, მაშინ გადამოწმება გადის. ანუ, შეამოწმეთ, არის თუ არა fromAcct GetCallingScriptHash(-ის) დაბრუნებული მნიშვნელობა. GetCallingScriptHash() ფუნქციას შეუძლია მიიღოს კონტრაქტის ჰეშის მნიშვნელობა მიმდინარე ჭკვიანი კონტრაქტიდან.

GetCallingScriptHash():

უფრო გუთუბი

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

დამატებითი ინფორმაცია შეგიძლიათ იხილოთ საიტზე გუთუბი. შემდეგ სტატიაში გაგაცნობთ მშობლიური APIისწავლეთ როგორ გადაიტანოთ აქტივები ონტოლოგიის სმარტ კონტრაქტებში.

სტატია თარგმნეს რედაქტორებმა Hashate&Shares განსაკუთრებით OntologyRussia-სთვის.

დეველოპერი ხარ? შეუერთდით ჩვენს ტექნიკურ საზოგადოებას უთანხმოება. ასევე, გადახედეთ დეველოპერის ცენტრი ონტოლოგიაში, თქვენ შეგიძლიათ იპოვოთ მეტი ინსტრუმენტი, დოკუმენტაცია და მრავალი სხვა.

გახსენით ამოცანები დეველოპერებისთვის. დაასრულეთ დავალება და მიიღეთ ჯილდო.

მიმართვა ონტოლოგიის ნიჭიერი პროგრამისთვის სტუდენტებისთვის

Ontology

ონტოლოგიის საიტი - GitHub - უთანხმოება - რუსული ტელეგრამა - Twitter - Reddit

წყარო: www.habr.com