@bananapus/core-v6 0.0.37 → 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 (287) 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 +19 -1
  5. package/src/JBMultiTerminal.sol +68 -34
  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/CodexMigrationFeeFailure.t.sol +0 -163
  74. package/test/audit/CrossTerminalSurplusSpoof.t.sol +0 -140
  75. package/test/audit/CycledSurplusAllowanceReset.t.sol +0 -184
  76. package/test/audit/FeeFreeSurplusLifecycle.t.sol +0 -399
  77. package/test/audit/FeeFreeSurplusStale.t.sol +0 -248
  78. package/test/audit/USDTVoidReturnCompat.t.sol +0 -525
  79. package/test/fork/TestChainlinkPriceFeedFork.sol +0 -254
  80. package/test/fork/TestSequencerPriceFeedFork.sol +0 -168
  81. package/test/fork/TestTerminalPreviewParityFork.sol +0 -108
  82. package/test/formal/BondingCurveProperties.t.sol +0 -420
  83. package/test/formal/FeeProperties.t.sol +0 -252
  84. package/test/invariants/Phase3DeepInvariant.t.sol +0 -412
  85. package/test/invariants/RulesetsInvariant.t.sol +0 -125
  86. package/test/invariants/TerminalStoreInvariant.t.sol +0 -227
  87. package/test/invariants/TokensInvariant.t.sol +0 -195
  88. package/test/invariants/handlers/ComprehensiveHandler.sol +0 -303
  89. package/test/invariants/handlers/EconomicHandler.sol +0 -377
  90. package/test/invariants/handlers/Phase3Handler.sol +0 -443
  91. package/test/invariants/handlers/RulesetsHandler.sol +0 -115
  92. package/test/invariants/handlers/TerminalStoreHandler.sol +0 -151
  93. package/test/invariants/handlers/TokensHandler.sol +0 -126
  94. package/test/regression/HoldFeesCashOutReserved.t.sol +0 -415
  95. package/test/regression/WeightCacheBoundary.t.sol +0 -291
  96. package/test/trees/JBController/burnTokensOf.tree +0 -9
  97. package/test/trees/JBController/claimTokensFor.tree +0 -5
  98. package/test/trees/JBController/deployERC20For.tree +0 -5
  99. package/test/trees/JBController/getRulesetOf.tree +0 -5
  100. package/test/trees/JBController/launchProjectFor.tree +0 -12
  101. package/test/trees/JBController/launchRulesetsFor.tree +0 -8
  102. package/test/trees/JBController/migrateController.tree +0 -12
  103. package/test/trees/JBController/mintTokensOf.tree +0 -12
  104. package/test/trees/JBController/payReservedTokenToTerminal.tree +0 -8
  105. package/test/trees/JBController/receiveMigrationFrom.tree +0 -4
  106. package/test/trees/JBController/sendReservedTokensToSplitsOf.tree +0 -12
  107. package/test/trees/JBController/setMetadataOf.tree +0 -5
  108. package/test/trees/JBController/setSplitGroupsOf.tree +0 -5
  109. package/test/trees/JBController/setTokenFor.tree +0 -5
  110. package/test/trees/JBController/transferCreditsFrom.tree +0 -8
  111. package/test/trees/JBDirectory/primaryTerminalOf.tree +0 -8
  112. package/test/trees/JBDirectory/setControllerOf.tree +0 -11
  113. package/test/trees/JBDirectory/setPrimaryTerminalOf.tree +0 -15
  114. package/test/trees/JBDirectory/setTerminalsOf.tree +0 -11
  115. package/test/trees/JBERC20/initialize.tree +0 -7
  116. package/test/trees/JBERC20/name.tree +0 -5
  117. package/test/trees/JBERC20/nonces.tree +0 -5
  118. package/test/trees/JBERC20/symbol.tree +0 -5
  119. package/test/trees/JBFeelessAddresses/setFeelessAddress.tree +0 -5
  120. package/test/trees/JBFeelessAddresses/supportsInterface.tree +0 -5
  121. package/test/trees/JBFundAccessLimits/payoutLimitOf.tree +0 -5
  122. package/test/trees/JBFundAccessLimits/payoutLimitsOf.tree +0 -8
  123. package/test/trees/JBFundAccessLimits/setFundAccessLimitsFor.tree +0 -18
  124. package/test/trees/JBFundAccessLimits/surplusAllowanceOf.tree +0 -5
  125. package/test/trees/JBFundAccessLimits/surplusAllowancesOf.tree +0 -8
  126. package/test/trees/JBMetadataResolver/getDataFor.tree +0 -8
  127. package/test/trees/JBMultiTerminal/accountingContextsOf.tree +0 -5
  128. package/test/trees/JBMultiTerminal/addAccountingContextsFor.tree +0 -10
  129. package/test/trees/JBMultiTerminal/addToBalanceOf.tree +0 -23
  130. package/test/trees/JBMultiTerminal/cashOutTokensOf.tree +0 -23
  131. package/test/trees/JBMultiTerminal/executePayout.tree +0 -32
  132. package/test/trees/JBMultiTerminal/executeProcessFee.tree +0 -14
  133. package/test/trees/JBMultiTerminal/migrateBalanceOf.tree +0 -12
  134. package/test/trees/JBMultiTerminal/pay.tree +0 -23
  135. package/test/trees/JBMultiTerminal/processHeldFeesOf.tree +0 -8
  136. package/test/trees/JBMultiTerminal/sendPayoutsOf.tree +0 -34
  137. package/test/trees/JBMultiTerminal/useAllowanceOf.tree +0 -16
  138. package/test/trees/JBPermissions/hasPermission.tree +0 -8
  139. package/test/trees/JBPermissions/hasPermissions.tree +0 -8
  140. package/test/trees/JBPermissions/setPermissionsFor.tree +0 -5
  141. package/test/trees/JBPrices/addPriceFeedFor.tree +0 -14
  142. package/test/trees/JBPrices/pricePerUnitOf.tree +0 -11
  143. package/test/trees/JBProjects/createFor.tree +0 -11
  144. package/test/trees/JBProjects/setTokenUriResolver.tree +0 -5
  145. package/test/trees/JBProjects/supportsInterface.tree +0 -9
  146. package/test/trees/JBProjects/tokenURI.tree +0 -5
  147. package/test/trees/JBRulesets/currentApprovalStatusForLatestRulesetOf.tree +0 -8
  148. package/test/trees/JBRulesets/currentOf.tree +0 -12
  149. package/test/trees/JBRulesets/getRulesetOf.tree +0 -5
  150. package/test/trees/JBRulesets/latestQueuedRulesetOf.tree +0 -10
  151. package/test/trees/JBRulesets/rulesetsOf.tree +0 -11
  152. package/test/trees/JBRulesets/upcomingRulesetOf.tree +0 -20
  153. package/test/trees/JBRulesets/updateRulesetWeightCache.tree +0 -5
  154. package/test/trees/JBSplits/setSplitGroupsOf.tree +0 -17
  155. package/test/trees/JBSplits/splitsOf.tree +0 -5
  156. package/test/trees/JBTerminalStore/currentReclaimableSurplusOf.tree +0 -16
  157. package/test/trees/JBTerminalStore/currentSurplusOf.tree +0 -25
  158. package/test/trees/JBTerminalStore/currentTotalSurplusOf.tree +0 -5
  159. package/test/trees/JBTerminalStore/recordCashOutsFor.tree +0 -16
  160. package/test/trees/JBTerminalStore/recordPaymentFrom.tree +0 -14
  161. package/test/trees/JBTerminalStore/recordPayoutFor.tree +0 -10
  162. package/test/trees/JBTerminalStore/recordTerminalMigration.tree +0 -5
  163. package/test/trees/JBTerminalStore/recordUsedAllowanceOf.tree +0 -10
  164. package/test/trees/JBTokens/burnFrom.tree +0 -10
  165. package/test/trees/JBTokens/claimTokensFor.tree +0 -10
  166. package/test/trees/JBTokens/deployERC20For.tree +0 -12
  167. package/test/trees/JBTokens/mintFor.tree +0 -10
  168. package/test/trees/JBTokens/setTokenFor.tree +0 -11
  169. package/test/trees/JBTokens/totalBalanceOf.tree +0 -5
  170. package/test/trees/JBTokens/totalSupplyOf.tree +0 -5
  171. package/test/trees/JBTokens/transferCreditsFrom.tree +0 -8
  172. package/test/trees/mintTokensOf.tree +0 -12
  173. package/test/units/static/JBChainlinkV3PriceFeed/TestPriceFeed.sol +0 -223
  174. package/test/units/static/JBController/JBControllerSetup.sol +0 -50
  175. package/test/units/static/JBController/TestBurnTokensOf.sol +0 -114
  176. package/test/units/static/JBController/TestClaimTokensFor.sol +0 -63
  177. package/test/units/static/JBController/TestDeployErc20For.sol +0 -86
  178. package/test/units/static/JBController/TestLaunchProjectFor.sol +0 -302
  179. package/test/units/static/JBController/TestLaunchRulesetsFor.sol +0 -342
  180. package/test/units/static/JBController/TestMigrateController.sol +0 -157
  181. package/test/units/static/JBController/TestMintTokensOfUnits.sol +0 -111
  182. package/test/units/static/JBController/TestOmnichainRulesetOperator.sol +0 -324
  183. package/test/units/static/JBController/TestPayReservedTokenToTerminal.sol +0 -74
  184. package/test/units/static/JBController/TestPreviewMintOf.sol +0 -117
  185. package/test/units/static/JBController/TestReceiveMigrationFrom.sol +0 -99
  186. package/test/units/static/JBController/TestRulesetViews.sol +0 -225
  187. package/test/units/static/JBController/TestSendReservedTokensToSplitsOf.sol +0 -615
  188. package/test/units/static/JBController/TestSetSplitGroupsOf.sol +0 -68
  189. package/test/units/static/JBController/TestSetTokenFor.sol +0 -239
  190. package/test/units/static/JBController/TestSetUriOf.sol +0 -57
  191. package/test/units/static/JBController/TestTransferCreditsFrom.sol +0 -169
  192. package/test/units/static/JBDeadline/TestDeadlineFuzz.sol +0 -211
  193. package/test/units/static/JBDirectory/JBDirectorySetup.sol +0 -26
  194. package/test/units/static/JBDirectory/TestPrimaryTerminalOf.sol +0 -126
  195. package/test/units/static/JBDirectory/TestSetControllerOf.sol +0 -183
  196. package/test/units/static/JBDirectory/TestSetControllerOfMigrationOrder.sol +0 -104
  197. package/test/units/static/JBDirectory/TestSetPrimaryTerminalOf.sol +0 -179
  198. package/test/units/static/JBDirectory/TestSetTerminalsOf.sol +0 -137
  199. package/test/units/static/JBERC20/JBERC20Setup.sol +0 -34
  200. package/test/units/static/JBERC20/SigUtils.sol +0 -36
  201. package/test/units/static/JBERC20/TestInitialize.sol +0 -60
  202. package/test/units/static/JBERC20/TestName.sol +0 -30
  203. package/test/units/static/JBERC20/TestNonces.sol +0 -62
  204. package/test/units/static/JBERC20/TestSymbol.sol +0 -31
  205. package/test/units/static/JBFeelessAdresses/JBFeelessSetup.sol +0 -22
  206. package/test/units/static/JBFeelessAdresses/TestInterfaces.sol +0 -30
  207. package/test/units/static/JBFeelessAdresses/TestSetFeelessAddress.sol +0 -35
  208. package/test/units/static/JBFees/TestFeesFuzz.sol +0 -79
  209. package/test/units/static/JBFixedPointNumber/TestAdjustDecimals.sol +0 -16
  210. package/test/units/static/JBFixedPointNumber/TestAdjustDecimalsFuzz.sol +0 -71
  211. package/test/units/static/JBFundAccessLimits/JBFundAccessSetup.sol +0 -24
  212. package/test/units/static/JBFundAccessLimits/TestFundAccessLimitsEdge.sol +0 -163
  213. package/test/units/static/JBFundAccessLimits/TestPayoutLimitOf.sol +0 -59
  214. package/test/units/static/JBFundAccessLimits/TestPayoutLimitsOf.sol +0 -101
  215. package/test/units/static/JBFundAccessLimits/TestSetFundAccessLimitsFor.sol +0 -189
  216. package/test/units/static/JBFundAccessLimits/TestSurplusAllowanceOf.sol +0 -64
  217. package/test/units/static/JBFundAccessLimits/TestSurplusAllowancesOf.sol +0 -102
  218. package/test/units/static/JBMetadataResolver/TestGetDataFor.sol +0 -90
  219. package/test/units/static/JBMetadataResolver/TestMetadataResolverEdgeCases.sol +0 -247
  220. package/test/units/static/JBMetadataResolver/TestMetadataResolverFuzz.sol +0 -229
  221. package/test/units/static/JBMultiTerminal/JBMultiTerminalSetup.sol +0 -50
  222. package/test/units/static/JBMultiTerminal/TestAccountingContextsOf.sol +0 -72
  223. package/test/units/static/JBMultiTerminal/TestAddAccountingContextsFor.sol +0 -289
  224. package/test/units/static/JBMultiTerminal/TestAddToBalanceOf.sol +0 -474
  225. package/test/units/static/JBMultiTerminal/TestCashOutTokensOf.sol +0 -624
  226. package/test/units/static/JBMultiTerminal/TestExecutePayout.sol +0 -578
  227. package/test/units/static/JBMultiTerminal/TestExecuteProcessFee.sol +0 -202
  228. package/test/units/static/JBMultiTerminal/TestMigrateBalanceOf.sol +0 -222
  229. package/test/units/static/JBMultiTerminal/TestPay.sol +0 -604
  230. package/test/units/static/JBMultiTerminal/TestPreviewCashOutFrom.sol +0 -117
  231. package/test/units/static/JBMultiTerminal/TestPreviewPayFor.sol +0 -114
  232. package/test/units/static/JBMultiTerminal/TestProcessHeldFeesOf.sol +0 -228
  233. package/test/units/static/JBMultiTerminal/TestSelfPayRevert.sol +0 -55
  234. package/test/units/static/JBMultiTerminal/TestSendPayoutsOf.sol +0 -257
  235. package/test/units/static/JBMultiTerminal/TestUseAllowanceOf.sol +0 -611
  236. package/test/units/static/JBPermissions/JBPermissionsSetup.sol +0 -20
  237. package/test/units/static/JBPermissions/TestHasPermission.sol +0 -50
  238. package/test/units/static/JBPermissions/TestHasPermissions.sol +0 -93
  239. package/test/units/static/JBPermissions/TestSetPermissionsFor.sol +0 -64
  240. package/test/units/static/JBPrices/JBPricesSetup.sol +0 -32
  241. package/test/units/static/JBPrices/TestAddPriceFeedFor.sol +0 -107
  242. package/test/units/static/JBPrices/TestPricePerUnitOf.sol +0 -132
  243. package/test/units/static/JBPrices/TestPrices.sol +0 -265
  244. package/test/units/static/JBProjects/JBProjectsSetup.sol +0 -22
  245. package/test/units/static/JBProjects/TestCreateFor.sol +0 -71
  246. package/test/units/static/JBProjects/TestInitialProject.sol +0 -21
  247. package/test/units/static/JBProjects/TestInterfaces.sol +0 -26
  248. package/test/units/static/JBProjects/TestSetResolver.sol +0 -37
  249. package/test/units/static/JBProjects/TestTokenUri.sol +0 -40
  250. package/test/units/static/JBRulesetMetadataResolver/TestSetCashOutTaxRateTo.sol +0 -108
  251. package/test/units/static/JBRulesets/JBRulesetsSetup.sol +0 -24
  252. package/test/units/static/JBRulesets/TestCurrentApprovalStatusForLatestRulesetOf.sol +0 -265
  253. package/test/units/static/JBRulesets/TestCurrentOf.sol +0 -242
  254. package/test/units/static/JBRulesets/TestGetRulesetOf.sol +0 -100
  255. package/test/units/static/JBRulesets/TestLatestQueuedRulesetOf.sol +0 -260
  256. package/test/units/static/JBRulesets/TestRulesets.sol +0 -632
  257. package/test/units/static/JBRulesets/TestRulesetsOf.sol +0 -37
  258. package/test/units/static/JBRulesets/TestUpcomingRulesetOf.sol +0 -522
  259. package/test/units/static/JBRulesets/TestUpdateRulesetWeightCache.sol +0 -96
  260. package/test/units/static/JBSplits/JBSplitsSetup.sol +0 -26
  261. package/test/units/static/JBSplits/TestSelfManagedSplitGroups.sol +0 -552
  262. package/test/units/static/JBSplits/TestSetSplitGroupsOf.sol +0 -377
  263. package/test/units/static/JBSplits/TestSplitsLockedEdge.sol +0 -267
  264. package/test/units/static/JBSplits/TestSplitsOf.sol +0 -24
  265. package/test/units/static/JBSplits/TestSplitsPacking.sol +0 -36
  266. package/test/units/static/JBSurplus/TestSurplusFuzz.sol +0 -160
  267. package/test/units/static/JBTerminalStore/JBTerminalStoreSetup.sol +0 -45
  268. package/test/units/static/JBTerminalStore/TestCurrentReclaimableSurplusOf.sol +0 -536
  269. package/test/units/static/JBTerminalStore/TestCurrentSurplusOf.sol +0 -463
  270. package/test/units/static/JBTerminalStore/TestCurrentTotalSurplusOf.sol +0 -135
  271. package/test/units/static/JBTerminalStore/TestPreviewCashOutFrom.sol +0 -476
  272. package/test/units/static/JBTerminalStore/TestPreviewPayFrom.sol +0 -494
  273. package/test/units/static/JBTerminalStore/TestRecordCashOutsFor.sol +0 -652
  274. package/test/units/static/JBTerminalStore/TestRecordPaymentFrom.sol +0 -744
  275. package/test/units/static/JBTerminalStore/TestRecordPayoutFor.sol +0 -289
  276. package/test/units/static/JBTerminalStore/TestRecordTerminalMigration.sol +0 -138
  277. package/test/units/static/JBTerminalStore/TestRecordUsedAllowanceOf.sol +0 -415
  278. package/test/units/static/JBTerminalStore/TestUint224Overflow.sol +0 -219
  279. package/test/units/static/JBTokens/JBTokensSetup.sol +0 -32
  280. package/test/units/static/JBTokens/TestBurnFrom.sol +0 -107
  281. package/test/units/static/JBTokens/TestClaimTokensFor.sol +0 -110
  282. package/test/units/static/JBTokens/TestDeployERC20ForUnits.sol +0 -92
  283. package/test/units/static/JBTokens/TestMintFor.sol +0 -100
  284. package/test/units/static/JBTokens/TestSetTokenFor.sol +0 -98
  285. package/test/units/static/JBTokens/TestTotalBalanceOf.sol +0 -65
  286. package/test/units/static/JBTokens/TestTotalSupplyOf.sol +0 -56
  287. 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
- }