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

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

@@ -6,7 +6,9 @@ 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 amount_1 = require("../../../utils/amount");
+const _tokens_1 = require("./_tokens");
 const BALANCE_OF_ABI = "function balanceOf(address account) view returns (uint256)";
 /**
  * Gets the working balance of an account (includes boost).
@@ -15,29 +17,19 @@ const BALANCE_OF_ABI = "function balanceOf(address account) view returns (uint25
  * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
  * @param accountAddress - Address to check balance for.
  * @param provider - Optional ethers.js Provider instance.
- * @returns The working balance formatted in ether units.
+ * @returns The working balance in staking token base units, with the staking token's registry decimals and symbol.
  */
 const getBalanceOf = async (chainId, gaugeAddressOrId, 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 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);
+    const [balance, stakingToken] = await Promise.all([
+        contract.balanceOf(accountAddress),
+        (0, _tokens_1.getStakingToken)(chainId, gaugeAddress, provider),
+    ]);
+    return (0, amount_1.toTokenAmount)(chainId, stakingToken, balance);
 };
 exports.getBalanceOf = getBalanceOf;

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

@@ -7,7 +7,7 @@ exports.getControllerAddress = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Gets the gauge controller address registered on the gauge.
  * @param chainId - The chain/network to use.
@@ -19,14 +19,7 @@ const getControllerAddress = async (chainId, gaugeAddressOrId, provider) => {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
+    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();

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

@@ -7,27 +7,22 @@ exports.getDecimalAdjustment = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the decimal adjustment factor used for a given reward token.
+ * Gets the decimal adjustment factor used for a given reward token: the integer multiplier `10 ** (18 - tokenDecimals)`
+ * the gauge applies to normalize that token's amounts to 18 decimals.
  * @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.
+ * @returns The multiplier, a plain integer.
  */
 const getDecimalAdjustment = async (chainId, gaugeAddressOrId, token, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
+    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);

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

@@ -7,7 +7,7 @@ exports.getDepositRAACOnClaim = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Returns whether claimed RAAC is auto-deposited (locked) on claim.
  * @param chainId - The chain/network to use.
@@ -19,14 +19,7 @@ const getDepositRAACOnClaim = async (chainId, gaugeAddressOrId, provider) => {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
+    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();

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

@@ -7,7 +7,7 @@ exports.getDistributorData = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Gets the registration data for a given distributor on the gauge.
  * @param chainId - The chain/network to use.
@@ -20,14 +20,7 @@ const getDistributorData = async (chainId, gaugeAddressOrId, distributor, provid
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
+    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);

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

@@ -7,7 +7,7 @@ exports.getDistributors = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Gets the list of distributor addresses registered on the gauge.
  * @param chainId - The chain/network to use.
@@ -19,14 +19,7 @@ const getDistributors = async (chainId, gaugeAddressOrId, provider) => {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
+    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();

package/dist/contracts/governance/gauge/getEarnedExtraReward.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.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");
+const amount_1 = require("../../../utils/amount");
+/**
+ * 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 in the token's base units, with its registry decimals and symbol.
+ */
+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 (0, amount_1.toTokenAmount)(chainId, token, await contract.earnedExtraReward(token, userAddress));
+};
+exports.getEarnedExtraReward = getEarnedExtraReward;

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

@@ -6,31 +6,26 @@ 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 user) view returns (uint256)";
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Gets the total amount of main-reward-token a user has already claimed from a gauge.
+ * 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 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 claimed reward amount (raw, base units).
+ * @returns The claimed reward in the token's base units, with its registry decimals and symbol.
  */
-const getEarnedReward = async (chainId, gaugeAddressOrId, 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;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
-    const contract = new ethers_1.ethers.Contract(gaugeAddress, [EARNED_REWARD_ABI], provider);
-    return contract.earnedReward(userAddress);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, (0, artifacts_1.getABI)("basegauge"), provider);
+    return (0, amount_1.toTokenAmount)(chainId, token, await contract.earnedReward(token, userAddress));
 };
 exports.getEarnedReward = getEarnedReward;

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

@@ -7,7 +7,7 @@ exports.getExtraRewardTokens = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+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.
@@ -19,14 +19,7 @@ const getExtraRewardTokens = async (chainId, gaugeAddressOrId, provider) => {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
+    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();

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

@@ -0,0 +1,40 @@
+"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");
+const amount_1 = require("../../../utils/amount");
+/**
+ * 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. Supplies are staking token amounts.
+ */
+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: (0, amount_1.toTokenAmount)(chainId, stakingToken, totalSupply),
+        workingSupply: (0, amount_1.toTokenAmount)(chainId, stakingToken, workingSupply),
+        rewardDistributor,
+        rewardToken,
+        lastUpdateTime,
+    };
+};
+exports.getGaugeData = getGaugeData;

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

