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

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

@@ -2,23 +2,30 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.kick = 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");
 /**
- * Kicks a user, forcing a re-checkpoint of their vote power (e.g. after their veToken lock expired).
+ * Writes down the vote weight of a user whose locks have expired. Reverts during a global pause.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param user - Address of the user to kick.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-const kick = async (chainId, user, signer) => {
+const kick = async (chainId, gaugeSystem, user, signer) => {
     if (!signer)
         throw new Error("Signer is required");
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, signer);
-    const tx = await contract.kick(user);
-    await tx.wait();
-    return tx;
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.kick(user);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to kick user", error);
+    }
 };
 exports.kick = kick;

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

@@ -2,23 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.removeGauge = 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");
 /**
- * Removes a gauge from the GaugeController. Requires the GAUGE_ADMIN role.
+ * Removes a gauge from the controller permanently. Requires GAUGE_ADMIN. Kicks the gauge's weight, unregisters it and redirects its unclaimed distributor entitlement to `recipient` in the same transaction. Not pause-gated.
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge to remove.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param recipient - Address that receives the gauge's unclaimed rewards.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-const removeGauge = async (chainId, gauge, signer) => {
+const removeGauge = async (chainId, gaugeSystem, gaugeAddressOrId, recipient, signer) => {
     if (!signer)
         throw new Error("Signer is required");
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, signer);
-    const tx = await contract.removeGauge(gauge);
-    await tx.wait();
-    return tx;
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.removeGauge(gaugeAddress, recipient);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to remove gauge", error);
+    }
 };
 exports.removeGauge = removeGauge;

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

@@ -2,23 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.removePowerFromGauge = 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");
 /**
- * Removes the caller's allocated vote power from a gauge.
+ * Releases the vote power a user still has on a removed gauge. For a paused (still active) gauge, vote 0 instead.
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge to remove power from.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-const removePowerFromGauge = async (chainId, gauge, signer) => {
+const removePowerFromGauge = async (chainId, gaugeSystem, gaugeAddressOrId, signer) => {
     if (!signer)
         throw new Error("Signer is required");
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, signer);
-    const tx = await contract.removePowerFromGauge(gauge);
-    await tx.wait();
-    return tx;
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.removePowerFromGauge(gaugeAddress);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to remove power from gauge", error);
+    }
 };
 exports.removePowerFromGauge = removePowerFromGauge;

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

@@ -2,24 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setBoostAmplificationEnabled = 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");
 /**
- * Enables or disables boost amplification for a gauge. Requires the GAUGE_ADMIN role.
+ * Enables or disables boost amplification for a gauge. Requires GAUGE_ADMIN.
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
- * @param enabled - Whether boost amplification should be enabled.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param enabled - True to enable amplification.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-const setBoostAmplificationEnabled = async (chainId, gauge, enabled, signer) => {
+const setBoostAmplificationEnabled = async (chainId, gaugeSystem, gaugeAddressOrId, enabled, signer) => {
     if (!signer)
         throw new Error("Signer is required");
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, signer);
-    const tx = await contract.setBoostAmplificationEnabled(gauge, enabled);
-    await tx.wait();
-    return tx;
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.setBoostAmplificationEnabled(gaugeAddress, enabled);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to set boost amplification", error);
+    }
 };
 exports.setBoostAmplificationEnabled = setBoostAmplificationEnabled;

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setDistributor = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Sets the GaugeRewardsDistributor wired to the controller. Requires GAUGE_ADMIN.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param distributor - Address of the new distributor.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const setDistributor = async (chainId, gaugeSystem, distributor, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.setDistributor(distributor);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to set distributor", error);
+    }
+};
+exports.setDistributor = setDistributor;

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

@@ -2,24 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setEmergencyGaugePause = 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");
 /**
- * Emergency-pauses or unpauses a single gauge. Requires the EMERGENCY_ADMIN role.
+ * Pauses or unpauses a single gauge. Requires EMERGENCY_ADMIN. Flips only the gauge's own switch: votes and weight are kept and its share stays in the distributor until it is unpaused. Pausing requires a registered gauge; unpausing also works for a removed one.
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
- * @param paused - Whether the gauge should be paused.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param paused - True to pause, false to unpause.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-const setEmergencyGaugePause = async (chainId, gauge, paused, signer) => {
+const setEmergencyGaugePause = async (chainId, gaugeSystem, gaugeAddressOrId, paused, signer) => {
     if (!signer)
         throw new Error("Signer is required");
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, signer);
-    const tx = await contract.setEmergencyGaugePause(gauge, paused);
-    await tx.wait();
-    return tx;
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.setEmergencyGaugePause(gaugeAddress, paused);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to set gauge pause", error);
+    }
 };
 exports.setEmergencyGaugePause = setEmergencyGaugePause;

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

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEmergencyGaugePauseBatch = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Pauses or unpauses several gauges in one transaction. Requires EMERGENCY_ADMIN. All-or-nothing: a zero address, pausing an unregistered gauge, or a gauge already in its requested state reverts the whole batch.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressesOrIds - Addresses or config ids of the gauges.
+ * @param statuses - Requested pause state per gauge, index-aligned with the gauges.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const setEmergencyGaugePauseBatch = async (chainId, gaugeSystem, gaugeAddressesOrIds, statuses, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddresses = gaugeAddressesOrIds.map((g) => (0, _helpers_1.resolveGauge)(chainId, g));
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.setEmergencyGaugePauseBatch(gaugeAddresses, statuses);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to set gauge pause batch", error);
+    }
+};
+exports.setEmergencyGaugePauseBatch = setEmergencyGaugePauseBatch;

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

@@ -2,23 +2,30 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setEmergencyPause = 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");
 /**
- * Emergency-pauses or unpauses the entire GaugeController. Requires the EMERGENCY_ADMIN role.
+ * Sets the controller's global emergency pause. Requires EMERGENCY_ADMIN. Does not touch any gauge's own switch, so individually paused gauges stay paused after a global unpause.
+ *
  * @param chainId - The chain/network to use.
- * @param paused - Whether the contract should be paused.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param paused - True to pause, false to unpause.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-const setEmergencyPause = async (chainId, paused, signer) => {
+const setEmergencyPause = async (chainId, gaugeSystem, paused, signer) => {
     if (!signer)
         throw new Error("Signer is required");
-    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-    const abi = (0, artifacts_1.getABI)("gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(address, abi, signer);
-    const tx = await contract.setEmergencyPause(paused);
-    await tx.wait();
-    return tx;
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.setEmergencyPause(paused);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to set emergency pause", error);
+    }
 };
 exports.setEmergencyPause = setEmergencyPause;

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setMaxVoteBuckets = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Sets the per-vote decay-bucket cap. Requires GAUGE_ADMIN. 0 is exact; 2 to 64 caps heavy multi-lock voters; 1 is rejected.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param maxBuckets - 0, or 2 to 64.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const setMaxVoteBuckets = async (chainId, gaugeSystem, maxBuckets, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.setMaxVoteBuckets(maxBuckets);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to set max vote buckets", error);
+    }
+};
+exports.setMaxVoteBuckets = setMaxVoteBuckets;

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

@@ -2,33 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.vote = 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");
 /**
- * Calls the vote function on the GaugeController contract.
+ * Allocates vote weight to a gauge. Reverts with GaugePaused for a non-zero vote on a paused gauge, and with EnforcedPause during a global pause.
  *
  * @param chainId - The chain/network to use.
- * @param gaugeAddress - The address of the gauge you wish to vote for.
- * @param voteWeight - The vote weight to allocate (uint256).
- * @param signer - An ethers.js Signer instance (must be connected to wallet).
- * @returns Transaction receipt after the vote is cast.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param voteWeight - Vote weight in basis points.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
  */
