🥇Kuidas kirjutada nutikontakt WebAssembly-s Ontology võrgus? Osa 1: Rust

Ontology Wasm tehnoloogia alandab dApp'i, millel on keeruline äriloogika, nutilepingute plokiahelasse üleviimise kulusid, rikastades sellega oluliselt dApp ökosüsteemi.

Praegu Ontology Wasm toetab samaaegselt arendust nii Rust'i kui ka C++ keeles. Rust keelt toetab Wasm paremini ja genereeritud baitkood on lihtsam, mis võib veelgi vähendada lepingukutsude kulusid. Nii et kuidas kasutada Rust'i lepingute arendamiseks Ontology võrgus?

WASM lepingute arendamine Rust'i abil

Lepingu loomine

Cargo on hea projektide loomise ja pakettide haldamise tööriist Rust'i programmide arendamiseks, mis aitab arendajatel paremini korraldada koodi ja väliste raamatukogude koostööd. Uue Ontology Wasm lepingu loomiseks lihtsalt käivitage järgmine käsk:

Projektistruktuur, mille see genereerib:

Fail Cargo.toml kasutatakse projekti põhiteabe ja sõltuva raamatukogu teabe seadistamiseks. Sektsioon [lib] failis peab olema seadistatud väärtuseks crate-type = ["cdylib"]. Fail lib.rs kasutatakse lepinguloogika koodi kirjutamiseks. Lisaks peate lisama sõltuvuste parameetrid konfiguratsiooni failis Cargo.toml sektsioonis [dependencies]:

Selle sõltuvuse abil saavad arendajad kutsuda välja liideseid, mis suhtlevad Ontology plokiahelaga, ja tööriistu, nagu näiteks serialiseerimise parameeter.

Lepingu sisendfunktsioon

Igal programmil on sisendfunktsioon, nagu näiteks main-funktsioon, mida me tavaliselt näeme, kuid lepingul ei ole main-funktsiooni. Kui Rust'iga arendatakse Wasm-lepingut, kasutatakse vaikimisi sisendfunktsioonina invoke-funktsiooni, et lepingut kasutada. Funktsiooni nimi Rust'is ei ole kompileerimisel selge, kui Rust'i lähtekood muudetakse baitkoodiks, mida saab täita virtuaalne masin. Et hoida kompilator ära genereerimast liialdavat koodi ja vähendada lepingu suurust, lisab invoke-funktsioon annotatsiooni #[no_mangle].

Kuidas invoke-funktsioon saab parameetreid tehingu läbiviimiseks?

ontio_std raamatukogu pakub funktsiooni runtime::input(), et saada tehingu täitmiseks vajalikud parameetrid. Arendajad saavad kasutada ZeroCopySource'i saadud baitide massiivi deserialiseerimiseks. Esimene loetud baitide massiiv on invoke-meetodi nimi, järgnev on meetodi parameetrid.

Kuidas tagastatakse lepingutäidise tulemus?

Funktsioon runtime::ret, mida pakub ontio_std raamatukogu, tagastab meetodi täitmise tulemuse.

Lõpetatud invoke-funktsioon näeb välja järgnev:

Lepingu andmete serialiseerimine ja deserialiseerimine

Lepingute arendamise protsessis seisavad arendajad alati silmitsi serialiseerimise ja deserialiseerimise probleemidega, nimelt sellega, kuidas salvestada struktuuri andme tüüpi andmed andmebaasi ja kuidas massiiv, mis loetakse andmebaasist, deserialiseerida, et saada struktuuri andme tüüpi andmed.

ontio_std raamatukogu pakub dekooderi ja kodeerija liideseid andmete serialiseerimiseks ja deserialiseerimiseks. Struktuuri struktuuri väljad rakendavad samuti dekooderi ja kodeerija liideseid, et struktuur saaks olla serialiseeritud ja deserialiseeritud. Sink klassi eksemplarid on vajalikud erinevate andmete tüüpide serialiseerimisel. Sink klassi eksemplaril on set tüüpi väli buf, mis salvestab bait tüüpi andmed, ja kõik serialiseeritud andmed salvestatakse buf-i.

Fikseeritud pikkusega andmete puhul (näiteks: byte, u16, u32, u64 jne) muudetakse andmed otse baitide massiiviks ja salvestatakse then buf-i; fikseerimata pikkusega andmete puhul tuleb esmalt serialiseerida pikkus ja seejärel Ddata (näiteks mitte teada pikkusega tervete arvude, sealhulgas u16, u32 või u64 jne).

Deserialiseerimine on otse vastupidine. Iga serialiseerimise meetodi jaoks on vastav deserialiseerimise meetod. Deserialiseerimine nõuab Source klassi eksemplaride kasutamist. See klassi eksemplar sisaldab kahte välja: buf ja pos. Buf'i kasutatakse andmete salvestamiseks, mis deserialiseeritakse, ja pos hoiab arvestatavat lugemispositsiooni. Kui loetakse spetsiifilist andme tüüpi, siis kui teate nende pikkust, saate neid otse lugeda; teadmata pikkusega andmete puhul looge esmalt pikkus, seejärel looge sisu.

Andmete juurde pääsemine ja nende uuendamine plokiks

Ontology-wasm-cdt-rust — kapseldas operatsioonimeetodi andmete käsitlemiseks plokis, mis on arendajatele mugav, et teostada operatsioone nagu andmete lisamine, kustutamine, muutmine ja päringud plokis järgmiselt:

database::get(key) — kasutatakse andmete pärimiseks plokist, kus key küsib AsRef liidese rakendust;
database::put(key, value) — kasutatakse andmete salvestamiseks plokki. Key küsib AsRef liidese täitmist ning value küsib Encoder liidese rakendust;
database::delete(key) — kasutatakse andmete kustutamiseks plokist, kus key küsib AsRef liidese rakendust.

Lepingu testimine

Kui lepingute meetodid on rakendatud, on meil vajalik juurdepääs andmetele plokis ja vajame vastavat virtuaalmasinat lepingute bytecode'i täitmiseks, seega on tavaliselt vajalik lepingu rakendamine plokis testimiseks. Kuid see testimismeetod on problemaatiline. Selleks, et arendajate jaoks oleks lepingute testimine lihtsam, pakub ontio_std raamatukogu mock-moduuli testimiseks. See modul simuleerib andmeid plokis, muutes arendajatele lepingus meetodite üksuste testimise lihtsamaks. Konkreetseid näiteid võib leida siin.

Lepingu silumine

console::debug(msg) väljastab silumisinfot lepingu silumise ajal. Teave msg salvestatakse sõlme logifaili. Tingimuseks on logifaili taseme seadmine silumismoodulisse, kui Ontology kohaliku test-sõlme käitatakse.

runtime::notify(msg) väljastab vastava silumisinfo lepingu silumisel. See meetod salvestab edastatud teabe plokki ja seda saab plokist küsida meetodi getSmartCodeEvent abil.

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

Oled sa arendaja? Liitu meie tehnilise kogukonnaga Discord. Samuti vaata Arendajate keskus meie veebisaidil, seal leiad arendaja tööriistad, dokumentatsiooni ja palju muud.