🥇 कसरी ओन्टोलजी नेटवर्कमा पाइथनमा स्मार्ट सम्झौता लेख्ने। भाग १: ब्लकचेन र ब्लक एपीआई

यो स्मार्ट अनुबंध विकास उपकरण प्रयोग गरेर ओन्टोलजी ब्लकचेन नेटवर्कमा पाइथन स्मार्ट अनुबंधहरू सिर्जना गर्ने ट्यूटोरियलहरूको श्रृंखलाको पहिलो भाग हो। स्मार्ट एक्स.

यस लेखमा, हामी Ontology smart Contract API सँग हाम्रो परिचय सुरु गर्नेछौं। Ontology स्मार्ट अनुबंध API 7 मोड्युलमा विभाजित छ:

Blockchain र Block API,
रनटाइम API,
भण्डारण API,
नेटिभ API,
API अपग्रेड गर्नुहोस्,
कार्यान्वयन इन्जिन API र
स्थिर र गतिशील कल API।

Blockchain र Block API ओन्टोलजी स्मार्ट अनुबंध प्रणाली को मुख्य भाग हो। ब्लकचेन एपीआईले आधारभूत ब्लकचेन क्वेरी अपरेशनहरूलाई समर्थन गर्दछ, जस्तै हालको ब्लकको उचाइ प्राप्त गर्ने, जबकि ब्लक एपीआईले आधारभूत ब्लक क्वेरी अपरेशनहरूलाई समर्थन गर्दछ, जस्तै दिइएको ब्लकको लागि लेनदेनको संख्या क्वेरी गर्ने।

सुरु गरौं!

पहिले, मा नयाँ सम्झौता सिर्जना गर्नुहोस् स्मार्ट एक्सर त्यसपछि तलका निर्देशनहरू पालना गर्नुहोस्।

1. Blockchain API कसरी प्रयोग गर्ने

स्मार्ट अनुबंध प्रकार्यहरूको लिङ्कहरू पाइथन लिङ्कहरूसँग समान छन्। तपाईं आवश्यक रूपमा सम्बन्धित कार्यहरू प्रविष्ट गर्न सक्नुहुन्छ। उदाहरणका लागि, निम्न कथनले हालको ब्लक उचाइ प्राप्त गर्न 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 ब्लक हेडर प्राप्त गर्न प्रयोग गरिन्छ, प्यारामिटर blockchain मा ब्लक को क्रम संख्या हो। उदाहरण:

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

TransactionByHash प्राप्त गर्नुहोस्

GetTransactionByHash लेनदेन ह्यास मार्फत लेनदेन प्राप्त गर्न प्रयोग गरिन्छ। लेनदेन ह्यास पठाइएको छ TransactionByHash प्राप्त गर्नुहोस् bytearray ढाँचामा प्यारामिटरहरूको रूपमा। यस प्रकार्यको कुञ्जी हेक्स ढाँचामा लेनदेन ह्यासलाई bytearray ढाँचामा लेनदेन ह्यासमा रूपान्तरण गर्नु हो। यो महत्त्वपूर्ण कदम हो। अन्यथा, तपाईले एउटा त्रुटि प्राप्त गर्नुहुनेछ जसले संकेत गर्दछ कि त्यो ब्लक ह्याससँग कुनै ब्लक छैन। हेक्स ढाँचामा लेनदेन ह्यासलाई बाइटियरे ढाँचामा रूपान्तरण गर्न उदाहरणको रूपमा लिनुहोस्। एउटा उदाहरण यस्तो देखिन्छ:

9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1

पहिले, लेनदेन ह्यासलाई उल्टाउनुहोस्:

c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279

विकासकर्ताहरूले 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}

यो SmartX द्वारा प्रदान गरिएको String Byte Array रूपान्तरण उपकरण प्रयोग गरेर गर्न सकिन्छ। अन्तमा, परिणामस्वरूप बाइटरेलाई समान स्ट्रिङमा रूपान्तरण गर्नुहोस्:

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. Block API कसरी प्रयोग गर्ने

त्यहाँ ब्लक API मा उपलब्ध तीन प्रकार्यहरू छन्: लेनदेन प्राप्त गर्नुहोस्, लेनदेन गणना प्राप्त गर्नुहोस्र लेनदेन द्वारा इन्डेक्स प्राप्त गर्नुहोस्। हामी तिनीहरूलाई एक एक गरेर तोड्नेछौं।

लेनदेन गणना प्राप्त गर्नुहोस्

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.

पछिशब्द

ब्लकचेन र ब्लक एपीआई स्मार्ट अनुबंधहरूको अपरिहार्य अंश हो किनभने तपाईंले तिनीहरूलाई ब्लकचेन डेटा अनुरोध गर्न र स्मार्ट अनुबंधहरूमा डेटा ब्लक गर्न प्रयोग गर्न सक्नुहुन्छ। निम्न लेखहरूमा, हामी बाँकी एपीआईहरू कसरी प्रयोग गर्ने र तिनीहरूले ओन्टोलजी ब्लकचेनसँग कसरी अन्तरक्रिया गर्छन् भनेर छलफल गर्नेछौं।

लेख विशेष गरी OntologyRussia को लागि Hashrate & Shares को सम्पादकहरु द्वारा अनुवाद गरिएको थियो। रुनु

तपाईं विकासकर्ता हुनुहुन्छ? हाम्रो प्राविधिक समुदायमा सामेल हुनुहोस् त्याग। साथै, एक नजर राख्नुहोस् विकासकर्ता केन्द्र हाम्रो वेबसाइटमा, जहाँ तपाइँ विकासकर्ता उपकरणहरू, कागजातहरू, र थप फेला पार्न सक्नुहुन्छ।

ओन्टोलोजी

स्रोत: www.habr.com

ओन्टोलजी नेटवर्कमा पाइथनमा स्मार्ट अनुबंध कसरी लेख्ने। भाग १: ब्लकचेन र ब्लक एपीआई