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

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeTokens = exports.ERC4626_ABI = exports.ERC20_ABI = void 0;
+const ethers_1 = require("ethers");
+const GAUGE_ABI = [
+    "function gaugeData() view returns (uint256 gaugeInitialStartTime, uint256 periodDuration, uint256 periodIndex, address stakingToken, uint256 totalSupply, uint256 workingSupply, address rewardDistributor, address rewardToken, uint256 lastUpdateTime)",
+];
+const VAULT_ABI = ["function asset() view returns (address)", "function totalAssets() view returns (uint256)"];
+exports.ERC20_ABI = [
+    "function symbol() view returns (string)",
+    "function decimals() view returns (uint8)",
+    "function balanceOf(address) view returns (uint256)",
+    "function allowance(address owner, address spender) view returns (uint256)",
+    "function approve(address spender, uint256 amount) returns (bool)",
+];
+exports.ERC4626_ABI = [
+    "function deposit(uint256 assets, address receiver) returns (uint256 shares)",
+    "function redeem(uint256 shares, address receiver, address owner) returns (uint256 assets)",
+];
+/**
+ * Reads a gauge's staking token from the gauge and whether it wraps another token. A staking token counts as a wrapper
+ * when it exposes a non-zero `asset()` and a working `totalAssets()`, the same test the subgraph uses for its `wrapped` flag.
+ */
+const getGaugeTokens = async (gaugeAddress, runner) => {
+    const gauge = new ethers_1.ethers.Contract(gaugeAddress, GAUGE_ABI, runner);
+    const stakingToken = (await gauge.gaugeData()).stakingToken;
+    const vault = new ethers_1.ethers.Contract(stakingToken, VAULT_ABI, runner);
+    try {
+        const [asset] = await Promise.all([vault.asset(), vault.totalAssets()]);
+        return { stakingToken, underlying: asset === ethers_1.ethers.ZeroAddress ? null : asset };
+    }
+    catch {
+        return { stakingToken, underlying: null };
+    }
+};
+exports.getGaugeTokens = getGaugeTokens;

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

@@ -1,12 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addRewardToken = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Registers a new reward token on the gauge (requires GAUGE_ADMIN).
  * @param chainId - The chain/network to use.
@@ -17,14 +14,7 @@ const getContractAddress_1 = __importDefault(require("../../getContractAddress")
 const addRewardToken = async (chainId, gaugeAddressOrId, token, 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 gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const abi = (0, artifacts_1.getABI)("basegauge");
     const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
     const tx = await contract.addRewardToken(token);

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.approveGaugeToken = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _tokens_1 = require("./_tokens");
+/**
+ * Approves the contract that pulls a gauge token: the staking token to the gauge, or for a wrapped gauge the underlying
+ * to the wrapper.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param token - "staking" to stake, "underlying" to wrap.
+ * @param amount - Allowance to set, base units.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The mined transaction.
+ */
+const approveGaugeToken = async (chainId, gaugeAddressOrId, token, amount, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const gauge = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const { stakingToken, underlying } = await (0, _tokens_1.getGaugeTokens)(gauge, signer);
+    if (token === "underlying" && !underlying) {
+        throw new Error(`Gauge ${gauge} does not take a wrapped token`);
+    }
+    const [address, spender] = token === "staking" ? [stakingToken, gauge] : [underlying, stakingToken];
+    const tx = await new ethers_1.ethers.Contract(address, _tokens_1.ERC20_ABI, signer).approve(spender, amount);
+    await tx.wait();
+    return tx;
+};
+exports.approveGaugeToken = approveGaugeToken;

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

@@ -1,12 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.claimExtraReward = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Claims a single extra reward token for the caller on the given gauge.
  * @param chainId - The chain/network to use.
@@ -17,14 +14,7 @@ const getContractAddress_1 = __importDefault(require("../../getContractAddress")
 const claimExtraReward = async (chainId, gaugeAddressOrId, token, 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 gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const abi = (0, artifacts_1.getABI)("basegauge");
     const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
     const tx = await contract.claimExtraReward(token);

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

@@ -1,12 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.claimExtraRewards = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Claims all extra reward tokens for the caller on the given gauge.
  * @param chainId - The chain/network to use.
@@ -16,14 +13,7 @@ const getContractAddress_1 = __importDefault(require("../../getContractAddress")
 const claimExtraRewards = async (chainId, gaugeAddressOrId, 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 gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const abi = (0, artifacts_1.getABI)("basegauge");
     const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
     const tx = await contract.claimExtraRewards();

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

@@ -1,12 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.claimOnBehalfOf = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Claims a specific token amount on behalf of a user (requires CLAIM_FOR_ROLE).
  * @param chainId - The chain/network to use.
@@ -19,14 +16,7 @@ const getContractAddress_1 = __importDefault(require("../../getContractAddress")
 const claimOnBehalfOf = async (chainId, gaugeAddressOrId, token, amount, user, 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 gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const abi = (0, artifacts_1.getABI)("basegauge");
     const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
     const tx = await contract.claimOnBehalfOf(token, amount, user);

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

@@ -1,14 +1,11 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.claimRewardToken = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Claims a specific reward token from a gauge.
+ * Claims the caller's main reward token from a gauge, pulling the gauge's share from its distributor first. Reverts while the gauge or its controller is paused.
  *
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
@@ -19,15 +16,8 @@ const claimRewardToken = async (chainId, gaugeAddressOrId, signer) => {
     if (!signer) {
         throw new Error("Signer is required");
     }
-    let gaugeAddress;
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
         const gaugeABI = (0, artifacts_1.getABI)("basegauge");
         const contract = new ethers_1.ethers.Contract(gaugeAddress, gaugeABI, signer);
         const tx = await contract.claimRewardToken();

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

@@ -1,12 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.claimRewardsFor = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Claims rewards on behalf of a user (requires DISTRIBUTOR_ROLE).
  * @param chainId - The chain/network to use.
@@ -17,14 +14,7 @@ const getContractAddress_1 = __importDefault(require("../../getContractAddress")
 const claimRewardsFor = async (chainId, gaugeAddressOrId, user, 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 gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const abi = (0, artifacts_1.getABI)("basegauge");
     const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
     const tx = await contract.claimRewardsFor(user);

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

@@ -1,12 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.depositRewardToken = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Deposits an amount of a reward token into the gauge for distribution.
  * @param chainId - The chain/network to use.
@@ -18,14 +15,7 @@ const getContractAddress_1 = __importDefault(require("../../getContractAddress")
 const depositRewardToken = async (chainId, gaugeAddressOrId, token, 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 gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     const abi = (0, artifacts_1.getABI)("basegauge");
     const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
     const tx = await contract.depositRewardToken(token, amount);

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

@@ -7,7 +7,7 @@ exports.getAllPendingExtraRewards = 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 all pending extra rewards for a user across all extra reward tokens.
  * @param chainId - The chain/network to use.
@@ -20,14 +20,7 @@ const getAllPendingExtraRewards = async (chainId, gaugeAddressOrId, user, 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 [tokens, amounts] = await contract.allPendingExtraRewards(user);

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

@@ -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,7 +7,7 @@ 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.
  * @param chainId - The chain/network to use.
@@ -20,14 +20,7 @@ const getDecimalAdjustment = async (chainId, gaugeAddressOrId, token, 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,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,31 +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 user) view returns (uint256)";
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * 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).
  */
-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 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();