@xpla/xplajs 1.7.0 → 1.8.0-rc.1

package/cosmos/ics23/v1/proofs.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CompressedNonExistenceProof = exports.CompressedExistenceProof = exports.CompressedBatchEntry = exports.CompressedBatchProof = exports.BatchEntry = exports.BatchProof = exports.InnerSpec = exports.ProofSpec = exports.InnerOp = exports.LeafOp = exports.CommitmentProof = exports.NonExistenceProof = exports.ExistenceProof = exports.lengthOpToJSON = exports.lengthOpFromJSON = exports.LengthOpAmino = exports.LengthOp = exports.hashOpToJSON = exports.hashOpFromJSON = exports.HashOpAmino = exports.HashOp = void 0;
 const binary_1 = require("../../../binary");
+const registry_1 = require("../../../registry");
 const helpers_1 = require("../../../helpers");
 var HashOp;
 (function (HashOp) {
@@ -186,6 +187,30 @@ function createBaseExistenceProof() {
         path: []
     };
 }
+/**
+ * ExistenceProof takes a key and a value and a set of steps to perform on it.
+ * The result of peforming all these steps will provide a "root hash", which can
+ * be compared to the value in a header.
+ *
+ * Since it is computationally infeasible to produce a hash collission for any of the used
+ * cryptographic hash functions, if someone can provide a series of operations to transform
+ * a given key and value into a root hash that matches some trusted root, these key and values
+ * must be in the referenced merkle tree.
+ *
+ * The only possible issue is maliablity in LeafOp, such as providing extra prefix data,
+ * which should be controlled by a spec. Eg. with lengthOp as NONE,
+ * prefix = FOO, key = BAR, value = CHOICE
+ * and
+ * prefix = F, key = OOBAR, value = CHOICE
+ * would produce the same value.
+ *
+ * With LengthOp this is tricker but not impossible. Which is why the "leafPrefixEqual" field
+ * in the ProofSpec is valuable to prevent this mutability. And why all trees should
+ * length-prefix the data before hashing it.
+ * @name ExistenceProof
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.ExistenceProof
+ */
 exports.ExistenceProof = {
     typeUrl: "/cosmos.ics23.v1.ExistenceProof",
     aminoType: "cosmos-sdk/ExistenceProof",
@@ -293,6 +318,9 @@ exports.ExistenceProof = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.ExistenceProof.typeUrl)) {
+            return;
+        }
         exports.LeafOp.registerTypeUrl();
         exports.InnerOp.registerTypeUrl();
     }
@@ -304,6 +332,14 @@ function createBaseNonExistenceProof() {
         right: undefined
     };
 }
+/**
+ * NonExistenceProof takes a proof of two neighbors, one left of the desired key,
+ * one right of the desired key. If both proofs are valid AND they are neighbors,
+ * then there is no valid proof for the given key.
+ * @name NonExistenceProof
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.NonExistenceProof
+ */
 exports.NonExistenceProof = {
     typeUrl: "/cosmos.ics23.v1.NonExistenceProof",
     aminoType: "cosmos-sdk/NonExistenceProof",
@@ -397,6 +433,9 @@ exports.NonExistenceProof = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.NonExistenceProof.typeUrl)) {
+            return;
+        }
         exports.ExistenceProof.registerTypeUrl();
     }
 };
@@ -408,6 +447,12 @@ function createBaseCommitmentProof() {
         compressed: undefined
     };
 }
+/**
+ * CommitmentProof is either an ExistenceProof or a NonExistenceProof, or a Batch of such messages
+ * @name CommitmentProof
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.CommitmentProof
+ */
 exports.CommitmentProof = {
     typeUrl: "/cosmos.ics23.v1.CommitmentProof",
     aminoType: "cosmos-sdk/CommitmentProof",
@@ -512,6 +557,9 @@ exports.CommitmentProof = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.CommitmentProof.typeUrl)) {
+            return;
+        }
         exports.ExistenceProof.registerTypeUrl();
         exports.NonExistenceProof.registerTypeUrl();
         exports.BatchProof.registerTypeUrl();
@@ -527,6 +575,25 @@ function createBaseLeafOp() {
         prefix: new Uint8Array()
     };
 }
