🥇ओन्टोलॉजी नेटवर्क पर पायथन में स्मार्ट कॉन्ट्रैक्ट कैसे लिखें। भाग 1: ब्लॉकचेन और ब्लॉक एपीआई

यह स्मार्ट कॉन्ट्रैक्ट डेवलपमेंट टूल का उपयोग करके ओन्टोलॉजी ब्लॉकचेन नेटवर्क पर पायथन में स्मार्ट कॉन्ट्रैक्ट बनाने पर शैक्षिक लेखों की श्रृंखला का पहला भाग है। SmartX.

इस लेख में, हम ओन्टोलॉजी स्मार्ट कॉन्ट्रैक्ट एपीआई से परिचित होना शुरू करेंगे। ओन्टोलॉजी स्मार्ट कॉन्ट्रैक्ट एपीआई को 7 मॉड्यूल में विभाजित किया गया है:

ब्लॉकचेन और ब्लॉक एपीआई,
रनटाइम एपीआई
भंडारण एपीआई
मूल एपीआई
एपीआई अपग्रेड करें,
निष्पादन इंजन एपीआई और
स्टेटिक और डायनेमिक कॉल एपीआई।

ब्लॉकचेन और ब्लॉक एपीआई ओन्टोलॉजी स्मार्ट कॉन्ट्रैक्ट सिस्टम का मुख्य हिस्सा है। ब्लॉकचेन एपीआई बुनियादी ब्लॉकचेन क्वेरी संचालन का समर्थन करता है, जैसे कि ब्लॉक की वर्तमान ऊंचाई प्राप्त करना, जबकि ब्लॉक एपीआई बुनियादी ब्लॉक क्वेरी संचालन का समर्थन करता है, जैसे किसी दिए गए ब्लॉक के लिए लेनदेन की संख्या को क्वेरी करना।

आएँ शुरू करें!

आरंभ करने के लिए, एक नया अनुबंध बनाएँ SmartX, और फिर नीचे दिए गए निर्देशों का पालन करें।

1. ब्लॉकचेन एपीआई का उपयोग कैसे करें

स्मार्ट कॉन्ट्रैक्ट फ़ंक्शन संदर्भ पायथन संदर्भों के समान हैं। आप आवश्यकतानुसार प्रासंगिक फ़ंक्शन दर्ज कर सकते हैं। उदाहरण के लिए, निम्नलिखित कथन GetHeight, एक ब्लॉक की वर्तमान ऊंचाई प्राप्त करने के लिए एक फ़ंक्शन, और GetHeader, ब्लॉक का शीर्षक प्राप्त करने के लिए एक फ़ंक्शन का परिचय देता है।

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

ऊँचाई प्राप्त करें

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

GetTransactionByHash का उपयोग लेनदेन हैश का उपयोग करके लेनदेन को पुनः प्राप्त करने के लिए किया जाता है। लेन-देन हैश को भेजा जाता है GetTransactionByHash बाइटरेरे प्रारूप में पैरामीटर के रूप में। इस फ़ंक्शन की कुंजी हेक्स प्रारूप में लेनदेन हैश को बायटेरे प्रारूप में लेनदेन हैश में परिवर्तित करना है। यह एक महत्वपूर्ण कदम है। अन्यथा आपको एक त्रुटि मिलेगी जो यह बताएगी कि उस ब्लॉक हैश के साथ कोई ब्लॉक नहीं है। आइए इसे बाइटरेरे प्रारूप में बदलने के लिए हेक्स प्रारूप में लेनदेन हैश को एक उदाहरण के रूप में लें। उदाहरण इस प्रकार दिखता है:

9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1

सबसे पहले लेन-देन हैश को उलटें:

c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279

डेवलपर्स स्मार्टएक्स द्वारा प्रदान किए गए हेक्स नंबर (लिटिल एंडियन) नंबर रूपांतरण टूल का उपयोग करके इस चरण को पूरा कर सकते हैं।

फिर परिणामी परिणाम को बाइटरेरे प्रारूप में परिवर्तित करें:

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

यह स्मार्टएक्स द्वारा प्रदान किए गए स्ट्रिंग बाइट ऐरे रूपांतरण टूल का उपयोग करके किया जा सकता है। अंत में, परिणामी बाइटरेरे को इस तरह एक स्ट्रिंग में परिवर्तित करें:

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 का उपयोग ब्लॉक प्राप्त करने के लिए किया जाता है। किसी विशिष्ट ब्लॉक को प्राप्त करने के दो तरीके हैं।

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. ब्लॉक एपीआई का उपयोग कैसे करें

ब्लॉक एपीआई में तीन उपलब्ध फ़ंक्शन हैं: लेन-देन प्राप्त करें, GetTransactionCountऔर GetTransactionByIndex. हम उन्हें एक-एक करके सुलझा लेंगे.

GetTransactionCount

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

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.

अंतभाषण

ब्लॉकचेन और ब्लॉक एपीआई स्मार्ट कॉन्ट्रैक्ट का एक अनिवार्य हिस्सा है क्योंकि आप इसका उपयोग ब्लॉकचेन डेटा को क्वेरी करने और स्मार्ट कॉन्ट्रैक्ट में डेटा को ब्लॉक करने के लिए कर सकते हैं। भविष्य के लेखों में, हम चर्चा करेंगे कि शेष एपीआई का उपयोग कैसे करें और समझें कि वे ओन्टोलॉजी ब्लॉकचेन के साथ कैसे इंटरैक्ट करते हैं।

लेख का अनुवाद हैशरेट एंड शेयर्स के संपादकों द्वारा विशेष रूप से ओन्टोलॉजी रूस के लिए किया गया था। क्लिक

क्या आप एक डेवलपर हैं? हमारे तकनीकी समुदाय में शामिल हों कलह. साथ ही, देखें डेवलपर केंद्र हमारी वेबसाइट पर, जहाँ आप डेवलपर टूल, दस्तावेज़ीकरण, और बहुत कुछ पा सकते हैं।

आंटलजी

स्रोत: www.habr.com

ओन्टोलॉजी नेटवर्क पर पायथन में स्मार्ट कॉन्ट्रैक्ट कैसे लिखें। भाग 1: ब्लॉकचेन और ब्लॉक एपीआई