@bananapus/721-hook-v6 0.0.9 → 0.0.10

package/foundry.toml

@@ -1,7 +1,7 @@
 [profile.default]
 solc = '0.8.26'
 evm_version = 'paris'
-optimizer_runs = 800
+optimizer_runs = 200
 libs = ["node_modules", "lib"]
 fs_permissions = [{ access = "read-write", path = "./"}]
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bananapus/721-hook-v6",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -18,9 +18,9 @@
   },
   "dependencies": {
     "@bananapus/address-registry-v6": "^0.0.4",
-    "@bananapus/core-v6": "^0.0.9",
-    "@bananapus/ownable-v6": "^0.0.5",
-    "@bananapus/permission-ids-v6": "^0.0.4",
+    "@bananapus/core-v6": "^0.0.10",
+    "@bananapus/ownable-v6": "^0.0.6",
+    "@bananapus/permission-ids-v6": "^0.0.5",
     "@openzeppelin/contracts": "5.2.0",
     "@prb/math": "^4.1.0",
     "solady": "^0.1.8"

package/src/JB721TiersHook.sol

@@ -23,12 +23,12 @@ import {IJB721TiersHookStore} from "./interfaces/IJB721TiersHookStore.sol";
 import {IJB721TokenUriResolver} from "./interfaces/IJB721TokenUriResolver.sol";
 import {JB721TiersHookLib} from "./libraries/JB721TiersHookLib.sol";
 import {JB721TiersRulesetMetadataResolver} from "./libraries/JB721TiersRulesetMetadataResolver.sol";
+import {JB721InitTiersConfig} from "./structs/JB721InitTiersConfig.sol";
 import {JB721Tier} from "./structs/JB721Tier.sol";
 import {JB721TierConfig} from "./structs/JB721TierConfig.sol";
-import {JB721TiersSetDiscountPercentConfig} from "./structs/JB721TiersSetDiscountPercentConfig.sol";
-import {JB721InitTiersConfig} from "./structs/JB721InitTiersConfig.sol";
 import {JB721TiersHookFlags} from "./structs/JB721TiersHookFlags.sol";
 import {JB721TiersMintReservesConfig} from "./structs/JB721TiersMintReservesConfig.sol";
+import {JB721TiersSetDiscountPercentConfig} from "./structs/JB721TiersSetDiscountPercentConfig.sol";
 
 /// @title JB721TiersHook
 /// @notice A Juicebox project can use this hook to sell tiered ERC-721 NFTs with different prices and metadata. When
@@ -190,13 +190,6 @@ contract JB721TiersHook is JBOwnable, ERC2771Context, JB721Hook, IJB721TiersHook
         return STORE.cashOutWeightOf({hook: address(this), tokenIds: tokenIds});
     }
 
-    /// @notice Indicates if this contract adheres to the specified interface.
-    /// @dev See {IERC165-supportsInterface}.
-    /// @param interfaceId The ID of the interface to check for adherence to.
-    function supportsInterface(bytes4 interfaceId) public view override(IERC165, JB721Hook) returns (bool) {
-        return interfaceId == type(IJB721TiersHook).interfaceId || JB721Hook.supportsInterface(interfaceId);
-    }
-
     /// @notice Initializes a cloned copy of the original hook contract.
     /// @param projectId The ID of the project this this hook is associated with.
     /// @param name The name of the NFT collection.
@@ -269,6 +262,13 @@ contract JB721TiersHook is JBOwnable, ERC2771Context, JB721Hook, IJB721TiersHook
         _transferOwnership(_msgSender());
     }
 
+    /// @notice Indicates if this contract adheres to the specified interface.
+    /// @dev See {IERC165-supportsInterface}.
+    /// @param interfaceId The ID of the interface to check for adherence to.
+    function supportsInterface(bytes4 interfaceId) public view override(IERC165, JB721Hook) returns (bool) {
+        return interfaceId == type(IJB721TiersHook).interfaceId || JB721Hook.supportsInterface(interfaceId);
+    }
+
     /// @notice The metadata URI of the NFT with the specified token ID.
     /// @dev Defers to the `tokenUriResolver` if it is set. Otherwise, use the `tokenUri` corresponding with the NFT's
     /// tier.

