@raac/rpc 1.2.0-beta.1 → 1.2.0-beta.11

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

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApy = void 0;
+const ethers_1 = require("ethers");
+const _apy_1 = require("./_apy");
+const add = (a, b) => (a === null && b === null ? null : (a ?? 0) + (b ?? 0));
+/**
+ * Calculates a gauge's minimum (no boost) and maximum (full boost) APY. Figures are simple annualized rates in percent, not compounded.
+ *
+ * Main rewards are shared by working balance, where a staker counts for `balance × boost / MAX_BOOST` (capped at balance). A fully boosted staker's working balance equals their stake, so maxApy = yearly main rewards USD / (workingSupply × staking price), and minApy = maxApy × MIN_BOOST / MAX_BOOST. Extra rewards are shared by raw balance over totalSupply. The figures hold workingSupply fixed, so a large new deposit, or other stakers boosting, lowers them. The "stream" source jumps whenever a pull compresses rewards into the rest of a period, e.g. after a pause.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param prices - USD price of the staking token and of each reward token (see `getRewardTokens`).
+ * @param options - Optional reward source: "epoch" (default) or "stream".
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Min, max and extra APY with the supplies and per-token yearly rewards behind them. An APY is null when nothing is staked.
+ */
+const getApy = async (chainId, gaugeAddressOrId, prices, options = {}, provider) => {
+    const state = await (0, _apy_1.loadGaugeApyState)(chainId, gaugeAddressOrId, prices, options, provider);
+    const totalStaked = ethers_1.ethers.formatUnits(state.totalSupply, state.stakingDecimals);
+    const workingSupply = ethers_1.ethers.formatUnits(state.workingSupply, state.stakingDecimals);
+    const price = prices.stakingTokenPriceUSD;
+    const maxApy = (0, _apy_1.toApyPct)(state.mainYearlyUSD, Number(workingSupply), price);
+    const minApy = maxApy === null ? null : (maxApy * Number(state.minBoost)) / Number(state.maxBoost);
+    const extraApy = (0, _apy_1.toApyPct)(state.extraYearlyUSD, Number(totalStaked), price);
+    return {
+        gauge: state.gauge,
+        stakingToken: state.stakingToken,
+        rewardSource: state.rewardSource,
+        totalStaked,
+        workingSupply,
+        tvlUSD: Number(totalStaked) * price,
+        minBoost: Number(state.minBoost) / 10000,
+        maxBoost: Number(state.maxBoost) / 10000,
+        minApy,
+        maxApy,
+        extraApy,
+        totalMinApy: add(minApy, extraApy),
+        totalMaxApy: add(maxApy, extraApy),
+        rewards: state.rewards,
+    };
+};
+exports.getApy = getApy;

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

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBalanceOf = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 const BALANCE_OF_ABI = "function balanceOf(address account) view returns (uint256)";
 /**
  * Gets the working balance of an account (includes boost).
@@ -22,20 +22,7 @@ const getBalanceOf = async (chainId, gaugeAddressOrId, accountAddress, provider)
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
-    }
-    catch (error) {
-        console.error("Error getting balance of:", error);
-        throw new Error(`Failed to get balance of from gauge ${gaugeAddress}: ${error.message}`);
-    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const contract = new ethers_1.ethers.Contract(gaugeAddress, [BALANCE_OF_ABI], provider);
     const balance = await contract.balanceOf(accountAddress);
     return ethers_1.ethers.formatEther(balance);

package/dist/contracts/governance/gauge/getControllerAddress.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.getControllerAddress = 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");
+/**
+ * Gets the gauge controller address registered on the gauge.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getControllerAddress = async (chainId, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, provider);
+    return contract.getControllerAddress();
+};
+exports.getControllerAddress = getControllerAddress;

package/dist/contracts/governance/gauge/getDecimalAdjustment.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.getDecimalAdjustment = 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");
+/**
+ * Gets the decimal adjustment factor used for a given reward token.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param token - Address of the reward token.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getDecimalAdjustment = async (chainId, gaugeAddressOrId, token, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, provider);
+    return contract.getDecimalAdjustment(token);
+};
+exports.getDecimalAdjustment = getDecimalAdjustment;

package/dist/contracts/governance/gauge/getDepositRAACOnClaim.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.getDepositRAACOnClaim = 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 whether claimed RAAC is auto-deposited (locked) on claim.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getDepositRAACOnClaim = async (chainId, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, provider);
+    return contract.depositRAACOnClaim();
+};
+exports.getDepositRAACOnClaim = getDepositRAACOnClaim;

package/dist/contracts/governance/gauge/getDistributorData.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.getDistributorData = 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");
+/**
+ * Gets the registration data for a given distributor on the gauge.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param distributor - Address of the distributor.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getDistributorData = async (chainId, gaugeAddressOrId, distributor, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, provider);
+    const [distro, approved] = await contract.getDistributorData(distributor);
+    return { distributor: distro, approved };
+};
+exports.getDistributorData = getDistributorData;

package/dist/contracts/governance/gauge/getDistributors.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.getDistributors = 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");
+/**
+ * Gets the list of distributor addresses registered on the gauge.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getDistributors = async (chainId, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, provider);
+    return contract.getDistributors();
+};
+exports.getDistributors = getDistributors;

package/dist/contracts/governance/gauge/getEarnedExtraReward.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.getEarnedExtraReward = 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");
+/**
+ * Gets the total amount of an extra reward token a user has already claimed from a gauge.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param token - Address of a registered extra reward token (see `getExtraRewardTokens`).
+ * @param userAddress - Address of the user.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The claimed extra reward amount (raw, base units).
+ */
+const getEarnedExtraReward = async (chainId, gaugeAddressOrId, token, userAddress, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, (0, artifacts_1.getABI)("basegauge"), provider);
+    return contract.earnedExtraReward(token, userAddress);
+};
+exports.getEarnedExtraReward = getEarnedExtraReward;

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

