Kuidas kirjutada nutilepingut Pythonis Ontology võrgus. Osa 2: Storage API

See on teise osa artiklisarjast, mis käsitleb nutikaleppe loomist Pythonis Ontology plokiahelas. Eelmises artiklis tutvusime Blockchain & Block API Ontology nutilepinguga.

Täna arutame, kuidas kasutada teist moodulit— Storage API. Storage API-l on viis omavahel seotud API-d, mis võimaldavad andmete lisamist, kustutamist ja muutmist nutilepingute jääkväljade puhul plokiahelas.

Allpool on lühikirjeldus nendest viiest API-st:

Vaatame lähemalt, kuidas neid viit API-d kasutataks.

0. Loo uus leping SmartX

1. Kuidas kasutada Storage API-d

GetContext & GetReadOnlyContext

GetContext ja GetReadOnlyContext saavad konteksti, milles praegune nutileping toimub. Tagastusväärtus on nutilepingu praeguse hash'i vastand. Nagu nimi viitab, GetReadOnlyContext võtab konteksti ainult lugemise režiimis. Allpool toodud näites on tagastusväärtus vastand lepingule, mis kuvatakse paremas ülanurgas.

Put

Function Put vastutab andmete salvestamise eest plokiahelas sõnastiku kujul. Nagu näha, Put võtab see kolm parameetrit. GetContext saab konteksti praegu teostatud nutilepingust, key— see on võtme väärtus, mida on vaja andmete salvestamiseks, ja value— see on andmete väärtus, mida tuleb salvestada. Pange tähele, et kui võtme väärtus on juba salvestuses olemas, siis funktsioon värskendab vastavat väärtust.

hashrate-and-shares.ru/images/obzorontology/python/functionput.png

Get

Function Get vastutab andmete lugemise eest praeguses plokiahelas võtme väärtuse kaudu. Allpool olevas näites võite täita võtme väärtust paremal olnud parameetrite paneelis, et täita funktsiooni ja lugeda andmeid, mis vastavad võtme väärtusele plokiahelas.

Delete

Function Delete vastutab andmete kustutamise eest plokiahelas võtme väärtuse kaudu. Allpool olevas näites võite täita võtme väärtust paremal olnud parameetrite paneelis, et täita funktsiooni ja kustutada andmeid, mis vastavad võtme väärtusele plokiahelas.

2. Storage API koodinäide

Allpool olev kood annab üksikasjaliku näite nende viie API kasutamisest: GetContext, Get, Put, Delete ja GetReadOnlyContext. Saate proovida kasutada neid API-sid SmartX.

from ontology.interop.System.Storage import GetContext, Get, Put, Delete, GetReadOnlyContext
from ontology.interop.System.Runtime import Notify

def Main(operation,args):
    if operation == 'get_sc':
        return get_sc()
    if operation == 'get_read_only_sc':
        return get_read_only_sc()
    if operation == 'get_data':
        key=args[0]
        return get_data(key)
    if operation == 'save_data':
        key=args[0]
        value=args[1]
        return save_data(key, value)
    if operation == 'delete_data':
        key=args[0]
        return delete_data(key)
    return False

def get_sc():
    return GetContext()
    
def get_read_only_sc():
    return GetReadOnlyContext()

def get_data(key):
    sc=GetContext() 
    data=Get(sc,key)
    return data
    
def save_data(key, value):
    sc=GetContext() 
    Put(sc,key,value)
    
def delete_data(key):
    sc=GetContext() 
    Delete(sc,key)

Järelsõna

Plokiahela salvestus on kogu plokiahelasüsteemi tuumik. Ontology Storage API on lihtne kasutada ja arendajatele mugav.

Teiselt poolt, ründavad kurjategijad sageli salvestust, näiteks turvaoht, millest rääkisime ühes eelnevas artiklis— storage injection attack, seega peavad arendajad pöörama erilist tähelepanu turvalisusele, kirjutades koodi, mis on seotud salvestusega. Täielikku juhendit leiate meie GitHub siit.

Järgmises artiklis arutame, kuidas kasutada Runtime API.

Artikkel on tõlgitud Hashrate&Shares toimetuse poolt spetsiaalselt OntologyRussia jaoks. klik

Kas oled arendaja? Liitu meie tehnilise kogukonnaga Discord. Lisaks vaadake Arendajate keskus Ontology, kus leiate rohkem tööriistu, dokumentatsiooni ja palju muud.

Avatud arendustööd. Sulge ülesanne — saa tasu.

Kandideeri Ontology Talent Programmi ridadesse üliõpilastele

Ontology

Ontology veebisait — GitHub — Discord — Telegrami venekeelne grupp — Twitter — Reddit

Allikas: habr.com