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

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

@@ -1,11 +1,13 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
 /**
- * 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 for-votes formatted in ether units, "0.0" 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<string>;

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

@@ -10,7 +10,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,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>;

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

@@ -8,8 +8,9 @@ export interface ProposalVotes {
  * 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.
  */
-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 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: (string | number | 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 delay/period, wei for threshold, percent for 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: string | number | 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,7 +5,8 @@ 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 calldatas - Calldata for calls.
@@ -14,4 +15,4 @@ import { ChainId } from "../../../configs/chains";
  * @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: (string | number | 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>;

package/dist/types/contracts/lockers/botLocker/_helpers.d.ts

@@ -0,0 +1,4 @@
+import { Provider, Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { RAACBotLocker } from "../../../typechain-types";
+export declare function getBotLockerContract(chainId: ChainId, runner?: Provider | Signer): Promise<RAACBotLocker>;

package/dist/types/contracts/lockers/botLocker/claim.d.ts

@@ -0,0 +1,6 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Claim all accrued reward tokens to `recipient`.
+ */
+export declare const claim: (chainId: ChainId, recipient: string, signer: Signer) => Promise<import("ethers").ContractTransactionResponse>;

package/dist/types/contracts/lockers/botLocker/getClaimable.d.ts

@@ -0,0 +1,6 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Claimable amount of a single reward token for `account`.
+ */
+export declare const getClaimable: (chainId: ChainId, account: string, token: string, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/lockers/botLocker/getClaimables.d.ts

@@ -0,0 +1,10 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface BotLockerClaimable {
+    token: string;
+    amount: bigint;
+}
+/**
+ * Claimable amounts across all registered reward tokens for `account`.
+ */
+export declare const getClaimables: (chainId: ChainId, account: string, provider?: Provider) => Promise<BotLockerClaimable[]>;

package/dist/types/contracts/lockers/botLocker/getClaimedRewards.d.ts

@@ -0,0 +1,7 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface BotLockerClaimedReward {
+    token: string;
+    amount: bigint;
+}
+export declare const getClaimedRewards: (chainId: ChainId, account: string, provider?: Provider) => Promise<BotLockerClaimedReward[]>;

package/dist/types/contracts/lockers/botLocker/getLockedTokenIds.d.ts

@@ -0,0 +1,3 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export declare const getLockedTokenIds: (chainId: ChainId, user: string, provider?: Provider) => Promise<bigint[]>;

package/dist/types/contracts/lockers/botLocker/getLocks.d.ts

@@ -0,0 +1,15 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface BotLockerNFTLock {
+    owner: string;
+    lockedAt: number;
+    tokenId: bigint;
+}
+/**
+ * Returns every active NFT lock across all owners.
+ */
+export declare const getLocks: (chainId: ChainId, provider?: Provider) => Promise<BotLockerNFTLock[]>;
+/**
+ * Returns every active NFT lock owned by `owner`.
+ */
+export declare const getLocksByOwner: (chainId: ChainId, owner: string, provider?: Provider) => Promise<BotLockerNFTLock[]>;

package/dist/types/contracts/lockers/botLocker/getRewardTokenCount.d.ts

@@ -0,0 +1,3 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export declare const getRewardTokenCount: (chainId: ChainId, provider?: Provider) => Promise<number>;

package/dist/types/contracts/lockers/botLocker/getRewardTokens.d.ts

@@ -0,0 +1,3 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export declare const getRewardTokens: (chainId: ChainId, provider?: Provider) => Promise<string[]>;

package/dist/types/contracts/lockers/botLocker/lock.d.ts

@@ -0,0 +1,7 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Lock RAAC Bot NFTs into the bot-locker. Each tokenId mints a share entitling the user to reward streams.
+ * Caller must have approved the locker on the NFT contract first (`setApprovalForAll`).
+ */
+export declare const lock: (chainId: ChainId, tokenIds: (string | number | bigint)[], signer: Signer) => Promise<import("ethers").ContractTransactionResponse>;

package/dist/types/contracts/lockers/botLocker/unlock.d.ts

@@ -0,0 +1,10 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Unlock NFTs from the bot-locker. Each tokenId must satisfy the unlock-window check
+ * (locked duration is a non-zero multiple of LOCK_DURATION_IN_EPOCH * EPOCH_DURATION).
+ *
+ * The contract no longer has a standalone unlock — it was merged into
+ * unlockAndClaim, which unlocks and claims accrued rewards atomically.
+ */
+export declare const unlock: (chainId: ChainId, tokenIds: (string | number | bigint)[], signer: Signer) => Promise<import("ethers").ContractTransactionResponse>;

package/dist/types/contracts/lockers/botLocker/unlockAndClaim.d.ts

@@ -0,0 +1,6 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Unlock NFTs and claim accrued rewards in one transaction.
+ */
+export declare const unlockAndClaim: (chainId: ChainId, tokenIds: (string | number | bigint)[], signer: Signer) => Promise<import("ethers").ContractTransactionResponse>;

package/dist/types/contracts/lockers/liquidLocker/_helpers.d.ts

@@ -0,0 +1,4 @@
+import { Provider, Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { RAACLiquidLocker } from "../../../typechain-types";
+export declare function getLiquidLockerContract(chainId: ChainId, runner?: Provider | Signer): Promise<RAACLiquidLocker>;

package/dist/types/contracts/lockers/liquidLocker/borrow.d.ts

@@ -0,0 +1,7 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Borrow leRAAC against the caller's locked RAAC collateral.
+ * If `depositToMaturityVault` is true, borrowed leRAAC is forwarded to the maturity vault for the caller.
+ */
+export declare const borrow: (chainId: ChainId, amount: string | number | bigint, depositToMaturityVault: boolean, signer: Signer) => Promise<import("ethers").ContractTransactionResponse>;

package/dist/types/contracts/lockers/liquidLocker/deposit.d.ts

@@ -0,0 +1,7 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Deposit RAAC into the liquid locker; locks underlying RAAC into veRAAC for the locker.
+ * Caller must have approved the locker to spend RAAC beforehand.
+ */
+export declare const deposit: (chainId: ChainId, amount: string | number | bigint, signer: Signer) => Promise<import("ethers").ContractTransactionResponse>;

package/dist/types/contracts/lockers/liquidLocker/donate.d.ts

@@ -0,0 +1,6 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Donate RAAC to be distributed pro-rata to all lockers.
+ */
+export declare const donate: (chainId: ChainId, amount: string | number | bigint, signer: Signer) => Promise<import("ethers").ContractTransactionResponse>;

package/dist/types/contracts/lockers/liquidLocker/getConfig.d.ts

@@ -0,0 +1,27 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface LiquidLockerConfig {
+    raac: string;
+    leRAAC: string;
+    veRAAC: string;
+    maturityVault: string;
+    zap: string;
+    intermediateRewardToken: string;
+    treasury: string;
+    cleverFeeRecipient: string;
+    raacBotLocker: string;
+    lockDurationEpochs: number;
+    reserveRate: bigint;
+    repayFeePercentage: bigint;
+    harvestBountyPercentage: bigint;
+    treasuryFeePercentage: bigint;
+    feeSharesBots: bigint;
+    feeSharesClever: bigint;
+    feeSharesTreasury: bigint;
+    paused: boolean;
+}
+/**
+ * Read the locker's configuration parameters in a single call batch.
+ * Frontend setup screens / dashboards should call this to render fee % and linked addresses.
+ */
+export declare const getConfig: (chainId: ChainId, provider?: Provider) => Promise<LiquidLockerConfig>;

package/dist/types/contracts/lockers/liquidLocker/getGlobalInfo.d.ts

@@ -0,0 +1,24 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface LiquidLockerGlobalInfo {
+    totalLockedGlobal: string;
+    totalUnlockedGlobal: string;
+    totalDebtGlobal: string;
+    pendingCumulatedAmount: string;
+    accRewardPerShare: string;
+    totalRaacInPool: string;
+    poolLockedUnderlying: string;
+    raw: {
+        totalLockedGlobal: bigint;
+        totalUnlockedGlobal: bigint;
+        totalDebtGlobal: bigint;
+        pendingCumulatedAmount: bigint;
+        accRewardPerShare: bigint;
+        totalRaacInPool: bigint;
+        poolLockedUnderlying: bigint;
+    };
+}
+/**
+ * One-shot snapshot of locker global accounting.
+ */
+export declare const getGlobalInfo: (chainId: ChainId, provider?: Provider) => Promise<LiquidLockerGlobalInfo>;

package/dist/types/contracts/lockers/liquidLocker/getUserInfo.d.ts

@@ -0,0 +1,21 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface LiquidLockerUserInfo {
+    totalDeposited: string;
+    totalPendingUnlocked: string;
+    totalUnlocked: string;
+    totalBorrowed: string;
+    totalReward: string;
+    raw: {
+        totalDeposited: bigint;
+        totalPendingUnlocked: bigint;
+        totalUnlocked: bigint;
+        totalBorrowed: bigint;
+        totalReward: bigint;
+    };
+}
+/**
+ * Get a user's locker totals. Mirrors RAACLiquidLocker.getUserInfo with both
+ * formatted (ether) and raw values returned for convenience.
+ */
+export declare const getUserInfo: (chainId: ChainId, account: string, provider?: Provider) => Promise<LiquidLockerUserInfo>;

package/dist/types/contracts/lockers/liquidLocker/getUserLocks.d.ts

@@ -0,0 +1,17 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface PendingUnlockInfo {
+    pendingUnlock: string;
+    unlockEpoch: number;
+    unlockTimestamp: number;
+    reserved: boolean;
+    raw: {
+        pendingUnlock: bigint;
+        unlockEpoch: bigint;
+        reserved: boolean;
+    };
+}
+/**
+ * Returns the user's pending (future) unlock entries.
+ */
+export declare const getUserLocks: (chainId: ChainId, account: string, provider?: Provider) => Promise<PendingUnlockInfo[]>;

package/dist/types/contracts/lockers/liquidLocker/harvest.d.ts

@@ -0,0 +1,7 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Harvest veRAAC rewards, swap to RAAC via the configured Zap, and distribute.
+ * Caller must hold HARVEST_ROLE; receives the harvest bounty at `recipient`.
+ */
+export declare const harvest: (chainId: ChainId, recipient: string, minimumOut: string | number | bigint, signer: Signer) => Promise<import("ethers").ContractTransactionResponse>;