+/**
+ * LeafOp represents the raw key-value data we wish to prove, and
+ * must be flexible to represent the internal transformation from
+ * the original key-value pairs into the basis hash, for many existing
+ * merkle trees.
+ *
+ * key and value are passed in. So that the signature of this operation is:
+ * leafOp(key, value) -> output
+ *
+ * To process this, first prehash the keys and values if needed (ANY means no hash in this case):
+ * hkey = prehashKey(key)
+ * hvalue = prehashValue(value)
+ *
+ * Then combine the bytes, and hash it
+ * output = hash(prefix || length(hkey) || hkey || length(hvalue) || hvalue)
+ * @name LeafOp
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.LeafOp
+ */
 exports.LeafOp = {
     typeUrl: "/cosmos.ics23.v1.LeafOp",
     aminoType: "cosmos-sdk/LeafOp",
@@ -650,6 +717,26 @@ function createBaseInnerOp() {
         suffix: new Uint8Array()
     };
 }
+/**
+ * InnerOp represents a merkle-proof step that is not a leaf.
+ * It represents concatenating two children and hashing them to provide the next result.
+ *
+ * The result of the previous step is passed in, so the signature of this op is:
+ * innerOp(child) -> output
+ *
+ * The result of applying InnerOp should be:
+ * output = op.hash(op.prefix || child || op.suffix)
+ *
+ * where the || operator is concatenation of binary data,
+ * and child is the result of hashing all the tree below this step.
+ *
+ * Any special data, like prepending child with the length, or prepending the entire operation with
+ * some value to differentiate from leaf nodes, should be included in prefix and suffix.
+ * If either of prefix or suffix is empty, we just treat it as an empty string
+ * @name InnerOp
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.InnerOp
+ */
 exports.InnerOp = {
     typeUrl: "/cosmos.ics23.v1.InnerOp",
     aminoType: "cosmos-sdk/InnerOp",
@@ -753,6 +840,21 @@ function createBaseProofSpec() {
         prehashKeyBeforeComparison: false
     };
 }
+/**
+ * ProofSpec defines what the expected parameters are for a given proof type.
+ * This can be stored in the client and used to validate any incoming proofs.
+ *
+ * verify(ProofSpec, Proof) -> Proof | Error
+ *
+ * As demonstrated in tests, if we don't fix the algorithm used to calculate the
+ * LeafHash for a given tree, there are many possible key-value pairs that can
+ * generate a given hash (by interpretting the preimage differently).
+ * We need this for proper security, requires client knows a priori what
+ * tree format server uses. But not in code, rather a configuration object.
+ * @name ProofSpec
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.ProofSpec
+ */
 exports.ProofSpec = {
     typeUrl: "/cosmos.ics23.v1.ProofSpec",
     aminoType: "cosmos-sdk/ProofSpec",
@@ -868,6 +970,9 @@ exports.ProofSpec = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.ProofSpec.typeUrl)) {
+            return;
+        }
         exports.LeafOp.registerTypeUrl();
         exports.InnerSpec.registerTypeUrl();
     }
@@ -882,6 +987,19 @@ function createBaseInnerSpec() {
         hash: 0
     };
 }
+/**
+ * InnerSpec contains all store-specific structure info to determine if two proofs from a
+ * given store are neighbors.
+ *
+ * This enables:
+ *
+ * isLeftMost(spec: InnerSpec, op: InnerOp)
+ * isRightMost(spec: InnerSpec, op: InnerOp)
+ * isLeftNeighbor(spec: InnerSpec, left: InnerOp, right: InnerOp)
+ * @name InnerSpec
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.InnerSpec
+ */
 exports.InnerSpec = {
     typeUrl: "/cosmos.ics23.v1.InnerSpec",
     aminoType: "cosmos-sdk/InnerSpec",
@@ -1027,6 +1145,12 @@ function createBaseBatchProof() {
         entries: []
     };
 }
+/**
+ * BatchProof is a group of multiple proof types than can be compressed
+ * @name BatchProof
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.BatchProof
+ */
 exports.BatchProof = {
     typeUrl: "/cosmos.ics23.v1.BatchProof",
     aminoType: "cosmos-sdk/BatchProof",
@@ -1101,6 +1225,9 @@ exports.BatchProof = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.BatchProof.typeUrl)) {
+            return;
+        }
         exports.BatchEntry.registerTypeUrl();
     }
 };
@@ -1110,6 +1237,12 @@ function createBaseBatchEntry() {
         nonexist: undefined
     };
 }
