@rev-net/core-v6 0.0.7 → 0.0.9

package/src/interfaces/IREVDeployer.sol

@@ -7,26 +7,43 @@ import {IJBController} from "@bananapus/core-v6/src/interfaces/IJBController.sol
 import {IJBDirectory} from "@bananapus/core-v6/src/interfaces/IJBDirectory.sol";
 import {IJBPermissions} from "@bananapus/core-v6/src/interfaces/IJBPermissions.sol";
 import {IJBProjects} from "@bananapus/core-v6/src/interfaces/IJBProjects.sol";
+import {IJBBuybackHookRegistry} from "@bananapus/buyback-hook-v6/src/interfaces/IJBBuybackHookRegistry.sol";
 import {IJBRulesetDataHook} from "@bananapus/core-v6/src/interfaces/IJBRulesetDataHook.sol";
 import {JBRulesetConfig} from "@bananapus/core-v6/src/structs/JBRulesetConfig.sol";
 import {JBTerminalConfig} from "@bananapus/core-v6/src/structs/JBTerminalConfig.sol";
 import {IJBSuckerRegistry} from "@bananapus/suckers-v6/src/interfaces/IJBSuckerRegistry.sol";
 import {CTPublisher} from "@croptop/core-v6/src/CTPublisher.sol";
-
 import {REVConfig} from "../structs/REVConfig.sol";
 import {REVCroptopAllowedPost} from "../structs/REVCroptopAllowedPost.sol";
 import {REVDeploy721TiersHookConfig} from "../structs/REVDeploy721TiersHookConfig.sol";
 import {REVSuckerDeploymentConfig} from "../structs/REVSuckerDeploymentConfig.sol";
 
