@boostxyz/sdk 0.0.0-alpha.10

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 (242) hide show
  1. package/LICENSE +674 -0
  2. package/README.md +7 -0
  3. package/dist/Actions/Action.cjs +2 -0
  4. package/dist/Actions/Action.cjs.map +1 -0
  5. package/dist/Actions/Action.d.ts +31 -0
  6. package/dist/Actions/Action.d.ts.map +1 -0
  7. package/dist/Actions/Action.js +29 -0
  8. package/dist/Actions/Action.js.map +1 -0
  9. package/dist/Actions/ContractAction.d.ts +370 -0
  10. package/dist/Actions/ContractAction.d.ts.map +1 -0
  11. package/dist/Actions/ERC721MintAction.d.ts +513 -0
  12. package/dist/Actions/ERC721MintAction.d.ts.map +1 -0
  13. package/dist/Actions/EventAction.cjs +2 -0
  14. package/dist/Actions/EventAction.cjs.map +1 -0
  15. package/dist/Actions/EventAction.d.ts +694 -0
  16. package/dist/Actions/EventAction.d.ts.map +1 -0
  17. package/dist/Actions/EventAction.js +491 -0
  18. package/dist/Actions/EventAction.js.map +1 -0
  19. package/dist/AllowLists/AllowList.cjs +2 -0
  20. package/dist/AllowLists/AllowList.cjs.map +1 -0
  21. package/dist/AllowLists/AllowList.d.ts +32 -0
  22. package/dist/AllowLists/AllowList.d.ts.map +1 -0
  23. package/dist/AllowLists/AllowList.js +30 -0
  24. package/dist/AllowLists/AllowList.js.map +1 -0
  25. package/dist/AllowLists/SimpleAllowList.cjs +2 -0
  26. package/dist/AllowLists/SimpleAllowList.cjs.map +1 -0
  27. package/dist/AllowLists/SimpleAllowList.d.ts +481 -0
  28. package/dist/AllowLists/SimpleAllowList.d.ts.map +1 -0
  29. package/dist/AllowLists/SimpleAllowList.js +154 -0
  30. package/dist/AllowLists/SimpleAllowList.js.map +1 -0
  31. package/dist/AllowLists/SimpleDenyList.cjs +2 -0
  32. package/dist/AllowLists/SimpleDenyList.cjs.map +1 -0
  33. package/dist/AllowLists/SimpleDenyList.d.ts +335 -0
  34. package/dist/AllowLists/SimpleDenyList.d.ts.map +1 -0
  35. package/dist/AllowLists/SimpleDenyList.js +115 -0
  36. package/dist/AllowLists/SimpleDenyList.js.map +1 -0
  37. package/dist/Auth/Auth.cjs +2 -0
  38. package/dist/Auth/Auth.cjs.map +1 -0
  39. package/dist/Auth/Auth.d.ts +10 -0
  40. package/dist/Auth/Auth.d.ts.map +1 -0
  41. package/dist/Auth/Auth.js +5 -0
  42. package/dist/Auth/Auth.js.map +1 -0
  43. package/dist/Auth/PassthroughAuth.cjs +2 -0
  44. package/dist/Auth/PassthroughAuth.cjs.map +1 -0
  45. package/dist/Auth/PassthroughAuth.d.ts +51 -0
  46. package/dist/Auth/PassthroughAuth.d.ts.map +1 -0
  47. package/dist/Auth/PassthroughAuth.js +39 -0
  48. package/dist/Auth/PassthroughAuth.js.map +1 -0
  49. package/dist/Boost.cjs +2 -0
  50. package/dist/Boost.cjs.map +1 -0
  51. package/dist/Boost.d.ts +234 -0
  52. package/dist/Boost.d.ts.map +1 -0
  53. package/dist/Boost.js +162 -0
  54. package/dist/Boost.js.map +1 -0
  55. package/dist/BoostCore.cjs +3 -0
  56. package/dist/BoostCore.cjs.map +1 -0
  57. package/dist/BoostCore.d.ts +498 -0
  58. package/dist/BoostCore.d.ts.map +1 -0
  59. package/dist/BoostCore.js +1153 -0
  60. package/dist/BoostCore.js.map +1 -0
  61. package/dist/BoostRegistry.cjs +2 -0
  62. package/dist/BoostRegistry.cjs.map +1 -0
  63. package/dist/BoostRegistry.d.ts +243 -0
  64. package/dist/BoostRegistry.d.ts.map +1 -0
  65. package/dist/BoostRegistry.js +262 -0
  66. package/dist/BoostRegistry.js.map +1 -0
  67. package/dist/Budgets/Budget.cjs +2 -0
  68. package/dist/Budgets/Budget.cjs.map +1 -0
  69. package/dist/Budgets/Budget.d.ts +31 -0
  70. package/dist/Budgets/Budget.d.ts.map +1 -0
  71. package/dist/Budgets/Budget.js +29 -0
  72. package/dist/Budgets/Budget.js.map +1 -0
  73. package/dist/Budgets/ManagedBudget.cjs +2 -0
  74. package/dist/Budgets/ManagedBudget.cjs.map +1 -0
  75. package/dist/Budgets/ManagedBudget.d.ts +1103 -0
  76. package/dist/Budgets/ManagedBudget.d.ts.map +1 -0
  77. package/dist/Budgets/ManagedBudget.js +516 -0
  78. package/dist/Budgets/ManagedBudget.js.map +1 -0
  79. package/dist/Budgets/SimpleBudget.d.ts +824 -0
  80. package/dist/Budgets/SimpleBudget.d.ts.map +1 -0
  81. package/dist/Budgets/VestingBudget.d.ts +778 -0
  82. package/dist/Budgets/VestingBudget.d.ts.map +1 -0
  83. package/dist/Deployable/Contract.cjs +2 -0
  84. package/dist/Deployable/Contract.cjs.map +1 -0
  85. package/dist/Deployable/Contract.d.ts +125 -0
  86. package/dist/Deployable/Contract.d.ts.map +1 -0
  87. package/dist/Deployable/Contract.js +150 -0
  88. package/dist/Deployable/Contract.js.map +1 -0
  89. package/dist/Deployable/Deployable.cjs +2 -0
  90. package/dist/Deployable/Deployable.cjs.map +1 -0
  91. package/dist/Deployable/Deployable.d.ts +161 -0
  92. package/dist/Deployable/Deployable.d.ts.map +1 -0
  93. package/dist/Deployable/Deployable.js +131 -0
  94. package/dist/Deployable/Deployable.js.map +1 -0
  95. package/dist/Deployable/DeployableTarget.cjs +2 -0
  96. package/dist/Deployable/DeployableTarget.cjs.map +1 -0
  97. package/dist/Deployable/DeployableTarget.d.ts +116 -0
  98. package/dist/Deployable/DeployableTarget.d.ts.map +1 -0
  99. package/dist/Deployable/DeployableTarget.js +132 -0
  100. package/dist/Deployable/DeployableTarget.js.map +1 -0
  101. package/dist/Incentives/AllowListIncentive.cjs +2 -0
  102. package/dist/Incentives/AllowListIncentive.cjs.map +1 -0
  103. package/dist/Incentives/AllowListIncentive.d.ts +513 -0
  104. package/dist/Incentives/AllowListIncentive.d.ts.map +1 -0
  105. package/dist/Incentives/AllowListIncentive.js +201 -0
  106. package/dist/Incentives/AllowListIncentive.js.map +1 -0
  107. package/dist/Incentives/CGDAIncentive.cjs +2 -0
  108. package/dist/Incentives/CGDAIncentive.cjs.map +1 -0
  109. package/dist/Incentives/CGDAIncentive.d.ts +644 -0
  110. package/dist/Incentives/CGDAIncentive.d.ts.map +1 -0
  111. package/dist/Incentives/CGDAIncentive.js +271 -0
  112. package/dist/Incentives/CGDAIncentive.js.map +1 -0
  113. package/dist/Incentives/ERC1155Incentive.d.ts +713 -0
  114. package/dist/Incentives/ERC1155Incentive.d.ts.map +1 -0
  115. package/dist/Incentives/ERC20Incentive.cjs +2 -0
  116. package/dist/Incentives/ERC20Incentive.cjs.map +1 -0
  117. package/dist/Incentives/ERC20Incentive.d.ts +666 -0
  118. package/dist/Incentives/ERC20Incentive.d.ts.map +1 -0
  119. package/dist/Incentives/ERC20Incentive.js +312 -0
  120. package/dist/Incentives/ERC20Incentive.js.map +1 -0
  121. package/dist/Incentives/ERC20VariableIncentive.d.ts +582 -0
  122. package/dist/Incentives/ERC20VariableIncentive.d.ts.map +1 -0
  123. package/dist/Incentives/Incentive.cjs +2 -0
  124. package/dist/Incentives/Incentive.cjs.map +1 -0
  125. package/dist/Incentives/Incentive.d.ts +36 -0
  126. package/dist/Incentives/Incentive.d.ts.map +1 -0
  127. package/dist/Incentives/Incentive.js +299 -0
  128. package/dist/Incentives/Incentive.js.map +1 -0
  129. package/dist/Incentives/PointsIncentive.cjs +2 -0
  130. package/dist/Incentives/PointsIncentive.cjs.map +1 -0
  131. package/dist/Incentives/PointsIncentive.d.ts +659 -0
  132. package/dist/Incentives/PointsIncentive.d.ts.map +1 -0
  133. package/dist/Incentives/PointsIncentive.js +215 -0
  134. package/dist/Incentives/PointsIncentive.js.map +1 -0
  135. package/dist/Validators/SignerValidator.cjs +2 -0
  136. package/dist/Validators/SignerValidator.cjs.map +1 -0
  137. package/dist/Validators/SignerValidator.d.ts +745 -0
  138. package/dist/Validators/SignerValidator.d.ts.map +1 -0
  139. package/dist/Validators/SignerValidator.js +293 -0
  140. package/dist/Validators/SignerValidator.js.map +1 -0
  141. package/dist/Validators/Validator.cjs +2 -0
  142. package/dist/Validators/Validator.cjs.map +1 -0
  143. package/dist/Validators/Validator.d.ts +31 -0
  144. package/dist/Validators/Validator.d.ts.map +1 -0
  145. package/dist/Validators/Validator.js +27 -0
  146. package/dist/Validators/Validator.js.map +1 -0
  147. package/dist/claiming.cjs +2 -0
  148. package/dist/claiming.cjs.map +1 -0
  149. package/dist/claiming.d.ts +43 -0
  150. package/dist/claiming.d.ts.map +1 -0
  151. package/dist/claiming.js +17 -0
  152. package/dist/claiming.js.map +1 -0
  153. package/dist/componentInterfaces-CKCBwG16.cjs +2 -0
  154. package/dist/componentInterfaces-CKCBwG16.cjs.map +1 -0
  155. package/dist/componentInterfaces-DYkaxBda.js +13 -0
  156. package/dist/componentInterfaces-DYkaxBda.js.map +1 -0
  157. package/dist/errors.cjs +2 -0
  158. package/dist/errors.cjs.map +1 -0
  159. package/dist/errors.d.ts +441 -0
  160. package/dist/errors.d.ts.map +1 -0
  161. package/dist/errors.js +262 -0
  162. package/dist/errors.js.map +1 -0
  163. package/dist/generated-BDeDiaCK.js +4625 -0
  164. package/dist/generated-BDeDiaCK.js.map +1 -0
  165. package/dist/generated-wKBNvm48.cjs +3 -0
  166. package/dist/generated-wKBNvm48.cjs.map +1 -0
  167. package/dist/index.cjs +2 -0
  168. package/dist/index.cjs.map +1 -0
  169. package/dist/index.d.ts +25 -0
  170. package/dist/index.d.ts.map +1 -0
  171. package/dist/index.js +113 -0
  172. package/dist/index.js.map +1 -0
  173. package/dist/transfers.cjs +2 -0
  174. package/dist/transfers.cjs.map +1 -0
  175. package/dist/transfers.d.ts +198 -0
  176. package/dist/transfers.d.ts.map +1 -0
  177. package/dist/transfers.js +84 -0
  178. package/dist/transfers.js.map +1 -0
  179. package/dist/utils.cjs +2 -0
  180. package/dist/utils.cjs.map +1 -0
  181. package/dist/utils.d.ts +116 -0
  182. package/dist/utils.d.ts.map +1 -0
  183. package/dist/utils.js +30 -0
  184. package/dist/utils.js.map +1 -0
  185. package/package.json +211 -0
  186. package/src/Actions/Action.test.ts +75 -0
  187. package/src/Actions/Action.ts +61 -0
  188. package/src/Actions/ContractAction.test.ts +197 -0
  189. package/src/Actions/ContractAction.ts +301 -0
  190. package/src/Actions/ERC721MintAction.test.ts +112 -0
  191. package/src/Actions/ERC721MintAction.ts +292 -0
  192. package/src/Actions/EventAction.test.ts +205 -0
  193. package/src/Actions/EventAction.ts +811 -0
  194. package/src/AllowLists/AllowList.test.ts +64 -0
  195. package/src/AllowLists/AllowList.ts +60 -0
  196. package/src/AllowLists/SimpleAllowList.test.ts +52 -0
  197. package/src/AllowLists/SimpleAllowList.ts +284 -0
  198. package/src/AllowLists/SimpleDenyList.test.ts +52 -0
  199. package/src/AllowLists/SimpleDenyList.ts +227 -0
  200. package/src/Auth/Auth.ts +11 -0
  201. package/src/Auth/PassthroughAuth.test.ts +12 -0
  202. package/src/Auth/PassthroughAuth.ts +80 -0
  203. package/src/Boost.ts +290 -0
  204. package/src/BoostCore.test.ts +773 -0
  205. package/src/BoostCore.ts +1261 -0
  206. package/src/BoostRegistry.ts +467 -0
  207. package/src/Budgets/Budget.test.ts +27 -0
  208. package/src/Budgets/Budget.ts +61 -0
  209. package/src/Budgets/ManagedBudget.test.ts +154 -0
  210. package/src/Budgets/ManagedBudget.ts +796 -0
  211. package/src/Budgets/SimpleBudget.test.ts +152 -0
  212. package/src/Budgets/SimpleBudget.ts +564 -0
  213. package/src/Budgets/VestingBudget.test.ts +123 -0
  214. package/src/Budgets/VestingBudget.ts +602 -0
  215. package/src/Deployable/Contract.ts +229 -0
  216. package/src/Deployable/Deployable.ts +250 -0
  217. package/src/Deployable/DeployableTarget.ts +223 -0
  218. package/src/Incentives/AllowListIncentive.test.ts +143 -0
  219. package/src/Incentives/AllowListIncentive.ts +334 -0
  220. package/src/Incentives/CGDAIncentive.test.ts +132 -0
  221. package/src/Incentives/CGDAIncentive.ts +468 -0
  222. package/src/Incentives/ERC1155Incentive.test.ts +87 -0
  223. package/src/Incentives/ERC1155Incentive.ts +466 -0
  224. package/src/Incentives/ERC20Incentive.test.ts +130 -0
  225. package/src/Incentives/ERC20Incentive.ts +482 -0
  226. package/src/Incentives/ERC20VariableIncentive.test.ts +136 -0
  227. package/src/Incentives/ERC20VariableIncentive.ts +420 -0
  228. package/src/Incentives/Incentive.test.ts +92 -0
  229. package/src/Incentives/Incentive.ts +85 -0
  230. package/src/Incentives/PointsIncentive.test.ts +139 -0
  231. package/src/Incentives/PointsIncentive.ts +365 -0
  232. package/src/Validators/SignerValidator.test.ts +159 -0
  233. package/src/Validators/SignerValidator.ts +681 -0
  234. package/src/Validators/Validator.test.ts +21 -0
  235. package/src/Validators/Validator.ts +55 -0
  236. package/src/claiming.ts +56 -0
  237. package/src/errors.ts +542 -0
  238. package/src/index.test.ts +40 -0
  239. package/src/index.ts +53 -0
  240. package/src/transfers.ts +284 -0
  241. package/src/utils.test.ts +44 -0
  242. package/src/utils.ts +198 -0
