🥇כיצד לכתוב חוזה חכם בפייתון ברשת אונטולוגיה. חלק 1: בלוקצ'יין ו-API של בלוקים

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

במאמר זה, נתחיל את ההיכרות שלנו עם ממשק ה-API של חוזים חכמים של Ontology. ממשק ה-API של חוזים חכמים של Ontology מחולק לשבעה מודולים:

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

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

בואו נתחיל!

כדי להתחיל, צור חוזה חדש ב SmartX, ולאחר מכן פעל לפי ההוראות שלהלן.

1. כיצד להשתמש בממשק ה-API של בלוקצ'יין

הפניות לפונקציות של חוזים חכמים זהות להפניות של פייתון. ניתן להזריק את הפונקציות המתאימות לפי הצורך. לדוגמה, ההצהרה הבאה מזריקה את GetHeight, פונקציה לאחזור גובה הבלוק הנוכחי, ואת GetHeader, פונקציה לאחזור כותרת הבלוק.

from ontology.interop.System.Blockchain import GetHeight, GetHeader

קבל גובה

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

from ontology.interop.System.Runtime import Notify
from ontology.interop.System.Blockchain import GetHeight
def Main(operation):
    if operation == 'demo':
        return demo()
    return False

def demo():
    height=GetHeight()
    Notify(height) # print height
    return height #return height after running the function

קבל כותרת

GetHeader משמש להשגת כותרת בלוק; הפרמטר הוא מספר הרצף של הבלוק בבלוקצ'יין. דוגמה:

from ontology.interop.System.Runtime import Notify
from ontology.interop.System.Blockchain import GetHeader
def demo():
    block_height=10
    header=GetHeader(block_height) 
    Notify(header)
return header

קבל עסקה על ידי Hash

GetTransactionByHash משמש לאחזור עסקה באמצעות גיבוב עסקה. גיבוב העסקה נשלח אל קבל עסקה על ידי Hash כפרמטרים בפורמט bytearray. המפתח לפונקציה זו הוא המרת גיבוב עסקת הקסדצימלי לגיבוב עסקת bytearray. זהו שלב חשוב. אחרת, תקבלו שגיאה המציינת שאין בלוק עם גיבוב הבלוק הזה. בואו ניקח גיבוב עסקת הקסדצימלי כדוגמה ונמיר אותו לפורמט bytearray. הדוגמה נראית כך:

9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1

ראשית, הפוך את קוד הגיבוב של העסקה:

c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279

מפתחים יכולים לבצע שלב זה באמצעות כלי המרת מספרים הקסדצימלי (little endian) המסופק על ידי SmartX.

לאחר מכן, המירו את הערך המתקבל לפורמט bytearray:

{0xc1,0x89,0x0c,0x4d,0x73,0x06,0x26,0xdf,0xaa,0x94,0x49,0x41,0x9d,0x66,0x25,0x05,0xea,0xb3,0xbd,0xa2,0xe1,0xf0,0x1f,0x89,0x46,0x3c,0xc1,0xa4,0xa3,0x0a,0x27,0x9f}

ניתן לעשות זאת באמצעות כלי ההמרה של מערך בתים של String המסופק על ידי SmartX. לבסוף, המירו את מערך הבייטים שנוצר למחרוזת כך:

xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f

להלן דוגמה לפונקציה GetTransactionByHash, אשר לוקחת עסקה לפי קוד ה-hash שלה:

from ontology.interop.System.Blockchain import GetTransactionByHash
def demo():
    # tx_hash="9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1"    
    tx_hash=bytearray(b"xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f")
    tx=GetTransactionByHash(tx_hash)
    return tx

גובה קבל עסקה

GetTransactionHeight משמש לאחזור גובה העסקה באמצעות קוד הגיבוב של העסקה. בואו נשתמש בקוד הגיבוב מהדוגמה לעיל:

from ontology.interop.System.Blockchain import  GetTransactionHeight
def demo():
    #   tx_hash="9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1"    
    tx_hash=bytearray(b"xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f")
    height=GetTransactionHeight(tx_hash)
    return height

קבל חוזה

מפתחים יכולים להשתמש בפונקציה GetContract כדי לאחזר חוזה באמצעות ה-hash שלו. תהליך המרת ה-hash של החוזה זהה לתהליך המרת ה-hash של העסקה שתואר לעיל.

from ontology.interop.System.Blockchain import GetContract
def demo():
    # contract_hash="d81a75a5ff9b95effa91239ff0bb3232219698fa"    
    contract_hash=bytearray(b"xfax98x96x21x32x32xbbxf0x9fx23x91xfaxefx95x9bxffxa5x75x1axd8")
    contract=GetContract(contract_hash)
    return contract

GetBlock

GetBlock משמש להשגת בלוק. ישנן שתי דרכים להשיג בלוק ספציפי.

1. קבל גובה בלוק אחר בלוק:

from ontology.interop.System.Blockchain import GetBlock
def demo():
    block=GetBlock(1408)
    return block

2. קבלו גיבוב בלוק אחר בלוק:

from ontology.interop.System.Blockchain import GetBlock
def demo():    
    block_hash=bytearray(b'x16xe0xc5x40x82x79x77x30x44xeax66xc8xc4x5dx17xf7x17x73x92x33x6dx54xe3x48x46x0bxc3x2fxe2x15x03xe4')
    block=GetBlock(block_hash)

2. כיצד להשתמש בממשק ה-API של Block

ישנן שלוש פונקציות זמינות ב-API של Block: קבל עסקאות, קבל מספר פעולותו - קבל עסקה לפי אינדקסננתח אותם אחד אחד.

קבל מספר פעולות

הפונקציה GetTransactionCount משמשת לקבלת מספר העסקאות עבור בלוק נתון.

from ontology.interop.System.Blockchain import GetBlock
from ontology.interop.System.Block import GetTransactionCount
def demo():
    block=GetBlock(1408)
    count=GetTransactionCount(block)
    return count

קבל עסקאות

מפתחים יכולים להשתמש בפונקציה GetTransactions כדי לקבל את כל העסקאות בבלוק נתון.

from ontology.interop.System.Blockchain import GetBlock
from ontology.interop.System.Block import GetTransactions 
def demo():
    block=GetBlock(1408)
    txs=GetTransactions(block)
    return txs

קבל עסקה לפי אינדקס

הפונקציה GetTransactionByIndex משמשת לאיסוף עסקה ספציפית בבלוק נתון.

from ontology.interop.System.Blockchain import GetBlock
from ontology.interop.System.Block import GetTransactionByIndex
def demo():
    block=GetBlock(1408)
    tx=GetTransactionByIndex(block,0) # index starts from 0.
    return tx

את המדריך המלא ניתן למצוא באתר שלנו GitHub.

אחרית דבר

ממשק ה-API של Blockchain & Block הוא חלק בלתי נפרד מחוזים חכמים, שכן ניתן להשתמש בו כדי לבצע שאילתות על נתוני בלוקצ'יין ובלוקים בתוך חוזים חכמים. במאמרים עתידיים נדון כיצד להשתמש ב-API הנותרים ונחקור את האינטראקציות שלהם עם בלוקצ'יין של אונטולוגיה.