@sparkdreamnft/sparkdreamjs 0.0.6 → 0.0.7

package/cosmos/ics23/v1/proofs.js

@@ -187,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",
@@ -295,6 +319,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",
@@ -390,6 +422,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",
@@ -497,6 +535,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",
@@ -613,6 +670,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",
@@ -709,6 +786,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",
@@ -828,6 +920,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",
@@ -966,6 +1071,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",
@@ -1040,6 +1151,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",
@@ -1122,6 +1239,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",
@@ -1210,6 +1332,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",
@@ -1294,6 +1422,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",
@@ -1412,6 +1545,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",

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

@@ -9,6 +9,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

@@ -10,6 +10,12 @@ function createBaseGenesisState() {
         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",

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;
@@ -74,6 +132,12 @@ export declare const Minter: {
     toProto(message: Minter): Uint8Array;
     toProtoMsg(message: Minter): MinterProtoMsg;
 };
+/**
+ * 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

@@ -10,6 +10,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",
@@ -96,6 +102,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",