{"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\/pt\/blog\/administrirovanie\/kak-napisat-smart-kontrakt-na-python-v-seti-ontology-chast-1-blockchain-block-api","title":{"rendered":"Como escrever um smart contract em Python na rede Ontology. Parte 1: Blockchain & API de Bloco","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Como
\n
\nEsta \u00e9 a primeira parte de uma s\u00e9rie de artigos educacionais sobre como criar contratos inteligentes em Python na rede blockchain Ontology usando a ferramenta de desenvolvimento de contratos inteligentes. SmartX<\/a><\/noindex>. <\/p>\n

Neste artigo, come\u00e7aremos a nos familiarizar com a API do contrato inteligente Ontology. A API do contrato inteligente Ontology \u00e9 dividida em 7 m\u00f3dulos: <\/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 e <\/li>\n
  7. Static & Dynamic Call API.<\/li>\n<\/ol>\n

    \nA Blockchain & Block API \u00e9 a parte principal do sistema de contratos inteligentes da Ontology. A API do Blockchain suporta opera\u00e7\u00f5es b\u00e1sicas de consulta blockchain, como, por exemplo, obter a altura atual do bloco, enquanto a API do Block suporta opera\u00e7\u00f5es b\u00e1sicas de consulta de blocos, como, por exemplo, solicitar a quantidade de transa\u00e7\u00f5es para um determinado bloco.<\/p>\n

    Vamos come\u00e7ar!<\/b><\/p>\n

    Para come\u00e7ar, crie um novo contrato em SmartX<\/a><\/noindex>, e depois siga as instru\u00e7\u00f5es abaixo.
    \n     <\/a><\/noindex><\/p>\n

    1. Como usar a Blockchain API<\/h3>\n

    \nOs links para as fun\u00e7\u00f5es dos contratos inteligentes s\u00e3o id\u00eanticos aos links do Python. Voc\u00ea pode inserir as fun\u00e7\u00f5es correspondentes conforme necess\u00e1rio. Por exemplo, a instru\u00e7\u00e3o abaixo insere GetHeight \u2014 a fun\u00e7\u00e3o para obter a altura atual do bloco, e GetHeader \u2014 a fun\u00e7\u00e3o para obter o cabe\u00e7alho do bloco.<\/p>\n

    from ontology.interop.System.Blockchain import GetHeight, GetHeader<\/code><\/pre>\n
    <\/p>\n
    GetHeight<\/h4>\n
    \nGetHeight \u00e9 usado para obter o n\u00famero de ordem mais recente do bloco na blockchain, como mostrado no exemplo abaixo. No \u00faltimo exemplo, para conveni\u00eancia, omitiremos a fun\u00e7\u00e3o Main, mas voc\u00ea pode adicion\u00e1-la se necess\u00e1rio.<\/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 \u00e9 usado para obter o cabe\u00e7alho do bloco, tendo como par\u00e2metro o n\u00famero de ordem do bloco na blockchain. Exemplo:<\/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 \u00e9 usado para obter uma transa\u00e7\u00e3o pelo hash da transa\u00e7\u00e3o. O hash da transa\u00e7\u00e3o \u00e9 passado em GetTransactionByHash <\/i>como par\u00e2metros em formato bytearray. A chave para esta fun\u00e7\u00e3o \u00e9 converter o hash da transa\u00e7\u00e3o do formato hex para o formato bytearray. Este \u00e9 um passo importante. Caso contr\u00e1rio, voc\u00ea receberia um erro indicando que n\u00e3o h\u00e1 bloco com tal hash. Vamos pegar o hash da transa\u00e7\u00e3o no formato hex como exemplo para convert\u00ea-lo para o formato bytearray. O exemplo \u00e9 o seguinte:<\/p>\n
    9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1<\/code><\/pre>\n
    \nPrimeiro, inverta o hash da transa\u00e7\u00e3o:<\/p>\n
    c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279<\/code><\/pre>\n
    \nOs desenvolvedores podem realizar esta etapa usando a ferramenta de convers\u00e3o Hex Number (little endian) Number, fornecida pela SmartX.<\/p>\n
    Em seguida, converta o resultado obtido para o formato 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
    \nIsso pode ser feito com a ferramenta de convers\u00e3o String Byte Array, que \u00e9 fornecida pela SmartX. Finalmente, converta o bytearray resultante em uma string semelhante:<\/p>\n
    xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f<\/code><\/pre>\n
    \nAbaixo est\u00e1 um exemplo da fun\u00e7\u00e3o GetTransactionByHash, que obt\u00e9m a transa\u00e7\u00e3o atrav\u00e9s do hash da transa\u00e7\u00e3o:<\/p>\n
    from ontology.interop.System.Blockchain import GetTransactionByHash\ndef demo():\n    # tx_hash=\"9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1\"    \ntx_hash=bytearray(b\"xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f\")\ntx=GetTransactionByHash(tx_hash)\nreturn tx<\/code><\/pre>\n
    GetTransactionHeight<\/h4>\n
    \nGetTransactionHeight \u00e9 utilizado para obter a altura da transa\u00e7\u00e3o atrav\u00e9s do hash da transa\u00e7\u00e3o. Vamos pegar o hash do exemplo acima:<\/p>\n
    from ontology.interop.System.Blockchain import  GetTransactionHeight\ndef demo():\n    #   tx_hash=\"9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1\"    \ntx_hash=bytearray(b\"xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f\")\nheight=GetTransactionHeight(tx_hash)\nreturn height<\/code><\/pre>\n
    <\/p>\n
    GetContract<\/h4>\n
    \nOs desenvolvedores podem usar a fun\u00e7\u00e3o GetContract para obter o contrato atrav\u00e9s do hash do contrato. O processo de convers\u00e3o do hash do contrato \u00e9 similar ao processo de convers\u00e3o do hash da transa\u00e7\u00e3o mencionado acima.<\/p>\n
    from ontology.interop.System.Blockchain import GetContract\ndef demo():\n    # contract_hash=\"d81a75a5ff9b95effa91239ff0bb3232219698fa\"    \ncontract_hash=bytearray(b\"xfax98x96x21x32x32xbbxf0x9fx23x91xfaxefx95x9bxffxa5x75x1axd8\")\ncontract=GetContract(contract_hash)\nreturn contract<\/code><\/pre>\n
    <\/p>\n
    GetBlock<\/h4>\n
    \nGetBlock \u00e9 utilizado para obter um bloco. Existem duas maneiras de obter um bloco espec\u00edfico.<\/p>\n
    1. Obter bloco pela altura do bloco:<\/b><\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\ndef demo():\nblock=GetBlock(1408)\nreturn block<\/code><\/pre>\n
    \n2. Obter bloco pelo hash do bloco:<\/b><\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\ndef demo():    \nblock_hash=bytearray(b'x16xe0xc5x40x82x79x77x30x44xeax66xc8xc4x5dx17xf7x17x73x92x33x6dx54xe3x48x46x0bxc3x2fxe2x15x03xe4')\nblock=GetBlock(block_hash)<\/code><\/pre>\n
    <\/p>\n
    2. Como usar a API de Blocos<\/h3>\n
    \nExistem tr\u00eas fun\u00e7\u00f5es dispon\u00edveis na API de Blocos: GetTransactions<\/i>, GetTransactionCount<\/i>, quanto GetTransactionByIndex<\/i>. Vamos analis\u00e1-las uma a uma.<\/p>\n
    GetTransactionCount<\/h4>\n
    \nGetTransactionCount \u00e9 utilizado para obter o n\u00famero de transa\u00e7\u00f5es para o bloco especificado.<\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\nfrom ontology.interop.System.Block import GetTransactionCount\ndef demo():\nblock=GetBlock(1408)\ncount=GetTransactionCount(block)\nreturn count<\/code><\/pre>\n
    <\/p>\n
    GetTransactions<\/h3>\n
    \nOs desenvolvedores podem usar a fun\u00e7\u00e3o GetTransactions para obter todas as transa\u00e7\u00f5es neste bloco.<\/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 \u00e9 usado para obter uma transa\u00e7\u00e3o espec\u00edfica neste bloco.<\/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) # o \u00edndice come\u00e7a em 0.\n    return tx<\/code><\/pre>\n
    \nO guia completo pode ser encontrado em nosso GitHub<\/a><\/noindex>.<\/p>\n
    Ep\u00edlogo<\/h3>\n
    \nA API Blockchain & Block \u00e9 uma parte indispens\u00e1vel dos contratos inteligentes, pois voc\u00ea pode us\u00e1-las para solicitar dados da blockchain e dados do bloco em contratos inteligentes. Nos pr\u00f3ximos artigos, discutiremos como usar as outras APIs e entenderemos sua intera\u00e7\u00e3o com a blockchain Ontology.<\/p>\n
    Este artigo foi traduzido pela equipe da Hashrate & Shares especialmente para a OntologyRussia. clique<\/a><\/noindex> <\/p><\/blockquote>\n
     Voc\u00ea \u00e9 desenvolvedor? Junte-se \u00e0 nossa comunidade t\u00e9cnica em Discord<\/a><\/noindex>. Al\u00e9m disso, d\u00ea uma olhada no Centro de Desenvolvedores<\/a><\/noindex> em nosso site, onde voc\u00ea pode encontrar ferramentas de desenvolvedor, documenta\u00e7\u00e3o e muito mais.<\/p>\n
    Ontology<\/h4>\n
    <\/p>\n