🥇Как да напишем смарт контракт на WebAssembly в мрежата Ontology? Част 1: Rust

Технология Ontology Wasm намалява разходите за прехвърляне на смарт контракти dApp със сложна бизнес логика в блокчейн, значително обогатявайки екосистемата на dApp.

Настоящият момент Ontology Wasm поддържа одновременно разработката на Rust и C++. Rust предлага по-добра поддръжка за Wasm, а генерираният байт-код е по-прост, което може допълнително да намали разходите за извикване на контракти. И така, как да използваме Rust за разработка на контракт в мрежата Ontology?

Разработка на Wasm-контракт с помощта на Rust

Създаване на контракт

Cargo — е добър инструмент за управление на проекти и пакети при разработка на софтуер на Rust, който помага на разработчиците да организират взаимодействието между кода и външните библиотеки. За да създадете нов Ontology Wasm-контракт, просто изпълнете следната команда:

Структурата на проекта, която тя генерира:

Файлът Cargo.toml се използва за конфигуриране на основна информация за проекта и информация за зависимите библиотеки. Секцията [lib] в файла трябва да бъде зададена на crate-type = ["cdylib"]. Файлът lib.rs се използва за писане на логиката на контракта. Освен това, трябва да добавите параметри за зависимости в секцията [dependencies] на конфигурационния файл Cargo.toml:

С тази зависимост разработчиците могат да извикват интерфейси, взаимодействащи с блокчейна Ontology, и инструменти като параметъра за сериализация.

Функция за вход на контракта

Всяка програма има функция за вход, подобна на main-функцията, но контрактът няма main-функция. Когато се разработва Wasm-контракт с Rust, функцията invoke по подразбиране се използва като функция за вход за използване на контракта. Името на функцията в Rust ще бъде неопределено при компилиране на изходния код на Rust в байт-код, който може да се изпълнява от виртуалната машина. За да се предотврати генерирането на излишен код и да се намали размерът на контракта, функцията invoke добавя анотация #[no_mangle].

Как функцията invoke получава параметри за изпълнение на транзакцията?

Библиотеката ontio_std предоставя функция runtime::input(), за да получи параметри за изпълнение на транзакция. Разработчиците могат да използват ZeroCopySource за десериализиране на получен масив от байтове. Първият прочетен масив от байтове е името на invoke метода, а след това параметрите на метода.

Как се връща резултатът от изпълнението на контракта?

Функцията runtime::ret, предоставена от библиотеката ontio_std, връща резултата от изпълнението на метода.

Завършената invoke функция изглежда по следния начин:

Сериализация и десериализация на данни от контракта

В процеса на разработка на контракти, разработчиците винаги се сблъскват с проблеми свързани със сериализацията и десериализацията, особено как да запазят struct тип данни в базата данни и как да десериализират масив от байтове, прочетен от базата данни, за да получат struct тип данни.

Библиотеката ontio_std предоставя интерфейси на декодер и кодер за сериализация и десериализация на данни. Полетата на структурата struct също реализират интерфейси на декодер и кодер, така че структурата може да бъде сериализирана и десериализирана. Инстанциите на класа Sink са необходими, когато сериализирате различни типове данни. Инстанцията на класа Sink има поле от тип set buf, което съхранява байтовите данни, а всички сериализирани данни се съхраняват в buf.

За данни с фиксирана дължина (например: byte, u16, u32, u64 и т.н.) данните се преобразуват директно в масив от байтове и след това се съхраняват в buf; за данни с нестандартна дължина, първо трябва да се сериализира дължината, а след това дани (например, беззнакови цели числа с неизвестен размер, включително u16, u32 или u64 и т.н.).

Десериализацията е противоположността на сериализацията. За всеки метод на сериализация има съответстващ метод на десериализация. Десериализацията изисква използването на инстанции на класа Source. Тази инстанция има две полета buf и pos. Buf се използва за съхранение на данни, които ще бъдат десериализирани, а pos се използва, за да съхранява текущата позиция на четене. Когато се чете конкретен тип данни, ако знаете дължината им, можете да ги прочетете директно, за данни с неизвестна дължина — първо прочетете дължината, а след това съдържанието.

Достъп и актуализиране на данни в веригата

Ontology-wasm-cdt-rust — инкапсулира операционния метод за работа с данни в мрежата, който е удобен за разработчиците да реализират операции като добавяне, изтриване, промяна и запитване на данни в мрежата по следния начин:

database::get(key) — използва се за запитване на данни от мрежата, а ключът запитва реализирането на интерфейса AsRef;
database::put(key, value) — използва се за съхраняване на данни в мрежата. Ключът запитва изпълнението на интерфейса AsRef, а стойността запитва реализирането на интерфейса Encoder;
database::delete(key) — използва се за изтриване на данни от мрежата, а ключът запитва реализирането на интерфейса AsRef.

Тестване на контракта

Когато се реализират методи на контракта, имаме нужда от достъп до данни в мрежата и ни трябва съответната виртуална машина, за да изпълним байткода на контракта, затова обикновено е необходимо да развернем контракта в мрежата за тестване. Но такъв метод на тестване е проблематичен. За да улесним разработчиците при тестването на контрактите, библиотеката ontio_std предоставя mock-модул за тестване. Този модул осигурява симулация на данни в мрежата, улеснявайки разработчиците в юнит-тестирането на методите на контракта. Конкретни примери могат да бъдат намерени тук.

Дебъгване на контракта

console::debug(msg) изкарва информация за дебъгване по време на дебъгването на контракта. Информацията msg ще бъде записана в лог-файла на нодата. Задължително условие е да е зададено нивото на лог-файла в режим на дебъгване, когато е стартирана локалната тестова нода Ontology.

runtime::notify(msg) изкарва съответната информация за дебъгване по време на дебъгването на контракта. Този метод ще запази внесената информация в мрежата и може да бъде запитван от мрежата с помощта на метода getSmartCodeEvent.

Статията беше преведена от редакцията на Hashrate&Shares специално за OntologyRussia. клик

Вие ли сте разработчик? Присъединете се към нашата техническа общност на Discord. Освен това, погледнете в Център за разработчици на нашия сайт, там можете да намерите инструменти за разработчици, документация и много друго.

Ontology

Източник: habr.com