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

Ontology Wasm tehnoloogia vähendab dApp i keerukate äriloogikaga nutilepingute blockchain'i üleviimise kulusid, rikastades seeläbi oluliselt dApp ekosüsteemi.

Praegu Ontology Wasm toetab samaaegselt nii Rusti kui ka C++ programmeerimise. Rust toetab Wasm'i paremini, ja genereeritud baitkood on lihtsam, mis võib veelgi vähendada lepingute kutsumise kulusid. Seega, kuidas kasutada Rusti Ontology võrgus lepingute arendamiseks?

WASM lepingute arendamine Rusti abil

Lepingu loomine

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

Selle genereeritud projekti struktuur:

Fail Cargo.toml kasutatakse projekti põhiinfo ja sõltuvuste teekide info seadistamiseks. Faili osa [lib] peab olema seatud väärtusele crate-type = ["cdylib"]. Fail lib.rs kasutatakse lepingu loogika koodi kirjutamiseks. Lisaks peate lisama sõltuvuste parameetrid Cargo.toml konfigureerimise faili sektsiooni [dependencies]:

Selle sõltuvuse abil saavad arendajad kutsuda liideseid, mis suhtlevad Ontology blockchain'iga, ja tööriistu, nagu serialiseerimise parameeter.

Lepingu sisenemismeetod

Igal programmil on sisenemismeetod, nagu näiteks main-meetod, mida me tavaliselt näeme, kuid lepingul ei ole main-meetodit. Kui arendatakse Wasm-lepingut Rusti abil, siis kasutatakse vaikimisi sisenemismeetodina invoke meetodit. Rustis on meetodi nimi kompilatsiooni ajal ebaselge, kui Rusti lähtekood muudetakse baitkoodiks, mida võib täita virtuaalmasin. Kompilaatori ülemäärase koodi genereerimise vältimiseks ja lepingu suuruse vähendamiseks lisab invoke meetod annotatsiooni #[no_mangle].

Kuidas invoke meetod saab tehingu täitmiseks parameetreid?

Raamatukogu ontio_std pakub funktsiooni runtime::input () parameetrite saamiseks tehingu täitmiseks. Arendajad saavad kasutada ZeroCopySource'i saadud baitmassivi deserialiseerimiseks. Esimene loetud baitmass on invoke-meetodi nimi, seejärel meetodi parameetrid.

Kuidas tagastatakse lepingu täitmise tulemus?

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

Valmis invoke funktsioon näeb välja järgmiselt:

Lepingu andmete serialiseerimine ja deserialiseerimine

Lepingute arendusprotsessis seisavad arendajad pidevalt silmitsi serialiseerimise ja deserialiseerimise probleemidega, eriti kuidas salvestada struct-tüüpi andmed andmebaasi ja kuidas deserialiseerida andmebaasist loetud baitmass, et saada struct-tüüpi andmed.

Raamatukogu ontio_std pakub dekooderite ja kooderite liideseid andmete serialiseerimiseks ja deserialiseerimiseks. Struct-i väljad rakendavad samuti dekooderite ja kooderite liideseid, nii et struktuuri saab serialiseerida ja deserialiseerida. Erinevate andmetüüpide serialiseerimiseks on vajalik Sink klassi eksemplar. Sink klassi eksemplaris on set- tüüpi väli buf, mis salvestab baittüüpi andmed, ja kõik serialiseeritud andmed salvestatakse buf-i.

Fikseeritud pikkusega andmete puhul (näiteks: byte, u16, u32, u64 jne) andmed konverteeritakse otse baitmassiks ja seejärel salvestatakse buf-i; fikseerimata pikkusega andmete puhul peab kõigepealt serialiseerima pikkuse ja seejärel andmed (näiteks teadmata suurusega positiivsed täisarvud, sealhulgas u16, u32 või u64 jne).

Deserialiseerimine on otsene vastand. Iga serialiseerimise meetodi jaoks on vastav deserialiseerimise meetod. Deserialiseerimisprotsessis on vajalik Source klassi eksemplar. Sellel eksemplaril on kaks väljad buf ja pos. Buf kasutatakse andmete hoidmiseks, mis tulevad deserialiseerimisele, ning pos kasutatakse hetke lugemise positsiooni hoidmiseks. Kui loetakse konkreetset andmetüüpi, siis kui tead nende pikkust, võid neid lugeda otse; teadmata pikkusega andmete puhul – kõigepealt loe pikkus, ja seejärel sisu.

Andmete ligipääs ja värskendamine plokiahelas

Ontology-wasm-cdt-rust on kapseldanud operatiivmeetodi andmete töötlemiseks plokiahelas, mis on arendajatele mugav andmete lisamise, kustutamise, muutmise ja pärimise toimingute teostamiseks järgmiste viisil:

database::get(key) kasutatakse andmete pärimiseks plokiahelast, kus key küsib AsRef liidese rakendust.
database::put(key, value) — kasutatakse andmete salvestamiseks võrgus. Key küsib AsRef liidese täitmist ja value küsib Encoder liidese rakendust;
database::delete(key) — kasutatakse andmete eemaldamiseks ahelast, samas kui key küsib AsRef liidese rakendust.

Lepingu testimine

Lepingu meetodite rakendamisel on meil juurdepääs andmetele ahelas ja meil on vajalik vastav virtuaalne masin, et täita lepingu lähtekoodi. Seetõttu on lepingute testimiseks tavaliselt vajalik lepingu juurutamine ahelas. Kuid selline testimise meetod on probleemne. Arendajate testimise lihtsustamiseks pakub raamatukogu ontio_std mock-moodulit testimiseks. See moodul simuleerib ahelas andmeid, muutes arendajatele lepingu meetodite üksustestimise lihtsamaks. Konkreetseid näiteid võib leida siit.

Lepingu tõrkeotsing

console::debug(msg) väljastab tõrkeotsingu teavet lepingu tõrkeotsingu ajal. Teave msg salvestatakse sõlme logifaili. Kohustuslik tingimus on logifaili taseme seadmine tõrkeotsingu režiimi, kui on käivitatud kohaliku test-sõlme Ontology.

runtime::notify(msg) väljastab vastava tõrkeotsingu teabe lepingu tõrkeotsingu ajal. See meetod salvestab edastatud teabe ahelas ja seda saab küsida ahelast meetodi getSmartCodeEvent abil.

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

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