@bananapus/core-v6 0.0.24 → 0.0.25

package/SKILLS.md

@@ -46,7 +46,7 @@ The core Juicebox V6 protocol on EVM: a modular system for launching treasury-ba
 | `setUriOf(uint256 projectId, string uri)` | Sets the project's metadata URI. |
 | `transferCreditsFrom(address holder, uint256 projectId, address recipient, uint256 creditCount)` | Transfers credits between addresses (reverts if `pauseCreditTransfers` is set in ruleset). |
 | `addPriceFeedFor(uint256 projectId, uint256 pricingCurrency, uint256 unitCurrency, IJBPriceFeed feed)` | Registers a price feed (requires `allowAddPriceFeed` in ruleset). |
-| `migrateController(uint256 projectId, IJBMigratable to)` | Migrates the project to a new controller. Calls `beforeReceiveMigrationFrom`, `migrate`, updates directory, then `afterReceiveMigrationFrom`. |
+| `migrate(uint256 projectId, IERC165 to)` | Migrates the project to a new controller. Calls `beforeReceiveMigrationFrom`, `migrate`, updates directory, then `afterReceiveMigrationFrom`. |
 | `currentRulesetOf(uint256 projectId)` | Returns the current ruleset and unpacked metadata. |
 | `upcomingRulesetOf(uint256 projectId)` | Returns the upcoming ruleset and unpacked metadata. |
 | `allRulesetsOf(uint256 projectId, uint256 startingId, uint256 size)` | Returns an array of rulesets with metadata, paginated. |
@@ -59,7 +59,7 @@ The core Juicebox V6 protocol on EVM: a modular system for launching treasury-ba
 | Function | What it does |
 |----------|--------------|
 | `pay(uint256 projectId, address token, uint256 amount, address beneficiary, uint256 minReturnedTokens, string memo, bytes metadata)` | Pays a project. Mints project tokens to beneficiary based on ruleset weight. Returns token count. |
-| `cashOutTokensOf(address holder, uint256 projectId, uint256 cashOutCount, address tokenToReclaim, uint256 minTokensReclaimed, address beneficiary, bytes metadata)` | Burns project tokens and reclaims surplus terminal tokens via bonding curve. |
+| `cashOutTokensOf(address holder, uint256 projectId, uint256 cashOutCount, address tokenToReclaim, uint256 minTokensReclaimed, address payable beneficiary, bytes metadata)` | Burns project tokens and reclaims surplus terminal tokens via bonding curve. |
 | `sendPayoutsOf(uint256 projectId, address token, uint256 amount, uint256 currency, uint256 minTokensPaidOut)` | Distributes payouts from the project's balance to its payout split group, up to the payout limit. |
 | `useAllowanceOf(uint256 projectId, address token, uint256 amount, uint256 currency, uint256 minTokensPaidOut, address payable beneficiary, address payable feeBeneficiary, string memo)` | Withdraws from the project's surplus allowance to a beneficiary. The `feeBeneficiary` receives tokens minted by the fee payment. |
 | `addToBalanceOf(uint256 projectId, address token, uint256 amount, bool shouldReturnHeldFees, string memo, bytes metadata)` | Adds funds to a project's balance without minting tokens. Can unlock held fees. |
@@ -70,7 +70,7 @@ The core Juicebox V6 protocol on EVM: a modular system for launching treasury-ba
 | `accountingContextForTokenOf(uint256 projectId, address token)` | Returns the accounting context for a specific token. |
 | `accountingContextsOf(uint256 projectId)` | Returns all accounting contexts for a project. |
 | `previewPayFor(uint256 projectId, address token, uint256 amount, address beneficiary, bytes metadata)` | Simulates a full payment including the reserved/beneficiary token split. Returns `(ruleset, beneficiaryTokenCount, reservedTokenCount, hookSpecifications)`. Composes `STORE.previewPayFrom` + `controller.previewMintOf`. |
-| `previewCashOutFrom(address holder, uint256 projectId, uint256 cashOutCount, address tokenToReclaim, address beneficiary, bytes metadata)` | Simulates a full cash out including bonding curve and data hook effects. Returns `(ruleset, reclaimAmount, cashOutTaxRate, hookSpecifications)`. Delegates to `STORE.previewCashOutFrom`. |
+| `previewCashOutFrom(address holder, uint256 projectId, uint256 cashOutCount, address tokenToReclaim, address payable beneficiary, bytes metadata)` | Simulates a full cash out including bonding curve and data hook effects. Returns `(ruleset, reclaimAmount, cashOutTaxRate, hookSpecifications)`. Delegates to `STORE.previewCashOutFrom`. |
 | `heldFeesOf(uint256 projectId, address token, uint256 count)` | Returns up to `count` held fees for a project/token. |
 
 ### JBTerminalStore
@@ -78,9 +78,9 @@ The core Juicebox V6 protocol on EVM: a modular system for launching treasury-ba
 | Function | What it does |
 |----------|--------------|
 | `recordPaymentFrom(address payer, JBTokenAmount amount, uint256 projectId, address beneficiary, bytes metadata)` | Records a payment. Applies data hook if enabled. Returns ruleset, token count, hook specifications. |
-| `recordPayoutFor(uint256 projectId, JBAccountingContext accountingContext, uint256 amount, uint256 currency)` | Records a payout. Enforces payout limits. Returns ruleset and amount paid out. |
-| `recordCashOutFor(address holder, uint256 projectId, uint256 cashOutCount, JBAccountingContext accountingContext, JBAccountingContext[] balanceAccountingContexts, bool beneficiaryIsFeeless, bytes metadata)` | Records a cash out. Computes reclaim via bonding curve. Returns ruleset, reclaim amount, tax rate, and hook specifications. |
-| `recordUsedAllowanceOf(uint256 projectId, JBAccountingContext accountingContext, uint256 amount, uint256 currency)` | Records surplus allowance usage. Enforces allowance limits. Returns ruleset and used amount. |
+| `recordPayoutFor(uint256 projectId, address token, uint256 amount, uint256 currency)` | Records a payout. Enforces payout limits. Returns ruleset and amount paid out. |
+| `recordCashOutFor(address holder, uint256 projectId, uint256 cashOutCount, address tokenToReclaim, bool beneficiaryIsFeeless, bytes metadata)` | Records a cash out. Computes reclaim via bonding curve. Returns ruleset, reclaim amount, tax rate, and hook specifications. |
+| `recordUsedAllowanceOf(uint256 projectId, address token, uint256 amount, uint256 currency)` | Records surplus allowance usage. Enforces allowance limits. Returns ruleset and used amount. |
 | `recordAddedBalanceFor(uint256 projectId, address token, uint256 amount)` | Records funds added to a project's balance. |
 | `recordTerminalMigration(uint256 projectId, address token)` | Records a terminal migration, returning the full balance. |
 | `balanceOf(address terminal, uint256 projectId, address token)` | Returns the balance of a project at a terminal for a given token. |
