@sparkdreamnft/sparkdreamjs 0.0.44 → 0.0.46

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;
     /**
@@ -88,6 +88,12 @@ export interface Params {
      * 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";
@@ -105,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;
     /**
@@ -165,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;
     /**
@@ -181,6 +187,12 @@ export interface ParamsAmino {
      * 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

@@ -23,7 +23,8 @@ function createBaseParams() {
         minTleValidators: 0,
         dkgWindowBlocks: BigInt(0),
         maxValidatorSetDrift: 0,
-        maxFeePerExec: ""
+        maxFeePerExec: "",
+        enableBatchAfterDkg: false
     };
 }
 /**
@@ -93,6 +94,9 @@ exports.Params = {
         if (message.maxFeePerExec !== "") {
             writer.uint32(154).string(message.maxFeePerExec);
         }
+        if (message.enableBatchAfterDkg === true) {
+            writer.uint32(160).bool(message.enableBatchAfterDkg);
+        }
         return writer;
     },
     decode(input, length) {
@@ -159,6 +163,9 @@ exports.Params = {
                 case 19:
                     message.maxFeePerExec = reader.string();
                     break;
+                case 20:
+                    message.enableBatchAfterDkg = reader.bool();
+                    break;
                 default:
                     reader.skipType(tag & 7);
                     break;
@@ -187,6 +194,7 @@ exports.Params = {
         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) {
@@ -248,6 +256,9 @@ exports.Params = {
         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) {
@@ -271,6 +282,7 @@ exports.Params = {
         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 (Groth16 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 (Groth16 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 {