איך כותבים חוזה חכם בפייתון ברשת אונטולוגיה. חלק 3: ריצה API

זהו החלק השלישי בסדרת מאמרים חינוכיים על יצירת חוזים חכמים ב-Python ברשת הבלוקצ'יין אונטולוגיה. במאמרים קודמים התוודענו

1. Blockchain & Block API
2. ממשק API לאחסון.

כעת, לאחר שיש לך רעיון כיצד לקרוא ל-API האחסון המתמשך המתאים בעת פיתוח חוזה חכם באמצעות Python ברשת אונטולוגיה, בואו נעבור ללמוד כיצד להשתמש API של זמן ריצה (API לביצוע חוזה). ל-Runtime API יש 8 ממשקי API קשורים המספקים ממשקים נפוצים לביצוע חוזה ועוזרים למפתחים לאחזר, לשנות ולאמת נתונים.

להלן תיאור קצר של 8 נתוני ה-API:

בואו נסתכל מקרוב על איך להשתמש בנתוני 8 ה-API. לפני כן, תוכל ליצור חוזה חדש בכלי פיתוח חוזים חכמים Ontology SmartX ופעל לפי ההוראות שלהלן.

כיצד להשתמש ב- Runtime API

ישנן שתי דרכים לייבא זמן ריצה 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 תחזיר את מחרוזת הhex "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

ממשק API של GetCurrentBlockHash

הפונקציה GetCurrentBlockHash מחזירה את ה-hash של הבלוק הנוכחי.

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) יש שתי פונקציות:

• ודא אם המתקשר של הפונקציה הנוכחית הוא מ-Act. אם כן (כלומר, אימות החתימה עבר), הפונקציה חוזרת.
• בדוק אם האובייקט הקורא לפונקציה הנוכחית הוא חוזה. אם מדובר בחוזה והפונקציה מבוצעת מתוך החוזה, האימות מועבר. כלומר, ודא אם 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 מקומיכדי ללמוד כיצד להעביר נכסים בחוזים חכמים אונטולוגיה.

המאמר תורגם על ידי העורכים Hashrate&Shares במיוחד עבור אונטולוגיה רוסיה.

האם אתה מפתח? הצטרף לקהילת הטכנולוגיה שלנו ב- מחלוקת. כמו כן, תסתכל על מרכז מפתחים אונטולוגיה, תוכלו למצוא שם עוד כלים, תיעוד ועוד הרבה יותר.

משימות פתוחות למפתחים. השלם את המשימה וקבל פרס.

להגיש מועמדות עבור תוכנית הכישרונות אונטולוגיה לסטודנטים

אונטולוגיה

אתר אונטולוגיה - GitHub - מחלוקת - טלגרם רוסית - טויטר - reddit

מקור: www.habr.com