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

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

@@ -1,5 +1,6 @@
 import { ethers, Signer } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { TokenAmount } from "../../../utils/amount";
 /**
  * Casts a vote on a governance proposal.
  * Allows veToken holders to vote on active proposals.
@@ -8,12 +9,13 @@ import { ChainId } from "../../../configs/chains";
  * - 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).
  */
-export declare const castVote: (chainId: ChainId, proposalId: number | bigint, support: boolean, signer: Signer) => Promise<{
+export declare const castVote: (chainId: ChainId, governance: string, proposalId: number | bigint, support: boolean, signer: Signer) => Promise<{
     tx: ethers.ContractTransactionResponse;
-    weight: string;
+    weight: TokenAmount;
 }>;

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

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

@@ -1,34 +1,34 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
-/**
- * Proposal types enum matching the contract
- */
-export declare enum ProposalType {
-    ParameterChange = 0,
-    SmartContractUpgrade = 1,
-    TreasuryAction = 2,
-    EmissionChange = 3,
-    GaugeManagement = 4
-}
+import { TokenAmount } from "../../../utils/amount";
 export interface ProposalCore {
     id: number;
     proposer: string;
-    proposalType: ProposalType;
     startTime: number;
     endTime: number;
     executed: boolean;
     canceled: boolean;
+    timelock: string;
     descriptionHash: string;
     targets: string[];
-    values: string[];
+    /** ETH value per action, in wei. */
+    values: TokenAmount[];
     calldatas: string[];
+    snapshotBlock: number;
+    /** Quorum numerator snapshotted at creation, percent of total voting power (denominator 100). */
+    quorumNumerator: bigint;
+    /** Total veRAAC voting power at the snapshot block, in base units. */
+    totalVotingPowerAtSnapshot: TokenAmount;
 }
 /**
  * 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, proposalId: number | bigint, provider?: Provider) => Promise<ProposalCore>;
+export declare const getProposal: (chainId: ChainId, governance: string, proposalId: number | bigint, provider?: Provider) => Promise<ProposalCore>;

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

@@ -4,7 +4,8 @@ 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, provider?: Provider) => Promise<number>;
+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

@@ -1,15 +1,20 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { TokenAmount } from "../../../utils/amount";
 import { ProposalState } from "./getState";
 export interface ProposalInfo {
     currentState: ProposalState;
     startTime: number;
     endTime: number;
     currentTime: number;
-    forVotes: string;
-    againstVotes: string;
-    currentQuorum: string;
-    requiredQuorum: string;
+    /** Votes for, in veRAAC base units. */
+    forVotes: TokenAmount;
+    /** Votes against, in veRAAC base units. */
+    againstVotes: TokenAmount;
+    /** Votes cast so far (for + against), in veRAAC base units. */
+    currentQuorum: TokenAmount;
+    /** Votes needed to reach quorum, in veRAAC base units. */
+    requiredQuorum: TokenAmount;
     isExecuted: boolean;
     isCanceled: boolean;
 }
