@bananapus/core-v6 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (436) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +112 -0
  3. package/SKILLS.md +151 -0
  4. package/docs/book.css +13 -0
  5. package/docs/book.toml +12 -0
  6. package/docs/solidity.min.js +74 -0
  7. package/docs/src/README.md +703 -0
  8. package/docs/src/SUMMARY.md +94 -0
  9. package/docs/src/src/JBChainlinkV3PriceFeed.sol/contract.JBChainlinkV3PriceFeed.md +83 -0
  10. package/docs/src/src/JBChainlinkV3SequencerPriceFeed.sol/contract.JBChainlinkV3SequencerPriceFeed.md +88 -0
  11. package/docs/src/src/JBController.sol/contract.JBController.md +1121 -0
  12. package/docs/src/src/JBDeadline.sol/contract.JBDeadline.md +84 -0
  13. package/docs/src/src/JBDirectory.sol/contract.JBDirectory.md +294 -0
  14. package/docs/src/src/JBERC20.sol/contract.JBERC20.md +190 -0
  15. package/docs/src/src/JBFeelessAddresses.sol/contract.JBFeelessAddresses.md +80 -0
  16. package/docs/src/src/JBFundAccessLimits.sol/contract.JBFundAccessLimits.md +253 -0
  17. package/docs/src/src/JBMultiTerminal.sol/contract.JBMultiTerminal.md +1472 -0
  18. package/docs/src/src/JBPermissions.sol/contract.JBPermissions.md +199 -0
  19. package/docs/src/src/JBPrices.sol/contract.JBPrices.md +154 -0
  20. package/docs/src/src/JBProjects.sol/contract.JBProjects.md +131 -0
  21. package/docs/src/src/JBRulesets.sol/contract.JBRulesets.md +677 -0
  22. package/docs/src/src/JBSplits.sol/contract.JBSplits.md +237 -0
  23. package/docs/src/src/JBTerminalStore.sol/contract.JBTerminalStore.md +591 -0
  24. package/docs/src/src/JBTokens.sol/contract.JBTokens.md +353 -0
  25. package/docs/src/src/README.md +25 -0
  26. package/docs/src/src/abstract/JBControlled.sol/abstract.JBControlled.md +64 -0
  27. package/docs/src/src/abstract/JBPermissioned.sol/abstract.JBPermissioned.md +84 -0
  28. package/docs/src/src/abstract/README.md +5 -0
  29. package/docs/src/src/enums/JBApprovalStatus.sol/enum.JBApprovalStatus.md +17 -0
  30. package/docs/src/src/enums/README.md +4 -0
  31. package/docs/src/src/interfaces/IJBCashOutHook.sol/interface.IJBCashOutHook.md +29 -0
  32. package/docs/src/src/interfaces/IJBCashOutTerminal.sol/interface.IJBCashOutTerminal.md +57 -0
  33. package/docs/src/src/interfaces/IJBControlled.sol/interface.IJBControlled.md +12 -0
  34. package/docs/src/src/interfaces/IJBController.sol/interface.IJBController.md +334 -0
  35. package/docs/src/src/interfaces/IJBDirectory.sol/interface.IJBDirectory.md +108 -0
  36. package/docs/src/src/interfaces/IJBDirectoryAccessControl.sol/interface.IJBDirectoryAccessControl.md +19 -0
  37. package/docs/src/src/interfaces/IJBFeeTerminal.sol/interface.IJBFeeTerminal.md +91 -0
  38. package/docs/src/src/interfaces/IJBFeelessAddresses.sol/interface.IJBFeelessAddresses.md +26 -0
  39. package/docs/src/src/interfaces/IJBFundAccessLimits.sol/interface.IJBFundAccessLimits.md +88 -0
  40. package/docs/src/src/interfaces/IJBMigratable.sol/interface.IJBMigratable.md +29 -0
  41. package/docs/src/src/interfaces/IJBMultiTerminal.sol/interface.IJBMultiTerminal.md +50 -0
  42. package/docs/src/src/interfaces/IJBPayHook.sol/interface.IJBPayHook.md +28 -0
  43. package/docs/src/src/interfaces/IJBPayoutTerminal.sol/interface.IJBPayoutTerminal.md +105 -0
  44. package/docs/src/src/interfaces/IJBPermissioned.sol/interface.IJBPermissioned.md +12 -0
  45. package/docs/src/src/interfaces/IJBPermissions.sol/interface.IJBPermissions.md +74 -0
  46. package/docs/src/src/interfaces/IJBPermitTerminal.sol/interface.IJBPermitTerminal.md +15 -0
  47. package/docs/src/src/interfaces/IJBPriceFeed.sol/interface.IJBPriceFeed.md +12 -0
  48. package/docs/src/src/interfaces/IJBPrices.sol/interface.IJBPrices.md +74 -0
  49. package/docs/src/src/interfaces/IJBProjectUriRegistry.sol/interface.IJBProjectUriRegistry.md +19 -0
  50. package/docs/src/src/interfaces/IJBProjects.sol/interface.IJBProjects.md +49 -0
  51. package/docs/src/src/interfaces/IJBRulesetApprovalHook.sol/interface.IJBRulesetApprovalHook.md +35 -0
  52. package/docs/src/src/interfaces/IJBRulesetDataHook.sol/interface.IJBRulesetDataHook.md +97 -0
  53. package/docs/src/src/interfaces/IJBRulesets.sol/interface.IJBRulesets.md +165 -0
  54. package/docs/src/src/interfaces/IJBSplitHook.sol/interface.IJBSplitHook.md +31 -0
  55. package/docs/src/src/interfaces/IJBSplits.sol/interface.IJBSplits.md +35 -0
  56. package/docs/src/src/interfaces/IJBTerminal.sol/interface.IJBTerminal.md +141 -0
  57. package/docs/src/src/interfaces/IJBTerminalStore.sol/interface.IJBTerminalStore.md +198 -0
  58. package/docs/src/src/interfaces/IJBToken.sol/interface.IJBToken.md +54 -0
  59. package/docs/src/src/interfaces/IJBTokenUriResolver.sol/interface.IJBTokenUriResolver.md +12 -0
  60. package/docs/src/src/interfaces/IJBTokens.sol/interface.IJBTokens.md +151 -0
  61. package/docs/src/src/interfaces/README.md +33 -0
  62. package/docs/src/src/libraries/JBCashOuts.sol/library.JBCashOuts.md +40 -0
  63. package/docs/src/src/libraries/JBConstants.sol/library.JBConstants.md +52 -0
  64. package/docs/src/src/libraries/JBCurrencyIds.sol/library.JBCurrencyIds.md +19 -0
  65. package/docs/src/src/libraries/JBFees.sol/library.JBFees.md +52 -0
  66. package/docs/src/src/libraries/JBFixedPointNumber.sol/library.JBFixedPointNumber.md +12 -0
  67. package/docs/src/src/libraries/JBMetadataResolver.sol/library.JBMetadataResolver.md +242 -0
  68. package/docs/src/src/libraries/JBRulesetMetadataResolver.sol/library.JBRulesetMetadataResolver.md +180 -0
  69. package/docs/src/src/libraries/JBSplitGroupIds.sol/library.JBSplitGroupIds.md +14 -0
  70. package/docs/src/src/libraries/JBSurplus.sol/library.JBSurplus.md +44 -0
  71. package/docs/src/src/libraries/README.md +12 -0
  72. package/docs/src/src/periphery/JBDeadline1Day.sol/contract.JBDeadline1Day.md +15 -0
  73. package/docs/src/src/periphery/JBDeadline3Days.sol/contract.JBDeadline3Days.md +15 -0
  74. package/docs/src/src/periphery/JBDeadline3Hours.sol/contract.JBDeadline3Hours.md +15 -0
  75. package/docs/src/src/periphery/JBDeadline7Days.sol/contract.JBDeadline7Days.md +15 -0
  76. package/docs/src/src/periphery/JBMatchingPriceFeed.sol/contract.JBMatchingPriceFeed.md +22 -0
  77. package/docs/src/src/periphery/README.md +8 -0
  78. package/docs/src/src/structs/JBAccountingContext.sol/struct.JBAccountingContext.md +20 -0
  79. package/docs/src/src/structs/JBAfterCashOutRecordedContext.sol/struct.JBAfterCashOutRecordedContext.md +43 -0
  80. package/docs/src/src/structs/JBAfterPayRecordedContext.sol/struct.JBAfterPayRecordedContext.md +42 -0
  81. package/docs/src/src/structs/JBBeforeCashOutRecordedContext.sol/struct.JBBeforeCashOutRecordedContext.md +45 -0
  82. package/docs/src/src/structs/JBBeforePayRecordedContext.sol/struct.JBBeforePayRecordedContext.md +41 -0
  83. package/docs/src/src/structs/JBCashOutHookSpecification.sol/struct.JBCashOutHookSpecification.md +22 -0
  84. package/docs/src/src/structs/JBCurrencyAmount.sol/struct.JBCurrencyAmount.md +17 -0
  85. package/docs/src/src/structs/JBFee.sol/struct.JBFee.md +20 -0
  86. package/docs/src/src/structs/JBFundAccessLimitGroup.sol/struct.JBFundAccessLimitGroup.md +39 -0
  87. package/docs/src/src/structs/JBPayHookSpecification.sol/struct.JBPayHookSpecification.md +22 -0
  88. package/docs/src/src/structs/JBPermissionsData.sol/struct.JBPermissionsData.md +21 -0
  89. package/docs/src/src/structs/JBRuleset.sol/struct.JBRuleset.md +55 -0
  90. package/docs/src/src/structs/JBRulesetConfig.sol/struct.JBRulesetConfig.md +51 -0
  91. package/docs/src/src/structs/JBRulesetMetadata.sol/struct.JBRulesetMetadata.md +79 -0
  92. package/docs/src/src/structs/JBRulesetWeightCache.sol/struct.JBRulesetWeightCache.md +16 -0
  93. package/docs/src/src/structs/JBRulesetWithMetadata.sol/struct.JBRulesetWithMetadata.md +16 -0
  94. package/docs/src/src/structs/JBSingleAllowance.sol/struct.JBSingleAllowance.md +26 -0
  95. package/docs/src/src/structs/JBSplit.sol/struct.JBSplit.md +49 -0
  96. package/docs/src/src/structs/JBSplitGroup.sol/struct.JBSplitGroup.md +17 -0
  97. package/docs/src/src/structs/JBSplitHookContext.sol/struct.JBSplitHookContext.md +29 -0
  98. package/docs/src/src/structs/JBTerminalConfig.sol/struct.JBTerminalConfig.md +16 -0
  99. package/docs/src/src/structs/JBTokenAmount.sol/struct.JBTokenAmount.md +23 -0
  100. package/docs/src/src/structs/README.md +25 -0
  101. package/foundry.lock +11 -0
  102. package/foundry.toml +41 -0
  103. package/package.json +38 -0
  104. package/remappings.txt +1 -0
  105. package/script/Deploy.s.sol +111 -0
  106. package/script/DeployPeriphery.s.sol +287 -0
  107. package/script/helpers/CoreDeploymentLib.sol +121 -0
  108. package/slither-ci.config.json +10 -0
  109. package/sphinx.lock +507 -0
  110. package/src/JBChainlinkV3PriceFeed.sol +77 -0
  111. package/src/JBChainlinkV3SequencerPriceFeed.sol +75 -0
  112. package/src/JBController.sol +1186 -0
  113. package/src/JBDeadline.sol +73 -0
  114. package/src/JBDirectory.sol +343 -0
  115. package/src/JBERC20.sol +131 -0
  116. package/src/JBFeelessAddresses.sol +54 -0
  117. package/src/JBFundAccessLimits.sol +308 -0
  118. package/src/JBMultiTerminal.sol +2024 -0
  119. package/src/JBPermissions.sol +252 -0
  120. package/src/JBPrices.sol +227 -0
  121. package/src/JBProjects.sol +126 -0
  122. package/src/JBRulesets.sol +1093 -0
  123. package/src/JBSplits.sol +324 -0
  124. package/src/JBTerminalStore.sol +908 -0
  125. package/src/JBTokens.sol +376 -0
  126. package/src/abstract/JBControlled.sol +48 -0
  127. package/src/abstract/JBPermissioned.sol +77 -0
  128. package/src/enums/JBApprovalStatus.sol +12 -0
  129. package/src/interfaces/IJBCashOutHook.sol +15 -0
  130. package/src/interfaces/IJBCashOutTerminal.sol +51 -0
  131. package/src/interfaces/IJBControlled.sol +10 -0
  132. package/src/interfaces/IJBController.sol +280 -0
  133. package/src/interfaces/IJBDirectory.sol +69 -0
  134. package/src/interfaces/IJBDirectoryAccessControl.sol +15 -0
  135. package/src/interfaces/IJBFeeTerminal.sol +61 -0
  136. package/src/interfaces/IJBFeelessAddresses.sol +17 -0
  137. package/src/interfaces/IJBFundAccessLimits.sol +94 -0
  138. package/src/interfaces/IJBMigratable.sol +24 -0
  139. package/src/interfaces/IJBMultiTerminal.sol +36 -0
  140. package/src/interfaces/IJBPayHook.sol +14 -0
  141. package/src/interfaces/IJBPayoutTerminal.sol +92 -0
  142. package/src/interfaces/IJBPermissioned.sol +10 -0
  143. package/src/interfaces/IJBPermissions.sol +71 -0
  144. package/src/interfaces/IJBPermitTerminal.sol +14 -0
  145. package/src/interfaces/IJBPriceFeed.sol +10 -0
  146. package/src/interfaces/IJBPrices.sol +65 -0
  147. package/src/interfaces/IJBProjectUriRegistry.sol +15 -0
  148. package/src/interfaces/IJBProjects.sol +27 -0
  149. package/src/interfaces/IJBRulesetApprovalHook.sol +21 -0
  150. package/src/interfaces/IJBRulesetDataHook.sol +56 -0
  151. package/src/interfaces/IJBRulesets.sol +151 -0
  152. package/src/interfaces/IJBSplitHook.sol +16 -0
  153. package/src/interfaces/IJBSplits.sol +28 -0
  154. package/src/interfaces/IJBTerminal.sol +120 -0
  155. package/src/interfaces/IJBTerminalStore.sol +225 -0
  156. package/src/interfaces/IJBToken.sol +39 -0
  157. package/src/interfaces/IJBTokenUriResolver.sol +10 -0
  158. package/src/interfaces/IJBTokens.sol +113 -0
  159. package/src/libraries/JBCashOuts.sol +120 -0
  160. package/src/libraries/JBConstants.sol +14 -0
  161. package/src/libraries/JBCurrencyIds.sol +7 -0
  162. package/src/libraries/JBFees.sol +28 -0
  163. package/src/libraries/JBFixedPointNumber.sol +12 -0
  164. package/src/libraries/JBMetadataResolver.sol +306 -0
  165. package/src/libraries/JBRulesetMetadataResolver.sol +160 -0
  166. package/src/libraries/JBSplitGroupIds.sol +7 -0
  167. package/src/libraries/JBSurplus.sol +40 -0
  168. package/src/periphery/JBDeadline1Day.sol +8 -0
  169. package/src/periphery/JBDeadline3Days.sol +8 -0
  170. package/src/periphery/JBDeadline3Hours.sol +8 -0
  171. package/src/periphery/JBDeadline7Days.sol +8 -0
  172. package/src/periphery/JBMatchingPriceFeed.sol +13 -0
  173. package/src/structs/JBAccountingContext.sol +12 -0
  174. package/src/structs/JBAfterCashOutRecordedContext.sol +30 -0
  175. package/src/structs/JBAfterPayRecordedContext.sol +29 -0
  176. package/src/structs/JBBeforeCashOutRecordedContext.sol +31 -0
  177. package/src/structs/JBBeforePayRecordedContext.sol +28 -0
  178. package/src/structs/JBCashOutHookSpecification.sol +15 -0
  179. package/src/structs/JBCurrencyAmount.sol +10 -0
  180. package/src/structs/JBFee.sol +12 -0
  181. package/src/structs/JBFundAccessLimitGroup.sol +28 -0
  182. package/src/structs/JBPayHookSpecification.sol +15 -0
  183. package/src/structs/JBPermissionsData.sol +13 -0
  184. package/src/structs/JBRuleset.sol +42 -0
  185. package/src/structs/JBRulesetConfig.sol +43 -0
  186. package/src/structs/JBRulesetMetadata.sol +56 -0
  187. package/src/structs/JBRulesetWeightCache.sol +9 -0
  188. package/src/structs/JBRulesetWithMetadata.sol +12 -0
  189. package/src/structs/JBSingleAllowance.sol +16 -0
  190. package/src/structs/JBSplit.sol +37 -0
  191. package/src/structs/JBSplitGroup.sol +12 -0
  192. package/src/structs/JBSplitHookContext.sol +20 -0
  193. package/src/structs/JBTerminalConfig.sol +12 -0
  194. package/src/structs/JBTokenAmount.sol +14 -0
  195. package/test/AuditExploits.t.sol +2710 -0
  196. package/test/ComprehensiveInvariant.t.sol +298 -0
  197. package/test/EconomicSimulation.t.sol +340 -0
  198. package/test/EntryPointPermutations.t.sol +671 -0
  199. package/test/FlashLoanAttacks.t.sol +792 -0
  200. package/test/PermissionEscalation.t.sol +679 -0
  201. package/test/RulesetTransitions.t.sol +699 -0
  202. package/test/SplitLoopTests.t.sol +731 -0
  203. package/test/TestAccessToFunds.sol +2644 -0
  204. package/test/TestCashOut.sol +185 -0
  205. package/test/TestCashOutCountFor.sol +272 -0
  206. package/test/TestCashOutHooks.sol +317 -0
  207. package/test/TestCashOutTimingEdge.sol +229 -0
  208. package/test/TestDurationUnderflow.sol +220 -0
  209. package/test/TestFeeProcessingFailure.sol +208 -0
  210. package/test/TestFees.sol +604 -0
  211. package/test/TestInterfaceSupport.sol +62 -0
  212. package/test/TestJBERC20Inheritance.sol +91 -0
  213. package/test/TestLaunchProject.sol +176 -0
  214. package/test/TestMetaTx.sol +203 -0
  215. package/test/TestMetadataParserLib.sol +438 -0
  216. package/test/TestMigrationHeldFees.sol +249 -0
  217. package/test/TestMintTokensOf.sol +172 -0
  218. package/test/TestMultiTokenSurplus.sol +206 -0
  219. package/test/TestMultipleAccessLimits.sol +642 -0
  220. package/test/TestPayBurnRedeemFlow.sol +180 -0
  221. package/test/TestPayHooks.sol +190 -0
  222. package/test/TestPermissions.sol +305 -0
  223. package/test/TestPermissionsEdge.sol +286 -0
  224. package/test/TestPermit2Terminal.sol +339 -0
  225. package/test/TestRulesetQueueing.sol +1001 -0
  226. package/test/TestRulesetQueuingStress.sol +778 -0
  227. package/test/TestRulesetWeightCaching.sol +177 -0
  228. package/test/TestSplits.sol +369 -0
  229. package/test/TestTerminalMigration.sol +167 -0
  230. package/test/TestTokenFlow.sol +174 -0
  231. package/test/WeirdTokenTests.t.sol +764 -0
  232. package/test/formal/BondingCurveProperties.t.sol +411 -0
  233. package/test/formal/FeeProperties.t.sol +246 -0
  234. package/test/helpers/JBTest.sol +129 -0
  235. package/test/helpers/MetadataResolverHelper.sol +116 -0
  236. package/test/helpers/TestBaseWorkflow.sol +317 -0
  237. package/test/invariants/Phase3DeepInvariant.t.sol +404 -0
  238. package/test/invariants/RulesetsInvariant.t.sol +115 -0
  239. package/test/invariants/TerminalStoreInvariant.t.sol +220 -0
  240. package/test/invariants/TokensInvariant.t.sol +184 -0
  241. package/test/invariants/handlers/ComprehensiveHandler.sol +285 -0
  242. package/test/invariants/handlers/EconomicHandler.sol +347 -0
  243. package/test/invariants/handlers/Phase3Handler.sol +414 -0
  244. package/test/invariants/handlers/RulesetsHandler.sol +111 -0
  245. package/test/invariants/handlers/TerminalStoreHandler.sol +146 -0
  246. package/test/invariants/handlers/TokensHandler.sol +127 -0
  247. package/test/mock/ERC2771ForwarderMock.sol +37 -0
  248. package/test/mock/MockERC20.sol +18 -0
  249. package/test/mock/MockMaliciousBeneficiary.sol +67 -0
  250. package/test/mock/MockMaliciousSplitHook.sol +42 -0
  251. package/test/mock/MockPriceFeed.sol +20 -0
  252. package/test/trees/JBController/burnTokensOf.tree +9 -0
  253. package/test/trees/JBController/claimTokensFor.tree +5 -0
  254. package/test/trees/JBController/deployERC20For.tree +5 -0
  255. package/test/trees/JBController/getRulesetOf.tree +5 -0
  256. package/test/trees/JBController/launchProjectFor.tree +12 -0
  257. package/test/trees/JBController/launchRulesetsFor.tree +8 -0
  258. package/test/trees/JBController/migrateController.tree +12 -0
  259. package/test/trees/JBController/mintTokensOf.tree +12 -0
  260. package/test/trees/JBController/payReservedTokenToTerminal.tree +8 -0
  261. package/test/trees/JBController/receiveMigrationFrom.tree +4 -0
  262. package/test/trees/JBController/sendReservedTokensToSplitsOf.tree +12 -0
  263. package/test/trees/JBController/setMetadataOf.tree +5 -0
  264. package/test/trees/JBController/setSplitGroupsOf.tree +5 -0
  265. package/test/trees/JBController/setTokenFor.tree +5 -0
  266. package/test/trees/JBController/transferCreditsFrom.tree +8 -0
  267. package/test/trees/JBDirectory/primaryTerminalOf.tree +8 -0
  268. package/test/trees/JBDirectory/setControllerOf.tree +11 -0
  269. package/test/trees/JBDirectory/setPrimaryTerminalOf.tree +15 -0
  270. package/test/trees/JBDirectory/setTerminalsOf.tree +11 -0
  271. package/test/trees/JBERC20/initialize.tree +7 -0
  272. package/test/trees/JBERC20/name.tree +5 -0
  273. package/test/trees/JBERC20/nonces.tree +5 -0
  274. package/test/trees/JBERC20/symbol.tree +5 -0
  275. package/test/trees/JBFeelessAddresses/setFeelessAddress.tree +5 -0
  276. package/test/trees/JBFeelessAddresses/supportsInterface.tree +5 -0
  277. package/test/trees/JBFundAccessLimits/payoutLimitOf.tree +5 -0
  278. package/test/trees/JBFundAccessLimits/payoutLimitsOf.tree +8 -0
  279. package/test/trees/JBFundAccessLimits/setFundAccessLimitsFor.tree +18 -0
  280. package/test/trees/JBFundAccessLimits/surplusAllowanceOf.tree +5 -0
  281. package/test/trees/JBFundAccessLimits/surplusAllowancesOf.tree +8 -0
  282. package/test/trees/JBMetadataResolver/getDataFor.tree +8 -0
  283. package/test/trees/JBMultiTerminal/accountingContextsOf.tree +5 -0
  284. package/test/trees/JBMultiTerminal/addAccountingContextsFor.tree +10 -0
  285. package/test/trees/JBMultiTerminal/addToBalanceOf.tree +23 -0
  286. package/test/trees/JBMultiTerminal/cashOutTokensOf.tree +23 -0
  287. package/test/trees/JBMultiTerminal/executePayout.tree +32 -0
  288. package/test/trees/JBMultiTerminal/executeProcessFee.tree +14 -0
  289. package/test/trees/JBMultiTerminal/migrateBalanceOf.tree +12 -0
  290. package/test/trees/JBMultiTerminal/pay.tree +23 -0
  291. package/test/trees/JBMultiTerminal/processHeldFeesOf.tree +8 -0
  292. package/test/trees/JBMultiTerminal/sendPayoutsOf.tree +34 -0
  293. package/test/trees/JBMultiTerminal/useAllowanceOf.tree +16 -0
  294. package/test/trees/JBPermissions/hasPermission.tree +8 -0
  295. package/test/trees/JBPermissions/hasPermissions.tree +8 -0
  296. package/test/trees/JBPermissions/setPermissionsFor.tree +5 -0
  297. package/test/trees/JBPrices/addPriceFeedFor.tree +14 -0
  298. package/test/trees/JBPrices/pricePerUnitOf.tree +11 -0
  299. package/test/trees/JBProjects/createFor.tree +11 -0
  300. package/test/trees/JBProjects/setTokenUriResolver.tree +5 -0
  301. package/test/trees/JBProjects/supportsInterface.tree +9 -0
  302. package/test/trees/JBProjects/tokenURI.tree +5 -0
  303. package/test/trees/JBRulesets/currentApprovalStatusForLatestRulesetOf.tree +8 -0
  304. package/test/trees/JBRulesets/currentOf.tree +12 -0
  305. package/test/trees/JBRulesets/getRulesetOf.tree +5 -0
  306. package/test/trees/JBRulesets/latestQueuedRulesetOf.tree +10 -0
  307. package/test/trees/JBRulesets/rulesetsOf.tree +11 -0
  308. package/test/trees/JBRulesets/upcomingRulesetOf.tree +20 -0
  309. package/test/trees/JBRulesets/updateRulesetWeightCache.tree +5 -0
  310. package/test/trees/JBSplits/setSplitGroupsOf.tree +17 -0
  311. package/test/trees/JBSplits/splitsOf.tree +5 -0
  312. package/test/trees/JBTerminalStore/currentReclaimableSurplusOf.tree +16 -0
  313. package/test/trees/JBTerminalStore/currentSurplusOf.tree +25 -0
  314. package/test/trees/JBTerminalStore/currentTotalSurplusOf.tree +5 -0
  315. package/test/trees/JBTerminalStore/recordCashOutsFor.tree +16 -0
  316. package/test/trees/JBTerminalStore/recordPaymentFrom.tree +14 -0
  317. package/test/trees/JBTerminalStore/recordPayoutFor.tree +10 -0
  318. package/test/trees/JBTerminalStore/recordTerminalMigration.tree +5 -0
  319. package/test/trees/JBTerminalStore/recordUsedAllowanceOf.tree +10 -0
  320. package/test/trees/JBTokens/burnFrom.tree +10 -0
  321. package/test/trees/JBTokens/claimTokensFor.tree +10 -0
  322. package/test/trees/JBTokens/deployERC20For.tree +12 -0
  323. package/test/trees/JBTokens/mintFor.tree +10 -0
  324. package/test/trees/JBTokens/setTokenFor.tree +11 -0
  325. package/test/trees/JBTokens/totalBalanceOf.tree +5 -0
  326. package/test/trees/JBTokens/totalSupplyOf.tree +5 -0
  327. package/test/trees/JBTokens/transferCreditsFrom.tree +8 -0
  328. package/test/trees/mintTokensOf.tree +12 -0
  329. package/test/units/static/JBChainlinkV3PriceFeed/TestPriceFeed.sol +220 -0
  330. package/test/units/static/JBController/JBControllerSetup.sol +40 -0
  331. package/test/units/static/JBController/TestBurnTokensOf.sol +107 -0
  332. package/test/units/static/JBController/TestClaimTokensFor.sol +60 -0
  333. package/test/units/static/JBController/TestDeployErc20For.sol +80 -0
  334. package/test/units/static/JBController/TestLaunchProjectFor.sol +282 -0
  335. package/test/units/static/JBController/TestLaunchRulesetsFor.sol +322 -0
  336. package/test/units/static/JBController/TestMigrateController.sol +148 -0
  337. package/test/units/static/JBController/TestMintTokensOfUnits.sol +102 -0
  338. package/test/units/static/JBController/TestPayReservedTokenToTerminal.sol +71 -0
  339. package/test/units/static/JBController/TestReceiveMigrationFrom.sol +95 -0
  340. package/test/units/static/JBController/TestRulesetViews.sol +219 -0
  341. package/test/units/static/JBController/TestSendReservedTokensToSplitsOf.sol +595 -0
  342. package/test/units/static/JBController/TestSetSplitGroupsOf.sol +63 -0
  343. package/test/units/static/JBController/TestSetTokenFor.sol +227 -0
  344. package/test/units/static/JBController/TestSetUriOf.sol +53 -0
  345. package/test/units/static/JBController/TestTransferCreditsFrom.sol +159 -0
  346. package/test/units/static/JBDeadline/TestDeadlineFuzz.sol +194 -0
  347. package/test/units/static/JBDirectory/JBDirectorySetup.sol +22 -0
  348. package/test/units/static/JBDirectory/TestPrimaryTerminalOf.sol +122 -0
  349. package/test/units/static/JBDirectory/TestSetControllerOf.sol +173 -0
  350. package/test/units/static/JBDirectory/TestSetControllerOfMigrationOrder.sol +98 -0
  351. package/test/units/static/JBDirectory/TestSetPrimaryTerminalOf.sol +169 -0
  352. package/test/units/static/JBDirectory/TestSetTerminalsOf.sol +128 -0
  353. package/test/units/static/JBERC20/JBERC20Setup.sol +20 -0
  354. package/test/units/static/JBERC20/SigUtils.sol +34 -0
  355. package/test/units/static/JBERC20/TestInitialize.sol +54 -0
  356. package/test/units/static/JBERC20/TestName.sol +30 -0
  357. package/test/units/static/JBERC20/TestNonces.sol +59 -0
  358. package/test/units/static/JBERC20/TestSymbol.sol +31 -0
  359. package/test/units/static/JBFeelessAdresses/JBFeelessSetup.sol +20 -0
  360. package/test/units/static/JBFeelessAdresses/TestInterfaces.sol +29 -0
  361. package/test/units/static/JBFeelessAdresses/TestSetFeelessAddress.sol +35 -0
  362. package/test/units/static/JBFees/TestFeesFuzz.sol +78 -0
  363. package/test/units/static/JBFixedPointNumber/TestAdjustDecimals.sol +16 -0
  364. package/test/units/static/JBFixedPointNumber/TestAdjustDecimalsFuzz.sol +71 -0
  365. package/test/units/static/JBFundAccessLimits/JBFundAccessSetup.sol +21 -0
  366. package/test/units/static/JBFundAccessLimits/TestFundAccessLimitsEdge.sol +159 -0
  367. package/test/units/static/JBFundAccessLimits/TestPayoutLimitOf.sol +56 -0
  368. package/test/units/static/JBFundAccessLimits/TestPayoutLimitsOf.sol +94 -0
  369. package/test/units/static/JBFundAccessLimits/TestSetFundAccessLimitsFor.sol +182 -0
  370. package/test/units/static/JBFundAccessLimits/TestSurplusAllowanceOf.sol +61 -0
  371. package/test/units/static/JBFundAccessLimits/TestSurplusAllowancesOf.sol +96 -0
  372. package/test/units/static/JBMetadataResolver/TestGetDataFor.sol +89 -0
  373. package/test/units/static/JBMetadataResolver/TestMetadataResolverFuzz.sol +227 -0
  374. package/test/units/static/JBMetadataResolver/TestMetadataResolverM20M21.sol +245 -0
  375. package/test/units/static/JBMultiTerminal/JBMultiTerminalSetup.sol +39 -0
  376. package/test/units/static/JBMultiTerminal/TestAccountingContextsOf.sol +65 -0
  377. package/test/units/static/JBMultiTerminal/TestAddAccountingContextsFor.sol +313 -0
  378. package/test/units/static/JBMultiTerminal/TestAddToBalanceOf.sol +432 -0
  379. package/test/units/static/JBMultiTerminal/TestCashOutTokensOf.sol +478 -0
  380. package/test/units/static/JBMultiTerminal/TestExecutePayout.sol +577 -0
  381. package/test/units/static/JBMultiTerminal/TestExecuteProcessFee.sol +176 -0
  382. package/test/units/static/JBMultiTerminal/TestMigrateBalanceOf.sol +190 -0
  383. package/test/units/static/JBMultiTerminal/TestPay.sol +514 -0
  384. package/test/units/static/JBMultiTerminal/TestProcessHeldFeesOf.sol +29 -0
  385. package/test/units/static/JBMultiTerminal/TestSendPayoutsOf.sol +243 -0
  386. package/test/units/static/JBMultiTerminal/TestUseAllowanceOf.sol +310 -0
  387. package/test/units/static/JBPermissions/JBPermissionsSetup.sol +18 -0
  388. package/test/units/static/JBPermissions/TestHasPermission.sol +50 -0
  389. package/test/units/static/JBPermissions/TestHasPermissions.sol +93 -0
  390. package/test/units/static/JBPermissions/TestSetPermissionsFor.sol +62 -0
  391. package/test/units/static/JBPrices/JBPricesSetup.sol +26 -0
  392. package/test/units/static/JBPrices/TestAddPriceFeedFor.sol +102 -0
  393. package/test/units/static/JBPrices/TestPricePerUnitOf.sol +129 -0
  394. package/test/units/static/JBPrices/TestPrices.sol +262 -0
  395. package/test/units/static/JBProjects/JBProjectsSetup.sol +20 -0
  396. package/test/units/static/JBProjects/TestCreateFor.sol +69 -0
  397. package/test/units/static/JBProjects/TestInitialProject.sol +19 -0
  398. package/test/units/static/JBProjects/TestInterfaces.sol +27 -0
  399. package/test/units/static/JBProjects/TestSetResolver.sol +36 -0
  400. package/test/units/static/JBProjects/TestTokenUri.sol +38 -0
  401. package/test/units/static/JBRulesetMetadataResolver/TestSetCashOutTaxRateTo.sol +99 -0
  402. package/test/units/static/JBRulesets/JBRulesetsSetup.sol +21 -0
  403. package/test/units/static/JBRulesets/TestCurrentApprovalStatusForLatestRulesetOf.sol +257 -0
  404. package/test/units/static/JBRulesets/TestCurrentOf.sol +231 -0
  405. package/test/units/static/JBRulesets/TestGetRulesetOf.sol +94 -0
  406. package/test/units/static/JBRulesets/TestLatestQueuedRulesetOf.sol +252 -0
  407. package/test/units/static/JBRulesets/TestRulesets.sol +617 -0
  408. package/test/units/static/JBRulesets/TestRulesetsOf.sol +37 -0
  409. package/test/units/static/JBRulesets/TestUpcomingRulesetOf.sol +526 -0
  410. package/test/units/static/JBRulesets/TestUpdateRulesetWeightCache.sol +91 -0
  411. package/test/units/static/JBSplits/JBSplitsSetup.sol +23 -0
  412. package/test/units/static/JBSplits/TestSelfManagedSplitGroups.sol +502 -0
  413. package/test/units/static/JBSplits/TestSetSplitGroupsOf.sol +370 -0
  414. package/test/units/static/JBSplits/TestSplitsLockedEdge.sol +262 -0
  415. package/test/units/static/JBSplits/TestSplitsOf.sol +24 -0
  416. package/test/units/static/JBSplits/TestSplitsPacking.sol +33 -0
  417. package/test/units/static/JBSurplus/TestSurplusFuzz.sol +125 -0
  418. package/test/units/static/JBTerminalStore/JBTerminalStoreSetup.sol +23 -0
  419. package/test/units/static/JBTerminalStore/TestCurrentReclaimableSurplusOf.sol +434 -0
  420. package/test/units/static/JBTerminalStore/TestCurrentSurplusOf.sol +428 -0
  421. package/test/units/static/JBTerminalStore/TestCurrentTotalSurplusOf.sol +65 -0
  422. package/test/units/static/JBTerminalStore/TestRecordCashOutsFor.sol +479 -0
  423. package/test/units/static/JBTerminalStore/TestRecordPaymentFrom.sol +508 -0
  424. package/test/units/static/JBTerminalStore/TestRecordPayoutFor.sol +257 -0
  425. package/test/units/static/JBTerminalStore/TestRecordTerminalMigration.sol +131 -0
  426. package/test/units/static/JBTerminalStore/TestRecordUsedAllowanceOf.sol +390 -0
  427. package/test/units/static/JBTerminalStore/TestUint224Overflow.sol +187 -0
  428. package/test/units/static/JBTokens/JBTokensSetup.sol +23 -0
  429. package/test/units/static/JBTokens/TestBurnFrom.sol +104 -0
  430. package/test/units/static/JBTokens/TestClaimTokensFor.sol +107 -0
  431. package/test/units/static/JBTokens/TestDeployERC20ForUnits.sol +89 -0
  432. package/test/units/static/JBTokens/TestMintFor.sol +97 -0
  433. package/test/units/static/JBTokens/TestSetTokenFor.sol +95 -0
  434. package/test/units/static/JBTokens/TestTotalBalanceOf.sol +65 -0
  435. package/test/units/static/JBTokens/TestTotalSupplyOf.sol +56 -0
  436. package/test/units/static/JBTokens/TestTransferCreditsFrom.sol +54 -0