@@ -101,7 +101,7 @@ The core Juicebox V6 protocol on EVM: a modular system for launching treasury-ba
 | `currentOf(uint256 projectId)` | Returns the currently active ruleset with decayed weight and correct cycle number. |
 | `latestQueuedOf(uint256 projectId)` | Returns the latest queued ruleset and its approval status. |
 | `queueFor(uint256 projectId, uint256 duration, uint256 weight, uint256 weightCutPercent, IJBRulesetApprovalHook approvalHook, uint256 metadata, uint256 mustStartAtOrAfter)` | Queues a new ruleset. Only callable by the project's controller. |
-| `updateRulesetWeightCache(uint256 projectId)` | Updates the weight cache for long-running rulesets. Required when `weightCutMultiple > 20,000` to avoid gas limits. |
+| `updateRulesetWeightCache(uint256 projectId, uint256 rulesetId)` | Updates the weight cache for long-running rulesets. Required when `weightCutMultiple > 20,000` to avoid gas limits. |
 
 ### JBPermissions
 
@@ -186,8 +186,8 @@ The core Juicebox V6 protocol on EVM: a modular system for launching treasury-ba
 | `JBBeforeCashOutRecordedContext` | `terminal`, `holder`, `projectId`, `rulesetId`, `cashOutCount`, `totalSupply`, `surplus (JBTokenAmount)`, `useTotalSurplus`, `cashOutTaxRate`, `beneficiaryIsFeeless`, `metadata` | `IJBRulesetDataHook.beforeCashOutRecordedWith()` input |
 | `JBAfterPayRecordedContext` | `payer`, `projectId`, `rulesetId`, `amount (JBTokenAmount)`, `forwardedAmount (JBTokenAmount)`, `weight`, `newlyIssuedTokenCount`, `beneficiary`, `hookMetadata`, `payerMetadata` | `IJBPayHook.afterPayRecordedWith()` input |
 | `JBAfterCashOutRecordedContext` | `holder`, `projectId`, `rulesetId`, `cashOutCount`, `reclaimedAmount (JBTokenAmount)`, `forwardedAmount (JBTokenAmount)`, `cashOutTaxRate`, `beneficiary`, `hookMetadata`, `cashOutMetadata` | `IJBCashOutHook.afterCashOutRecordedWith()` input |
-| `JBPayHookSpecification` | `hook (IJBPayHook)`, `amount`, `metadata` | Returned by data hook; specifies which pay hooks to call and how much to forward |
-| `JBCashOutHookSpecification` | `hook (IJBCashOutHook)`, `amount`, `metadata` | Returned by data hook; specifies which cash out hooks to call and how much to forward |
+| `JBPayHookSpecification` | `hook (IJBPayHook)`, `noop (bool)`, `amount`, `metadata` | Returned by data hook; specifies which pay hooks to call and how much to forward. `noop = true` means informational-only (callback skipped, amount must be 0). |
+| `JBCashOutHookSpecification` | `hook (IJBCashOutHook)`, `noop (bool)`, `amount`, `metadata` | Returned by data hook; specifies which cash out hooks to call and how much to forward. `noop = true` means informational-only (callback skipped, amount must be 0). |
 | `JBSplitHookContext` | `token`, `amount`, `decimals`, `projectId`, `groupId`, `split (JBSplit)` | `IJBSplitHook.processSplitWith()` input |
 
 ### Constants (`JBConstants`)
@@ -244,7 +244,7 @@ The core Juicebox V6 protocol on EVM: a modular system for launching treasury-ba
 - `JBERC20` is cloned via `Clones.clone()` -- its constructor sets invalid name/symbol; real values set in `initialize()`
 - Fee is 2.5% (`FEE = 25` out of `MAX_FEE = 1000`)
 - Project #1 is the fee beneficiary project (receives all protocol fees)
-- **Fee-free cashout exemption is scoped to fee-free intra-terminal payout amounts.** `_feeFreeSurplusOf[projectId][token]` accumulates the value of fee-free payouts. During cashout with `cashOutTaxRate=0`, the 2.5% fee applies only up to this surplus, then depletes. Once consumed, subsequent cashouts are fee-free again. This prevents a round-trip fee bypass (intra-terminal payout → zero-tax cashout) while scoping fees precisely to the fee-free inflow.
+- **Fee-free cashout exemption is scoped to fee-free intra-terminal payout amounts.** `_feeFreeSurplusOf[projectId][token]` accumulates the value of fee-free payouts. After any outflow (payouts, `useAllowanceOf`, non-zero-tax or feeless cashouts), the counter is capped at the remaining balance — non-fee-free funds leave first, preserving the fee-free counter. During cashout with `cashOutTaxRate=0`, the 2.5% fee applies only up to this surplus, then depletes. Once consumed, subsequent cashouts are fee-free again. Cleared on terminal migration. This prevents a round-trip fee bypass (intra-terminal payout → zero-tax cashout) while scoping fees precisely to the fee-free inflow.
 - `JBProjects` constructor optionally mints project #1 to `feeProjectOwner` -- if `address(0)`, no fee project is created
 - `JBMultiTerminal` derives `DIRECTORY` from the provided `store` in its constructor -- not passed directly
 - `JBPrices.pricePerUnitOf()` checks project-specific feed, then inverse, then falls back to `DEFAULT_PROJECT_ID = 0`
