Как разработать WASM-контракт с помощью Rust в сети Ontology

С тех пор как технология Ontology Wasm была запущена в тестовой сети Ontology (Ontology TestNet), она получила широкое внимание со стороны разработчиков сообщества, поскольку эта технология снижает стоимость переноса контрактов dAPP со сложной бизнес-логикой на блокчейн, тем самым значительно обогащая dApp экосистему.

В настоящее время Ontology Wasm одновременно поддерживает разработку как на языке Rust, так и на языке C++. Язык Rust лучше поддерживает Wasm, а сгенерированный байт-код проще, что может еще больше снизить стоимость контрактных вызовов. Итак, как Вам использовать Rust для разработки контракта в сети Ontology?

Создание контракта

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.

Десериализация является прямой противоположностью. Для каждого метода сериализации есть соответствующий метод десериализации. Десериализация требует использования экземпляров класса Source. Этот экземпляр класса имеет два поля buf и pos. Buf используется для хранения данных, которые будут десериализованы, а pos используется, чтобы хранить текущую позицию считывания. Когда считывается конкретный тип данных, если вы знаете их длину, вы можете считывать их напрямую, для данных неизвестной длины — сначала считайте длину, а затем считайте содержимое.