@bananapus/core-v6 0.0.36 → 0.0.38

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 (286) hide show
  1. package/foundry.lock +1 -7
  2. package/foundry.toml +1 -1
  3. package/package.json +19 -7
  4. package/src/JBController.sol +26 -5
  5. package/src/JBMultiTerminal.sol +85 -47
  6. package/src/JBTerminalStore.sol +6 -6
  7. package/src/interfaces/IJBController.sol +4 -1
  8. package/src/libraries/JBFees.sol +47 -9
  9. package/src/libraries/JBPayoutSplitGroupLib.sol +2 -2
  10. package/src/periphery/JBMatchingPriceFeed.sol +1 -1
  11. package/test/mock/MockMaliciousBeneficiary.sol +15 -15
  12. package/ADMINISTRATION.md +0 -103
  13. package/ARCHITECTURE.md +0 -133
  14. package/AUDIT_INSTRUCTIONS.md +0 -139
  15. package/RISKS.md +0 -215
  16. package/SKILLS.md +0 -55
  17. package/STYLE_GUIDE.md +0 -610
  18. package/USER_JOURNEYS.md +0 -215
  19. package/script/Deploy.s.sol +0 -124
  20. package/script/DeployPeriphery.s.sol +0 -354
  21. package/slither-ci.config.json +0 -10
  22. package/test/AuditFixes.t.sol +0 -808
  23. package/test/ComprehensiveInvariant.t.sol +0 -306
  24. package/test/CoreExploitTests.t.sol +0 -2741
  25. package/test/EconomicSimulation.t.sol +0 -348
  26. package/test/EntryPointPermutations.t.sol +0 -684
  27. package/test/FlashLoanAttacks.t.sol +0 -797
  28. package/test/PermissionEscalation.t.sol +0 -711
  29. package/test/PermissionsInvariant.t.sol +0 -403
  30. package/test/RulesetTransitions.t.sol +0 -713
  31. package/test/SplitLoopTests.t.sol +0 -752
  32. package/test/TestAccessToFunds.sol +0 -2683
  33. package/test/TestAuditResponseDesignProofs.sol +0 -434
  34. package/test/TestCashOut.sol +0 -198
  35. package/test/TestCashOutCountFor.sol +0 -271
  36. package/test/TestCashOutHooks.sol +0 -351
  37. package/test/TestCashOutTimingEdge.sol +0 -241
  38. package/test/TestDataHookFuzzing.sol +0 -524
  39. package/test/TestDurationUnderflow.sol +0 -233
  40. package/test/TestFeeFreeCashOutBypass.sol +0 -949
  41. package/test/TestFeeProcessingFailure.sol +0 -218
  42. package/test/TestFees.sol +0 -619
  43. package/test/TestForwardedTokenConsumption.sol +0 -425
  44. package/test/TestInterfaceSupport.sol +0 -81
  45. package/test/TestJBERC20Inheritance.sol +0 -103
  46. package/test/TestL2SequencerPriceFeed.sol +0 -292
  47. package/test/TestLaunchProject.sol +0 -188
  48. package/test/TestMetaTx.sol +0 -217
  49. package/test/TestMetadataOffsetOverflow.sol +0 -179
  50. package/test/TestMetadataParserLib.sol +0 -471
  51. package/test/TestMigrationHeldFees.sol +0 -255
  52. package/test/TestMintTokensOf.sol +0 -185
  53. package/test/TestMultiTerminalSurplus.sol +0 -348
  54. package/test/TestMultiTokenSurplus.sol +0 -202
  55. package/test/TestMultipleAccessLimits.sol +0 -664
  56. package/test/TestPayBurnRedeemFlow.sol +0 -195
  57. package/test/TestPayHooks.sol +0 -209
  58. package/test/TestPermissions.sol +0 -324
  59. package/test/TestPermissionsEdge.sol +0 -290
  60. package/test/TestPermit2DataHook.t.sol +0 -360
  61. package/test/TestPermit2Terminal.sol +0 -372
  62. package/test/TestRulesetQueueing.sol +0 -1025
  63. package/test/TestRulesetQueuingStress.sol +0 -806
  64. package/test/TestRulesetWeightCaching.sol +0 -178
  65. package/test/TestSplits.sol +0 -391
  66. package/test/TestTerminalMigration.sol +0 -274
  67. package/test/TestTerminalPreviewParity.sol +0 -208
  68. package/test/TestTokenFlow.sol +0 -191
  69. package/test/TestWeightCacheStaleAfterRejection.sol +0 -303
  70. package/test/WeirdTokenTests.t.sol +0 -817
  71. package/test/audit/CashOutReenterPay.t.sol +0 -501
  72. package/test/audit/CodexHeldFeeRounding.t.sol +0 -159
  73. package/test/audit/CrossTerminalSurplusSpoof.t.sol +0 -140
  74. package/test/audit/CycledSurplusAllowanceReset.t.sol +0 -184
  75. package/test/audit/FeeFreeSurplusLifecycle.t.sol +0 -399
  76. package/test/audit/FeeFreeSurplusStale.t.sol +0 -248
  77. package/test/audit/USDTVoidReturnCompat.t.sol +0 -525
  78. package/test/fork/TestChainlinkPriceFeedFork.sol +0 -254
  79. package/test/fork/TestSequencerPriceFeedFork.sol +0 -168
  80. package/test/fork/TestTerminalPreviewParityFork.sol +0 -108
  81. package/test/formal/BondingCurveProperties.t.sol +0 -420
  82. package/test/formal/FeeProperties.t.sol +0 -252
  83. package/test/invariants/Phase3DeepInvariant.t.sol +0 -412
  84. package/test/invariants/RulesetsInvariant.t.sol +0 -125
  85. package/test/invariants/TerminalStoreInvariant.t.sol +0 -227
  86. package/test/invariants/TokensInvariant.t.sol +0 -195
  87. package/test/invariants/handlers/ComprehensiveHandler.sol +0 -303
  88. package/test/invariants/handlers/EconomicHandler.sol +0 -377
  89. package/test/invariants/handlers/Phase3Handler.sol +0 -443
  90. package/test/invariants/handlers/RulesetsHandler.sol +0 -115
  91. package/test/invariants/handlers/TerminalStoreHandler.sol +0 -151
  92. package/test/invariants/handlers/TokensHandler.sol +0 -126
  93. package/test/regression/HoldFeesCashOutReserved.t.sol +0 -415
  94. package/test/regression/WeightCacheBoundary.t.sol +0 -291
  95. package/test/trees/JBController/burnTokensOf.tree +0 -9
  96. package/test/trees/JBController/claimTokensFor.tree +0 -5
  97. package/test/trees/JBController/deployERC20For.tree +0 -5
  98. package/test/trees/JBController/getRulesetOf.tree +0 -5
  99. package/test/trees/JBController/launchProjectFor.tree +0 -12
  100. package/test/trees/JBController/launchRulesetsFor.tree +0 -8
  101. package/test/trees/JBController/migrateController.tree +0 -12
  102. package/test/trees/JBController/mintTokensOf.tree +0 -12
  103. package/test/trees/JBController/payReservedTokenToTerminal.tree +0 -8
  104. package/test/trees/JBController/receiveMigrationFrom.tree +0 -4
  105. package/test/trees/JBController/sendReservedTokensToSplitsOf.tree +0 -12
  106. package/test/trees/JBController/setMetadataOf.tree +0 -5
  107. package/test/trees/JBController/setSplitGroupsOf.tree +0 -5
  108. package/test/trees/JBController/setTokenFor.tree +0 -5
  109. package/test/trees/JBController/transferCreditsFrom.tree +0 -8
  110. package/test/trees/JBDirectory/primaryTerminalOf.tree +0 -8
  111. package/test/trees/JBDirectory/setControllerOf.tree +0 -11
  112. package/test/trees/JBDirectory/setPrimaryTerminalOf.tree +0 -15
  113. package/test/trees/JBDirectory/setTerminalsOf.tree +0 -11
  114. package/test/trees/JBERC20/initialize.tree +0 -7
  115. package/test/trees/JBERC20/name.tree +0 -5
  116. package/test/trees/JBERC20/nonces.tree +0 -5
  117. package/test/trees/JBERC20/symbol.tree +0 -5
  118. package/test/trees/JBFeelessAddresses/setFeelessAddress.tree +0 -5
  119. package/test/trees/JBFeelessAddresses/supportsInterface.tree +0 -5
  120. package/test/trees/JBFundAccessLimits/payoutLimitOf.tree +0 -5
  121. package/test/trees/JBFundAccessLimits/payoutLimitsOf.tree +0 -8
  122. package/test/trees/JBFundAccessLimits/setFundAccessLimitsFor.tree +0 -18
  123. package/test/trees/JBFundAccessLimits/surplusAllowanceOf.tree +0 -5
  124. package/test/trees/JBFundAccessLimits/surplusAllowancesOf.tree +0 -8
  125. package/test/trees/JBMetadataResolver/getDataFor.tree +0 -8
  126. package/test/trees/JBMultiTerminal/accountingContextsOf.tree +0 -5
  127. package/test/trees/JBMultiTerminal/addAccountingContextsFor.tree +0 -10
  128. package/test/trees/JBMultiTerminal/addToBalanceOf.tree +0 -23
  129. package/test/trees/JBMultiTerminal/cashOutTokensOf.tree +0 -23
  130. package/test/trees/JBMultiTerminal/executePayout.tree +0 -32
  131. package/test/trees/JBMultiTerminal/executeProcessFee.tree +0 -14
  132. package/test/trees/JBMultiTerminal/migrateBalanceOf.tree +0 -12
  133. package/test/trees/JBMultiTerminal/pay.tree +0 -23
  134. package/test/trees/JBMultiTerminal/processHeldFeesOf.tree +0 -8
  135. package/test/trees/JBMultiTerminal/sendPayoutsOf.tree +0 -34
  136. package/test/trees/JBMultiTerminal/useAllowanceOf.tree +0 -16
  137. package/test/trees/JBPermissions/hasPermission.tree +0 -8
  138. package/test/trees/JBPermissions/hasPermissions.tree +0 -8
  139. package/test/trees/JBPermissions/setPermissionsFor.tree +0 -5
  140. package/test/trees/JBPrices/addPriceFeedFor.tree +0 -14
  141. package/test/trees/JBPrices/pricePerUnitOf.tree +0 -11
  142. package/test/trees/JBProjects/createFor.tree +0 -11
  143. package/test/trees/JBProjects/setTokenUriResolver.tree +0 -5
  144. package/test/trees/JBProjects/supportsInterface.tree +0 -9
  145. package/test/trees/JBProjects/tokenURI.tree +0 -5
  146. package/test/trees/JBRulesets/currentApprovalStatusForLatestRulesetOf.tree +0 -8
  147. package/test/trees/JBRulesets/currentOf.tree +0 -12
  148. package/test/trees/JBRulesets/getRulesetOf.tree +0 -5
  149. package/test/trees/JBRulesets/latestQueuedRulesetOf.tree +0 -10
  150. package/test/trees/JBRulesets/rulesetsOf.tree +0 -11
  151. package/test/trees/JBRulesets/upcomingRulesetOf.tree +0 -20
  152. package/test/trees/JBRulesets/updateRulesetWeightCache.tree +0 -5
  153. package/test/trees/JBSplits/setSplitGroupsOf.tree +0 -17
  154. package/test/trees/JBSplits/splitsOf.tree +0 -5
  155. package/test/trees/JBTerminalStore/currentReclaimableSurplusOf.tree +0 -16
  156. package/test/trees/JBTerminalStore/currentSurplusOf.tree +0 -25
  157. package/test/trees/JBTerminalStore/currentTotalSurplusOf.tree +0 -5
  158. package/test/trees/JBTerminalStore/recordCashOutsFor.tree +0 -16
  159. package/test/trees/JBTerminalStore/recordPaymentFrom.tree +0 -14
  160. package/test/trees/JBTerminalStore/recordPayoutFor.tree +0 -10
  161. package/test/trees/JBTerminalStore/recordTerminalMigration.tree +0 -5
  162. package/test/trees/JBTerminalStore/recordUsedAllowanceOf.tree +0 -10
  163. package/test/trees/JBTokens/burnFrom.tree +0 -10
  164. package/test/trees/JBTokens/claimTokensFor.tree +0 -10
  165. package/test/trees/JBTokens/deployERC20For.tree +0 -12
  166. package/test/trees/JBTokens/mintFor.tree +0 -10
  167. package/test/trees/JBTokens/setTokenFor.tree +0 -11
  168. package/test/trees/JBTokens/totalBalanceOf.tree +0 -5
  169. package/test/trees/JBTokens/totalSupplyOf.tree +0 -5
  170. package/test/trees/JBTokens/transferCreditsFrom.tree +0 -8
  171. package/test/trees/mintTokensOf.tree +0 -12
  172. package/test/units/static/JBChainlinkV3PriceFeed/TestPriceFeed.sol +0 -223
  173. package/test/units/static/JBController/JBControllerSetup.sol +0 -50
  174. package/test/units/static/JBController/TestBurnTokensOf.sol +0 -114
  175. package/test/units/static/JBController/TestClaimTokensFor.sol +0 -63
  176. package/test/units/static/JBController/TestDeployErc20For.sol +0 -86
  177. package/test/units/static/JBController/TestLaunchProjectFor.sol +0 -302
  178. package/test/units/static/JBController/TestLaunchRulesetsFor.sol +0 -342
  179. package/test/units/static/JBController/TestMigrateController.sol +0 -157
  180. package/test/units/static/JBController/TestMintTokensOfUnits.sol +0 -111
  181. package/test/units/static/JBController/TestOmnichainRulesetOperator.sol +0 -324
  182. package/test/units/static/JBController/TestPayReservedTokenToTerminal.sol +0 -74
  183. package/test/units/static/JBController/TestPreviewMintOf.sol +0 -117
  184. package/test/units/static/JBController/TestReceiveMigrationFrom.sol +0 -99
  185. package/test/units/static/JBController/TestRulesetViews.sol +0 -225
  186. package/test/units/static/JBController/TestSendReservedTokensToSplitsOf.sol +0 -615
  187. package/test/units/static/JBController/TestSetSplitGroupsOf.sol +0 -68
  188. package/test/units/static/JBController/TestSetTokenFor.sol +0 -239
  189. package/test/units/static/JBController/TestSetUriOf.sol +0 -57
  190. package/test/units/static/JBController/TestTransferCreditsFrom.sol +0 -169
  191. package/test/units/static/JBDeadline/TestDeadlineFuzz.sol +0 -211
  192. package/test/units/static/JBDirectory/JBDirectorySetup.sol +0 -26
  193. package/test/units/static/JBDirectory/TestPrimaryTerminalOf.sol +0 -126
  194. package/test/units/static/JBDirectory/TestSetControllerOf.sol +0 -183
  195. package/test/units/static/JBDirectory/TestSetControllerOfMigrationOrder.sol +0 -104
  196. package/test/units/static/JBDirectory/TestSetPrimaryTerminalOf.sol +0 -179
  197. package/test/units/static/JBDirectory/TestSetTerminalsOf.sol +0 -137
  198. package/test/units/static/JBERC20/JBERC20Setup.sol +0 -34
  199. package/test/units/static/JBERC20/SigUtils.sol +0 -36
  200. package/test/units/static/JBERC20/TestInitialize.sol +0 -60
  201. package/test/units/static/JBERC20/TestName.sol +0 -30
  202. package/test/units/static/JBERC20/TestNonces.sol +0 -62
  203. package/test/units/static/JBERC20/TestSymbol.sol +0 -31
  204. package/test/units/static/JBFeelessAdresses/JBFeelessSetup.sol +0 -22
  205. package/test/units/static/JBFeelessAdresses/TestInterfaces.sol +0 -30
  206. package/test/units/static/JBFeelessAdresses/TestSetFeelessAddress.sol +0 -35
  207. package/test/units/static/JBFees/TestFeesFuzz.sol +0 -79
  208. package/test/units/static/JBFixedPointNumber/TestAdjustDecimals.sol +0 -16
  209. package/test/units/static/JBFixedPointNumber/TestAdjustDecimalsFuzz.sol +0 -71
  210. package/test/units/static/JBFundAccessLimits/JBFundAccessSetup.sol +0 -24
  211. package/test/units/static/JBFundAccessLimits/TestFundAccessLimitsEdge.sol +0 -163
  212. package/test/units/static/JBFundAccessLimits/TestPayoutLimitOf.sol +0 -59
  213. package/test/units/static/JBFundAccessLimits/TestPayoutLimitsOf.sol +0 -101
  214. package/test/units/static/JBFundAccessLimits/TestSetFundAccessLimitsFor.sol +0 -189
  215. package/test/units/static/JBFundAccessLimits/TestSurplusAllowanceOf.sol +0 -64
  216. package/test/units/static/JBFundAccessLimits/TestSurplusAllowancesOf.sol +0 -102
  217. package/test/units/static/JBMetadataResolver/TestGetDataFor.sol +0 -90
  218. package/test/units/static/JBMetadataResolver/TestMetadataResolverEdgeCases.sol +0 -247
  219. package/test/units/static/JBMetadataResolver/TestMetadataResolverFuzz.sol +0 -229
  220. package/test/units/static/JBMultiTerminal/JBMultiTerminalSetup.sol +0 -50
  221. package/test/units/static/JBMultiTerminal/TestAccountingContextsOf.sol +0 -72
  222. package/test/units/static/JBMultiTerminal/TestAddAccountingContextsFor.sol +0 -289
  223. package/test/units/static/JBMultiTerminal/TestAddToBalanceOf.sol +0 -474
  224. package/test/units/static/JBMultiTerminal/TestCashOutTokensOf.sol +0 -624
  225. package/test/units/static/JBMultiTerminal/TestExecutePayout.sol +0 -578
  226. package/test/units/static/JBMultiTerminal/TestExecuteProcessFee.sol +0 -202
  227. package/test/units/static/JBMultiTerminal/TestMigrateBalanceOf.sol +0 -222
  228. package/test/units/static/JBMultiTerminal/TestPay.sol +0 -604
  229. package/test/units/static/JBMultiTerminal/TestPreviewCashOutFrom.sol +0 -117
  230. package/test/units/static/JBMultiTerminal/TestPreviewPayFor.sol +0 -114
  231. package/test/units/static/JBMultiTerminal/TestProcessHeldFeesOf.sol +0 -228
  232. package/test/units/static/JBMultiTerminal/TestSelfPayRevert.sol +0 -55
  233. package/test/units/static/JBMultiTerminal/TestSendPayoutsOf.sol +0 -257
  234. package/test/units/static/JBMultiTerminal/TestUseAllowanceOf.sol +0 -611
  235. package/test/units/static/JBPermissions/JBPermissionsSetup.sol +0 -20
  236. package/test/units/static/JBPermissions/TestHasPermission.sol +0 -50
  237. package/test/units/static/JBPermissions/TestHasPermissions.sol +0 -93
  238. package/test/units/static/JBPermissions/TestSetPermissionsFor.sol +0 -64
  239. package/test/units/static/JBPrices/JBPricesSetup.sol +0 -32
  240. package/test/units/static/JBPrices/TestAddPriceFeedFor.sol +0 -107
  241. package/test/units/static/JBPrices/TestPricePerUnitOf.sol +0 -132
  242. package/test/units/static/JBPrices/TestPrices.sol +0 -265
  243. package/test/units/static/JBProjects/JBProjectsSetup.sol +0 -22
  244. package/test/units/static/JBProjects/TestCreateFor.sol +0 -71
  245. package/test/units/static/JBProjects/TestInitialProject.sol +0 -21
  246. package/test/units/static/JBProjects/TestInterfaces.sol +0 -26
  247. package/test/units/static/JBProjects/TestSetResolver.sol +0 -37
  248. package/test/units/static/JBProjects/TestTokenUri.sol +0 -40
  249. package/test/units/static/JBRulesetMetadataResolver/TestSetCashOutTaxRateTo.sol +0 -108
  250. package/test/units/static/JBRulesets/JBRulesetsSetup.sol +0 -24
  251. package/test/units/static/JBRulesets/TestCurrentApprovalStatusForLatestRulesetOf.sol +0 -265
  252. package/test/units/static/JBRulesets/TestCurrentOf.sol +0 -242
  253. package/test/units/static/JBRulesets/TestGetRulesetOf.sol +0 -100
  254. package/test/units/static/JBRulesets/TestLatestQueuedRulesetOf.sol +0 -260
  255. package/test/units/static/JBRulesets/TestRulesets.sol +0 -632
  256. package/test/units/static/JBRulesets/TestRulesetsOf.sol +0 -37
  257. package/test/units/static/JBRulesets/TestUpcomingRulesetOf.sol +0 -522
  258. package/test/units/static/JBRulesets/TestUpdateRulesetWeightCache.sol +0 -96
  259. package/test/units/static/JBSplits/JBSplitsSetup.sol +0 -26
  260. package/test/units/static/JBSplits/TestSelfManagedSplitGroups.sol +0 -552
  261. package/test/units/static/JBSplits/TestSetSplitGroupsOf.sol +0 -377
  262. package/test/units/static/JBSplits/TestSplitsLockedEdge.sol +0 -267
  263. package/test/units/static/JBSplits/TestSplitsOf.sol +0 -24
  264. package/test/units/static/JBSplits/TestSplitsPacking.sol +0 -36
  265. package/test/units/static/JBSurplus/TestSurplusFuzz.sol +0 -160
  266. package/test/units/static/JBTerminalStore/JBTerminalStoreSetup.sol +0 -45
  267. package/test/units/static/JBTerminalStore/TestCurrentReclaimableSurplusOf.sol +0 -536
  268. package/test/units/static/JBTerminalStore/TestCurrentSurplusOf.sol +0 -463
  269. package/test/units/static/JBTerminalStore/TestCurrentTotalSurplusOf.sol +0 -135
  270. package/test/units/static/JBTerminalStore/TestPreviewCashOutFrom.sol +0 -476
  271. package/test/units/static/JBTerminalStore/TestPreviewPayFrom.sol +0 -494
  272. package/test/units/static/JBTerminalStore/TestRecordCashOutsFor.sol +0 -652
  273. package/test/units/static/JBTerminalStore/TestRecordPaymentFrom.sol +0 -744
  274. package/test/units/static/JBTerminalStore/TestRecordPayoutFor.sol +0 -289
  275. package/test/units/static/JBTerminalStore/TestRecordTerminalMigration.sol +0 -138
  276. package/test/units/static/JBTerminalStore/TestRecordUsedAllowanceOf.sol +0 -415
  277. package/test/units/static/JBTerminalStore/TestUint224Overflow.sol +0 -219
  278. package/test/units/static/JBTokens/JBTokensSetup.sol +0 -32
  279. package/test/units/static/JBTokens/TestBurnFrom.sol +0 -107
  280. package/test/units/static/JBTokens/TestClaimTokensFor.sol +0 -110
  281. package/test/units/static/JBTokens/TestDeployERC20ForUnits.sol +0 -92
  282. package/test/units/static/JBTokens/TestMintFor.sol +0 -100
  283. package/test/units/static/JBTokens/TestSetTokenFor.sol +0 -98
  284. package/test/units/static/JBTokens/TestTotalBalanceOf.sol +0 -65
  285. package/test/units/static/JBTokens/TestTotalSupplyOf.sol +0 -56
  286. package/test/units/static/JBTokens/TestTransferCreditsFrom.sol +0 -56
