@sparkdreamnft/sparkdreamjs 0.0.36 → 0.0.38

package/sparkdream/rep/v1/bonded_role.js

@@ -371,7 +371,10 @@ function createBaseBondedRoleConfig() {
         minAgeBlocks: BigInt(0),
         demotionCooldown: BigInt(0),
         demotionThreshold: "",
-        unbondCooldown: BigInt(0)
+        unbondCooldown: BigInt(0),
+        upheldToResetOverturns: BigInt(0),
+        overturnBaseCooldown: BigInt(0),
+        overturnCooldownEscalates: false
     };
 }
 /**
@@ -414,6 +417,15 @@ exports.BondedRoleConfig = {
         if (message.unbondCooldown !== BigInt(0)) {
             writer.uint32(64).int64(message.unbondCooldown);
         }
+        if (message.upheldToResetOverturns !== BigInt(0)) {
+            writer.uint32(72).uint64(message.upheldToResetOverturns);
+        }
+        if (message.overturnBaseCooldown !== BigInt(0)) {
+            writer.uint32(80).int64(message.overturnBaseCooldown);
+        }
+        if (message.overturnCooldownEscalates === true) {
+            writer.uint32(88).bool(message.overturnCooldownEscalates);
+        }
         return writer;
     },
     decode(input, length) {
@@ -447,6 +459,15 @@ exports.BondedRoleConfig = {
                 case 8:
                     message.unbondCooldown = reader.int64();
                     break;
+                case 9:
+                    message.upheldToResetOverturns = reader.uint64();
+                    break;
+                case 10:
+                    message.overturnBaseCooldown = reader.int64();
+                    break;
+                case 11:
+                    message.overturnCooldownEscalates = reader.bool();
+                    break;
                 default:
                     reader.skipType(tag & 7);
                     break;
@@ -464,6 +485,9 @@ exports.BondedRoleConfig = {
         message.demotionCooldown = object.demotionCooldown !== undefined && object.demotionCooldown !== null ? BigInt(object.demotionCooldown.toString()) : BigInt(0);
         message.demotionThreshold = object.demotionThreshold ?? "";
         message.unbondCooldown = object.unbondCooldown !== undefined && object.unbondCooldown !== null ? BigInt(object.unbondCooldown.toString()) : BigInt(0);
+        message.upheldToResetOverturns = object.upheldToResetOverturns !== undefined && object.upheldToResetOverturns !== null ? BigInt(object.upheldToResetOverturns.toString()) : BigInt(0);
+        message.overturnBaseCooldown = object.overturnBaseCooldown !== undefined && object.overturnBaseCooldown !== null ? BigInt(object.overturnBaseCooldown.toString()) : BigInt(0);
+        message.overturnCooldownEscalates = object.overturnCooldownEscalates ?? false;
         return message;
     },
     fromAmino(object) {
@@ -492,6 +516,15 @@ exports.BondedRoleConfig = {
         if (object.unbond_cooldown !== undefined && object.unbond_cooldown !== null) {
             message.unbondCooldown = BigInt(object.unbond_cooldown);
         }
+        if (object.upheld_to_reset_overturns !== undefined && object.upheld_to_reset_overturns !== null) {
+            message.upheldToResetOverturns = BigInt(object.upheld_to_reset_overturns);
+        }
+        if (object.overturn_base_cooldown !== undefined && object.overturn_base_cooldown !== null) {
+            message.overturnBaseCooldown = BigInt(object.overturn_base_cooldown);
+        }
+        if (object.overturn_cooldown_escalates !== undefined && object.overturn_cooldown_escalates !== null) {
+            message.overturnCooldownEscalates = object.overturn_cooldown_escalates;
+        }
         return message;
     },
     toAmino(message) {
@@ -504,6 +537,9 @@ exports.BondedRoleConfig = {
         obj.demotion_cooldown = message.demotionCooldown !== BigInt(0) ? message.demotionCooldown?.toString() : undefined;
         obj.demotion_threshold = message.demotionThreshold === "" ? undefined : message.demotionThreshold;
         obj.unbond_cooldown = message.unbondCooldown !== BigInt(0) ? message.unbondCooldown?.toString() : undefined;
+        obj.upheld_to_reset_overturns = message.upheldToResetOverturns !== BigInt(0) ? message.upheldToResetOverturns?.toString() : undefined;
+        obj.overturn_base_cooldown = message.overturnBaseCooldown !== BigInt(0) ? message.overturnBaseCooldown?.toString() : undefined;
+        obj.overturn_cooldown_escalates = message.overturnCooldownEscalates === false ? undefined : message.overturnCooldownEscalates;
         return obj;
     },
     fromAminoMsg(object) {

package/sparkdream/rep/v1/initiative.d.ts

@@ -35,13 +35,15 @@ export declare enum InitiativeStatus {
     INITIATIVE_STATUS_CHALLENGED = 4,
     INITIATIVE_STATUS_COMPLETED = 5,
     INITIATIVE_STATUS_REJECTED = 6,
-    INITIATIVE_STATUS_ABANDONED = 7,
     /**
-     * INITIATIVE_STATUS_CANCELLED - Retired by the project creator (or Operations Committee) while still
-     * OPEN and unassigned. Distinct from ABANDONED, which records an assignee
-     * walking away from work they had taken on.
+     * INITIATIVE_STATUS_CLOSED - Retired by the project creator or the Operations Committee. The work is
+     * not being done and its budget has gone back to the project.
+     *
+     * Distinct from COMPLETED, which is narrower: COMPLETED means the work was
+     * delivered, passed its gates and paid out. CLOSED carries no claim about
+     * the work at all, only that the project stopped funding it.
      */
