@sparkdreamnft/sparkdreamjs 0.0.43 → 0.0.45

package/sparkdream/shield/v1/genesis.d.ts

@@ -1,5 +1,5 @@
 import { Params, ParamsAmino } from "./params";
-import { ShieldedOpRegistration, ShieldedOpRegistrationAmino, UsedNullifier, UsedNullifierAmino, DayFunding, DayFundingAmino, VerificationKey, VerificationKeyAmino, TLEKeySet, TLEKeySetAmino, PendingShieldedOp, PendingShieldedOpAmino, ShieldEpochState, ShieldEpochStateAmino, ShieldEpochDecryptionKey, ShieldEpochDecryptionKeyAmino, IdentityRateLimitEntry, IdentityRateLimitEntryAmino, ShieldDecryptionShare, ShieldDecryptionShareAmino, TLEMissCounterEntry, TLEMissCounterEntryAmino, DKGState, DKGStateAmino, DKGContributionEntry, DKGContributionEntryAmino } from "./types";
+import { ShieldedOpRegistration, ShieldedOpRegistrationAmino, UsedNullifier, UsedNullifierAmino, DayFunding, DayFundingAmino, VerificationKey, VerificationKeyAmino, TLEKeySet, TLEKeySetAmino, PendingShieldedOp, PendingShieldedOpAmino, ShieldEpochState, ShieldEpochStateAmino, ShieldEpochDecryptionKey, ShieldEpochDecryptionKeyAmino, IdentityRateLimitEntry, IdentityRateLimitEntryAmino, ShieldDecryptionShare, ShieldDecryptionShareAmino, TLEMissCounterEntry, TLEMissCounterEntryAmino, DKGState, DKGStateAmino, DKGContributionEntry, DKGContributionEntryAmino, DecryptionDemandEntry, DecryptionDemandEntryAmino, DKGComplaint, DKGComplaintAmino } from "./types";
 import { BinaryReader, BinaryWriter } from "../../../binary";
 import { DeepPartial } from "../../../helpers";
 /**
@@ -77,6 +77,14 @@ export interface GenesisState {
      * DKG registrations (pub keys from REGISTERING phase)
      */
     dkgRegistrations: DKGContributionEntry[];
