🥇Как да напишете смарт контракт на 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, и инструменти като параметъра за сериализация.

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

Всяка програма има функция за вход, каквато е основната функция, която обикновено виждаме, но контрактът няма основна функция. Когато се разработва 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 има поле buf от тип set, което съдържа байтови данни, а всички сериализирани данни се съхраняват в buf.

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

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

Достъп и актуализация на данни в блокчейна

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

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

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

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

Отстраняване на грешки в контракта

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

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

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

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

Ontology

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