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

package/dist/types/contracts/governance/gaugeController/getGaugeEmissions.d.ts

@@ -0,0 +1,64 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface GaugeEpochEmission {
+    /** Epoch (Unix-week) start timestamp, seconds. */
+    epoch: number;
+    /** System reward emission attributed to this epoch (formatted). For past epochs this
+     * is the actual deposited amount; for the in-progress epoch it is the FULL scheduled
+     * week emission (not the partial tick deposit). */
+    deposited: string;
+    /** RAAC actually deposited into the distributor so far for this epoch (formatted).
+     * For the current epoch this grows via tick() during the week; for past epochs it
+     * equals `deposited`. */
+    depositedSoFar: string;
+    /** Gauge relative weight at this epoch, 1e18-scaled (1e18 = 100%). */
+    relativeWeight: bigint;
+    /** Gauge relative weight as a percentage 0..100. */
+    relativeWeightPct: number;
+    /** RAAC this gauge received/was allocated for this epoch = deposited × relativeWeight. */
+    gaugeEmission: string;
+    gaugeEmissionRaw: bigint;
+    /** True for the in-progress (current) epoch — `deposited` is the scheduled full-week
+     * total, while `depositedSoFar` is what has been ticked in so far. */
+    isCurrent: boolean;
+    /**
+     * True for the upcoming (next) epoch preview. Nothing is deposited yet, so `deposited`
+     * is the PROJECTED system emission for that week (schedule × distributor share) and
+     * `gaugeEmission` is the projection from the gauge's weight at `nextEpoch` — i.e. what
+     * this gauge would receive if voting stays as it currently stands.
+     */
+    isProjected?: boolean;
+}
+export interface GaugeEmissionsResult {
+    gauge: string;
+    rewardToken: string;
+    currentEpoch: number;
+    weekSeconds: number;
+    /** Current-epoch gauge relative weight as a percentage 0..100. */
+    relativeWeightPct: number;
+    /** RAAC allocated to this gauge for the current (in-progress) epoch — the scheduled
+     * full-week total, deterministic from the emission schedule (not the tick deposit). */
+    currentWeekEmission: string;
+    /** RAAC deposited into the distributor so far for the current epoch (tick-based). */
+    currentWeekDepositedSoFar: string;
+    /** Per-epoch series, oldest → newest, ending at the current epoch. */
+    epochs: GaugeEpochEmission[];
+}
+/**
+ * Per-epoch emissions for a gauge. The GaugeController snapshots gauge weights per epoch
+ * and the GaugeRewardsDistributor records the RAAC deposited per epoch, so for a COMPLETED
+ * epoch a gauge's emission is:
+ *   depositedAtEpoch(epoch) × gaugeRelativeWeight(gauge, epoch).
+ *
+ * For the in-progress epoch, `depositedAtEpoch` only reflects what has been ticked in so
+ * far and keeps growing through the week — which is misleading. Since the emission schedule
+ * already determines the full week's emission, the current (and upcoming) epoch instead use
+ *   scheduledWeekEmission(epoch) × gaugeRelativeWeight(gauge, epoch)
+ * where scheduledWeekEmission = minter.calculateScheduledMintableAmount(week) × distributorShare.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gauge - Gauge address (or config key).
+ * @param numEpochs - How many epochs to include, ending at the current one (default 8).
+ * @param provider - Optional ethers.js Provider instance.
+ */
+export declare const getGaugeEmissions: (chainId: ChainId, gauge: string, numEpochs?: number, includeUpcoming?: boolean, provider?: Provider) => Promise<GaugeEmissionsResult>;

package/dist/types/contracts/governance/gaugeController/getGaugeRelativeWeight.d.ts

@@ -0,0 +1,15 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Computes and checkpoints a gauge's relative weight at a given epoch.
+ *
+ * This is a state-modifying call (it writes checkpoints), so it requires a Signer.
+ * For a pure read with no state changes, use getGaugeRelativeWeightView instead.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param epoch - Epoch timestamp to checkpoint.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+export declare const getGaugeRelativeWeight: (chainId: ChainId, gauge: string, epoch: string | number | bigint, signer: Signer) => Promise<any>;

package/dist/types/contracts/governance/gaugeController/getGaugeRelativeWeightView.d.ts

@@ -0,0 +1,14 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Reads a gauge's relative weight at a given epoch without modifying state.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param epoch - Epoch timestamp to query.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns An object with relativeWeight (1e18-scaled, where 1e18 = 100%) and totalWeight, both bigint.
+ */
+export declare const getGaugeRelativeWeightView: (chainId: ChainId, gauge: string, epoch: string | number | bigint, provider?: Provider) => Promise<{
+    relativeWeight: bigint;
+    totalWeight: bigint;
+}>;