+/**
+ * Use BatchEntry not CommitmentProof, to avoid recursion
+ * @name BatchEntry
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.BatchEntry
+ */
 exports.BatchEntry = {
     typeUrl: "/cosmos.ics23.v1.BatchEntry",
     aminoType: "cosmos-sdk/BatchEntry",
@@ -1192,6 +1325,9 @@ exports.BatchEntry = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.BatchEntry.typeUrl)) {
+            return;
+        }
         exports.ExistenceProof.registerTypeUrl();
         exports.NonExistenceProof.registerTypeUrl();
     }
@@ -1202,6 +1338,11 @@ function createBaseCompressedBatchProof() {
         lookupInners: []
     };
 }
+/**
+ * @name CompressedBatchProof
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.CompressedBatchProof
+ */
 exports.CompressedBatchProof = {
     typeUrl: "/cosmos.ics23.v1.CompressedBatchProof",
     aminoType: "cosmos-sdk/CompressedBatchProof",
@@ -1290,6 +1431,9 @@ exports.CompressedBatchProof = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.CompressedBatchProof.typeUrl)) {
+            return;
+        }
         exports.CompressedBatchEntry.registerTypeUrl();
         exports.InnerOp.registerTypeUrl();
     }
@@ -1300,6 +1444,12 @@ function createBaseCompressedBatchEntry() {
         nonexist: undefined
     };
 }
+/**
+ * Use BatchEntry not CommitmentProof, to avoid recursion
+ * @name CompressedBatchEntry
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.CompressedBatchEntry
+ */
 exports.CompressedBatchEntry = {
     typeUrl: "/cosmos.ics23.v1.CompressedBatchEntry",
     aminoType: "cosmos-sdk/CompressedBatchEntry",
@@ -1382,6 +1532,9 @@ exports.CompressedBatchEntry = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.CompressedBatchEntry.typeUrl)) {
+            return;
+        }
         exports.CompressedExistenceProof.registerTypeUrl();
         exports.CompressedNonExistenceProof.registerTypeUrl();
     }
@@ -1394,6 +1547,11 @@ function createBaseCompressedExistenceProof() {
         path: []
     };
 }
+/**
+ * @name CompressedExistenceProof
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.CompressedExistenceProof
+ */
 exports.CompressedExistenceProof = {
     typeUrl: "/cosmos.ics23.v1.CompressedExistenceProof",
     aminoType: "cosmos-sdk/CompressedExistenceProof",
@@ -1511,6 +1669,9 @@ exports.CompressedExistenceProof = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.CompressedExistenceProof.typeUrl)) {
+            return;
+        }
         exports.LeafOp.registerTypeUrl();
     }
 };
@@ -1521,6 +1682,11 @@ function createBaseCompressedNonExistenceProof() {
         right: undefined
     };
 }
+/**
+ * @name CompressedNonExistenceProof
+ * @package cosmos.ics23.v1
+ * @see proto type: cosmos.ics23.v1.CompressedNonExistenceProof
+ */
 exports.CompressedNonExistenceProof = {
     typeUrl: "/cosmos.ics23.v1.CompressedNonExistenceProof",
     aminoType: "cosmos-sdk/CompressedNonExistenceProof",
@@ -1614,6 +1780,9 @@ exports.CompressedNonExistenceProof = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.CompressedNonExistenceProof.typeUrl)) {
+            return;
+        }
         exports.CompressedExistenceProof.registerTypeUrl();
     }
 };

package/cosmos/mint/module/v1/module.d.ts

@@ -1,25 +1,45 @@
 import { BinaryReader, BinaryWriter } from "../../../../binary";
 import { DeepPartial } from "../../../../helpers";
-/** Module is the config object of the mint module. */
+/**
+ * Module is the config object of the mint module.
+ * @name Module
+ * @package cosmos.mint.module.v1
+ * @see proto type: cosmos.mint.module.v1.Module
+ */
 export interface Module {
     feeCollectorName: string;
-    /** authority defines the custom module authority. If not set, defaults to the governance module. */
+    /**
+     * authority defines the custom module authority. If not set, defaults to the governance module.
+     */
     authority: string;
 }
 export interface ModuleProtoMsg {
     typeUrl: "/cosmos.mint.module.v1.Module";
     value: Uint8Array;
 }