-    INITIATIVE_STATUS_CANCELLED = 8,
+    INITIATIVE_STATUS_CLOSED = 7,
     UNRECOGNIZED = -1
 }
 export declare const InitiativeStatusAmino: typeof InitiativeStatus;

package/sparkdream/rep/v1/initiative.js

@@ -146,13 +146,15 @@ var InitiativeStatus;
     InitiativeStatus[InitiativeStatus["INITIATIVE_STATUS_CHALLENGED"] = 4] = "INITIATIVE_STATUS_CHALLENGED";
     InitiativeStatus[InitiativeStatus["INITIATIVE_STATUS_COMPLETED"] = 5] = "INITIATIVE_STATUS_COMPLETED";
     InitiativeStatus[InitiativeStatus["INITIATIVE_STATUS_REJECTED"] = 6] = "INITIATIVE_STATUS_REJECTED";
-    InitiativeStatus[InitiativeStatus["INITIATIVE_STATUS_ABANDONED"] = 7] = "INITIATIVE_STATUS_ABANDONED";
     /**
-     * INITIATIVE_STATUS_CANCELLED - Retired by the project creator (or Operations Committee) while still
-     * OPEN and unassigned. Distinct from ABANDONED, which records an assignee
-     * walking away from work they had taken on.
+     * INITIATIVE_STATUS_CLOSED - Retired by the project creator or the Operations Committee. The work is
+     * not being done and its budget has gone back to the project.
+     *
+     * Distinct from COMPLETED, which is narrower: COMPLETED means the work was
+     * delivered, passed its gates and paid out. CLOSED carries no claim about
+     * the work at all, only that the project stopped funding it.
      */
-    InitiativeStatus[InitiativeStatus["INITIATIVE_STATUS_CANCELLED"] = 8] = "INITIATIVE_STATUS_CANCELLED";
+    InitiativeStatus[InitiativeStatus["INITIATIVE_STATUS_CLOSED"] = 7] = "INITIATIVE_STATUS_CLOSED";
     InitiativeStatus[InitiativeStatus["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
 })(InitiativeStatus || (exports.InitiativeStatus = InitiativeStatus = {}));
 exports.InitiativeStatusAmino = InitiativeStatus;
