@raac/rpc 1.1.0-beta.92 → 1.2.0-beta.10

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

@@ -0,0 +1,46 @@
+"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 });
+// Auto-generated barrel: re-exports every method in this namespace.
+__exportStar(require("./addGauge"), exports);
+__exportStar(require("./batchVote"), exports);
+__exportStar(require("./calculateBoost"), exports);
+__exportStar(require("./forceCompleteCheckpoint"), exports);
+__exportStar(require("./getActiveGauges"), exports);
+__exportStar(require("./getConstants"), exports);
+__exportStar(require("./getCurrentEpoch"), exports);
+__exportStar(require("./getGauge"), exports);
+__exportStar(require("./getGaugeRelativeWeight"), exports);
+__exportStar(require("./getGaugeRelativeWeightView"), exports);
+__exportStar(require("./getGaugeEmissions"), exports);
+__exportStar(require("./getGaugeWeight"), exports);
+__exportStar(require("./getLastVoteTime"), exports);
+__exportStar(require("./getNextEpoch"), exports);
+__exportStar(require("./getTotalWeight"), exports);
+__exportStar(require("./getUserGaugeVotePower"), exports);
+__exportStar(require("./getUserVotePowerRemaining"), exports);
+__exportStar(require("./getVeToken"), exports);
+__exportStar(require("./getVoteUserPower"), exports);
+__exportStar(require("./getVoteUserSlope"), exports);
+__exportStar(require("./isGaugeActive"), exports);
+__exportStar(require("./isPaused"), exports);
+__exportStar(require("./kick"), exports);
+__exportStar(require("./removeGauge"), exports);
+__exportStar(require("./removePowerFromGauge"), exports);
+__exportStar(require("./setBoostAmplificationEnabled"), exports);
+__exportStar(require("./setEmergencyGaugePause"), exports);
+__exportStar(require("./setEmergencyPause"), exports);
+__exportStar(require("./vote"), exports);

package/dist/contracts/governance/gaugeController/isGaugeActive.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.isGaugeActive = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const getContractAddress_1 = require("../../getContractAddress");
+const IS_GAUGE_ACTIVE_ABI = "function isGaugeActive(address gauge) view returns (bool)";
+/**
+ * Checks if a gauge is active.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddress - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns True if gauge is active.
+ */
+const isGaugeActive = async (chainId, gaugeAddress, 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, "gaugecontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, [IS_GAUGE_ACTIVE_ABI], provider);
+    return await contract.isGaugeActive(gaugeAddress);
+};
+exports.isGaugeActive = isGaugeActive;

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

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPaused = 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");
+/**
+ * Checks whether the GaugeController is currently paused.
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns True if the contract is paused, false otherwise.
+ */
+const isPaused = async (chainId, 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, "gaugecontroller");
+    const abi = (0, artifacts_1.getABI)("gaugecontroller");
+    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    return contract.paused();
+};
+exports.isPaused = isPaused;

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