-const vote = async (chainId, gaugeAddress, voteWeight, signer) => {
-    if (!signer) {
+const vote = async (chainId, gaugeSystem, gaugeAddressOrId, voteWeight, signer) => {
+    if (!signer)
         throw new Error("Signer is required");
-    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
     try {
-        const gaugeControllerAddress = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-        const gaugeControllerABI = (0, artifacts_1.getABI)("gaugecontroller");
-        const gaugeControllerContract = new ethers_1.ethers.Contract(gaugeControllerAddress, gaugeControllerABI, signer);
-        const tx = await gaugeControllerContract.vote(gaugeAddress, voteWeight);
+        const tx = await contract.vote(gaugeAddress, voteWeight);
         await tx.wait();
-        console.log(`Vote cast for gauge: ${gaugeAddress}`);
         return tx;
     }
     catch (error) {
-        console.error("Error voting:", error);
-        throw new Error(`Failed to vote: ${error.message}`);
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to vote", error);
     }
 };
 exports.vote = vote;

package/dist/contracts/governance/gaugeSystems/_helpers.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGauge = exports.lookupGauge = exports.listGauges = exports.resolveGaugeDistributor = exports.resolveGaugeController = exports.requireGaugeSystem = exports.getGaugeSystemsConfig = exports.GAUGE_SYSTEM_IDS = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+exports.GAUGE_SYSTEM_IDS = ["raacgauges", "rwagauges"];
+const isDeployed = (address) => !!address && ethers_1.ethers.isAddress(address) && address !== ethers_1.ethers.ZeroAddress;
+/**
+ * Reads the `gauges` section of a chain config.
+ *
+ * @param chainId - The chain/network to use.
+ * @returns The configured gauge systems keyed by id; systems missing from the config are absent.
+ */
+const getGaugeSystemsConfig = (chainId) => {
+    const config = chains_1.default[chainId];
+    if (!config) {
+        throw new Error(`Chain configuration not found for chainId: ${chainId}`);
+    }
+    return (config.gauges ?? {});
+};
+exports.getGaugeSystemsConfig = getGaugeSystemsConfig;
+/**
+ * Looks up one gauge system in the chain config.
+ *
+ * @param chainId - The chain/network to use.
+ * @param system - Gauge system id, any case.
+ * @returns The system config.
+ * @throws If the id is unknown or the chain does not configure it.
+ */
+const requireGaugeSystem = (chainId, system) => {
+    const id = system.toLowerCase();
+    if (!exports.GAUGE_SYSTEM_IDS.includes(id)) {
+        throw new Error(`Unknown gauge system "${system}". Expected one of: ${exports.GAUGE_SYSTEM_IDS.join(", ")}`);
+    }
+    const found = (0, exports.getGaugeSystemsConfig)(chainId)[id];
+    if (!found) {
+        throw new Error(`Gauge system "${id}" is not configured for chainId: ${chainId}`);
+    }
+    return found;
+};
+exports.requireGaugeSystem = requireGaugeSystem;
+const resolveSystemContract = (chainId, ref, field, name) => {
+    if (!ref) {
+        throw new Error(`Gauge system or ${name} address is required`);
+    }
+    if (ethers_1.ethers.isAddress(ref)) {
+        return (0, _helpers_1.requireAddress)(ref, name);
+    }
+    const system = (0, exports.requireGaugeSystem)(chainId, ref);
+    if (!isDeployed(system[field])) {
+        throw new Error(`Gauge system "${system.id}" has no ${name} deployed on chainId: ${chainId}`);
+    }
+    return ethers_1.ethers.getAddress(system[field]);
+};
+/**
+ * Resolves the GaugeController a controller method targets.
+ *
+ * @param chainId - The chain/network to use.
+ * @param ref - Gauge system id or a GaugeController address.
+ * @returns The checksummed GaugeController address.
+ */
+const resolveGaugeController = (chainId, ref) => resolveSystemContract(chainId, ref, "controller", "GaugeController");
+exports.resolveGaugeController = resolveGaugeController;
+/**
+ * Resolves the GaugeRewardsDistributor a distributor method targets.
+ *
+ * @param chainId - The chain/network to use.
+ * @param ref - Gauge system id or a GaugeRewardsDistributor address.
+ * @returns The checksummed GaugeRewardsDistributor address.
+ */
+const resolveGaugeDistributor = (chainId, ref) => resolveSystemContract(chainId, ref, "distributor", "GaugeRewardsDistributor");
+exports.resolveGaugeDistributor = resolveGaugeDistributor;
+/**
+ * Lists gauges from the chain config, tagged with their system.
+ *
+ * @param chainId - The chain/network to use.
+ * @param system - Optional gauge system id; all systems when omitted.
+ * @returns The configured gauges.
+ */
+const listGauges = (chainId, system) => {
+    const systems = system ? [(0, exports.requireGaugeSystem)(chainId, system)] : Object.values((0, exports.getGaugeSystemsConfig)(chainId));
+    return systems.flatMap((s) => (s?.gauges ?? []).map((g) => ({ ...g, system: s.id, gaugeType: s.gaugeType })));
+};
+exports.listGauges = listGauges;
+/**
+ * Finds a gauge in the chain config by address or id.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Gauge address or config id, any case.
+ * @returns The gauge tagged with its system, or null if the config does not list it.
+ */
+const lookupGauge = (chainId, gaugeAddressOrId) => {
+    const target = gaugeAddressOrId.toLowerCase();
+    const field = ethers_1.ethers.isAddress(target) ? "contract" : "id";
+    return (0, exports.listGauges)(chainId).find((g) => g[field].toLowerCase() === target) ?? null;
+};
+exports.lookupGauge = lookupGauge;
+/**
+ * Resolves a gauge argument to an address. Addresses pass through, so gauges missing from the
+ * config still work; ids are looked up across every gauge system.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Gauge address or config id.
+ * @returns The checksummed gauge address.
+ */
+const resolveGauge = (chainId, gaugeAddressOrId) => {
+    if (!gaugeAddressOrId) {
+        throw new Error("Gauge address or id is required");
+    }
+    if (ethers_1.ethers.isAddress(gaugeAddressOrId)) {
+        return ethers_1.ethers.getAddress(gaugeAddressOrId);
+    }
+    const gauge = (0, exports.lookupGauge)(chainId, gaugeAddressOrId);
+    if (!gauge) {
+        throw new Error(`Gauge "${gaugeAddressOrId}" not found in any gauge system for chainId: ${chainId}`);
+    }
+    return (0, _helpers_1.requireAddress)(gauge.contract, "gauge");
+};
+exports.resolveGauge = resolveGauge;

package/dist/contracts/governance/gaugeSystems/findGauge.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findGauge = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Finds a gauge in the chain config by address or id and reports which system it belongs to.
+ * Reads the chain config only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Gauge address or config id, any case.
+ * @returns The gauge tagged with its system and gauge type, or null if the config does not list it.
+ */
+const findGauge = (chainId, gaugeAddressOrId) => (0, _helpers_1.lookupGauge)(chainId, gaugeAddressOrId);
+exports.findGauge = findGauge;

package/dist/contracts/governance/gaugeSystems/getGaugeSystem.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeSystem = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Returns one gauge system from the chain config.
+ * Reads the chain config only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @param system - Gauge system id: "raacgauges" or "rwagauges".
+ * @returns The system's label, gauge type, controller and distributor addresses and gauge list.
+ */
+const getGaugeSystem = (chainId, system) => (0, _helpers_1.requireGaugeSystem)(chainId, system);
+exports.getGaugeSystem = getGaugeSystem;

package/dist/contracts/governance/gaugeSystems/getGaugeSystems.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeSystems = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Lists the gauge systems configured for a chain (RAAC gauges, RWA gauges).
+ * Reads the chain config only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @returns Each system with its id, label, gauge type, controller and distributor addresses and gauge list.
+ */
+const getGaugeSystems = (chainId) => Object.values((0, _helpers_1.getGaugeSystemsConfig)(chainId)).filter((s) => !!s);
+exports.getGaugeSystems = getGaugeSystems;

package/dist/contracts/governance/gaugeSystems/getGauges.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGauges = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Lists the gauges in the chain config, each tagged with the system it belongs to.
+ * Reads the chain config only; no RPC call is made. For the controller's on-chain list use
+ * `governance.controller.getRegisteredGaugeList`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param system - Optional gauge system id; gauges of every system when omitted.
+ * @returns The configured gauges with their addresses.
+ */
+const getGauges = (chainId, system) => (0, _helpers_1.listGauges)(chainId, system);
+exports.getGauges = getGauges;

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

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Re-exports every method in this namespace.
+__exportStar(require("./findGauge"), exports);
+__exportStar(require("./getGauges"), exports);
+__exportStar(require("./getGaugeSystem"), exports);
+__exportStar(require("./getGaugeSystems"), exports);

package/dist/types/RPCLibrary.d.ts

@@ -111,6 +111,7 @@ import { decodeErrorName, getErrorInfo, attachDecodedError, decodeErrorMessage,
 import * as distributorMethods from "./contracts/governance/distributor";
 import * as gaugeMethods from "./contracts/governance/gauge";
 import * as controllerMethods from "./contracts/governance/gaugeController";
+import * as gaugeSystemMethods from "./contracts/governance/gaugeSystems";
 import { cancel as cancelProposals } from "./contracts/governance/proposals/cancel";
 import { getQuorumNumerator as getQuorumNumeratorProposals } from "./contracts/governance/proposals/getQuorumNumerator";
 import { getVotingPeriod as getVotingPeriodProposals } from "./contracts/governance/proposals/getVotingPeriod";
@@ -363,6 +364,7 @@ declare class RPCLibrary {
         distributor: typeof distributorMethods;
         gauge: typeof gaugeMethods;
         controller: typeof controllerMethods;
+        gaugeSystems: typeof gaugeSystemMethods;
         proposals: {
             cancel: typeof cancelProposals;
             getQuorumNumerator: typeof getQuorumNumeratorProposals;