ProHoster > Blog > Administración > Como escribir un contrato intelixente en Python na rede Ontology. Parte 1: Blockchain e Block API
Como escribir un contrato intelixente en Python na rede Ontology. Parte 1: Blockchain e Block API
Esta é a primeira parte dunha serie de tutoriais sobre a creación de contratos intelixentes de Python na rede blockchain de Ontology mediante a ferramenta de desenvolvemento de contratos intelixentes. SmartX.
Neste artigo, comezaremos a coñecer a API do contrato intelixente de Ontology. A API do contrato intelixente de Ontology divídese en 7 módulos:
Blockchain e Block API,
API de execución,
API de almacenamento,
API nativa,
Actualizar API,
API do motor de execución e
API de chamada estática e dinámica.
Blockchain & Block API é a parte principal do sistema de contrato intelixente de Ontology. A API Blockchain admite operacións básicas de consulta de blockchain, como obter a altura actual do bloque, mentres que a API Block admite operacións básicas de consulta de bloques, como consultar o número de transaccións para un determinado bloque.
Imos comezar!
En primeiro lugar, crea un novo contrato SmartXe despois siga as instrucións a continuación.
1. Como usar a API Blockchain
As ligazóns ás funcións de contrato intelixente son idénticas ás ligazóns de Python. Pode introducir as funcións correspondentes segundo sexa necesario. Por exemplo, a seguinte instrución introduce unha función GetHeight para obter a altura actual do bloque e unha función GetHeader para obter a cabeceira do bloque.
from ontology.interop.System.Blockchain import GetHeight, GetHeader
GetHeight
GetHeight úsase para obter o último número de secuencia de bloques na cadea de bloques, como se mostra no seguinte exemplo. No último exemplo, omitiremos a función Principal por comodidade, pero podes engadila se é necesario.
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 úsase para obter a cabeceira do bloque, o parámetro é o número de serie do bloque na cadea de bloques. Exemplo:
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 úsase para obter unha transacción mediante un hash de transacción. O hash da transacción envíase a GetTransactionByHash como parámetros en formato bytearray. A clave desta función é converter o hash da transacción en formato hexadecimal ao hash da transacción en formato bytearray. Este é un paso importante. En caso contrario, obtería un erro que indica que non hai ningún bloque con ese hash de bloque. Tomemos o hash de transacción en formato hexadecimal como exemplo para convertelo a formato bytearray. Un exemplo é así:
Isto pódese facer usando a ferramenta de conversión String Byte Array proporcionada por SmartX. Finalmente, converte a matriz de bytes resultante nunha cadea similar:
Os desenvolvedores poden usar a función GetContract para obter un contrato a través do hash do contrato. O proceso de conversión de hash de contrato é o mesmo que o proceso de conversión de hash de transacción mencionado anteriormente.
GetBlock úsase para obter un bloque. Hai dúas formas de obter un bloque específico.
1. Obtén a altura de bloque por bloque:
from ontology.interop.System.Blockchain import GetBlock
def demo():
block=GetBlock(1408)
return block
2. Obtén un hash bloque por bloque:
from ontology.interop.System.Blockchain import GetBlock
def demo():
block_hash=bytearray(b'x16xe0xc5x40x82x79x77x30x44xeax66xc8xc4x5dx17xf7x17x73x92x33x6dx54xe3x48x46x0bxc3x2fxe2x15x03xe4')
block=GetBlock(block_hash)
2. Como usar Block API
Hai tres funcións dispoñibles na API Block: GetTransactions, GetTransactionCountE GetTransactionByIndex. Irémolos desglosando un por un.
GetTransactionCount
GetTransactionCount úsase para obter o número de transaccións para un determinado bloque.
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
Os desenvolvedores poden usar a función GetTransactions para obter todas as transaccións nun bloque determinado.
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 úsase para obter unha transacción específica nun bloque determinado.
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
Pódese atopar unha guía completa na nosa web GitHub.
Posterior
A API de Blockchain & Block é unha parte indispensable dos contratos intelixentes, xa que pode usalos para solicitar datos de blockchain e bloquear datos en contratos intelixentes. Nos seguintes artigos, discutiremos como usar o resto das API e descubrir como interactúan coa cadea de bloques de Ontology.
O artigo foi traducido polos editores de Hashrate&Shares especialmente para OntologyRussia. chorar
Vostede é un programador? Únete á nosa comunidade tecnolóxica en Discordia. Ademais, bótalle un ollo Centro de Desenvolvedores no noso sitio web, onde podes atopar ferramentas para desenvolvedores, documentación e moito máis.