@raac/rpc 1.2.0-beta.5 → 1.2.0-beta.7

package/dist/contracts/governance/gauge/setGaugeRewardDistributor.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setGaugeRewardDistributor = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+/**
+ * Sets the gauge reward distributor address (requires DEFAULT_ADMIN_ROLE).
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param rewardDistributor - Address of the new reward distributor.
+ * @param signer - An ethers.js Signer instance (required).
+ */
+const setGaugeRewardDistributor = async (chainId, gaugeAddressOrId, rewardDistributor, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    let gaugeAddress;
+    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
+        gaugeAddress = gaugeAddressOrId;
+    }
+    else {
+        // @ts-ignore
+        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
+    }
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
+    const tx = await contract.setGaugeRewardDistributor(rewardDistributor);
+    await tx.wait();
+    return tx;
+};
+exports.setGaugeRewardDistributor = setGaugeRewardDistributor;

package/dist/contracts/governance/gauge/setRaacAutolockMin.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setRaacAutolockMin = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+/**
+ * Sets the minimum RAAC amount required to trigger an autolock on claim (requires DEFAULT_ADMIN_ROLE).
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param amount - The new minimum autolock amount.
+ * @param signer - An ethers.js Signer instance (required).
+ */
+const setRaacAutolockMin = async (chainId, gaugeAddressOrId, amount, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    let gaugeAddress;
+    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
+        gaugeAddress = gaugeAddressOrId;
+    }
+    else {
+        // @ts-ignore
+        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
+    }
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
+    const tx = await contract.setRaacAutolockMin(amount);
+    await tx.wait();
+    return tx;
+};
+exports.setRaacAutolockMin = setRaacAutolockMin;

package/dist/contracts/governance/gauge/updateUserRewards.js