@@ -265,12 +265,159 @@ The core Juicebox V6 protocol on EVM: a modular system for launching treasury-ba
 - **`JBAccountingContext.currency` is NOT `baseCurrency` — by design.** `baseCurrency` in ruleset metadata uses abstract real-world values (1 = ETH, 2 = USD) so rulesets are portable across chains — `baseCurrency=2` means "issue X tokens per USD" whether on Ethereum, Base, or Arbitrum. `JBAccountingContext.currency` uses token-derived values (`uint32(uint160(tokenAddress))`) because terminals track specific tokens at specific addresses — e.g. NATIVE_TOKEN = 61166, USDC on Ethereum = 909516616, USDC on Base = 3169378579. `JBPrices` mediates between the two: it converts token-derived currencies to/from abstract currencies (e.g. USDC token → USD concept, NATIVE_TOKEN → ETH concept) so that payout limits denominated in USD work correctly regardless of which token the terminal holds. The separation is what makes cross-chain consistency possible: same ruleset, different terminal accounting per chain.
 - **Don't queue multiple identical rulesets.** A ruleset with a `duration` automatically cycles — no need to queue copies. Queue multiple rulesets only when configuration actually changes between periods (e.g. different weight, splits, or limits).
 - **`NATIVE_TOKEN` represents a different token on each chain.** `NATIVE_TOKEN` (`0x000000000000000000000000000000000000EEEe`) is the token received via `msg.value` — ETH on Ethereum/Base/Optimism/Arbitrum, CELO on Celo, etc. Its currency is `uint32(uint160(NATIVE_TOKEN))` = 61166. A `JBMatchingPriceFeed` (returns 1:1) is deployed for `ETH:NATIVE_TOKEN` on ETH-native chains so that `baseCurrency=ETH` resolves correctly to the native token. On non-ETH-native chains, a different price feed would be needed.