@@ -180,11 +182,8 @@ function initiativeStatusFromJSON(object) {
         case "INITIATIVE_STATUS_REJECTED":
             return InitiativeStatus.INITIATIVE_STATUS_REJECTED;
         case 7:
-        case "INITIATIVE_STATUS_ABANDONED":
-            return InitiativeStatus.INITIATIVE_STATUS_ABANDONED;
-        case 8:
-        case "INITIATIVE_STATUS_CANCELLED":
-            return InitiativeStatus.INITIATIVE_STATUS_CANCELLED;
+        case "INITIATIVE_STATUS_CLOSED":
+            return InitiativeStatus.INITIATIVE_STATUS_CLOSED;
         case -1:
         case "UNRECOGNIZED":
         default:
@@ -207,10 +206,8 @@ function initiativeStatusToJSON(object) {
             return "INITIATIVE_STATUS_COMPLETED";
         case InitiativeStatus.INITIATIVE_STATUS_REJECTED:
             return "INITIATIVE_STATUS_REJECTED";
-        case InitiativeStatus.INITIATIVE_STATUS_ABANDONED:
-            return "INITIATIVE_STATUS_ABANDONED";
-        case InitiativeStatus.INITIATIVE_STATUS_CANCELLED:
-            return "INITIATIVE_STATUS_CANCELLED";
+        case InitiativeStatus.INITIATIVE_STATUS_CLOSED:
+            return "INITIATIVE_STATUS_CLOSED";
         case InitiativeStatus.UNRECOGNIZED:
         default:
             return "UNRECOGNIZED";

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

@@ -385,7 +385,10 @@ export interface Params {
     /**
      * External-conviction ratio applied instead of external_conviction_ratio when
      * the initiative is self-assigned. Must be >= external_conviction_ratio and
-     * <= 1. Default 1.0: the community alone vouches for self-assigned work.
+     * <= 1. Default 0.75 — a distinct-staker floor as much as a magnitude one,
+     * since max_conviction_share_per_member caps any one member's contribution:
+     * ceil(0.75 / 0.33) = 3 independent stakers, against 2 for externally
+     * assigned work.
      */
     selfAssignedExternalConvictionRatio: string;
     /**
@@ -549,6 +552,63 @@ export interface Params {
      * Epochs of history the accuracy ring scores. Default 6.
      */
     reviewerAccuracyWindowEpochs: bigint;
+    /**
+     * Reviewer bonded-role policy: the eligibility and exit terms for
+     * ROLE_TYPE_INITIATIVE_REVIEWER.
+     *
+     * These live here rather than only in the BondedRoleConfig store so the
+     * reviewer role has the same shape as every other bonded role: params are the
+     * source of truth and are written through to rep's enforcement state on
+     * InitGenesis and on every operational param update (x/forum does this for
+     * the sentinel, x/collect for the curator). Before that, the reviewer was the
+     * one role no module owned, so its config was reachable only by editing
+     * genesis or shipping an upgrade.
+     *
+     * Field numbers jump past the reviewer pay knobs above because these were
+     * added later; they belong to this block by topic, not by number.
+     *
+     * min_reviewer_bond is deliberately a LOW barrier to entry (500 DREAM), not a
+     * measure of what a bad verdict costs. Per-verdict exposure is the reserve --
+     * SlashReviewersOnOverturn charges BondReserved, which is
+     * reviewer_bond_reserve_rate x the initiative's budget -- so liability already
+     * scales with what the review could mint, whatever the floor is.
+     *
+     * Reviewers scale up by bonding more when they want bigger work. Free bond
+     * above a reviewer's open reserves is what decides which initiatives they can
+     * pick up and how many at once: at the default 10% rate the floor alone covers
+     * work up to ~5,000 DREAM of budget, while an EPIC initiative (10,000 cap)
+     * reserves 1,000. Raising the ceiling is just another MsgBondRole against the
+     * same record -- it adds to current_bond and is reservable on the next verdict,
+     * with no waiting period and no need to unbond first. Keeping the entry price
+     * low is the point: reviewing should be something an ordinary member can start
+     * doing and then grow into, rather than something gated on holding a large
+     * balance up front.
+     */
+    minReviewerBond: string;
+    /**
+     * Free bond below which a reviewer is demoted out of the role. Conventionally
+     * half of min_reviewer_bond.
+     */
+    reviewerDemotionThreshold: string;
+    /**
+     * Trust level a member must hold to bond as a reviewer. The trust ladder
+     * already encodes reputation, so this is the whole eligibility gate and
+     * min_reviewer_rep_tier stays 0 (see BondedRoleConfig seeding notes).
+     *
+     * Required, unlike the sentinel's and curator's: BondRole skips the trust
+     * check entirely on an empty string, so an omitted level would silently open
+     * the one role whose approvals mint DREAM. An ungated roster is still
+     * expressible as TRUST_LEVEL_NEW.
+     */
+    minReviewerTrustLevel: string;
+    minReviewerRepTier: bigint;
+    minReviewerAgeBlocks: bigint;
+    reviewerDemotionCooldown: bigint;
+    /**
+     * Bond stays slashable through this window after an unbond request, so open
+     * verdicts can age out and still be charged if a jury overturns them.
+     */
+    reviewerUnbondCooldown: bigint;
     /**
      * Ceiling on the uspark x/rep may draw from the community pool per UTC day to
      * fund its bonded-role reward pools.
@@ -643,6 +703,43 @@ export interface Params {
      * requirement entirely.
      */
     permissionlessMinReviewBountyRate: string;
+    /**
+     * --- Federation verifier pay (SPARK pool + DREAM stipend) ---
+     *
+     * The verifier's whole reward distribution lives here rather than in
+     * x/federation, for the same reason the curator's lives here rather than in
+     * x/collect: the accuracy it scores comes from the shared RoleActivity
+     * record x/rep owns, and the epoch it resets is the epoch the accuracy ring
+     * is stamped in. Two modules distributing on two independently-editable
+     * cadences would both reset those per-epoch counters and neither would read
+     * a coherent window. x/federation keeps the verification mechanics -- bond,
+     * slash, challenge windows, cooldown base -- and reports actions here.
+     *
+     * The verifier is the one bonded role whose work has an OFF-chain cost:
+     * fetching the peer's content and hashing it, then paying SPARK gas to
+     * submit. Paying only in DREAM made it the single role where doing the job
+     * drains the holder's SPARK and returns a token they cannot spend on gas.
+     */
+    maxVerifierRewardPool: string;
+    verifierRewardPoolOverflowBurnRatio: string;
+    verifierRewardEpochBlocks: bigint;
+    minVerifierAccuracy: string;
+    verifierAccuracyWindowEpochs: bigint;
+    /**
+     * Verified items required in an epoch to earn anything that epoch. This is
+     * the ONLY place volume enters verifier pay -- as a floor, never as a
+     * weight. See the score formula in x/rep/keeper/verifier_reward_distribution.go
+     * for why weighting by verified_count is the wrong curve for this role.
+     */
+    minEpochVerifications: number;
+    /**
+     * Flat DREAM minted per eligible verifier per epoch, scaled down pro-rata
+     * when the roster would push the epoch's total past the mint cap. Auto-bonds
+     * while the verifier is in RECOVERY so a slashed verifier can rebuild their
+     * bond by working rather than by fronting DREAM.
+     */
+    verifierDreamReward: string;
+    maxVerifierDreamMintPerEpoch: string;
 }
 export interface ParamsProtoMsg {
     typeUrl: "/sparkdream.rep.v1.Params";
@@ -943,7 +1040,10 @@ export interface ParamsAmino {
     /**
      * External-conviction ratio applied instead of external_conviction_ratio when
      * the initiative is self-assigned. Must be >= external_conviction_ratio and
-     * <= 1. Default 1.0: the community alone vouches for self-assigned work.
+     * <= 1. Default 0.75 — a distinct-staker floor as much as a magnitude one,
+     * since max_conviction_share_per_member caps any one member's contribution:
+     * ceil(0.75 / 0.33) = 3 independent stakers, against 2 for externally
+     * assigned work.
      */
     self_assigned_external_conviction_ratio?: string;
     /**
@@ -1107,6 +1207,63 @@ export interface ParamsAmino {
      * Epochs of history the accuracy ring scores. Default 6.
      */
     reviewer_accuracy_window_epochs?: string;
+    /**
+     * Reviewer bonded-role policy: the eligibility and exit terms for
+     * ROLE_TYPE_INITIATIVE_REVIEWER.
+     *
+     * These live here rather than only in the BondedRoleConfig store so the
+     * reviewer role has the same shape as every other bonded role: params are the
+     * source of truth and are written through to rep's enforcement state on
+     * InitGenesis and on every operational param update (x/forum does this for
+     * the sentinel, x/collect for the curator). Before that, the reviewer was the
+     * one role no module owned, so its config was reachable only by editing
+     * genesis or shipping an upgrade.
+     *
+     * Field numbers jump past the reviewer pay knobs above because these were
+     * added later; they belong to this block by topic, not by number.
+     *
+     * min_reviewer_bond is deliberately a LOW barrier to entry (500 DREAM), not a
+     * measure of what a bad verdict costs. Per-verdict exposure is the reserve --
+     * SlashReviewersOnOverturn charges BondReserved, which is
+     * reviewer_bond_reserve_rate x the initiative's budget -- so liability already
+     * scales with what the review could mint, whatever the floor is.
+     *
+     * Reviewers scale up by bonding more when they want bigger work. Free bond
+     * above a reviewer's open reserves is what decides which initiatives they can
+     * pick up and how many at once: at the default 10% rate the floor alone covers
+     * work up to ~5,000 DREAM of budget, while an EPIC initiative (10,000 cap)
+     * reserves 1,000. Raising the ceiling is just another MsgBondRole against the
+     * same record -- it adds to current_bond and is reservable on the next verdict,
+     * with no waiting period and no need to unbond first. Keeping the entry price
+     * low is the point: reviewing should be something an ordinary member can start
+     * doing and then grow into, rather than something gated on holding a large
+     * balance up front.
+     */
+    min_reviewer_bond?: string;
+    /**
+     * Free bond below which a reviewer is demoted out of the role. Conventionally
+     * half of min_reviewer_bond.
+     */
+    reviewer_demotion_threshold?: string;
+    /**
+     * Trust level a member must hold to bond as a reviewer. The trust ladder
+     * already encodes reputation, so this is the whole eligibility gate and
+     * min_reviewer_rep_tier stays 0 (see BondedRoleConfig seeding notes).
+     *
+     * Required, unlike the sentinel's and curator's: BondRole skips the trust
+     * check entirely on an empty string, so an omitted level would silently open
+     * the one role whose approvals mint DREAM. An ungated roster is still
+     * expressible as TRUST_LEVEL_NEW.
+     */
+    min_reviewer_trust_level?: string;
+    min_reviewer_rep_tier?: string;
+    min_reviewer_age_blocks?: string;
+    reviewer_demotion_cooldown?: string;
+    /**
+     * Bond stays slashable through this window after an unbond request, so open
+     * verdicts can age out and still be charged if a jury overturns them.
+     */
+    reviewer_unbond_cooldown?: string;
     /**
      * Ceiling on the uspark x/rep may draw from the community pool per UTC day to
      * fund its bonded-role reward pools.
@@ -1201,6 +1358,43 @@ export interface ParamsAmino {
      * requirement entirely.
      */
     permissionless_min_review_bounty_rate?: string;
+    /**
+     * --- Federation verifier pay (SPARK pool + DREAM stipend) ---
+     *
+     * The verifier's whole reward distribution lives here rather than in
+     * x/federation, for the same reason the curator's lives here rather than in
+     * x/collect: the accuracy it scores comes from the shared RoleActivity
+     * record x/rep owns, and the epoch it resets is the epoch the accuracy ring
+     * is stamped in. Two modules distributing on two independently-editable
+     * cadences would both reset those per-epoch counters and neither would read
+     * a coherent window. x/federation keeps the verification mechanics -- bond,
+     * slash, challenge windows, cooldown base -- and reports actions here.
+     *
+     * The verifier is the one bonded role whose work has an OFF-chain cost:
+     * fetching the peer's content and hashing it, then paying SPARK gas to
+     * submit. Paying only in DREAM made it the single role where doing the job
+     * drains the holder's SPARK and returns a token they cannot spend on gas.
+     */
+    max_verifier_reward_pool?: string;
+    verifier_reward_pool_overflow_burn_ratio?: string;
+    verifier_reward_epoch_blocks?: string;
+    min_verifier_accuracy?: string;
+    verifier_accuracy_window_epochs?: string;
+    /**
+     * Verified items required in an epoch to earn anything that epoch. This is
+     * the ONLY place volume enters verifier pay -- as a floor, never as a
+     * weight. See the score formula in x/rep/keeper/verifier_reward_distribution.go
+     * for why weighting by verified_count is the wrong curve for this role.
+     */
+    min_epoch_verifications?: number;
+    /**
+     * Flat DREAM minted per eligible verifier per epoch, scaled down pro-rata
+     * when the roster would push the epoch's total past the mint cap. Auto-bonds
+     * while the verifier is in RECOVERY so a slashed verifier can rebuild their
+     * bond by working rather than by fronting DREAM.
+     */
+    verifier_dream_reward?: string;
+    max_verifier_dream_mint_per_epoch?: string;
 }
 export interface ParamsAminoMsg {
     type: "sparkdream/x/rep/Params";
@@ -1477,6 +1671,29 @@ export interface RepOperationalParams {
     reviewRequiredAboveBudget: string;
     reviewBountyReclaimDelay: bigint;
     permissionlessMinReviewBountyRate: string;
+    /**
+     * Mirrors the federation-verifier pay params in Params.
+     */
+    maxVerifierRewardPool: string;
+    verifierRewardPoolOverflowBurnRatio: string;
+    verifierRewardEpochBlocks: bigint;
+    minVerifierAccuracy: string;
+    verifierAccuracyWindowEpochs: bigint;
+    minEpochVerifications: number;
+    verifierDreamReward: string;
+    maxVerifierDreamMintPerEpoch: string;
+    /**
+     * Mirrors the reviewer bonded-role policy in Params. Updating these writes
+     * through to the BondedRoleConfig for ROLE_TYPE_INITIATIVE_REVIEWER, so the
+     * reviewer bond floor is tunable by council vote like every other role's.
+     */
+    minReviewerBond: string;
+    reviewerDemotionThreshold: string;
+    minReviewerTrustLevel: string;
+    minReviewerRepTier: bigint;
+    minReviewerAgeBlocks: bigint;
+    reviewerDemotionCooldown: bigint;
+    reviewerUnbondCooldown: bigint;
 }
 export interface RepOperationalParamsProtoMsg {
     typeUrl: "/sparkdream.rep.v1.RepOperationalParams";
@@ -1753,6 +1970,29 @@ export interface RepOperationalParamsAmino {
     review_required_above_budget?: string;
     review_bounty_reclaim_delay?: string;
     permissionless_min_review_bounty_rate?: string;
+    /**
+     * Mirrors the federation-verifier pay params in Params.
+     */
+    max_verifier_reward_pool?: string;
+    verifier_reward_pool_overflow_burn_ratio?: string;
+    verifier_reward_epoch_blocks?: string;
+    min_verifier_accuracy?: string;
+    verifier_accuracy_window_epochs?: string;
+    min_epoch_verifications?: number;
+    verifier_dream_reward?: string;
+    max_verifier_dream_mint_per_epoch?: string;
+    /**
+     * Mirrors the reviewer bonded-role policy in Params. Updating these writes
+     * through to the BondedRoleConfig for ROLE_TYPE_INITIATIVE_REVIEWER, so the
+     * reviewer bond floor is tunable by council vote like every other role's.
+     */
+    min_reviewer_bond?: string;
+    reviewer_demotion_threshold?: string;
+    min_reviewer_trust_level?: string;
+    min_reviewer_rep_tier?: string;
+    min_reviewer_age_blocks?: string;
+    reviewer_demotion_cooldown?: string;
+    reviewer_unbond_cooldown?: string;
 }
 export interface RepOperationalParamsAminoMsg {
     type: "sparkdream/x/rep/RepOperationalParams";