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

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 (10000 = 100% of the caller's voting power).
+ * @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/contracts/governance/proposals/cancel.js

@@ -2,26 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cancel = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
- * Cancels an active proposal.
- * Allows cancellation by proposer or if proposer's voting power drops below threshold.
+ * Cancels a proposal.
  * - Only cancellable before execution
  * - Proposer can always cancel their proposal
- * - Automatic cancellation if proposer loses required voting power
+ * - A `CANCELLATION_ROLE` holder can cancel any proposal
+ * - If the proposal is queued, the pending operation is also cancelled in the timelock it was queued in
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal to cancel.
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt after the proposal is canceled.
  */
-const cancel = async (chainId, proposalId, signer) => {
+const cancel = async (chainId, governance, proposalId, signer) => {
     if (!signer) {
         throw new Error("Signer is required");
     }
     try {
-        const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "governance");
+        const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
         const abi = (0, artifacts_1.getABI)("governance");
         const contract = new ethers_1.ethers.Contract(contractAddress, abi, signer);
         const tx = await contract.cancel(proposalId);
@@ -31,7 +32,7 @@ const cancel = async (chainId, proposalId, signer) => {
     }
     catch (error) {
         console.error("Error canceling proposal:", error);
-        throw new Error(`Failed to cancel proposal: ${error.message}`);
+        throw (0, _helpers_1.toGovernanceTxError)("Failed to cancel proposal", error);
     }
 };
 exports.cancel = cancel;

package/dist/contracts/governance/proposals/castVote.js

@@ -2,8 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.castVote = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
+const amount_1 = require("../../../utils/amount");
 /**
  * Casts a vote on a governance proposal.
  * Allows veToken holders to vote on active proposals.
@@ -12,17 +13,18 @@ const artifacts_1 = require("../../../utils/artifacts");
  * - Voting window between start and end times
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal to vote on.
  * @param support - True to vote in favor, false to vote against.
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
- * @returns Transaction receipt and the voting power used.
+ * @returns The mined transaction and the voting power the vote carried, in veRAAC base units (undefined when the VoteCast event could not be read).
  */
-const castVote = async (chainId, proposalId, support, signer) => {
+const castVote = async (chainId, governance, proposalId, support, signer) => {
     if (!signer) {
         throw new Error("Signer is required");
     }
     try {
-        const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "governance");
+        const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
         const abi = (0, artifacts_1.getABI)("governance");
         const contract = new ethers_1.ethers.Contract(contractAddress, abi, signer);
         const tx = await contract.castVote(proposalId, support);
@@ -33,12 +35,12 @@ const castVote = async (chainId, proposalId, support, signer) => {
         console.log(`Vote cast on proposal ${proposalId}: ${support ? "FOR" : "AGAINST"} with weight ${weight ? ethers_1.ethers.formatEther(weight) : "unknown"}`);
         return {
             tx,
-            weight: weight ? ethers_1.ethers.formatEther(weight) : undefined,
+            weight: weight === undefined ? undefined : (0, amount_1.toTokenAmount)(chainId, "veraac", weight),
         };
     }
     catch (error) {
         console.error("Error casting vote:", error);
-        throw new Error(`Failed to cast vote: ${error.message}`);
+        throw (0, _helpers_1.toGovernanceTxError)("Failed to cast vote", error);
     }
 };
 exports.castVote = castVote;

package/dist/contracts/governance/proposals/execute.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.execute = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Executes a successful proposal through the timelock.
@@ -11,17 +11,18 @@ const artifacts_1 = require("../../../utils/artifacts");
  * 2. Execute - Execute proposal after timelock delay
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal to execute.
- * @param value - Optional ETH value to send with the execution (for payable actions).
+ * @param value - Optional ETH value to send with the execution, in wei (for payable actions).
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt after the proposal is queued or executed.
  */
-const execute = async (chainId, proposalId, value = 0, signer) => {
+const execute = async (chainId, governance, proposalId, value = 0n, signer) => {
     if (!signer) {
         throw new Error("Signer is required");
     }
     try {
-        const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "governance");
+        const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
         const abi = (0, artifacts_1.getABI)("governance");
         const contract = new ethers_1.ethers.Contract(contractAddress, abi, signer);
         const tx = await contract.execute(proposalId, { value });
@@ -31,7 +32,7 @@ const execute = async (chainId, proposalId, value = 0, signer) => {
     }
     catch (error) {
         console.error("Error executing proposal:", error);
-        throw new Error(`Failed to execute proposal: ${error.message}`);
+        throw (0, _helpers_1.toGovernanceTxError)("Failed to execute proposal", error);
     }
 };
 exports.execute = execute;

package/dist/contracts/governance/proposals/getGovernances.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGovernances = void 0;
+const chains_1 = __importDefault(require("../../../configs/chains"));
+/**
+ * Lists the Governance instances configured for a chain.
+ * Reads the chain config only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @returns Each configured instance with its id, label, governance and timelock addresses.
+ */
+const getGovernances = (chainId) => {
+    const config = chains_1.default[chainId];
+    if (!config) {
+        throw new Error(`Chain configuration not found for chainId: ${chainId}`);
+    }
+    return (config.proposals ?? []);
+};
+exports.getGovernances = getGovernances;

package/dist/contracts/{tokens/veRAAC/getEffectiveLockEnd.js → governance/proposals/getLabel.js}

@@ -3,28 +3,27 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEffectiveLockEnd = void 0;
+exports.getLabel = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
- * Gets the weighted average lock end time for a user.
+ * Gets the category label this Governance instance was deployed for.
  *
  * @param chainId - The chain/network to use.
- * @param address - The address to query.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
- * @returns The effective lock end timestamp.
+ * @returns The instance label.
  */
-const getEffectiveLockEnd = async (chainId, address, provider) => {
+const getLabel = async (chainId, governance, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "veraac");
-    const abi = (0, artifacts_1.getABI)("veraac");
+    const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
+    const abi = (0, artifacts_1.getABI)("governance");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
-    const lockEnd = await contract.getEffectiveLockEnd(address);
-    return Number(lockEnd);
+    return await contract.label();
 };
-exports.getEffectiveLockEnd = getEffectiveLockEnd;
+exports.getLabel = getLabel;

package/dist/contracts/governance/proposals/getProposal.js

@@ -3,54 +3,50 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getProposal = exports.ProposalType = void 0;
+exports.getProposal = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
-/**
- * Proposal types enum matching the contract
- */
-var ProposalType;
-(function (ProposalType) {
-    ProposalType[ProposalType["ParameterChange"] = 0] = "ParameterChange";
-    ProposalType[ProposalType["SmartContractUpgrade"] = 1] = "SmartContractUpgrade";
-    ProposalType[ProposalType["TreasuryAction"] = 2] = "TreasuryAction";
-    ProposalType[ProposalType["EmissionChange"] = 3] = "EmissionChange";
-    ProposalType[ProposalType["GaugeManagement"] = 4] = "GaugeManagement";
-})(ProposalType || (exports.ProposalType = ProposalType = {}));
+const amount_1 = require("../../../utils/amount");
 /**
  * Gets full proposal details.
+ * `timelock` is the zero address until the proposal is queued, after which it is pinned to the timelock it was queued in.
+ * `snapshotBlock`, `quorumNumerator` and `totalVotingPowerAtSnapshot` are captured at creation and never change.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal to query.
  * @param provider - Optional ethers.js Provider instance.
  * @returns Full ProposalCore data.
  */
-const getProposal = async (chainId, proposalId, provider) => {
+const getProposal = async (chainId, governance, proposalId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "governance");
+    const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
     const abi = (0, artifacts_1.getABI)("governance");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
     const proposal = await contract.getProposal(proposalId);
     // Destructure by index: ethers v6 Result extends Array, so `proposal.values`
     // resolves to Array.prototype.values (the iterator) instead of the struct field.
-    const [id, proposer, proposalType, startTime, endTime, executed, canceled, descriptionHash, targets, rawValues, calldatas,] = proposal;
+    const [id, proposer, startTime, endTime, executed, canceled, timelock, descriptionHash, targets, rawValues, calldatas, snapshotBlock, quorumNumerator, totalVotingPowerAtSnapshot,] = proposal;
     return {
         id: Number(id),
         proposer,
-        proposalType: Number(proposalType),
         startTime: Number(startTime),
         endTime: Number(endTime),
         executed,
         canceled,
+        timelock,
         descriptionHash,
         targets: Array.from(targets),
-        values: Array.from(rawValues).map((v) => ethers_1.ethers.formatEther(v)),
+        values: Array.from(rawValues).map((v) => (0, amount_1.toTokenAmount)(chainId, "eth", v)),
         calldatas: Array.from(calldatas),
+        snapshotBlock: Number(snapshotBlock),
+        quorumNumerator,
+        totalVotingPowerAtSnapshot: (0, amount_1.toTokenAmount)(chainId, "veraac", totalVotingPowerAtSnapshot),
     };
 };
 exports.getProposal = getProposal;