@@ -17,8 +22,9 @@ export interface ProposalInfo {
  * 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.
+ * @returns Detailed proposal info: state, timing, and votes and quorum in veRAAC base units.
  */
-export declare const getProposalInfo: (chainId: ChainId, proposalId: number | bigint, provider?: Provider) => Promise<ProposalInfo>;
+export declare const getProposalInfo: (chainId: ChainId, governance: string, proposalId: number | bigint, provider?: Provider) => Promise<ProposalInfo>;

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

@@ -1,10 +1,12 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { TokenAmount } from "../../../utils/amount";
 /**
  * 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.
+ * @returns The threshold, veRAAC voting power in base units.
  */
-export declare const getProposalThreshold: (chainId: ChainId, provider?: Provider) => Promise<string>;
+export declare const getProposalThreshold: (chainId: ChainId, governance: string, provider?: Provider) => Promise<TokenAmount>;

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

@@ -1,11 +1,14 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { TokenAmount } from "../../../utils/amount";
 /**
- * Gets the current quorum requirement.
- * Calculates required quorum based on total voting power.
+ * 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 current quorum threshold formatted in ether units.
+ * @returns The required votes, veRAAC voting power in base units; zero for an unknown proposal.
  */
-export declare const getQuorum: (chainId: ChainId, provider?: Provider) => Promise<string>;
+export declare const getQuorum: (chainId: ChainId, governance: string, proposalId: number | bigint, provider?: Provider) => Promise<TokenAmount>;

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

@@ -1,8 +1,11 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
 export interface QuorumSettings {
-    numerator: number;
-    denominator: number;
+    /** Quorum numerator, percent of total voting power. */
+    numerator: bigint;
+    /** Quorum denominator, 100. */
+    denominator: bigint;
+    /** numerator / denominator as a percentage, a computed float. */
     percentage: number;
 }
 /**
@@ -10,7 +13,8 @@ export interface QuorumSettings {
  * 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, provider?: Provider) => Promise<QuorumSettings>;
+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

@@ -16,8 +16,9 @@ export declare enum ProposalState {
  * 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, proposalId: number | bigint, provider?: Provider) => Promise<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,27 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { TokenAmount } from "../../../utils/amount";
+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, in base units. Null when unknown. */
+    weight: TokenAmount | 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>;

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

@@ -1,15 +1,19 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { TokenAmount } from "../../../utils/amount";
 export interface ProposalVotes {
-    forVotes: string;
-    againstVotes: string;
+    /** Votes for, in veRAAC base units. */
+    forVotes: TokenAmount;
+    /** Votes against, in veRAAC base units. */
+    againstVotes: TokenAmount;
 }
 /**
  * Gets vote counts for a proposal.
  *
  * @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 for and against vote totals formatted in ether units.
+ * @returns The for and against vote totals, veRAAC voting power in base units.
  */
-export declare const getVotes: (chainId: ChainId, proposalId: number | bigint, provider?: Provider) => Promise<ProposalVotes>;
+export declare const getVotes: (chainId: ChainId, governance: string, proposalId: number | bigint, provider?: Provider) => Promise<ProposalVotes>;

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

@@ -4,7 +4,8 @@ import { ChainId } from "../../../configs/chains";
  * Gets the voting delay (time before voting starts after proposal creation).
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns The voting delay in seconds.
  */
-export declare const getVotingDelay: (chainId: ChainId, provider?: Provider) => Promise<number>;
+export declare const getVotingDelay: (chainId: ChainId, governance: string, provider?: Provider) => Promise<number>;

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

@@ -4,7 +4,8 @@ import { ChainId } from "../../../configs/chains";
  * Gets the voting period duration.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns The voting period in seconds.
  */
-export declare const getVotingPeriod: (chainId: ChainId, provider?: Provider) => Promise<number>;
+export declare const getVotingPeriod: (chainId: ChainId, governance: string, provider?: Provider) => Promise<number>;

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

@@ -0,0 +1,13 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Checks whether an account holds a Governance role.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param role - The bytes32 role identifier (see `getRoles`).
+ * @param account - The address to check.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns True if the account holds the role.
+ */
+export declare const hasRole: (chainId: ChainId, governance: string, role: string, account: string, provider?: Provider) => Promise<boolean>;

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

@@ -0,0 +1,14 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Checks whether an account has already voted on a proposal.
+ * Votes cannot be changed or withdrawn, so a `true` result is final.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param proposalId - The ID of the proposal to query.
+ * @param account - The address to check.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns True if the account has voted on the proposal.
+ */
+export declare const hasVoted: (chainId: ChainId, governance: string, proposalId: number | bigint, account: string, provider?: Provider) => Promise<boolean>;

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

@@ -1,14 +1,23 @@
+export { getGovernances, type LabelledGovernance } from "./getGovernances";
 export { getState, ProposalState } from "./getState";
 export { getVotes, type ProposalVotes } from "./getVotes";
+export { hasVoted } from "./hasVoted";
+export { getVoteReceipt, type VoteReceipt } from "./getVoteReceipt";
 export { getQuorum } from "./getQuorum";
-export { getProposal, ProposalType, type ProposalCore } from "./getProposal";
-export { getProposalData, type ProposalData } from "./getProposalData";
+export { getProposal, type ProposalCore } from "./getProposal";
 export { getProposalInfo, type ProposalInfo } from "./getProposalInfo";
+export { getProposalEta } from "./getProposalEta";
+export { getProposalCount } from "./getProposalCount";
 export { getVotingDelay } from "./getVotingDelay";
 export { getVotingPeriod } from "./getVotingPeriod";
 export { getProposalThreshold } from "./getProposalThreshold";
 export { getQuorumNumerator, type QuorumSettings } from "./getQuorumNumerator";
+export { getLabel } from "./getLabel";
+export { getRoles, type GovernanceRoles } from "./getRoles";
+export { hasRole } from "./hasRole";
 export { propose } from "./propose";
 export { castVote } from "./castVote";
 export { execute } from "./execute";
 export { cancel } from "./cancel";
+export { setParameter, GovernanceParameter } from "./setParameter";
+export { setTimelock } from "./setTimelock";

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

@@ -1,29 +1,19 @@
 import { ethers, Signer } from "ethers";
 import { ChainId } from "../../../configs/chains";
-/**
- * Proposal types enum matching the contract
- */
-export declare enum ProposalType {
-    ParameterChange = 0,
-    SmartContractUpgrade = 1,
-    TreasuryAction = 2,
-    EmissionChange = 3,
-    GaugeManagement = 4
-}
 /**
  * Creates a new governance proposal.
- * Requires the caller to have at least proposalThreshold veRAAC voting power.
+ * Requires the caller to have at least proposalThreshold veRAAC voting power at the previous block, which becomes the proposal's snapshot block.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param targets - Array of target addresses for proposal actions.
- * @param values - Array of ETH values for proposal actions.
+ * @param values - Array of ETH values for the proposal actions, in wei.
  * @param calldatas - Array of calldata for proposal actions.
  * @param description - Description of the proposal.
- * @param proposalType - Type of the proposal (ParameterChange, SmartContractUpgrade, TreasuryAction, EmissionChange, or GaugeManagement).
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt and the proposal ID.
  */
-export declare const propose: (chainId: ChainId, targets: string[], values: (string | number | bigint)[], calldatas: string[], description: string, proposalType: ProposalType, signer: Signer) => Promise<{
+export declare const propose: (chainId: ChainId, governance: string, targets: string[], values: bigint[], calldatas: string[], description: string, signer: Signer) => Promise<{
     tx: ethers.ContractTransactionResponse;
     proposalId: number;
 }>;

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

@@ -0,0 +1,23 @@
+import { ethers, Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Governance parameters enum matching the contract
+ */
+export declare enum GovernanceParameter {
+    VotingDelay = 0,
+    VotingPeriod = 1,
+    ProposalThreshold = 2,
+    QuorumNumerator = 3
+}
+/**
+ * Updates a governance parameter. Requires `PARAMETER_UPDATE_ROLE`; takes effect immediately.
+ * Only affects proposals created afterwards, since quorum inputs are snapshotted at creation.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param param - The parameter to update.
+ * @param newValue - The new raw value: seconds for the voting delay and period, veRAAC base units for the proposal threshold, percent (denominator 100) for the quorum numerator.
+ * @param signer - An ethers.js Signer instance (must be connected to wallet).
+ * @returns The transaction response.
+ */
+export declare const setParameter: (chainId: ChainId, governance: string, param: GovernanceParameter, newValue: bigint, signer: Signer) => Promise<ethers.ContractTransactionResponse>;

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

@@ -0,0 +1,14 @@
+import { ethers, Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Updates the timelock controller used to queue new proposals. Requires `DEFAULT_ADMIN_ROLE`.
+ * Proposals already queued stay bound to the timelock they were queued in.
+ * Update the instance's `timelock` in the chain config afterwards so it stays in sync.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param newTimelock - Address of the new timelock controller.
+ * @param signer - An ethers.js Signer instance (must be connected to wallet).
+ * @returns The transaction response.
+ */
+export declare const setTimelock: (chainId: ChainId, governance: string, newTimelock: string, signer: Signer) => Promise<ethers.ContractTransactionResponse>;

package/dist/types/contracts/governance/timelock/getConstants.d.ts

@@ -10,7 +10,8 @@ export interface TimelockConstants {
  * Gets the timelock constants.
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns Timelock constants including MIN_DELAY, MAX_DELAY, GRACE_PERIOD, EMERGENCY_DELAY.
  */
-export declare const getConstants: (chainId: ChainId, provider?: Provider) => Promise<TimelockConstants>;
+export declare const getConstants: (chainId: ChainId, timelock: string, provider?: Provider) => Promise<TimelockConstants>;

package/dist/types/contracts/governance/timelock/getMinDelay.d.ts

@@ -4,7 +4,8 @@ import { ChainId } from "../../../configs/chains";
  * Returns the minimum delay for operations.
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns Current minimum delay in seconds.
  */
-export declare const getMinDelay: (chainId: ChainId, provider?: Provider) => Promise<number>;
+export declare const getMinDelay: (chainId: ChainId, timelock: string, provider?: Provider) => Promise<number>;

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

@@ -0,0 +1,19 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface TimelockRoles {
+    defaultAdminRole: string;
+    proposerRole: string;
+    executorRole: string;
+    cancellerRole: string;
+    emergencyRole: string;
+}
+/**
+ * Gets the access-control role identifiers used by the TimelockController.
+ * Governance must hold PROPOSER_ROLE, EXECUTOR_ROLE and CANCELLER_ROLE to queue, execute and cancel proposals.
+ *
+ * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The bytes32 role identifiers.
+ */
+export declare const getRoles: (chainId: ChainId, timelock: string, provider?: Provider) => Promise<TimelockRoles>;

package/dist/types/contracts/governance/timelock/getTimestamp.d.ts

@@ -5,8 +5,9 @@ import { ChainId } from "../../../configs/chains";
  * This is when the operation will be ready for execution.
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param operationId - Operation ID to check (bytes32 hash).
  * @param provider - Optional ethers.js Provider instance.
  * @returns Timestamp when operation will be ready (0 if not scheduled).
  */
-export declare const getTimestamp: (chainId: ChainId, operationId: string, provider?: Provider) => Promise<number>;
+export declare const getTimestamp: (chainId: ChainId, timelock: string, operationId: string, provider?: Provider) => Promise<number>;

package/dist/types/contracts/governance/timelock/hasRole.d.ts

@@ -0,0 +1,13 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Checks whether an account holds a TimelockController role.
+ *
+ * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
+ * @param role - The bytes32 role identifier (see `getRoles`).
+ * @param account - The address to check.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns True if the account holds the role.
+ */
+export declare const hasRole: (chainId: ChainId, timelock: string, role: string, account: string, provider?: Provider) => Promise<boolean>;

package/dist/types/contracts/governance/timelock/hashOperationBatch.d.ts

@@ -5,13 +5,14 @@ import { ChainId } from "../../../configs/chains";
  * Use this to compute the operation ID before scheduling or checking status.
  *
  * @param chainId - The chain/network to use.
- * @param proposalId - The ID of the proposal.
+ * @param timelock - Address of the TimelockController contract.
+ * @param nonce - Caller-supplied discriminator. Governance passes the proposal ID.
  * @param targets - Target addresses for calls.
- * @param values - ETH values for calls.
+ * @param values - ETH values for the calls, in wei.
  * @param calldatas - Calldata for calls.
  * @param predecessor - ID of operation that must be executed before (or zero bytes32).
  * @param salt - Random value for operation ID.
  * @param provider - Optional ethers.js Provider instance.
  * @returns Operation hash (bytes32).
  */
-export declare const hashOperationBatch: (chainId: ChainId, proposalId: number | bigint, targets: string[], values: (string | number | bigint)[], calldatas: string[], predecessor: string, salt: string, provider?: Provider) => Promise<string>;
+export declare const hashOperationBatch: (chainId: ChainId, timelock: string, nonce: number | bigint, targets: string[], values: bigint[], calldatas: string[], predecessor: string, salt: string, provider?: Provider) => Promise<string>;

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

@@ -5,3 +5,5 @@ export { getTimestamp } from "./getTimestamp";
 export { getMinDelay } from "./getMinDelay";
 export { hashOperationBatch } from "./hashOperationBatch";
 export { getConstants, type TimelockConstants } from "./getConstants";
+export { getRoles, type TimelockRoles } from "./getRoles";
+export { hasRole } from "./hasRole";

package/dist/types/contracts/governance/timelock/isOperationDone.d.ts

@@ -4,8 +4,9 @@ import { ChainId } from "../../../configs/chains";
  * Returns whether an operation is done (executed).
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param operationId - Operation ID to check (bytes32 hash).
  * @param provider - Optional ethers.js Provider instance.
  * @returns True if operation is done.
  */
-export declare const isOperationDone: (chainId: ChainId, operationId: string, provider?: Provider) => Promise<boolean>;
+export declare const isOperationDone: (chainId: ChainId, timelock: string, operationId: string, provider?: Provider) => Promise<boolean>;

package/dist/types/contracts/governance/timelock/isOperationPending.d.ts

@@ -4,8 +4,9 @@ import { ChainId } from "../../../configs/chains";
  * Returns whether an operation is pending (scheduled but not executed).
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param operationId - Operation ID to check (bytes32 hash).
  * @param provider - Optional ethers.js Provider instance.
  * @returns True if operation is pending.
  */
-export declare const isOperationPending: (chainId: ChainId, operationId: string, provider?: Provider) => Promise<boolean>;
+export declare const isOperationPending: (chainId: ChainId, timelock: string, operationId: string, provider?: Provider) => Promise<boolean>;

package/dist/types/contracts/governance/timelock/isOperationReady.d.ts

@@ -6,8 +6,9 @@ import { ChainId } from "../../../configs/chains";
  * it's still within the grace period.
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param operationId - Operation ID to check (bytes32 hash).
  * @param provider - Optional ethers.js Provider instance.
  * @returns True if operation can be executed.
  */
-export declare const isOperationReady: (chainId: ChainId, operationId: string, provider?: Provider) => Promise<boolean>;
+export declare const isOperationReady: (chainId: ChainId, timelock: string, operationId: string, provider?: Provider) => Promise<boolean>;