@@ -13,10 +13,11 @@ const getContractAddress_1 = __importDefault(require("../../getContractAddress")
  *
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
+ * @param user - Address of the user whose reward state should be settled/kicked.
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt after the update is complete.
  */
-const updateUserRewards = async (chainId, gaugeAddressOrId, signer) => {
+const updateUserRewards = async (chainId, gaugeAddressOrId, user, signer) => {
     if (!signer) {
         throw new Error("Signer is required");
     }
@@ -37,7 +38,7 @@ const updateUserRewards = async (chainId, gaugeAddressOrId, signer) => {
     try {
         const gaugeABI = (0, artifacts_1.getABI)("basegauge");
         const contract = new ethers_1.ethers.Contract(gaugeAddress, gaugeABI, signer);
-        const tx = await contract.updateUserRewards();
+        const tx = await contract.updateUserRewards(user);
         await tx.wait();
         console.log(`Updated user rewards for gauge: ${gaugeAddress}`);
         return tx;

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGauge = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Adds a new gauge to the GaugeController. Requires the GAUGE_ADMIN role.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge to add.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const addGauge = async (chainId, gauge, 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.addGauge(gauge);
+    await tx.wait();
+    return tx;
+};
+exports.addGauge = addGauge;

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

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchVote = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Casts votes on multiple gauges in a single transaction.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddresses - Array of gauge addresses to vote on.
+ * @param voteWeights - Array of vote weights (basis points) aligned with gaugeAddresses.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const batchVote = async (chainId, gaugeAddresses, voteWeights, 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.batchVote(gaugeAddresses, voteWeights);
+    await tx.wait();
+    return tx;
+};
+exports.batchVote = batchVote;

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forceCompleteCheckpoint = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Forces completion of a pending checkpoint for a gauge.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge to checkpoint.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const forceCompleteCheckpoint = async (chainId, gauge, 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.forceCompleteCheckpoint(gauge);
+    await tx.wait();
+    return tx;
+};
+exports.forceCompleteCheckpoint = forceCompleteCheckpoint;

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

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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");
+/**
+ * Reads the immutable/constant configuration values from the GaugeController.
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns An object with maxBoost, minBoost, weightPrecision, week, weightVoteDelay,
+ *   minVoteWeight and maxVoteWeight, all bigint.
+ */
+const getConstants = async (chainId, 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([
+        contract.MAX_BOOST(),
+        contract.MIN_BOOST(),
+        contract.WEIGHT_PRECISION(),
+        contract.WEEK(),
+        contract.WEIGHT_VOTE_DELAY(),
+        contract.MIN_VOTE_WEIGHT(),
+        contract.MAX_VOTE_WEIGHT(),
+    ]);
+    return {
+        maxBoost,
+        minBoost,
+        weightPrecision,
+        week,
+        weightVoteDelay,
+        minVoteWeight,
+        maxVoteWeight,
+    };
+};
+exports.getConstants = getConstants;

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

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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");
+/**
+ * Gets the current epoch boundary (rounded down to the week) from the GaugeController.
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Current epoch timestamp as a bigint.
+ */
+const getCurrentEpoch = async (chainId, 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.getCurrentEpoch();
+};
+exports.getCurrentEpoch = getCurrentEpoch;

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

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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");
+/**
+ * Reads the gauge config struct from the public `gauges` mapping on the GaugeController.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns An object with isActive, isBoostAmplificationEnabled (booleans), weight and lastUpdateTime (bigint).
+ */
+const getGauge = async (chainId, gauge, 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 };
+};
+exports.getGauge = getGauge;

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

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeEmissions = 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 E18 = 10n ** 18n;
+/**
+ * Per-epoch emissions actually received by a gauge: the GaugeController snapshots
+ * gauge weights per epoch, and the GaugeRewardsDistributor records the RAAC deposited
+ * per epoch. A gauge's emission for an epoch is therefore
+ *   depositedAtEpoch(epoch) × gaugeRelativeWeight(gauge, epoch).
+ *
+ * Returns a series ending at the current (in-progress) epoch so callers can chart
+ * "week of X → this gauge received Y RAAC".
+ *
+ * @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 provider - Optional ethers.js Provider instance.
+ */
+const getGaugeEmissions = async (chainId, gauge, 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([
+        controller.WEEK(),
+        controller.getCurrentEpoch(),
+        distributor.startEpoch(),
+        distributor.rewardToken(),
+    ]);
+    const week = BigInt(weekBn);
+    const currentEpoch = BigInt(currentEpochBn);
+    const startEpoch = BigInt(startEpochBn) > 0n ? BigInt(startEpochBn) : currentEpoch;
+    // Window: [currentEpoch - (numEpochs-1)*week .. currentEpoch], clamped to startEpoch.
+    const span = BigInt(Math.max(1, numEpochs) - 1) * week;
+    let from = currentEpoch - span;
+    if (from < startEpoch)
+        from = startEpoch;
+    const epochList = [];
+    for (let e = from; e <= currentEpoch; e += week)
+        epochList.push(e);
+    const epochs = await Promise.all(epochList.map(async (e) => {
+        let deposited = 0n;
+        let relativeWeight = 0n;
+        try {
+            deposited = 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 gaugeEmissionRaw = (deposited * relativeWeight) / E18;
+        return {
+            epoch: Number(e),
+            deposited: ethers_1.ethers.formatEther(deposited),
+            relativeWeight,
+            relativeWeightPct: Number((relativeWeight * 10000n) / E18) / 100,
+            gaugeEmission: ethers_1.ethers.formatEther(gaugeEmissionRaw),
+            gaugeEmissionRaw,
+            isCurrent: e === currentEpoch,
+        };
+    }));
+    const current = epochs[epochs.length - 1];
+    // ── Upcoming-epoch preview ────────────────────────────────────────────────
+    // Votes cast this epoch take effect at nextEpoch, so getGaugeRelativeWeightView
+    // at nextEpoch already reflects current voting. Nothing is deposited yet, so we
+    // project the distributor's deposit from the emission schedule:
+    //   projectedSystem = minterWeekly(nextEpoch) × distributorShareOfMinter
+    //   projectedGauge  = projectedSystem × gaugeRelativeWeight(nextEpoch)
+    if (includeUpcoming) {
+        const nextEpoch = currentEpoch + week;
+        let relNext = 0n;
+        let minterWeekly = 0n;
+        let distShare = 0n; // 1e18-scaled fraction of the minter routed to the distributor
+        try {
+            const [rel] = await controller.getGaugeRelativeWeightView(gauge, nextEpoch);
+            relNext = BigInt(rel);
+        }
+        catch {
+            /* no projected snapshot */
+        }
+        try {
+            const minter = new ethers_1.ethers.Contract((0, getContractAddress_1.getContractAddress)(chainId, "raacminter"), (0, artifacts_1.getABI)("raacminter"), provider);
+            minterWeekly = BigInt(await minter.calculateScheduledMintableAmount(nextEpoch, nextEpoch + week));
+            // distributor's share of the minter's weighted distribution
+            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 — projection stays 0 */
+        }
+        const projectedSystem = (minterWeekly * distShare) / E18;
+        const projectedRaw = (projectedSystem * relNext) / E18;
+        epochs.push({
+            epoch: Number(nextEpoch),
+            deposited: ethers_1.ethers.formatEther(projectedSystem),
+            relativeWeight: relNext,
+            relativeWeightPct: Number((relNext * 10000n) / E18) / 100,
+            gaugeEmission: ethers_1.ethers.formatEther(projectedRaw),
+            gaugeEmissionRaw: projectedRaw,
+            isCurrent: false,
+            isProjected: true,
+        });
+    }
+    return {
+        gauge,
+        rewardToken,
+        currentEpoch: Number(currentEpoch),
+        weekSeconds: Number(week),
+        relativeWeightPct: current ? current.relativeWeightPct : 0,
+        currentWeekEmission: current ? current.gaugeEmission : "0",
+        epochs,
+    };
+};
+exports.getGaugeEmissions = getGaugeEmissions;

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

@@ -0,0 +1,29 @@
+"use strict";
+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");
+/**
+ * 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.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param epoch - Epoch timestamp to checkpoint.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const getGaugeRelativeWeight = async (chainId, gauge, 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;
+};
+exports.getGaugeRelativeWeight = getGaugeRelativeWeight;

package/dist/contracts/governance/gaugeController/getGaugeRelativeWeightView.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.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");
+/**
+ * Reads a gauge's relative weight at a given epoch without modifying state.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param epoch - Epoch timestamp to query.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns An object with relativeWeight (1e18-scaled, where 1e18 = 100%) and totalWeight, both bigint.
+ */
+const getGaugeRelativeWeightView = async (chainId, gauge, 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 };
+};
+exports.getGaugeRelativeWeightView = getGaugeRelativeWeightView;

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

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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");
+/**
+ * Gets the timestamp of a user's last vote on a given gauge.
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user.
+ * @param gauge - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The last vote timestamp as a bigint.
+ */
+const getLastVoteTime = async (chainId, user, gauge, 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);
+};
+exports.getLastVoteTime = getLastVoteTime;

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

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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");
+/**
+ * Gets the next epoch boundary (current epoch plus one week) from the GaugeController.
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Next epoch timestamp as a bigint.
+ */
+const getNextEpoch = async (chainId, 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.getNextEpoch();
+};
+exports.getNextEpoch = getNextEpoch;

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

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserGaugeVotePower = 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");
+/**
+ * Gets the vote weight (in basis points) a user has allocated to a gauge.
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user.
+ * @param gauge - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Vote weight in basis points as a bigint.
+ */
+const getUserGaugeVotePower = async (chainId, user, gauge, 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.getUserGaugeVotePower(user, gauge);
+};
+exports.getUserGaugeVotePower = getUserGaugeVotePower;

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

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVeToken = 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");
+/**
+ * Gets the veToken (voting escrow token) address used by the GaugeController.
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The veToken contract address as a string.
+ */
+const getVeToken = async (chainId, 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.veToken();
+};
+exports.getVeToken = getVeToken;

package/dist/contracts/governance/gaugeController/getVoteUserPower.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.getVoteUserPower = 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");
+/**
+ * Gets the total vote power a user has currently allocated across all gauges.
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The user's allocated vote power as a bigint.
+ */
+const getVoteUserPower = async (chainId, user, 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.voteUserPower(user);
+};
+exports.getVoteUserPower = getVoteUserPower;

package/dist/contracts/governance/gaugeController/getVoteUserSlope.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.getVoteUserSlope = 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");
+/**
+ * Reads a user's vote slope for a gauge from the public `voteUserSlopes` mapping.
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user.
+ * @param gauge - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns An object with locked, power and end, all bigint.
+ */
+const getVoteUserSlope = async (chainId, user, gauge, 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 [locked, power, end] = await contract.voteUserSlopes(user, gauge);
+    return { locked, power, end };
+};
+exports.getVoteUserSlope = getVoteUserSlope;