+- **Noop hook specifications are informational-only.** `noop = true` + `amount != 0` reverts with `JBTerminalStore_NoopHookSpecHasAmount`. Data hooks use noop specs to return diagnostics to preview clients without triggering a hook callback. The `noop` flag only suppresses the callback — parameter overrides (weight, tax rate, supply) from the data hook still apply.
+
+## Permission IDs
+
+Quick-reference for the most common `JBPermissionIds` values (from `@bananapus/permission-ids-v6`). Pass these to `JBPermissions.setPermissionsFor()`.
+
+| ID | Name | Gates |
+|----|------|-------|
+| `1` | `ROOT` | All permissions for the scoped project. Cannot be combined with `projectId = 0`. |
+| `2` | `QUEUE_RULESETS` | `JBController.queueRulesetsOf` |
+| `3` | `LAUNCH_RULESETS` | `JBController.launchRulesetsFor` |
+| `4` | `CASH_OUT_TOKENS` | `JBMultiTerminal.cashOutTokensOf` |
+| `5` | `SEND_PAYOUTS` | `JBMultiTerminal.sendPayoutsOf` |
+| `6` | `MIGRATE_TERMINAL` | `JBMultiTerminal.migrateBalanceOf` |
+| `7` | `SET_PROJECT_URI` | `JBController.setUriOf` |
+| `8` | `DEPLOY_ERC20` | `JBController.deployERC20For` |
+| `9` | `SET_TOKEN` | `JBController.setTokenFor` |
+| `10` | `MINT_TOKENS` | `JBController.mintTokensOf` |
+| `11` | `BURN_TOKENS` | `JBController.burnTokensOf` |
+| `12` | `CLAIM_TOKENS` | `JBController.claimTokensFor` |
+| `13` | `TRANSFER_CREDITS` | `JBController.transferCreditsFrom` |
+| `14` | `SET_CONTROLLER` | `JBDirectory.setControllerOf` |
+| `15` | `SET_TERMINALS` | `JBDirectory.setTerminalsOf` (can remove primary terminal) |
+| `16` | `SET_PRIMARY_TERMINAL` | `JBDirectory.setPrimaryTerminalOf` |
+| `17` | `USE_ALLOWANCE` | `JBMultiTerminal.useAllowanceOf` |
+| `18` | `SET_SPLIT_GROUPS` | `JBController.setSplitGroupsOf` |
+| `19` | `ADD_PRICE_FEED` | `JBController.addPriceFeedFor` |
+| `20` | `ADD_ACCOUNTING_CONTEXTS` | `JBMultiTerminal.addAccountingContextsFor` |
+| `21` | `SET_TOKEN_METADATA` | `JBController.setTokenMetadataOf` |
+
+IDs 22-33 are used by extension contracts (721 hook, buyback hook, router terminal, suckers).
+
+## Common Errors
+
+Errors an agent is most likely to encounter. All are custom errors (revert with selector).
+
+| Error | Contract | When |
+|-------|----------|------|
+| `JBPermissioned_Unauthorized` | `JBPermissioned` | Caller lacks the required permission ID for the project. |
+| `JBController_RulesetsArrayEmpty` | `JBController` | `launchProjectFor` / `queueRulesetsOf` called with empty rulesets array. |
+| `JBController_RulesetsAlreadyLaunched` | `JBController` | `launchRulesetsFor` called on a project that already has rulesets. |
+| `JBController_MintNotAllowedAndNotTerminalOrHook` | `JBController` | `mintTokensOf` called but `allowOwnerMinting` is false and caller is not a terminal/hook. |
+| `JBController_ZeroTokensToMint` | `JBController` | `mintTokensOf` called with `tokenCount = 0`. |
+| `JBController_ZeroTokensToBurn` | `JBController` | `burnTokensOf` called with `tokenCount = 0`. |
+| `JBController_NoReservedTokens` | `JBController` | `sendReservedTokensToSplitsOf` called but no pending reserved tokens. |
+| `JBController_CreditTransfersPaused` | `JBController` | `transferCreditsFrom` called but `pauseCreditTransfers` is set in ruleset. |
+| `JBController_RulesetSetTokenNotAllowed` | `JBController` | `setTokenFor` called but `allowSetCustomToken` is false in ruleset. |
+| `JBController_AddingPriceFeedNotAllowed` | `JBController` | `addPriceFeedFor` called but `allowAddPriceFeed` is false in ruleset. |
+| `JBController_InvalidReservedPercent` | `JBController` | `reservedPercent` exceeds `MAX_RESERVED_PERCENT` (10,000). |
+| `JBController_InvalidCashOutTaxRate` | `JBController` | `cashOutTaxRate` exceeds `MAX_CASH_OUT_TAX_RATE` (10,000). |
+| `JBMultiTerminal_UnderMinReturnedTokens` | `JBMultiTerminal` | Payment minted fewer tokens than `minReturnedTokens`. |
+| `JBMultiTerminal_UnderMinTokensReclaimed` | `JBMultiTerminal` | Cash out reclaimed less than `minTokensReclaimed`. |
+| `JBMultiTerminal_UnderMinTokensPaidOut` | `JBMultiTerminal` | Payout distributed less than `minTokensPaidOut`. |
+| `JBMultiTerminal_TokenNotAccepted` | `JBMultiTerminal` | Token has no accounting context for the project in this terminal. |
+| `JBMultiTerminal_NoMsgValueAllowed` | `JBMultiTerminal` | `msg.value > 0` sent with an ERC-20 payment (not `NATIVE_TOKEN`). |
+| `JBMultiTerminal_PermitAllowanceNotEnough` | `JBMultiTerminal` | Permit2 allowance insufficient for the payment amount. |
+| `JBTerminalStore_RulesetPaymentPaused` | `JBTerminalStore` | `pausePay` is set in the current ruleset. |
+| `JBTerminalStore_RulesetNotFound` | `JBTerminalStore` | No ruleset exists for the project (not launched). |
+| `JBTerminalStore_InadequateControllerPayoutLimit` | `JBTerminalStore` | `sendPayoutsOf` amount exceeds the payout limit for this cycle. |
+| `JBTerminalStore_InadequateControllerAllowance` | `JBTerminalStore` | `useAllowanceOf` amount exceeds the surplus allowance. |
+| `JBTerminalStore_InadequateTerminalStoreBalance` | `JBTerminalStore` | Withdrawal exceeds the terminal's recorded balance. |
+| `JBTerminalStore_InsufficientTokens` | `JBTerminalStore` | Cash out count exceeds the holder's token balance. |
+| `JBTerminalStore_TerminalMigrationNotAllowed` | `JBTerminalStore` | `migrateBalanceOf` called but `allowTerminalMigration` is false. |
+| `JBTerminalStore_NoopHookSpecHasAmount` | `JBTerminalStore` | Data hook returned a noop spec with `amount != 0`. |
+| `JBTerminalStore_AccountingContextAlreadySet` | `JBTerminalStore` | Accounting context already exists for that token. |
+| `JBDirectory_SetControllerNotAllowed` | `JBDirectory` | Controller change not allowed by the current ruleset. |
+| `JBDirectory_SetTerminalsNotAllowed` | `JBDirectory` | Terminal change not allowed by the current ruleset. |
+| `JBDirectory_DuplicateTerminals` | `JBDirectory` | Duplicate terminal in the terminals array. |
+| `JBTokens_ProjectAlreadyHasToken` | `JBTokens` | `deployERC20For` / `setTokenFor` called but project already has an ERC-20. |
+| `JBTokens_InsufficientCredits` | `JBTokens` | `claimTokensFor` count exceeds credit balance. |
+| `JBTokens_TokensMustHave18Decimals` | `JBTokens` | Custom token does not use 18 decimals. |
+| `JBSplits_TotalPercentExceeds100` | `JBSplits` | Split percentages sum exceeds `SPLITS_TOTAL_PERCENT`. |
+| `JBPrices_PriceFeedAlreadyExists` | `JBPrices` | Feed already set for that currency pair (immutable). |
+| `JBPrices_PriceFeedNotFound` | `JBPrices` | No feed found for the requested currency pair. |
+| `JBPermissions_CantSetRootPermissionForWildcardProject` | `JBPermissions` | Tried to grant ROOT with `projectId = 0` (wildcard). |
+| `JBRulesets_InvalidWeight` | `JBRulesets` | Weight exceeds `uint112.max`. |
+| `JBRulesets_InvalidWeightCutPercent` | `JBRulesets` | `weightCutPercent` exceeds `MAX_WEIGHT_CUT_PERCENT`. |
+| `JBFundAccessLimits_InvalidPayoutLimitCurrencyOrdering` | `JBFundAccessLimits` | Payout limit currencies not in strictly increasing order. |
+
+## Key Events
+
+The most important events for indexing and off-chain monitoring. Indexed params marked with `*`.
+
+| Event | Interface | Key Params |
+|-------|-----------|------------|
+| `Pay` | `IJBTerminal` | `rulesetId*`, `rulesetCycleNumber*`, `projectId*`, `payer`, `beneficiary`, `amount`, `newlyIssuedTokenCount` |
+| `CashOutTokens` | `IJBCashOutTerminal` | `rulesetId*`, `rulesetCycleNumber*`, `projectId*`, `holder`, `beneficiary`, `cashOutCount`, `cashOutTaxRate`, `reclaimAmount` |
+| `SendPayouts` | `IJBPayoutTerminal` | `rulesetId*`, `rulesetCycleNumber*`, `projectId*`, `projectOwner`, `amount`, `amountPaidOut`, `fee`, `netLeftoverPayoutAmount` |
+| `SendPayoutToSplit` | `IJBPayoutTerminal` | `projectId*`, `rulesetId*`, `group*`, `split`, `amount`, `netAmount` |
+| `UseAllowance` | `IJBPayoutTerminal` | `rulesetId*`, `rulesetCycleNumber*`, `projectId*`, `beneficiary`, `amount`, `netAmountPaidOut` |
+| `MintTokens` | `IJBController` | `beneficiary*`, `projectId*`, `tokenCount`, `beneficiaryTokenCount`, `reservedPercent` |
+| `BurnTokens` | `IJBController` | `holder*`, `projectId*`, `tokenCount` |
+| `SendReservedTokensToSplits` | `IJBController` | `rulesetId*`, `rulesetCycleNumber*`, `projectId*`, `owner`, `tokenCount`, `leftoverAmount` |
+| `SendReservedTokensToSplit` | `IJBController` | `projectId*`, `rulesetId*`, `groupId*`, `split`, `tokenCount` |
+| `LaunchProject` | `IJBController` | `rulesetId`, `projectId`, `projectUri` |
+| `QueueRulesets` | `IJBController` | `rulesetId`, `projectId` |
+| `DeployERC20` | `IJBController` | `projectId*`, `deployer*`, `salt`, `saltHash`, `caller` |
+| `SetUri` | `IJBController` | `projectId*`, `uri` |
+| `AddToBalance` | `IJBTerminal` | `projectId*`, `amount`, `returnedFees` |
+| `MigrateTerminal` | `IJBTerminal` | `projectId*`, `token*`, `to*`, `amount` |
+| `HoldFee` | `IJBFeeTerminal` | `projectId*`, `token*`, `amount*`, `fee`, `beneficiary` |
+| `ProcessFee` | `IJBFeeTerminal` | `projectId*`, `token*`, `amount*`, `wasHeld`, `beneficiary` |
+| `ReturnHeldFees` | `IJBFeeTerminal` | `projectId*`, `token*`, `amount*`, `returnedFees`, `leftoverAmount` |
+| `Create` | `IJBProjects` | `projectId*`, `owner*` |
+| `OperatorPermissionsSet` | `IJBPermissions` | (operator, account, projectId, permissionIds, packed, caller) |
+| `RulesetQueued` | `IJBRulesets` | (rulesetId, projectId, duration, weight, weightCutPercent, approvalHook, metadata, mustStartAtOrAfter, caller) |
+| `SetSplit` | `IJBSplits` | (projectId, rulesetId, groupId, split, caller) |
+| `AddPriceFeed` | `IJBPrices` | (projectId, pricingCurrency, unitCurrency, feed, caller) |
+
+## Hook Interface Return Types
+
+### `IJBRulesetDataHook.beforePayRecordedWith()`
+
+```solidity
+function beforePayRecordedWith(JBBeforePayRecordedContext calldata context)
+    external view
+    returns (
+        uint256 weight,                              // Overrides the ruleset's weight for token issuance
+        JBPayHookSpecification[] memory hookSpecifications  // Pay hooks to call + amounts to forward
+    );
+```
+
+The data hook can override `weight` to change how many tokens the payer receives. Return `hookSpecifications` to redirect funds to pay hooks (each spec has `hook`, `amount`, `metadata`, and `noop`). An empty array means all funds stay in the terminal balance.
+
+### `IJBRulesetDataHook.beforeCashOutRecordedWith()`
+
+```solidity
+function beforeCashOutRecordedWith(JBBeforeCashOutRecordedContext calldata context)
+    external view
+    returns (
+        uint256 cashOutTaxRate,                               // Overrides the ruleset's cash out tax rate
+        uint256 cashOutCount,                                 // Overrides the number of tokens being cashed out
+        uint256 totalSupply,                                  // Overrides total supply for bonding curve calc
+        JBCashOutHookSpecification[] memory hookSpecifications // Cash out hooks to call + amounts to forward
+    );
+```
+
+The data hook can override `cashOutTaxRate` (0 = proportional, 10000 = nothing reclaimable), `cashOutCount` and `totalSupply` (to shift the bonding curve), and return `hookSpecifications` to redirect reclaimed funds to cash out hooks.
+
+### `IJBRulesetDataHook.hasMintPermissionFor()`
+
+```solidity
+function hasMintPermissionFor(uint256 projectId, JBRuleset memory ruleset, address addr)
+    external view returns (bool flag);
+```
+
+Returns whether `addr` is allowed to mint tokens for the project. Called by `JBController.mintTokensOf` when the caller is not the owner and `allowOwnerMinting` is false -- the data hook can grant mint permission to specific addresses (e.g. suckers for omnichain bridging).
 
 ## Example Integration
 
 ```solidity
 // SPDX-License-Identifier: MIT
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 import {IJBController} from "@bananapus/core-v6/src/interfaces/IJBController.sol";
 import {IJBDirectory} from "@bananapus/core-v6/src/interfaces/IJBDirectory.sol";

package/STYLE_GUIDE.md

@@ -21,7 +21,7 @@ One contract/interface/struct/enum per file. Name the file after the type it con
 
 ```solidity
 // Contracts — pin to exact version
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 // Interfaces, structs, enums — caret for forward compatibility
 pragma solidity ^0.8.0;
