🥇როგორ დავწეროთ ჭკვიანი კონტრაქტი პითონში ონტოლოგიის ქსელში. ნაწილი 1: Blockchain & Block API

ეს არის პირველი ნაწილი გაკვეთილების სერიის შესახებ Python ჭკვიანი კონტრაქტების შექმნის შესახებ Ontology blockchain ქსელში ჭკვიანი კონტრაქტის განვითარების ინსტრუმენტის გამოყენებით. SmartX.

ამ სტატიაში ჩვენ დავიწყებთ გაცნობას Ontology smart contract API-სთან. Ontology smart contract API დაყოფილია 7 მოდულად:

Blockchain & Block API,
გაშვების API,
შენახვის API,
მშობლიური API,
განაახლეთ API,
Execution Engine API და
Static & Dynamic Call API.

Blockchain & Block API არის ონტოლოგიის ჭკვიანი კონტრაქტის სისტემის ძირითადი ნაწილი. Blockchain API მხარს უჭერს ბლოკჩეინის მოთხოვნის ძირითად ოპერაციებს, როგორიცაა ამჟამინდელი ბლოკის სიმაღლის მიღება, ხოლო Block API მხარს უჭერს ძირითადი ბლოკის მოთხოვნის ოპერაციებს, როგორიცაა ტრანზაქციების რაოდენობის მოთხოვნა მოცემულ ბლოკზე.

Დავიწყოთ!

პირველ რიგში, შექმენით ახალი კონტრაქტი SmartXდა შემდეგ მიჰყევით ქვემოთ მოცემულ ინსტრუქციას.

1. როგორ გამოვიყენოთ Blockchain 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

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 როგორც პარამეტრები bytearray ფორმატში. ამ ფუნქციის გასაღები არის ტრანზაქციის ჰეშის თექვსმეტობით ფორმატში გადაქცევა ტრანზაქციის ჰეშში bytearray ფორმატში. ეს მნიშვნელოვანი ნაბიჯია. წინააღმდეგ შემთხვევაში, თქვენ მიიღებთ შეცდომას, რომელიც მიუთითებს, რომ არ არსებობს ბლოკი ამ ბლოკის ჰეშით. ავიღოთ ტრანზაქციის ჰეში თექვსმეტობით ფორმატში, როგორც მაგალითი, რომ გადავიყვანოთ იგი ბაიტის ფორმატში. მაგალითი ასე გამოიყურება:

9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1

პირველი, შეცვალეთ ტრანზაქციის ჰეში:

c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279

დეველოპერებს შეუძლიათ შეასრულონ ეს ნაბიჯი SmartX-ის მიერ მოწოდებული Hex Number(little endian)Number კონვერტაციის ხელსაწყოს გამოყენებით.

შემდეგ გადაიყვანეთ შედეგი 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

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

Block API-ში სამი ხელმისაწვდომი ფუნქციაა: GetTransactions, 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

დეველოპერებს შეუძლიათ გამოიყენონ 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.

Afterword

Blockchain & Block API არის ჭკვიანი კონტრაქტების შეუცვლელი ნაწილი, რადგან თქვენ შეგიძლიათ გამოიყენოთ ისინი ბლოკჩეინის მონაცემების მოთხოვნისა და სმარტ კონტრაქტებში მონაცემების დაბლოკვისთვის. შემდეგ სტატიებში განვიხილავთ, თუ როგორ გამოვიყენოთ დანარჩენი API-ები და გავიგოთ, როგორ ურთიერთქმედებენ ისინი ონტოლოგიის ბლოკჩეინთან.

სტატია თარგმნეს Hashrate&Shares-ის რედაქტორებმა სპეციალურად OntologyRussia-სთვის. ტირილი

დეველოპერი ხარ? შეუერთდით ჩვენს ტექნიკურ საზოგადოებას უთანხმოება. ასევე, გადახედეთ დეველოპერის ცენტრი ჩვენს ვებსაიტზე, სადაც შეგიძლიათ იპოვოთ დეველოპერის ხელსაწყოები, დოკუმენტაცია და სხვა.

Ontology

წყარო: www.habr.com

როგორ დავწეროთ ჭკვიანი კონტრაქტი პითონში ონტოლოგიის ქსელში. ნაწილი 1: Blockchain & Block API