@@ -0,0 +1,205 @@
1
+ import { selectors as eventSelectors } from '@boostxyz/signatures/events';
2
+ import { loadFixture } from '@nomicfoundation/hardhat-network-helpers';
3
+ import { type Hex, type Log, isAddress } from 'viem';
4
+ import { beforeAll, beforeEach, describe, expect, test } from 'vitest';
5
+ import type { MockERC721 } from '../../test/MockERC721';
6
+ import { accounts } from '../../test/accounts';
7
+ import {
8
+ type Fixtures,
9
+ defaultOptions,
10
+ deployFixtures,
11
+ fundErc721,
12
+ } from '../../test/helpers';
13
+ import {
14
+ EventAction,
15
+ type EventActionPayloadSimple,
16
+ FilterType,
17
+ PrimitiveType,
18
+ SignatureType,
19
+ } from './EventAction';
20
+
21
+ let fixtures: Fixtures, erc721: MockERC721;
22
+
23
+ beforeAll(async () => {
24
+ fixtures = await loadFixture(deployFixtures);
25
+ });
26
+
27
+ function basicErc721TransferAction(
28
+ erc721: MockERC721,
29
+ ): EventActionPayloadSimple {
30
+ return {
31
+ actionClaimant: {
32
+ signatureType: SignatureType.EVENT,
33
+ signature: eventSelectors['Transfer(address,address,uint256)'] as Hex,
34
+ fieldIndex: 2,
35
+ targetContract: erc721.assertValidAddress(),
36
+ chainid: defaultOptions.config.chains[0].id,
37
+ },
38
+ actionSteps: [
39
+ {
40
+ signature: eventSelectors['Transfer(address,address,uint256)'] as Hex,
41
+ signatureType: SignatureType.EVENT,
42
+ targetContract: erc721.assertValidAddress(),
43
+ chainid: defaultOptions.config.chains[0].id,
44
+ actionParameter: {
45
+ filterType: FilterType.EQUAL,
46
+ fieldType: PrimitiveType.ADDRESS,
47
+ fieldIndex: 2,
48
+ filterData: accounts[1].account,
49
+ },
50
+ },
51
+ ],
52
+ };
53
+ }
54
+
55
+ /*
56
+ function basicErc721MintFuncAction(
57
+ erc721: MockERC721,
58
+ ): EventActionPayloadSimple {
59
+ return {
60
+ actionClaimant: {
61
+ signatureType: SignatureType.FUNC,
62
+ signature: funcSelectors['mint(address)'] as Hex,
63
+ fieldIndex: 0,
64
+ targetContract: erc721.assertValidAddress(),
65
+ },
66
+ actionSteps: [
67
+ {
68
+ signature: funcSelectors['mint(address)'] as Hex,
69
+ signatureType: SignatureType.FUNC,
70
+ actionType: 0,
71
+ targetContract: erc721.assertValidAddress(),
72
+ actionParameter: {
73
+ filterType: FilterType.EQUAL,
74
+ fieldType: PrimitiveType.ADDRESS,
75
+ fieldIndex: 2,
76
+ filterData: accounts[1].account,
77
+ },
78
+ },
79
+ ],
80
+ };
81
+ }
82
+ */
83
+
84
+ function cloneEventAction(fixtures: Fixtures, erc721: MockERC721) {
85
+ return function cloneEventAction() {
86
+ return fixtures.registry.clone(
87
+ crypto.randomUUID(),
88
+ fixtures.core.EventAction(basicErc721TransferAction(erc721)),
89
+ );
90
+ };
91
+ }
92
+
93
+ describe('EventAction', () => {
94
+ beforeEach(async () => {
95
+ erc721 = await loadFixture(fundErc721(defaultOptions));
96
+ });
97
+
98
+ test('can successfully be deployed', async () => {
99
+ const action = new EventAction(
100
+ defaultOptions,
101
+ basicErc721TransferAction(erc721),
102
+ );
103
+ await action.deploy();
104
+ expect(isAddress(action.assertValidAddress())).toBe(true);
105
+ });
106
+
107
+ test('can get an action step', async () => {
108
+ const action = await loadFixture(cloneEventAction(fixtures, erc721));
109
+ const step = await action.getActionStep(0);
110
+ if (!step) throw new Error('there should be an action step at this index');
111
+ step.targetContract = step.targetContract.toUpperCase() as Hex;
112
+ step.actionParameter.filterData =
113
+ step.actionParameter.filterData.toUpperCase() as Hex;
114
+ expect(step).toMatchObject({
115
+ signature: eventSelectors['Transfer(address,address,uint256)'] as Hex,
116
+ signatureType: SignatureType.EVENT,
117
+ actionType: 0,
118
+ targetContract: erc721.assertValidAddress().toUpperCase(),
119
+ actionParameter: {
120
+ filterType: FilterType.EQUAL,
121
+ fieldType: PrimitiveType.ADDRESS,
122
+ fieldIndex: 2,
123
+ filterData: accounts[1].account.toUpperCase(),
124
+ },
125
+ });
126
+ });
127
+
128
+ test('can get all action steps', async () => {
129
+ const action = await loadFixture(cloneEventAction(fixtures, erc721));
130
+ const steps = await action.getActionSteps();
131
+ expect(steps.length).toBe(1);
132
+ const step = steps[0]!;
133
+ step.targetContract = step.targetContract.toUpperCase() as Hex;
134
+ step.actionParameter.filterData =
135
+ step.actionParameter.filterData.toUpperCase() as Hex;
136
+ expect(step).toMatchObject({
137
+ signature: eventSelectors['Transfer(address,address,uint256)'] as Hex,
138
+ signatureType: SignatureType.EVENT,
139
+ actionType: 0,
140
+ targetContract: erc721.assertValidAddress().toUpperCase(),
141
+ actionParameter: {
142
+ filterType: FilterType.EQUAL,
143
+ fieldType: PrimitiveType.ADDRESS,
144
+ fieldIndex: 2,
145
+ filterData: accounts[1].account.toUpperCase(),
146
+ },
147
+ });
148
+ });
149
+
150
+ test('can get the total number of action steps', async () => {
151
+ const action = await loadFixture(cloneEventAction(fixtures, erc721));
152
+ const count = await action.getActionStepsCount();
153
+ expect(count).toBe(1);
154
+ });
155
+
156
+ test('can get the action claimant', async () => {
157
+ const action = await loadFixture(cloneEventAction(fixtures, erc721));
158
+ const claimant = await action.getActionClaimant();
159
+ claimant.targetContract = claimant.targetContract.toUpperCase() as Hex;
160
+ expect(claimant).toMatchObject({
161
+ signatureType: SignatureType.EVENT,
162
+ signature: eventSelectors['Transfer(address,address,uint256)'] as Hex,
163
+ fieldIndex: 2,
164
+ targetContract: erc721.assertValidAddress().toUpperCase(),
165
+ });
166
+ });
167
+
168
+ test('with no logs, does not validate', async () => {
169
+ const action = await loadFixture(cloneEventAction(fixtures, erc721));
170
+ expect(await action.validateActionSteps()).toBe(false);
171
+ });
172
+
173
+ test('with a correct log, validates', async () => {
174
+ const action = await loadFixture(cloneEventAction(fixtures, erc721));
175
+ const recipient = accounts[1].account;
176
+ await erc721.approve(recipient, 1n);
177
+ await erc721.transferFrom(defaultOptions.account.address, recipient, 1n);
178
+ expect(await action.validateActionSteps()).toBe(true);
179
+ });
180
+
181
+ test('can supply your own logs to validate against', async () => {
182
+ const log = {
183
+ eventName: 'Transfer',
184
+ args: undefined,
185
+ address: erc721.assertValidAddress(),
186
+ blockHash:
187
+ '0xbf602f988260519805d032be46d6ff97fbefbee6924b21097074d6d0bc34eced',
188
+ blockNumber: 1203n,
189
+ data: '0x',
190
+ logIndex: 0,
191
+ removed: false,
192
+ topics: [
193
+ '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
194
+ '0x000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266',
195
+ '0x00000000000000000000000070997970c51812dc3a010c7d01b50e0d17dc79c8',
196
+ '0x0000000000000000000000000000000000000000000000000000000000000001',
197
+ ],
198
+ transactionHash:
199
+ '0xff0e6ab0c4961ec14b7b40afec83ed7d7a77582683512a262e641d21f82efea5',
200
+ transactionIndex: 0,
201
+ } as Log;
202
+ const action = await loadFixture(cloneEventAction(fixtures, erc721));
203
+ expect(await action.validateActionSteps({ logs: [log] })).toBe(true);
204
+ });
205
+ });