@croptop/core-v6 0.0.31 → 0.0.32

package/README.md

@@ -90,4 +90,6 @@ script/
 - fee routing depends on the designated fee project remaining correctly configured; if its terminal rejects payments,
   Croptop refunds the fee to `_msgSender()` instead of trapping ETH in `CTPublisher`
 - burn-lock ownership is intentionally irreversible and should only be used when immutability is desired
+- after burn-locking into `CTProjectOwner`, the previous owner no longer holds the project NFT directly; control is
+  intentionally mediated through Croptop's owner helper and hook-admin surface instead of remaining a plain owner EOA
 - duplicate-content and stale-tier edge cases are guarded by tests, but integrations should still treat metadata reuse carefully

package/USER_JOURNEYS.md

@@ -52,6 +52,17 @@
 2. Restrict future edits to the paths Croptop intentionally exposes.
 3. Accept that this is a product-shaping choice, not a cosmetic deployment detail.
 
+## Journey 5: Support Cross-Chain Payments Through Data Hooks
+
+**Starting state:** a sucker pays the Croptop project on behalf of a remote user via `payRemote`, and `CTDeployer.beforePayRecordedWith` needs to forward the correct beneficiary to downstream hooks.
+
+**Success:** downstream data hooks see the real remote user so any hook-specific accounting accrues to the right person.
+
+**Flow**
+1. The sucker calls `terminal.pay()` with relay-beneficiary metadata.
+2. `CTDeployer.beforePayRecordedWith()` resolves the relay beneficiary when the payer is a registered sucker.
+3. The swapped beneficiary is forwarded to the downstream data hook.
+
 ## Hand-Offs
 
 - Use [nana-721-hook-v6](../nana-721-hook-v6/USER_JOURNEYS.md) for the underlying tier issuance behavior Croptop wraps.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@croptop/core-v6",
-    "version": "0.0.31",
+    "version": "0.0.32",
     "license": "MIT",
     "repository": {
         "type": "git",
@@ -16,18 +16,18 @@
         "artifacts": "source ./.env && npx sphinx artifacts --org-id 'ea165b21-7cdc-4d7b-be59-ecdd4c26bee4' --project-name 'croptop-core-v5'"
     },
     "dependencies": {
-        "@bananapus/721-hook-v6": "^0.0.32",
-        "@bananapus/buyback-hook-v6": "^0.0.26",
-        "@bananapus/core-v6": "^0.0.32",
+        "@bananapus/721-hook-v6": "^0.0.33",
+        "@bananapus/buyback-hook-v6": "^0.0.27",
+        "@bananapus/core-v6": "^0.0.34",
         "@bananapus/ownable-v6": "^0.0.17",
-        "@bananapus/permission-ids-v6": "^0.0.15",
+        "@bananapus/permission-ids-v6": "^0.0.17",
         "@bananapus/router-terminal-v6": "^0.0.26",
-        "@bananapus/suckers-v6": "^0.0.22",
+        "@bananapus/suckers-v6": "^0.0.25",
         "@openzeppelin/contracts": "^5.6.1"
     },
     "devDependencies": {
         "@bananapus/address-registry-v6": "^0.0.17",
-        "@rev-net/core-v6": "^0.0.28",
+        "@rev-net/core-v6": "^0.0.30",
         "@sphinx-labs/plugins": "^0.33.3"
     }
-}
+}

package/src/CTDeployer.sol

@@ -28,6 +28,7 @@ import {JBRulesetConfig} from "@bananapus/core-v6/src/structs/JBRulesetConfig.so
 import {JBOwnable} from "@bananapus/ownable-v6/src/JBOwnable.sol";
 import {JBPermissionIds} from "@bananapus/permission-ids-v6/src/JBPermissionIds.sol";
 import {IJBSuckerRegistry} from "@bananapus/suckers-v6/src/interfaces/IJBSuckerRegistry.sol";
+import {JBRelayBeneficiary} from "@bananapus/suckers-v6/src/libraries/JBRelayBeneficiary.sol";
 
 import {ICTDeployer} from "./interfaces/ICTDeployer.sol";
 import {ICTPublisher} from "./interfaces/ICTPublisher.sol";
@@ -172,6 +173,24 @@ contract CTDeployer is ERC2771Context, JBPermissioned, IJBRulesetDataHook, IERC7
         if (address(hook) == address(0)) {
             return (context.weight, hookSpecifications);
         }
+
+        // Resolve the relay beneficiary — if the payer is a sucker with relay metadata,
+        // swap the beneficiary so downstream hooks see the real user.
+        address effectiveBeneficiary = JBRelayBeneficiary.resolve({
+            payer: context.payer,
+            beneficiary: context.beneficiary,
+            projectId: context.projectId,
+            metadata: context.metadata,
+            registry: SUCKER_REGISTRY
+        });
+
+        // If the beneficiary was swapped, create a memory copy with the new beneficiary.
+        if (effectiveBeneficiary != context.beneficiary) {
+            JBBeforePayRecordedContext memory hookContext = context;
+            hookContext.beneficiary = effectiveBeneficiary;
+            return hook.beforePayRecordedWith(hookContext);
+        }
+
         // slither-disable-next-line unused-return
         return hook.beforePayRecordedWith(context);
     }