package/dist/types/contracts/governance/gaugeController/getGaugeWeight.d.ts

@@ -0,0 +1,11 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Gets the weight of a gauge.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddress - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Weight of the gauge formatted in ether units.
+ */
+export declare const getGaugeWeight: (chainId: ChainId, gaugeAddress: string, provider?: Provider) => Promise<string>;

package/dist/types/contracts/governance/gaugeController/getLastVoteTime.d.ts

@@ -0,0 +1,11 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Gets the timestamp of a user's last vote on a given gauge.
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user.
+ * @param gauge - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The last vote timestamp as a bigint.
+ */
+export declare const getLastVoteTime: (chainId: ChainId, user: string, gauge: string, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getNextEpoch.d.ts

@@ -0,0 +1,9 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Gets the next epoch boundary (current epoch plus one week) from the GaugeController.
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Next epoch timestamp as a bigint.
+ */
+export declare const getNextEpoch: (chainId: ChainId, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getTotalWeight.d.ts

@@ -0,0 +1,10 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Gets the total weight of all active gauges.
+ *
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Total weight of all active gauges formatted in ether units.
+ */
+export declare const getTotalWeight: (chainId: ChainId, provider?: Provider) => Promise<string>;

package/dist/types/contracts/governance/gaugeController/getUserGaugeVotePower.d.ts

@@ -0,0 +1,11 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Gets the vote weight (in basis points) a user has allocated to a gauge.
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user.
+ * @param gauge - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Vote weight in basis points as a bigint.
+ */
+export declare const getUserGaugeVotePower: (chainId: ChainId, user: string, gauge: string, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getUserVotePowerRemaining.d.ts

@@ -0,0 +1,11 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Get user's remaining voting power available.
+ *
+ * @param chainId - The chain/network to use.
+ * @param userAddress - Address of the user.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Remaining voting power in basis points (0-10000).
+ */
+export declare const getUserVotePowerRemaining: (chainId: ChainId, userAddress: string, provider?: Provider) => Promise<number>;

package/dist/types/contracts/governance/gaugeController/getVeToken.d.ts

@@ -0,0 +1,9 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Gets the veToken (voting escrow token) address used by the GaugeController.
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The veToken contract address as a string.
+ */
+export declare const getVeToken: (chainId: ChainId, provider?: Provider) => Promise<string>;

package/dist/types/contracts/governance/gaugeController/getVoteUserPower.d.ts

@@ -0,0 +1,10 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Gets the total vote power a user has currently allocated across all gauges.
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The user's allocated vote power as a bigint.
+ */
+export declare const getVoteUserPower: (chainId: ChainId, user: string, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getVoteUserSlope.d.ts

@@ -0,0 +1,15 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Reads a user's vote slope for a gauge from the public `voteUserSlopes` mapping.
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user.
+ * @param gauge - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns An object with locked, power and end, all bigint.
+ */
+export declare const getVoteUserSlope: (chainId: ChainId, user: string, gauge: string, provider?: Provider) => Promise<{
+    locked: bigint;
+    power: bigint;
+    end: bigint;
+}>;

package/dist/types/contracts/governance/gaugeController/index.d.ts

@@ -0,0 +1,29 @@
+export * from "./addGauge";
+export * from "./batchVote";
+export * from "./calculateBoost";
+export * from "./forceCompleteCheckpoint";
+export * from "./getActiveGauges";
+export * from "./getConstants";
+export * from "./getCurrentEpoch";
+export * from "./getGauge";
+export * from "./getGaugeRelativeWeight";
+export * from "./getGaugeRelativeWeightView";
+export * from "./getGaugeEmissions";
+export * from "./getGaugeWeight";
+export * from "./getLastVoteTime";
+export * from "./getNextEpoch";
+export * from "./getTotalWeight";
+export * from "./getUserGaugeVotePower";
+export * from "./getUserVotePowerRemaining";
+export * from "./getVeToken";
+export * from "./getVoteUserPower";
+export * from "./getVoteUserSlope";
+export * from "./isGaugeActive";
+export * from "./isPaused";
+export * from "./kick";
+export * from "./removeGauge";
+export * from "./removePowerFromGauge";
+export * from "./setBoostAmplificationEnabled";
+export * from "./setEmergencyGaugePause";
+export * from "./setEmergencyPause";
+export * from "./vote";

package/dist/types/contracts/governance/gaugeController/isGaugeActive.d.ts

@@ -0,0 +1,11 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const isGaugeActive: (chainId: ChainId, gaugeAddress: string, provider?: Provider) => Promise<boolean>;

package/dist/types/contracts/governance/gaugeController/isPaused.d.ts

@@ -0,0 +1,9 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const isPaused: (chainId: ChainId, provider?: Provider) => Promise<boolean>;

package/dist/types/contracts/governance/gaugeController/kick.d.ts

@@ -0,0 +1,10 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const kick: (chainId: ChainId, user: string, signer: Signer) => Promise<any>;

package/dist/types/contracts/governance/gaugeController/removeGauge.d.ts

@@ -0,0 +1,10 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const removeGauge: (chainId: ChainId, gauge: string, signer: Signer) => Promise<any>;

package/dist/types/contracts/governance/gaugeController/removePowerFromGauge.d.ts

@@ -0,0 +1,10 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const removePowerFromGauge: (chainId: ChainId, gauge: string, signer: Signer) => Promise<any>;

package/dist/types/contracts/governance/gaugeController/setBoostAmplificationEnabled.d.ts

@@ -0,0 +1,11 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const setBoostAmplificationEnabled: (chainId: ChainId, gauge: string, enabled: boolean, signer: Signer) => Promise<any>;

package/dist/types/contracts/governance/gaugeController/setEmergencyGaugePause.d.ts

@@ -0,0 +1,11 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const setEmergencyGaugePause: (chainId: ChainId, gauge: string, paused: boolean, signer: Signer) => Promise<any>;

package/dist/types/contracts/governance/gaugeController/setEmergencyPause.d.ts

@@ -0,0 +1,10 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const setEmergencyPause: (chainId: ChainId, paused: boolean, signer: Signer) => Promise<any>;

package/dist/types/contracts/governance/gaugeController/vote.d.ts

@@ -0,0 +1,12 @@
+import { ethers, Signer } from "ethers";
+import configs from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const vote: (chainId: keyof typeof configs, gaugeAddress: string, voteWeight: string | number | bigint, signer: Signer) => Promise<ethers.ContractTransactionResponse>;

package/dist/types/contracts/governance/proposals/cancel.d.ts

@@ -0,0 +1,16 @@
+import { ethers, Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const cancel: (chainId: ChainId, governance: string, proposalId: number | bigint, signer: Signer) => Promise<ethers.ContractTransactionResponse>;

package/dist/types/contracts/governance/proposals/castVote.d.ts

@@ -0,0 +1,20 @@
+import { ethers, Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const castVote: (chainId: ChainId, governance: string, proposalId: number | bigint, support: boolean, signer: Signer) => Promise<{
+    tx: ethers.ContractTransactionResponse;
+    weight: string;
+}>;

package/dist/types/contracts/governance/proposals/execute.d.ts

@@ -0,0 +1,16 @@
+import { ethers, Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const execute: (chainId: ChainId, governance: string, proposalId: number | bigint, value: string | number | bigint, signer: Signer) => Promise<ethers.ContractTransactionResponse>;

package/dist/types/contracts/governance/proposals/getGovernances.d.ts

@@ -0,0 +1,11 @@
+import { ChainId } from "../../../configs/chains";
+import { GovernanceInstance } from "../../../configs/chains/chain";
+export type LabelledGovernance = GovernanceInstance;
+/**
+ * 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.
+ */
+export declare const getGovernances: (chainId: ChainId) => LabelledGovernance[];

package/dist/types/contracts/governance/proposals/getLabel.d.ts

@@ -0,0 +1,11 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const getLabel: (chainId: ChainId, governance: string, provider?: Provider) => Promise<string>;

package/dist/types/contracts/governance/proposals/getProposal.d.ts

@@ -0,0 +1,30 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface ProposalCore {
+    id: number;
+    proposer: string;
+    startTime: number;
+    endTime: number;
+    executed: boolean;
+    canceled: boolean;
+    timelock: string;
+    descriptionHash: string;
+    targets: string[];
+    values: string[];
+    calldatas: string[];
+    snapshotBlock: number;
+    quorumNumerator: number;
+    totalVotingPowerAtSnapshot: string;
+}
+/**
+ * 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.
+ */
+export declare const getProposal: (chainId: ChainId, governance: string, proposalId: number | bigint, provider?: Provider) => Promise<ProposalCore>;

package/dist/types/contracts/governance/proposals/getProposalCount.d.ts

@@ -0,0 +1,11 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const getProposalCount: (chainId: ChainId, governance: string, provider?: Provider) => Promise<number>;

package/dist/types/contracts/governance/proposals/getProposalEta.d.ts

@@ -0,0 +1,13 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * 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.
+ */
+export declare const getProposalEta: (chainId: ChainId, governance: string, proposalId: number | bigint, provider?: Provider) => Promise<number>;

package/dist/types/contracts/governance/proposals/getProposalInfo.d.ts

@@ -0,0 +1,25 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { ProposalState } from "./getState";
+export interface ProposalInfo {
+    currentState: ProposalState;
+    startTime: number;
+    endTime: number;
+    currentTime: number;
+    forVotes: string;
+    againstVotes: string;
+    currentQuorum: string;
+    requiredQuorum: string;
+    isExecuted: boolean;
+    isCanceled: boolean;
+}
+/**
+ * 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.
+ */
+export declare const getProposalInfo: (chainId: ChainId, governance: string, proposalId: number | bigint, provider?: Provider) => Promise<ProposalInfo>;

package/dist/types/contracts/governance/proposals/getProposalThreshold.d.ts

@@ -0,0 +1,11 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Gets the minimum voting power required to create proposals.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The proposal threshold formatted in ether units.
+ */
+export declare const getProposalThreshold: (chainId: ChainId, governance: string, provider?: Provider) => Promise<string>;

package/dist/types/contracts/governance/proposals/getQuorum.d.ts

@@ -0,0 +1,13 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Gets the quorum requirement for a proposal.
+ * Derived from the total voting power and quorum numerator snapshotted when the proposal was created, so it never moves afterwards.
+ *
+ * @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 The required for-votes formatted in ether units, "0.0" for an unknown proposal.
+ */
+export declare const getQuorum: (chainId: ChainId, governance: string, proposalId: number | bigint, provider?: Provider) => Promise<string>;

package/dist/types/contracts/governance/proposals/getQuorumNumerator.d.ts

@@ -0,0 +1,17 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface QuorumSettings {
+    numerator: number;
+    denominator: number;
+    percentage: number;
+}
+/**
+ * Gets the quorum numerator and denominator settings.
+ * The percentage of total voting power required for quorum.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The quorum settings including numerator, denominator, and percentage.
+ */
+export declare const getQuorumNumerator: (chainId: ChainId, governance: string, provider?: Provider) => Promise<QuorumSettings>;

package/dist/types/contracts/governance/proposals/getRoles.d.ts

@@ -0,0 +1,16 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface GovernanceRoles {
+    defaultAdminRole: string;
+    parameterUpdateRole: string;
+    cancellationRole: string;
+}
+/**
+ * Gets the access-control role identifiers used by Governance.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The bytes32 role identifiers.
+ */
+export declare const getRoles: (chainId: ChainId, governance: string, provider?: Provider) => Promise<GovernanceRoles>;

package/dist/types/contracts/governance/proposals/getState.d.ts

@@ -0,0 +1,24 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Proposal states enum matching the contract
+ */
+export declare enum ProposalState {
+    Pending = 0,
+    Active = 1,
+    Canceled = 2,
+    Defeated = 3,
+    Succeeded = 4,
+    Queued = 5,
+    Executed = 6
+}
+/**
+ * Returns the current state of a proposal.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param proposalId - The ID of the proposal to check.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The current ProposalState.
+ */
+export declare const getState: (chainId: ChainId, governance: string, proposalId: number | bigint, provider?: Provider) => Promise<ProposalState>;

package/dist/types/contracts/governance/proposals/getVoteReceipt.d.ts

@@ -0,0 +1,26 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface VoteReceipt {
+    hasVoted: boolean;
+    /** True for, false against. Null when the account has not voted, or its VoteCast event could not be read. */
+    support: boolean | null;
+    /** veRAAC the vote carried, ether units. Null when unknown. */
+    weight: string | null;
+    transactionHash: string | null;
+    blockNumber: number | null;
+}
+/**
+ * Gets an account's vote on a proposal: whether it voted, from `hasVoted`,
+ * and which side and weight, from its `VoteCast` event. Both event fields
+ * (`voter`, `proposalId`) are indexed, so the lookup is a filtered log query
+ * starting at the proposal's snapshot block, before which no vote can exist.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param proposalId - The proposal ID.
+ * @param account - The voter address.
+ * @param fromBlock - First block to search for the event; pass the proposal's snapshot block.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The receipt. `hasVoted` is authoritative; the event fields are null if the log query fails.
+ */
+export declare const getVoteReceipt: (chainId: ChainId, governance: string, proposalId: number | bigint, account: string, fromBlock?: number | bigint, provider?: Provider) => Promise<VoteReceipt>;