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

package/dist/contracts/governance/timelock/getRoles.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRoles = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the 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.
+ */
+const getRoles = async (chainId, timelock, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
+    const abi = (0, artifacts_1.getABI)("timelockcontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    const [defaultAdminRole, proposerRole, executorRole, cancellerRole, emergencyRole] = await Promise.all([
+        contract.DEFAULT_ADMIN_ROLE(),
+        contract.PROPOSER_ROLE(),
+        contract.EXECUTOR_ROLE(),
+        contract.CANCELLER_ROLE(),
+        contract.EMERGENCY_ROLE(),
+    ]);
+    return { defaultAdminRole, proposerRole, executorRole, cancellerRole, emergencyRole };
+};
+exports.getRoles = getRoles;

package/dist/contracts/governance/timelock/getTimestamp.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTimestamp = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Returns the timestamp for an operation.
+ * 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).
+ */
+const getTimestamp = async (chainId, timelock, operationId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
+    const abi = (0, artifacts_1.getABI)("timelockcontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    const timestamp = await contract.getTimestamp(operationId);
+    return Number(timestamp);
+};
+exports.getTimestamp = getTimestamp;

package/dist/contracts/governance/timelock/hasRole.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasRole = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * 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.
+ */
+const hasRole = async (chainId, timelock, role, account, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
+    const abi = (0, artifacts_1.getABI)("timelockcontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    return await contract.hasRole(role, account);
+};
+exports.hasRole = hasRole;

package/dist/contracts/governance/timelock/hashOperationBatch.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashOperationBatch = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Hashes an operation for unique identification.
+ * Use this to compute the operation ID before scheduling or checking status.
+ *
+ * @param chainId - The chain/network to use.
+ * @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.
+ * @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).
+ */
+const hashOperationBatch = async (chainId, timelock, nonce, targets, values, calldatas, predecessor, salt, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
+    const abi = (0, artifacts_1.getABI)("timelockcontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    return await contract.hashOperationBatch(nonce, targets, values, calldatas, predecessor, salt);
+};
+exports.hashOperationBatch = hashOperationBatch;

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasRole = exports.getRoles = exports.getConstants = exports.hashOperationBatch = exports.getMinDelay = exports.getTimestamp = exports.isOperationDone = exports.isOperationReady = exports.isOperationPending = void 0;
+// Read functions
+var isOperationPending_1 = require("./isOperationPending");
+Object.defineProperty(exports, "isOperationPending", { enumerable: true, get: function () { return isOperationPending_1.isOperationPending; } });
+var isOperationReady_1 = require("./isOperationReady");
+Object.defineProperty(exports, "isOperationReady", { enumerable: true, get: function () { return isOperationReady_1.isOperationReady; } });
+var isOperationDone_1 = require("./isOperationDone");
+Object.defineProperty(exports, "isOperationDone", { enumerable: true, get: function () { return isOperationDone_1.isOperationDone; } });
+var getTimestamp_1 = require("./getTimestamp");
+Object.defineProperty(exports, "getTimestamp", { enumerable: true, get: function () { return getTimestamp_1.getTimestamp; } });
+var getMinDelay_1 = require("./getMinDelay");
+Object.defineProperty(exports, "getMinDelay", { enumerable: true, get: function () { return getMinDelay_1.getMinDelay; } });
+var hashOperationBatch_1 = require("./hashOperationBatch");
+Object.defineProperty(exports, "hashOperationBatch", { enumerable: true, get: function () { return hashOperationBatch_1.hashOperationBatch; } });
+var getConstants_1 = require("./getConstants");
+Object.defineProperty(exports, "getConstants", { enumerable: true, get: function () { return getConstants_1.getConstants; } });
+var getRoles_1 = require("./getRoles");
+Object.defineProperty(exports, "getRoles", { enumerable: true, get: function () { return getRoles_1.getRoles; } });
+var hasRole_1 = require("./hasRole");
+Object.defineProperty(exports, "hasRole", { enumerable: true, get: function () { return hasRole_1.hasRole; } });

package/dist/contracts/governance/timelock/isOperationDone.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOperationDone = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * 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.
+ */
+const isOperationDone = async (chainId, timelock, operationId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
+    const abi = (0, artifacts_1.getABI)("timelockcontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    return await contract.isOperationDone(operationId);
+};
+exports.isOperationDone = isOperationDone;

package/dist/contracts/governance/timelock/isOperationPending.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOperationPending = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * 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.
+ */
+const isOperationPending = async (chainId, timelock, operationId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
+    const abi = (0, artifacts_1.getABI)("timelockcontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    return await contract.isOperationPending(operationId);
+};
+exports.isOperationPending = isOperationPending;

package/dist/contracts/governance/timelock/isOperationReady.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOperationReady = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Returns whether an operation is ready for execution.
+ * An operation is ready when the timelock delay has passed and
+ * 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.
+ */
+const isOperationReady = async (chainId, timelock, operationId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
+    const abi = (0, artifacts_1.getABI)("timelockcontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    return await contract.isOperationReady(operationId);
+};
+exports.isOperationReady = isOperationReady;

package/dist/contracts/lockers/botLocker/_helpers.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBotLockerContract = getBotLockerContract;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+async function getBotLockerContract(chainId, runner) {
+    if (!runner) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        runner = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "raacbotlocker");
+    const abi = (0, artifacts_1.getABI)("raacbotlocker");
+    return new ethers_1.ethers.Contract(address, abi, runner);
+}

package/dist/contracts/lockers/botLocker/claim.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claim = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Claim all accrued reward tokens to `recipient`.
+ */
+const claim = async (chainId, recipient, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, signer);
+    const tx = await contract.claim(recipient);
+    await tx.wait();
+    return tx;
+};
+exports.claim = claim;

package/dist/contracts/lockers/botLocker/getClaimable.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClaimable = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Claimable amount of a single reward token for `account`.
+ */
+const getClaimable = async (chainId, account, token, provider) => {
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, provider);
+    return contract.claimable(account, token);
+};
+exports.getClaimable = getClaimable;

package/dist/contracts/lockers/botLocker/getClaimables.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClaimables = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Claimable amounts across all registered reward tokens for `account`.
+ */
+const getClaimables = async (chainId, account, provider) => {
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, provider);
+    const results = await contract.claimables(account);
+    return results.map((r) => ({
+        token: r.token ?? r[0],
+        amount: r.amount ?? r[1],
+    }));
+};
+exports.getClaimables = getClaimables;

package/dist/contracts/lockers/botLocker/getClaimedRewards.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClaimedRewards = void 0;
+const _helpers_1 = require("./_helpers");
+const getClaimedRewards = async (chainId, account, provider) => {
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, provider);
+    const results = await contract.getClaimedRewards(account);
+    return results.map((r) => ({
+        token: r.token ?? r[0],
+        amount: r.amount ?? r[1],
+    }));
+};
+exports.getClaimedRewards = getClaimedRewards;

