🥇 ऑन्टोलॉजी नेटवर्कवर पायथनमध्ये स्मार्ट करार कसा लिहायचा. भाग 1: ब्लॉकचेन आणि ब्लॉक API

स्मार्ट कॉन्ट्रॅक्ट डेव्हलपमेंट टूलचा वापर करून ऑन्टोलॉजी ब्लॉकचेन नेटवर्कवर पायथन स्मार्ट कॉन्ट्रॅक्ट्स तयार करण्याच्या ट्यूटोरियलच्या मालिकेतील हा पहिला भाग आहे. स्मार्टएक्स.

या लेखात, आम्ही ऑन्टोलॉजी स्मार्ट कॉन्ट्रॅक्ट एपीआयशी आमची ओळख सुरू करू. ऑन्टोलॉजी स्मार्ट कॉन्ट्रॅक्ट API 7 मॉड्यूलमध्ये विभागले गेले आहे:

ब्लॉकचेन आणि ब्लॉक API,
रनटाइम API,
स्टोरेज API,
मूळ API,
API अपग्रेड करा,
एक्झिक्युशन इंजिन API आणि
स्टॅटिक आणि डायनॅमिक कॉल API.

ब्लॉकचेन आणि ब्लॉक API हे ऑन्टोलॉजी स्मार्ट कॉन्ट्रॅक्ट सिस्टमचा मुख्य भाग आहे. ब्लॉकचेन API मूलभूत ब्लॉकचेन क्वेरी ऑपरेशन्सना समर्थन देते, जसे की वर्तमान ब्लॉकची उंची मिळवणे, तर ब्लॉक API मूलभूत ब्लॉक क्वेरी ऑपरेशन्सचे समर्थन करते, जसे की दिलेल्या ब्लॉकसाठी व्यवहारांची संख्या क्वेरी करणे.

चला सुरू करुया!

प्रथम, मध्ये एक नवीन करार तयार करा स्मार्टएक्सआणि नंतर खालील सूचनांचे अनुसरण करा.

1. Blockchain API कसे वापरावे

स्मार्ट कॉन्ट्रॅक्ट फंक्शन्सच्या लिंक्स पायथन लिंक्स सारख्याच असतात. आपण आवश्यकतेनुसार संबंधित कार्ये प्रविष्ट करू शकता. उदाहरणार्थ, खालील विधान वर्तमान ब्लॉकची उंची मिळविण्यासाठी GetHeight फंक्शन आणि ब्लॉकचे शीर्षलेख मिळविण्यासाठी GetHeader फंक्शन सादर करते.

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

GetHeight

खालील उदाहरणात दाखवल्याप्रमाणे, ब्लॉकचेनमधील शेवटचा ब्लॉक अनुक्रम क्रमांक मिळविण्यासाठी GetHeight चा वापर केला जातो. शेवटच्या उदाहरणात, आम्ही सोयीसाठी मुख्य कार्य वगळू, परंतु आवश्यक असल्यास तुम्ही ते जोडू शकता.

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

ब्लॉक हेडर मिळविण्यासाठी 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

ट्रान्झॅक्शन बाय हॅश मिळवा

GetTransactionByHash चा वापर ट्रान्झॅक्शन हॅशद्वारे व्यवहार मिळविण्यासाठी केला जातो. कडे व्यवहार हॅश पाठवला आहे ट्रान्झॅक्शन बाय हॅश मिळवा bytearray स्वरूपात पॅरामीटर्स म्हणून. या फंक्शनची गुरुकिल्ली हेक्स फॉरमॅटमधील ट्रान्झॅक्शन हॅशला बायटियरे फॉरमॅटमध्ये ट्रान्झॅक्शन हॅशमध्ये रूपांतरित करणे आहे. हे एक महत्त्वाचे पाऊल आहे. अन्यथा, तुम्हाला एक त्रुटी मिळेल जी सूचित करते की त्या ब्लॉक हॅशसह कोणताही ब्लॉक नाही. हेक्स फॉरमॅटमधील ट्रान्झॅक्शन हॅश हे बायटियरे फॉरमॅटमध्ये रूपांतरित करण्यासाठी उदाहरण म्हणून घेऊ. एक उदाहरण असे दिसते:

9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1

प्रथम, व्यवहार हॅश उलट करा:

c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279

SmartX द्वारे प्रदान केलेले Hex Number(little endian) Number रूपांतरण साधन वापरून विकसक ही पायरी पूर्ण करू शकतात.

नंतर परिणाम बायटियर फॉर्मेटमध्ये रूपांतरित करा:

{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}

हे SmartX द्वारे प्रदान केलेले स्ट्रिंग बाइट अॅरे रूपांतरण साधन वापरून केले जाऊ शकते. शेवटी, परिणामी बाइटअरे समान स्ट्रिंगमध्ये रूपांतरित करा:

xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f

खालील GetTransactionByHash फंक्शनचे उदाहरण आहे जे व्यवहाराचा हॅश वापरून व्यवहार करते:

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 फंक्शन वापरू शकतात. कॉन्ट्रॅक्ट हॅश रूपांतरण प्रक्रिया वर नमूद केलेल्या ट्रान्झॅक्शन हॅश रूपांतरण प्रक्रियेसारखीच आहे.

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 कसे वापरावे

ब्लॉक API मध्ये तीन उपलब्ध कार्ये आहेत: व्यवहार मिळवा, TransactionCount मिळवाआणि TransactionByIndex मिळवा. आम्ही त्यांना एक एक करून तोडून टाकू.

TransactionCount मिळवा

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

TransactionByIndex मिळवा

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 हा स्मार्ट कॉन्ट्रॅक्टचा अपरिहार्य भाग आहे कारण तुम्ही ब्लॉकचेन डेटाची विनंती करण्यासाठी आणि स्मार्ट कॉन्ट्रॅक्टमध्ये डेटा ब्लॉक करण्यासाठी त्यांचा वापर करू शकता. पुढील लेखांमध्ये, आम्ही उर्वरित APIs कसे वापरावे आणि ते ऑन्टोलॉजी ब्लॉकचेनशी कसे संवाद साधतात ते शोधू.

लेखाचा अनुवाद हॅशरेट आणि शेअर्सच्या संपादकांनी विशेषतः ऑन्टोलॉजी रशियासाठी केला आहे. रडणे

तुम्ही डेव्हलपर आहात का? येथे आमच्या टेक समुदायात सामील व्हा विचित्र. तसेच, एक कटाक्ष विकसक केंद्र आमच्या वेबसाइटवर, जिथे तुम्ही विकसक साधने, दस्तऐवजीकरण आणि बरेच काही शोधू शकता.

Ontology

स्त्रोत: www.habr.com

ऑन्टोलॉजी नेटवर्कवर पायथनमध्ये स्मार्ट करार कसा लिहायचा. भाग १: ब्लॉकचेन आणि ब्लॉक API