របៀបសរសេរកិច្ចសន្យាឆ្លាតវៃនៅក្នុង Python នៅលើបណ្តាញ Ontology ។ ផ្នែកទី 1៖ Blockchain & Block API

នេះគឺជាផ្នែកដំបូងនៃអត្ថបទអប់រំអំពីការបង្កើតកិច្ចសន្យាឆ្លាតវៃនៅក្នុង Python នៅលើបណ្តាញ Ontology blockchain ដោយប្រើឧបករណ៍អភិវឌ្ឍន៍កិច្ចសន្យាឆ្លាតវៃ ក្រុមហ៊ុន SmartX.

នៅក្នុងអត្ថបទនេះ យើងនឹងចាប់ផ្តើមស្គាល់គ្នារបស់យើងជាមួយនឹង Ontology smart contract API។ Ontology smart contract API ចែកចេញជា 7 ម៉ូឌុល៖

1. Blockchain & Block API,
2. Runtime API
3. API ផ្ទុក
4. API ដើម
5. ធ្វើឱ្យប្រសើរឡើង API,
6. Execution Engine API និង
7. API ហៅតាមឋិតិវន្ត និងថាមវន្ត។

Blockchain & Block API គឺជាផ្នែកស្នូលនៃប្រព័ន្ធកិច្ចសន្យាឆ្លាតវៃ Ontology ។ Blockchain API គាំទ្រប្រតិបត្តិការសំណួរ blockchain ជាមូលដ្ឋាន ដូចជាការទទួលបានកម្ពស់បច្ចុប្បន្ននៃប្លុក ខណៈពេលដែល Block API គាំទ្រប្រតិបត្តិការសំណួរប្លុកមូលដ្ឋាន ដូចជាការសាកសួរចំនួនប្រតិបត្តិការសម្រាប់ប្លុកដែលបានផ្តល់ឱ្យ។

តោះ​ចាប់ផ្តើម!

ដើម្បីចាប់ផ្តើម សូមបង្កើតកិច្ចសន្យាថ្មីនៅក្នុង ក្រុមហ៊ុន SmartXហើយបន្ទាប់មកធ្វើតាមការណែនាំខាងក្រោម។

1. របៀបប្រើ Blockchain API

ឯកសារយោងមុខងារកិច្ចសន្យាឆ្លាតវៃគឺដូចគ្នាបេះបិទទៅនឹងឯកសារយោង Python ។ អ្នកអាចបញ្ចូលមុខងារដែលពាក់ព័ន្ធតាមតម្រូវការ។ ឧទាហរណ៍ សេចក្តីថ្លែងការណ៍ខាងក្រោមណែនាំ GetHeight ដែលជាមុខងារដើម្បីទទួលបានកម្ពស់បច្ចុប្បន្ននៃប្លុក និង GetHeader ដែលជាមុខងារដើម្បីទទួលបានចំណងជើងប្លុក។

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

GetHeight

GetHeight ត្រូវបានប្រើដើម្បីទទួលបានលេខលំដាប់ប្លុកចុងក្រោយនៅក្នុង blockchain ដូចដែលបានបង្ហាញក្នុងឧទាហរណ៍ខាងក្រោម។ ក្នុងឧទាហរណ៍ចុងក្រោយ ដើម្បីភាពងាយស្រួល យើងនឹងរំលងមុខងារ 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 ត្រូវបានប្រើដើម្បីទទួលបានបឋមកថាប្លុក ប៉ារ៉ាម៉ែត្រគឺជាលេខសៀរៀលនៃប្លុកនៅក្នុង 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

GetTransactionByHash

GetTransactionByHash ត្រូវបានប្រើដើម្បីទាញយកប្រតិបត្តិការដោយប្រើសញ្ញាប្រតិបត្តិការ។ លេខកូដប្រតិបត្តិការត្រូវបានផ្ញើទៅ GetTransactionByHash ជាប៉ារ៉ាម៉ែត្រក្នុងទ្រង់ទ្រាយ bytearray ។ គន្លឹះនៃមុខងារនេះគឺដើម្បីបំប្លែង hash ប្រតិបត្តិការក្នុងទម្រង់ hex ទៅជា transaction hash ក្នុងទម្រង់ bytearray។ នេះគឺជាជំហានដ៏សំខាន់មួយ។ បើមិនដូច្នេះទេ អ្នកនឹងទទួលបានកំហុសដែលបង្ហាញថាមិនមានប្លុកជាមួយនឹងសញ្ញាប្លុកនោះ។ ចូរយកសញ្ញាប្រតិបត្តិការក្នុងទម្រង់ hex ជាឧទាហរណ៍ ដើម្បីបំប្លែងវាទៅជាទម្រង់ bytearray។ ឧទាហរណ៍មើលទៅដូចនេះ៖

9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1

ជាដំបូង បញ្ច្រាសការដកឃ្លា៖

c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279

អ្នកអភិវឌ្ឍន៍អាចសម្រេចបាននូវជំហាននេះដោយប្រើឧបករណ៍បំប្លែងលេខ Hex (little endian) Number ដែលផ្តល់ដោយ 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 Byte Array ដែលផ្តល់ដោយ SmartX ។ ជាចុងក្រោយ បំប្លែង bytearray លទ្ធផលទៅជា string ដូចនេះ៖

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

GetTransactionHeight ត្រូវបានប្រើដើម្បីទទួលបានកម្ពស់ប្រតិបត្តិការដោយប្រើសញ្ញាប្រតិបត្តិការ។ ចូរយក hash ពីឧទាហរណ៍ខាងលើ៖

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

GetContract

អ្នកអភិវឌ្ឍន៍អាចប្រើមុខងារ 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 ត្រូវបានប្រើដើម្បីទទួលបានប្លុក។ មានវិធីពីរយ៉ាងដើម្បីទទួលបានប្លុកជាក់លាក់។

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 គឺជាផ្នែកមួយដែលមិនអាចខ្វះបាននៃកិច្ចសន្យាឆ្លាតវៃ ព្រោះអ្នកអាចប្រើវាដើម្បីសាកសួរទិន្នន័យ blockchain និងទប់ស្កាត់ទិន្នន័យនៅក្នុងកិច្ចសន្យាឆ្លាតវៃ។ នៅក្នុងអត្ថបទនាពេលអនាគត យើងនឹងពិភាក្សាអំពីរបៀបប្រើ APIs ដែលនៅសល់ និងស្វែងយល់ពីរបៀបដែលពួកគេធ្វើអន្តរកម្មជាមួយ Ontology blockchain ។

អត្ថបទនេះត្រូវបានបកប្រែដោយអ្នកកែសម្រួលនៃ Hashrate & Shares ជាពិសេសសម្រាប់ OntologyRussia ។ យំ

តើអ្នកជាអ្នកអភិវឌ្ឍន៍មែនទេ? ចូលរួមជាមួយសហគមន៍បច្ចេកវិទ្យារបស់យើងនៅ វិវាទ. ផងដែរសូមក្រឡេកមើល មជ្ឈមណ្ឌលអ្នកអភិវឌ្ឍន៍ នៅលើគេហទំព័ររបស់យើង ដែលអ្នកអាចស្វែងរកឧបករណ៍អ្នកអភិវឌ្ឍន៍ ឯកសារ និងច្រើនទៀត។

Ontology

• គេហទំព័រ Ontology
• GitHub / វិវាទ
• Telegram ភាសាអង់គ្លេស / ប្រទេសរុស្ស៊ី
• Twitter / Reddit

ប្រភព: www.habr.com