10 KiB
| order |
|---|
| 4 |
Обзор дизайна Cosmos SDK
Cosmos SDK - это фреймворк, который облегчает разработку безопасных конечных автоматов поверх движка консенсуса Tendermint. По своей сути, SDK представляет собой реализацию ABCI на языке программирования Go. Он поставляется с хранилищем данных multistore и маршрутизатором для обработки транзакций router.
Далее представлен алгоритм обработки транзакций в приложении на Cosmos SDK при передаче транзакций из Tendermint через DeliverTx:
-
Декодируйте
transactions, полученные от механизма консенсуса Tendermint (помните, что Tendermint работает только с[]bytes). -
Извлеките
messagesизtransactionsи выполните базовые проверки. -
Направьте каждое сообщение в соответствующий модуль для его обработки.
-
Сохраните изменения состояния.
Приложение также позволяет генерировать транзакции, кодировать их и передавать их базовому движку Tendermint для их трансляции.
baseapp
baseApp — это базовая реализация ABCI в Cosmos SDK. Она поставляется с модулем router для маршрутизации транзакций в соответствующий модуль. Файл app.go вашего приложения будет определять ваш тип app, который будет встраивать baseapp. Таким образом, ваш пользовательский тип app будет автоматически наследовать все ABCI-методы baseapp. Пример этого в [туториале по созданию приложения с помощью SDK] (https://github.com/cosmos/sdk-application-tutorial/blob/master/app.go#L27).
Цель baseapp: обеспечить безопасный интерфейс между хранилищем и расширяемым конечным автоматом, в то же время определяя как можно меньше о конечном компьютере (соответствуя ABCI).
УЗнать больше о baseapp можно здесь.
multistore
В составе Cosmos SDK есть хранилище для сохранения состояния. Это хранилище позволяет разработчикам создавать любое количество KVStores. Эти KVStores принимают только [] byte в качестве значения, и поэтому любая пользовательская структура должна быть собрана с помощью go-amin перед сохранением.
Абстракция в виде этого хранилища используется для разделения состояния на отдельные части, каждый из которых управляется своим собственным модулем. Получить больше информации о multistore можно здесь.
Модули
Основное преимуществе Cosmos SDK заключается в его модульности. Приложения SDK создаются путем объединения набора совместимых модулей. Каждый модуль определяет подмножество состояния и содержит свой собственный обработчик сообщений/транзакций, в то время как SDK отвечает за маршрутизацию каждого сообщения в соответствующий модуль.
Вот упрощенное представление о том, как транзакция обрабатывается приложением каждого полной ноды, когда она получена в валидном блоке:
+
|
| Транзакция ретранслируется из движка Tendermint
| полной ноды в приложение ноды через DeliverTx
|
|
|
+---------------------v--------------------------+
| Приложение |
| |
| Используя методы baseapp, декодируй Tx, |
| извлеки сообщение и маршрутизируй его |
| |
+---------------------+--------------------------+
|
|
|
+---------------------------+
|
|
| Сообщение отправлено
| в нужный модуль
| для обработки
|
|
+----------------+ +---------------+ +----------------+ +------v----------+
| | | | | | | |
| AUTH MODULE | | BANK MODULE | | STAKING MODULE | | GOV MODULE |
| | | | | | | |
| | | | | | | Обработай сооб.,|
| | | | | | | обнови состояние|
| | | | | | | |
+----------------+ +---------------+ +----------------+ +------+----------+
|
|
|
|
+--------------------------+
|
| Верни результат в Tendermint
| (0=Ok, 1=Err)
v
Каждый модуль можно рассматривать как самостоятельный конечный автомат. Разработчикам необходимо определить подмножество состояния, обрабатываемого модулем, а также настраиваемые типы сообщений, которые изменяют состояние (следует отметить, что messages извлекаются из transactions с использованием baseapp). В общем, каждый модуль создает свой собственный KVStore в multistore, чтобы сохранить подмножество состояния, которое он определяет. Большинству разработчиков потребуется доступ к другим сторонним модулям при создании своих собственных модулей. Учитывая, что Cosmos-SDK является открытой платформой, некоторые модули могут быть вредоносными, что означает необходимость создания правил безопасности для определения межмодульных взаимодействий. Эти правила основаны на object-capabilities. На практике это означает, что вместо того, чтобы каждый модуль вел список контроля доступа для других модулей, каждый модуль реализует специальные объекты, называемые хранителями, которые могут быть переданы другим модулям для предоставления предварительно определенного набора возможностей.
Модули SDK определены в директории x/ SDK. Основные модули в составе Cosmos SDK:
-
x/auth: используется для управления учетными записями и подписями. -
x/bank: используется для создания и передачи токенов. -
x/stakingиx/slashing: используется для создания блокчейнов Proof-of-Stake.
В дополнение к уже существующим модулям в x/, которые каждый может использовать в своем приложении, SDK позволяет создавать собственные модули.