{"id":52506,"date":"2019-11-10T00:00:00","date_gmt":"2019-11-09T21:00:00","guid":{"rendered":"https:\/\/prohoster.info\/blog\/blog_prohoster\/kak-napisat-smart-kontrakt-na-python-v-seti-ontology-chast-1-blockchain-block-api"},"modified":"2020-02-18T14:00:15","modified_gmt":"2020-02-18T11:00:15","slug":"kak-napisat-smart-kontrakt-na-python-v-seti-ontology-chast-1-blockchain-block-api","status":"publish","type":"post","link":"https:\/\/prohoster.info\/ro\/blog\/administrirovanie\/kak-napisat-smart-kontrakt-na-python-v-seti-ontology-chast-1-blockchain-block-api","title":{"rendered":"Cum s\u0103 scrii un smart contract pe Python \u00een re\u021beaua Ontology. Partea 1: Blockchain & Block API","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Cum
\n
\nAceasta este prima parte dintr-o serie de articole educa\u021bionale despre crearea de contracte inteligente \u00een Python \u00een re\u021beaua blockchain Ontology, folosind instrumentul de dezvoltare a contractelor inteligente. SmartX<\/a><\/noindex>. <\/p>\n

\u00cen acest articol, vom \u00eencepe s\u0103 ne familiariz\u0103m cu API-ul contractului inteligent Ontology. API-ul contractului inteligent Ontology este \u00eemp\u0103r\u021bit \u00een 7 module: <\/p>\n

    \n
  1. Blockchain & Block API, <\/li>\n
  2. Runtime API, <\/li>\n
  3. Storage API, <\/li>\n
  4. Native API, <\/li>\n
  5. Upgrade API, <\/li>\n
  6. Execution Engine API \u0219i <\/li>\n
  7. Static & Dynamic Call API.<\/li>\n<\/ol>\n

    \nBlockchain & Block API este partea principal\u0103 a sistemului de contracte inteligente Ontology. API-ul Blockchain sus\u021bine opera\u021biuni de baz\u0103 pentru cererile blockchain, cum ar fi ob\u021binerea \u00een\u0103l\u021bimii curente a blocului, \u00een timp ce API-ul Block sus\u021bine opera\u021biuni de baz\u0103 pentru cererile de bloc, cum ar fi solicitarea num\u0103rului de tranzac\u021bii pentru un anumit bloc.<\/p>\n

    S\u0103 \u00eencepem!<\/b><\/p>\n

    Pentru \u00eenceput, crea\u021bi un nou contract \u00een SmartX<\/a><\/noindex>, apoi urma\u021bi instruc\u021biunile de mai jos.
    \n     <\/a><\/noindex><\/p>\n

    1. Cum s\u0103 utiliza\u021bi Blockchain API<\/h3>\n

    \nLeg\u0103turile c\u0103tre func\u021biile contractelor inteligente sunt identice cu leg\u0103turile Python. Pute\u021bi introduce func\u021biile corespunz\u0103toare dup\u0103 necesitate. De exemplu, instruc\u021biunea de mai jos introduce GetHeight\u2014 func\u021bia pentru ob\u021binerea \u00een\u0103l\u021bimii curente a blocului, \u0219i GetHeader\u2014 func\u021bia pentru ob\u021binerea titlului blocului.<\/p>\n

    from ontology.interop.System.Blockchain import GetHeight, GetHeader<\/code><\/pre>\n
    <\/p>\n
    GetHeight<\/h4>\n
    \nGetHeight este utilizat pentru a ob\u021bine ultimul num\u0103r de ordine al blocului \u00een blockchain, a\u0219a cum se arat\u0103 \u00een exemplul de mai jos. \u00cen ultimul exemplu, pentru comoditate, vom omite func\u021bia Main, dar o pute\u021bi ad\u0103uga dac\u0103 este necesar.<\/p>\n
    from ontology.interop.System.Runtime import Notify\nfrom ontology.interop.System.Blockchain import GetHeight\ndef Main(operation):\n    if operation == 'demo':\n        return demo()\n    return False\n\ndef demo():\n    height=GetHeight()\n    Notify(height) # print height\n    return height #return height after running the function<\/code><\/pre>\n
    <\/p>\n
    GetHeader<\/h4>\n
    \nGetHeader este utilizat pentru a ob\u021bine titlul blocului, parametrul fiind num\u0103rul de ordine al blocului \u00een blockchain. Exemplu:<\/p>\n
    from ontology.interop.System.Runtime import Notify\nfrom ontology.interop.System.Blockchain import GetHeader\ndef demo():\n    block_height=10\n    header=GetHeader(block_height)\n    Notify(header)\nreturn header<\/code><\/pre>\n
    <\/p>\n
    GetTransactionByHash<\/h4>\n
    \nGetTransactionByHash este utilizat pentru a ob\u021bine tranzac\u021bia prin hash-ul tranzac\u021biilor. Hash-ul tranzac\u021biei este trimis \u00een GetTransactionByHash <\/i>ca parametru \u00een format bytearray. Cheia acestei func\u021bii este conversia hash-ului tranzac\u021biei din format hex \u00een hash-ul tranzac\u021biei \u00een format bytearray. Acesta este un pas important. Altfel, ve\u021bi primi o eroare care indic\u0103 c\u0103 nu exist\u0103 un bloc cu acest hash. S\u0103 lu\u0103m hash-ul tranzac\u021biei \u00een format hex ca exemplu pentru a-l converti \u00een format bytearray. Exemplul arat\u0103 astfel:<\/p>\n
    9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1<\/code><\/pre>\n
    \nMai \u00eent\u00e2i, r\u0103sturna\u021bi hash-ul tranzac\u021biei:<\/p>\n
    c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279<\/code><\/pre>\n
    \nDezvoltatorii pot realiza acest pas cu ajutorul instrumentului de conversie Hex Number (little endian) oferit de SmartX.<\/p>\n
    Apoi, transforma\u021bi rezultatul ob\u021binut \u00eentr-un format bytearray:<\/p>\n
    {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}<\/code><\/pre>\n
    \nAcest lucru se poate face cu ajutorul instrumentului de conversie String Byte Array, care este furnizat de SmartX. La final, transforma\u021bi bytearray-ul ob\u021binut \u00eentr-un string similar:<\/p>\n
    xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f<\/code><\/pre>\n
    \nMai jos este un exemplu de func\u021bie GetTransactionByHash, care preia o tranzac\u021bie prin intermediul hash-ului tranzac\u021biei:<\/p>\n
    from ontology.interop.System.Blockchain import GetTransactionByHash\ndef demo():\n    # tx_hash=\"9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1\"    \n    tx_hash=bytearray(b\"xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f\")\n    tx=GetTransactionByHash(tx_hash)\n    return tx<\/code><\/pre>\n
    GetTransactionHeight<\/h4>\n
    \nGetTransactionHeight este utilizat pentru a ob\u021bine \u00een\u0103l\u021bimea unei tranzac\u021bii prin intermediul hash-ului tranzac\u021biei. S\u0103 lu\u0103m hash-ul din exemplul de mai sus:<\/p>\n
    from ontology.interop.System.Blockchain import  GetTransactionHeight\ndef demo():\n    #   tx_hash=\"9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1\"    \n    tx_hash=bytearray(b\"xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f\")\n    height=GetTransactionHeight(tx_hash)\n    return height<\/code><\/pre>\n
    <\/p>\n
    GetContract<\/h4>\n
    \nDezvoltatorii pot utiliza func\u021bia GetContract pentru a ob\u021bine un contract prin intermediul hash-ului contractului. Procesul de conversie a hash-ului contractului este similar cu cel al hash-ului tranzac\u021biei men\u021bionat mai sus.<\/p>\n
    from ontology.interop.System.Blockchain import GetContract\ndef demo():\n    # contract_hash=\"d81a75a5ff9b95effa91239ff0bb3232219698fa\"    \n    contract_hash=bytearray(b\"xfax98x96x21x32x32xbbxf0x9fx23x91xfaxefx95x9bxffxa5x75x1axd8\")\n    contract=GetContract(contract_hash)\n    return contract<\/code><\/pre>\n
    <\/p>\n
    GetBlock<\/h4>\n
    \nGetBlock este utilizat pentru a ob\u021bine un bloc. Exist\u0103 dou\u0103 modalit\u0103\u021bi de a ob\u021bine un bloc specific.<\/p>\n
    1. Ob\u021bine\u021bi blocul dup\u0103 \u00een\u0103l\u021bimea blocului:<\/b><\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\ndef demo():\n    block=GetBlock(1408)\n    return block<\/code><\/pre>\n
    \n2. Ob\u021bine\u021bi blocul dup\u0103 hash-ul blocului:<\/b><\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\ndef demo():    \n    block_hash=bytearray(b'x16xe0xc5x40x82x79x77x30x44xeax66xc8xc4x5dx17xf7x17x73x92x33x6dx54xe3x48x46x0bxc3x2fxe2x15x03xe4')\n    block=GetBlock(block_hash)<\/code><\/pre>\n
    <\/p>\n
    2. Cum s\u0103 utiliza\u021bi Block API<\/h3>\n
    \nExist\u0103 trei func\u021bii disponibile \u00een Block API: GetTransactions<\/i>, GetTransactionCount<\/i>, \u0219i GetTransactionByIndex<\/i>. Le vom analiza una c\u00e2te una.<\/p>\n
    GetTransactionCount<\/h4>\n
    \nGetTransactionCount este utilizat pentru a ob\u021bine num\u0103rul de tranzac\u021bii pentru un anumit bloc.<\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\nfrom ontology.interop.System.Block import GetTransactionCount\ndef demo():\n    block=GetBlock(1408)\n    count=GetTransactionCount(block)\n    return count<\/code><\/pre>\n
    <\/p>\n
    GetTransactions<\/h3>\n
    \nDezvoltatorii pot utiliza func\u021bia GetTransactions pentru a ob\u021bine toate tranzac\u021biile din acest bloc.<\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\nfrom ontology.interop.System.Block import GetTransactions \ndef demo():\n    block=GetBlock(1408)\n    txs=GetTransactions(block)\n    return txs<\/code><\/pre>\n
    <\/p>\n
    GetTransactionByIndex<\/h4>\n
    \nGetTransactionByIndex este utilizat pentru a ob\u021bine o tranzac\u021bie specific\u0103 din acest bloc.<\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\nfrom ontology.interop.System.Block import GetTransactionByIndex\ndef demo():\n    block=GetBlock(1408)\n    tx=GetTransactionByIndex(block,0) # indexul \u00eencepe de la 0.\n    return tx<\/code><\/pre>\n
    \nGhidul complet poate fi g\u0103sit pe site-ul nostru GitHub<\/a><\/noindex>.<\/p>\n
    Cuv\u00e2nt \u00eenainte<\/h3>\n
    \nBlockchain & Block API este o parte esen\u021bial\u0103 a contractelor inteligente, deoarece le pute\u021bi utiliza pentru a solicita datele blockchain-ului \u0219i datele blocului \u00een contractele inteligente. \u00cen articolele urm\u0103toare, vom discuta despre utilizarea celorlalte API-uri \u0219i vom explora interac\u021biunile lor cu blockchain-ul Ontology.<\/p>\n
    Articolul a fost tradus de redac\u021bia Hashrate&Shares special pentru OntologyRussia. clic<\/a><\/noindex> <\/p><\/blockquote>\n
     E\u0219ti dezvoltator? Al\u0103tur\u0103-te comunit\u0103\u021bii noastre tehnice pe Discord<\/a><\/noindex>. De asemenea, arunc\u0103 o privire pe Centrul de Dezvoltatori<\/a><\/noindex> pe site-ul nostru, unde pute\u021bi g\u0103si instrumente pentru dezvoltatori, documenta\u021bie \u0219i multe altele.<\/p>\n
    Ontology<\/h4>\n
    <\/p>\n