package/dist/contracts/lockers/botLocker/getLockedTokenIds.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLockedTokenIds = void 0;
+const _helpers_1 = require("./_helpers");
+const getLockedTokenIds = async (chainId, user, provider) => {
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, provider);
+    const ids = await contract.getLockedTokenIds(user);
+    return Array.from(ids);
+};
+exports.getLockedTokenIds = getLockedTokenIds;

package/dist/contracts/lockers/botLocker/getLocks.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLocksByOwner = exports.getLocks = void 0;
+const _helpers_1 = require("./_helpers");
+const normalize = (l) => ({
+    owner: l.owner ?? l[0],
+    lockedAt: Number(l.lockedAt ?? l[1]),
+    tokenId: l.tokenId ?? l[2],
+});
+/**
+ * Returns every active NFT lock across all owners.
+ */
+const getLocks = async (chainId, provider) => {
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, provider);
+    const results = await contract.getLocks();
+    return results.map(normalize);
+};
+exports.getLocks = getLocks;
+/**
+ * Returns every active NFT lock owned by `owner`.
+ */
+const getLocksByOwner = async (chainId, owner, provider) => {
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, provider);
+    const results = await contract.getLocksByOwner(owner);
+    return results.map(normalize);
+};
+exports.getLocksByOwner = getLocksByOwner;

