epic(nibiru-std): proto module with tests + scripts

Squashed commit of:

commit b57e6f4
Author: Unique-Divine <[email protected]>
Date:   Sat Sep 30 12:11:34 2023 -0500

    chore: run tidy and update Cargo.lock

commit eb5669d
Author: Unique-Divine <[email protected]>
Date:   Sat Sep 30 11:33:49 2023 -0500

    refactor(nibi-dev): return BashCommandOutput since it's less verbose

commit 26191a6
Author: Unique-Divine <[email protected]>
Date:   Sat Sep 30 10:43:44 2023 -0500

    test(wasm.rs): Verify that protobuf messages encode properly as stargate msgs

contracts/bindings-perp/src/contract.rs

@@ -267,7 +267,7 @@ pub mod tests {
  testing::{self, mock_env, MockApi, MockQuerier},
  Coin, CosmosMsg, Decimal, MemoryStorage, OwnedDeps, SubMsg, Uint128,
  };
- use nibiru_std::bindings::route::NibiruRoute;
+ use nibiru_std::bindings::msg::NibiruRoute;
 
  use crate::msg;
  use crate::state;

contracts/bindings-perp/src/msg.rs

@@ -5,8 +5,8 @@ use cosmwasm_std::{
 };
 
 use nibiru_macro::cw_custom;
+use nibiru_std::bindings::msg::NibiruRoute;
 use nibiru_std::bindings::query as bindings_query;
-use nibiru_std::bindings::route::NibiruRoute;
 
 use crate::state::Sudoers;
 

contracts/controller/src/contract.rs

@@ -4,7 +4,7 @@ use cosmwasm_std::{
  MessageInfo, Response, StdResult,
 };
 use nibiru_macro::cw_custom;
-use nibiru_std::bindings::route::NibiruRoute;
+use nibiru_std::bindings::msg::NibiruRoute;
 
 use crate::{
  msgs::{ExecuteMsg, InitMsg, IsMemberResponse, QueryMsg, WhitelistResponse},

contracts/shifter/src/contract.rs

@@ -4,7 +4,7 @@ use cosmwasm_std::{
  MessageInfo, Response, StdResult,
 };
 use nibiru_macro::cw_custom;
-use nibiru_std::bindings::route::NibiruRoute;
+use nibiru_std::bindings::msg::NibiruRoute;
 
 use crate::{
  msgs::{ExecuteMsg, InitMsg, IsMemberResponse, QueryMsg, WhitelistResponse},

nibiru-std/Cargo.toml

@@ -3,9 +3,7 @@ name = "nibiru-std"
 version = "0.0.2"
 edition = "2021"
 description = "Nibiru Chain standard library for CosmWasm smart contracts"
-authors = [
- "Unique Divine <[email protected]>"
-]
+authors = ["Unique Divine <[email protected]>"]
 
 documentation = "https://docs.rs/nibiru-std"
 homepage = "https:/NibiruChain/cw-nibiru"
@@ -22,12 +20,13 @@ library = []
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 [dependencies]
-cosmwasm-std = { version = "1.4.0", features = ["stargate"] }
+cosmwasm-std = { version = "1.4.1", features = ["stargate"] }
 cosmwasm-schema = "1.4.0"
 prost = "0.12"
 prost-types = "0.12"
 serde = "1.0.188"
 anyhow = "1"
+nibiru-macro = { path = "../packages/macro" }
 
 # cargo run --bin script-name
 # [[bin]]

nibiru-std/src/bindings/mod.rs

@@ -1,4 +1,4 @@
+pub mod msg;
 pub mod querier;
 pub mod query;
-pub mod route;
 pub mod state;

nibiru-std/src/proto/cosmos.app.runtime.v1alpha1.rs

@@ -0,0 +1,46 @@
+// @generated
+/// Module is the config object for the runtime module.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct Module {
+ /// app_name is the name of the app.
+ #[prost(string, tag="1")]
+ pub app_name: ::prost::alloc::string::String,
+ /// begin_blockers specifies the module names of begin blockers
+ /// to call in the order in which they should be called. If this is left empty
+ /// no begin blocker will be registered.
+ #[prost(string, repeated, tag="2")]
+ pub begin_blockers: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
+ /// end_blockers specifies the module names of the end blockers
+ /// to call in the order in which they should be called. If this is left empty
+ /// no end blocker will be registered.
+ #[prost(string, repeated, tag="3")]
+ pub end_blockers: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
+ /// init_genesis specifies the module names of init genesis functions
+ /// to call in the order in which they should be called. If this is left empty
+ /// no init genesis function will be registered.
+ #[prost(string, repeated, tag="4")]
+ pub init_genesis: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
+ /// export_genesis specifies the order in which to export module genesis data.
+ /// If this is left empty, the init_genesis order will be used for export genesis
+ /// if it is specified.
+ #[prost(string, repeated, tag="5")]
+ pub export_genesis: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
+ /// override_store_keys is an optional list of overrides for the module store keys
+ /// to be used in keeper construction.
+ #[prost(message, repeated, tag="6")]
+ pub override_store_keys: ::prost::alloc::vec::Vec<StoreKeyConfig>,
+}
+/// StoreKeyConfig may be supplied to override the default module store key, which
+/// is the module name.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct StoreKeyConfig {
+ /// name of the module to override the store key of
+ #[prost(string, tag="1")]
+ pub module_name: ::prost::alloc::string::String,
+ /// the kv store key to use instead of the module name.
+ #[prost(string, tag="2")]
+ pub kv_store_key: ::prost::alloc::string::String,
+}
+// @@protoc_insertion_point(module)