package/src/JB721TiersHookDeployer.sol

@@ -3,12 +3,12 @@ pragma solidity 0.8.26;
 
 import {IJBAddressRegistry} from "@bananapus/address-registry-v6/src/interfaces/IJBAddressRegistry.sol";
 import {JBOwnable} from "@bananapus/ownable-v6/src/JBOwnable.sol";
-import {LibClone} from "solady/src/utils/LibClone.sol";
 import {ERC2771Context} from "@openzeppelin/contracts/metatx/ERC2771Context.sol";
+import {LibClone} from "solady/src/utils/LibClone.sol";
 
 import {JB721TiersHook} from "./JB721TiersHook.sol";
-import {IJB721TiersHookDeployer} from "./interfaces/IJB721TiersHookDeployer.sol";
 import {IJB721TiersHook} from "./interfaces/IJB721TiersHook.sol";
+import {IJB721TiersHookDeployer} from "./interfaces/IJB721TiersHookDeployer.sol";
 import {IJB721TiersHookStore} from "./interfaces/IJB721TiersHookStore.sol";
 import {JBDeploy721TiersHookConfig} from "./structs/JBDeploy721TiersHookConfig.sol";
 

package/src/JB721TiersHookProjectDeployer.sol

@@ -13,14 +13,14 @@ import {JBPermissionIds} from "@bananapus/permission-ids-v6/src/JBPermissionIds.
 import {ERC2771Context} from "@openzeppelin/contracts/metatx/ERC2771Context.sol";
 import {Context} from "@openzeppelin/contracts/utils/Context.sol";
 
+import {IJB721TiersHook} from "./interfaces/IJB721TiersHook.sol";
 import {IJB721TiersHookDeployer} from "./interfaces/IJB721TiersHookDeployer.sol";
 import {IJB721TiersHookProjectDeployer} from "./interfaces/IJB721TiersHookProjectDeployer.sol";
-import {IJB721TiersHook} from "./interfaces/IJB721TiersHook.sol";
 import {JBDeploy721TiersHookConfig} from "./structs/JBDeploy721TiersHookConfig.sol";
-import {JBLaunchRulesetsConfig} from "./structs/JBLaunchRulesetsConfig.sol";
-import {JBQueueRulesetsConfig} from "./structs/JBQueueRulesetsConfig.sol";
 import {JBLaunchProjectConfig} from "./structs/JBLaunchProjectConfig.sol";
+import {JBLaunchRulesetsConfig} from "./structs/JBLaunchRulesetsConfig.sol";
 import {JBPayDataHookRulesetConfig} from "./structs/JBPayDataHookRulesetConfig.sol";
+import {JBQueueRulesetsConfig} from "./structs/JBQueueRulesetsConfig.sol";
 
 /// @title JB721TiersHookProjectDeployer
 /// @notice Deploys a project and a 721 tiers hook for it. Can be used to queue rulesets for the project if given
@@ -195,6 +195,27 @@ contract JB721TiersHookProjectDeployer is ERC2771Context, JBPermissioned, IJB721
         });
     }
 
+    //*********************************************************************//
+    // -------------------------- internal views ------------------------- //
+    //*********************************************************************//
+
+    /// @dev ERC-2771 specifies the context as being a single address (20 bytes).
+    function _contextSuffixLength() internal view virtual override(ERC2771Context, Context) returns (uint256) {
+        return ERC2771Context._contextSuffixLength();
+    }
+
+    /// @notice The calldata. Preferred to use over `msg.data`.
+    /// @return calldata The `msg.data` of this call.
+    function _msgData() internal view override(ERC2771Context, Context) returns (bytes calldata) {
+        return ERC2771Context._msgData();
+    }
+
+    /// @notice The message's sender. Preferred to use over `msg.sender`.
+    /// @return sender The address which sent this call.
+    function _msgSender() internal view override(ERC2771Context, Context) returns (address sender) {
+        return ERC2771Context._msgSender();
+    }
+
     //*********************************************************************//
     // ------------------------ internal functions ----------------------- //
     //*********************************************************************//