@@ -6,39 +6,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEarnedReward = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
-const EARNED_REWARD_ABI = "function earnedReward(address token, address user) view returns (uint256)";
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the earned rewards for a user for a specific token (already claimed).
+ * Gets the total amount of a reward token a user has already claimed from a gauge.
  *
  * @param chainId - The chain/network to use.
- * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
- * @param tokenAddress - Address of the reward token.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param token - Reward token address (see `getRewardTokens`).
  * @param userAddress - Address of the user.
  * @param provider - Optional ethers.js Provider instance.
- * @returns The amount of earned rewards formatted in ether units.
+ * @returns The claimed reward amount (raw, base units).
  */
-const getEarnedReward = async (chainId, gaugeAddressOrId, tokenAddress, userAddress, provider) => {
+const getEarnedReward = async (chainId, gaugeAddressOrId, token, userAddress, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
-    }
-    catch (error) {
-        console.error("Error getting earned reward:", error);
-        throw new Error(`Failed to get earned reward from gauge ${gaugeAddress}: ${error.message}`);
-    }
-    const contract = new ethers_1.ethers.Contract(gaugeAddress, [EARNED_REWARD_ABI], provider);
-    const earned = await contract.earnedReward(tokenAddress, userAddress);
-    return ethers_1.ethers.formatEther(earned);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, (0, artifacts_1.getABI)("basegauge"), provider);
+    return contract.earnedReward(token, userAddress);
 };
 exports.getEarnedReward = getEarnedReward;