nibiru-std/src/proto/cosmos.app.v1alpha1.rs

@@ -0,0 +1,151 @@
+// @generated
+/// ModuleDescriptor describes an app module.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct ModuleDescriptor {
+ /// go_import names the package that should be imported by an app to load the
+ /// module in the runtime module registry. It is required to make debugging
+ /// of configuration errors easier for users.
+ #[prost(string, tag="1")]
+ pub go_import: ::prost::alloc::string::String,
+ /// use_package refers to a protobuf package that this module
+ /// uses and exposes to the world. In an app, only one module should "use"
+ /// or own a single protobuf package. It is assumed that the module uses
+ /// all of the .proto files in a single package.
+ #[prost(message, repeated, tag="2")]
+ pub use_package: ::prost::alloc::vec::Vec<PackageReference>,
+ /// can_migrate_from defines which module versions this module can migrate
+ /// state from. The framework will check that one module version is able to
+ /// migrate from a previous module version before attempting to update its
+ /// config. It is assumed that modules can transitively migrate from earlier
+ /// versions. For instance if v3 declares it can migrate from v2, and v2
+ /// declares it can migrate from v1, the framework knows how to migrate
+ /// from v1 to v3, assuming all 3 module versions are registered at runtime.
+ #[prost(message, repeated, tag="3")]
+ pub can_migrate_from: ::prost::alloc::vec::Vec<MigrateFromInfo>,
+}
+/// PackageReference is a reference to a protobuf package used by a module.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct PackageReference {
+ /// name is the fully-qualified name of the package.
+ #[prost(string, tag="1")]
+ pub name: ::prost::alloc::string::String,
+ /// revision is the optional revision of the package that is being used.
+ /// Protobuf packages used in Cosmos should generally have a major version
+ /// as the last part of the package name, ex. foo.bar.baz.v1.
+ /// The revision of a package can be thought of as the minor version of a
+ /// package which has additional backwards compatible definitions that weren't
+ /// present in a previous version.
+ ///
+ /// A package should indicate its revision with a source code comment
+ /// above the package declaration in one of its files containing the
+ /// text "Revision N" where N is an integer revision. All packages start
+ /// at revision 0 the first time they are released in a module.
+ ///
+ /// When a new version of a module is released and items are added to existing
+ /// .proto files, these definitions should contain comments of the form
+ /// "Since Revision N" where N is an integer revision.
+ ///
+ /// When the module runtime starts up, it will check the pinned proto
+ /// image and panic if there are runtime protobuf definitions that are not
+ /// in the pinned descriptor which do not have
+ /// a "Since Revision N" comment or have a "Since Revision N" comment where
+ /// N is <= to the revision specified here. This indicates that the protobuf
+ /// files have been updated, but the pinned file descriptor hasn't.
+ ///
+ /// If there are items in the pinned file descriptor with a revision
+ /// greater than the value indicated here, this will also cause a panic
+ /// as it may mean that the pinned descriptor for a legacy module has been
+ /// improperly updated or that there is some other versioning discrepancy.
+ /// Runtime protobuf definitions will also be checked for compatibility
+ /// with pinned file descriptors to make sure there are no incompatible changes.
+ ///
+ /// This behavior ensures that:
+ /// * pinned proto images are up-to-date
+ /// * protobuf files are carefully annotated with revision comments which
+ /// are important good client UX
+ /// * protobuf files are changed in backwards and forwards compatible ways
+ #[prost(uint32, tag="2")]
+ pub revision: u32,
+}
+/// MigrateFromInfo is information on a module version that a newer module
+/// can migrate from.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct MigrateFromInfo {
+ /// module is the fully-qualified protobuf name of the module config object
+ /// for the previous module version, ex: "cosmos.group.module.v1.Module".
+ #[prost(string, tag="1")]
+ pub module: ::prost::alloc::string::String,
+}
+/// Config represents the configuration for a Cosmos SDK ABCI app.
+/// It is intended that all state machine logic including the version of
+/// baseapp and tx handlers (and possibly even Tendermint) that an app needs
+/// can be described in a config object. For compatibility, the framework should
+/// allow a mixture of declarative and imperative app wiring, however, apps
+/// that strive for the maximum ease of maintainability should be able to describe
+/// their state machine with a config object alone.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct Config {
+ /// modules are the module configurations for the app.
+ #[prost(message, repeated, tag="1")]
+ pub modules: ::prost::alloc::vec::Vec<ModuleConfig>,
+ /// golang_bindings specifies explicit interface to implementation type bindings which
+ /// depinject uses to resolve interface inputs to provider functions. The scope of this
+ /// field's configuration is global (not module specific).
+ #[prost(message, repeated, tag="2")]
+ pub golang_bindings: ::prost::alloc::vec::Vec<GolangBinding>,
+}
+/// ModuleConfig is a module configuration for an app.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct ModuleConfig {
+ /// name is the unique name of the module within the app. It should be a name
+ /// that persists between different versions of a module so that modules
+ /// can be smoothly upgraded to new versions.
+ ///
+ /// For example, for the module cosmos.bank.module.v1.Module, we may chose
+ /// to simply name the module "bank" in the app. When we upgrade to
+ /// cosmos.bank.module.v2.Module, the app-specific name "bank" stays the same
+ /// and the framework knows that the v2 module should receive all the same state
+ /// that the v1 module had. Note: modules should provide info on which versions
+ /// they can migrate from in the ModuleDescriptor.can_migration_from field.
+ #[prost(string, tag="1")]
+ pub name: ::prost::alloc::string::String,
+ /// config is the config object for the module. Module config messages should
+ /// define a ModuleDescriptor using the cosmos.app.v1alpha1.is_module extension.
+ #[prost(message, optional, tag="2")]
+ pub config: ::core::option::Option<::prost_types::Any>,
+ /// golang_bindings specifies explicit interface to implementation type bindings which
+ /// depinject uses to resolve interface inputs to provider functions. The scope of this
+ /// field's configuration is module specific.
+ #[prost(message, repeated, tag="3")]
+ pub golang_bindings: ::prost::alloc::vec::Vec<GolangBinding>,
+}
+/// GolangBinding is an explicit interface type to implementing type binding for dependency injection.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct GolangBinding {
+ /// interface_type is the interface type which will be bound to a specific implementation type
+ #[prost(string, tag="1")]
+ pub interface_type: ::prost::alloc::string::String,
+ /// implementation is the implementing type which will be supplied when an input of type interface is requested
+ #[prost(string, tag="2")]
+ pub implementation: ::prost::alloc::string::String,
+}
+/// QueryConfigRequest is the Query/Config request type.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct QueryConfigRequest {
+}
+/// QueryConfigRequest is the Query/Config response type.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct QueryConfigResponse {
+ /// config is the current app config.
+ #[prost(message, optional, tag="1")]
+ pub config: ::core::option::Option<Config>,
+}
+// @@protoc_insertion_point(module)

nibiru-std/src/proto/cosmos.auth.module.v1.rs

@@ -0,0 +1,28 @@
+// @generated
+/// Module is the config object for the auth module.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct Module {
+ /// bech32_prefix is the bech32 account prefix for the app.
+ #[prost(string, tag="1")]
+ pub bech32_prefix: ::prost::alloc::string::String,
+ /// module_account_permissions are module account permissions.
+ #[prost(message, repeated, tag="2")]
+ pub module_account_permissions: ::prost::alloc::vec::Vec<ModuleAccountPermission>,
+ /// authority defines the custom module authority. If not set, defaults to the governance module.
+ #[prost(string, tag="3")]
+ pub authority: ::prost::alloc::string::String,
+}
+/// ModuleAccountPermission represents permissions for a module account.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct ModuleAccountPermission {
+ /// account is the name of the module.
+ #[prost(string, tag="1")]
+ pub account: ::prost::alloc::string::String,
+ /// permissions are the permissions this module has. Currently recognized
+ /// values are minter, burner and staking.
+ #[prost(string, repeated, tag="2")]
+ pub permissions: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
+}
+// @@protoc_insertion_point(module)