@@ -1,476 +0,0 @@
1
- // SPDX-License-Identifier: MIT
2
- pragma solidity 0.8.28;
3
-
4
- import {JBTerminalStore} from "../../../../src/JBTerminalStore.sol";
5
- import {IJBCashOutHook} from "../../../../src/interfaces/IJBCashOutHook.sol";
6
- import {IJBController} from "../../../../src/interfaces/IJBController.sol";
7
- import {IJBDirectory} from "../../../../src/interfaces/IJBDirectory.sol";
8
- import {IJBFundAccessLimits} from "../../../../src/interfaces/IJBFundAccessLimits.sol";
9
- import {IJBRulesetApprovalHook} from "../../../../src/interfaces/IJBRulesetApprovalHook.sol";
10
- import {IJBRulesetDataHook} from "../../../../src/interfaces/IJBRulesetDataHook.sol";
11
- import {IJBRulesets} from "../../../../src/interfaces/IJBRulesets.sol";
12
- import {IJBTerminal} from "../../../../src/interfaces/IJBTerminal.sol";
13
- import {IJBToken} from "../../../../src/interfaces/IJBToken.sol";
14
- import {JBConstants} from "../../../../src/libraries/JBConstants.sol";
15
- import {JBRulesetMetadataResolver} from "../../../../src/libraries/JBRulesetMetadataResolver.sol";
16
- import {JBAccountingContext} from "../../../../src/structs/JBAccountingContext.sol";
17
- import {JBBeforeCashOutRecordedContext} from "../../../../src/structs/JBBeforeCashOutRecordedContext.sol";
18
- import {JBCashOutHookSpecification} from "../../../../src/structs/JBCashOutHookSpecification.sol";
19
- import {JBRuleset} from "../../../../src/structs/JBRuleset.sol";
20
- import {JBRulesetMetadata} from "../../../../src/structs/JBRulesetMetadata.sol";
21
- import {JBTokenAmount} from "../../../../src/structs/JBTokenAmount.sol";
22
- import {mulDiv} from "@prb/math/src/Common.sol";
23
- import {JBTerminalStoreSetup} from "./JBTerminalStoreSetup.sol";
24
-
25
- contract TestPreviewCashOutFor_Local is JBTerminalStoreSetup {
26
- uint64 _projectId = 1;
27
- uint256 _decimals = 18;
28
- uint256 _balance = 10e18;
29
- uint256 _totalSupply = 20e18;
30
-
31
- // Mocks
32
- IJBTerminal _terminal1 = IJBTerminal(makeAddr("terminal1"));
33
- IJBTerminal _terminal2 = IJBTerminal(makeAddr("terminal2"));
34
- IJBToken _token = IJBToken(makeAddr("token"));
35
- IJBController _controller = IJBController(makeAddr("controller"));
36
- IJBFundAccessLimits _accessLimits = IJBFundAccessLimits(makeAddr("funds"));
37
- IJBRulesetDataHook _dataHook = IJBRulesetDataHook(makeAddr("dataHook"));
38
- IJBCashOutHook _cashOutHook = IJBCashOutHook(makeAddr("cashOutHook"));
39
-
40
- uint32 _currency = uint32(uint160(address(_token)));
41
-
42
- function setUp() public {
43
- super.terminalStoreSetup();
44
-
45
- // Register accounting context so the store can look up decimals/currency for the token.
46
- // address(this) acts as the terminal for both preview and record calls.
47
- JBAccountingContext[] memory _ctxs = new JBAccountingContext[](1);
48
- _ctxs[0] = JBAccountingContext({token: address(_token), decimals: 18, currency: _currency});
49
- _store.recordAccountingContextOf(_projectId, _ctxs);
50
- }
51
-
52
- function _setBalance(address terminal, uint256 balance) internal {
53
- bytes32 balanceOfSlot = keccak256(abi.encode(terminal, uint256(0)));
54
- bytes32 projectSlot = keccak256(abi.encode(_projectId, uint256(balanceOfSlot)));
55
- bytes32 slot = keccak256(abi.encode(address(_token), uint256(projectSlot)));
56
- vm.store(address(_store), slot, bytes32(balance));
57
- }
58
-
59
- function _mockUseTotalSurplus() internal {
60
- IJBTerminal[] memory _terminals = new IJBTerminal[](2);
61
- _terminals[0] = _terminal1;
62
- _terminals[1] = _terminal2;
63
-
64
- mockExpect(address(directory), abi.encodeCall(IJBDirectory.terminalsOf, (_projectId)), abi.encode(_terminals));
65
-
66
- mockExpect(
67
- address(_terminal1),
68
- abi.encodeCall(IJBTerminal.currentSurplusOf, (_projectId, new address[](0), _decimals, _currency)),
69
- abi.encode(1e18)
70
- );
71
- mockExpect(
72
- address(_terminal2),
73
- abi.encodeCall(IJBTerminal.currentSurplusOf, (_projectId, new address[](0), _decimals, _currency)),
74
- abi.encode(2e18)
75
- );
76
- }
77
-
78
- function test_MatchesRecordCashOutFor() external {
79
- // Setup: set balance for address(this) (acting as terminal for both preview and record)
80
- _setBalance(address(this), _balance);
81
-
82
- _mockUseTotalSurplus();
83
-
84
- JBRulesetMetadata memory _metadata = JBRulesetMetadata({
85
- reservedPercent: 0,
86
- cashOutTaxRate: 0,
87
- baseCurrency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
88
- pausePay: false,
89
- pauseCreditTransfers: false,
90
- allowOwnerMinting: false,
91
- allowSetCustomToken: false,
92
- allowTerminalMigration: false,
93
- allowSetTerminals: false,
94
- ownerMustSendPayouts: false,
95
- allowSetController: false,
96
- allowAddAccountingContext: true,
97
- allowAddPriceFeed: false,
98
- holdFees: false,
99
- useTotalSurplusForCashOuts: true,
100
- useDataHookForPay: false,
101
- useDataHookForCashOut: false,
102
- dataHook: address(0),
103
- metadata: 0
104
- });
105
-
106
- uint256 _packedMetadata = JBRulesetMetadataResolver.packRulesetMetadata(_metadata);
107
-
108
- JBRuleset memory _returnedRuleset = JBRuleset({
109
- cycleNumber: uint48(block.timestamp),
110
- id: uint48(block.timestamp),
111
- basedOnId: 0,
112
- start: uint48(block.timestamp),
113
- duration: uint32(block.timestamp + 1000),
114
- weight: 1e18,
115
- weightCutPercent: 0,
116
- approvalHook: IJBRulesetApprovalHook(address(0)),
117
- metadata: _packedMetadata
118
- });
119
-
120
- uint256 _cashOutCount = 10e18;
121
-
122
- JBAccountingContext memory _accountingContext =
123
- // forge-lint: disable-next-line(unsafe-typecast)
124
- JBAccountingContext({token: address(_token), decimals: uint8(_decimals), currency: _currency});
125
-
126
- // Mock for preview call
127
- mockExpect(address(rulesets), abi.encodeCall(IJBRulesets.currentOf, (_projectId)), abi.encode(_returnedRuleset));
128
- mockExpect(address(directory), abi.encodeCall(IJBDirectory.controllerOf, (_projectId)), abi.encode(_controller));
129
- mockExpect(
130
- address(_controller),
131
- abi.encodeCall(IJBController.totalTokenSupplyWithReservedTokensOf, (_projectId)),
132
- abi.encode(_totalSupply)
133
- );
134
-
135
- (, uint256 previewReclaimAmount, uint256 previewTaxRate, JBCashOutHookSpecification[] memory previewSpecs) = _store.previewCashOutFrom({
136
- terminal: address(this),
137
- holder: address(this),
138
- projectId: _projectId,
139
- cashOutCount: _cashOutCount,
140
- tokenToReclaim: _accountingContext.token,
141
- beneficiaryIsFeeless: false,
142
- metadata: ""
143
- });
144
-
145
- // Re-mock for record call (same mocks, fresh expectations)
146
- _mockUseTotalSurplus();
147
- mockExpect(address(rulesets), abi.encodeCall(IJBRulesets.currentOf, (_projectId)), abi.encode(_returnedRuleset));
148
- mockExpect(address(directory), abi.encodeCall(IJBDirectory.controllerOf, (_projectId)), abi.encode(_controller));
149
- mockExpect(
150
- address(_controller),
151
- abi.encodeCall(IJBController.totalTokenSupplyWithReservedTokensOf, (_projectId)),
152
- abi.encode(_totalSupply)
153
- );
154
-
155
- (, uint256 recordReclaimAmount, uint256 recordTaxRate, JBCashOutHookSpecification[] memory recordSpecs) = _store.recordCashOutFor({
156
- holder: address(this),
157
- projectId: _projectId,
158
- cashOutCount: _cashOutCount,
159
- tokenToReclaim: _accountingContext.token,
160
- beneficiaryIsFeeless: false,
161
- metadata: ""
162
- });
163
-
164
- assertEq(previewReclaimAmount, recordReclaimAmount);
165
- assertEq(previewTaxRate, recordTaxRate);
166
- assertEq(previewSpecs.length, recordSpecs.length);
167
- }
168
-
169
- function test_DoesNotModifyState() external {
170
- _setBalance(address(this), _balance);
171
- _mockUseTotalSurplus();
172
-
173
- JBRulesetMetadata memory _metadata = JBRulesetMetadata({
174
- reservedPercent: 0,
175
- cashOutTaxRate: 0,
176
- baseCurrency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
177
- pausePay: false,
178
- pauseCreditTransfers: false,
179
- allowOwnerMinting: false,
180
- allowSetCustomToken: false,
181
- allowTerminalMigration: false,
182
- allowSetTerminals: false,
183
- ownerMustSendPayouts: false,
184
- allowSetController: false,
185
- allowAddAccountingContext: true,
186
- allowAddPriceFeed: false,
187
- holdFees: false,
188
- useTotalSurplusForCashOuts: true,
189
- useDataHookForPay: false,
190
- useDataHookForCashOut: false,
191
- dataHook: address(0),
192
- metadata: 0
193
- });
194
-
195
- uint256 _packedMetadata = JBRulesetMetadataResolver.packRulesetMetadata(_metadata);
196
-
197
- JBRuleset memory _returnedRuleset = JBRuleset({
198
- cycleNumber: uint48(block.timestamp),
199
- id: uint48(block.timestamp),
200
- basedOnId: 0,
201
- start: uint48(block.timestamp),
202
- duration: uint32(block.timestamp + 1000),
203
- weight: 1e18,
204
- weightCutPercent: 0,
205
- approvalHook: IJBRulesetApprovalHook(address(0)),
206
- metadata: _packedMetadata
207
- });
208
-
209
- JBAccountingContext memory _accountingContext =
210
- // forge-lint: disable-next-line(unsafe-typecast)
211
- JBAccountingContext({token: address(_token), decimals: uint8(_decimals), currency: _currency});
212
-
213
- mockExpect(address(rulesets), abi.encodeCall(IJBRulesets.currentOf, (_projectId)), abi.encode(_returnedRuleset));
214
- mockExpect(address(directory), abi.encodeCall(IJBDirectory.controllerOf, (_projectId)), abi.encode(_controller));
215
- mockExpect(
216
- address(_controller),
217
- abi.encodeCall(IJBController.totalTokenSupplyWithReservedTokensOf, (_projectId)),
218
- abi.encode(_totalSupply)
219
- );
220
-
221
- uint256 balanceBefore = _store.balanceOf(address(this), _projectId, address(_token));
222
-
223
- _store.previewCashOutFrom({
224
- terminal: address(this),
225
- holder: address(this),
226
- projectId: _projectId,
227
- cashOutCount: 5e18,
228
- tokenToReclaim: _accountingContext.token,
229
- beneficiaryIsFeeless: false,
230
- metadata: ""
231
- });
232
-
233
- uint256 balanceAfter = _store.balanceOf(address(this), _projectId, address(_token));
234
- assertEq(balanceBefore, balanceAfter);
235
- }
236
-
237
- function test_RevertsWhenCashOutCountExceedsTotalSupply() external {
238
- _setBalance(address(this), _balance);
239
- _mockUseTotalSurplus();
240
-
241
- JBRulesetMetadata memory _metadata = JBRulesetMetadata({
242
- reservedPercent: 0,
243
- cashOutTaxRate: 0,
244
- baseCurrency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
245
- pausePay: false,
246
- pauseCreditTransfers: false,
247
- allowOwnerMinting: false,
248
- allowSetCustomToken: false,
249
- allowTerminalMigration: false,
250
- allowSetTerminals: false,
251
- ownerMustSendPayouts: false,
252
- allowSetController: false,
253
- allowAddAccountingContext: true,
254
- allowAddPriceFeed: false,
255
- holdFees: false,
256
- useTotalSurplusForCashOuts: true,
257
- useDataHookForPay: false,
258
- useDataHookForCashOut: false,
259
- dataHook: address(0),
260
- metadata: 0
261
- });
262
-
263
- uint256 _packedMetadata = JBRulesetMetadataResolver.packRulesetMetadata(_metadata);
264
-
265
- JBRuleset memory _returnedRuleset = JBRuleset({
266
- cycleNumber: uint48(block.timestamp),
267
- id: uint48(block.timestamp),
268
- basedOnId: 0,
269
- start: uint48(block.timestamp),
270
- duration: uint32(block.timestamp + 1000),
271
- weight: 1e18,
272
- weightCutPercent: 0,
273
- approvalHook: IJBRulesetApprovalHook(address(0)),
274
- metadata: _packedMetadata
275
- });
276
-
277
- JBAccountingContext memory _accountingContext =
278
- // forge-lint: disable-next-line(unsafe-typecast)
279
- JBAccountingContext({token: address(_token), decimals: uint8(_decimals), currency: _currency});
280
-
281
- mockExpect(address(rulesets), abi.encodeCall(IJBRulesets.currentOf, (_projectId)), abi.encode(_returnedRuleset));
282
- mockExpect(address(directory), abi.encodeCall(IJBDirectory.controllerOf, (_projectId)), abi.encode(_controller));
283
- mockExpect(
284
- address(_controller),
285
- abi.encodeCall(IJBController.totalTokenSupplyWithReservedTokensOf, (_projectId)),
286
- abi.encode(_totalSupply)
287
- );
288
-
289
- uint256 _excessiveCashOutCount = _totalSupply + 1;
290
-
291
- vm.expectRevert(
292
- abi.encodeWithSelector(
293
- JBTerminalStore.JBTerminalStore_InsufficientTokens.selector, _excessiveCashOutCount, _totalSupply
294
- )
295
- );
296
- _store.previewCashOutFrom({
297
- terminal: address(this),
298
- holder: address(this),
299
- projectId: _projectId,
300
- cashOutCount: _excessiveCashOutCount,
301
- tokenToReclaim: _accountingContext.token,
302
- beneficiaryIsFeeless: false,
303
- metadata: ""
304
- });
305
- }
306
-
307
- function test_ReturnsZeroWhenSurplusIsZero() external {
308
- // No balance set, no surplus
309
-
310
- JBRulesetMetadata memory _metadata = JBRulesetMetadata({
311
- reservedPercent: 0,
312
- cashOutTaxRate: 0,
313
- baseCurrency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
314
- pausePay: false,
315
- pauseCreditTransfers: false,
316
- allowOwnerMinting: false,
317
- allowSetCustomToken: false,
318
- allowTerminalMigration: false,
319
- allowSetTerminals: false,
320
- ownerMustSendPayouts: false,
321
- allowSetController: false,
322
- allowAddAccountingContext: true,
323
- allowAddPriceFeed: false,
324
- holdFees: false,
325
- useTotalSurplusForCashOuts: true,
326
- useDataHookForPay: false,
327
- useDataHookForCashOut: false,
328
- dataHook: address(0),
329
- metadata: 0
330
- });
331
-
332
- uint256 _packedMetadata = JBRulesetMetadataResolver.packRulesetMetadata(_metadata);
333
-
334
- JBRuleset memory _returnedRuleset = JBRuleset({
335
- cycleNumber: uint48(block.timestamp),
336
- id: uint48(block.timestamp),
337
- basedOnId: 0,
338
- start: uint48(block.timestamp),
339
- duration: uint32(block.timestamp + 1000),
340
- weight: 1e18,
341
- weightCutPercent: 0,
342
- approvalHook: IJBRulesetApprovalHook(address(0)),
343
- metadata: _packedMetadata
344
- });
345
-
346
- JBAccountingContext memory _accountingContext =
347
- // forge-lint: disable-next-line(unsafe-typecast)
348
- JBAccountingContext({token: address(_token), decimals: uint8(_decimals), currency: _currency});
349
-
350
- IJBTerminal[] memory _terminals = new IJBTerminal[](1);
351
- _terminals[0] = _terminal1;
352
-
353
- mockExpect(address(rulesets), abi.encodeCall(IJBRulesets.currentOf, (_projectId)), abi.encode(_returnedRuleset));
354
- mockExpect(address(directory), abi.encodeCall(IJBDirectory.terminalsOf, (_projectId)), abi.encode(_terminals));
355
- mockExpect(
356
- address(_terminal1),
357
- abi.encodeCall(IJBTerminal.currentSurplusOf, (_projectId, new address[](0), _decimals, _currency)),
358
- abi.encode(0)
359
- );
360
- mockExpect(address(directory), abi.encodeCall(IJBDirectory.controllerOf, (_projectId)), abi.encode(_controller));
361
- mockExpect(
362
- address(_controller),
363
- abi.encodeCall(IJBController.totalTokenSupplyWithReservedTokensOf, (_projectId)),
364
- abi.encode(_totalSupply)
365
- );
366
-
367
- (, uint256 reclaimAmount,,) = _store.previewCashOutFrom({
368
- terminal: address(this),
369
- holder: address(this),
370
- projectId: _projectId,
371
- cashOutCount: 5e18,
372
- tokenToReclaim: _accountingContext.token,
373
- beneficiaryIsFeeless: false,
374
- metadata: ""
375
- });
376
-
377
- assertEq(reclaimAmount, 0);
378
- }
379
-
380
- function test_WithDataHookAndZeroAmountNoopSpec() external {
381
- _setBalance(address(this), _balance);
382
- _mockUseTotalSurplus();
383
-
384
- JBRulesetMetadata memory _metadata = JBRulesetMetadata({
385
- reservedPercent: 0,
386
- cashOutTaxRate: 0,
387
- baseCurrency: uint32(uint160(JBConstants.NATIVE_TOKEN)),
388
- pausePay: false,
389
- pauseCreditTransfers: false,
390
- allowOwnerMinting: false,
391
- allowSetCustomToken: false,
392
- allowTerminalMigration: false,
393
- allowSetTerminals: false,
394
- ownerMustSendPayouts: false,
395
- allowSetController: false,
396
- allowAddAccountingContext: true,
397
- allowAddPriceFeed: false,
398
- holdFees: false,
399
- useTotalSurplusForCashOuts: true,
400
- useDataHookForPay: false,
401
- useDataHookForCashOut: true,
402
- dataHook: address(_dataHook),
403
- metadata: 0
404
- });
405
-
406
- uint256 _packedMetadata = JBRulesetMetadataResolver.packRulesetMetadata(_metadata);
407
-
408
- JBRuleset memory _returnedRuleset = JBRuleset({
409
- cycleNumber: uint48(block.timestamp),
410
- id: uint48(block.timestamp),
411
- basedOnId: 0,
412
- start: uint48(block.timestamp),
413
- duration: uint32(block.timestamp + 1000),
414
- weight: 1e18,
415
- weightCutPercent: 0,
416
- approvalHook: IJBRulesetApprovalHook(address(0)),
417
- metadata: _packedMetadata
418
- });
419
-
420
- JBAccountingContext memory _accountingContext =
421
- // forge-lint: disable-next-line(unsafe-typecast)
422
- JBAccountingContext({token: address(_token), decimals: uint8(_decimals), currency: _currency});
423
-
424
- JBBeforeCashOutRecordedContext memory _context = JBBeforeCashOutRecordedContext({
425
- terminal: address(this),
426
- holder: address(this),
427
- projectId: _projectId,
428
- rulesetId: uint48(block.timestamp),
429
- cashOutCount: 10e18,
430
- totalSupply: _totalSupply,
431
- surplus: JBTokenAmount({
432
- token: _accountingContext.token,
433
- value: 3e18,
434
- decimals: _accountingContext.decimals,
435
- currency: _accountingContext.currency
436
- }),
437
- useTotalSurplus: true,
438
- cashOutTaxRate: 0,
439
- beneficiaryIsFeeless: false,
440
- metadata: ""
441
- });
442
-
443
- JBCashOutHookSpecification[] memory _spec = new JBCashOutHookSpecification[](1);
444
- _spec[0] = JBCashOutHookSpecification({hook: _cashOutHook, noop: true, amount: 0, metadata: "info"});
445
-
446
- mockExpect(address(rulesets), abi.encodeCall(IJBRulesets.currentOf, (_projectId)), abi.encode(_returnedRuleset));
447
- mockExpect(address(directory), abi.encodeCall(IJBDirectory.controllerOf, (_projectId)), abi.encode(_controller));
448
- mockExpect(
449
- address(_controller),
450
- abi.encodeCall(IJBController.totalTokenSupplyWithReservedTokensOf, (_projectId)),
451
- abi.encode(_totalSupply)
452
- );
453
- mockExpect(
454
- address(_dataHook),
455
- abi.encodeCall(IJBRulesetDataHook.beforeCashOutRecordedWith, (_context)),
456
- abi.encode(0, 10e18, _totalSupply, 3e18, _spec)
457
- );
458
-
459
- (, uint256 reclaimAmount, uint256 cashOutTaxRate, JBCashOutHookSpecification[] memory hookSpecifications) = _store.previewCashOutFrom({
460
- terminal: address(this),
461
- holder: address(this),
462
- projectId: _projectId,
463
- cashOutCount: 10e18,
464
- tokenToReclaim: _accountingContext.token,
465
- beneficiaryIsFeeless: false,
466
- metadata: ""
467
- });
468
-
469
- assertEq(reclaimAmount, mulDiv(3e18, 10e18, _totalSupply));
470
- assertEq(cashOutTaxRate, 0);
471
- assertEq(hookSpecifications.length, 1);
472
- assertEq(hookSpecifications[0].amount, 0);
473
- assertEq(hookSpecifications[0].noop, true);
474
- assertEq(hookSpecifications[0].metadata, bytes("info"));
475
- }
476
- }