@@ -3,42 +3,42 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGaugeRewardTokenData = void 0;
+exports.getGaugeRewardTokenData = exports.GAUGE_REWARD_RATE_DECIMALS = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Gets the gauge-level reward accounting data for a specific token.
+ * Decimals of the main reward token's `rate`: the gauge normalizes rewards to 18 decimals and stores the
+ * per-second rate scaled by a further 1e36 (`RewardIntegralCalculator.calculateRate`), so tokens per second is `value / 1e54`.
+ */
+exports.GAUGE_REWARD_RATE_DECIMALS = 54;
+/**
+ * Gets the gauge-level reward accounting data for the gauge's main 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.
+ * @returns The reward token data; see `GaugeRewardTokenData` for the unit of each field.
  */
 const getGaugeRewardTokenData = async (chainId, gaugeAddressOrId, token, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
+    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,
+        rate: (0, amount_1.toScaled)(rate, exports.GAUGE_REWARD_RATE_DECIMALS),
         integral,
         lastUpdateTime,
-        distributed,
-        leftoverRewards,
+        distributed: (0, amount_1.toAmount)(distributed, Number(decimals), (0, amount_1.getTokenInfo)(chainId, token)?.symbol),
+        leftoverRewards: (0, amount_1.toAmount)(leftoverRewards, amount_1.WAD_DECIMALS),
     };
 };
 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

@@ -7,7 +7,8 @@ exports.getPendingExtraRewards = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
  * Gets the pending extra rewards for a user for a specific token.
  * @param chainId - The chain/network to use.
@@ -15,22 +16,16 @@ const getContractAddress_1 = __importDefault(require("../../getContractAddress")
  * @param token - Address of the reward token.
  * @param user - Address of the user.
  * @param provider - Optional ethers.js Provider instance.
+ * @returns The pending extra reward in the token's base units, with its registry decimals and symbol.
  */
 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);
     }
-    let gaugeAddress;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
+    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);
+    return (0, amount_1.toTokenAmount)(chainId, token, await contract.pendingExtraRewards(token, user));
 };
 exports.getPendingExtraRewards = getPendingExtraRewards;

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

@@ -6,31 +6,26 @@ 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 account) view returns (uint256)";
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Gets the pending (unclaimed) main-reward-token amount for a user on a gauge.
+ * 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 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 pending reward amount (raw, base units).
+ * @returns The pending reward in the token's base units, with its registry decimals and symbol.
  */
-const getPendingRewards = async (chainId, gaugeAddressOrId, 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;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
-    const contract = new ethers_1.ethers.Contract(gaugeAddress, [PENDING_REWARDS_ABI], provider);
-    return contract.pendingRewards(accountAddress);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, (0, artifacts_1.getABI)("basegauge"), provider);
+    return (0, amount_1.toTokenAmount)(chainId, token, await 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

@@ -7,28 +7,23 @@ exports.getRaacAutolockMin = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
  * 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.
+ * @returns The minimum in RAAC base units.
  */
 const getRaacAutolockMin = async (chainId, gaugeAddressOrId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    let gaugeAddress;
-    if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-        gaugeAddress = gaugeAddressOrId;
-    }
-    else {
-        // @ts-ignore
-        gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-    }
+    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();
+    return (0, amount_1.toTokenAmount)(chainId, "raactoken", await contract.raacAutolockMin());
 };
 exports.getRaacAutolockMin = getRaacAutolockMin;

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

@@ -6,7 +6,9 @@ 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 amount_1 = require("../../../utils/amount");
+const _tokens_1 = require("./_tokens");
 const RAW_BALANCE_OF_ABI = "function rawBalanceOf(address account) view returns (uint256)";
 /**
  * Gets the raw balance of an account (without boost).
@@ -15,29 +17,19 @@ const RAW_BALANCE_OF_ABI = "function rawBalanceOf(address account) view returns
  * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
  * @param accountAddress - Address to check balance for.
  * @param provider - Optional ethers.js Provider instance.
- * @returns The raw balance formatted in ether units.
+ * @returns The staked balance in staking token base units, with the staking token's registry decimals and symbol.
  */
 const getRawBalanceOf = async (chainId, gaugeAddressOrId, 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 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);
+    const [balance, stakingToken] = await Promise.all([
+        contract.rawBalanceOf(accountAddress),
+        (0, _tokens_1.getStakingToken)(chainId, gaugeAddress, provider),
+    ]);
+    return (0, amount_1.toTokenAmount)(chainId, stakingToken, balance);
 };
 exports.getRawBalanceOf = getRawBalanceOf;