Hur man skriver ett smart kontrakt i Python på Ontology-nätverket. Del 3: Runtime API

Det här är den tredje delen av en serie utbildningsartiklar om hur man skapar smarta kontrakt på Python i blockchain-nätverket Ontology. I de tidigare artiklarna har vi blivit bekanta med

1. Blockchain & Block API
2. Storage API.

Nu när du har en uppfattning om hur du anropar det lämpliga API:t för permanent lagring när du utvecklar ett smart kontrakt med Python i Ontology-nätverket, låt oss gå vidare till att lära oss hur man använder Runtime API (Contract Execution API). Runtime API har 8 relaterade API:er som erbjuder allmänna gränssnitt för att köra kontrakt och hjälper utvecklare att hämta, omvandla och verifiera data.

Nedanför finns en kort beskrivning av dessa 8 API:er:

Låt oss ta en närmare titt på hur vi använder dessa 8 API:er. Innan dess kan du skapa ett nytt kontrakt i Ontology:s utvecklingsverktyg för smarta kontrakt SmartX och följa de nedanstående instruktionerna.

Hur man använder Runtime API

Det finns två sätt att importera Runtime API: ontology.interop.System.Runtime och ontology.interop.Ontology.Runtime. Ontology-sökvägen innehåller nyligen tillagda API:er. De följande raderna importerar dessa API:er.

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

Notify API

Funktionen Notify sänder ett händelse genom hela nätverket. I det följande exemplet kommer funktionen Notify att returnera hex-strängen “hello world” och sprida den över hela nätverket.

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

Du kan se detta i loggarna:

GetTime API

Funktionen GetTime returnerar den aktuella tidsstämpeln, vilket ger Unix-tiden då funktionen anropades. Enheten är sekunder.

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

GetCurrentBlockHash API

Funktionen GetCurrentBlockHash returnerar hash av den aktuella block.

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

Serialize och Deserialize

Detta är ett par funktioner för serialisering och deserialisering. Funktionen Serialize omvandlar ett objekt till ett bytearray-objekt, medan funktionen Deserialize omvandlar bytearray tillbaka till det ursprungliga objektet. Det följande kodexemplet genomför omvandlingen av inkommande parametrar och sparar dem i kontraktets permanenta lagring. Det hämtar också data från kontraktets permanenta lagring och omvandlar dem tillbaka till det ursprungliga objektet.

från ontology.interop.System.Runtime importera GetTime, CheckWitness, Log, Notify, Serialize, Deserialize
från ontology.interop.System.Storage importera Put, Get, GetContext

def Main(operation, args):
    om operation == 'serialize_to_bytearray':
        data = args[0]
        return serialize_to_bytearray(data)
    om 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 och AddressToBase58

Detta är ett par funktioner för konvertering av adresser. Funktionen Base58ToAddress konverterar en base58-kodad adress till en adress i form av bytearray, medan AddressToBase58 konverterar en adress i form av bytearray till en base58-kodad adress.

från ontology.interop.Ontology.Runtime importera Base58ToAddress, AddressToBase58
def demo():
    base58_addr="AV1GLfVzw28vtK3d1kVGxv5xuWU59P6Sgn"
    addr=Base58ToAddress(base58_addr)
    Log(addr)
    base58_addr=AddressToBase58(addr)
    Log(base58_addr)

CheckWitness

Funktionen CheckWitness(fromAcct) har två funktioner:

• Verifiera om objektet fromAcct som anropar den aktuella funktionen. Om så är fallet (dvs. underskriftskontrollen är godkänd), returneras funktionen.
• Kontrollera om objektet som anropar den aktuella funktionen är ett kontrakt. Om det är ett kontrakt och funktionen anropas från kontraktet, så är verifieringen godkänd. Det vill säga, verifiera om fromAcct är värdet som returneras av GetCallingScriptHash(). Funktionen GetCallingScriptHash() kan ta värdet av hashkoden för det aktuella smarta kontraktet.

GetCallingScriptHash():

Mer information finns på Guthub

från ontology.interop.System.Runtime importera CheckWitness
från ontology.interop.Ontology.Runtime importera Base58ToAddress
def demo():
    addr=Base58ToAddress("AW8hN1KhHE3fLDoPAwrhtjD1P7vfad3v8z")
    res=CheckWitness(addr)
    return res

Mer information kan hittas på Guthub. I nästa artikel kommer vi att presentera Native API, för att förstå hur man överför tillgångar i Ontologys smarta kontrakt.

Artikeln har översatts av redaktionen Hashrate&Shares speciellt för OntologyRussia.

Är du utvecklare? Gå med i vårt tekniska samhälle på Discord. Dessutom, kolla in Utvecklarcentrum Ontology, där du kan hitta fler verktyg, dokumentation och mycket mer.

Öppna uppgifter för utvecklare. Stäng uppgiften — få en belöning.

Ansök till Ontologys talangprogram för studenter

Ontology

Ontology-webbplats — GitHub — Discord — Telegram Ryska — Twitter — Reddit

Källa: habr.com