@bananapus/721-hook-v6 0.0.28 → 0.0.30

package/test/unit/getters_constructor_Unit.t.sol

@@ -3,6 +3,8 @@ pragma solidity 0.8.28;
 
 // forge-lint: disable-next-line(unaliased-plain-import)
 import "../utils/UnitTestSetup.sol";
+import {JB721TierConfigFlags} from "../../src/structs/JB721TierConfigFlags.sol";
+import {JB721TierFlags} from "../../src/structs/JB721TierFlags.sol";
 
 contract Test_Getters_Constructor_Unit is UnitTestSetup {
     using stdStorage for StdStorage;
@@ -151,11 +153,13 @@ contract Test_Getters_Constructor_Unit is UnitTestSetup {
                     encodedIPFSUri: bytes32(0),
                     category: uint24(100),
                     discountPercent: uint8(0),
-                    allowOwnerMint: false,
-                    transfersPausable: false,
-                    cantBeRemoved: false,
-                    cantIncreaseDiscountPercent: false,
-                    cantBuyWithCredits: false,
+                    flags: JB721TierFlags({
+                        allowOwnerMint: false,
+                        transfersPausable: false,
+                        cantBeRemoved: false,
+                        cantIncreaseDiscountPercent: false,
+                        cantBuyWithCredits: false
+                    }),
                     splitPercent: 0,
                     resolvedUri: ""
                 })
