@sparkdreamnft/sparkdreamjs 0.0.43 → 0.0.45

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

@@ -26,6 +26,23 @@ export declare enum NullifierScopeType {
 export declare const NullifierScopeTypeAmino: typeof NullifierScopeType;
 export declare function nullifierScopeTypeFromJSON(object: any): NullifierScopeType;
 export declare function nullifierScopeTypeToJSON(object: NullifierScopeType): string;
+/** NullifierMode controls what an operation's nullifier proves. */
+export declare enum NullifierMode {
+    /** NULLIFIER_MODE_CONSUME - The nullifier is consumed: each (member, scope) acts once. */
+    NULLIFIER_MODE_CONSUME = 0,
+    /**
+     * NULLIFIER_MODE_OWNERSHIP - The nullifier proves ownership of anonymously created content and is
+     * reused: the target module's ShieldOwnershipResolver supplies the owner's
+     * domain, scope and tag (the creation nullifier), the proof must reproduce
+     * the tag, and the owner's sequence (bound into the message hash) stops
+     * replays. Immediate mode only.
+     */
+    NULLIFIER_MODE_OWNERSHIP = 1,
+    UNRECOGNIZED = -1
+}
+export declare const NullifierModeAmino: typeof NullifierMode;
+export declare function nullifierModeFromJSON(object: any): NullifierMode;
+export declare function nullifierModeToJSON(object: NullifierMode): string;
 /** ShieldBatchMode controls which execution modes an operation supports. */
 export declare enum ShieldBatchMode {
     /** SHIELD_BATCH_MODE_IMMEDIATE_ONLY - Only immediate execution allowed */
@@ -56,8 +73,19 @@ export declare enum DKGPhase {
     DKG_PHASE_REGISTERING = 1,
     /** DKG_PHASE_CONTRIBUTING - Key registration closed; accepting Feldman DKG contributions */
     DKG_PHASE_CONTRIBUTING = 2,
-    /** DKG_PHASE_ACTIVE - DKG complete, master key available, encrypted batch enabled */
+    /** DKG_PHASE_ACTIVE - DKG complete, master key available */
     DKG_PHASE_ACTIVE = 3,
+    /**
+     * DKG_PHASE_COMPLAINING - Contributions closed; validators report dealers whose evaluation for
+     * them is missing, undecryptable or inconsistent with the commitments
+     */
+    DKG_PHASE_COMPLAINING = 4,
+    /**
+     * DKG_PHASE_JUSTIFYING - Complaints closed; accused dealers publish the disputed evaluations in
+     * clear. A dealer with an unjustified complaint at the deadline is
+     * disqualified from the key set.
+     */
+    DKG_PHASE_JUSTIFYING = 5,
     UNRECOGNIZED = -1
 }
 export declare const DKGPhaseAmino: typeof DKGPhase;
@@ -104,6 +132,20 @@ export interface ShieldedOpRegistration {
      * Must refer to a uint64 field in the inner message
      */
     scopeFieldPath: string;
+    /**
+     * What the nullifier proves: a consumed one-time action (default) or
+     * ownership of anonymously created content. OWNERSHIP ignores
+     * nullifier_scope_type and scope_field_path (the target module supplies the
+     * owner's scope) and requires batch_mode IMMEDIATE_ONLY.
+     */
+    nullifierMode: NullifierMode;
+    /**
+     * For NULLIFIER_SCOPE_EPOCH: the scope is current_epoch / epoch_window, so
+     * each member gets one action per window of this many shield epochs instead
+     * of one per epoch. 0 or 1 = every epoch. Must be 0 or 1 for other scope
+     * types and for ownership ops.
+     */
+    epochWindow: bigint;
 }
 export interface ShieldedOpRegistrationProtoMsg {
     typeUrl: "/sparkdream.shield.v1.ShieldedOpRegistration";
@@ -150,6 +192,20 @@ export interface ShieldedOpRegistrationAmino {
      * Must refer to a uint64 field in the inner message
      */
     scope_field_path?: string;
+    /**
+     * What the nullifier proves: a consumed one-time action (default) or
+     * ownership of anonymously created content. OWNERSHIP ignores
+     * nullifier_scope_type and scope_field_path (the target module supplies the
+     * owner's scope) and requires batch_mode IMMEDIATE_ONLY.
+     */
+    nullifier_mode?: NullifierMode;
+    /**
+     * For NULLIFIER_SCOPE_EPOCH: the scope is current_epoch / epoch_window, so
+     * each member gets one action per window of this many shield epochs instead
+     * of one per epoch. 0 or 1 = every epoch. Must be 0 or 1 for other scope
+     * types and for ownership ops.
+     */
+    epoch_window?: string;
 }
 export interface ShieldedOpRegistrationAminoMsg {
     type: "/sparkdream.shield.v1.ShieldedOpRegistration";
@@ -191,7 +247,7 @@ export interface UsedNullifierAminoMsg {
 }
 /**
  * DayFunding tracks funding per day to enforce the daily cap.
- * Day is calculated as block_height / 14400 (at 6s/block = 1 day).
+ * Day is the UTC day of the block time (block_time / 86400).
  * @name DayFunding
  * @package sparkdream.shield.v1
  * @see proto type: sparkdream.shield.v1.DayFunding
@@ -206,7 +262,7 @@ export interface DayFundingProtoMsg {
 }
 /**
  * DayFunding tracks funding per day to enforce the daily cap.
- * Day is calculated as block_height / 14400 (at 6s/block = 1 day).
+ * Day is the UTC day of the block time (block_time / 86400).
  * @name DayFundingAmino
  * @package sparkdream.shield.v1
  * @see proto type: sparkdream.shield.v1.DayFunding
@@ -220,7 +276,8 @@ export interface DayFundingAminoMsg {
     value: DayFundingAmino;
 }
 /**
- * PendingShieldedOp is stored in queue until the shield epoch boundary triggers batch execution.
+ * PendingShieldedOp is stored in queue until its epoch has closed, its batch was
+ * demanded and the epoch key exists; it then executes in that block.
  * @name PendingShieldedOp
  * @package sparkdream.shield.v1
  * @see proto type: sparkdream.shield.v1.PendingShieldedOp
@@ -228,20 +285,32 @@ export interface DayFundingAminoMsg {
 export interface PendingShieldedOp {
     id: bigint;
     targetEpoch: bigint;
-    nullifier: Uint8Array;
+    /**
+     * Submission nullifier proven at submission: MiMC(secret, ScopeElement(
+     * BatchSubmissionDomain, BatchSubmissionScope(encrypted_payload))). One per
+     * payload and member; it deduplicates submissions and is unrelated to the
+     * operation's own nullifier, which travels inside the ciphertext.
+     */
+    submissionNullifier: Uint8Array;
     merkleRoot: Uint8Array;
     proofDomain: ProofDomain;
     minTrustLevel: number;
     encryptedPayload: Uint8Array;
     submittedAtHeight: bigint;
     submittedAtEpoch: bigint;
+    /**
+     * Rate-limit nullifier proven by the submission proof (same member, same
+     * epoch); the decrypted operation proof must reproduce it.
+     */
+    rateLimitNullifier: Uint8Array;
 }
 export interface PendingShieldedOpProtoMsg {
     typeUrl: "/sparkdream.shield.v1.PendingShieldedOp";
     value: Uint8Array;
 }
 /**
- * PendingShieldedOp is stored in queue until the shield epoch boundary triggers batch execution.
+ * PendingShieldedOp is stored in queue until its epoch has closed, its batch was
+ * demanded and the epoch key exists; it then executes in that block.
  * @name PendingShieldedOpAmino
  * @package sparkdream.shield.v1
  * @see proto type: sparkdream.shield.v1.PendingShieldedOp
@@ -249,13 +318,24 @@ export interface PendingShieldedOpProtoMsg {
 export interface PendingShieldedOpAmino {
     id?: string;
     target_epoch?: string;
-    nullifier?: string;
+    /**
+     * Submission nullifier proven at submission: MiMC(secret, ScopeElement(
+     * BatchSubmissionDomain, BatchSubmissionScope(encrypted_payload))). One per
+     * payload and member; it deduplicates submissions and is unrelated to the
+     * operation's own nullifier, which travels inside the ciphertext.
+     */
+    submission_nullifier?: string;
     merkle_root?: string;
     proof_domain?: ProofDomain;
     min_trust_level?: number;
     encrypted_payload?: string;
     submitted_at_height?: string;
     submitted_at_epoch?: string;
+    /**
+     * Rate-limit nullifier proven by the submission proof (same member, same
+     * epoch); the decrypted operation proof must reproduce it.
+     */
+    rate_limit_nullifier?: string;
 }
 export interface PendingShieldedOpAminoMsg {
     type: "/sparkdream.shield.v1.PendingShieldedOp";
@@ -384,6 +464,12 @@ export interface TLEKeySet {
     thresholdDenominator: bigint;
     validatorShares: TLEValidatorPublicShare[];
     createdAtHeight: bigint;
+    /**
+     * BN256 G2 point s*G2: what clients encrypt to (tools/tle). The G1 key
+     * above cannot be encrypted to on a type-3 pairing; it stays for share
+     * bookkeeping.
+     */
+    masterPublicKeyG2: Uint8Array;
 }
 export interface TLEKeySetProtoMsg {
     typeUrl: "/sparkdream.shield.v1.TLEKeySet";
@@ -410,6 +496,12 @@ export interface TLEKeySetAmino {
     threshold_denominator?: string;
     validator_shares?: TLEValidatorPublicShareAmino[];
     created_at_height?: string;
+    /**
+     * BN256 G2 point s*G2: what clients encrypt to (tools/tle). The G1 key
+     * above cannot be encrypted to on a type-3 pairing; it stays for share
+     * bookkeeping.
+     */
+    master_public_key_g2?: string;
 }
 export interface TLEKeySetAminoMsg {
     type: "/sparkdream.shield.v1.TLEKeySet";
@@ -498,13 +590,29 @@ export interface DKGState {
     thresholdNumerator: bigint;
     thresholdDenominator: bigint;
     /**
-     * Snapshot of bonded validator addresses at DKG start
+     * DKG participants, 1-based Shamir index = position + 1. Snapshot of the
+     * bonded set at open; narrowed to the validators that registered a key
+     * when CONTRIBUTING starts (a validator without a registered key could
+     * never receive its evaluations).
      */
     expectedValidators: string[];
     /**
      * Number of contributions received so far
      */
     contributionsReceived: bigint;
+    /**
+     * Block height when COMPLAINING ends and JUSTIFYING starts
+     */
+    complaintDeadline: bigint;
+    /**
+     * Block height when JUSTIFYING ends and the key set is aggregated
+     */
+    justificationDeadline: bigint;
+    /**
+     * Dealers excluded from aggregation: a complaint against them stood
+     * unjustified at the justification deadline.
+     */
+    disqualifiedDealers: string[];
 }
 export interface DKGStateProtoMsg {
     typeUrl: "/sparkdream.shield.v1.DKGState";
@@ -543,13 +651,29 @@ export interface DKGStateAmino {
     threshold_numerator?: string;
     threshold_denominator?: string;
     /**
-     * Snapshot of bonded validator addresses at DKG start
+     * DKG participants, 1-based Shamir index = position + 1. Snapshot of the
+     * bonded set at open; narrowed to the validators that registered a key
+     * when CONTRIBUTING starts (a validator without a registered key could
+     * never receive its evaluations).
      */
     expected_validators?: string[];
     /**
      * Number of contributions received so far
      */
     contributions_received?: string;
+    /**
+     * Block height when COMPLAINING ends and JUSTIFYING starts
+     */
+    complaint_deadline?: string;
+    /**
+     * Block height when JUSTIFYING ends and the key set is aggregated
+     */
+    justification_deadline?: string;
+    /**
+     * Dealers excluded from aggregation: a complaint against them stood
+     * unjustified at the justification deadline.
+     */
+    disqualified_dealers?: string[];
 }
 export interface DKGStateAminoMsg {
     type: "/sparkdream.shield.v1.DKGState";
@@ -758,6 +882,18 @@ export interface DKGVoteExtension {
      * Epoch decryption share: secret_share_i * H_to_G1(epoch)
      */
     decryptionShare: Uint8Array;
+    /**
+     * --- COMPLAINING phase data ---
+     * 1-based indices of dealers whose evaluation for this validator is
+     * missing, does not decrypt, or does not match their commitments
+     */
+    complaints: number[];
+    /**
+     * --- JUSTIFYING phase data ---
+     * The dealer's answers to complaints against it: the disputed evaluations
+     * in clear, verifiable against its Feldman commitments
+     */
+    justifications: DKGJustification[];
 }
 export interface DKGVoteExtensionProtoMsg {
     typeUrl: "/sparkdream.shield.v1.DKGVoteExtension";
@@ -814,11 +950,105 @@ export interface DKGVoteExtensionAmino {
      * Epoch decryption share: secret_share_i * H_to_G1(epoch)
      */
     decryption_share?: string;
+    /**
+     * --- COMPLAINING phase data ---
+     * 1-based indices of dealers whose evaluation for this validator is
+     * missing, does not decrypt, or does not match their commitments
+     */
+    complaints?: number[];
+    /**
+     * --- JUSTIFYING phase data ---
+     * The dealer's answers to complaints against it: the disputed evaluations
+     * in clear, verifiable against its Feldman commitments
+     */
+    justifications?: DKGJustificationAmino[];
 }
 export interface DKGVoteExtensionAminoMsg {
     type: "/sparkdream.shield.v1.DKGVoteExtension";
     value: DKGVoteExtensionAmino;
 }
+/**
+ * DKGJustification is a dealer's public answer to a complaint: p_i(j) for the
+ * complaining validator j, which anyone checks against the dealer's Feldman
+ * commitments.
+ * @name DKGJustification
+ * @package sparkdream.shield.v1
+ * @see proto type: sparkdream.shield.v1.DKGJustification
+ */
+export interface DKGJustification {
+    /**
+     * 1-based index of the complaining validator
+     */
+    complainerIndex: number;
+    /**
+     * p_i(complainer_index) as a BN256 scalar
+     */
+    evaluation: Uint8Array;
+}
+export interface DKGJustificationProtoMsg {
+    typeUrl: "/sparkdream.shield.v1.DKGJustification";
+    value: Uint8Array;
+}
+/**
+ * DKGJustification is a dealer's public answer to a complaint: p_i(j) for the
+ * complaining validator j, which anyone checks against the dealer's Feldman
+ * commitments.
+ * @name DKGJustificationAmino
+ * @package sparkdream.shield.v1
+ * @see proto type: sparkdream.shield.v1.DKGJustification
+ */
+export interface DKGJustificationAmino {
+    /**
+     * 1-based index of the complaining validator
+     */
+    complainer_index?: number;
+    /**
+     * p_i(complainer_index) as a BN256 scalar
+     */
+    evaluation?: string;
+}
+export interface DKGJustificationAminoMsg {
+    type: "/sparkdream.shield.v1.DKGJustification";
+    value: DKGJustificationAmino;
+}
+/**
+ * DKGComplaint records a complaint by complainer_address against
+ * dealer_address in the current round and, once the dealer answers with a
+ * valid evaluation, that evaluation (the complainer uses it in place of the
+ * ciphertext it could not open).
+ * @name DKGComplaint
+ * @package sparkdream.shield.v1
+ * @see proto type: sparkdream.shield.v1.DKGComplaint
+ */
+export interface DKGComplaint {
+    dealerAddress: string;
+    complainerAddress: string;
+    justified: boolean;
+    evaluation: Uint8Array;
+}
+export interface DKGComplaintProtoMsg {
+    typeUrl: "/sparkdream.shield.v1.DKGComplaint";
+    value: Uint8Array;
+}
+/**
+ * DKGComplaint records a complaint by complainer_address against
+ * dealer_address in the current round and, once the dealer answers with a
+ * valid evaluation, that evaluation (the complainer uses it in place of the
+ * ciphertext it could not open).
+ * @name DKGComplaintAmino
+ * @package sparkdream.shield.v1
+ * @see proto type: sparkdream.shield.v1.DKGComplaint
+ */
+export interface DKGComplaintAmino {
+    dealer_address?: string;
+    complainer_address?: string;
+    justified?: boolean;
+    evaluation?: string;
+}
+export interface DKGComplaintAminoMsg {
+    type: "/sparkdream.shield.v1.DKGComplaint";
+    value: DKGComplaintAmino;
+}
 /**
  * InjectedDKGData is the aggregated shield data injected by the block proposer
  * as a pseudo-transaction at position 0 of the block.
@@ -983,7 +1213,7 @@ export interface VerificationKey {
      */
     circuitId: string;
     /**
-     * serialized Groth16/PLONK verification key
+     * serialized Groth16 verification key
      */
     vkBytes: Uint8Array;
     description: string;
@@ -1004,7 +1234,7 @@ export interface VerificationKeyAmino {
      */
     circuit_id?: string;
     /**
-     * serialized Groth16/PLONK verification key
+     * serialized Groth16 verification key
      */
     vk_bytes?: string;
     description?: string;
@@ -1071,6 +1301,38 @@ export interface TLEMissCounterEntryAminoMsg {
     type: "/sparkdream.shield.v1.TLEMissCounterEntry";
     value: TLEMissCounterEntryAmino;
 }
+/**
+ * DecryptionDemandEntry records that the EndBlocker asked validators for
+ * decryption shares of a closed epoch (its batch became ready) at a height.
+ * TLE liveness for that epoch is judged one full epoch interval later.
+ * @name DecryptionDemandEntry
+ * @package sparkdream.shield.v1
+ * @see proto type: sparkdream.shield.v1.DecryptionDemandEntry
+ */
+export interface DecryptionDemandEntry {
+    epoch: bigint;
+    height: bigint;
+}
+export interface DecryptionDemandEntryProtoMsg {
+    typeUrl: "/sparkdream.shield.v1.DecryptionDemandEntry";
+    value: Uint8Array;
+}
+/**
+ * DecryptionDemandEntry records that the EndBlocker asked validators for
+ * decryption shares of a closed epoch (its batch became ready) at a height.
+ * TLE liveness for that epoch is judged one full epoch interval later.
+ * @name DecryptionDemandEntryAmino
+ * @package sparkdream.shield.v1
+ * @see proto type: sparkdream.shield.v1.DecryptionDemandEntry
+ */
+export interface DecryptionDemandEntryAmino {
+    epoch?: string;
+    height?: string;
+}
+export interface DecryptionDemandEntryAminoMsg {
+    type: "/sparkdream.shield.v1.DecryptionDemandEntry";
+    value: DecryptionDemandEntryAmino;
+}
 /**
  * ShieldedOpRegistration defines a registered shielded operation.
  * @name ShieldedOpRegistration
@@ -1110,7 +1372,7 @@ export declare const UsedNullifier: {
 };
 /**
  * DayFunding tracks funding per day to enforce the daily cap.
- * Day is calculated as block_height / 14400 (at 6s/block = 1 day).
+ * Day is the UTC day of the block time (block_time / 86400).
  * @name DayFunding
  * @package sparkdream.shield.v1
  * @see proto type: sparkdream.shield.v1.DayFunding
@@ -1128,7 +1390,8 @@ export declare const DayFunding: {
     toProtoMsg(message: DayFunding): DayFundingProtoMsg;
 };
 /**
- * PendingShieldedOp is stored in queue until the shield epoch boundary triggers batch execution.
+ * PendingShieldedOp is stored in queue until its epoch has closed, its batch was
+ * demanded and the epoch key exists; it then executes in that block.
  * @name PendingShieldedOp
  * @package sparkdream.shield.v1
  * @see proto type: sparkdream.shield.v1.PendingShieldedOp
@@ -1326,6 +1589,47 @@ export declare const DKGVoteExtension: {
     toProto(message: DKGVoteExtension): Uint8Array;
     toProtoMsg(message: DKGVoteExtension): DKGVoteExtensionProtoMsg;
 };
+/**
+ * DKGJustification is a dealer's public answer to a complaint: p_i(j) for the
+ * complaining validator j, which anyone checks against the dealer's Feldman
+ * commitments.
+ * @name DKGJustification
+ * @package sparkdream.shield.v1
+ * @see proto type: sparkdream.shield.v1.DKGJustification
+ */
+export declare const DKGJustification: {
+    typeUrl: string;
+    encode(message: DKGJustification, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): DKGJustification;
+    fromPartial(object: DeepPartial<DKGJustification>): DKGJustification;
+    fromAmino(object: DKGJustificationAmino): DKGJustification;
+    toAmino(message: DKGJustification): DKGJustificationAmino;
+    fromAminoMsg(object: DKGJustificationAminoMsg): DKGJustification;
+    fromProtoMsg(message: DKGJustificationProtoMsg): DKGJustification;
+    toProto(message: DKGJustification): Uint8Array;
+    toProtoMsg(message: DKGJustification): DKGJustificationProtoMsg;
+};
+/**
+ * DKGComplaint records a complaint by complainer_address against
+ * dealer_address in the current round and, once the dealer answers with a
+ * valid evaluation, that evaluation (the complainer uses it in place of the
+ * ciphertext it could not open).
+ * @name DKGComplaint
+ * @package sparkdream.shield.v1
+ * @see proto type: sparkdream.shield.v1.DKGComplaint
+ */
+export declare const DKGComplaint: {
+    typeUrl: string;
+    encode(message: DKGComplaint, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): DKGComplaint;
+    fromPartial(object: DeepPartial<DKGComplaint>): DKGComplaint;
+    fromAmino(object: DKGComplaintAmino): DKGComplaint;
+    toAmino(message: DKGComplaint): DKGComplaintAmino;
+    fromAminoMsg(object: DKGComplaintAminoMsg): DKGComplaint;
+    fromProtoMsg(message: DKGComplaintProtoMsg): DKGComplaint;
+    toProto(message: DKGComplaint): Uint8Array;
+    toProtoMsg(message: DKGComplaint): DKGComplaintProtoMsg;
+};
 /**
  * InjectedDKGData is the aggregated shield data injected by the block proposer
  * as a pseudo-transaction at position 0 of the block.
@@ -1438,3 +1742,23 @@ export declare const TLEMissCounterEntry: {
     toProto(message: TLEMissCounterEntry): Uint8Array;
     toProtoMsg(message: TLEMissCounterEntry): TLEMissCounterEntryProtoMsg;
 };
+/**
+ * DecryptionDemandEntry records that the EndBlocker asked validators for
+ * decryption shares of a closed epoch (its batch became ready) at a height.
+ * TLE liveness for that epoch is judged one full epoch interval later.
+ * @name DecryptionDemandEntry
+ * @package sparkdream.shield.v1
+ * @see proto type: sparkdream.shield.v1.DecryptionDemandEntry
+ */
+export declare const DecryptionDemandEntry: {
+    typeUrl: string;
+    encode(message: DecryptionDemandEntry, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): DecryptionDemandEntry;
+    fromPartial(object: DeepPartial<DecryptionDemandEntry>): DecryptionDemandEntry;
+    fromAmino(object: DecryptionDemandEntryAmino): DecryptionDemandEntry;
+    toAmino(message: DecryptionDemandEntry): DecryptionDemandEntryAmino;
+    fromAminoMsg(object: DecryptionDemandEntryAminoMsg): DecryptionDemandEntry;
+    fromProtoMsg(message: DecryptionDemandEntryProtoMsg): DecryptionDemandEntry;
+    toProto(message: DecryptionDemandEntry): Uint8Array;
+    toProtoMsg(message: DecryptionDemandEntry): DecryptionDemandEntryProtoMsg;
+};