{"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\/pl\/blog\/administrirovanie\/kak-napisat-smart-kontrakt-na-python-v-seti-ontology-chast-1-blockchain-block-api","title":{"rendered":"Jak napisa\u0107 smart kontrakt w Pythonie w sieci Ontology. Cz\u0119\u015b\u0107 1: Blockchain i Block API","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Jak
\n
\nTo pierwsza cz\u0119\u015b\u0107 serii artyku\u0142\u00f3w edukacyjnych na temat tworzenia smart kontrakt\u00f3w w Pythonie w sieci blockchain Ontology za pomoc\u0105 narz\u0119dzia do tworzenia smart kontrakt\u00f3w. SmartX<\/a><\/noindex>. <\/p>\n

W tym artykule rozpoczniemy zapoznawanie si\u0119 z API smart kontraktu Ontology. API smart kontraktu Ontology jest podzielone na 7 modu\u0142\u00f3w: <\/p>\n

    \n
  1. Blockchain i 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 oraz <\/li>\n
  7. Static i Dynamic Call API.<\/li>\n<\/ol>\n

    \nBlockchain i Block API jest kluczow\u0105 cz\u0119\u015bci\u0105 systemu smart kontrakt\u00f3w Ontology. Blockchain API wspiera podstawowe operacje zwi\u0105zane z zapytaniami blockchain, takie jak pobieranie bie\u017c\u0105cej wysoko\u015bci bloku, podczas gdy Block API wspiera podstawowe operacje zapytaniowe zwi\u0105zane z blokami, takie jak zapytanie o liczb\u0119 transakcji dla danego bloku.<\/p>\n

    Przejd\u017amy do rzeczy!<\/b><\/p>\n

    Na pocz\u0105tek stw\u00f3rz nowy kontrakt w SmartX<\/a><\/noindex>, a nast\u0119pnie post\u0119puj zgodnie z poni\u017cszymi instrukcjami.
    \n     <\/a><\/noindex><\/p>\n

    1. Jak u\u017cywa\u0107 Blockchain API<\/h3>\n

    \nOdno\u015bniki do funkcji smart kontrakt\u00f3w s\u0105 identyczne z odno\u015bnikami w Pythonie. Mo\u017cesz wprowadza\u0107 odpowiednie funkcje w razie potrzeby. Na przyk\u0142ad, poni\u017csza instrukcja wprowadza GetHeight \u2014 funkcj\u0119 do uzyskiwania bie\u017c\u0105cej wysoko\u015bci bloku, oraz GetHeader \u2014 funkcj\u0119 do uzyskiwania nag\u0142\u00f3wka bloku.<\/p>\n

    from ontology.interop.System.Blockchain import GetHeight, GetHeader<\/code><\/pre>\n
    <\/p>\n
    GetHeight<\/h4>\n
    \nGetHeight jest u\u017cywane do uzyskiwania ostatniego numeru porz\u0105dkowego bloku w blockchainie, jak pokazano w poni\u017cszym przyk\u0142adzie. W ostatnim przyk\u0142adzie dla u\u0142atwienia pominiemy funkcj\u0119 Main, ale mo\u017cesz j\u0105 doda\u0107, je\u015bli to konieczne.<\/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 jest u\u017cywane do uzyskiwania nag\u0142\u00f3wka bloku, a jego parametrem jest numer porz\u0105dkowy bloku w blockchainie. Przyk\u0142ad:<\/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 jest u\u017cywane do uzyskiwania transakcji na podstawie hasha transakcji. Hash transakcji jest wysy\u0142any do GetTransactionByHash <\/i>jako parametry w formacie bytearray. Kluczowym elementem tej funkcji jest konwersja hasha transakcji w formacie hex na hash transakcji w formacie bytearray. To wa\u017cny krok. W przeciwnym razie otrzymasz b\u0142\u0105d, kt\u00f3ry wskazuje, \u017ce nie ma bloku z takim hashem. We\u017amy hash transakcji w formacie hex, jako przyk\u0142ad, aby przekszta\u0142ci\u0107 go w format bytearray. Przyk\u0142ad wygl\u0105da nast\u0119puj\u0105co:<\/p>\n
    9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1<\/code><\/pre>\n
    \nNajpierw odwr\u00f3\u0107 hash transakcji:<\/p>\n
    c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279<\/code><\/pre>\n
    \nProgrami\u015bci mog\u0105 wykona\u0107 ten krok za pomoc\u0105 narz\u0119dzia konwersji Hex Number (little endian), kt\u00f3re jest dostarczane przez SmartX.<\/p>\n
    Nast\u0119pnie przekszta\u0142\u0107 uzyskany wynik w 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
    \nMo\u017cna to zrobi\u0107 za pomoc\u0105 narz\u0119dzia konwersji String Byte Array, kt\u00f3re jest dostarczane przez SmartX. Na koniec przekszta\u0142\u0107 uzyskany bytearray w podobny ci\u0105g:<\/p>\n
    xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f<\/code><\/pre>\n
    \nPoni\u017cej znajduje si\u0119 przyk\u0142ad funkcji GetTransactionByHash, kt\u00f3ra pobiera transakcj\u0119 za pomoc\u0105 hasha transakcji:<\/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 u\u017cywana jest do uzyskania wysoko\u015bci transakcji za pomoc\u0105 hasha transakcji. We\u017amy hash z powy\u017cszego przyk\u0142adu:<\/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
    \nProgrami\u015bci mog\u0105 u\u017cywa\u0107 funkcji GetContract, aby uzyska\u0107 kontrakt za pomoc\u0105 hasha kontraktu. Proces konwersji hasha kontraktu jest analogiczny do procesu konwersji hasha transakcji, kt\u00f3ry zosta\u0142 wcze\u015bniej wspomniany.<\/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 u\u017cywana jest do uzyskania bloku. Istniej\u0105 dwa sposoby, aby uzyska\u0107 konkretny blok.<\/p>\n
    1. Uzyska\u0107 blok po wysoko\u015bci bloku:<\/b><\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\ndef demo():\n    block=GetBlock(1408)\n    return block<\/code><\/pre>\n
    \n2. Uzyska\u0107 blok po hashu bloku:<\/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. Jak u\u017cywa\u0107 Block API<\/h3>\n
    \nIstniej\u0105 trzy dost\u0119pne funkcje w Block API: GetTransactions<\/i>, GetTransactionCount<\/i>, i GetTransactionByIndex<\/i>. Om\u00f3wimy je jedna po drugiej.<\/p>\n
    GetTransactionCount<\/h4>\n
    \nGetTransactionCount u\u017cywana jest do uzyskania liczby transakcji dla danego bloku.<\/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
    \nProgrami\u015bci mog\u0105 u\u017cywa\u0107 funkcji GetTransactions, aby uzyska\u0107 wszystkie transakcje w danym bloku.<\/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 u\u017cywa si\u0119 do uzyskania konkretnej transakcji w danym bloku.<\/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) # indeks zaczyna si\u0119 od 0.\n    return tx<\/code><\/pre>\n
    \nPe\u0142ne instrukcje mo\u017cna znale\u017a\u0107 na naszym GitHub<\/a><\/noindex>.<\/p>\n
    Epilog<\/h3>\n
    \nBlockchain & Block API jest niezast\u0105pion\u0105 cz\u0119\u015bci\u0105 inteligentnych kontrakt\u00f3w, poniewa\u017c mo\u017cesz ich u\u017cy\u0107, aby za\u017c\u0105da\u0107 danych blockchaina i danych blok\u00f3w w inteligentnych kontraktach. W nast\u0119pnych artyku\u0142ach om\u00f3wimy, jak u\u017cywa\u0107 pozosta\u0142ych API i wyja\u015bnimy ich interakcje z blockchainem Ontology.<\/p>\n
    Artyku\u0142 zosta\u0142 przet\u0142umaczony przez redakcj\u0119 Hashrate&Shares specjalnie dla OntologyRussia. klik<\/a><\/noindex> <\/p><\/blockquote>\n
     Jeste\u015b programist\u0105? Do\u0142\u0105cz do naszej spo\u0142eczno\u015bci technicznej na Discord<\/a><\/noindex>. Ponadto zajrzyj do Centrum dewelopera<\/a><\/noindex> na naszej stronie, tam mo\u017cesz znale\u017a\u0107 narz\u0119dzia dla deweloper\u00f3w, dokumentacj\u0119 i wiele wi\u0119cej.<\/p>\n
    Ontology<\/h4>\n
    <\/p>\n