+/// @notice Deploys and manages revnets -- Juicebox projects with pre-configured tokenomics.
 interface IREVDeployer {
-    event ReplaceSplitOperator(uint256 indexed revnetId, address indexed newSplitOperator, address caller);
-    event DeploySuckers(
-        uint256 indexed revnetId,
-        bytes32 encodedConfigurationHash,
-        REVSuckerDeploymentConfig suckerDeploymentConfiguration,
-        address caller
+    /// @notice Emitted when tokens are auto-issued for a beneficiary during a stage.
+    /// @param revnetId The ID of the revnet.
+    /// @param stageId The ID of the stage.
+    /// @param beneficiary The address receiving the auto-issued tokens.
+    /// @param count The number of tokens auto-issued.
+    /// @param caller The address that triggered the auto-issuance.
+    event AutoIssue(
+        uint256 indexed revnetId, uint256 indexed stageId, address indexed beneficiary, uint256 count, address caller
     );
 
+    /// @notice Emitted when held tokens are burned from the deployer contract.
+    /// @param revnetId The ID of the revnet whose tokens were burned.
+    /// @param count The number of tokens burned.
+    /// @param caller The address that triggered the burn.
+    event BurnHeldTokens(uint256 indexed revnetId, uint256 count, address caller);
+
+    /// @notice Emitted when a new revnet is deployed.
+    /// @param revnetId The ID of the deployed revnet.
+    /// @param configuration The revnet's configuration.
+    /// @param terminalConfigurations The terminals configured for the revnet.
+    /// @param suckerDeploymentConfiguration The sucker deployment configuration.
+    /// @param rulesetConfigurations The rulesets configured for the revnet.
+    /// @param encodedConfigurationHash The hash of the encoded configuration.
+    /// @param caller The address that deployed the revnet.
     event DeployRevnet(
         uint256 indexed revnetId,
         REVConfig configuration,
@@ -37,42 +54,64 @@ interface IREVDeployer {
         address caller
     );
 
-    event SetCashOutDelay(uint256 indexed revnetId, uint256 cashOutDelay, address caller);
-
-    event AutoIssue(
-        uint256 indexed revnetId, uint256 indexed stageId, address indexed beneficiary, uint256 count, address caller
+    /// @notice Emitted when suckers are deployed for a revnet.
+    /// @param revnetId The ID of the revnet.
+    /// @param encodedConfigurationHash The hash of the encoded configuration.
+    /// @param suckerDeploymentConfiguration The sucker deployment configuration.
+    /// @param caller The address that deployed the suckers.
+    event DeploySuckers(
+        uint256 indexed revnetId,
+        bytes32 encodedConfigurationHash,
+        REVSuckerDeploymentConfig suckerDeploymentConfiguration,
+        address caller
     );
 
+    /// @notice Emitted when the split operator of a revnet is replaced.
+    /// @param revnetId The ID of the revnet.
+    /// @param newSplitOperator The address of the new split operator.
+    /// @param caller The address that replaced the split operator.
+    event ReplaceSplitOperator(uint256 indexed revnetId, address indexed newSplitOperator, address caller);
+
+    /// @notice Emitted when the cash out delay is set for a revnet.
+    /// @param revnetId The ID of the revnet.
+    /// @param cashOutDelay The cash out delay in seconds.
+    /// @param caller The address that set the delay.
+    event SetCashOutDelay(uint256 indexed revnetId, uint256 cashOutDelay, address caller);
+
+    /// @notice Emitted when an auto-issuance amount is stored for a beneficiary during a stage.
+    /// @param revnetId The ID of the revnet.
+    /// @param stageId The ID of the stage.
+    /// @param beneficiary The address the tokens will be issued to.
+    /// @param count The number of tokens stored for auto-issuance.
+    /// @param caller The address that stored the amount.
     event StoreAutoIssuanceAmount(
         uint256 indexed revnetId, uint256 indexed stageId, address indexed beneficiary, uint256 count, address caller
     );
 
-    event BurnHeldTokens(uint256 indexed revnetId, uint256 count, address caller);
+    /// @notice The number of revnet tokens that can be auto-minted for a beneficiary during a stage.
+    /// @param revnetId The ID of the revnet.
+    /// @param stageId The ID of the stage.
+    /// @param beneficiary The beneficiary of the auto-mint.
+    /// @return The number of tokens available to auto-issue.
+    function amountToAutoIssue(uint256 revnetId, uint256 stageId, address beneficiary) external view returns (uint256);
+
+    /// @notice The buyback hook used as a data hook to route payments through buyback pools.
+    /// @return The buyback hook contract.
+    function BUYBACK_HOOK() external view returns (IJBBuybackHookRegistry);
 
     /// @notice The number of seconds until a revnet's participants can cash out after deploying to a new network.
     /// @return The cash out delay in seconds.
     function CASH_OUT_DELAY() external view returns (uint256);
 
+    /// @notice The timestamp when cash outs become available for a revnet's participants.
+    /// @param revnetId The ID of the revnet.
+    /// @return The cash out delay timestamp.
+    function cashOutDelayOf(uint256 revnetId) external view returns (uint256);
+
     /// @notice The controller used to create and manage Juicebox projects for revnets.
     /// @return The controller contract.
     function CONTROLLER() external view returns (IJBController);
 
-    /// @notice The directory of terminals and controllers for Juicebox projects.
-    /// @return The directory contract.
-    function DIRECTORY() external view returns (IJBDirectory);
-
-    /// @notice The contract that mints ERC-721s representing project ownership.
-    /// @return The projects contract.
-    function PROJECTS() external view returns (IJBProjects);
-
-    /// @notice The contract that stores Juicebox project access permissions.
-    /// @return The permissions contract.
-    function PERMISSIONS() external view returns (IJBPermissions);
-
-    /// @notice The cash out fee as a fraction out of `JBConstants.MAX_FEE`.
-    /// @return The fee value.
-    function FEE() external view returns (uint256);
-
     /// @notice The default Uniswap pool fee tier for auto-configured buyback pools.
     /// @return The fee tier (10_000 = 1%).
     function DEFAULT_BUYBACK_POOL_FEE() external view returns (uint24);
@@ -81,63 +120,52 @@ interface IREVDeployer {
     /// @return The TWAP window in seconds.
     function DEFAULT_BUYBACK_TWAP_WINDOW() external view returns (uint32);
 
-    /// @notice The registry that deploys and tracks suckers for revnets.
-    /// @return The sucker registry contract.
-    function SUCKER_REGISTRY() external view returns (IJBSuckerRegistry);
+    /// @notice The directory of terminals and controllers for Juicebox projects.
+    /// @return The directory contract.
+    function DIRECTORY() external view returns (IJBDirectory);
+
+    /// @notice The cash out fee as a fraction out of `JBConstants.MAX_FEE`.
+    /// @return The fee value.
+    function FEE() external view returns (uint256);
 
     /// @notice The Juicebox project ID of the revnet that receives cash out fees.
     /// @return The fee revnet ID.
     function FEE_REVNET_ID() external view returns (uint256);
 
-    /// @notice The croptop publisher revnets can use to publish ERC-721 posts to their tiered ERC-721 hooks.
-    /// @return The publisher contract.
-    function PUBLISHER() external view returns (CTPublisher);
-
-    /// @notice The buyback hook used as a data hook to route payments through buyback pools.
-    /// @return The buyback hook contract.
-    function BUYBACK_HOOK() external view returns (IJBRulesetDataHook);
+    /// @notice The hashed encoded configuration of each revnet.
+    /// @param revnetId The ID of the revnet.
+    /// @return The hashed encoded configuration.
+    function hashedEncodedConfigurationOf(uint256 revnetId) external view returns (bytes32);
 
     /// @notice The deployer used to create tiered ERC-721 hooks for revnets.
     /// @return The hook deployer contract.
     function HOOK_DEPLOYER() external view returns (IJB721TiersHookDeployer);
 
+    /// @notice Whether an address is a revnet's split operator.
+    /// @param revnetId The ID of the revnet.
+    /// @param addr The address to check.
+    /// @return A flag indicating whether the address is the revnet's split operator.
+    function isSplitOperatorOf(uint256 revnetId, address addr) external view returns (bool);
+
     /// @notice The loan contract used by all revnets.
     /// @return The loans contract address.
     function LOANS() external view returns (address);
 
-    /// @notice The number of revnet tokens that can be auto-minted for a beneficiary during a stage.
-    /// @param revnetId The ID of the revnet.
-    /// @param stageId The ID of the stage.
-    /// @param beneficiary The beneficiary of the auto-mint.
-    /// @return The number of tokens available to auto-issue.
-    function amountToAutoIssue(uint256 revnetId, uint256 stageId, address beneficiary) external view returns (uint256);
-
-    /// @notice The timestamp when cash outs become available for a revnet's participants.
-    /// @param revnetId The ID of the revnet.
-    /// @return The cash out delay timestamp.
-    function cashOutDelayOf(uint256 revnetId) external view returns (uint256);
+    /// @notice The contract that stores Juicebox project access permissions.
+    /// @return The permissions contract.
+    function PERMISSIONS() external view returns (IJBPermissions);
 
-    /// @notice Deploy new suckers for an existing revnet.
-    /// @param revnetId The ID of the revnet to deploy suckers for.
-    /// @param suckerDeploymentConfiguration The suckers to set up for the revnet.
-    /// @return suckers The addresses of the deployed suckers.
-    function deploySuckersFor(
-        uint256 revnetId,
-        REVSuckerDeploymentConfig calldata suckerDeploymentConfiguration
-    )
-        external
-        returns (address[] memory suckers);
+    /// @notice The contract that mints ERC-721s representing project ownership.
+    /// @return The projects contract.
+    function PROJECTS() external view returns (IJBProjects);
 
-    /// @notice The hashed encoded configuration of each revnet.
-    /// @param revnetId The ID of the revnet.
-    /// @return The hashed encoded configuration.
-    function hashedEncodedConfigurationOf(uint256 revnetId) external view returns (bytes32);
+    /// @notice The croptop publisher revnets can use to publish ERC-721 posts to their tiered ERC-721 hooks.
+    /// @return The publisher contract.
+    function PUBLISHER() external view returns (CTPublisher);
 
-    /// @notice Whether an address is a revnet's split operator.
-    /// @param revnetId The ID of the revnet.
-    /// @param addr The address to check.
-    /// @return A flag indicating whether the address is the revnet's split operator.
-    function isSplitOperatorOf(uint256 revnetId, address addr) external view returns (bool);
+    /// @notice The registry that deploys and tracks suckers for revnets.
+    /// @return The sucker registry contract.
+    function SUCKER_REGISTRY() external view returns (IJBSuckerRegistry);
 
     /// @notice Each revnet's tiered ERC-721 hook.
     /// @param revnetId The ID of the revnet.
@@ -150,6 +178,10 @@ interface IREVDeployer {
     /// @param beneficiary The address to auto-mint tokens to.
     function autoIssueFor(uint256 revnetId, uint256 stageId, address beneficiary) external;
 
+    /// @notice Burn any of a revnet's tokens held by this contract.
+    /// @param revnetId The ID of the revnet whose tokens should be burned.
+    function burnHeldTokensOf(uint256 revnetId) external;
+
     /// @notice Deploy a revnet, or initialize an existing Juicebox project as a revnet.
     /// @param revnetId The ID of the Juicebox project to initialize. Send 0 to deploy a new revnet.
     /// @param configuration Core revnet configuration.
@@ -165,6 +197,17 @@ interface IREVDeployer {
         external
         returns (uint256);
 
+    /// @notice Deploy new suckers for an existing revnet.
+    /// @param revnetId The ID of the revnet to deploy suckers for.
+    /// @param suckerDeploymentConfiguration The suckers to set up for the revnet.
+    /// @return suckers The addresses of the deployed suckers.
+    function deploySuckersFor(
+        uint256 revnetId,
+        REVSuckerDeploymentConfig calldata suckerDeploymentConfiguration
+    )
+        external
+        returns (address[] memory suckers);
+
     /// @notice Deploy a revnet with tiered ERC-721s and optional croptop posting support.
     /// @param revnetId The ID of the Juicebox project to initialize. Send 0 to deploy a new revnet.
     /// @param configuration Core revnet configuration.
@@ -189,8 +232,4 @@ interface IREVDeployer {
     /// @param revnetId The ID of the revnet.
     /// @param newSplitOperator The new split operator's address.
     function setSplitOperatorOf(uint256 revnetId, address newSplitOperator) external;
-
-    /// @notice Burn any of a revnet's tokens held by this contract.
-    /// @param revnetId The ID of the revnet whose tokens should be burned.
-    function burnHeldTokensOf(uint256 revnetId) external;
 }

package/src/interfaces/IREVLoans.sol

@@ -1,7 +1,6 @@
 // SPDX-License-Identifier: MIT
 pragma solidity ^0.8.0;
 
-import {IPermit2} from "@uniswap/permit2/src/interfaces/IPermit2.sol";
 import {IJBController} from "@bananapus/core-v6/src/interfaces/IJBController.sol";
 import {IJBDirectory} from "@bananapus/core-v6/src/interfaces/IJBDirectory.sol";
 import {IJBPayoutTerminal} from "@bananapus/core-v6/src/interfaces/IJBPayoutTerminal.sol";
@@ -9,11 +8,22 @@ import {IJBPrices} from "@bananapus/core-v6/src/interfaces/IJBPrices.sol";
 import {IJBProjects} from "@bananapus/core-v6/src/interfaces/IJBProjects.sol";
 import {IJBTokenUriResolver} from "@bananapus/core-v6/src/interfaces/IJBTokenUriResolver.sol";
 import {JBSingleAllowance} from "@bananapus/core-v6/src/structs/JBSingleAllowance.sol";
-
+import {IPermit2} from "@uniswap/permit2/src/interfaces/IPermit2.sol";
 import {REVLoan} from "./../structs/REVLoan.sol";
 import {REVLoanSource} from "./../structs/REVLoanSource.sol";
 
+/// @notice Manages loans against revnet token collateral.
 interface IREVLoans {
+    /// @notice Emitted when a loan is created by borrowing from a revnet.
+    /// @param loanId The ID of the newly created loan.
+    /// @param revnetId The ID of the revnet being borrowed from.
+    /// @param loan The loan data.
+    /// @param source The source of the loan (terminal and token).
+    /// @param borrowAmount The amount borrowed.
+    /// @param collateralCount The amount of collateral tokens locked.
+    /// @param sourceFeeAmount The fee amount charged by the source.
+    /// @param beneficiary The address receiving the borrowed funds.
+    /// @param caller The address that created the loan.
     event Borrow(
         uint256 indexed loanId,
         uint256 indexed revnetId,
@@ -25,7 +35,41 @@ interface IREVLoans {
         address payable beneficiary,
         address caller
     );
+
+    /// @notice Emitted when a loan is liquidated after exceeding the liquidation duration.
+    /// @param loanId The ID of the liquidated loan.
+    /// @param revnetId The ID of the revnet the loan was from.
+    /// @param loan The liquidated loan data.
+    /// @param caller The address that triggered the liquidation.
     event Liquidate(uint256 indexed loanId, uint256 indexed revnetId, REVLoan loan, address caller);
+
+    /// @notice Emitted when collateral is reallocated from one loan to a new loan.
+    /// @param loanId The ID of the original loan.
+    /// @param revnetId The ID of the revnet.
+    /// @param reallocatedLoanId The ID of the loan after reallocation.
+    /// @param reallocatedLoan The reallocated loan data.
+    /// @param removedCollateralCount The amount of collateral removed from the original loan.
+    /// @param caller The address that triggered the reallocation.
+    event ReallocateCollateral(
+        uint256 indexed loanId,
+        uint256 indexed revnetId,
+        uint256 indexed reallocatedLoanId,
+        REVLoan reallocatedLoan,
+        uint256 removedCollateralCount,
+        address caller
+    );
+
+    /// @notice Emitted when a loan is repaid.
+    /// @param loanId The ID of the loan being repaid.
+    /// @param revnetId The ID of the revnet.
+    /// @param paidOffLoanId The ID of the loan after repayment.
+    /// @param loan The original loan data.
+    /// @param paidOffLoan The loan data after repayment.
+    /// @param repayBorrowAmount The amount repaid.
+    /// @param sourceFeeAmount The fee amount charged by the source.
+    /// @param collateralCountToReturn The amount of collateral returned.
+    /// @param beneficiary The address receiving the returned collateral.
+    /// @param caller The address that repaid the loan.
     event RepayLoan(
         uint256 indexed loanId,
         uint256 indexed revnetId,
@@ -38,55 +82,11 @@ interface IREVLoans {
         address payable beneficiary,
         address caller
     );
-    event ReallocateCollateral(
-        uint256 indexed loanId,
-        uint256 indexed revnetId,
-        uint256 indexed reallocatedLoanId,
-        REVLoan reallocatedLoan,
-        uint256 removedCollateralCount,
-        address caller
-    );
-    event SetTokenUriResolver(IJBTokenUriResolver indexed resolver, address caller);
-
-    /// @notice The duration after which a loan expires and its collateral is permanently lost.
-    /// @return The loan liquidation duration in seconds.
-    function LOAN_LIQUIDATION_DURATION() external view returns (uint256);
-
-    /// @notice The permit2 utility used for token transfers.
-    /// @return The permit2 contract.
-    function PERMIT2() external view returns (IPermit2);
 
-    /// @notice The controller that manages revnets using this loans contract.
-    /// @return The controller contract.
-    function CONTROLLER() external view returns (IJBController);
-
-    /// @notice The directory of terminals and controllers for revnets.
-    /// @return The directory contract.
-    function DIRECTORY() external view returns (IJBDirectory);
-
-    /// @notice The contract that stores prices for each revnet.
-    /// @return The prices contract.
-    function PRICES() external view returns (IJBPrices);
-
-    /// @notice The contract that mints ERC-721s representing project ownership.
-    /// @return The projects contract.
-    function PROJECTS() external view returns (IJBProjects);
-
-    /// @notice The ID of the REV revnet that receives protocol fees from loans.
-    /// @return The REV revnet ID.
-    function REV_ID() external view returns (uint256);
-
-    /// @notice The fee percent charged by the REV revnet on each loan, in terms of `JBConstants.MAX_FEE`.
-    /// @return The REV prepaid fee percent.
-    function REV_PREPAID_FEE_PERCENT() external view returns (uint256);
-
-    /// @notice The minimum fee percent that must be prepaid when borrowing, in terms of `JBConstants.MAX_FEE`.
-    /// @return The minimum prepaid fee percent.
-    function MIN_PREPAID_FEE_PERCENT() external view returns (uint256);
-
-    /// @notice The maximum fee percent that can be prepaid when borrowing, in terms of `JBConstants.MAX_FEE`.
-    /// @return The maximum prepaid fee percent.
-    function MAX_PREPAID_FEE_PERCENT() external view returns (uint256);
+    /// @notice Emitted when the token URI resolver is changed.
+    /// @param resolver The new token URI resolver.
+    /// @param caller The address that set the resolver.
+    event SetTokenUriResolver(IJBTokenUriResolver indexed resolver, address caller);
 
     /// @notice The amount that can be borrowed from a revnet given a certain amount of collateral.
     /// @param revnetId The ID of the revnet to check for borrowable assets from.
@@ -104,6 +104,10 @@ interface IREVLoans {
         view
         returns (uint256);
 
+    /// @notice The controller that manages revnets using this loans contract.
+    /// @return The controller contract.
+    function CONTROLLER() external view returns (IJBController);
+
     /// @notice Determines the source fee amount for a loan being paid off a certain amount.
     /// @param loan The loan having its source fee amount determined.
     /// @param amount The amount being paid off.
@@ -116,6 +120,10 @@ interface IREVLoans {
         view
         returns (uint256 sourceFeeAmount);
 
+    /// @notice The directory of terminals and controllers for revnets.
+    /// @return The directory contract.
+    function DIRECTORY() external view returns (IJBDirectory);
+
     /// @notice Whether a revnet currently has outstanding loans from the specified terminal in the specified token.
     /// @param revnetId The ID of the revnet issuing the loan.
     /// @param terminal The terminal that the loan is issued from.
@@ -123,6 +131,10 @@ interface IREVLoans {
     /// @return A flag indicating if the revnet has an active loan source.
     function isLoanSourceOf(uint256 revnetId, IJBPayoutTerminal terminal, address token) external view returns (bool);
 
+    /// @notice The duration after which a loan expires and its collateral is permanently lost.
+    /// @return The loan liquidation duration in seconds.
+    function LOAN_LIQUIDATION_DURATION() external view returns (uint256);
+
     /// @notice Get a loan's details.
     /// @param loanId The ID of the loan to retrieve.
     /// @return The loan data.
@@ -136,13 +148,33 @@ interface IREVLoans {
     /// @return The array of loan sources.
     function loanSourcesOf(uint256 revnetId) external view returns (REVLoanSource[] memory);
 
-    /// @notice The cumulative number of loans ever created for a revnet, used as a loan ID sequence counter.
-    /// @dev This counter only increments and never decrements. It does NOT represent the count of currently active
-    /// loans -- repaid and liquidated loans leave permanent gaps in the sequence. Do not use this value to determine
-    /// how many loans are currently outstanding.
-    /// @param revnetId The ID of the revnet to get the cumulative loan count for.
-    /// @return The cumulative number of loans ever created.
-    function totalLoansBorrowedFor(uint256 revnetId) external view returns (uint256);
+    /// @notice The maximum fee percent that can be prepaid when borrowing, in terms of `JBConstants.MAX_FEE`.
+    /// @return The maximum prepaid fee percent.
+    function MAX_PREPAID_FEE_PERCENT() external view returns (uint256);
+
+    /// @notice The minimum fee percent that must be prepaid when borrowing, in terms of `JBConstants.MAX_FEE`.
+    /// @return The minimum prepaid fee percent.
+    function MIN_PREPAID_FEE_PERCENT() external view returns (uint256);
+
+    /// @notice The permit2 utility used for token transfers.
+    /// @return The permit2 contract.
+    function PERMIT2() external view returns (IPermit2);
+
+    /// @notice The contract that stores prices for each revnet.
+    /// @return The prices contract.
+    function PRICES() external view returns (IJBPrices);
+
+    /// @notice The contract that mints ERC-721s representing project ownership.
+    /// @return The projects contract.
+    function PROJECTS() external view returns (IJBProjects);
+
+    /// @notice The ID of the REV revnet that receives protocol fees from loans.
+    /// @return The REV revnet ID.
+    function REV_ID() external view returns (uint256);
+
+    /// @notice The fee percent charged by the REV revnet on each loan, in terms of `JBConstants.MAX_FEE`.
+    /// @return The REV prepaid fee percent.
+    function REV_PREPAID_FEE_PERCENT() external view returns (uint256);
 
     /// @notice The revnet ID for the loan with the provided loan ID.
     /// @param loanId The loan ID to get the revnet ID of.
@@ -172,6 +204,14 @@ interface IREVLoans {
     /// @return The total collateral count.
     function totalCollateralOf(uint256 revnetId) external view returns (uint256);
 
+    /// @notice The cumulative number of loans ever created for a revnet, used as a loan ID sequence counter.
+    /// @dev This counter only increments and never decrements. It does NOT represent the count of currently active
+    /// loans -- repaid and liquidated loans leave permanent gaps in the sequence. Do not use this value to determine
+    /// how many loans are currently outstanding.
+    /// @param revnetId The ID of the revnet to get the cumulative loan count for.
+    /// @return The cumulative number of loans ever created.
+    function totalLoansBorrowedFor(uint256 revnetId) external view returns (uint256);
+
     /// @notice Open a loan by borrowing from a revnet. Collateral tokens are burned and only re-minted upon repayment.
     /// @param revnetId The ID of the revnet being borrowed from.
     /// @param source The source of the loan (terminal and token).
@@ -198,25 +238,6 @@ interface IREVLoans {
     /// @param count The number of loans to iterate over.
     function liquidateExpiredLoansFrom(uint256 revnetId, uint256 startingLoanId, uint256 count) external;
 
-    /// @notice Repay a loan or return excess collateral no longer needed to support the loan.
-    /// @param loanId The ID of the loan being repaid.
-    /// @param maxRepayBorrowAmount The maximum amount to repay, denominated in the source's token.
-    /// @param collateralCountToReturn The amount of collateral to return from the loan.
-    /// @param beneficiary The address receiving the returned collateral and fee payment tokens.
-    /// @param allowance A permit2 allowance to facilitate the repayment transfer.
-    /// @return paidOffLoanId The ID of the loan after it has been paid off.
-    /// @return paidOffloan The loan after it has been paid off.
-    function repayLoan(
-        uint256 loanId,
-        uint256 maxRepayBorrowAmount,
-        uint256 collateralCountToReturn,
-        address payable beneficiary,
-        JBSingleAllowance calldata allowance
-    )
-        external
-        payable
-        returns (uint256 paidOffLoanId, REVLoan memory paidOffloan);
-
     /// @notice Refinance a loan by transferring extra collateral from an existing loan to a new loan.
     /// @param loanId The ID of the loan to reallocate collateral from.
     /// @param collateralCountToTransfer The amount of collateral to transfer from the original loan.
@@ -241,6 +262,25 @@ interface IREVLoans {
         external
         returns (uint256 reallocatedLoanId, uint256 newLoanId, REVLoan memory reallocatedLoan, REVLoan memory newLoan);
 
+    /// @notice Repay a loan or return excess collateral no longer needed to support the loan.
+    /// @param loanId The ID of the loan being repaid.
+    /// @param maxRepayBorrowAmount The maximum amount to repay, denominated in the source's token.
+    /// @param collateralCountToReturn The amount of collateral to return from the loan.
+    /// @param beneficiary The address receiving the returned collateral and fee payment tokens.
+    /// @param allowance A permit2 allowance to facilitate the repayment transfer.
+    /// @return paidOffLoanId The ID of the loan after it has been paid off.
+    /// @return paidOffloan The loan after it has been paid off.
+    function repayLoan(
+        uint256 loanId,
+        uint256 maxRepayBorrowAmount,
+        uint256 collateralCountToReturn,
+        address payable beneficiary,
+        JBSingleAllowance calldata allowance
+    )
+        external
+        payable
+        returns (uint256 paidOffLoanId, REVLoan memory paidOffloan);
+
     /// @notice Sets the address of the resolver used to retrieve the token URI of loans.
     /// @param resolver The new token URI resolver.
     function setTokenUriResolver(IJBTokenUriResolver resolver) external;

package/src/structs/REV721TiersHookFlags.sol

@@ -0,0 +1,14 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+/// @custom:member noNewTiersWithReserves A flag indicating if new tiers with non-zero reserve frequency are forbidden.
+/// @custom:member noNewTiersWithVotes A flag indicating if new tiers with voting units are forbidden.
+/// @custom:member noNewTiersWithOwnerMinting A flag indicating if new tiers with owner minting are forbidden.
+/// @custom:member preventOverspending A flag indicating if payments exceeding the price of minted NFTs should be
+/// prevented.
+struct REV721TiersHookFlags {
+    bool noNewTiersWithReserves;
+    bool noNewTiersWithVotes;
+    bool noNewTiersWithOwnerMinting;
+    bool preventOverspending;
+}

package/src/structs/REVBaseline721HookConfig.sol

@@ -0,0 +1,27 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {IJB721TokenUriResolver} from "@bananapus/721-hook-v6/src/interfaces/IJB721TokenUriResolver.sol";
+import {JB721InitTiersConfig} from "@bananapus/721-hook-v6/src/structs/JB721InitTiersConfig.sol";
+
+import {REV721TiersHookFlags} from "./REV721TiersHookFlags.sol";
+
+/// @custom:member name The name of the NFT collection.
+/// @custom:member symbol The symbol of the NFT collection.
+/// @custom:member baseUri The base URI for the NFT collection.
+/// @custom:member tokenUriResolver The token URI resolver for the NFT collection.
+/// @custom:member contractUri The contract URI for the NFT collection.
+/// @custom:member tiersConfig The tier configuration for the NFT collection.
+/// @custom:member reserveBeneficiary The default reserve beneficiary for the NFT collection.
+/// @custom:member flags A set of flags that configure the 721 hook. Omits `issueTokensForSplits` since revnets
+/// always force it to `false`.
+struct REVBaseline721HookConfig {
+    string name;
+    string symbol;
+    string baseUri;
+    IJB721TokenUriResolver tokenUriResolver;
+    string contractUri;
+    JB721InitTiersConfig tiersConfig;
+    address reserveBeneficiary;
+    REV721TiersHookFlags flags;
+}

package/src/structs/REVDeploy721TiersHookConfig.sol

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 pragma solidity ^0.8.0;
 
-import {JBDeploy721TiersHookConfig} from "@bananapus/721-hook-v6/src/structs/JBDeploy721TiersHookConfig.sol";
+import {REVBaseline721HookConfig} from "./REVBaseline721HookConfig.sol";
 
 /// @custom:member baseline721HookConfiguration The baseline config.
 /// @custom:member salt The salt to base the collection's address on.
@@ -16,7 +16,7 @@ import {JBDeploy721TiersHookConfig} from "@bananapus/721-hook-v6/src/structs/JBD
 /// the
 /// discount of a tier.
 struct REVDeploy721TiersHookConfig {
-    JBDeploy721TiersHookConfig baseline721HookConfiguration;
+    REVBaseline721HookConfig baseline721HookConfiguration;
     bytes32 salt;
     bool splitOperatorCanAdjustTiers;
     bool splitOperatorCanUpdateMetadata;

package/test/REV.integrations.t.sol

@@ -38,7 +38,7 @@ struct FeeProjectConfig {
     REVSuckerDeploymentConfig suckerDeploymentConfiguration;
 }
 
-contract REVnet_Integrations is TestBaseWorkflow, JBTest {
+contract REVnet_Integrations is TestBaseWorkflow {
     /// @notice the salts that are used to deploy the contracts.
     bytes32 REV_DEPLOYER_SALT = "REVDeployer";
     bytes32 ERC20_SALT = "REV_TOKEN";
@@ -177,7 +177,8 @@ contract REVnet_Integrations is TestBaseWorkflow, JBTest {
 
         HOOK_STORE = new JB721TiersHookStore();
 
-        EXAMPLE_HOOK = new JB721TiersHook(jbDirectory(), jbPermissions(), jbRulesets(), HOOK_STORE, multisig());
+        EXAMPLE_HOOK =
+            new JB721TiersHook(jbDirectory(), jbPermissions(), jbRulesets(), HOOK_STORE, jbSplits(), multisig());
 
         ADDRESS_REGISTRY = new JBAddressRegistry();
 
@@ -192,7 +193,7 @@ contract REVnet_Integrations is TestBaseWorkflow, JBTest {
             FEE_PROJECT_ID,
             HOOK_DEPLOYER,
             PUBLISHER,
-            IJBRulesetDataHook(address(MOCK_BUYBACK)),
+            IJBBuybackHookRegistry(address(MOCK_BUYBACK)),
             makeAddr("loans"),
             TRUSTED_FORWARDER
         );