@@ -0,0 +1,699 @@
1
+ // SPDX-License-Identifier: MIT
2
+ pragma solidity ^0.8.6;
3
+
4
+ import /* {*} from */ "./helpers/TestBaseWorkflow.sol";
5
+ import {JBAccountingContext} from "../src/structs/JBAccountingContext.sol";
6
+ import {ERC165, IERC165} from "@openzeppelin/contracts/utils/introspection/ERC165.sol";
7
+
8
+ /// @notice Tests for ruleset transition edge cases: boundary timing, weight decay, approval hooks, limit resets.
9
+ contract RulesetTransitions_Local is TestBaseWorkflow {
10
+ using JBRulesetMetadataResolver for JBRuleset;
11
+
12
+ address public projectOwner;
13
+
14
+ function setUp() public override {
15
+ super.setUp();
16
+ projectOwner = multisig();
17
+
18
+ // Launch fee collector project (#1)
19
+ _launchFeeProject();
20
+ }
21
+
22
+ // ═══════════════════════════════════════════════════════════════════
23
+ // Helpers
24
+ // ═══════════════════════════════════════════════════════════════════
25
+
26
+ function _launchFeeProject() internal {
27
+ JBRulesetConfig[] memory feeRulesetConfig = new JBRulesetConfig[](1);
28
+ feeRulesetConfig[0].mustStartAtOrAfter = 0;
29
+ feeRulesetConfig[0].duration = 0;
30
+ feeRulesetConfig[0].weight = 1000e18;
31
+ feeRulesetConfig[0].weightCutPercent = 0;
32
+ feeRulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
33
+ feeRulesetConfig[0].metadata = JBRulesetMetadata({
34
+ reservedPercent: 0,
35
+ cashOutTaxRate: 0,
36
+ baseCurrency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
37
+ pausePay: false,
38
+ pauseCreditTransfers: false,
39
+ allowOwnerMinting: false,
40
+ allowSetCustomToken: false,
41
+ allowTerminalMigration: false,
42
+ allowSetTerminals: false,
43
+ ownerMustSendPayouts: false,
44
+ allowSetController: false,
45
+ allowAddAccountingContext: true,
46
+ allowAddPriceFeed: false,
47
+ holdFees: false,
48
+ useTotalSurplusForCashOuts: false,
49
+ useDataHookForPay: false,
50
+ useDataHookForCashOut: false,
51
+ dataHook: address(0),
52
+ metadata: 0
53
+ });
54
+ feeRulesetConfig[0].splitGroups = new JBSplitGroup[](0);
55
+ feeRulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
56
+
57
+ JBTerminalConfig[] memory terminalConfigurations = _defaultTerminalConfig();
58
+
59
+ jbController()
60
+ .launchProjectFor({
61
+ owner: address(420),
62
+ projectUri: "feeCollector",
63
+ rulesetConfigurations: feeRulesetConfig,
64
+ terminalConfigurations: terminalConfigurations,
65
+ memo: ""
66
+ });
67
+ }
68
+
69
+ function _defaultTerminalConfig() internal view returns (JBTerminalConfig[] memory) {
70
+ JBTerminalConfig[] memory terminalConfigurations = new JBTerminalConfig[](1);
71
+ JBAccountingContext[] memory tokensToAccept = new JBAccountingContext[](1);
72
+ tokensToAccept[0] = JBAccountingContext({
73
+ token: JBConstants.NATIVE_TOKEN, decimals: 18, currency: uint32(uint160(JBConstants.NATIVE_TOKEN))
74
+ });
75
+ terminalConfigurations[0] =
76
+ JBTerminalConfig({terminal: jbMultiTerminal(), accountingContextsToAccept: tokensToAccept});
77
+ return terminalConfigurations;
78
+ }
79
+
80
+ function _defaultMetadata() internal pure returns (JBRulesetMetadata memory) {
81
+ return JBRulesetMetadata({
82
+ reservedPercent: 0,
83
+ cashOutTaxRate: 0,
84
+ baseCurrency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
85
+ pausePay: false,
86
+ pauseCreditTransfers: false,
87
+ allowOwnerMinting: true,
88
+ allowSetCustomToken: true,
89
+ allowTerminalMigration: false,
90
+ allowSetTerminals: false,
91
+ ownerMustSendPayouts: false,
92
+ allowSetController: false,
93
+ allowAddAccountingContext: true,
94
+ allowAddPriceFeed: false,
95
+ holdFees: false,
96
+ useTotalSurplusForCashOuts: false,
97
+ useDataHookForPay: false,
98
+ useDataHookForCashOut: false,
99
+ dataHook: address(0),
100
+ metadata: 0
101
+ });
102
+ }
103
+
104
+ function _payProject(uint256 pid, address payer, uint256 amount) internal returns (uint256) {
105
+ vm.deal(payer, amount);
106
+ vm.prank(payer);
107
+ return jbMultiTerminal().pay{value: amount}({
108
+ projectId: pid,
109
+ token: JBConstants.NATIVE_TOKEN,
110
+ amount: amount,
111
+ beneficiary: payer,
112
+ minReturnedTokens: 0,
113
+ memo: "",
114
+ metadata: new bytes(0)
115
+ });
116
+ }
117
+
118
+ // ═══════════════════════════════════════════════════════════════════
119
+ // Test 1: Pay at cycle boundary — different weights
120
+ // ═══════════════════════════════════════════════════════════════════
121
+
122
+ function test_rulesetTransition_payAtBoundary() public {
123
+ // Launch with 7-day duration, 50% weight cut
124
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
125
+ rulesetConfig[0].mustStartAtOrAfter = 0;
126
+ rulesetConfig[0].duration = 7 days;
127
+ rulesetConfig[0].weight = 1000e18;
128
+ rulesetConfig[0].weightCutPercent = uint32(JBConstants.MAX_WEIGHT_CUT_PERCENT / 2); // 50%
129
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
130
+ rulesetConfig[0].metadata = _defaultMetadata();
131
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
132
+ rulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
133
+
134
+ uint256 pid = jbController()
135
+ .launchProjectFor({
136
+ owner: projectOwner,
137
+ projectUri: "boundaryTest",
138
+ rulesetConfigurations: rulesetConfig,
139
+ terminalConfigurations: _defaultTerminalConfig(),
140
+ memo: ""
141
+ });
142
+
143
+ // Pay at last second of cycle 1
144
+ vm.warp(block.timestamp + 7 days - 1);
145
+ uint256 tokensCycle1 = _payProject(pid, address(0xA11CE), 1 ether);
146
+
147
+ // Pay at first second of cycle 2
148
+ vm.warp(block.timestamp + 2); // crosses boundary
149
+ uint256 tokensCycle2 = _payProject(pid, address(0xB0B), 1 ether);
150
+
151
+ // Cycle 2 has 50% of cycle 1's weight → should mint half the tokens
152
+ assertGt(tokensCycle1, tokensCycle2, "Cycle 2 should mint fewer tokens due to weight cut");
153
+ // With 50% cut: cycle2 tokens should be ~half of cycle1
154
+ assertApproxEqRel(tokensCycle2, tokensCycle1 / 2, 0.01e18, "Cycle 2 tokens should be ~50% of cycle 1");
155
+ }
156
+
157
+ // ═══════════════════════════════════════════════════════════════════
158
+ // Test 2: Cash out across cycles — uses current tax rate
159
+ // ═══════════════════════════════════════════════════════════════════
160
+
161
+ function test_rulesetTransition_cashOutAcrossCycles() public {
162
+ // Cycle 1: 0% tax. Queue cycle 2: 90% tax
163
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
164
+ rulesetConfig[0].mustStartAtOrAfter = 0;
165
+ rulesetConfig[0].duration = 7 days;
166
+ rulesetConfig[0].weight = 1000e18;
167
+ rulesetConfig[0].weightCutPercent = 0;
168
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
169
+ rulesetConfig[0].metadata = _defaultMetadata();
170
+ rulesetConfig[0].metadata.cashOutTaxRate = 0;
171
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
172
+ rulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
173
+
174
+ uint256 pid = jbController()
175
+ .launchProjectFor({
176
+ owner: projectOwner,
177
+ projectUri: "cashOutCycleTest",
178
+ rulesetConfigurations: rulesetConfig,
179
+ terminalConfigurations: _defaultTerminalConfig(),
180
+ memo: ""
181
+ });
182
+
183
+ // Pay in cycle 1
184
+ address alice = address(0xA11CE);
185
+ uint256 aliceTokens = _payProject(pid, alice, 10 ether);
186
+
187
+ // Queue new ruleset with 90% cashOutTaxRate
188
+ JBRulesetConfig[] memory newConfig = new JBRulesetConfig[](1);
189
+ newConfig[0].mustStartAtOrAfter = 0;
190
+ newConfig[0].duration = 7 days;
191
+ newConfig[0].weight = 1000e18;
192
+ newConfig[0].weightCutPercent = 0;
193
+ newConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
194
+ newConfig[0].metadata = _defaultMetadata();
195
+ newConfig[0].metadata.cashOutTaxRate = 9000; // 90%
196
+ newConfig[0].splitGroups = new JBSplitGroup[](0);
197
+ newConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
198
+
199
+ vm.prank(projectOwner);
200
+ jbController().queueRulesetsOf(pid, newConfig, "");
201
+
202
+ // Advance to cycle 2
203
+ vm.warp(block.timestamp + 7 days + 1);
204
+
205
+ // Pay in second payer so Alice isn't the sole holder (tax has no effect on 100% cashout)
206
+ address bob = address(0xB0B);
207
+ _payProject(pid, bob, 10 ether);
208
+
209
+ // Cash out Alice in cycle 2 — should use the new 90% tax rate
210
+ vm.prank(alice);
211
+ uint256 reclaimAmount = jbMultiTerminal()
212
+ .cashOutTokensOf({
213
+ holder: alice,
214
+ projectId: pid,
215
+ cashOutCount: aliceTokens,
216
+ tokenToReclaim: JBConstants.NATIVE_TOKEN,
217
+ minTokensReclaimed: 0,
218
+ beneficiary: payable(alice),
219
+ metadata: new bytes(0)
220
+ });
221
+
222
+ // With 90% tax on partial cashout (50% of supply), reclaim is significantly reduced
223
+ // The bonding curve formula penalizes partial cashouts with high tax
224
+ assertLt(reclaimAmount, 10 ether, "90% tax should reduce reclaim below payment amount");
225
+ }
226
+
227
+ // ═══════════════════════════════════════════════════════════════════
228
+ // Test 3: Weight decay — 10 cycles accuracy
229
+ // ═══════════════════════════════════════════════════════════════════
230
+
231
+ function test_weightDecay_multiCycle_accuracy() public {
232
+ // 10% weight cut per cycle
233
+ uint32 tenPercentCut = uint32(JBConstants.MAX_WEIGHT_CUT_PERCENT / 10);
234
+
235
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
236
+ rulesetConfig[0].mustStartAtOrAfter = 0;
237
+ rulesetConfig[0].duration = 1 days;
238
+ rulesetConfig[0].weight = 1000e18;
239
+ rulesetConfig[0].weightCutPercent = tenPercentCut;
240
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
241
+ rulesetConfig[0].metadata = _defaultMetadata();
242
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
243
+ rulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
244
+
245
+ uint256 pid = jbController()
246
+ .launchProjectFor({
247
+ owner: projectOwner,
248
+ projectUri: "decayTest",
249
+ rulesetConfigurations: rulesetConfig,
250
+ terminalConfigurations: _defaultTerminalConfig(),
251
+ memo: ""
252
+ });
253
+
254
+ // Record tokens minted per cycle
255
+ uint256[] memory tokensPerCycle = new uint256[](10);
256
+ for (uint256 i = 0; i < 10; i++) {
257
+ if (i > 0) vm.warp(block.timestamp + 1 days + 1);
258
+ tokensPerCycle[i] = _payProject(pid, address(uint160(0x6000 + i)), 1 ether);
259
+ }
260
+
261
+ // Each cycle should mint ~90% of previous
262
+ for (uint256 i = 1; i < 10; i++) {
263
+ assertLt(tokensPerCycle[i], tokensPerCycle[i - 1], "Each cycle should mint fewer tokens");
264
+ // Within 1% tolerance of 90% ratio
265
+ uint256 expectedRatio = 900; // 90%
266
+ uint256 actualRatio = (tokensPerCycle[i] * 1000) / tokensPerCycle[i - 1];
267
+ assertApproxEqAbs(actualRatio, expectedRatio, 5, "Weight decay ratio should be ~90%");
268
+ }
269
+
270
+ // After 10 cycles (9 weight transitions): weight ≈ 1000 * 0.9^9 ≈ 387.42
271
+ // Cycle 10 tokens should be roughly 38.74% of cycle 1
272
+ uint256 ratio = (tokensPerCycle[9] * 10_000) / tokensPerCycle[0];
273
+ assertApproxEqAbs(ratio, 3874, 50, "After 9 weight transitions, weight should be ~38.74% of original");
274
+ }
275
+
276
+ // ═══════════════════════════════════════════════════════════════════
277
+ // Test 4: 100% weight cut kills weight
278
+ // ═══════════════════════════════════════════════════════════════════
279
+
280
+ function test_weightDecay_100percent_killsWeight() public {
281
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
282
+ rulesetConfig[0].mustStartAtOrAfter = 0;
283
+ rulesetConfig[0].duration = 1 days;
284
+ rulesetConfig[0].weight = 1000e18;
285
+ rulesetConfig[0].weightCutPercent = uint32(JBConstants.MAX_WEIGHT_CUT_PERCENT); // 100%
286
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
287
+ rulesetConfig[0].metadata = _defaultMetadata();
288
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
289
+ rulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
290
+
291
+ uint256 pid = jbController()
292
+ .launchProjectFor({
293
+ owner: projectOwner,
294
+ projectUri: "killWeightTest",
295
+ rulesetConfigurations: rulesetConfig,
296
+ terminalConfigurations: _defaultTerminalConfig(),
297
+ memo: ""
298
+ });
299
+
300
+ // Cycle 1: normal minting
301
+ uint256 cycle1Tokens = _payProject(pid, address(0xA11CE), 1 ether);
302
+ assertGt(cycle1Tokens, 0, "Cycle 1 should mint tokens");
303
+
304
+ // Advance to cycle 2
305
+ vm.warp(block.timestamp + 1 days + 1);
306
+
307
+ // Cycle 2: weight should be 0 → mint 0 tokens
308
+ uint256 cycle2Tokens = _payProject(pid, address(0xB0B), 1 ether);
309
+ assertEq(cycle2Tokens, 0, "100% weight cut should mint 0 tokens in cycle 2");
310
+ }
311
+
312
+ // ═══════════════════════════════════════════════════════════════════
313
+ // Test 5: Queued ruleset overrides auto-cycle
314
+ // ═══════════════════════════════════════════════════════════════════
315
+
316
+ function test_queuedRuleset_overridesAutoCycle() public {
317
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
318
+ rulesetConfig[0].mustStartAtOrAfter = 0;
319
+ rulesetConfig[0].duration = 7 days;
320
+ rulesetConfig[0].weight = 1000e18;
321
+ rulesetConfig[0].weightCutPercent = uint32(JBConstants.MAX_WEIGHT_CUT_PERCENT / 2); // 50%
322
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
323
+ rulesetConfig[0].metadata = _defaultMetadata();
324
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
325
+ rulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
326
+
327
+ uint256 pid = jbController()
328
+ .launchProjectFor({
329
+ owner: projectOwner,
330
+ projectUri: "queueOverrideTest",
331
+ rulesetConfigurations: rulesetConfig,
332
+ terminalConfigurations: _defaultTerminalConfig(),
333
+ memo: ""
334
+ });
335
+
336
+ // Queue a new ruleset with different weight (2000e18 instead of auto-decayed 500e18)
337
+ JBRulesetConfig[] memory newConfig = new JBRulesetConfig[](1);
338
+ newConfig[0].mustStartAtOrAfter = 0;
339
+ newConfig[0].duration = 7 days;
340
+ newConfig[0].weight = 2000e18;
341
+ newConfig[0].weightCutPercent = 0;
342
+ newConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
343
+ newConfig[0].metadata = _defaultMetadata();
344
+ newConfig[0].splitGroups = new JBSplitGroup[](0);
345
+ newConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
346
+
347
+ vm.prank(projectOwner);
348
+ jbController().queueRulesetsOf(pid, newConfig, "");
349
+
350
+ // Advance to cycle 2
351
+ vm.warp(block.timestamp + 7 days + 1);
352
+
353
+ // Pay — should use queued weight (2000e18), not auto-decayed (500e18)
354
+ uint256 tokens = _payProject(pid, address(0xA11CE), 1 ether);
355
+
356
+ // With weight 2000e18 and 1 ETH, should get 2000 tokens
357
+ assertEq(tokens, 2000e18, "Queued ruleset weight should override auto-cycle decay");
358
+ }
359
+
360
+ // ═══════════════════════════════════════════════════════════════════
361
+ // Test 6: Approval hook — pending to approved
362
+ // ═══════════════════════════════════════════════════════════════════
363
+
364
+ function test_approvalHook_pendingToApproved() public {
365
+ DelayedApprovalHook approvalHook = new DelayedApprovalHook(3 days);
366
+
367
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
368
+ rulesetConfig[0].mustStartAtOrAfter = 0;
369
+ rulesetConfig[0].duration = 7 days;
370
+ rulesetConfig[0].weight = 1000e18;
371
+ rulesetConfig[0].weightCutPercent = 0;
372
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(approvalHook));
373
+ rulesetConfig[0].metadata = _defaultMetadata();
374
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
375
+ rulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
376
+
377
+ uint256 pid = jbController()
378
+ .launchProjectFor({
379
+ owner: projectOwner,
380
+ projectUri: "approvalTest",
381
+ rulesetConfigurations: rulesetConfig,
382
+ terminalConfigurations: _defaultTerminalConfig(),
383
+ memo: ""
384
+ });
385
+
386
+ // Queue a new ruleset
387
+ JBRulesetConfig[] memory newConfig = new JBRulesetConfig[](1);
388
+ newConfig[0].mustStartAtOrAfter = 0;
389
+ newConfig[0].duration = 7 days;
390
+ newConfig[0].weight = 2000e18;
391
+ newConfig[0].weightCutPercent = 0;
392
+ newConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
393
+ newConfig[0].metadata = _defaultMetadata();
394
+ newConfig[0].splitGroups = new JBSplitGroup[](0);
395
+ newConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
396
+
397
+ vm.prank(projectOwner);
398
+ jbController().queueRulesetsOf(pid, newConfig, "");
399
+
400
+ // Check status before approval period
401
+ (,, JBApprovalStatus statusBefore) = jbController().latestQueuedRulesetOf(pid);
402
+ // Status should be ApprovalExpected (pending)
403
+ assertTrue(
404
+ statusBefore == JBApprovalStatus.ApprovalExpected || statusBefore == JBApprovalStatus.Approved,
405
+ "Status should be ApprovalExpected or Approved initially"
406
+ );
407
+
408
+ // Advance past approval delay (3 days)
409
+ vm.warp(block.timestamp + 4 days);
410
+
411
+ // Status should now be Approved
412
+ (,, JBApprovalStatus statusAfter) = jbController().latestQueuedRulesetOf(pid);
413
+ assertEq(uint256(statusAfter), uint256(JBApprovalStatus.Approved), "Status should be Approved after delay");
414
+ }
415
+
416
+ // ═══════════════════════════════════════════════════════════════════
417
+ // Test 7: Approval hook — rejected falls back
418
+ // ═══════════════════════════════════════════════════════════════════
419
+
420
+ function test_approvalHook_rejected_fallsBack() public {
421
+ AlwaysRejectingHook rejectHook = new AlwaysRejectingHook();
422
+
423
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
424
+ rulesetConfig[0].mustStartAtOrAfter = 0;
425
+ rulesetConfig[0].duration = 7 days;
426
+ rulesetConfig[0].weight = 1000e18;
427
+ rulesetConfig[0].weightCutPercent = 0;
428
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(rejectHook));
429
+ rulesetConfig[0].metadata = _defaultMetadata();
430
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
431
+ rulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
432
+
433
+ uint256 pid = jbController()
434
+ .launchProjectFor({
435
+ owner: projectOwner,
436
+ projectUri: "rejectTest",
437
+ rulesetConfigurations: rulesetConfig,
438
+ terminalConfigurations: _defaultTerminalConfig(),
439
+ memo: ""
440
+ });
441
+
442
+ // Queue a new ruleset with different weight
443
+ JBRulesetConfig[] memory newConfig = new JBRulesetConfig[](1);
444
+ newConfig[0].mustStartAtOrAfter = 0;
445
+ newConfig[0].duration = 7 days;
446
+ newConfig[0].weight = 5000e18;
447
+ newConfig[0].weightCutPercent = 0;
448
+ newConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
449
+ newConfig[0].metadata = _defaultMetadata();
450
+ newConfig[0].splitGroups = new JBSplitGroup[](0);
451
+ newConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
452
+
453
+ vm.prank(projectOwner);
454
+ jbController().queueRulesetsOf(pid, newConfig, "");
455
+
456
+ // Advance to cycle 2
457
+ vm.warp(block.timestamp + 7 days + 1);
458
+
459
+ // Pay — should use the fallback (cycle 1 auto-repeated), not the rejected queued ruleset
460
+ uint256 tokens = _payProject(pid, address(0xA11CE), 1 ether);
461
+
462
+ // Should still get 1000 tokens (cycle 1 weight, not 5000)
463
+ assertEq(tokens, 1000e18, "Rejected ruleset should fall back to repeating previous cycle");
464
+ }
465
+
466
+ // ═══════════════════════════════════════════════════════════════════
467
+ // Test 8: Payout limit resets at cycle boundary
468
+ // ═══════════════════════════════════════════════════════════════════
469
+
470
+ function test_rulesetTransition_payoutLimitReset() public {
471
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
472
+ rulesetConfig[0].mustStartAtOrAfter = 0;
473
+ rulesetConfig[0].duration = 7 days;
474
+ rulesetConfig[0].weight = 1000e18;
475
+ rulesetConfig[0].weightCutPercent = 0;
476
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
477
+ rulesetConfig[0].metadata = _defaultMetadata();
478
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
479
+
480
+ JBCurrencyAmount[] memory payoutLimits = new JBCurrencyAmount[](1);
481
+ payoutLimits[0] = JBCurrencyAmount({amount: 5 ether, currency: uint32(uint160(JBConstants.NATIVE_TOKEN))});
482
+ JBFundAccessLimitGroup[] memory fundAccessLimitGroups = new JBFundAccessLimitGroup[](1);
483
+ fundAccessLimitGroups[0] = JBFundAccessLimitGroup({
484
+ terminal: address(jbMultiTerminal()),
485
+ token: JBConstants.NATIVE_TOKEN,
486
+ payoutLimits: payoutLimits,
487
+ surplusAllowances: new JBCurrencyAmount[](0)
488
+ });
489
+ rulesetConfig[0].fundAccessLimitGroups = fundAccessLimitGroups;
490
+
491
+ uint256 pid = jbController()
492
+ .launchProjectFor({
493
+ owner: projectOwner,
494
+ projectUri: "payoutLimitResetTest",
495
+ rulesetConfigurations: rulesetConfig,
496
+ terminalConfigurations: _defaultTerminalConfig(),
497
+ memo: ""
498
+ });
499
+
500
+ // Fund generously
501
+ _payProject(pid, address(0xBA1E), 100 ether);
502
+
503
+ // Use full payout limit in cycle 1
504
+ vm.prank(projectOwner);
505
+ jbMultiTerminal()
506
+ .sendPayoutsOf({
507
+ projectId: pid,
508
+ token: JBConstants.NATIVE_TOKEN,
509
+ amount: 5 ether,
510
+ currency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
511
+ minTokensPaidOut: 0
512
+ });
513
+
514
+ // Try to send more — should fail (limit exhausted)
515
+ vm.prank(projectOwner);
516
+ vm.expectRevert();
517
+ jbMultiTerminal()
518
+ .sendPayoutsOf({
519
+ projectId: pid,
520
+ token: JBConstants.NATIVE_TOKEN,
521
+ amount: 1 ether,
522
+ currency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
523
+ minTokensPaidOut: 0
524
+ });
525
+
526
+ // Advance to cycle 2
527
+ vm.warp(block.timestamp + 7 days + 1);
528
+
529
+ // Payout limit should be reset — can send again
530
+ vm.prank(projectOwner);
531
+ jbMultiTerminal()
532
+ .sendPayoutsOf({
533
+ projectId: pid,
534
+ token: JBConstants.NATIVE_TOKEN,
535
+ amount: 5 ether,
536
+ currency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
537
+ minTokensPaidOut: 0
538
+ });
539
+
540
+ // If we got here, limit was successfully reset
541
+ assertTrue(true, "Payout limit reset at cycle boundary");
542
+ }
543
+
544
+ // ═══════════════════════════════════════════════════════════════════
545
+ // Test 9: Tax rate change across cycles
546
+ // ═══════════════════════════════════════════════════════════════════
547
+
548
+ function test_rulesetTransition_changeTaxRate() public {
549
+ // Cycle 1: 0% tax
550
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
551
+ rulesetConfig[0].mustStartAtOrAfter = 0;
552
+ rulesetConfig[0].duration = 7 days;
553
+ rulesetConfig[0].weight = 1000e18;
554
+ rulesetConfig[0].weightCutPercent = 0;
555
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
556
+ rulesetConfig[0].metadata = _defaultMetadata();
557
+ rulesetConfig[0].metadata.cashOutTaxRate = 0;
558
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
559
+ rulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
560
+
561
+ uint256 pid = jbController()
562
+ .launchProjectFor({
563
+ owner: projectOwner,
564
+ projectUri: "taxRateChangeTest",
565
+ rulesetConfigurations: rulesetConfig,
566
+ terminalConfigurations: _defaultTerminalConfig(),
567
+ memo: ""
568
+ });
569
+
570
+ // Pay in cycle 1
571
+ address alice = address(0xA11CE);
572
+ uint256 aliceTokens = _payProject(pid, alice, 10 ether);
573
+
574
+ // Queue cycle 2: 90% tax
575
+ JBRulesetConfig[] memory newConfig = new JBRulesetConfig[](1);
576
+ newConfig[0].mustStartAtOrAfter = 0;
577
+ newConfig[0].duration = 7 days;
578
+ newConfig[0].weight = 1000e18;
579
+ newConfig[0].weightCutPercent = 0;
580
+ newConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
581
+ newConfig[0].metadata = _defaultMetadata();
582
+ newConfig[0].metadata.cashOutTaxRate = 9000; // 90%
583
+ newConfig[0].splitGroups = new JBSplitGroup[](0);
584
+ newConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
585
+
586
+ vm.prank(projectOwner);
587
+ jbController().queueRulesetsOf(pid, newConfig, "");
588
+
589
+ // Advance to cycle 2
590
+ vm.warp(block.timestamp + 7 days + 1);
591
+
592
+ // Add a second payer so Alice isn't the sole holder (tax has no effect on 100% cashout)
593
+ address bob = address(0xB0B);
594
+ _payProject(pid, bob, 10 ether);
595
+
596
+ // Cash out Alice's cycle-1 tokens in cycle 2 with 90% tax
597
+ vm.prank(alice);
598
+ uint256 reclaimAmount = jbMultiTerminal()
599
+ .cashOutTokensOf({
600
+ holder: alice,
601
+ projectId: pid,
602
+ cashOutCount: aliceTokens,
603
+ tokenToReclaim: JBConstants.NATIVE_TOKEN,
604
+ minTokensReclaimed: 0,
605
+ beneficiary: payable(alice),
606
+ metadata: new bytes(0)
607
+ });
608
+
609
+ // With 90% tax on partial cashout, reclaim is reduced below payment
610
+ assertLt(reclaimAmount, 10 ether, "Tokens minted in cycle 1 should get reduced reclaim under cycle 2's 90% tax");
611
+ }
612
+
613
+ // ═══════════════════════════════════════════════════════════════════
614
+ // Test 10: duration=0 means same ruleset forever
615
+ // ═══════════════════════════════════════════════════════════════════
616
+
617
+ function test_rulesetTransition_durationZero_neverCycles() public {
618
+ JBRulesetConfig[] memory rulesetConfig = new JBRulesetConfig[](1);
619
+ rulesetConfig[0].mustStartAtOrAfter = 0;
620
+ rulesetConfig[0].duration = 0; // Never cycles
621
+ rulesetConfig[0].weight = 1000e18;
622
+ rulesetConfig[0].weightCutPercent = uint32(JBConstants.MAX_WEIGHT_CUT_PERCENT / 2); // 50% cut would apply if it
623
+ // cycled
624
+ rulesetConfig[0].approvalHook = IJBRulesetApprovalHook(address(0));
625
+ rulesetConfig[0].metadata = _defaultMetadata();
626
+ rulesetConfig[0].splitGroups = new JBSplitGroup[](0);
627
+ rulesetConfig[0].fundAccessLimitGroups = new JBFundAccessLimitGroup[](0);
628
+
629
+ uint256 pid = jbController()
630
+ .launchProjectFor({
631
+ owner: projectOwner,
632
+ projectUri: "noCycleTest",
633
+ rulesetConfigurations: rulesetConfig,
634
+ terminalConfigurations: _defaultTerminalConfig(),
635
+ memo: ""
636
+ });
637
+
638
+ // Pay now
639
+ uint256 tokensNow = _payProject(pid, address(0xA11CE), 1 ether);
640
+
641
+ // Advance far into the future
642
+ vm.warp(block.timestamp + 365 days);
643
+
644
+ // Pay again — should still use same weight (no cycling)
645
+ uint256 tokensLater = _payProject(pid, address(0xB0B), 1 ether);
646
+
647
+ assertEq(tokensNow, tokensLater, "duration=0 should mean weight never decays");
648
+
649
+ // Verify still cycle 1
650
+ (JBRuleset memory ruleset,) = jbController().currentRulesetOf(pid);
651
+ assertEq(ruleset.cycleNumber, 1, "Should still be cycle 1 with duration=0");
652
+ }
653
+
654
+ receive() external payable {}
655
+ }
656
+
657
+ // ═══════════════════════════════════════════════════════════════════════
658
+ // Mock Contracts
659
+ // ═══════════════════════════════════════════════════════════════════════
660
+
661
+ /// @notice Approval hook that approves after a configurable delay.
662
+ contract DelayedApprovalHook is ERC165, IJBRulesetApprovalHook {
663
+ uint256 public immutable approvalDelay;
664
+
665
+ constructor(uint256 _approvalDelay) {
666
+ approvalDelay = _approvalDelay;
667
+ }
668
+
669
+ function DURATION() external view override returns (uint256) {
670
+ return approvalDelay;
671
+ }
672
+
673
+ function approvalStatusOf(uint256, JBRuleset calldata ruleset) external view override returns (JBApprovalStatus) {
674
+ // If enough time has passed since the ruleset was queued, approve it
675
+ if (block.timestamp >= ruleset.start - approvalDelay) {
676
+ return JBApprovalStatus.Approved;
677
+ }
678
+ return JBApprovalStatus.ApprovalExpected;
679
+ }
680
+
681
+ function supportsInterface(bytes4 _interfaceId) public view override(IERC165, ERC165) returns (bool) {
682
+ return _interfaceId == type(IJBRulesetApprovalHook).interfaceId || super.supportsInterface(_interfaceId);
683
+ }
684
+ }
685
+
686
+ /// @notice Approval hook that always rejects.
687
+ contract AlwaysRejectingHook is ERC165, IJBRulesetApprovalHook {
688
+ function DURATION() external pure override returns (uint256) {
689
+ return 0;
690
+ }
691
+
692
+ function approvalStatusOf(uint256, JBRuleset calldata) external pure override returns (JBApprovalStatus) {
693
+ return JBApprovalStatus.Failed;
694
+ }
695
+
696
+ function supportsInterface(bytes4 _interfaceId) public view override(IERC165, ERC165) returns (bool) {
697
+ return _interfaceId == type(IJBRulesetApprovalHook).interfaceId || super.supportsInterface(_interfaceId);
698
+ }
699
+ }