@raac/rpc 1.2.0-beta.9 → 2.0.0-beta.1

package/dist/contracts/governance/gaugeController/getConstants.js

@@ -6,24 +6,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConstants = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Reads the immutable/constant configuration values from the GaugeController.
+ * Reads the constant configuration values from a GaugeController.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns An object with maxBoost, minBoost, weightPrecision, week, weightVoteDelay,
- *   minVoteWeight and maxVoteWeight, all bigint.
+ * @returns maxBoost and minBoost in basis points (10000 = 1x), weightPrecision (10000), week and weightVoteDelay in seconds, and minVoteWeight and maxVoteWeight in basis points (10000 = 100%).
  */
-const getConstants = async (chainId, provider) => {
+const getConstants = async (chainId, gaugeSystem, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
-    const [maxBoost, minBoost, weightPrecision, week, weightVoteDelay, minVoteWeight, maxVoteWeight,] = await Promise.all([
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const [maxBoost, minBoost, weightPrecision, week, weightVoteDelay, minVoteWeight, maxVoteWeight] = await Promise.all([
         contract.MAX_BOOST(),
         contract.MIN_BOOST(),
         contract.WEIGHT_PRECISION(),
@@ -32,14 +32,6 @@ const getConstants = async (chainId, provider) => {
         contract.MIN_VOTE_WEIGHT(),
         contract.MAX_VOTE_WEIGHT(),
     ]);
-    return {
-        maxBoost,
-        minBoost,
-        weightPrecision,
-        week,
-        weightVoteDelay,
-        minVoteWeight,
-        maxVoteWeight,
-    };
+    return { maxBoost, minBoost, weightPrecision, week, weightVoteDelay, minVoteWeight, maxVoteWeight };
 };
 exports.getConstants = getConstants;

package/dist/contracts/governance/gaugeController/getCurrentEpoch.js

@@ -6,22 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentEpoch = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the current epoch boundary (rounded down to the week) from the GaugeController.
+ * Returns the start timestamp of the controller's current epoch.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Current epoch timestamp as a bigint.
+ * @returns The current epoch timestamp, seconds.
  */
-const getCurrentEpoch = async (chainId, provider) => {
+const getCurrentEpoch = async (chainId, gaugeSystem, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
     return contract.getCurrentEpoch();
 };
 exports.getCurrentEpoch = getCurrentEpoch;

package/dist/contracts/governance/gaugeController/getExpiredGaugeVotePower.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExpiredGaugeVotePower = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the vote power a user still has assigned to gauges whose votes no longer count, because every lock backing the vote has decayed out by the next epoch. Free it by re-voting those gauges.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param user - Address of the voter.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The stale vote weight in basis points (10000 = 100%) and the gauges it sits on.
+ */
+const getExpiredGaugeVotePower = async (chainId, gaugeSystem, user, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const [expiredGaugePower, gauges] = await contract.getExpiredGaugeVotePower(user);
+    return { expiredGaugePower, gauges: [...gauges] };
+};
+exports.getExpiredGaugeVotePower = getExpiredGaugeVotePower;

package/dist/contracts/governance/gaugeController/getGauge.js

@@ -6,24 +6,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getGauge = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Reads the gauge config struct from the public `gauges` mapping on the GaugeController.
+ * Reads a gauge's entry from the controller's public `gauges` mapping.
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param provider - Optional ethers.js Provider instance.
- * @returns An object with isActive, isBoostAmplificationEnabled (booleans), weight and lastUpdateTime (bigint).
+ * @returns isActive and isBoostAmplificationEnabled flags, the stored weight (veRAAC voting power, base units) and lastUpdateTime.
  */
-const getGauge = async (chainId, gauge, provider) => {
+const getGauge = async (chainId, gaugeSystem, gaugeAddressOrId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
-    const [isActive, isBoostAmplificationEnabled, weight, lastUpdateTime] = await contract.gauges(gauge);
-    return { isActive, isBoostAmplificationEnabled, weight, lastUpdateTime };
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const [isActive, isBoostAmplificationEnabled, weight, lastUpdateTime] = await contract.gauges(gaugeAddress);
+    return { isActive, isBoostAmplificationEnabled, weight: (0, amount_1.toTokenAmount)(chainId, "veraac", weight), lastUpdateTime };
 };
 exports.getGauge = getGauge;

package/dist/contracts/governance/gaugeController/getGaugeDistributor.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeDistributor = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the GaugeRewardsDistributor wired to the controller.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The distributor address.
+ */
+const getGaugeDistributor = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    return contract.gaugeDistributor();
+};
+exports.getGaugeDistributor = getGaugeDistributor;

package/dist/contracts/governance/gaugeController/getGaugeEmissions.js

@@ -8,6 +8,8 @@ const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const amount_1 = require("../../../utils/amount");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 const E18 = 10n ** 18n;
 /**
  * Per-epoch emissions for a gauge. The GaugeController snapshots gauge weights per epoch
@@ -22,53 +24,59 @@ const E18 = 10n ** 18n;
  * where scheduledWeekEmission = minter.calculateScheduledMintableAmount(week) × distributorShare.
  *
  * @param chainId - The chain/network to use.
- * @param gauge - Gauge address (or config key).
- * @param numEpochs - How many epochs to include, ending at the current one (default 8).
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges").
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param numEpochs - How many epochs to include, ending at the current one (default 8), clamped to the gauge's start.
+ * @param includeUpcoming - Whether to append a projection for the next epoch (default true).
  * @param provider - Optional ethers.js Provider instance.
  */
-const getGaugeEmissions = async (chainId, gauge, numEpochs = 8, includeUpcoming = true, provider) => {
+const getGaugeEmissions = async (chainId, gaugeSystem, gaugeAddressOrId, numEpochs = 8, includeUpcoming = true, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const controller = new ethers_1.ethers.Contract((0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller"), (0, artifacts_1.getABI)("gaugecontroller"), provider);
-    const distributor = new ethers_1.ethers.Contract((0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor"), (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
-    const [weekBn, currentEpochBn, startEpochBn, rewardToken] = await Promise.all([
+    const gauge = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const distAddr = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const controller = new ethers_1.ethers.Contract((0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem), (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const distributor = new ethers_1.ethers.Contract(distAddr, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    const gaugeContract = new ethers_1.ethers.Contract(gauge, (0, artifacts_1.getABI)("basegauge"), provider);
+    const [weekBn, currentEpochBn, gaugeData, rewardToken] = await Promise.all([
         controller.WEEK(),
         controller.getCurrentEpoch(),
-        distributor.startEpoch(),
+        gaugeContract.gaugeData(),
         distributor.rewardToken(),
     ]);
     const week = BigInt(weekBn);
     const currentEpoch = BigInt(currentEpochBn);
-    const startEpoch = BigInt(startEpochBn) > 0n ? BigInt(startEpochBn) : currentEpoch;
+    const gaugeStart = BigInt(gaugeData.gaugeInitialStartTime ?? gaugeData[0] ?? 0n);
+    const startEpoch = gaugeStart > 0n ? (gaugeStart / week) * week : currentEpoch;
     // ── Distributor's share of the minter + scheduled-emission helper ─────────
     // The schedule deterministically sets each week's system emission, so we use it for
     // the in-progress and upcoming epochs (where depositedAtEpoch is partial/zero).
-    let distShare = 0n; // 1e18-scaled fraction of the minter routed to the distributor
-    let minter = null;
-    try {
-        minter = new ethers_1.ethers.Contract((0, getContractAddress_1.getContractAddress)(chainId, "raacminter"), (0, artifacts_1.getABI)("raacminter"), provider);
-        const distAddr = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-        const [info, totalWeight] = await Promise.all([minter.poolInfo(distAddr), minter.totalWeight()]);
-        const poolWeight = BigInt(info.weight ?? info[0] ?? 0n);
-        const exists = Boolean(info.exists ?? info[1]);
-        const tw = BigInt(totalWeight);
-        distShare = exists && tw > 0n ? (poolWeight * E18) / tw : 0n;
-    }
-    catch {
-        /* minter not readable — scheduled emission stays 0 */
-    }
+    const minter = new ethers_1.ethers.Contract((0, getContractAddress_1.getContractAddress)(chainId, "raacminter"), (0, artifacts_1.getABI)("raacminter"), provider);
+    const [info, totalWeight, mintingStart] = await Promise.all([
+        minter.poolInfo(distAddr),
+        minter.totalWeight(),
+        minter.mintingStartAtTimestamp(),
+    ]);
+    const poolWeight = BigInt(info.weight ?? info[0] ?? 0n);
+    const exists = Boolean(info.exists ?? info[1]);
+    const tw = BigInt(totalWeight);
+    // 1e18-scaled fraction of the minter routed to the distributor
+    const distShare = exists && tw > 0n ? (poolWeight * E18) / tw : 0n;
+    const mintingStartAt = BigInt(mintingStart ?? 0n);
     const scheduledSystemEmission = async (epochStart) => {
-        if (!minter || distShare === 0n)
+        if (distShare === 0n || mintingStartAt === 0n)
             return 0n;
-        try {
-            const minterWeekly = BigInt(await minter.calculateScheduledMintableAmount(epochStart, epochStart + week));
-            return (minterWeekly * distShare) / E18;
-        }
-        catch {
+        // The schedule emits nothing before activation, and the minter reverts with an arithmetic
+        // panic on a window that starts before it, so the epoch the minter was activated in is
+        // clamped to the activation timestamp.
+        const from = epochStart < mintingStartAt ? mintingStartAt : epochStart;
+        const to = epochStart + week;
+        if (to <= from)
             return 0n;
-        }
+        const minterWeekly = BigInt(await minter.calculateScheduledMintableAmount(from, to));
+        return (minterWeekly * distShare) / E18;
     };
     // Window: [currentEpoch - (numEpochs-1)*week .. currentEpoch], clamped to startEpoch.
     const span = BigInt(Math.max(1, numEpochs) - 1) * week;
@@ -80,21 +88,9 @@ const getGaugeEmissions = async (chainId, gauge, numEpochs = 8, includeUpcoming
         epochList.push(e);
     const epochs = await Promise.all(epochList.map(async (e) => {
         const isCurrent = e === currentEpoch;
-        let depositedSoFar = 0n;
-        let relativeWeight = 0n;
-        try {
-            depositedSoFar = BigInt(await distributor.depositedAtEpoch(rewardToken, e));
-        }
-        catch {
-            /* ignore */
-        }
-        try {
-            const [rel] = await controller.getGaugeRelativeWeightView(gauge, e);
-            relativeWeight = BigInt(rel);
-        }
-        catch {
-            /* no snapshot at this epoch */
-        }
+        const depositedSoFar = BigInt(await distributor.depositedAtEpoch(rewardToken, e));
+        const [rel] = await controller.getGaugeRelativeWeightView(gauge, e);
+        const relativeWeight = BigInt(rel);
         // Past epochs: use the actual deposited. Current (in-progress) epoch: use the
         // scheduled full-week emission (deposited is still partial/tick-based).
         let systemEmission = depositedSoFar;
@@ -105,12 +101,11 @@ const getGaugeEmissions = async (chainId, gauge, numEpochs = 8, includeUpcoming
         const gaugeEmissionRaw = (systemEmission * relativeWeight) / E18;
         return {
             epoch: Number(e),
-            deposited: ethers_1.ethers.formatEther(systemEmission),
-            depositedSoFar: ethers_1.ethers.formatEther(depositedSoFar),
-            relativeWeight,
+            deposited: (0, amount_1.toTokenAmount)(chainId, rewardToken, systemEmission),
+            depositedSoFar: (0, amount_1.toTokenAmount)(chainId, rewardToken, depositedSoFar),
+            relativeWeight: (0, amount_1.toScaled)(relativeWeight, amount_1.WAD_DECIMALS),
             relativeWeightPct: Number((relativeWeight * 10000n) / E18) / 100,
-            gaugeEmission: ethers_1.ethers.formatEther(gaugeEmissionRaw),
-            gaugeEmissionRaw,
+            gaugeEmission: (0, amount_1.toTokenAmount)(chainId, rewardToken, gaugeEmissionRaw),
             isCurrent,
         };
     }));
@@ -121,24 +116,17 @@ const getGaugeEmissions = async (chainId, gauge, numEpochs = 8, includeUpcoming
     // deposit is projected from the same emission schedule.
     if (includeUpcoming) {
         const nextEpoch = currentEpoch + week;
-        let relNext = 0n;
-        try {
-            const [rel] = await controller.getGaugeRelativeWeightView(gauge, nextEpoch);
-            relNext = BigInt(rel);
-        }
-        catch {
-            /* no projected snapshot */
-        }
+        const [relNextRaw] = await controller.getGaugeRelativeWeightView(gauge, nextEpoch);
+        const relNext = BigInt(relNextRaw);
         const projectedSystem = await scheduledSystemEmission(nextEpoch);
         const projectedRaw = (projectedSystem * relNext) / E18;
         epochs.push({
             epoch: Number(nextEpoch),
-            deposited: ethers_1.ethers.formatEther(projectedSystem),
-            depositedSoFar: "0",
-            relativeWeight: relNext,
+            deposited: (0, amount_1.toTokenAmount)(chainId, rewardToken, projectedSystem),
+            depositedSoFar: (0, amount_1.toTokenAmount)(chainId, rewardToken, 0n),
+            relativeWeight: (0, amount_1.toScaled)(relNext, amount_1.WAD_DECIMALS),
             relativeWeightPct: Number((relNext * 10000n) / E18) / 100,
-            gaugeEmission: ethers_1.ethers.formatEther(projectedRaw),
-            gaugeEmissionRaw: projectedRaw,
+            gaugeEmission: (0, amount_1.toTokenAmount)(chainId, rewardToken, projectedRaw),
             isCurrent: false,
             isProjected: true,
         });
@@ -149,8 +137,8 @@ const getGaugeEmissions = async (chainId, gauge, numEpochs = 8, includeUpcoming
         currentEpoch: Number(currentEpoch),
         weekSeconds: Number(week),
         relativeWeightPct: current ? current.relativeWeightPct : 0,
-        currentWeekEmission: current ? current.gaugeEmission : "0",
-        currentWeekDepositedSoFar: current ? current.depositedSoFar : "0",
+        currentWeekEmission: current ? current.gaugeEmission : (0, amount_1.toTokenAmount)(chainId, rewardToken, 0n),
+        currentWeekDepositedSoFar: current ? current.depositedSoFar : (0, amount_1.toTokenAmount)(chainId, rewardToken, 0n),
         epochs,
     };
 };

package/dist/contracts/governance/gaugeController/getGaugeRelativeWeight.js

@@ -2,28 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getGaugeRelativeWeight = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
 /**
- * Computes and checkpoints a gauge's relative weight at a given epoch.
- *
- * This is a state-modifying call (it writes checkpoints), so it requires a Signer.
- * For a pure read with no state changes, use getGaugeRelativeWeightView instead.
+ * Checkpoints a gauge and computes its relative weight at an epoch. State-changing; use `getGaugeRelativeWeightView` to read without a transaction. Reverts during a global pause.
  *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
- * @param epoch - Epoch timestamp to checkpoint.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param epoch - Epoch start timestamp, seconds.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-const getGaugeRelativeWeight = async (chainId, gauge, epoch, signer) => {
+const getGaugeRelativeWeight = async (chainId, gaugeSystem, gaugeAddressOrId, epoch, signer) => {
     if (!signer)
         throw new Error("Signer is required");
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, signer);
-    const tx = await contract.getGaugeRelativeWeight(gauge, epoch);
-    await tx.wait();
-    return tx;
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.getGaugeRelativeWeight(gaugeAddress, epoch);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to checkpoint gauge relative weight", error);
+    }
 };
 exports.getGaugeRelativeWeight = getGaugeRelativeWeight;

package/dist/contracts/governance/gaugeController/getGaugeRelativeWeightView.js

@@ -6,25 +6,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getGaugeRelativeWeightView = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Reads a gauge's relative weight at a given epoch without modifying state.
+ * Returns a gauge's relative weight at an epoch without checkpointing.
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
- * @param epoch - Epoch timestamp to query.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param epoch - Epoch start timestamp, seconds.
  * @param provider - Optional ethers.js Provider instance.
- * @returns An object with relativeWeight (1e18-scaled, where 1e18 = 100%) and totalWeight, both bigint.
+ * @returns relativeWeight as an 18-decimal fraction (1.0 = 100%) and the total weight at that epoch (veRAAC voting power, base units). Both are zero when no weight is voted.
  */
-const getGaugeRelativeWeightView = async (chainId, gauge, epoch, provider) => {
+const getGaugeRelativeWeightView = async (chainId, gaugeSystem, gaugeAddressOrId, epoch, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
-    const [relativeWeight, totalWeight] = await contract.getGaugeRelativeWeightView(gauge, epoch);
-    return { relativeWeight, totalWeight };
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const [relativeWeight, totalWeight] = await contract.getGaugeRelativeWeightView(gaugeAddress, epoch);
+    return { relativeWeight: (0, amount_1.toScaled)(relativeWeight, amount_1.WAD_DECIMALS), totalWeight: (0, amount_1.toTokenAmount)(chainId, "veraac", totalWeight) };
 };
 exports.getGaugeRelativeWeightView = getGaugeRelativeWeightView;

package/dist/contracts/governance/gaugeController/getGaugeWeight.js

@@ -6,24 +6,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getGaugeWeight = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
-const GET_GAUGE_WEIGHT_ABI = "function getGaugeWeight(address gauge) view returns (uint256)";
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Gets the weight of a gauge.
+ * Returns a gauge's weight projected to the next epoch.
  *
  * @param chainId - The chain/network to use.
- * @param gaugeAddress - Address of the gauge.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Weight of the gauge formatted in ether units.
+ * @returns The weight, veRAAC voting power in base units.
  */
-const getGaugeWeight = async (chainId, gaugeAddress, provider) => {
+const getGaugeWeight = async (chainId, gaugeSystem, gaugeAddressOrId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(contractAddress, [GET_GAUGE_WEIGHT_ABI], provider);
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
     const weight = await contract.getGaugeWeight(gaugeAddress);
-    return ethers_1.ethers.formatEther(weight);
+    return (0, amount_1.toTokenAmount)(chainId, "veraac", weight);
 };
 exports.getGaugeWeight = getGaugeWeight;

package/dist/contracts/governance/gaugeController/getLastVoteTime.js

@@ -6,24 +6,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLastVoteTime = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the timestamp of a user's last vote on a given gauge.
+ * Returns when a user last voted on a gauge.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param user - Address of the user.
- * @param gauge - Address of the gauge.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param provider - Optional ethers.js Provider instance.
- * @returns The last vote timestamp as a bigint.
+ * @returns The last vote timestamp, seconds.
  */
-const getLastVoteTime = async (chainId, user, gauge, provider) => {
+const getLastVoteTime = async (chainId, gaugeSystem, user, gaugeAddressOrId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
-    return contract.lastVoteTime(user, gauge);
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    return contract.lastVoteTime(user, gaugeAddress);
 };
 exports.getLastVoteTime = getLastVoteTime;

package/dist/contracts/governance/gaugeController/getMaxVoteBuckets.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMaxVoteBuckets = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the per-vote decay-bucket cap. 0 means exact (one entry per lock).
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The bucket cap.
+ */
+const getMaxVoteBuckets = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    return contract.maxVoteBuckets();
+};
+exports.getMaxVoteBuckets = getMaxVoteBuckets;

package/dist/contracts/governance/gaugeController/getNextEpoch.js

@@ -6,22 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getNextEpoch = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the next epoch boundary (current epoch plus one week) from the GaugeController.
+ * Returns the start timestamp of the controller's next epoch. Votes cast now take effect at this epoch.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Next epoch timestamp as a bigint.
+ * @returns The next epoch timestamp, seconds.
  */
-const getNextEpoch = async (chainId, provider) => {
+const getNextEpoch = async (chainId, gaugeSystem, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
     return contract.getNextEpoch();
 };
 exports.getNextEpoch = getNextEpoch;

package/dist/contracts/governance/gaugeController/getRegisteredGaugeList.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRegisteredGaugeList = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns every gauge registered on the controller, from `addGauge` until `removeGauge`, emergency-paused ones included.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The registered gauge addresses.
+ */
+const getRegisteredGaugeList = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    return [...(await contract.getRegisteredGaugeList())];
+};
+exports.getRegisteredGaugeList = getRegisteredGaugeList;