-/** Module is the config object of the mint module. */
+/**
+ * Module is the config object of the mint module.
+ * @name ModuleAmino
+ * @package cosmos.mint.module.v1
+ * @see proto type: cosmos.mint.module.v1.Module
+ */
 export interface ModuleAmino {
     fee_collector_name: string;
-    /** authority defines the custom module authority. If not set, defaults to the governance module. */
+    /**
+     * authority defines the custom module authority. If not set, defaults to the governance module.
+     */
     authority: string;
 }
 export interface ModuleAminoMsg {
     type: "cosmos-sdk/Module";
     value: ModuleAmino;
 }
+/**
+ * Module is the config object of the mint module.
+ * @name Module
+ * @package cosmos.mint.module.v1
+ * @see proto type: cosmos.mint.module.v1.Module
+ */
 export declare const Module: {
     typeUrl: string;
     aminoType: string;

package/cosmos/mint/module/v1/module.js

@@ -8,6 +8,12 @@ function createBaseModule() {
         authority: ""
     };
 }
+/**
+ * Module is the config object of the mint module.
+ * @name Module
+ * @package cosmos.mint.module.v1
+ * @see proto type: cosmos.mint.module.v1.Module
+ */
 exports.Module = {
     typeUrl: "/cosmos.mint.module.v1.Module",
     aminoType: "cosmos-sdk/Module",

package/cosmos/mint/v1beta1/genesis.d.ts

@@ -1,28 +1,52 @@
 import { Minter, MinterAmino, Params, ParamsAmino } from "./mint";
 import { BinaryReader, BinaryWriter } from "../../../binary";
 import { DeepPartial } from "../../../helpers";
-/** GenesisState defines the mint module's genesis state. */
+/**
+ * GenesisState defines the mint module's genesis state.
+ * @name GenesisState
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.GenesisState
+ */
 export interface GenesisState {
-    /** minter is a space for holding current inflation information. */
+    /**
+     * minter is a space for holding current inflation information.
+     */
     minter: Minter;
-    /** params defines all the parameters of the module. */
+    /**
+     * params defines all the parameters of the module.
+     */
     params: Params;
 }
 export interface GenesisStateProtoMsg {
     typeUrl: "/cosmos.mint.v1beta1.GenesisState";
     value: Uint8Array;
 }
-/** GenesisState defines the mint module's genesis state. */
+/**
+ * GenesisState defines the mint module's genesis state.
+ * @name GenesisStateAmino
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.GenesisState
+ */
 export interface GenesisStateAmino {
-    /** minter is a space for holding current inflation information. */
+    /**
+     * minter is a space for holding current inflation information.
+     */
     minter: MinterAmino;
-    /** params defines all the parameters of the module. */
+    /**
+     * params defines all the parameters of the module.
+     */
     params: ParamsAmino;
 }
 export interface GenesisStateAminoMsg {
     type: "cosmos-sdk/GenesisState";
     value: GenesisStateAmino;
 }
+/**
+ * GenesisState defines the mint module's genesis state.
+ * @name GenesisState
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.GenesisState
+ */
 export declare const GenesisState: {
     typeUrl: string;
     aminoType: string;

package/cosmos/mint/v1beta1/genesis.js

@@ -3,12 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GenesisState = void 0;
 const mint_1 = require("./mint");
 const binary_1 = require("../../../binary");
+const registry_1 = require("../../../registry");
 function createBaseGenesisState() {
     return {
         minter: mint_1.Minter.fromPartial({}),
         params: mint_1.Params.fromPartial({})
     };
 }
+/**
+ * GenesisState defines the mint module's genesis state.
+ * @name GenesisState
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.GenesisState
+ */
 exports.GenesisState = {
     typeUrl: "/cosmos.mint.v1beta1.GenesisState",
     aminoType: "cosmos-sdk/GenesisState",
@@ -91,6 +98,9 @@ exports.GenesisState = {
         };
     },
     registerTypeUrl() {
+        if (!registry_1.GlobalDecoderRegistry.registerExistingTypeUrl(exports.GenesisState.typeUrl)) {
+            return;
+        }
         mint_1.Minter.registerTypeUrl();
         mint_1.Params.registerTypeUrl();
     }

package/cosmos/mint/v1beta1/mint.d.ts

@@ -1,65 +1,123 @@
 import { BinaryReader, BinaryWriter } from "../../../binary";
 import { DeepPartial } from "../../../helpers";
-/** Minter represents the minting state. */
+/**
+ * Minter represents the minting state.
+ * @name Minter
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.Minter
+ */
 export interface Minter {
-    /** current annual inflation rate */
+    /**
+     * current annual inflation rate
+     */
     inflation: string;
-    /** current annual expected provisions */
+    /**
+     * current annual expected provisions
+     */
     annualProvisions: string;
 }
 export interface MinterProtoMsg {
     typeUrl: "/cosmos.mint.v1beta1.Minter";
     value: Uint8Array;
 }
-/** Minter represents the minting state. */
+/**
+ * Minter represents the minting state.
+ * @name MinterAmino
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.Minter
+ */
 export interface MinterAmino {
-    /** current annual inflation rate */
+    /**
+     * current annual inflation rate
+     */
     inflation: string;
-    /** current annual expected provisions */
+    /**
+     * current annual expected provisions
+     */
     annual_provisions: string;
 }
 export interface MinterAminoMsg {
     type: "cosmos-sdk/Minter";
     value: MinterAmino;
 }
-/** Params defines the parameters for the x/mint module. */
+/**
+ * Params defines the parameters for the x/mint module.
+ * @name Params
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.Params
+ */
 export interface Params {
-    /** type of coin to mint */
+    /**
+     * type of coin to mint
+     */
     mintDenom: string;
-    /** maximum annual change in inflation rate */
+    /**
+     * maximum annual change in inflation rate
+     */
     inflationRateChange: string;
-    /** maximum inflation rate */
+    /**
+     * maximum inflation rate
+     */
     inflationMax: string;
-    /** minimum inflation rate */
+    /**
+     * minimum inflation rate
+     */
     inflationMin: string;
-    /** goal of percent bonded atoms */
+    /**
+     * goal of percent bonded atoms
+     */
     goalBonded: string;
-    /** expected blocks per year */
+    /**
+     * expected blocks per year
+     */
     blocksPerYear: bigint;
 }
 export interface ParamsProtoMsg {
     typeUrl: "/cosmos.mint.v1beta1.Params";
     value: Uint8Array;
 }
-/** Params defines the parameters for the x/mint module. */
+/**
+ * Params defines the parameters for the x/mint module.
+ * @name ParamsAmino
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.Params
+ */
 export interface ParamsAmino {
-    /** type of coin to mint */
+    /**
+     * type of coin to mint
+     */
     mint_denom: string;
-    /** maximum annual change in inflation rate */
+    /**
+     * maximum annual change in inflation rate
+     */
     inflation_rate_change: string;
-    /** maximum inflation rate */
+    /**
+     * maximum inflation rate
+     */
     inflation_max: string;
-    /** minimum inflation rate */
+    /**
+     * minimum inflation rate
+     */
     inflation_min: string;
-    /** goal of percent bonded atoms */
+    /**
+     * goal of percent bonded atoms
+     */
     goal_bonded: string;
-    /** expected blocks per year */
+    /**
+     * expected blocks per year
+     */
     blocks_per_year: string;
 }
 export interface ParamsAminoMsg {
     type: "cosmos-sdk/x/mint/Params";
     value: ParamsAmino;
 }
+/**
+ * Minter represents the minting state.
+ * @name Minter
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.Minter
+ */
 export declare const Minter: {
     typeUrl: string;
     aminoType: string;
@@ -77,6 +135,12 @@ export declare const Minter: {
     toProtoMsg(message: Minter): MinterProtoMsg;
     registerTypeUrl(): void;
 };
+/**
+ * Params defines the parameters for the x/mint module.
+ * @name Params
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.Params
+ */
 export declare const Params: {
     typeUrl: string;
     aminoType: string;

package/cosmos/mint/v1beta1/mint.js

@@ -9,6 +9,12 @@ function createBaseMinter() {
         annualProvisions: ""
     };
 }
+/**
+ * Minter represents the minting state.
+ * @name Minter
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.Minter
+ */
 exports.Minter = {
     typeUrl: "/cosmos.mint.v1beta1.Minter",
     aminoType: "cosmos-sdk/Minter",
@@ -102,6 +108,12 @@ function createBaseParams() {
         blocksPerYear: BigInt(0)
     };
 }
+/**
+ * Params defines the parameters for the x/mint module.
+ * @name Params
+ * @package cosmos.mint.v1beta1
+ * @see proto type: cosmos.mint.v1beta1.Params
+ */
 exports.Params = {
     typeUrl: "/cosmos.mint.v1beta1.Params",
     aminoType: "cosmos-sdk/x/mint/Params",