@bananapus/721-hook-v6 0.0.77 → 1.0.1

package/README.md

@@ -63,7 +63,14 @@ If a bug affects supply, reserve minting, or tier lookup, it usually lives in th
 - this hook participates in treasury-facing execution, not only metadata
 - custom token URI resolvers should be treated as part of the trusted surface
 - adding a 721 hook through a deployer is easy; carrying the right ruleset behavior forward is where mistakes happen
+- `JB721TiersHookProjectDeployer` forwards the creation fee on a project launch and advertises the resolved fee payer
+  via `IJBPayerTracker.originalPayer`, so a `pay`-routing fee receiver credits the launching user rather than the
+  deployer. The deployer reads the payer from `_msgSender()` (ERC-2771), so a trusted forwarder still attributes the fee
+  to the relayed user.
 - projects should be explicit about whether the hook affects pay, cash out, or only metadata-facing paths
+- reserve beneficiary defaults are mutable hook state, so operators should not rely on later same-batch updates when
+  computing who receives reserve NFTs
+- future token-URI resolver slots are metadata authority; treat resolver changes like collection-facing admin actions
 - per-tier owner-tracked voting units are queryable via `getPastTierVotingUnits(tierId, blockNumber)`: mints, transfers, and burns write ownership history, so the trace follows owned units regardless of delegation
 - active delegated vote totals are queryable globally via `getPastTotalActiveVotes(blockNumber)` / `getTotalActiveVotes()` and per tier via `getPastTotalTierActiveVotes(tierId, blockNumber)` / `getTotalTierActiveVotes(tierId)`. These totals include only voting units held by accounts with a nonzero delegate, so a token in undelegated custody does not count and returned tokens become active again if the holder's delegation is still set.
 - per-account active tier voting units are queryable via `getPastAccountTierActiveVotes(account, tierId, blockNumber)`. This follows the account holding the tier units, not the delegate receiving voting power, so reward distributors can cap tier-scoped claims against the holder's active units even when votes are delegated to another address.
@@ -139,6 +146,8 @@ script/
 - custom token URI resolvers are part of the security surface
 - projects need to be deliberate about whether the hook participates in pay, cash out, or both paths
 - tier mutations after launch are powerful and should be permissioned carefully
+- distributors and curated drops that depend on historical 721 ownership should pre-warm checkpoints before relying on
+  snapshot-based eligibility
 
 When people say "the 721 hook," they often mean three different things: the hook contract, the store, and the metadata resolver plugged into it.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bananapus/721-hook-v6",
-  "version": "0.0.77",
+  "version": "1.0.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -25,10 +25,10 @@
     "artifacts": "source ./.env && npx sphinx artifacts --org-id 'ea165b21-7cdc-4d7b-be59-ecdd4c26bee4' --project-name 'nana-721-hook-v6'"
   },
   "dependencies": {
-    "@bananapus/address-registry-v6": "^0.0.36",
-    "@bananapus/core-v6": "^0.0.87",
-    "@bananapus/ownable-v6": "^0.0.40",
-    "@bananapus/permission-ids-v6": "^0.0.32",
+    "@bananapus/address-registry-v6": "^1.0.0",
+    "@bananapus/core-v6": "^1.0.2",
+    "@bananapus/ownable-v6": "^1.0.0",
+    "@bananapus/permission-ids-v6": "^1.0.0",
     "@openzeppelin/contracts": "5.6.1",
     "@prb/math": "4.1.2",
     "solady": "0.1.26"

package/src/JB721TiersHookProjectDeployer.sol

@@ -4,8 +4,10 @@ pragma solidity 0.8.28;
 import {JBPermissioned} from "@bananapus/core-v6/src/abstract/JBPermissioned.sol";
 import {IJBController} from "@bananapus/core-v6/src/interfaces/IJBController.sol";
 import {IJBDirectory} from "@bananapus/core-v6/src/interfaces/IJBDirectory.sol";
+import {IJBPayerTracker} from "@bananapus/core-v6/src/interfaces/IJBPayerTracker.sol";
 import {IJBPermissions} from "@bananapus/core-v6/src/interfaces/IJBPermissions.sol";
 import {IJBProjects} from "@bananapus/core-v6/src/interfaces/IJBProjects.sol";
+import {JBPayerTrackerLib} from "@bananapus/core-v6/src/libraries/JBPayerTrackerLib.sol";
 import {JBRulesetConfig} from "@bananapus/core-v6/src/structs/JBRulesetConfig.sol";
 import {JBRulesetMetadata} from "@bananapus/core-v6/src/structs/JBRulesetMetadata.sol";
 import {JBOwnable} from "@bananapus/ownable-v6/src/JBOwnable.sol";
@@ -31,6 +33,7 @@ contract JB721TiersHookProjectDeployer is
     ERC2771Context,
     JBPermissioned,
     IERC721Receiver,
+    IJBPayerTracker,
     IJB721TiersHookProjectDeployer
 {
     //*********************************************************************//
@@ -43,6 +46,16 @@ contract JB721TiersHookProjectDeployer is
     /// @notice The deployer contract used to create new 721 tiers hook instances via clone.
     IJB721TiersHookDeployer public immutable override HOOK_DEPLOYER;
 
+    //*********************************************************************//
+    // ------------------- public transient properties ------------------- //
+    //*********************************************************************//
+
+    /// @notice The account that paid the creation fee for the project currently being launched.
+    /// @dev Set to the resolved fee payer (this contract's caller, or that caller's upstream payer when the caller is
+    /// itself an `IJBPayerTracker`) while `JBProjects.createFor` runs, so `JBProjects` attributes the fee to the true
+    /// payer. Cleared back to `address(0)` once the call returns.
+    address public transient override originalPayer;
+
     //*********************************************************************//
     // -------------------------- constructor ---------------------------- //
     //*********************************************************************//
@@ -92,8 +105,15 @@ contract JB721TiersHookProjectDeployer is
     {
         // Reserve the project ID up front so permissionless project creations cannot invalidate hook deployment.
         IJBProjects projects = DIRECTORY.PROJECTS();
+
+        // Expose the resolved fee payer so `JBProjects` attributes the creation fee to the true payer, not this
+        // contract. Cleared immediately after.
+        originalPayer = JBPayerTrackerLib.resolve(_msgSender());
+
         projectId = projects.createFor{value: msg.value}(address(this));
 
+        originalPayer = address(0);
+
         // Deploy the hook.
         hook = HOOK_DEPLOYER.deployHookFor({
             projectId: projectId,