@@ -393,21 +414,4 @@ contract JB721TiersHookProjectDeployer is ERC2771Context, JBPermissioned, IJB721
             projectId: projectId, rulesetConfigurations: rulesetConfigurations, memo: queueRulesetsConfig.memo
         });
     }
-
-    /// @notice The calldata. Preferred to use over `msg.data`.
-    /// @return calldata The `msg.data` of this call.
-    function _msgData() internal view override(ERC2771Context, Context) returns (bytes calldata) {
-        return ERC2771Context._msgData();
-    }
-
-    /// @notice The message's sender. Preferred to use over `msg.sender`.
-    /// @return sender The address which sent this call.
-    function _msgSender() internal view override(ERC2771Context, Context) returns (address sender) {
-        return ERC2771Context._msgSender();
-    }
-
-    /// @dev ERC-2771 specifies the context as being a single address (20 bytes).
-    function _contextSuffixLength() internal view virtual override(ERC2771Context, Context) returns (uint256) {
-        return ERC2771Context._contextSuffixLength();
-    }
 }

package/src/JB721TiersHookStore.sol

@@ -383,18 +383,6 @@ contract JB721TiersHookStore is IJB721TiersHookStore {
     // -------------------------- public views --------------------------- //
     //*********************************************************************//
 
-    /// @notice Get the tier with the provided ID from the provided 721 contract.
-    /// @param hook The 721 contract to get the tier from.
-    /// @param id The ID of the tier to get.
-    /// @param includeResolvedUri If set to `true`, if the contract has a token URI resolver, its content will be
-    /// resolved and included.
-    /// @return The tier.
-    function tierOf(address hook, uint256 id, bool includeResolvedUri) public view override returns (JB721Tier memory) {
-        return _getTierFrom({
-            hook: hook, tierId: id, storedTier: _storedTierOf[hook][id], includeResolvedUri: includeResolvedUri
-        });
-    }
-
     /// @notice Get the number of NFTs that the specified address has from the specified 721 contract (across all
     /// tiers).
     /// @param hook The 721 contract to get the balance within.
@@ -454,6 +442,18 @@ contract JB721TiersHookStore is IJB721TiersHookStore {
         return tokenId / _ONE_BILLION;
     }
 
+    /// @notice Get the tier with the provided ID from the provided 721 contract.
+    /// @param hook The 721 contract to get the tier from.
+    /// @param id The ID of the tier to get.
+    /// @param includeResolvedUri If set to `true`, if the contract has a token URI resolver, its content will be
+    /// resolved and included.
+    /// @return The tier.
+    function tierOf(address hook, uint256 id, bool includeResolvedUri) public view override returns (JB721Tier memory) {
+        return _getTierFrom({
+            hook: hook, tierId: id, storedTier: _storedTierOf[hook][id], includeResolvedUri: includeResolvedUri
+        });
+    }
+
     /// @notice The combined cash out weight for all NFTs from the provided 721 contract.
     /// @param hook The 721 contract to get the total cash out weight of.
     /// @return weight The total cash out weight.

package/src/abstract/JB721Hook.sol

@@ -17,8 +17,8 @@ import {JBRuleset} from "@bananapus/core-v6/src/structs/JBRuleset.sol";
 import {IERC2981} from "@openzeppelin/contracts/interfaces/IERC2981.sol";
 import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
 
-import {ERC721} from "./ERC721.sol";
 import {IJB721Hook} from "../interfaces/IJB721Hook.sol";
+import {ERC721} from "./ERC721.sol";
 
 /// @title JB721Hook
 /// @notice When a project which uses this hook is paid, this hook may mint NFTs to the payer, depending on this hook's
@@ -68,26 +68,6 @@ abstract contract JB721Hook is ERC721, IJB721Hook {
     // ------------------------- external views -------------------------- //
     //*********************************************************************//
 
-    /// @notice The data calculated before a payment is recorded in the terminal store. This data is provided to the
-    /// terminal's `pay(...)` transaction.
-    /// @dev Sets this contract as the pay hook. Part of `IJBRulesetDataHook`.
-    /// @param context The payment context passed to this contract by the `pay(...)` function.
-    /// @return weight The new `weight` to use, overriding the ruleset's `weight`.
-    /// @return hookSpecifications The amount and data to send to pay hooks (this contract) instead of adding to the
-    /// terminal's balance.
-    function beforePayRecordedWith(JBBeforePayRecordedContext calldata context)
-        public
-        view
-        virtual
-        override
-        returns (uint256 weight, JBPayHookSpecification[] memory hookSpecifications)
-    {
-        // Forward the received weight and use this contract as the only pay hook.
-        weight = context.weight;
-        hookSpecifications = new JBPayHookSpecification[](1);
-        hookSpecifications[0] = JBPayHookSpecification({hook: this, amount: 0, metadata: bytes("")});
-    }
-
     /// @notice The data calculated before a cash out is recorded in the terminal store. This data is provided to the
     /// terminal's `cashOutTokensOf(...)` transaction.
     /// @dev Sets this contract as the cash out hook. Part of `IJBRulesetDataHook`.
@@ -138,6 +118,26 @@ abstract contract JB721Hook is ERC721, IJB721Hook {
         cashOutTaxRate = context.cashOutTaxRate;
     }
 
+    /// @notice The data calculated before a payment is recorded in the terminal store. This data is provided to the
+    /// terminal's `pay(...)` transaction.
+    /// @dev Sets this contract as the pay hook. Part of `IJBRulesetDataHook`.
+    /// @param context The payment context passed to this contract by the `pay(...)` function.
+    /// @return weight The new `weight` to use, overriding the ruleset's `weight`.
+    /// @return hookSpecifications The amount and data to send to pay hooks (this contract) instead of adding to the
+    /// terminal's balance.
+    function beforePayRecordedWith(JBBeforePayRecordedContext calldata context)
+        public
+        view
+        virtual
+        override
+        returns (uint256 weight, JBPayHookSpecification[] memory hookSpecifications)
+    {
+        // Forward the received weight and use this contract as the only pay hook.
+        weight = context.weight;
+        hookSpecifications = new JBPayHookSpecification[](1);
+        hookSpecifications[0] = JBPayHookSpecification({hook: this, amount: 0, metadata: bytes("")});
+    }
+
     /// @notice Required by the IJBRulesetDataHook interfaces. Return false to not leak any permissions.
     function hasMintPermissionFor(uint256, JBRuleset memory, address) external pure returns (bool) {
         return false;
@@ -175,24 +175,6 @@ abstract contract JB721Hook is ERC721, IJB721Hook {
     // ---------------------- external transactions ---------------------- //
     //*********************************************************************//
 
-    /// @notice Mints one or more NFTs to the `context.beneficiary` upon payment if conditions are met. Part of
-    /// `IJBPayHook`.
-    /// @dev Reverts if the calling contract is not one of the project's terminals.
-    /// @param context The payment context passed in by the terminal.
-    // slither-disable-next-line locked-ether
-    function afterPayRecordedWith(JBAfterPayRecordedContext calldata context) external payable virtual override {
-        uint256 projectId = PROJECT_ID;
-
-        // Make sure the caller is a terminal of the project, and that the call is being made on behalf of an
-        // interaction with the correct project.
-        if (!DIRECTORY.isTerminalOf(projectId, IJBTerminal(msg.sender)) || context.projectId != projectId) {
-            revert JB721Hook_InvalidPay();
-        }
-
-        // Process the payment.
-        _processPayment(context);
-    }
-
     /// @notice Burns the specified NFTs upon token holder cash out, reclaiming funds from the project's balance for
     /// `context.beneficiary`. Part of `IJBCashOutHook`.
     /// @dev Reverts if the calling contract is not one of the project's terminals.
@@ -241,10 +223,32 @@ abstract contract JB721Hook is ERC721, IJB721Hook {
         _didBurn(decodedTokenIds);
     }
 
+    /// @notice Mints one or more NFTs to the `context.beneficiary` upon payment if conditions are met. Part of
+    /// `IJBPayHook`.
+    /// @dev Reverts if the calling contract is not one of the project's terminals.
+    /// @param context The payment context passed in by the terminal.
+    // slither-disable-next-line locked-ether
+    function afterPayRecordedWith(JBAfterPayRecordedContext calldata context) external payable virtual override {
+        uint256 projectId = PROJECT_ID;
+
+        // Make sure the caller is a terminal of the project, and that the call is being made on behalf of an
+        // interaction with the correct project.
+        if (!DIRECTORY.isTerminalOf(projectId, IJBTerminal(msg.sender)) || context.projectId != projectId) {
+            revert JB721Hook_InvalidPay();
+        }
+
+        // Process the payment.
+        _processPayment(context);
+    }
+
     //*********************************************************************//
-    // ---------------------- internal transactions ---------------------- //
+    // ------------------------ internal functions ----------------------- //
     //*********************************************************************//
 
+    /// @notice Executes after NFTs have been burned via cash out.
+    /// @param tokenIds The token IDs of the NFTs that were burned.
+    function _didBurn(uint256[] memory tokenIds) internal virtual;
+
     /// @notice Initializes the contract by associating it with a project and adding ERC721 details.
     /// @param projectId The ID of the project that this contract is associated with.
     /// @param name The name of the NFT collection.
@@ -254,10 +258,6 @@ abstract contract JB721Hook is ERC721, IJB721Hook {
         PROJECT_ID = projectId;
     }
 
-    /// @notice Executes after NFTs have been burned via cash out.
-    /// @param tokenIds The token IDs of the NFTs that were burned.
-    function _didBurn(uint256[] memory tokenIds) internal virtual;
-
     /// @notice Process a received payment.
     /// @param context The payment context passed in by the terminal.
     function _processPayment(JBAfterPayRecordedContext calldata context) internal virtual;

package/src/interfaces/IJB721Hook.sol

@@ -6,6 +6,7 @@ import {IJBDirectory} from "@bananapus/core-v6/src/interfaces/IJBDirectory.sol";
 import {IJBPayHook} from "@bananapus/core-v6/src/interfaces/IJBPayHook.sol";
 import {IJBRulesetDataHook} from "@bananapus/core-v6/src/interfaces/IJBRulesetDataHook.sol";
 
+/// @notice A 721 hook that integrates with Juicebox as a data hook, pay hook, and cash out hook.
 interface IJB721Hook is IJBRulesetDataHook, IJBPayHook, IJBCashOutHook {
     /// @notice The directory of terminals and controllers for projects.
     /// @return The directory contract.

package/src/interfaces/IJB721TiersHook.sol

@@ -13,11 +13,29 @@ import {JB721TiersHookFlags} from "../structs/JB721TiersHookFlags.sol";
 import {JB721TiersMintReservesConfig} from "../structs/JB721TiersMintReservesConfig.sol";
 import {JB721TiersSetDiscountPercentConfig} from "../structs/JB721TiersSetDiscountPercentConfig.sol";
 
+/// @notice A 721 tiers hook that mints tiered NFTs for payments and tracks their cash out weight.
 interface IJB721TiersHook is IJB721Hook {
+    /// @notice Emitted when pay credits are added for an account.
+    /// @param amount The amount of credits added.
+    /// @param newTotalCredits The new total credits balance for the account.
+    /// @param account The account that received the credits.
+    /// @param caller The address that called the function.
     event AddPayCredits(
         uint256 indexed amount, uint256 indexed newTotalCredits, address indexed account, address caller
     );
+
+    /// @notice Emitted when a new tier is added.
+    /// @param tierId The ID of the tier that was added.
+    /// @param tier The configuration of the tier that was added.
+    /// @param caller The address that called the function.
     event AddTier(uint256 indexed tierId, JB721TierConfig tier, address caller);
+
+    /// @notice Emitted when an NFT is minted from a payment.
+    /// @param tokenId The token ID of the minted NFT.
+    /// @param tierId The ID of the tier the NFT was minted from.
+    /// @param beneficiary The address that received the NFT.
+    /// @param totalAmountPaid The total amount paid in the transaction.
+    /// @param caller The address that called the function.
     event Mint(
         uint256 indexed tokenId,
         uint256 indexed tierId,
@@ -25,25 +43,55 @@ interface IJB721TiersHook is IJB721Hook {
         uint256 totalAmountPaid,
         address caller
     );
+
+    /// @notice Emitted when a reserved NFT is minted.
+    /// @param tokenId The token ID of the minted reserved NFT.
+    /// @param tierId The ID of the tier the reserved NFT was minted from.
+    /// @param beneficiary The address that received the reserved NFT.
+    /// @param caller The address that called the function.
     event MintReservedNft(uint256 indexed tokenId, uint256 indexed tierId, address indexed beneficiary, address caller);
+
+    /// @notice Emitted when a tier is removed.
+    /// @param tierId The ID of the tier that was removed.
+    /// @param caller The address that called the function.
     event RemoveTier(uint256 indexed tierId, address caller);
+
+    /// @notice Emitted when the base URI is set.
+    /// @param baseUri The new base URI.
+    /// @param caller The address that called the function.
     event SetBaseUri(string indexed baseUri, address caller);
+
+    /// @notice Emitted when the contract URI is set.
+    /// @param uri The new contract URI.
+    /// @param caller The address that called the function.
     event SetContractUri(string indexed uri, address caller);
+
+    /// @notice Emitted when a tier's discount percent is set.
+    /// @param tierId The ID of the tier whose discount percent was set.
+    /// @param discountPercent The new discount percent.
+    /// @param caller The address that called the function.
     event SetDiscountPercent(uint256 indexed tierId, uint256 discountPercent, address caller);
+
+    /// @notice Emitted when a tier's encoded IPFS URI is set.
+    /// @param tierId The ID of the tier whose encoded IPFS URI was set.
+    /// @param encodedUri The new encoded IPFS URI.
+    /// @param caller The address that called the function.
     event SetEncodedIPFSUri(uint256 indexed tierId, bytes32 encodedUri, address caller);
+
+    /// @notice Emitted when the token URI resolver is set.
+    /// @param resolver The new token URI resolver.
+    /// @param caller The address that called the function.
     event SetTokenUriResolver(IJB721TokenUriResolver indexed resolver, address caller);
+
+    /// @notice Emitted when pay credits are used by an account.
+    /// @param amount The amount of credits used.
+    /// @param newTotalCredits The new total credits balance for the account.
+    /// @param account The account that used the credits.
+    /// @param caller The address that called the function.
     event UsePayCredits(
         uint256 indexed amount, uint256 indexed newTotalCredits, address indexed account, address caller
     );
 
-    /// @notice The contract storing and managing project rulesets.
-    /// @return The rulesets contract.
-    function RULESETS() external view returns (IJBRulesets);
-
-    /// @notice The contract that stores and manages data for this contract's NFTs.
-    /// @return The store contract.
-    function STORE() external view returns (IJB721TiersHookStore);
-
     /// @notice The base URI for the NFT `tokenUris`.
     /// @return The base URI string.
     function baseURI() external view returns (string memory);
@@ -68,6 +116,14 @@ interface IJB721TiersHook is IJB721Hook {
     /// @return prices The prices contract used to resolve the value of payments in other currencies.
     function pricingContext() external view returns (uint256 currency, uint256 decimals, IJBPrices prices);
 
+    /// @notice The contract storing and managing project rulesets.
+    /// @return The rulesets contract.
+    function RULESETS() external view returns (IJBRulesets);
+
+    /// @notice The contract that stores and manages data for this contract's NFTs.
+    /// @return The store contract.
+    function STORE() external view returns (IJB721TiersHookStore);
+
     /// @notice Add or remove tiers.
     /// @param tiersToAdd The tiers to add, as an array of `JB721TierConfig` structs.
     /// @param tierIdsToRemove The tiers to remove, as an array of tier IDs.
@@ -94,15 +150,6 @@ interface IJB721TiersHook is IJB721Hook {
     )
         external;
 
-    /// @notice Set the discount percent for a tier.
-    /// @param tierId The ID of the tier to set the discount of.
-    /// @param discountPercent The discount percent to set.
-    function setDiscountPercentOf(uint256 tierId, uint256 discountPercent) external;
-
-    /// @notice Set the discount percent for multiple tiers.
-    /// @param configs The configs to set the discount percent for.
-    function setDiscountPercentsOf(JB721TiersSetDiscountPercentConfig[] calldata configs) external;
-
     /// @notice Manually mint NFTs from the provided tiers.
     /// @param tierIds The IDs of the tiers to mint from.
     /// @param beneficiary The address to mint to.
@@ -118,6 +165,15 @@ interface IJB721TiersHook is IJB721Hook {
     /// @param count The number of reserved NFTs to mint.
     function mintPendingReservesFor(uint256 tierId, uint256 count) external;
 
+    /// @notice Set the discount percent for a tier.
+    /// @param tierId The ID of the tier to set the discount of.
+    /// @param discountPercent The discount percent to set.
+    function setDiscountPercentOf(uint256 tierId, uint256 discountPercent) external;
+
+    /// @notice Set the discount percent for multiple tiers.
+    /// @param configs The configs to set the discount percent for.
+    function setDiscountPercentsOf(JB721TiersSetDiscountPercentConfig[] calldata configs) external;
+
     /// @notice Update this hook's URI metadata properties.
     /// @param baseUri The new base URI.
     /// @param contractUri The new contract URI.

package/src/interfaces/IJB721TiersHookDeployer.sol

@@ -4,7 +4,12 @@ pragma solidity ^0.8.0;
 import {IJB721TiersHook} from "./IJB721TiersHook.sol";
 import {JBDeploy721TiersHookConfig} from "../structs/JBDeploy721TiersHookConfig.sol";
 
+/// @notice Deploys 721 tiers hooks for projects.
 interface IJB721TiersHookDeployer {
+    /// @notice Emitted when a 721 tiers hook is deployed for a project.
+    /// @param projectId The ID of the project the hook was deployed for.
+    /// @param hook The deployed hook contract.
+    /// @param caller The address that called the function.
     event HookDeployed(uint256 indexed projectId, IJB721TiersHook hook, address caller);
 
     /// @notice Deploys a 721 tiers hook for the specified project.

package/src/interfaces/IJB721TiersHookProjectDeployer.sol

@@ -1,8 +1,8 @@
 // SPDX-License-Identifier: MIT
 pragma solidity ^0.8.0;
 
-import {IJBDirectory} from "@bananapus/core-v6/src/interfaces/IJBDirectory.sol";
 import {IJBController} from "@bananapus/core-v6/src/interfaces/IJBController.sol";
+import {IJBDirectory} from "@bananapus/core-v6/src/interfaces/IJBDirectory.sol";
 
 import {IJB721TiersHook} from "./IJB721TiersHook.sol";
 import {IJB721TiersHookDeployer} from "./IJB721TiersHookDeployer.sol";
@@ -11,6 +11,7 @@ import {JBLaunchProjectConfig} from "../structs/JBLaunchProjectConfig.sol";
 import {JBLaunchRulesetsConfig} from "../structs/JBLaunchRulesetsConfig.sol";
 import {JBQueueRulesetsConfig} from "../structs/JBQueueRulesetsConfig.sol";
 
+/// @notice Deploys projects with 721 tiers hooks attached.
 interface IJB721TiersHookProjectDeployer {
     /// @notice The directory of terminals and controllers for projects.
     /// @return The directory contract.

package/src/interfaces/IJB721TiersHookStore.sol

@@ -6,7 +6,11 @@ import {JB721Tier} from "../structs/JB721Tier.sol";
 import {JB721TierConfig} from "../structs/JB721TierConfig.sol";
 import {JB721TiersHookFlags} from "../structs/JB721TiersHookFlags.sol";
 
+/// @notice Stores and manages data for 721 tiers hooks.
 interface IJB721TiersHookStore {
+    /// @notice Emitted when removed tiers are cleaned from the sorting sequence.
+    /// @param hook The 721 contract whose tiers were cleaned.
+    /// @param caller The address that called the function.
     event CleanTiers(address indexed hook, address caller);
 
     /// @notice Emitted when the default reserve beneficiary is changed.

package/src/interfaces/IJB721TokenUriResolver.sol

@@ -1,6 +1,7 @@
 // SPDX-License-Identifier: MIT
 pragma solidity ^0.8.0;
 
+/// @notice Resolves token URIs for 721 NFTs.
 interface IJB721TokenUriResolver {
     /// @notice Resolve the token URI for the given NFT.
     /// @param nft The address of the NFT contract.