{"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\/es\/blog\/administrirovanie\/kak-napisat-smart-kontrakt-na-python-v-seti-ontology-chast-1-blockchain-block-api","title":{"rendered":"C\u00f3mo escribir un contrato inteligente en Python en la red Ontology. Parte 1: Blockchain & Block API","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"C\u00f3mo
\n
\nEsta es la primera parte de una serie de art\u00edculos educativos sobre c\u00f3mo crear contratos inteligentes en Python en la red blockchain de Ontology utilizando la herramienta de desarrollo de contratos inteligentes. SmartX<\/a><\/noindex>. <\/p>\n

En este art\u00edculo, comenzaremos a familiarizarnos con la API de contratos inteligentes de Ontology. La API de contratos inteligentes de Ontology se divide en 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 y <\/li>\n
  7. Static & Dynamic Call API.<\/li>\n<\/ol>\n

    \nBlockchain & Block API es la parte principal del sistema de contratos inteligentes de Ontology. La API de Blockchain admite operaciones b\u00e1sicas de consulta blockchain, como la obtenci\u00f3n de la altura actual del bloque, mientras que la API de Block admite operaciones b\u00e1sicas de consulta de bloques, como la solicitud de la cantidad de transacciones para un bloque dado.<\/p>\n

    \u00a1Vamos a empezar!<\/b><\/p>\n

    Primero, crea un nuevo contrato en SmartX<\/a><\/noindex>, y luego sigue las instrucciones a continuaci\u00f3n.
    \n     <\/a><\/noindex><\/p>\n

    1. C\u00f3mo usar la API de Blockchain<\/h3>\n

    \nLos enlaces a las funciones de los contratos inteligentes son id\u00e9nticos a los enlaces de Python. Puedes introducir las funciones correspondientes seg\u00fan sea necesario. Por ejemplo, la siguiente instrucci\u00f3n introduce GetHeight, la funci\u00f3n para obtener la altura actual del bloque, y GetHeader, la funci\u00f3n para obtener el encabezado del bloque.<\/p>\n

    from ontology.interop.System.Blockchain import GetHeight, GetHeader<\/code><\/pre>\n
    <\/p>\n
    GetHeight<\/h4>\n
    \nGetHeight se utiliza para obtener el \u00faltimo n\u00famero secuencial del bloque en la blockchain, como se muestra en el ejemplo a continuaci\u00f3n. En el \u00faltimo ejemplo, por conveniencia, omitir\u00e9 la funci\u00f3n Main, pero puedes agregarla si es necesario.<\/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 se utiliza para obtener el encabezado del bloque, cuyo par\u00e1metro es el n\u00famero secuencial del bloque en la blockchain. Ejemplo:<\/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 se utiliza para obtener una transacci\u00f3n mediante el hash de la transacci\u00f3n. El hash de la transacci\u00f3n se env\u00eda a GetTransactionByHash <\/i>como par\u00e1metros en formato bytearray. La clave para esta funci\u00f3n es convertir el hash de la transacci\u00f3n en formato hex a un hash de transacci\u00f3n en formato bytearray. Este es un paso importante. De lo contrario, recibir\u00edas un error que indica que no hay bloque con ese hash. Tomemos un hash de transacci\u00f3n en formato hex, por ejemplo, para convertirlo a formato bytearray. El ejemplo es el siguiente:<\/p>\n
    9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1<\/code><\/pre>\n
    \nPrimero, invierte el hash de la transacci\u00f3n:<\/p>\n
    c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279<\/code><\/pre>\n
    \nLos desarrolladores pueden realizar este paso utilizando la herramienta de conversi\u00f3n Hex Number (little endian) que proporciona SmartX.<\/p>\n
    Luego, convierte el resultado obtenido en 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
    \nEsto se puede hacer mediante la herramienta de conversi\u00f3n String Byte Array que ofrece SmartX. Finalmente, convierte el bytearray obtenido en una cadena similar:<\/p>\n
    xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f<\/code><\/pre>\n
    \nA continuaci\u00f3n se muestra un ejemplo de la funci\u00f3n GetTransactionByHash, que obtiene una transacci\u00f3n mediante el hash de la transacci\u00f3n:<\/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 se utiliza para obtener la altura de la transacci\u00f3n mediante el hash de la transacci\u00f3n. Tomemos el hash del ejemplo anterior:<\/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
    \nLos desarrolladores pueden utilizar la funci\u00f3n GetContract para obtener un contrato mediante el hash del contrato. El proceso de conversi\u00f3n del hash del contrato es similar al proceso de conversi\u00f3n del hash de la transacci\u00f3n mencionado anteriormente.<\/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 se utiliza para obtener un bloque. Hay dos formas de obtener un bloque espec\u00edfico.<\/p>\n
    1. Obtener un bloque por la altura del bloque:<\/b><\/p>\n
    from ontology.interop.System.Blockchain import GetBlock\ndef demo():\n    block=GetBlock(1408)\n    return block<\/code><\/pre>\n
    \n2. Obtener un bloque por el hash del bloque:<\/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. C\u00f3mo utilizar la API de Block<\/h3>\n
    \nHay tres funciones disponibles en la API de Block: GetTransactions<\/i>, GetTransactionCount<\/i>como GetTransactionByIndex<\/i>. Las analizaremos una por una.<\/p>\n
    GetTransactionCount<\/h4>\n
    \nGetTransactionCount se utiliza para obtener la cantidad de transacciones para un bloque dado.<\/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
    \nLos desarrolladores pueden utilizar la funci\u00f3n GetTransactions para obtener todas las transacciones en este bloque.<\/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 se utiliza para obtener una transacci\u00f3n espec\u00edfica en este bloque.<\/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) # el \u00edndice comienza desde 0.\n    return tx<\/code><\/pre>\n
    \nLa gu\u00eda completa se puede encontrar en nuestro GitHub<\/a><\/noindex>.<\/p>\n
    P\u00f3scrito<\/h3>\n
    \nLa API de Blockchain & Block es una parte indispensable de los contratos inteligentes, ya que puede utilizarlas para solicitar datos del blockchain y datos de bloques en los contratos inteligentes. En los siguientes art\u00edculos, discutiremos c\u00f3mo usar el resto de las API y c\u00f3mo interact\u00faan con el blockchain de Ontology.<\/p>\n
    El art\u00edculo fue traducido por el equipo de Hashrate&Shares especialmente para OntologyRussia. clic<\/a><\/noindex> <\/p><\/blockquote>\n
     \u00bfEres desarrollador? \u00danete a nuestra comunidad t\u00e9cnica en Discord<\/a><\/noindex>. Adem\u00e1s, echa un vistazo al Centro de Desarrolladores<\/a><\/noindex> en nuestro sitio, all\u00ed puedes encontrar herramientas para desarrolladores, documentaci\u00f3n y mucho m\u00e1s.<\/p>\n
    Ontology<\/h4>\n
    <\/p>\n