package/dist/contracts/governance/gauge/getExtraRewardTokens.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.getExtraRewardTokens = 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");
+/**
+ * Gets the list of extra reward token addresses registered on the gauge.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getExtraRewardTokens = async (chainId, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, provider);
+    return contract.getExtraRewardTokens();
+};
+exports.getExtraRewardTokens = getExtraRewardTokens;

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

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeData = 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");
+/**
+ * Reads a gauge's `gaugeData` struct: its staking and reward tokens, distributor, supplies and period state.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The gauge data.
+ */
+const getGaugeData = async (chainId, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, (0, artifacts_1.getABI)("basegauge"), provider);
+    const [gaugeInitialStartTime, periodDuration, periodIndex, stakingToken, totalSupply, workingSupply, rewardDistributor, rewardToken, lastUpdateTime,] = await contract.gaugeData();
+    return {
+        gaugeInitialStartTime,
+        periodDuration,
+        periodIndex,
+        stakingToken,
+        totalSupply,
+        workingSupply,
+        rewardDistributor,
+        rewardToken,
+        lastUpdateTime,
+    };
+};
+exports.getGaugeData = getGaugeData;

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

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeRewardTokenData = 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");
+/**
+ * Gets the gauge-level reward accounting data for a specific token.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param token - Address of the reward token.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getGaugeRewardTokenData = async (chainId, gaugeAddressOrId, token, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, provider);
+    const [isActive, decimals, rate, integral, lastUpdateTime, distributed, leftoverRewards,] = await contract.getGaugeRewardTokenData(token);
+    return {
+        isActive,
+        decimals,
+        rate,
+        integral,
+        lastUpdateTime,
+        distributed,
+        leftoverRewards,
+    };
+};
+exports.getGaugeRewardTokenData = getGaugeRewardTokenData;

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

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPauseStatus = 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");
+/**
+ * Reads both pause switches that gate a gauge, mirroring the contract's `whenGaugeLive` check.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The gauge's and its controller's pause flags, and whether the gauge is live.
+ */
+const getPauseStatus = async (chainId, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const gauge = new ethers_1.ethers.Contract(gaugeAddress, (0, artifacts_1.getABI)("basegauge"), provider);
+    const [gaugePaused, controllerAddress] = await Promise.all([gauge.isPaused(), gauge.gaugeController()]);
+    const controller = new ethers_1.ethers.Contract(controllerAddress, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const controllerPaused = await controller.isPaused();
+    return { gaugePaused, controllerPaused, live: !gaugePaused && !controllerPaused };
+};
+exports.getPauseStatus = getPauseStatus;

package/dist/contracts/governance/gauge/getPendingExtraRewards.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.getPendingExtraRewards = 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");
+/**
+ * Gets the pending extra rewards for a user for a specific token.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param token - Address of the reward token.
+ * @param user - Address of the user.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getPendingExtraRewards = async (chainId, gaugeAddressOrId, token, user, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, provider);
+    return contract.pendingExtraRewards(token, user);
+};
+exports.getPendingExtraRewards = getPendingExtraRewards;

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

@@ -6,39 +6,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPendingRewards = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
-const PENDING_REWARDS_ABI = "function pendingRewards(address token, address account) view returns (uint256)";
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the pending rewards for a user for a specific token.
+ * Gets the rewards a user can claim from a gauge for one reward token. Only counts rewards already pulled into the gauge, which is everything a user can claim right now; `getUserClaimableRewards` adds the extra reward tokens.
  *
  * @param chainId - The chain/network to use.
- * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
- * @param tokenAddress - Address of the reward token.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param token - The gauge's main reward token (`getGaugeData().rewardToken`). Any other token reverts with NotSupportedToken; use `getPendingExtraRewards` for extra reward tokens.
  * @param accountAddress - Address of the user.
  * @param provider - Optional ethers.js Provider instance.
- * @returns The amount of pending rewards formatted in ether units.
+ * @returns The pending reward amount (raw, base units).
  */
-const getPendingRewards = async (chainId, gaugeAddressOrId, tokenAddress, accountAddress, provider) => {
+const getPendingRewards = async (chainId, gaugeAddressOrId, token, accountAddress, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
-    }
-    catch (error) {
-        console.error("Error getting pending rewards:", error);
-        throw new Error(`Failed to get pending rewards from gauge ${gaugeAddress}: ${error.message}`);
-    }
-    const contract = new ethers_1.ethers.Contract(gaugeAddress, [PENDING_REWARDS_ABI], provider);
-    const pending = await contract.pendingRewards(tokenAddress, accountAddress);
-    return ethers_1.ethers.formatEther(pending);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, (0, artifacts_1.getABI)("basegauge"), provider);
+    return contract.pendingRewards(token, accountAddress);
 };
 exports.getPendingRewards = getPendingRewards;

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

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPeriodBoundaries = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 const GET_PERIOD_BOUNDARIES_ABI = "function getPeriodBoundaries() view returns (uint256 periodStartTime, uint256 periodEndTime)";
 /**
  * Gets the start and end time of the current period.
@@ -21,20 +21,7 @@ const getPeriodBoundaries = async (chainId, gaugeAddressOrId, provider) => {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
-    }
-    catch (error) {
-        console.error("Error getting period boundaries:", error);
-        throw new Error(`Failed to get period boundaries from gauge ${gaugeAddress}: ${error.message}`);
-    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const contract = new ethers_1.ethers.Contract(gaugeAddress, [GET_PERIOD_BOUNDARIES_ABI], provider);
     const [periodStartTime, periodEndTime] = await contract.getPeriodBoundaries();
     return {

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

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPeriodDuration = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 const PERIOD_DURATION_ABI = "function periodDuration() view returns (uint256)";
 /**
  * Gets the period duration for the gauge.
@@ -21,20 +21,7 @@ const getPeriodDuration = async (chainId, gaugeAddressOrId, provider) => {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
-    }
-    catch (error) {
-        console.error("Error getting period duration:", error);
-        throw new Error(`Failed to get period duration from gauge ${gaugeAddress}: ${error.message}`);
-    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const contract = new ethers_1.ethers.Contract(gaugeAddress, [PERIOD_DURATION_ABI], provider);
     const periodDuration = await contract.periodDuration();
     return Number(periodDuration);

package/dist/contracts/governance/gauge/getRaacAutolockMin.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.getRaacAutolockMin = 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");
+/**
+ * Gets the minimum RAAC amount required to trigger an autolock on claim.
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getRaacAutolockMin = async (chainId, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, provider);
+    return contract.raacAutolockMin();
+};
+exports.getRaacAutolockMin = getRaacAutolockMin;

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

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRawBalanceOf = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 const RAW_BALANCE_OF_ABI = "function rawBalanceOf(address account) view returns (uint256)";
 /**
  * Gets the raw balance of an account (without boost).
@@ -22,20 +22,7 @@ const getRawBalanceOf = async (chainId, gaugeAddressOrId, accountAddress, provid
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
-    }
-    catch (error) {
-        console.error("Error getting raw balance of:", error);
-        throw new Error(`Failed to get raw balance of from gauge ${gaugeAddress}: ${error.message}`);
-    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const contract = new ethers_1.ethers.Contract(gaugeAddress, [RAW_BALANCE_OF_ABI], provider);
     const balance = await contract.rawBalanceOf(accountAddress);
     return ethers_1.ethers.formatEther(balance);