Как да напиша интелигентен договор на WebAssembly в мрежата Ontology? Част 1: Ръжда

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

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

Разработване на WASM договор с Rust

Създайте договор

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

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

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

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

Функция за въвеждане на договор

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

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

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

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

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

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

Сериализиране и десериализиране на договорни данни

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

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

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

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

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

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

• база данни::get(ключ) - използва се за изискване на данни от веригата, а ключът изисква изпълнението на интерфейса AsRef;
• база данни::put(ключ, стойност) - използва се за съхраняване на данни в мрежата. Key изисква имплементирането на интерфейса AsRef, а value изисква имплементирането на интерфейса Encoder;
• база данни::изтриване(ключ) - използва се за премахване на данни от веригата, а ключът изисква изпълнението на интерфейса AsRef.

Тестване на договора

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

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

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

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

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

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

Онтология

• Онтологичен уебсайт
• GitHub / раздор
• Telegram Английски / Руски
• Twitter / Reddit

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