온톨로지 네트워크에서 파이썬으로 스마트 계약을 작성하는 방법. 1부: 블록체인 및 블록 API

이것은 스마트 계약 개발 도구를 사용하여 온톨로지 블록체인 네트워크에서 Python 스마트 계약을 생성하는 방법에 대한 자습서 시리즈의 첫 번째 부분입니다. SmartX.

이 기사에서는 온톨로지 스마트 계약 API에 대해 알아볼 것입니다. Ontology 스마트 계약 API는 7개의 모듈로 나뉩니다.

1. 블록체인 및 블록 API,
2. 런타임 API,
3. 스토리지 API,
4. 네이티브 API,
5. 업그레이드 API,
6. 실행 엔진 API 및
7. 정적 및 동적 호출 API.

블록체인 및 블록 API는 온톨로지 스마트 계약 시스템의 주요 부분입니다. Blockchain API는 현재 블록 높이 가져오기와 같은 기본 블록체인 쿼리 작업을 지원하는 반면, Block API는 주어진 블록에 대한 트랜잭션 수 쿼리와 같은 기본 블록 쿼리 작업을 지원합니다.

시작하자!

먼저 새 계약서를 작성합니다. SmartX그런 다음 아래 지침을 따르십시오.

1. 블록체인 API 사용 방법

스마트 계약 기능에 대한 링크는 Python 링크와 동일합니다. 필요에 따라 해당 기능을 입력할 수 있습니다. 예를 들어 다음 문은 현재 블록 높이를 가져오는 GetHeight 함수와 블록 헤더를 가져오는 GetHeader 함수를 소개합니다.

from ontology.interop.System.Blockchain import GetHeight, GetHeader

GetHeight

GetHeight는 아래 예와 같이 블록체인의 마지막 블록 시퀀스 번호를 가져오는 데 사용됩니다. 마지막 예제에서는 편의를 위해 Main 함수를 생략하지만 필요에 따라 추가할 수 있습니다.

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는 블록 헤더를 가져오는 데 사용되며 매개변수는 블록체인에 있는 블록의 일련 번호입니다. 예:

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는 트랜잭션 해시를 통해 트랜잭션을 가져오는 데 사용됩니다. 트랜잭션 해시는 다음 주소로 전송됩니다. GetTransactionByHash bytearray 형식의 매개변수로. 이 함수의 핵심은 hex 형식의 트랜잭션 해시를 bytearray 형식의 트랜잭션 해시로 변환하는 것입니다. 이것은 중요한 단계입니다. 그렇지 않으면 해당 블록 해시가 있는 블록이 없음을 나타내는 오류가 발생합니다. bytearray 형식으로 변환하는 예로 XNUMX진수 형식의 트랜잭션 해시를 살펴보겠습니다. 예를 들면 다음과 같습니다.

9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1

먼저 트랜잭션 해시를 뒤집습니다.

c1890c4d730626dfaa9449419d662505eab3bda2e1f01f89463cc1a4a30a279

개발자는 SmartX에서 제공하는 Hex Number(little endian)Number 변환 도구를 사용하여 이 단계를 수행할 수 있습니다.

그런 다음 결과를 bytearray 형식으로 변환합니다.

{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}

이것은 SmartX에서 제공하는 String Byte Array 변환 도구를 사용하여 수행할 수 있습니다. 마지막으로 결과 bytearray를 유사한 문자열로 변환합니다.

xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f

다음은 트랜잭션의 해시를 사용하여 트랜잭션을 가져오는 GetTransactionByHash 함수의 예입니다.

from ontology.interop.System.Blockchain import GetTransactionByHash
def demo():
    # tx_hash="9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1"    
    tx_hash=bytearray(b"xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f")
    tx=GetTransactionByHash(tx_hash)
    return tx

GetTransactionHeight

GetTransactionHeight는 트랜잭션 해시를 통해 트랜잭션 높이를 가져오는 데 사용됩니다. 위의 예에서 해시를 살펴보겠습니다.

from ontology.interop.System.Blockchain import  GetTransactionHeight
def demo():
    #   tx_hash="9f270aa3a4c13c46891ff0e1a2bdb3ea0525669d414994aadf2606734d0c89c1"    
    tx_hash=bytearray(b"xc1x89x0cx4dx73x06x26xdfxaax94x49x41x9dx66x25x05xeaxb3xbdxa2xe1xf0x1fx89x46x3cxc1xa4xa3x0ax27x9f")
    height=GetTransactionHeight(tx_hash)
    return height

계약 받기

개발자는 GetContract 기능을 사용하여 계약의 해시를 통해 계약을 가져올 수 있습니다. 계약 해시 변환 프로세스는 위에서 언급한 트랜잭션 해시 변환 프로세스와 동일합니다.

from ontology.interop.System.Blockchain import GetContract
def demo():
    # contract_hash="d81a75a5ff9b95effa91239ff0bb3232219698fa"    
    contract_hash=bytearray(b"xfax98x96x21x32x32xbbxf0x9fx23x91xfaxefx95x9bxffxa5x75x1axd8")
    contract=GetContract(contract_hash)
    return contract

GetBlock

GetBlock은 블록을 가져오는 데 사용됩니다. 특정 블록을 얻는 방법에는 두 가지가 있습니다.

1. 블록 높이로 블록 가져오기:

from ontology.interop.System.Blockchain import GetBlock
def demo():
    block=GetBlock(1408)
    return block

2. 블록 해시로 블록을 얻습니다.

from ontology.interop.System.Blockchain import GetBlock
def demo():    
    block_hash=bytearray(b'x16xe0xc5x40x82x79x77x30x44xeax66xc8xc4x5dx17xf7x17x73x92x33x6dx54xe3x48x46x0bxc3x2fxe2x15x03xe4')
    block=GetBlock(block_hash)

2. 블록 API 사용 방법

Block API에는 세 가지 기능이 있습니다. 거래 가져오기, GetTransactionCount과 GetTransactionByIndex. 우리는 그것들을 하나씩 분해할 것입니다.

GetTransactionCount

GetTransactionCount는 주어진 블록에 대한 트랜잭션 수를 가져오는 데 사용됩니다.

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 기능을 사용하여 주어진 블록의 모든 트랜잭션을 가져올 수 있습니다.

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는 주어진 블록에서 특정 트랜잭션을 가져오는 데 사용됩니다.

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

전체 가이드는 당사에서 찾을 수 있습니다. GitHub의.

사후

블록체인 및 블록 API는 블록체인 데이터를 요청하고 스마트 계약에서 데이터를 차단하는 데 사용할 수 있으므로 스마트 계약의 필수적인 부분입니다. 향후 기사에서는 나머지 API를 사용하는 방법과 이들이 온톨로지 블록체인과 상호 작용하는 방법에 대해 논의할 것입니다.

이 기사는 특히 OntologyRussia를 위해 Hashrate&Shares 편집자가 번역했습니다. 클릭

당신은 개발자입니까? 기술 커뮤니티에 가입하세요. 디스코드. 또한 살펴보십시오. 개발자 센터 개발자 도구, 설명서 등을 찾을 수 있는 웹 사이트에서.

온톨로지

• 온톨로지 웹사이트
• GitHub의 / 디스코드
• 텔레그램 영어 / 러시아인
• 트위터 / 레딧

출처 : habr.com