@@ -112,6 +112,10 @@ contract JBExample is JBPermissioned, IJBExample {
     // ----------------------- external views ---------------------------- //
     //*********************************************************************//
 
+    //*********************************************************************//
+    // -------------------------- public views --------------------------- //
+    //*********************************************************************//
+
     //*********************************************************************//
     // ----------------------- public transactions ----------------------- //
     //*********************************************************************//
@@ -141,10 +145,11 @@ contract JBExample is JBPermissioned, IJBExample {
 8. Constructor
 9. External transactions
 10. External views
-11. Public transactions
-12. Internal helpers
-13. Internal views
-14. Private helpers
+11. Public views
+12. Public transactions
+13. Internal helpers
+14. Internal views
+15. Private helpers
 
 Functions are alphabetized within each section.
 
@@ -326,7 +331,7 @@ Standard config across all repos:
 
 ```toml
 [profile.default]
-solc = '0.8.26'
+solc = '0.8.28'
 evm_version = 'cancun'
 optimizer_runs = 200
 libs = ["node_modules", "lib"]

package/USER_JOURNEYS.md

@@ -89,15 +89,15 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 - `metadata` -- Hook-specific data
 
 **State changes**:
-1. `JBTerminalStore.balanceOf[terminal][projectId][token]` decremented by `reclaimAmount + hookSpec amounts`
-2. Project tokens burned via `JBController.burnTokensOf()` (credits first, then ERC-20)
+1. `STORE.recordCashOutFor()` -- computes the reclaim amount via bonding curve (using current `totalSupply` which still includes the tokens being cashed out), then decrements `JBTerminalStore.balanceOf[terminal][projectId][token]` by `reclaimAmount + hookSpec amounts`
+2. Project tokens burned via `JBController.burnTokensOf()` (credits first, then ERC-20) -- happens AFTER the reclaim calculation, so the bonding curve sees the pre-burn supply
 3. Reclaimed tokens transferred to beneficiary
 4. Cash out hooks execute (if data hook returns specifications)
-5. Fee taken (2.5%) on total amount eligible for fees, unless beneficiary is feeless. When `cashOutTaxRate == 0`, the fee applies only up to the project's unconsumed fee-free surplus (`_feeFreeSurplusOf`) from intra-terminal payouts — once depleted, cashouts are fee-free.
+5. Fee taken (2.5%) on total amount eligible for fees, unless beneficiary is feeless. When `cashOutTaxRate == 0`, the fee applies only up to the project's unconsumed fee-free surplus (`_feeFreeSurplusOf`) from intra-terminal payouts -- once depleted, cashouts are fee-free.
 
 **Events**: `CashOutTokens(rulesetId, rulesetCycleNumber, projectId, holder, beneficiary, cashOutCount, cashOutTaxRate, reclaimAmount, metadata, caller)`
 
-**Preview**: Call `JBMultiTerminal.previewCashOutFrom(holder, projectId, cashOutCount, tokenToReclaim, beneficiary, metadata)` to simulate the full cash out on-chain -- including data hook effects on tax rate, supply, and hook specifications. Returns `(ruleset, reclaimAmount, cashOutTaxRate, hookSpecifications)`. This is a `view` function that does not modify state. The terminal delegates to `JBTerminalStore.previewCashOutFrom(holder, projectId, cashOutCount, accountingContext, balanceAccountingContexts, beneficiaryIsFeeless, metadata)` for the bonding curve computation. For a simpler estimate without data hook effects, use `currentTotalReclaimableSurplusOf(projectId, cashOutCount, decimals, currency)` or the 6-param `currentReclaimableSurplusOf` overload.
+**Preview**: Call `JBMultiTerminal.previewCashOutFrom(holder, projectId, cashOutCount, tokenToReclaim, beneficiary, metadata)` to simulate the full cash out on-chain -- including data hook effects on tax rate, supply, and hook specifications. Returns `(ruleset, reclaimAmount, cashOutTaxRate, hookSpecifications)`. This is a `view` function that does not modify state. The terminal delegates to `JBTerminalStore.previewCashOutFrom(terminal, holder, projectId, cashOutCount, tokenToReclaim, beneficiaryIsFeeless, metadata)` for the bonding curve computation. For a simpler estimate without data hook effects, use `currentTotalReclaimableSurplusOf(projectId, cashOutCount, decimals, currency)` or the 6-param `currentReclaimableSurplusOf` overload.
 
 **Edge cases**:
 - `cashOutCount = 0` with `totalSupply = 0` -- returns entire surplus (C-5 known bug)
@@ -169,7 +169,7 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 - `usedAmount > surplus` -- reverts (`InadequateTerminalStoreBalance`)
 - Surplus allowance resets each ruleset (keyed by `rulesetId`, not `cycleNumber`)
 - Amount validated against surplus BEFORE checking allowance limit
-- If both owner and beneficiary are feeless, no fee is taken
+- If either the owner or the beneficiary is feeless, no fee is taken
 
 ---
 
@@ -277,7 +277,7 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 1. `JBSplits` stores the new split groups for the project/ruleset/group combination
 2. Locked splits from existing configuration must be preserved (validated by `JBSplits`)
 
-**Events**: Emitted by `JBSplits` (not `JBController`)
+**Events**: `SetSplit(projectId, rulesetId, groupId, split, caller)` per split (emitted by `JBSplits`, not `JBController`)
 
 **Edge cases**:
 - Locked splits (`lockedUntil > block.timestamp`) cannot be removed or modified
@@ -321,15 +321,19 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 
 **Who can call**: Project owner, address with `SET_CONTROLLER` permission, or an address in `isAllowedToSetFirstController` (for first controller only). The current controller's ruleset must have `allowSetController` enabled.
 
+**Parameters**:
+- `projectId` -- The project being migrated
+- `controller` -- The new controller (must support `IERC165`)
+
 **Flow**:
 1. `JBDirectory.setControllerOf(projectId, newController)` is called
-2. Directory calls `newController.beforeReceiveMigrationFrom(oldController, projectId)`:
-   - Copies metadata URI from old controller
-   - Distributes pending reserved tokens from old controller
-3. Directory calls `oldController.migrate(projectId, newController)`:
+2. If old controller exists AND new controller supports `IJBMigratable`: directory calls `newController.beforeReceiveMigrationFrom(oldController, projectId)`:
+   - Copies metadata URI from old controller (if it supports `IJBProjectUriRegistry`)
+   - Distributes pending reserved tokens from old controller (if it supports `IJBController` and has pending tokens)
+3. If old controller exists AND old controller supports `IJBMigratable`: directory calls `oldController.migrate(projectId, newController)`:
    - Reverts if pending reserved tokens > 0 (must distribute first)
 4. Directory updates `controllerOf[projectId] = newController`
-5. Directory calls `newController.afterReceiveMigrationFrom(oldController, projectId)`
+5. If old controller exists AND new controller supports `IJBMigratable`: directory calls `newController.afterReceiveMigrationFrom(oldController, projectId)` (currently a no-op; verifies caller is the directory)
 
 **Events**: `Migrate(projectId, to, caller)` from old controller; `SetController(projectId, controller, caller)` from directory
 
@@ -358,7 +362,7 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 2. Clone's `initialize(name, symbol, owner=JBTokens)` is called
 3. `JBTokens.tokenOf[projectId]` set to the new token
 
-**Events**: `DeployERC20(projectId, deployer, salt, saltHash, caller)`
+**Events**: `DeployERC20(projectId, deployer, salt, saltHash, caller)` from `JBController`, `DeployERC20(projectId, token, name, symbol, salt, caller)` from `JBTokens`
 
 **Edge cases**:
 - Can only be called once per project. If a token is already set, `JBTokens` reverts.
@@ -383,6 +387,8 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 1. `JBTokens.creditBalanceOf[holder][projectId]` decreased by `tokenCount`
 2. ERC-20 tokens minted to `beneficiary` for `tokenCount`
 
+**Events**: `ClaimTokens(holder, projectId, creditBalance, count, beneficiary, caller)` (emitted by `JBTokens`)
+
 **Edge cases**:
 - Requires an ERC-20 token to be deployed for the project (reverts otherwise)
 - Credits and ERC-20 tokens are fungible -- this is a one-way conversion from internal credits to on-chain ERC-20
@@ -421,7 +427,7 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 
 ## 15. Add Price Feeds
 
-**Entry point**: `JBController.addPriceFeed(uint256 projectId, uint256 pricingCurrency, uint256 unitCurrency, IJBPriceFeed feed)`
+**Entry point**: `JBController.addPriceFeedFor(uint256 projectId, uint256 pricingCurrency, uint256 unitCurrency, IJBPriceFeed feed)`
 
 **Who can call**: Project owner or address with `ADD_PRICE_FEED` permission.
 
@@ -435,7 +441,7 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 1. `JBPrices` stores the feed for the `(projectId, pricingCurrency, unitCurrency)` triple
 2. Feed is **immutable** once set -- cannot be replaced or removed
 
-**Events**: Emitted by `JBPrices`
+**Events**: `AddPriceFeed(projectId, pricingCurrency, unitCurrency, feed, caller)` (emitted by `JBPrices`)
 
 **Edge cases**:
 - Requires `allowAddPriceFeed` in current ruleset
@@ -488,6 +494,8 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 2. All `PROJECTS.ownerOf(projectId)` calls now return the new owner
 3. All permission checks that reference the owner now apply to the new owner
 
+**Events**: `Transfer(from, to, tokenId)` (standard ERC-721 event)
+
 **Edge cases**:
 - This is a standard ERC-721 transfer. All ERC-721 rules apply (approval, operator, etc.)
 - **Permissions are NOT transferred**. Existing operators retain their permissions scoped to the account that granted them (the old owner). The new owner must grant their own permissions.
@@ -539,7 +547,7 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 1. `JBTokens.creditBalanceOf[holder][projectId]` decreased
 2. `JBTokens.creditBalanceOf[recipient][projectId]` increased
 
-**Events**: Emitted by `JBTokens`
+**Events**: `TransferCredits(holder, projectId, recipient, count, caller)` (emitted by `JBTokens`)
 
 **Edge cases**:
 - Reverts if `pauseCreditTransfers` is set in current ruleset
@@ -554,10 +562,18 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 
 **Who can call**: Project owner or address with `SET_PROJECT_URI` permission.
 
+**Parameters**:
+- `projectId` -- Target project
+- `uri` -- Metadata URI (typically an IPFS hash)
+
 **State changes**: `uriOf[projectId] = uri`
 
 **Events**: `SetUri(projectId, uri, caller)`
 
+**Edge cases**:
+- Empty string is valid -- clears the metadata URI
+- No ruleset flag required (always allowed with permission)
+
 ---
 
 ## 21. Set Custom Token
@@ -566,8 +582,14 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 
 **Who can call**: Project owner or address with `SET_TOKEN` permission.
 
+**Parameters**:
+- `projectId` -- Target project
+- `token` -- The custom token contract (must implement `IJBToken`)
+
 **State changes**: `JBTokens.tokenOf[projectId] = token`
 
+**Events**: `SetToken(projectId, token, caller)` (emitted by `JBTokens`)
+
 **Edge cases**:
 - Requires `allowSetCustomToken` in current or upcoming ruleset
 - Can only be called if no token is currently set for the project
@@ -581,7 +603,18 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 
 **Who can call**: Project owner or address with `SET_TOKEN_METADATA` permission.
 
-**State changes**: Updates the ERC-20 token's name and symbol via `JBERC20.setNameAndSymbol()`
+**Parameters**:
+- `projectId` -- Target project
+- `name` -- New ERC-20 token name
+- `symbol` -- New ERC-20 token symbol
+
+**State changes**: Updates the ERC-20 token's name and symbol via `JBERC20.setMetadata()`
+
+**Events**: `SetTokenMetadata(projectId, name, symbol, caller)` (emitted by `JBTokens`)
+
+**Edge cases**:
+- Requires an ERC-20 token to be deployed for the project (reverts if no token set)
+- Only works with `JBERC20` clones (custom tokens that implement `IJBToken` may not support `setMetadata`)
 
 ---
 
@@ -615,6 +648,10 @@ All user paths through the Juicebox V6 core protocol. For each journey: entry po
 
 **Who can call**: Project owner, address with `ADD_ACCOUNTING_CONTEXTS` permission, or the project's controller.
 
+**Parameters**:
+- `projectId` -- Target project
+- `accountingContexts` -- Array of `JBAccountingContext` structs, each specifying a token address, decimals, and currency
+
 **State changes**:
 1. For each context: validates token decimals, stores `_accountingContextForTokenOf[projectId][token]`
 2. Appends to `_accountingContextsOf[projectId]` array

package/foundry.toml

@@ -1,5 +1,5 @@
 [profile.default]
-solc = '0.8.26'
+solc = '0.8.28'
 evm_version = 'cancun'
 optimizer_runs = 200
 libs = ["node_modules", "lib"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bananapus/core-v6",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
     "artifacts": "source ./.env && npx sphinx artifacts --org-id 'ea165b21-7cdc-4d7b-be59-ecdd4c26bee4' --project-name 'nana-core-v6'"
   },
   "dependencies": {
-    "@bananapus/permission-ids-v6": "^0.0.10",
+    "@bananapus/permission-ids-v6": "^0.0.11",
     "@chainlink/contracts": "^1.3.0",
     "@openzeppelin/contracts": "^5.6.1",
     "@prb/math": "^4.1.1",

package/script/Deploy.s.sol

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 import {Sphinx} from "@sphinx-labs/contracts/contracts/foundry/SphinxPlugin.sol";
 import {Script} from "forge-std/Script.sol";
@@ -43,7 +43,7 @@ contract Deploy is Script, Sphinx {
     uint256 private CORE_DEPLOYMENT_NONCE = 6;
 
     function configureSphinx() public override {
-        sphinxConfig.projectName = "nana-core-v5";
+        sphinxConfig.projectName = "nana-core-v6";
         sphinxConfig.mainnets = ["ethereum", "optimism", "base", "arbitrum"];
         sphinxConfig.testnets = ["ethereum_sepolia", "optimism_sepolia", "base_sepolia", "arbitrum_sepolia"];
     }

package/script/DeployPeriphery.s.sol

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 import {Sphinx} from "@sphinx-labs/contracts/contracts/foundry/SphinxPlugin.sol";
 import {Script} from "forge-std/Script.sol";
@@ -47,7 +47,7 @@ contract DeployPeriphery is Script, Sphinx {
     address private OMNICHAIN_RULESET_OPERATOR = address(0x8f5DED85c40b50d223269C1F922A056E72101590);
 
     function configureSphinx() public override {
-        sphinxConfig.projectName = "nana-core-v5";
+        sphinxConfig.projectName = "nana-core-v6";
         sphinxConfig.mainnets = ["ethereum", "optimism", "base", "arbitrum"];
         sphinxConfig.testnets = ["ethereum_sepolia", "optimism_sepolia", "base_sepolia", "arbitrum_sepolia"];
     }
@@ -254,9 +254,6 @@ contract DeployPeriphery is Script, Sphinx {
             });
         } else if (block.chainid == 84_532) {
             usdc = address(0x036CbD53842c5426634e7929541eC2318f3dCF7e);
-            // TODO: Verify this feed address — 0xd30e2101... is the Arbitrum Sepolia ETH/USD feed and is likely
-            // incorrect for Base Sepolia USDC/USD. Replace with the correct Chainlink Base Sepolia USDC/USD address
-            // before deploying. Testnet-only; does not affect mainnet deployments.
             usdcFeed = new JBChainlinkV3PriceFeed({
                 feed: AggregatorV3Interface(address(0xd30e2101a97dcbAeBCBC04F14C3f624E67A35165)),
                 threshold: 86_400 seconds

package/script/helpers/CoreDeploymentLib.sol

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 import {stdJson} from "forge-std/Script.sol";
 import {Vm} from "forge-std/Vm.sol";
@@ -40,7 +40,7 @@ library CoreDeploymentLib {
     address internal constant VM_ADDRESS = address(uint160(uint256(keccak256("hevm cheat code"))));
     // forge-lint: disable-next-line(screaming-snake-case-const)
     Vm internal constant vm = Vm(VM_ADDRESS);
-    string constant PROJECT_NAME = "nana-core-v5";
+    string constant PROJECT_NAME = "nana-core-v6";
 
     function getDeployment(string memory path) internal returns (CoreDeployment memory deployment) {
         // get chainId for which we need to get the deployment.

package/src/JBChainlinkV3PriceFeed.sol

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 import {AggregatorV3Interface} from "@chainlink/contracts/src/v0.8/shared/interfaces/AggregatorV3Interface.sol";
 

package/src/JBChainlinkV3SequencerPriceFeed.sol

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 import {AggregatorV2V3Interface} from "@chainlink/contracts/src/v0.8/shared/interfaces/AggregatorV2V3Interface.sol";
 import {AggregatorV3Interface} from "@chainlink/contracts/src/v0.8/shared/interfaces/AggregatorV3Interface.sol";

package/src/JBController.sol

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 import {JBPermissionIds} from "@bananapus/permission-ids-v6/src/JBPermissionIds.sol";
 import {ERC2771Context} from "@openzeppelin/contracts/metatx/ERC2771Context.sol";
@@ -95,11 +95,18 @@ contract JBController is JBPermissioned, ERC2771Context, IJBController, IJBMigra
     IJBTokens public immutable override TOKENS;
 
     /// @notice The address of the contract that manages omnichain ruleset ops.
-    /// @dev This is a deterministic CREATE2 deployment; bytecode verification at runtime would add
-    /// gas
-    /// cost for marginal security benefit since the address is verified at deploy time.
-    /// @dev Trust assumption is bounded: the operator can only queue rulesets that the omnichain
-    /// deployer's logic permits. It cannot drain funds or bypass access controls.
+    /// @dev This is a deterministic CREATE2 deployment; bytecode verification at runtime would add gas cost for
+    /// marginal security benefit since the address is verified at deploy time.
+    /// @dev TRUST BOUNDARY: This hardcoded address can call `launchRulesetsFor` and `queueRulesetsOf` for ANY project,
+    /// bypassing normal `JBPermissions` checks. If this address is compromised or its implementation is malicious:
+    ///   - Projects WITH approval hooks are partially protected: the attacker can queue rulesets, but they must pass
+    ///     the project's approval hook before becoming active.
+    ///   - Projects WITHOUT approval hooks (duration == 0 or no approval hook set) are IMMEDIATELY affected: queued
+    ///     rulesets take effect as soon as the current ruleset expires (or immediately if duration == 0).
+    /// @dev The operator can also call `setTerminalsOf` during `launchRulesetsFor`, which could redirect a project's
+    /// payment routing. This is limited to the initial launch flow (reverts if rulesets already exist).
+    /// @dev Mitigation: verify the deployed bytecode at this address matches the expected `JBOmnichainDeployer`
+    /// contract from `nana-omnichain-deployers-v6` on every target chain before running deployment scripts.
     address public immutable override OMNICHAIN_RULESET_OPERATOR;
 
     //*********************************************************************//
@@ -164,7 +171,7 @@ contract JBController is JBPermissioned, ERC2771Context, IJBController, IJBMigra
     /// @param pricingCurrency The currency the feed's output price is in terms of.
     /// @param unitCurrency The currency being priced by the feed.
     /// @param feed The address of the price feed to add.
-    function addPriceFeed(
+    function addPriceFeedFor(
         uint256 projectId,
         uint256 pricingCurrency,
         uint256 unitCurrency,

package/src/JBDeadline.sol

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
 

package/src/JBDirectory.sol

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-pragma solidity 0.8.26;
+pragma solidity 0.8.28;
 
 import {JBPermissionIds} from "@bananapus/permission-ids-v6/src/JBPermissionIds.sol";
 import {Ownable} from "@openzeppelin/contracts/access/Ownable.sol";