package/dist/contracts/lockers/botLocker/getRewardTokenCount.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRewardTokenCount = void 0;
+const _helpers_1 = require("./_helpers");
+const getRewardTokenCount = async (chainId, provider) => {
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, provider);
+    const count = await contract.getRewardTokenCount();
+    return Number(count);
+};
+exports.getRewardTokenCount = getRewardTokenCount;

package/dist/contracts/lockers/botLocker/getRewardTokens.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRewardTokens = void 0;
+const _helpers_1 = require("./_helpers");
+const getRewardTokens = async (chainId, provider) => {
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, provider);
+    return Array.from(await contract.getRewardTokens());
+};
+exports.getRewardTokens = getRewardTokens;

package/dist/contracts/lockers/botLocker/lock.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lock = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * 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`).
+ */
+const lock = async (chainId, tokenIds, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, signer);
+    const tx = await contract.lock(tokenIds);
+    await tx.wait();
+    return tx;
+};
+exports.lock = lock;

package/dist/contracts/lockers/botLocker/unlock.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unlock = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * 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.
+ */
+const unlock = async (chainId, tokenIds, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, signer);
+    const tx = await contract.unlockAndClaim(tokenIds);
+    await tx.wait();
+    return tx;
+};
+exports.unlock = unlock;

package/dist/contracts/lockers/botLocker/unlockAndClaim.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unlockAndClaim = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Unlock NFTs and claim accrued rewards in one transaction.
+ */
+const unlockAndClaim = async (chainId, tokenIds, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const contract = await (0, _helpers_1.getBotLockerContract)(chainId, signer);
+    const tx = await contract.unlockAndClaim(tokenIds);
+    await tx.wait();
+    return tx;
+};
+exports.unlockAndClaim = unlockAndClaim;

package/dist/contracts/lockers/liquidLocker/_helpers.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLiquidLockerContract = getLiquidLockerContract;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+async function getLiquidLockerContract(chainId, runner) {
+    if (!runner) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        runner = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "raacliquidlocker");
+    const abi = (0, artifacts_1.getABI)("raacliquidlocker");
+    return new ethers_1.ethers.Contract(address, abi, runner);
+}

package/dist/contracts/lockers/liquidLocker/borrow.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.borrow = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Borrow leRAAC against the caller's locked RAAC collateral.
+ * If `depositToMaturityVault` is true, borrowed leRAAC is forwarded to the maturity vault for the caller.
+ */
+const borrow = async (chainId, amount, depositToMaturityVault, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const contract = await (0, _helpers_1.getLiquidLockerContract)(chainId, signer);
+    const tx = await contract.borrow(amount, depositToMaturityVault);
+    await tx.wait();
+    return tx;
+};
+exports.borrow = borrow;

package/dist/contracts/lockers/liquidLocker/deposit.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deposit = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Deposit RAAC into the liquid locker; locks underlying RAAC into veRAAC for the locker.
+ * Caller must have approved the locker to spend RAAC beforehand.
+ */
+const deposit = async (chainId, amount, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const contract = await (0, _helpers_1.getLiquidLockerContract)(chainId, signer);
+    const tx = await contract.deposit(amount);
+    await tx.wait();
+    return tx;
+};
+exports.deposit = deposit;

package/dist/contracts/lockers/liquidLocker/donate.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.donate = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Donate RAAC to be distributed pro-rata to all lockers.
+ */
+const donate = async (chainId, amount, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const contract = await (0, _helpers_1.getLiquidLockerContract)(chainId, signer);
+    const tx = await contract.donate(amount);
+    await tx.wait();
+    return tx;
+};
+exports.donate = donate;

package/dist/contracts/lockers/liquidLocker/getConfig.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Read the locker's configuration parameters in a single call batch.
+ * Frontend setup screens / dashboards should call this to render fee % and linked addresses.
+ */
+const getConfig = async (chainId, provider) => {
+    const contract = await (0, _helpers_1.getLiquidLockerContract)(chainId, provider);
+    const [raac, leRAAC, veRAAC, maturityVault, zap, intermediateRewardToken, treasury, cleverFeeRecipient, raacBotLocker, lockDurationEpochs, reserveRate, repayFeePercentage, harvestBountyPercentage, treasuryFeePercentage, feeSharesBots, feeSharesClever, feeSharesTreasury, paused,] = await Promise.all([
+        contract.raac(),
+        contract.leRAAC(),
+        contract.veRAAC(),
+        contract.maturityVault(),
+        contract.zap(),
+        contract.intermediateRewardToken(),
+        contract.treasury(),
+        contract.cleverFeeRecipient(),
+        contract.raacBotLocker(),
+        contract.lockDurationEpochs(),
+        contract.reserveRate(),
+        contract.repayFeePercentage(),
+        contract.harvestBountyPercentage(),
+        contract.treasuryFeePercentage(),
+        contract.feeSharesBots(),
+        contract.feeSharesClever(),
+        contract.feeSharesTreasury(),
+        contract.paused(),
+    ]);
+    return {
+        raac,
+        leRAAC,
+        veRAAC,
+        maturityVault,
+        zap,
+        intermediateRewardToken,
+        treasury,
+        cleverFeeRecipient,
+        raacBotLocker,
+        lockDurationEpochs: Number(lockDurationEpochs),
+        reserveRate,
+        repayFeePercentage,
+        harvestBountyPercentage,
+        treasuryFeePercentage,
+        feeSharesBots,
+        feeSharesClever,
+        feeSharesTreasury,
+        paused,
+    };
+};
+exports.getConfig = getConfig;

package/dist/contracts/lockers/liquidLocker/getGlobalInfo.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGlobalInfo = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("./_helpers");
+/**
+ * One-shot snapshot of locker global accounting.
+ */
+const getGlobalInfo = async (chainId, provider) => {
+    const contract = await (0, _helpers_1.getLiquidLockerContract)(chainId, provider);
+    const [totalLockedGlobal, totalUnlockedGlobal, totalDebtGlobal, pendingCumulatedAmount, accRewardPerShare, totalRaacInPool, poolLockedUnderlying,] = await Promise.all([
+        contract.totalLockedGlobal(),
+        contract.totalUnlockedGlobal(),
+        contract.totalDebtGlobal(),
+        contract.pendingCumulatedAmount(),
+        contract.accRewardPerShare(),
+        contract.totalRaacInPool(),
+        contract.poolLockedUnderlying(),
+    ]);
+    return {
+        totalLockedGlobal: ethers_1.ethers.formatEther(totalLockedGlobal),
+        totalUnlockedGlobal: ethers_1.ethers.formatEther(totalUnlockedGlobal),
+        totalDebtGlobal: ethers_1.ethers.formatEther(totalDebtGlobal),
+        pendingCumulatedAmount: ethers_1.ethers.formatEther(pendingCumulatedAmount),
+        accRewardPerShare: accRewardPerShare.toString(),
+        totalRaacInPool: ethers_1.ethers.formatEther(totalRaacInPool),
+        poolLockedUnderlying: ethers_1.ethers.formatEther(poolLockedUnderlying),
+        raw: {
+            totalLockedGlobal,
+            totalUnlockedGlobal,
+            totalDebtGlobal,
+            pendingCumulatedAmount,
+            accRewardPerShare,
+            totalRaacInPool,
+            poolLockedUnderlying,
+        },
+    };
+};
+exports.getGlobalInfo = getGlobalInfo;