@@ -265,7 +269,7 @@ contract Test_Getters_Constructor_Unit is UnitTestSetup {
         votingUnits = bound(votingUnits, 1, type(uint32).max);
         balances = bound(balances, 1, type(uint32).max);
 
-        defaultTierConfig.useVotingUnits = true;
+        defaultTierConfig.flags.useVotingUnits = true;
         // forge-lint: disable-next-line(unsafe-typecast)
         defaultTierConfig.votingUnits = uint32(votingUnits);
         ForTest_JB721TiersHook hook = _initializeForTestHook(numberOfTiers);
@@ -474,7 +478,7 @@ contract Test_Getters_Constructor_Unit is UnitTestSetup {
         vm.assume(newOwner != trustedForwarder);
         vm.assume(previousOwner != trustedForwarder);
 
-        defaultTierConfig.allowOwnerMint = true;
+        defaultTierConfig.flags.allowOwnerMint = true;
         defaultTierConfig.reserveFrequency = 0;
         ForTest_JB721TiersHook hook = _initializeForTestHook(10);
 
@@ -546,13 +550,15 @@ contract Test_Getters_Constructor_Unit is UnitTestSetup {
                 encodedIPFSUri: tokenUris[0],
                 category: uint24(100),
                 discountPercent: uint8(0),
-                allowOwnerMint: false,
-                useReserveBeneficiaryAsDefault: false,
-                transfersPausable: false,
-                useVotingUnits: true,
-                cantBeRemoved: false,
-                cantIncreaseDiscountPercent: false,
-                cantBuyWithCredits: false,
+                flags: JB721TierConfigFlags({
+                    allowOwnerMint: false,
+                    useReserveBeneficiaryAsDefault: false,
+                    transfersPausable: false,
+                    useVotingUnits: true,
+                    cantBeRemoved: false,
+                    cantIncreaseDiscountPercent: false,
+                    cantBuyWithCredits: false
+                }),
                 splitPercent: 0,
                 splits: new JBSplit[](0)
             });

package/test/unit/mintFor_mintReservesFor_Unit.t.sol

@@ -414,7 +414,7 @@ contract Test_mintFor_mintReservesFor_Unit is UnitTestSetup {
     function test_mintFor_mintArrayOfTiers() public {
         uint256 numberOfTiers = 3;
 
-        defaultTierConfig.allowOwnerMint = true;
+        defaultTierConfig.flags.allowOwnerMint = true;
         defaultTierConfig.reserveFrequency = 0;
         ForTest_JB721TiersHook hook = _initializeForTestHook(numberOfTiers);
 
@@ -454,7 +454,7 @@ contract Test_mintFor_mintReservesFor_Unit is UnitTestSetup {
         }
 
         // Set the `allowOwnerMint` flag to false and initialize the hook.
-        defaultTierConfig.allowOwnerMint = false;
+        defaultTierConfig.flags.allowOwnerMint = false;
         ForTest_JB721TiersHook hook = _initializeForTestHook(numberOfTiers);
 
         vm.prank(owner);

package/test/unit/pay_Unit.t.sol

@@ -1309,7 +1309,7 @@ contract Test_afterPayRecorded_Unit is UnitTestSetup {
     // as long as the `transfersPausable` flag must be true.
     // Transfers involving the zero address (minting and burning) are not affected.
     function test_transferFrom_revertTransferIfPausedInRuleset() public {
-        defaultTierConfig.transfersPausable = true;
+        defaultTierConfig.flags.transfersPausable = true;
         JB721TiersHook hook = _initHookDefaultTiers(10);
 
         // Mock the directory call.

package/CHANGE_LOG.md

@@ -1,359 +0,0 @@
-# nana-721-hook-v6 Changelog (v5 → v6)
-
-This document describes all changes between `nana-721-hook` (v5) and `nana-721-hook-v6` (v6).
-
-## Summary
-
-- **Tier splits system**: Each NFT tier can now route a percentage of payments to split recipients instead of the project treasury, with full DOS protection via try-catch on all external calls.
-- **`votingUnits` replaced by `splitPercent`** in packed tier storage — voting units moved to a separate mapping to free the storage slot for the more widely-needed split feature.
-- **New `JB721TiersHookLib` library**: Code extracted from the hook to stay within the EIP-170 contract size limit (24KB).
-- **Mutable collection metadata**: `name` and `symbol` can now be changed post-deployment via `setMetadata()`.
-- **Prices moved to constructor immutable**: `IJBPrices` is now a constructor parameter instead of being packed in tier config.
-
----
-
-## 1. Breaking Changes
-
-### 1.1 `IJB721TiersHook` — Changed Function Signatures
-
-| Function | v5 Signature | v6 Signature | Notes |
-|----------|-------------|-------------|-------|
-| `pricingContext()` | `returns (uint256, uint256, IJBPrices)` | `returns (uint256 currency, uint256 decimals)` | `IJBPrices` removed from return; now a separate `PRICES()` getter |
-| `setMetadata(...)` | `(string baseUri, string contractMetadataUri, IJB721TokenUriResolver, uint256, bytes32)` | `(string name, string symbol, string baseUri, string contractUri, IJB721TokenUriResolver, uint256, bytes32)` | Added `name` and `symbol` parameters; `contractMetadataUri` renamed to `contractUri` |
-
-### 1.2 `JB721Hook` (abstract) — Changed Function Signatures
-
-| Function | v5 Signature | v6 Signature | Notes |
-|----------|-------------|-------------|-------|
-| `cashOutWeightOf(...)` | `(uint256[] memory, JBBeforeCashOutRecordedContext calldata) returns (uint256)` | `(uint256[] memory) returns (uint256)` | Removed `JBBeforeCashOutRecordedContext` parameter |
-| `totalCashOutWeight(...)` | `(JBBeforeCashOutRecordedContext calldata) returns (uint256)` | `() returns (uint256)` | Removed `JBBeforeCashOutRecordedContext` parameter |
-| `afterPayRecordedWith(...)` | Reverts if `msg.value != 0` | No `msg.value` check | v6 removes the `msg.value != 0` revert condition from pay hook validation |
-
-### 1.3 `JB721TiersHook` — Changed Constructor
-
-| Parameter | v5 | v6 | Notes |
-|-----------|----|----|-------|
-| `prices` | Not a parameter (packed in `_packedPricingContext`) | `IJBPrices prices` | Now an immutable constructor parameter |
-| `splits` | Not present | `IJBSplits splits` | New immutable for tier split distribution |
-
-### 1.4 `JB721InitTiersConfig` — Removed Field
-
-| Field | v5 | v6 | Notes |
-|-------|----|----|-------|
-| `prices` | `IJBPrices prices` | Removed | Prices contract moved to `JB721TiersHook` constructor as an immutable |
-
-### 1.5 `JB721Constants` — Renamed Constant
-
-| v5 | v6 | Notes |
-|----|----|-------|
-| `MAX_DISCOUNT_PERCENT` | `DISCOUNT_DENOMINATOR` | Same value (`200`), renamed for clarity |
-
-### 1.6 `JBStored721Tier` — Replaced Field
-
-| Field | v5 | v6 | Notes |
-|-------|----|----|-------|
-| `votingUnits` (`uint32`) | Present | Removed | Replaced by `splitPercent` |
-| `splitPercent` (`uint32`) | Not present | Added | Percentage of tier price routed to splits |
-
-> **Why this change**: On-chain voting units were rarely used by projects, while per-tier payment splits were the most requested feature. Reusing the same `uint32` storage slot avoided expanding the packed struct and kept gas costs unchanged. Voting units are still available via the `_tierVotingUnitsOf` mapping.
-
-### 1.7 Error Signature Changes (Store)
-
-Several store errors gained a `tierId` parameter for better debugging:
-
-| Error | v5 | v6 |
-|-------|----|----|
-| `CantMintManually` | `()` | `(uint256 tierId)` |
-| `CantRemoveTier` | `()` | `(uint256 tierId)` |
-| `InsufficientSupplyRemaining` | `()` | `(uint256 tierId)` |
-| `ManualMintingNotAllowed` | `()` | `(uint256 tierId)` |
-| `ReserveFrequencyNotAllowed` | `()` | `(uint256 tierId)` |
-| `UnrecognizedTier` | `()` | `(uint256 tierId)` |
-| `VotingUnitsNotAllowed` | `()` | `(uint256 tierId)` |
-| `ZeroInitialSupply` | `()` | `(uint256 tierId)` |
-
-### 1.8 Solidity Version Change
-
-All contracts upgraded from `pragma solidity 0.8.23` to `pragma solidity 0.8.28`.
-
-### 1.9 Cross-Repo Impact
-
-> The tier splits system affects `revnet-core-v6`, `croptop-core-v6`, and `nana-omnichain-deployers-v6`, which all deploy 721 hooks and must account for the new `splitPercent`/`splits` fields in `JB721TierConfig`. The `issueTokensForSplits` flag in `JB721TiersHookFlags` is force-set to `false` by `revnet-core-v6` to prevent dilution.
-
----
-
-## 2. New Features
-
-### 2.1 Tier Splits System
-
-The largest new feature in v6. Each tier can now define a `splitPercent` and a set of `JBSplit[]` recipients. When an NFT is minted from a tier with splits configured, a portion of the payment is routed to the tier's split group recipients instead of entering the project's balance.
-
-**New immutables on `JB721TiersHook`:**
-
-| Name | Type | Description |
-|------|------|-------------|
-| `PRICES()` | `IJBPrices` | Price feed contract (was previously packed in `_packedPricingContext`) |
-| `SPLITS()` | `IJBSplits` | Splits contract for reading/writing tier split groups |
-
-**New library: `JB721TiersHookLib`** (entirely new in v6)
-
-Contains functions extracted from `JB721TiersHook` to stay within the EIP-170 contract size limit:
-
-| Function | Description |
-|----------|-------------|
-| `adjustTiersFor(...)` | Handles tier removal, addition, event emission, and split group setting |
-| `recordAddTiersFor(...)` | Records new tiers and sets their split groups (used during initialization) |
-| `normalizePaymentValue(...)` | Normalizes payment value based on pricing context |
-| `calculateSplitAmounts(...)` | Calculates per-tier split amounts for a pay event |
-| `convertAndCapSplitAmounts(...)` | Converts split amounts between currencies, capped at payment value |
-| `calculateWeight(...)` | Adjusts minting weight to account for split amounts |
-| `distributeAll(...)` | Pulls tokens and distributes forwarded funds to tier split recipients |
-| `resolveTokenURI(...)` | Resolves the token URI (moved IPFS decoding out of hook) |
-
-**New flag on `JB721TiersHookFlags`:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `issueTokensForSplits` | `bool` | When `true`, payers receive full token credit even for the portion routed to splits. When `false` (default), weight is reduced proportionally. |
-
-### 2.2 Mutable Collection Name and Symbol
-
-The ERC721 collection `name` and `symbol` can now be changed after initialization via `setMetadata(...)`.
-
-**New internal functions on `ERC721` (abstract):**
-
-| Function | Description |
-|----------|-------------|
-| `_setName(string memory)` | Updates the token collection name |
-| `_setSymbol(string memory)` | Updates the token collection symbol |
-
-### 2.3 `split.hook` Support in Tier Distribution
-
-Tier split payouts now support the `split.hook` field (`IJBSplitHook`). The distribution priority follows the same order as `JBMultiTerminal`: hook > projectId > beneficiary. In v5, tier splits did not exist. In v6, this ensures full parity with core split behavior.
-
-### 2.4 DOS Protection on Split Distribution
-
-All external calls during tier split distribution (split hooks, terminal `pay`/`addToBalanceOf`, and leftover distribution) are wrapped in try-catch. A reverting split recipient or terminal cannot brick payments to the project. On failure, the failed amount is accumulated separately and routed to the project balance after the distribution loop completes. This proportional redistribution ensures that later split recipients receive only their configured share, not an inflated share from the failed recipient's funds. A `SplitPayoutReverted` or `AddToBalanceReverted` event is emitted with the revert reason. For ERC-20 split hook failures, tokens are transferred first and the hook callback is best-effort; for ERC-20 terminal failures, the approval is reset to zero.
-
-### 2.5 `splitPercent` Bounds Validation
-
-`JB721TiersHookStore.recordAddTiers` now validates that each tier's `splitPercent` does not exceed `JBConstants.SPLITS_TOTAL_PERCENT`. If it does, it reverts with `JB721TiersHookStore_SplitPercentExceedsBounds(uint256 percent, uint256 limit)`.
-
-### 2.6 `beforePayRecordedWith` Override in `JB721TiersHook`
-
-v6 overrides `beforePayRecordedWith` in `JB721TiersHook` (not just the base `JB721Hook`). The override calculates per-tier split amounts and adjusts the minting weight so the terminal only mints project tokens for the portion of the payment that actually enters the project. It also sets the `JBPayHookSpecification.amount` to the total split amount so the terminal forwards those funds to the hook for distribution.
-
-### 2.7 Pricing Decimals Validation
-
-`initialize(...)` now reverts with `JB721TiersHook_InvalidPricingDecimals` if `tiersConfig.decimals > 18`.
-
-### 2.8 `allowSetCustomToken` Pass-Through
-
-The `JBPayDataHookRulesetMetadata` struct gained an `allowSetCustomToken` field. In v5, the project deployer hardcoded this to `false`. In v6, it passes through the value from the config.
-
----
-
-## 3. Event Changes
-
-### 3.1 New Events on `IJB721TiersHook`
-
-| Event | Signature | Description |
-|-------|-----------|-------------|
-| `AddToBalanceReverted` | `AddToBalanceReverted(uint256 indexed projectId, address token, uint256 amount, bytes reason)` | Emitted when leftover distribution's `addToBalanceOf` call fails. Funds remain in the hook contract. |
-| `SetName` | `SetName(string indexed name, address caller)` | Emitted when the collection name is changed |
-| `SetSymbol` | `SetSymbol(string indexed symbol, address caller)` | Emitted when the collection symbol is changed |
-| `SplitPayoutReverted` | `SplitPayoutReverted(uint256 indexed projectId, JBSplit split, uint256 amount, bytes reason, address caller)` | Emitted when a split payout reverts during distribution. The failed split's funds route to the project balance. |
-
-### 3.2 New Event on `IJB721TiersHookStore`
-
-| Event | Signature | Description |
-|-------|-----------|-------------|
-| `SetDefaultReserveBeneficiary` | `SetDefaultReserveBeneficiary(address indexed hook, address indexed newBeneficiary, address caller)` | Emitted when the global default reserve beneficiary is changed via `useReserveBeneficiaryAsDefault` |
-
-### 3.3 Events Unchanged
-
-All other events (`AddPayCredits`, `AddTier`, `Mint`, `MintReservedNft`, `RemoveTier`, `SetBaseUri`, `SetContractUri`, `SetDiscountPercent`, `SetEncodedIPFSUri`, `SetTokenUriResolver`, `UsePayCredits`, `CleanTiers`, `HookDeployed`) remain unchanged.
-
----
-
-## 4. Error Changes
-
-### 4.1 New Errors on `JB721TiersHook`
-
-| Error | Signature | Description |
-|-------|-----------|-------------|
-| `JB721TiersHook_CurrencyMismatch` | `(uint256 paymentCurrency, uint256 tierCurrency)` | Reserved for currency mismatch detection |
-| `JB721TiersHook_InvalidPricingDecimals` | `(uint256 decimals)` | Reverts when `tiersConfig.decimals > 18` during initialization |
-
-### 4.2 New Error on `JB721TiersHookStore`
-
-| Error | Signature | Description |
-|-------|-----------|-------------|
-| `JB721TiersHookStore_SplitPercentExceedsBounds` | `(uint256 percent, uint256 limit)` | Reverts when a tier's `splitPercent` exceeds `JBConstants.SPLITS_TOTAL_PERCENT` during `recordAddTiers` |
-
-### 4.3 Store Errors with Added `tierId` Parameter
-
-See Section 1.7 above. Eight store errors gained a `tierId` parameter for improved debuggability.
-
-### 4.4 Errors Unchanged
-
-All other errors (`JB721Hook_InvalidPay`, `JB721Hook_InvalidCashOut`, `JB721Hook_UnauthorizedToken`, `JB721Hook_UnexpectedTokenCashedOut`, `JB721TiersHook_AlreadyInitialized`, `JB721TiersHook_NoProjectId`, `JB721TiersHook_Overspending`, `JB721TiersHook_MintReserveNftsPaused`, `JB721TiersHook_TierTransfersPaused`) remain unchanged.
-
----
-
-## 5. Struct Changes
-
-### 5.1 `JB721Tier` — Added Field
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `splitPercent` | `uint32` | Percentage of the tier's price routed to the tier's split group (out of `JBConstants.SPLITS_TOTAL_PERCENT`). Inserted between `cannotIncreaseDiscountPercent` and `resolvedUri`. |
-
-### 5.2 `JB721TierConfig` — Added Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `splitPercent` | `uint32` | Percentage of payment routed to splits when minting from this tier |
-| `splits` | `JBSplit[]` | The split recipients for this tier's split group |
-
-### 5.3 `JBStored721Tier` — Replaced Field
-
-The `votingUnits` (`uint32`) field was replaced by `splitPercent` (`uint32`) in the storage layout. Voting units are still tracked but no longer stored in the packed tier struct (they use the existing `_tierVotingUnitsOf` mapping).
-
-### 5.4 `JB721InitTiersConfig` — Removed Field
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `prices` | `IJBPrices` | Removed. The prices contract is now an immutable on the hook itself. |
-
-### 5.5 `JB721TiersHookFlags` — Added Field
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `issueTokensForSplits` | `bool` | Whether payers receive token credit for the split portion of their payment |
-
-### 5.6 `JBPayDataHookRulesetMetadata` — Added Field
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `allowSetCustomToken` | `bool` | Whether the project owner can set a custom ERC-20 token. Inserted between `allowOwnerMinting` and `allowTerminalMigration`. |
-
-### 5.7 Structs Unchanged
-
-`JB721TiersMintReservesConfig`, `JB721TiersSetDiscountPercentConfig`, `JB721TiersRulesetMetadata`, `JBBitmapWord`, `JBDeploy721TiersHookConfig`, `JBLaunchProjectConfig`, `JBLaunchRulesetsConfig`, `JBQueueRulesetsConfig`, `JBPayDataHookRulesetConfig` remain structurally identical (import paths updated from core-v5 to core-v6).
-
----
-
-## 6. Implementation Changes (Non-Interface)
-
-### 6.1 `JB721TiersHook._processPayment` — Split Distribution
-
-After minting NFTs and updating pay credits, v6 checks `context.hookMetadata` and `context.forwardedAmount.value`. If both are non-zero, it calls `JB721TiersHookLib.distributeAll(...)` to distribute the forwarded funds to tier split recipients. This is the core of the tier splits flow.
-
-### 6.2 `JB721TiersHook.adjustTiers` — Delegated to Library
-
-In v5, `adjustTiers` directly called `STORE.recordRemoveTierIds()` and `STORE.recordAddTiers()` with inline event emission. In v6, the entire operation is delegated to `JB721TiersHookLib.adjustTiersFor(...)`, which also handles setting split groups for newly added tiers in `JBSplits`.
-
-### 6.3 `JB721TiersHook.initialize` — Split Group Setup
-
-During initialization, v6 uses `JB721TiersHookLib.recordAddTiersFor(...)` instead of calling `STORE.recordAddTiers()` directly. This also sets up split groups for tiers that have splits configured.
-
-### 6.4 `JB721TiersHook.tokenURI` — Delegated to Library
-
-In v5, `tokenURI` resolved the URI inline (checking the resolver, then falling back to IPFS decoding). In v6, this is delegated to `JB721TiersHookLib.resolveTokenURI(...)` to reduce contract bytecode size.
-
-### 6.5 `JB721TiersHook._processPayment` — Payment Normalization Delegated
-
-In v5, the payment value normalization (currency conversion via `IJBPrices`) was done inline. In v6, it is delegated to `JB721TiersHookLib.normalizePaymentValue(...)`.
-
-### 6.6 `JB721TiersHook._packedPricingContext` — Reduced Packing
-
-In v5, `_packedPricingContext` packed three values: currency (bits 0-31), decimals (bits 32-39), and prices contract address (bits 40-199). In v6, it only packs currency and decimals (bits 0-39) since the prices contract is now a separate immutable.
-
-### 6.7 `JB721Hook.afterPayRecordedWith` — Removed `msg.value` Check
-
-v5 reverted if `msg.value != 0` in `afterPayRecordedWith`. v6 removes this check because the hook now accepts forwarded native token payments for tier split distribution.
-
-### 6.8 `JB721TiersHookLib._sendPayoutToSplit` — `split.hook` Priority
-
-Split payouts follow the same priority order as `JBMultiTerminal`: if `split.hook` is set, funds are sent to the hook via `processSplitWith`; otherwise if `split.projectId` is set, funds go to the project's primary terminal; otherwise funds go to `split.beneficiary`. For ERC-20 payments to hooks, tokens are transferred first and the hook callback is best-effort (failure does not revert).
-
-### 6.9 `JB721TiersHookLib` — Try-Catch on All External Calls
-
-All external calls during split distribution (split hooks, terminal `pay`, terminal `addToBalanceOf`, and leftover `addToBalanceOf`) are wrapped in try-catch. On failure: the failed amount is accumulated separately and routed to the project balance after the distribution loop, ensuring proportional (not equal) redistribution among remaining recipients. Native token calls return false (funds stay in the hook), ERC-20 terminal call approvals are reset to zero, and `SplitPayoutReverted` or `AddToBalanceReverted` events are emitted with the revert reason.
-
-### 6.10 `JB721TiersHookLib.calculateSplitAmounts` — Discount Applied Before Splits
-
-Split amounts are calculated on the discount-adjusted (effective) tier price rather than the base price. This ensures the split amount matches the actual price the minter pays when a tier discount is active.
-
-### 6.11 `JB721TiersHookStore.recordAddTiers` — Validates `splitPercent`
-
-`recordAddTiers` now reverts with `JB721TiersHookStore_SplitPercentExceedsBounds` if a tier's `splitPercent` exceeds `JBConstants.SPLITS_TOTAL_PERCENT`.
-
-### 6.12 `JB721TiersHookStore.recordAddTiers` — Stores `splitPercent`
-
-The store now stores `splitPercent` in the `JBStored721Tier` packed struct (replacing the `votingUnits` field in storage). The `votingUnits` value continues to be stored in the `_tierVotingUnitsOf` mapping.
-
-### 6.13 `JB721TiersHookStore.recordAddTiers` — Emits `SetDefaultReserveBeneficiary`
-
-When a tier config has `useReserveBeneficiaryAsDefault` set and the beneficiary differs from the current default, v6 emits the new `SetDefaultReserveBeneficiary` event.
-
-### 6.14 `JB721TiersHookProjectDeployer` — `allowSetCustomToken` Pass-Through
-
-In v5, the project deployer hardcoded `allowSetCustomToken: false` when constructing `JBRulesetMetadata`. In v6, it passes through `payDataRulesetConfig.metadata.allowSetCustomToken`.
-
----
-
-## 7. Migration Table
-
-### 7.1 Interfaces
-
-| v5 | v6 | Notes |
-|----|----|-------|
-| `IJB721Hook` | `IJB721Hook` | Unchanged (import path updated) |
-| `IJB721TiersHook` | `IJB721TiersHook` | `pricingContext()` return changed; `setMetadata()` signature changed; added `PRICES()`, `SPLITS()`, `SetName`, `SetSymbol`, `SplitPayoutReverted`, `AddToBalanceReverted` |
-| `IJB721TiersHookDeployer` | `IJB721TiersHookDeployer` | Unchanged |
-| `IJB721TiersHookProjectDeployer` | `IJB721TiersHookProjectDeployer` | Unchanged |
-| `IJB721TiersHookStore` | `IJB721TiersHookStore` | Added `SetDefaultReserveBeneficiary` event; NatSpec added |
-| `IJB721TokenUriResolver` | `IJB721TokenUriResolver` | Unchanged |
-
-### 7.2 Contracts
-
-| v5 | v6 | Notes |
-|----|----|-------|
-| `JB721TiersHook` | `JB721TiersHook` | Constructor gains `prices` and `splits`; tier splits system; code extracted to library |
-| `JB721TiersHookDeployer` | `JB721TiersHookDeployer` | Unchanged (import paths updated) |
-| `JB721TiersHookProjectDeployer` | `JB721TiersHookProjectDeployer` | `allowSetCustomToken` pass-through |
-| `JB721TiersHookStore` | `JB721TiersHookStore` | `splitPercent` storage and validation; error params added; `SplitPercentExceedsBounds` error; `SetDefaultReserveBeneficiary` event |
-| `JB721Hook` (abstract) | `JB721Hook` (abstract) | `cashOutWeightOf`/`totalCashOutWeight` signatures simplified; `msg.value` check removed from `afterPayRecordedWith` |
-| `ERC721` (abstract) | `ERC721` (abstract) | Added `_setName()` and `_setSymbol()` |
-
-### 7.3 Libraries
-
-| v5 | v6 | Notes |
-|----|----|-------|
-| `JB721Constants` | `JB721Constants` | `MAX_DISCOUNT_PERCENT` renamed to `DISCOUNT_DENOMINATOR` |
-| `JB721TiersRulesetMetadataResolver` | `JB721TiersRulesetMetadataResolver` | Unchanged |
-| `JBBitmap` | `JBBitmap` | Unchanged |
-| `JBIpfsDecoder` | `JBIpfsDecoder` | Unchanged |
-| _(not present)_ | `JB721TiersHookLib` | New library for tier splits, payment normalization, weight calculation, and token URI resolution |
-
-### 7.4 Structs
-
-| v5 | v6 | Notes |
-|----|----|-------|
-| `JB721Tier` | `JB721Tier` | Added `splitPercent` field |
-| `JB721TierConfig` | `JB721TierConfig` | Added `splitPercent` and `splits` fields |
-| `JB721TiersHookFlags` | `JB721TiersHookFlags` | Added `issueTokensForSplits` field |
-| `JB721InitTiersConfig` | `JB721InitTiersConfig` | Removed `prices` field |
-| `JBStored721Tier` | `JBStored721Tier` | `votingUnits` replaced by `splitPercent` |
-| `JBPayDataHookRulesetMetadata` | `JBPayDataHookRulesetMetadata` | Added `allowSetCustomToken` field |
-| `JB721TiersMintReservesConfig` | `JB721TiersMintReservesConfig` | Unchanged |
-| `JB721TiersSetDiscountPercentConfig` | `JB721TiersSetDiscountPercentConfig` | Unchanged |
-| `JB721TiersRulesetMetadata` | `JB721TiersRulesetMetadata` | Unchanged |
-| `JBBitmapWord` | `JBBitmapWord` | Unchanged |
-| `JBDeploy721TiersHookConfig` | `JBDeploy721TiersHookConfig` | Unchanged |
-| `JBLaunchProjectConfig` | `JBLaunchProjectConfig` | Unchanged |
-| `JBLaunchRulesetsConfig` | `JBLaunchRulesetsConfig` | Unchanged |
-| `JBQueueRulesetsConfig` | `JBQueueRulesetsConfig` | Unchanged |
-| `JBPayDataHookRulesetConfig` | `JBPayDataHookRulesetConfig` | Unchanged |