+    /**
+     * Closed epochs whose decryption shares have been requested from validators
+     */
+    decryptionDemands: DecryptionDemandEntry[];
+    /**
+     * DKG complaints for the current round
+     */
+    dkgComplaints: DKGComplaint[];
 }
 export interface GenesisStateProtoMsg {
     typeUrl: "/sparkdream.shield.v1.GenesisState";
@@ -157,6 +165,14 @@ export interface GenesisStateAmino {
      * DKG registrations (pub keys from REGISTERING phase)
      */
     dkg_registrations?: DKGContributionEntryAmino[];
+    /**
+     * Closed epochs whose decryption shares have been requested from validators
+     */
+    decryption_demands?: DecryptionDemandEntryAmino[];
+    /**
+     * DKG complaints for the current round
+     */
+    dkg_complaints?: DKGComplaintAmino[];
 }
 export interface GenesisStateAminoMsg {
     type: "/sparkdream.shield.v1.GenesisState";

package/sparkdream/shield/v1/genesis.js

@@ -23,7 +23,9 @@ function createBaseGenesisState() {
         tleMissCounters: [],
         dkgState: types_1.DKGState.fromPartial({}),
         dkgContributions: [],
-        dkgRegistrations: []
+        dkgRegistrations: [],
+        decryptionDemands: [],
+        dkgComplaints: []
     };
 }
 /**
@@ -86,6 +88,12 @@ exports.GenesisState = {
         for (const v of message.dkgRegistrations) {
             types_1.DKGContributionEntry.encode(v, writer.uint32(138).fork()).ldelim();
         }
+        for (const v of message.decryptionDemands) {
+            types_1.DecryptionDemandEntry.encode(v, writer.uint32(146).fork()).ldelim();
+        }
+        for (const v of message.dkgComplaints) {
+            types_1.DKGComplaint.encode(v, writer.uint32(154).fork()).ldelim();
+        }
         return writer;
     },
     decode(input, length) {
@@ -146,6 +154,12 @@ exports.GenesisState = {
                 case 17:
                     message.dkgRegistrations.push(types_1.DKGContributionEntry.decode(reader, reader.uint32()));
                     break;
+                case 18:
+                    message.decryptionDemands.push(types_1.DecryptionDemandEntry.decode(reader, reader.uint32()));
+                    break;
+                case 19:
+                    message.dkgComplaints.push(types_1.DKGComplaint.decode(reader, reader.uint32()));
+                    break;
                 default:
                     reader.skipType(tag & 7);
                     break;
@@ -172,6 +186,8 @@ exports.GenesisState = {
         message.dkgState = object.dkgState !== undefined && object.dkgState !== null ? types_1.DKGState.fromPartial(object.dkgState) : undefined;
         message.dkgContributions = object.dkgContributions?.map(e => types_1.DKGContributionEntry.fromPartial(e)) || [];
         message.dkgRegistrations = object.dkgRegistrations?.map(e => types_1.DKGContributionEntry.fromPartial(e)) || [];
+        message.decryptionDemands = object.decryptionDemands?.map(e => types_1.DecryptionDemandEntry.fromPartial(e)) || [];
+        message.dkgComplaints = object.dkgComplaints?.map(e => types_1.DKGComplaint.fromPartial(e)) || [];
         return message;
     },
     fromAmino(object) {
@@ -203,6 +219,8 @@ exports.GenesisState = {
         }
         message.dkgContributions = object.dkg_contributions?.map(e => types_1.DKGContributionEntry.fromAmino(e)) || [];
         message.dkgRegistrations = object.dkg_registrations?.map(e => types_1.DKGContributionEntry.fromAmino(e)) || [];
+        message.decryptionDemands = object.decryption_demands?.map(e => types_1.DecryptionDemandEntry.fromAmino(e)) || [];
+        message.dkgComplaints = object.dkg_complaints?.map(e => types_1.DKGComplaint.fromAmino(e)) || [];
         return message;
     },
     toAmino(message) {
@@ -284,6 +302,18 @@ exports.GenesisState = {
         else {
             obj.dkg_registrations = message.dkgRegistrations;
         }
+        if (message.decryptionDemands) {
+            obj.decryption_demands = message.decryptionDemands.map(e => e ? types_1.DecryptionDemandEntry.toAmino(e) : undefined);
+        }
+        else {
+            obj.decryption_demands = message.decryptionDemands;
+        }
+        if (message.dkgComplaints) {
+            obj.dkg_complaints = message.dkgComplaints.map(e => e ? types_1.DKGComplaint.toAmino(e) : undefined);
+        }
+        else {
+            obj.dkg_complaints = message.dkgComplaints;
+        }
         return obj;
     },
     fromAminoMsg(object) {

package/sparkdream/shield/v1/params.d.ts

@@ -12,7 +12,7 @@ export interface Params {
      */
     enabled: boolean;
     /**
-     * Maximum uspark to skim from community pool per day (14400 blocks at 6s/block)
+     * Maximum bond-denom amount to draw from the community pool per UTC day (day = block time / 86400)
      */
     maxFundingPerDay: string;
     /**
@@ -72,7 +72,7 @@ export interface Params {
      */
     minTleValidators: number;
     /**
-     * Total DKG window in blocks (split: first half = key registration, second half = contributions)
+     * Total DKG window in blocks, split into four equal phases: key registration, dealing, complaints, justifications
      */
     dkgWindowBlocks: bigint;
     /**
@@ -80,6 +80,20 @@ export interface Params {
      * e.g. 33 means re-key if >33% of DKG participants are no longer in the bonded set.
      */
     maxValidatorSetDrift: number;
+    /**
+     * Maximum fee (in the bond denom) the shield module pays for one
+     * MsgShieldedExec. The submitter chooses the fee but the module pays it, so
+     * without a ceiling one exec could hand the whole gas reserve to the fee
+     * collector. A tx whose fee exceeds this, or is in any other denom, is
+     * rejected before anything is paid.
+     */
+    maxFeePerExec: string;
+    /**
+     * Whether a completed DKG turns encrypted_batch_enabled on by itself.
+     * Off by default: governance enables batch mode explicitly once it is
+     * satisfied with the ceremony. A re-key always turns batch mode off.
+     */
+    enableBatchAfterDkg: boolean;
 }
 export interface ParamsProtoMsg {
     typeUrl: "/sparkdream.shield.v1.Params";
@@ -97,7 +111,7 @@ export interface ParamsAmino {
      */
     enabled?: boolean;
     /**
-     * Maximum uspark to skim from community pool per day (14400 blocks at 6s/block)
+     * Maximum bond-denom amount to draw from the community pool per UTC day (day = block time / 86400)
      */
     max_funding_per_day?: string;
     /**
@@ -157,7 +171,7 @@ export interface ParamsAmino {
      */
     min_tle_validators?: number;
     /**
-     * Total DKG window in blocks (split: first half = key registration, second half = contributions)
+     * Total DKG window in blocks, split into four equal phases: key registration, dealing, complaints, justifications
      */
     dkg_window_blocks?: string;
     /**
@@ -165,6 +179,20 @@ export interface ParamsAmino {
      * e.g. 33 means re-key if >33% of DKG participants are no longer in the bonded set.
      */
     max_validator_set_drift?: number;
+    /**
+     * Maximum fee (in the bond denom) the shield module pays for one
+     * MsgShieldedExec. The submitter chooses the fee but the module pays it, so
+     * without a ceiling one exec could hand the whole gas reserve to the fee
+     * collector. A tx whose fee exceeds this, or is in any other denom, is
+     * rejected before anything is paid.
+     */
+    max_fee_per_exec?: string;
+    /**
+     * Whether a completed DKG turns encrypted_batch_enabled on by itself.
+     * Off by default: governance enables batch mode explicitly once it is
+     * satisfied with the ceremony. A re-key always turns batch mode off.
+     */
+    enable_batch_after_dkg?: boolean;
 }
 export interface ParamsAminoMsg {
     type: "sparkdream/x/shield/Params";

package/sparkdream/shield/v1/params.js

@@ -22,7 +22,9 @@ function createBaseParams() {
         tleJailDuration: BigInt(0),
         minTleValidators: 0,
         dkgWindowBlocks: BigInt(0),
-        maxValidatorSetDrift: 0
+        maxValidatorSetDrift: 0,
+        maxFeePerExec: "",
+        enableBatchAfterDkg: false
     };
 }
 /**
@@ -89,6 +91,12 @@ exports.Params = {
         if (message.maxValidatorSetDrift !== 0) {
             writer.uint32(144).uint32(message.maxValidatorSetDrift);
         }
+        if (message.maxFeePerExec !== "") {
+            writer.uint32(154).string(message.maxFeePerExec);
+        }
+        if (message.enableBatchAfterDkg === true) {
+            writer.uint32(160).bool(message.enableBatchAfterDkg);
+        }
         return writer;
     },
     decode(input, length) {
@@ -152,6 +160,12 @@ exports.Params = {
                 case 18:
                     message.maxValidatorSetDrift = reader.uint32();
                     break;
+                case 19:
+                    message.maxFeePerExec = reader.string();
+                    break;
+                case 20:
+                    message.enableBatchAfterDkg = reader.bool();
+                    break;
                 default:
                     reader.skipType(tag & 7);
                     break;
@@ -179,6 +193,8 @@ exports.Params = {
         message.minTleValidators = object.minTleValidators ?? 0;
         message.dkgWindowBlocks = object.dkgWindowBlocks !== undefined && object.dkgWindowBlocks !== null ? BigInt(object.dkgWindowBlocks.toString()) : BigInt(0);
         message.maxValidatorSetDrift = object.maxValidatorSetDrift ?? 0;
+        message.maxFeePerExec = object.maxFeePerExec ?? "";
+        message.enableBatchAfterDkg = object.enableBatchAfterDkg ?? false;
         return message;
     },
     fromAmino(object) {
@@ -237,6 +253,12 @@ exports.Params = {
         if (object.max_validator_set_drift !== undefined && object.max_validator_set_drift !== null) {
             message.maxValidatorSetDrift = object.max_validator_set_drift;
         }
+        if (object.max_fee_per_exec !== undefined && object.max_fee_per_exec !== null) {
+            message.maxFeePerExec = object.max_fee_per_exec;
+        }
+        if (object.enable_batch_after_dkg !== undefined && object.enable_batch_after_dkg !== null) {
+            message.enableBatchAfterDkg = object.enable_batch_after_dkg;
+        }
         return message;
     },
     toAmino(message) {
@@ -259,6 +281,8 @@ exports.Params = {
         obj.min_tle_validators = message.minTleValidators === 0 ? undefined : message.minTleValidators;
         obj.dkg_window_blocks = message.dkgWindowBlocks !== BigInt(0) ? message.dkgWindowBlocks?.toString() : undefined;
         obj.max_validator_set_drift = message.maxValidatorSetDrift === 0 ? undefined : message.maxValidatorSetDrift;
+        obj.max_fee_per_exec = message.maxFeePerExec === "" ? undefined : message.maxFeePerExec;
+        obj.enable_batch_after_dkg = message.enableBatchAfterDkg === false ? undefined : message.enableBatchAfterDkg;
         return obj;
     },
     fromAminoMsg(object) {

package/sparkdream/shield/v1/query.d.ts

@@ -475,6 +475,10 @@ export interface QueryTLEMasterPublicKeyRequestAminoMsg {
  */
 export interface QueryTLEMasterPublicKeyResponse {
     masterPublicKey: Uint8Array;
+    /**
+     * The key clients encrypt batch payloads to (see tools/tle).
+     */
+    masterPublicKeyG2: Uint8Array;
 }
 export interface QueryTLEMasterPublicKeyResponseProtoMsg {
     typeUrl: "/sparkdream.shield.v1.QueryTLEMasterPublicKeyResponse";
@@ -487,6 +491,10 @@ export interface QueryTLEMasterPublicKeyResponseProtoMsg {
  */
 export interface QueryTLEMasterPublicKeyResponseAmino {
     master_public_key?: string;
+    /**
+     * The key clients encrypt batch payloads to (see tools/tle).
+     */
+    master_public_key_g2?: string;
 }
 export interface QueryTLEMasterPublicKeyResponseAminoMsg {
     type: "/sparkdream.shield.v1.QueryTLEMasterPublicKeyResponse";

package/sparkdream/shield/v1/query.js

@@ -1315,7 +1315,8 @@ exports.QueryTLEMasterPublicKeyRequest = {
 };
 function createBaseQueryTLEMasterPublicKeyResponse() {
     return {
-        masterPublicKey: new Uint8Array()
+        masterPublicKey: new Uint8Array(),
+        masterPublicKeyG2: new Uint8Array()
     };
 }
 /**
@@ -1329,6 +1330,9 @@ exports.QueryTLEMasterPublicKeyResponse = {
         if (message.masterPublicKey.length !== 0) {
             writer.uint32(10).bytes(message.masterPublicKey);
         }
+        if (message.masterPublicKeyG2.length !== 0) {
+            writer.uint32(18).bytes(message.masterPublicKeyG2);
+        }
         return writer;
     },
     decode(input, length) {
@@ -1341,6 +1345,9 @@ exports.QueryTLEMasterPublicKeyResponse = {
                 case 1:
                     message.masterPublicKey = reader.bytes();
                     break;
+                case 2:
+                    message.masterPublicKeyG2 = reader.bytes();
+                    break;
                 default:
                     reader.skipType(tag & 7);
                     break;
@@ -1351,6 +1358,7 @@ exports.QueryTLEMasterPublicKeyResponse = {
     fromPartial(object) {
         const message = createBaseQueryTLEMasterPublicKeyResponse();
         message.masterPublicKey = object.masterPublicKey ?? new Uint8Array();
+        message.masterPublicKeyG2 = object.masterPublicKeyG2 ?? new Uint8Array();
         return message;
     },
     fromAmino(object) {
@@ -1358,11 +1366,15 @@ exports.QueryTLEMasterPublicKeyResponse = {
         if (object.master_public_key !== undefined && object.master_public_key !== null) {
             message.masterPublicKey = (0, helpers_1.bytesFromBase64)(object.master_public_key);
         }
+        if (object.master_public_key_g2 !== undefined && object.master_public_key_g2 !== null) {
+            message.masterPublicKeyG2 = (0, helpers_1.bytesFromBase64)(object.master_public_key_g2);
+        }
         return message;
     },
     toAmino(message) {
         const obj = {};
         obj.master_public_key = message.masterPublicKey ? (0, helpers_1.base64FromBytes)(message.masterPublicKey) : undefined;
+        obj.master_public_key_g2 = message.masterPublicKeyG2 ? (0, helpers_1.base64FromBytes)(message.masterPublicKeyG2) : undefined;
         return obj;
     },
     fromAminoMsg(object) {

package/sparkdream/shield/v1/tx.d.ts

@@ -71,16 +71,22 @@ export interface MsgShieldedExec {
      */
     innerMessage?: Any;
     /**
-     * ZK proof bytes (PLONK over BN254).
-     * REQUIRED for IMMEDIATE mode, EMPTY for ENCRYPTED_BATCH mode.
+     * ZK proof bytes (Groth16 over BN254), always required. IMMEDIATE: the
+     * operation proof, bound to inner_message. ENCRYPTED_BATCH: the submission
+     * proof, bound to encrypted_payload (MessageHash =
+     * ShieldMessageHash(BatchSubmissionTypeURL, encrypted_payload), Scope =
+     * ScopeElement(BatchSubmissionDomain, BatchSubmissionScope(payload))); the
+     * operation proof travels inside the ciphertext.
      */
     proof: Uint8Array;
     /**
-     * 32-byte nullifier (prevents replay)
+     * 32-byte nullifier. IMMEDIATE: the operation nullifier (prevents replay).
+     * ENCRYPTED_BATCH: the submission nullifier (one per payload and member;
+     * the operation nullifier is inside the ciphertext).
      */
     nullifier: Uint8Array;
     /**
-     * 32-byte rate-limit nullifier: H(secret, "rate_limit", epoch)
+     * 32-byte rate-limit nullifier: MiMC(secret_key, MaxUint64, epoch)
      */
     rateLimitNullifier: Uint8Array;
     /**
@@ -100,7 +106,8 @@ export interface MsgShieldedExec {
      */
     execMode: ShieldExecMode;
     /**
-     * IBE-encrypted payload containing (inner_message + proof)
+     * IBE-encrypted payload containing (inner_message + operation proof +
+     * operation nullifier), see tools/tle.EncodeExecFragment
      * REQUIRED for ENCRYPTED_BATCH mode, EMPTY for IMMEDIATE mode
      */
     encryptedPayload: Uint8Array;
@@ -131,16 +138,22 @@ export interface MsgShieldedExecAmino {
      */
     inner_message?: AnyAmino;
     /**
-     * ZK proof bytes (PLONK over BN254).
-     * REQUIRED for IMMEDIATE mode, EMPTY for ENCRYPTED_BATCH mode.
+     * ZK proof bytes (Groth16 over BN254), always required. IMMEDIATE: the
+     * operation proof, bound to inner_message. ENCRYPTED_BATCH: the submission
+     * proof, bound to encrypted_payload (MessageHash =
+     * ShieldMessageHash(BatchSubmissionTypeURL, encrypted_payload), Scope =
+     * ScopeElement(BatchSubmissionDomain, BatchSubmissionScope(payload))); the
+     * operation proof travels inside the ciphertext.
      */
     proof?: string;
     /**
-     * 32-byte nullifier (prevents replay)
+     * 32-byte nullifier. IMMEDIATE: the operation nullifier (prevents replay).
+     * ENCRYPTED_BATCH: the submission nullifier (one per payload and member;
+     * the operation nullifier is inside the ciphertext).
      */
     nullifier?: string;
     /**
-     * 32-byte rate-limit nullifier: H(secret, "rate_limit", epoch)
+     * 32-byte rate-limit nullifier: MiMC(secret_key, MaxUint64, epoch)
      */
     rate_limit_nullifier?: string;
     /**
@@ -160,7 +173,8 @@ export interface MsgShieldedExecAmino {
      */
     exec_mode?: ShieldExecMode;
     /**
-     * IBE-encrypted payload containing (inner_message + proof)
+     * IBE-encrypted payload containing (inner_message + operation proof +
+     * operation nullifier), see tools/tle.EncodeExecFragment
      * REQUIRED for ENCRYPTED_BATCH mode, EMPTY for IMMEDIATE mode
      */
     encrypted_payload?: string;
@@ -219,7 +233,13 @@ export interface MsgShieldedExecResponseAminoMsg {
  */
 export interface MsgTriggerDkg {
     authority: string;
+    /**
+     * Optional threshold numerator (0 = default 2)
+     */
     thresholdNumerator: bigint;
+    /**
+     * Optional threshold denominator (0 = default 3)
+     */
     thresholdDenominator: bigint;
 }
 export interface MsgTriggerDkgProtoMsg {
@@ -234,7 +254,13 @@ export interface MsgTriggerDkgProtoMsg {
  */
 export interface MsgTriggerDkgAmino {
     authority?: string;
+    /**
+     * Optional threshold numerator (0 = default 2)
+     */
     threshold_numerator?: string;
+    /**
+     * Optional threshold denominator (0 = default 3)
+     */
     threshold_denominator?: string;
 }
 export interface MsgTriggerDkgAminoMsg {