@raac/rpc 1.2.0-beta.8 → 2.0.0-beta.0

package/dist/contracts/governance/distributor/deposit.js

@@ -2,26 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deposit = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
 /**
- * Deposits reward tokens into the distributor.
- * The reward token must be pre-approved by the caller before calling.
+ * Deposits reward tokens into the distributor for the current epoch. The token must be the distributor's reward token and pre-approved. Reverts when no gauge is registered.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
  * @param token - Address of the reward token.
- * @param amount - Amount of reward tokens to deposit.
+ * @param amount - Amount to deposit, in `token` base units.
  * @param signer - An ethers.js Signer instance (required).
- * @returns Transaction after it has been mined.
+ * @returns The transaction after it has been mined.
  */
-const deposit = async (chainId, token, amount, signer) => {
+const deposit = async (chainId, gaugeSystem, token, amount, signer) => {
     if (!signer)
         throw new Error("Signer is required");
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, signer);
-    const tx = await contract.deposit(token, amount);
-    await tx.wait();
-    return tx;
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), signer);
+    try {
+        const tx = await contract.deposit(token, amount);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to deposit rewards", error);
+    }
 };
 exports.deposit = deposit;

package/dist/contracts/governance/distributor/getClaimableForGauge.js

@@ -6,24 +6,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getClaimableForGauge = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Gets the amount of rewards currently claimable for a gauge.
+ * Estimates the rewards a gauge can still pull from the distributor.
  *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Claimable reward amount (bigint).
+ * @returns The claimable amount, in the distributor's reward token base units.
  */