@@ -0,0 +1,24 @@
+"use strict";
+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");
+/**
+ * Kicks a user, forcing a re-checkpoint of their vote power (e.g. after their veToken lock expired).
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user to kick.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const kick = async (chainId, 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;
+};
+exports.kick = kick;

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

@@ -0,0 +1,24 @@
+"use strict";
+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");
+/**
+ * Removes a gauge from the GaugeController. Requires the GAUGE_ADMIN role.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge to remove.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const removeGauge = async (chainId, gauge, 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;
+};
+exports.removeGauge = removeGauge;

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

@@ -0,0 +1,24 @@
+"use strict";
+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");
+/**
+ * Removes the caller's allocated vote power from a gauge.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge to remove power from.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const removePowerFromGauge = async (chainId, gauge, 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;
+};
+exports.removePowerFromGauge = removePowerFromGauge;

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

@@ -0,0 +1,25 @@
+"use strict";
+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");
+/**
+ * Enables or disables boost amplification for a gauge. Requires the GAUGE_ADMIN role.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param enabled - Whether boost amplification should be enabled.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const setBoostAmplificationEnabled = async (chainId, gauge, 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;
+};
+exports.setBoostAmplificationEnabled = setBoostAmplificationEnabled;

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

@@ -0,0 +1,25 @@
+"use strict";
+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");
+/**
+ * Emergency-pauses or unpauses a single gauge. Requires the EMERGENCY_ADMIN role.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param paused - Whether the gauge should be paused.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const setEmergencyGaugePause = async (chainId, gauge, 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;
+};
+exports.setEmergencyGaugePause = setEmergencyGaugePause;

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

@@ -0,0 +1,24 @@
+"use strict";
+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");
+/**
+ * Emergency-pauses or unpauses the entire GaugeController. Requires the EMERGENCY_ADMIN role.
+ * @param chainId - The chain/network to use.
+ * @param paused - Whether the contract should be paused.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const setEmergencyPause = async (chainId, 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;
+};
+exports.setEmergencyPause = setEmergencyPause;

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

@@ -0,0 +1,34 @@
+"use strict";
+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");
+/**
+ * Calls the vote function on the GaugeController contract.
+ *
+ * @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.
+ */
+const vote = async (chainId, gaugeAddress, voteWeight, signer) => {
+    if (!signer) {
+        throw new Error("Signer is required");
+    }
+    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);
+        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}`);
+    }
+};
+exports.vote = vote;

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancel = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Cancels a proposal.
+ * - Only cancellable before execution
+ * - Proposer can always cancel their proposal
+ * - 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, governance, proposalId, signer) => {
+    if (!signer) {
+        throw new Error("Signer is required");
+    }
+    try {
+        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);
+        await tx.wait();
+        console.log(`Proposal ${proposalId} canceled at ${contractAddress}`);
+        return tx;
+    }
+    catch (error) {
+        console.error("Error canceling proposal:", error);
+        throw (0, _helpers_1.toGovernanceTxError)("Failed to cancel proposal", error);
+    }
+};
+exports.cancel = cancel;

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

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castVote = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Casts a vote on a governance proposal.
+ * Allows veToken holders to vote on active proposals.
+ * - One vote per proposal per address
+ * - Vote weight based on veToken voting power
+ * - 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.
+ */
+const castVote = async (chainId, governance, proposalId, support, signer) => {
+    if (!signer) {
+        throw new Error("Signer is required");
+    }
+    try {
+        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);
+        const receipt = await tx.wait();
+        // Extract vote weight from events
+        const event = receipt.logs.find((log) => log.fragment?.name === "VoteCast");
+        const weight = event?.args?.[3];
+        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,
+        };
+    }
+    catch (error) {
+        console.error("Error casting vote:", error);
+        throw (0, _helpers_1.toGovernanceTxError)("Failed to cast vote", error);
+    }
+};
+exports.castVote = castVote;

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Executes a successful proposal through the timelock.
+ * Two-step execution process:
+ * 1. Queue - Schedule proposal in timelock when vote succeeds
+ * 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 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, governance, proposalId, value = 0, signer) => {
+    if (!signer) {
+        throw new Error("Signer is required");
+    }
+    try {
+        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 });
+        await tx.wait();
+        console.log(`Proposal ${proposalId} executed/queued at ${contractAddress}`);
+        return tx;
+    }
+    catch (error) {
+        console.error("Error executing proposal:", error);
+        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/governance/proposals/getLabel.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.getLabel = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the category label this Governance instance was deployed for.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The instance label.
+ */
+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, _helpers_1.requireAddress)(governance, "Governance");
+    const abi = (0, artifacts_1.getABI)("governance");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    return await contract.label();
+};
+exports.getLabel = getLabel;

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

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProposal = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * 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, governance, proposalId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    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, startTime, endTime, executed, canceled, timelock, descriptionHash, targets, rawValues, calldatas, snapshotBlock, quorumNumerator, totalVotingPowerAtSnapshot,] = proposal;
+    return {
+        id: Number(id),
+        proposer,
+        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)),
+        calldatas: Array.from(calldatas),
+        snapshotBlock: Number(snapshotBlock),
+        quorumNumerator: Number(quorumNumerator),
+        totalVotingPowerAtSnapshot: ethers_1.ethers.formatEther(totalVotingPowerAtSnapshot),
+    };
+};
+exports.getProposal = getProposal;

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

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProposalCount = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the total number of proposals.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The total number of proposals.
+ */
+const getProposalCount = async (chainId, governance, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    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 proposalCount = await contract.getProposalCount();
+    return Number(proposalCount);
+};
+exports.getProposalCount = getProposalCount;

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

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProposalEta = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the timestamp at which a queued proposal becomes executable.
+ * Read from the timelock the proposal 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 query.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Execution timestamp in seconds, or 0 if the proposal has not been queued.
+ */
+const getProposalEta = 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, _helpers_1.requireAddress)(governance, "Governance");
+    const abi = (0, artifacts_1.getABI)("governance");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    const eta = await contract.proposalEta(proposalId);
+    return Number(eta);
+};
+exports.getProposalEta = getProposalEta;

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

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProposalInfo = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets detailed proposal status info.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param proposalId - The ID of the proposal.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Detailed proposal info including state, timing, votes, and quorum.
+ */
+const getProposalInfo = 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, _helpers_1.requireAddress)(governance, "Governance");
+    const abi = (0, artifacts_1.getABI)("governance");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    const [currentState, startTime, endTime, currentTime, forVotes, againstVotes, currentQuorum, requiredQuorum, isExecuted, isCanceled,] = await contract.getProposalInfo(proposalId);
+    return {
+        currentState: Number(currentState),
+        startTime: Number(startTime),
+        endTime: Number(endTime),
+        currentTime: Number(currentTime),
+        forVotes: ethers_1.ethers.formatEther(forVotes),
+        againstVotes: ethers_1.ethers.formatEther(againstVotes),
+        currentQuorum: ethers_1.ethers.formatEther(currentQuorum),
+        requiredQuorum: ethers_1.ethers.formatEther(requiredQuorum),
+        isExecuted,
+        isCanceled,
+    };
+};
+exports.getProposalInfo = getProposalInfo;