import * as _m0 from "protobufjs/minimal"; import { DeepPartial } from "../../../helpers"; /** ModuleDescriptor describes an app module. */ export interface 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. */ goImport: 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. */ usePackage: 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. */ canMigrateFrom: MigrateFromInfo[]; } /** ModuleDescriptor describes an app module. */ export interface ModuleDescriptorSDKType { go_import: string; use_package: PackageReferenceSDKType[]; can_migrate_from: MigrateFromInfoSDKType[]; } /** PackageReference is a reference to a protobuf package used by a module. */ export interface PackageReference { /** name is the fully-qualified name of the package. */ name: 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 */ revision: number; } /** PackageReference is a reference to a protobuf package used by a module. */ export interface PackageReferenceSDKType { name: string; revision: number; } /** * MigrateFromInfo is information on a module version that a newer module * can migrate from. */ export interface MigrateFromInfo { /** * module is the fully-qualified protobuf name of the module config object * for the previous module version, ex: "cosmos.group.module.v1.Module". */ module: string; } /** * MigrateFromInfo is information on a module version that a newer module * can migrate from. */ export interface MigrateFromInfoSDKType { module: string; } function createBaseModuleDescriptor(): ModuleDescriptor { return { goImport: "", usePackage: [], canMigrateFrom: [] }; } export const ModuleDescriptor = { encode(message: ModuleDescriptor, writer: _m0.Writer = _m0.Writer.create()): _m0.Writer { if (message.goImport !== "") { writer.uint32(10).string(message.goImport); } for (const v of message.usePackage) { PackageReference.encode(v!, writer.uint32(18).fork()).ldelim(); } for (const v of message.canMigrateFrom) { MigrateFromInfo.encode(v!, writer.uint32(26).fork()).ldelim(); } return writer; }, decode(input: _m0.Reader | Uint8Array, length?: number): ModuleDescriptor { const reader = input instanceof _m0.Reader ? input : new _m0.Reader(input); let end = length === undefined ? reader.len : reader.pos + length; const message = createBaseModuleDescriptor(); while (reader.pos < end) { const tag = reader.uint32(); switch (tag >>> 3) { case 1: message.goImport = reader.string(); break; case 2: message.usePackage.push(PackageReference.decode(reader, reader.uint32())); break; case 3: message.canMigrateFrom.push(MigrateFromInfo.decode(reader, reader.uint32())); break; default: reader.skipType(tag & 7); break; } } return message; }, fromPartial(object: DeepPartial): ModuleDescriptor { const message = createBaseModuleDescriptor(); message.goImport = object.goImport ?? ""; message.usePackage = object.usePackage?.map(e => PackageReference.fromPartial(e)) || []; message.canMigrateFrom = object.canMigrateFrom?.map(e => MigrateFromInfo.fromPartial(e)) || []; return message; } }; function createBasePackageReference(): PackageReference { return { name: "", revision: 0 }; } export const PackageReference = { encode(message: PackageReference, writer: _m0.Writer = _m0.Writer.create()): _m0.Writer { if (message.name !== "") { writer.uint32(10).string(message.name); } if (message.revision !== 0) { writer.uint32(16).uint32(message.revision); } return writer; }, decode(input: _m0.Reader | Uint8Array, length?: number): PackageReference { const reader = input instanceof _m0.Reader ? input : new _m0.Reader(input); let end = length === undefined ? reader.len : reader.pos + length; const message = createBasePackageReference(); while (reader.pos < end) { const tag = reader.uint32(); switch (tag >>> 3) { case 1: message.name = reader.string(); break; case 2: message.revision = reader.uint32(); break; default: reader.skipType(tag & 7); break; } } return message; }, fromPartial(object: DeepPartial): PackageReference { const message = createBasePackageReference(); message.name = object.name ?? ""; message.revision = object.revision ?? 0; return message; } }; function createBaseMigrateFromInfo(): MigrateFromInfo { return { module: "" }; } export const MigrateFromInfo = { encode(message: MigrateFromInfo, writer: _m0.Writer = _m0.Writer.create()): _m0.Writer { if (message.module !== "") { writer.uint32(10).string(message.module); } return writer; }, decode(input: _m0.Reader | Uint8Array, length?: number): MigrateFromInfo { const reader = input instanceof _m0.Reader ? input : new _m0.Reader(input); let end = length === undefined ? reader.len : reader.pos + length; const message = createBaseMigrateFromInfo(); while (reader.pos < end) { const tag = reader.uint32(); switch (tag >>> 3) { case 1: message.module = reader.string(); break; default: reader.skipType(tag & 7); break; } } return message; }, fromPartial(object: DeepPartial): MigrateFromInfo { const message = createBaseMigrateFromInfo(); message.module = object.module ?? ""; return message; } };