-const getClaimableForGauge = async (chainId, gauge, provider) => {
+const getClaimableForGauge = async (chainId, gaugeSystem, gaugeAddressOrId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
-    return contract.getClaimableForGauge(gauge);
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    const [claimable, rewardToken] = await Promise.all([contract.getClaimableForGauge(gaugeAddress), contract.rewardToken()]);
+    return (0, amount_1.toTokenAmount)(chainId, rewardToken, claimable);
 };
 exports.getClaimableForGauge = getClaimableForGauge;

package/dist/contracts/governance/distributor/getClaimedAtEpoch.js

@@ -6,25 +6,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getClaimedAtEpoch = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Gets the amount claimed by a gauge at a specific epoch.
+ * Returns how much a gauge has already pulled for an epoch.
  *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
- * @param epoch - The epoch to query.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param epoch - Epoch start timestamp, seconds.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Amount claimed at the epoch (bigint).
+ * @returns The claimed amount, in the distributor's reward token base units.
  */
-const getClaimedAtEpoch = async (chainId, gauge, epoch, provider) => {
+const getClaimedAtEpoch = async (chainId, gaugeSystem, gaugeAddressOrId, epoch, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
-    return contract.claimedAtEpoch(gauge, epoch);
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    const [claimed, rewardToken] = await Promise.all([contract.claimedAtEpoch(gaugeAddress, epoch), contract.rewardToken()]);
+    return (0, amount_1.toTokenAmount)(chainId, rewardToken, claimed);
 };
 exports.getClaimedAtEpoch = getClaimedAtEpoch;

package/dist/contracts/governance/distributor/getDepositedAtEpoch.js

@@ -6,25 +6,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDepositedAtEpoch = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Gets the amount of a token deposited at a specific epoch.
+ * Returns the rewards deposited into the distributor for an epoch.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
  * @param token - Address of the reward token.
- * @param epoch - The epoch to query.
+ * @param epoch - Epoch start timestamp, seconds.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Amount deposited at the epoch (bigint).
+ * @returns The deposited amount, in `token` base units.
  */
-const getDepositedAtEpoch = async (chainId, token, epoch, provider) => {
+const getDepositedAtEpoch = async (chainId, gaugeSystem, token, epoch, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
-    return contract.depositedAtEpoch(token, epoch);
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return (0, amount_1.toTokenAmount)(chainId, token, await contract.depositedAtEpoch(token, epoch));
 };
 exports.getDepositedAtEpoch = getDepositedAtEpoch;

package/dist/contracts/governance/distributor/getDustLastProcessedEpoch.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.getDustLastProcessedEpoch = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the cursor of the last epoch swept by `withdrawDust`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The epoch timestamp, seconds.
+ */
+const getDustLastProcessedEpoch = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.dustLastProcessedEpoch();
+};
+exports.getDustLastProcessedEpoch = getDustLastProcessedEpoch;

package/dist/contracts/governance/distributor/getGaugeController.js

@@ -6,23 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getGaugeController = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the gauge controller address used by the distributor.
+ * Returns the GaugeController the distributor reads weights from.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Gauge controller address (string).
+ * @returns The controller address.
  */
-const getGaugeController = async (chainId, provider) => {
+const getGaugeController = async (chainId, gaugeSystem, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
     return contract.gaugeController();
 };
 exports.getGaugeController = getGaugeController;

package/dist/contracts/governance/distributor/getLastClaimedEpoch.js

@@ -6,24 +6,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLastClaimedEpoch = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the last epoch claimed for a gauge.
+ * Returns the epoch a gauge's next claim starts walking from.
  *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Last claimed epoch (bigint).
+ * @returns The epoch timestamp, seconds.
  */
-const getLastClaimedEpoch = async (chainId, gauge, provider) => {
+const getLastClaimedEpoch = async (chainId, gaugeSystem, gaugeAddressOrId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
-    return contract.lastClaimedEpoch(gauge);
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.lastClaimedEpoch(gaugeAddress);
 };
 exports.getLastClaimedEpoch = getLastClaimedEpoch;

package/dist/contracts/governance/distributor/getMaxClaimBound.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.getMaxClaimBound = 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 whether claim walks are capped and the cap in epochs.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns enabled flag and maxEpochs.
+ */
+const getMaxClaimBound = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    const [enabled, maxEpochs] = await Promise.all([contract.enableMaxClaimBound(), contract.MAX_EPOCHS()]);
+    return { enabled, maxEpochs };
+};
+exports.getMaxClaimBound = getMaxClaimBound;

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

@@ -6,23 +6,23 @@ 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 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the distributor's period (epoch) duration in seconds.
+ * Returns the distributor's period duration.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Period duration in seconds (bigint).
+ * @returns The period duration, seconds.
  */
-const getPeriodDuration = async (chainId, provider) => {
+const getPeriodDuration = async (chainId, gaugeSystem, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
     return contract.PERIOD_DURATION();
 };
 exports.getPeriodDuration = getPeriodDuration;

package/dist/contracts/governance/distributor/getRewardToken.js

@@ -6,23 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRewardToken = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the reward token address used by the distributor.
+ * Returns the single reward token the distributor pays out.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Reward token address (string).
+ * @returns The reward token address.
  */
-const getRewardToken = async (chainId, provider) => {
+const getRewardToken = async (chainId, gaugeSystem, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
     return contract.rewardToken();
 };
 exports.getRewardToken = getRewardToken;

package/dist/contracts/governance/distributor/getRewardTokenInfo.js

@@ -6,24 +6,33 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRewardTokenInfo = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Gets aggregate statistics for the distributor's reward token.
+ * Reads the reward token totals and the distributor's current token balance.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Object with totalDeposited, totalDistributed, totalClaimable and balance (all bigint).
+ * @returns totalDeposited, totalDistributed, totalClaimable and balance, in the distributor's reward token base units.
  */
-const getRewardTokenInfo = async (chainId, provider) => {
+const getRewardTokenInfo = async (chainId, gaugeSystem, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
-    const [totalDeposited, totalDistributed, totalClaimable, balance] = await contract.getRewardTokenInfo();
-    return { totalDeposited, totalDistributed, totalClaimable, balance };
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    const [[totalDeposited, totalDistributed, totalClaimable, balance], rewardToken] = await Promise.all([
+        contract.getRewardTokenInfo(),
+        contract.rewardToken(),
+    ]);
+    return {
+        totalDeposited: (0, amount_1.toTokenAmount)(chainId, rewardToken, totalDeposited),
+        totalDistributed: (0, amount_1.toTokenAmount)(chainId, rewardToken, totalDistributed),
+        totalClaimable: (0, amount_1.toTokenAmount)(chainId, rewardToken, totalClaimable),
+        balance: (0, amount_1.toTokenAmount)(chainId, rewardToken, balance),
+    };
 };
 exports.getRewardTokenInfo = getRewardTokenInfo;

package/dist/contracts/governance/distributor/getRewardTokenStats.js

@@ -6,25 +6,30 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRewardTokenStats = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const amount_1 = require("../../../utils/amount");
 /**
- * Reads the rewardTokenInfo mapping entry for a given token.
+ * Reads the `rewardTokenInfo` mapping entry for a token.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
  * @param token - Address of the reward token.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Object with totalDeposited, totalDistributed and totalClaimable (all bigint).
+ * @returns totalDeposited, totalDistributed and totalClaimable, in `token` base units.
  */
-const getRewardTokenStats = async (chainId, token, provider) => {
+const getRewardTokenStats = async (chainId, gaugeSystem, token, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
     const [totalDeposited, totalDistributed, totalClaimable] = await contract.rewardTokenInfo(token);
-    return { totalDeposited, totalDistributed, totalClaimable };
+    return {
+        totalDeposited: (0, amount_1.toTokenAmount)(chainId, token, totalDeposited),
+        totalDistributed: (0, amount_1.toTokenAmount)(chainId, token, totalDistributed),
+        totalClaimable: (0, amount_1.toTokenAmount)(chainId, token, totalClaimable),
+    };
 };
 exports.getRewardTokenStats = getRewardTokenStats;

package/dist/contracts/governance/distributor/index.js

@@ -21,13 +21,16 @@ __exportStar(require("./deposit"), exports);
 __exportStar(require("./getClaimableForGauge"), exports);
 __exportStar(require("./getClaimedAtEpoch"), exports);
 __exportStar(require("./getDepositedAtEpoch"), exports);
+__exportStar(require("./getDustLastProcessedEpoch"), exports);
 __exportStar(require("./getGaugeController"), exports);
 __exportStar(require("./getLastClaimedEpoch"), exports);
+__exportStar(require("./getMaxClaimBound"), exports);
 __exportStar(require("./getPeriodDuration"), exports);
 __exportStar(require("./getRewardToken"), exports);
 __exportStar(require("./getRewardTokenInfo"), exports);
 __exportStar(require("./getRewardTokenStats"), exports);
-__exportStar(require("./getStartEpoch"), exports);
 __exportStar(require("./setController"), exports);
+__exportStar(require("./setLastClaimedEpoch"), exports);
+__exportStar(require("./setMaxClaimBound"), exports);
+__exportStar(require("./withdrawDust"), exports);
 __exportStar(require("./withdrawRemovedGaugeRewards"), exports);
-__exportStar(require("./withdrawUnallocatedRewards"), exports);

package/dist/contracts/governance/distributor/setController.js

@@ -2,25 +2,30 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setController = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
 /**
- * Sets the gauge controller for the distributor.
- * Requires DEFAULT_ADMIN_ROLE.
+ * Points the distributor at a different GaugeController. Requires DEFAULT_ADMIN_ROLE.
  *
  * @param chainId - The chain/network to use.
- * @param controller - Address of the new gauge controller.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param controller - Address of the new controller.
  * @param signer - An ethers.js Signer instance (required).
- * @returns Transaction after it has been mined.
+ * @returns The transaction after it has been mined.
  */
-const setController = async (chainId, controller, signer) => {
+const setController = async (chainId, gaugeSystem, controller, signer) => {
     if (!signer)
         throw new Error("Signer is required");
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(address, abi, signer);
-    const tx = await contract.setController(controller);
-    await tx.wait();
-    return tx;
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), signer);
+    try {
+        const tx = await contract.setController(controller);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to set controller", error);
+    }
 };
 exports.setController = setController;

package/dist/contracts/governance/distributor/setLastClaimedEpoch.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setLastClaimedEpoch = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Bootstraps a new gauge's claim checkpoint. Requires CONTROLLER_ROLE; the controller calls it from `addGauge`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const setLastClaimedEpoch = async (chainId, gaugeSystem, gaugeAddressOrId, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), signer);
+    try {
+        const tx = await contract.setLastClaimedEpoch(gaugeAddress);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to set last claimed epoch", error);
+    }
+};
+exports.setLastClaimedEpoch = setLastClaimedEpoch;

package/dist/contracts/governance/distributor/setMaxClaimBound.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setMaxClaimBound = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Caps how many epochs a claim walks per call (MAX_EPOCHS). Requires DISTRIBUTOR_ADMIN.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param enabled - True to cap claim walks.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const setMaxClaimBound = async (chainId, gaugeSystem, enabled, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), signer);
+    try {
+        const tx = await contract.setMaxClaimBound(enabled);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to set max claim bound", error);
+    }
+};
+exports.setMaxClaimBound = setMaxClaimBound;

package/dist/contracts/governance/distributor/withdrawDust.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withdrawDust = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Sweeps leftover rewards from fully settled epochs to a recipient. Requires DEFAULT_ADMIN_ROLE. Reverts when there is nothing new to sweep.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param recipient - Address that receives the dust.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const withdrawDust = async (chainId, gaugeSystem, recipient, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), signer);
+    try {
+        const tx = await contract.withdrawDust(recipient);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to withdraw dust", error);
+    }
+};
+exports.withdrawDust = withdrawDust;