@waku/rln 0.1.5-ea6daae.0 → 0.1.5-ec5db88.0

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 (143) hide show
  1. package/README.md +5 -0
  2. package/bundle/_virtual/index2.js +1 -1
  3. package/bundle/_virtual/utils.js +2 -2
  4. package/bundle/_virtual/utils2.js +2 -2
  5. package/bundle/index.js +3 -1
  6. package/bundle/node_modules/@ethersproject/abi/lib.esm/_version.js +1 -1
  7. package/bundle/node_modules/@ethersproject/abstract-provider/lib.esm/_version.js +1 -1
  8. package/bundle/node_modules/@ethersproject/abstract-signer/lib.esm/_version.js +1 -1
  9. package/bundle/node_modules/@ethersproject/address/lib.esm/_version.js +1 -1
  10. package/bundle/node_modules/@ethersproject/bignumber/lib.esm/_version.js +1 -1
  11. package/bundle/node_modules/@ethersproject/contracts/lib.esm/_version.js +1 -1
  12. package/bundle/node_modules/@ethersproject/contracts/lib.esm/index.js +1 -1
  13. package/bundle/node_modules/@ethersproject/hash/lib.esm/_version.js +1 -1
  14. package/bundle/node_modules/@ethersproject/keccak256/lib.esm/index.js +1 -1
  15. package/bundle/node_modules/{js-sha3 → @ethersproject/keccak256/node_modules/js-sha3}/src/sha3.js +2 -2
  16. package/bundle/node_modules/@ethersproject/networks/lib.esm/_version.js +1 -1
  17. package/bundle/node_modules/@ethersproject/networks/lib.esm/index.js +1 -19
  18. package/bundle/node_modules/@ethersproject/properties/lib.esm/_version.js +1 -1
  19. package/bundle/node_modules/@ethersproject/providers/lib.esm/_version.js +1 -1
  20. package/bundle/node_modules/@ethersproject/signing-key/lib.esm/_version.js +1 -1
  21. package/bundle/node_modules/@ethersproject/signing-key/lib.esm/elliptic.js +10 -58
  22. package/bundle/node_modules/@ethersproject/strings/lib.esm/_version.js +1 -1
  23. package/bundle/node_modules/@ethersproject/transactions/lib.esm/_version.js +1 -1
  24. package/bundle/node_modules/@ethersproject/web/lib.esm/_version.js +1 -1
  25. package/bundle/packages/rln/dist/contract/abi.js +502 -248
  26. package/bundle/packages/rln/dist/contract/constants.js +5 -8
  27. package/bundle/packages/rln/dist/contract/rln_base_contract.js +465 -0
  28. package/bundle/packages/rln/dist/contract/rln_contract.js +31 -357
  29. package/bundle/packages/rln/dist/contract/types.js +9 -0
  30. package/bundle/packages/rln/dist/create.js +1 -1
  31. package/bundle/packages/rln/dist/credentials_manager.js +215 -0
  32. package/bundle/packages/rln/dist/keystore/cipher.js +3 -3
  33. package/bundle/packages/rln/dist/keystore/keystore.js +12 -7
  34. package/bundle/packages/rln/dist/rln.js +56 -166
  35. package/bundle/packages/rln/dist/zerokit.js +5 -5
  36. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/checksum.js +3 -3
  37. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/cipher.js +4 -4
  38. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/class.js +7 -7
  39. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/functional.js +7 -7
  40. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/index.js +6 -6
  41. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/kdf.js +5 -5
  42. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/password.js +1 -1
  43. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/schema-validation-generated.js +1 -1
  44. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/schema-validation.js +2 -2
  45. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/lib/types.js +1 -1
  46. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/ethereum-cryptography/aes.js +3 -3
  47. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/ethereum-cryptography/pbkdf2.js +7 -7
  48. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/ethereum-cryptography/random.js +3 -3
  49. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/ethereum-cryptography/scrypt.js +3 -3
  50. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/ethereum-cryptography/sha256.js +3 -3
  51. package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/ethereum-cryptography/utils.js +7 -7
  52. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/_assert.js +1 -1
  53. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/_sha2.js +3 -3
  54. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/_u64.js +1 -1
  55. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/cryptoBrowser.js +1 -1
  56. package/bundle/packages/rln/node_modules/@noble/hashes/esm/_assert.js +43 -0
  57. package/bundle/packages/rln/node_modules/@noble/hashes/esm/_sha2.js +116 -0
  58. package/bundle/packages/rln/node_modules/@noble/hashes/esm/hmac.js +79 -0
  59. package/bundle/packages/rln/node_modules/@noble/hashes/esm/sha256.js +126 -0
  60. package/bundle/packages/rln/node_modules/@noble/hashes/esm/utils.js +43 -0
  61. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/hmac.js +3 -3
  62. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/pbkdf2.js +4 -4
  63. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/scrypt.js +5 -5
  64. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/sha256.js +3 -3
  65. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/sha512.js +4 -4
  66. package/bundle/{node_modules/@chainsafe/bls-keystore → packages/rln}/node_modules/@noble/hashes/utils.js +2 -2
  67. package/dist/.tsbuildinfo +1 -1
  68. package/dist/codec.test-utils.d.ts +36 -0
  69. package/dist/codec.test-utils.js +56 -0
  70. package/dist/codec.test-utils.js.map +1 -0
  71. package/dist/contract/abi.d.ts +21 -17
  72. package/dist/contract/abi.js +502 -248
  73. package/dist/contract/abi.js.map +1 -1
  74. package/dist/contract/constants.d.ts +22 -18
  75. package/dist/contract/constants.js +3 -3
  76. package/dist/contract/constants.js.map +1 -1
  77. package/dist/contract/rln_base_contract.d.ts +90 -0
  78. package/dist/contract/rln_base_contract.js +448 -0
  79. package/dist/contract/rln_base_contract.js.map +1 -0
  80. package/dist/contract/rln_contract.d.ts +5 -115
  81. package/dist/contract/rln_contract.js +30 -355
  82. package/dist/contract/rln_contract.js.map +1 -1
  83. package/dist/contract/test-setup.d.ts +26 -0
  84. package/dist/contract/test-setup.js +56 -0
  85. package/dist/contract/test-setup.js.map +1 -0
  86. package/dist/contract/test-utils.d.ts +39 -0
  87. package/dist/contract/test-utils.js +118 -0
  88. package/dist/contract/test-utils.js.map +1 -0
  89. package/dist/contract/types.d.ts +45 -0
  90. package/dist/contract/types.js +8 -0
  91. package/dist/contract/types.js.map +1 -0
  92. package/dist/create.js +1 -1
  93. package/dist/create.js.map +1 -1
  94. package/dist/credentials_manager.d.ts +44 -0
  95. package/dist/credentials_manager.js +197 -0
  96. package/dist/credentials_manager.js.map +1 -0
  97. package/dist/index.d.ts +5 -2
  98. package/dist/index.js +4 -2
  99. package/dist/index.js.map +1 -1
  100. package/dist/keystore/keystore.js +11 -6
  101. package/dist/keystore/keystore.js.map +1 -1
  102. package/dist/keystore/types.d.ts +2 -1
  103. package/dist/rln.d.ts +9 -52
  104. package/dist/rln.js +54 -163
  105. package/dist/rln.js.map +1 -1
  106. package/dist/types.d.ts +27 -0
  107. package/dist/types.js +2 -0
  108. package/dist/types.js.map +1 -0
  109. package/dist/zerokit.d.ts +3 -3
  110. package/dist/zerokit.js +5 -5
  111. package/dist/zerokit.js.map +1 -1
  112. package/package.json +1 -1
  113. package/src/codec.test-utils.ts +80 -0
  114. package/src/contract/abi.ts +502 -248
  115. package/src/contract/constants.ts +3 -3
  116. package/src/contract/rln_base_contract.ts +684 -0
  117. package/src/contract/rln_contract.ts +37 -579
  118. package/src/contract/test-setup.ts +86 -0
  119. package/src/contract/test-utils.ts +179 -0
  120. package/src/contract/types.ts +53 -0
  121. package/src/create.ts +1 -1
  122. package/src/credentials_manager.ts +282 -0
  123. package/src/index.ts +17 -2
  124. package/src/keystore/keystore.ts +19 -10
  125. package/src/keystore/types.ts +2 -1
  126. package/src/rln.ts +67 -258
  127. package/src/types.ts +31 -0
  128. package/src/zerokit.ts +3 -3
  129. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/index.js +0 -0
  130. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/md5.js +0 -0
  131. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/nil.js +0 -0
  132. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/parse.js +0 -0
  133. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/regex.js +0 -0
  134. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/rng.js +0 -0
  135. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/sha1.js +0 -0
  136. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/stringify.js +0 -0
  137. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/v1.js +0 -0
  138. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/v3.js +0 -0
  139. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/v35.js +0 -0
  140. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/v4.js +0 -0
  141. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/v5.js +0 -0
  142. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/validate.js +0 -0
  143. /package/bundle/{node_modules → packages/rln/node_modules}/@chainsafe/bls-keystore/node_modules/uuid/dist/esm-browser/version.js +0 -0
@@ -1,8 +1,8 @@
1
1
  import { RLN_ABI } from './abi.js';
2
2
 
3
- const SEPOLIA_CONTRACT = {
4
- chainId: 11155111,
5
- address: "0xCB33Aa5B38d79E3D9Fa8B10afF38AA201399a7e3",
3
+ const LINEA_CONTRACT = {
4
+ chainId: 59141,
5
+ address: "0xb9cd878c90e49f797b4431fbf4fb333108cb90e6",
6
6
  abi: RLN_ABI
7
7
  };
8
8
  /**
@@ -17,10 +17,7 @@ const RATE_LIMIT_TIERS = {
17
17
  // Global rate limit parameters
18
18
  const RATE_LIMIT_PARAMS = {
19
19
  MIN_RATE: RATE_LIMIT_TIERS.LOW,
20
- MAX_RATE: RATE_LIMIT_TIERS.HIGH,
21
- MAX_TOTAL_RATE: 160_000, // Maximum total rate limit across all memberships
22
- EPOCH_LENGTH: 600 // Epoch length in seconds (10 minutes)
23
- };
20
+ MAX_RATE: RATE_LIMIT_TIERS.HIGH};
24
21
  const DEFAULT_RATE_LIMIT = RATE_LIMIT_PARAMS.MAX_RATE;
25
22
 
26
- export { DEFAULT_RATE_LIMIT, RATE_LIMIT_PARAMS, RATE_LIMIT_TIERS, SEPOLIA_CONTRACT };
23
+ export { DEFAULT_RATE_LIMIT, LINEA_CONTRACT, RATE_LIMIT_PARAMS, RATE_LIMIT_TIERS };
@@ -0,0 +1,465 @@
1
+ import '../../../interfaces/dist/protocols.js';
2
+ import '../../../interfaces/dist/connection_manager.js';
3
+ import '../../../interfaces/dist/health_indicator.js';
4
+ import '../../../../node_modules/multiformats/dist/src/bases/base10.js';
5
+ import '../../../../node_modules/multiformats/dist/src/bases/base16.js';
6
+ import '../../../../node_modules/multiformats/dist/src/bases/base2.js';
7
+ import '../../../../node_modules/multiformats/dist/src/bases/base256emoji.js';
8
+ import '../../../../node_modules/multiformats/dist/src/bases/base32.js';
9
+ import '../../../../node_modules/multiformats/dist/src/bases/base36.js';
10
+ import '../../../../node_modules/multiformats/dist/src/bases/base58.js';
11
+ import '../../../../node_modules/multiformats/dist/src/bases/base64.js';
12
+ import '../../../../node_modules/multiformats/dist/src/bases/base8.js';
13
+ import '../../../../node_modules/multiformats/dist/src/bases/identity.js';
14
+ import '../../../../node_modules/multiformats/dist/src/codecs/json.js';
15
+ import { Logger } from '../../../utils/dist/logger/index.js';
16
+ import { RLN_ABI } from './abi.js';
17
+ import { DEFAULT_RATE_LIMIT, RATE_LIMIT_PARAMS } from './constants.js';
18
+ import { MembershipState } from './types.js';
19
+ import { Contract } from '../../../../node_modules/@ethersproject/contracts/lib.esm/index.js';
20
+ import { BigNumber } from '../../../../node_modules/@ethersproject/bignumber/lib.esm/bignumber.js';
21
+
22
+ const log = new Logger("waku:rln:contract:base");
23
+ class RLNBaseContract {
24
+ contract;
25
+ deployBlock;
26
+ rateLimit;
27
+ _members = new Map();
28
+ _membersFilter;
29
+ _membershipErasedFilter;
30
+ _membersExpiredFilter;
31
+ /**
32
+ * Constructor for RLNBaseContract.
33
+ * Allows injecting a mocked contract for testing purposes.
34
+ */
35
+ constructor(options) {
36
+ const { address, signer, rateLimit = DEFAULT_RATE_LIMIT, contract } = options;
37
+ this.contract = contract || new Contract(address, RLN_ABI, signer);
38
+ this.rateLimit = rateLimit;
39
+ // Initialize event filters
40
+ this._membersFilter = this.contract.filters.MembershipRegistered();
41
+ this._membershipErasedFilter = this.contract.filters.MembershipErased();
42
+ this._membersExpiredFilter = this.contract.filters.MembershipExpired();
43
+ // Initialize members and subscriptions
44
+ this.fetchMembers()
45
+ .then(() => {
46
+ this.subscribeToMembers();
47
+ })
48
+ .catch((error) => {
49
+ log.error("Failed to initialize members", { error });
50
+ });
51
+ // Validate rate limit asynchronously
52
+ this.validateRateLimit(rateLimit).catch((error) => {
53
+ log.error("Failed to validate initial rate limit", { error });
54
+ });
55
+ }
56
+ /**
57
+ * Gets the current rate limit for this contract instance
58
+ */
59
+ getRateLimit() {
60
+ return this.rateLimit;
61
+ }
62
+ /**
63
+ * Gets the contract address
64
+ */
65
+ get address() {
66
+ return this.contract.address;
67
+ }
68
+ /**
69
+ * Gets the contract provider
70
+ */
71
+ get provider() {
72
+ return this.contract.provider;
73
+ }
74
+ /**
75
+ * Gets the minimum allowed rate limit from the contract
76
+ * @returns Promise<number> The minimum rate limit in messages per epoch
77
+ */
78
+ async getMinRateLimit() {
79
+ const minRate = await this.contract.minMembershipRateLimit();
80
+ return BigNumber.from(minRate).toNumber();
81
+ }
82
+ /**
83
+ * Gets the maximum allowed rate limit from the contract
84
+ * @returns Promise<number> The maximum rate limit in messages per epoch
85
+ */
86
+ async getMaxRateLimit() {
87
+ const maxRate = await this.contract.maxMembershipRateLimit();
88
+ return BigNumber.from(maxRate).toNumber();
89
+ }
90
+ /**
91
+ * Gets the maximum total rate limit across all memberships
92
+ * @returns Promise<number> The maximum total rate limit in messages per epoch
93
+ */
94
+ async getMaxTotalRateLimit() {
95
+ const maxTotalRate = await this.contract.maxTotalRateLimit();
96
+ return maxTotalRate.toNumber();
97
+ }
98
+ /**
99
+ * Gets the current total rate limit usage across all memberships
100
+ * @returns Promise<number> The current total rate limit usage in messages per epoch
101
+ */
102
+ async getCurrentTotalRateLimit() {
103
+ const currentTotal = await this.contract.currentTotalRateLimit();
104
+ return currentTotal.toNumber();
105
+ }
106
+ /**
107
+ * Gets the remaining available total rate limit that can be allocated
108
+ * @returns Promise<number> The remaining rate limit that can be allocated
109
+ */
110
+ async getRemainingTotalRateLimit() {
111
+ const [maxTotal, currentTotal] = await Promise.all([
112
+ this.contract.maxTotalRateLimit(),
113
+ this.contract.currentTotalRateLimit()
114
+ ]);
115
+ return Number(maxTotal) - Number(currentTotal);
116
+ }
117
+ /**
118
+ * Updates the rate limit for future registrations
119
+ * @param newRateLimit The new rate limit to use
120
+ */
121
+ async setRateLimit(newRateLimit) {
122
+ await this.validateRateLimit(newRateLimit);
123
+ this.rateLimit = newRateLimit;
124
+ }
125
+ get members() {
126
+ const sortedMembers = Array.from(this._members.values()).sort((left, right) => left.index.toNumber() - right.index.toNumber());
127
+ return sortedMembers;
128
+ }
129
+ async fetchMembers(options = {}) {
130
+ const registeredMemberEvents = await RLNBaseContract.queryFilter(this.contract, {
131
+ fromBlock: this.deployBlock,
132
+ ...options,
133
+ membersFilter: this.membersFilter
134
+ });
135
+ const removedMemberEvents = await RLNBaseContract.queryFilter(this.contract, {
136
+ fromBlock: this.deployBlock,
137
+ ...options,
138
+ membersFilter: this.membershipErasedFilter
139
+ });
140
+ const expiredMemberEvents = await RLNBaseContract.queryFilter(this.contract, {
141
+ fromBlock: this.deployBlock,
142
+ ...options,
143
+ membersFilter: this.membersExpiredFilter
144
+ });
145
+ const events = [
146
+ ...registeredMemberEvents,
147
+ ...removedMemberEvents,
148
+ ...expiredMemberEvents
149
+ ];
150
+ this.processEvents(events);
151
+ }
152
+ static async queryFilter(contract, options) {
153
+ const FETCH_CHUNK = 5;
154
+ const BLOCK_RANGE = 3000;
155
+ const { fromBlock, membersFilter, fetchRange = BLOCK_RANGE, fetchChunks = FETCH_CHUNK } = options;
156
+ if (fromBlock === undefined) {
157
+ return contract.queryFilter(membersFilter);
158
+ }
159
+ if (!contract.provider) {
160
+ throw Error("No provider found on the contract.");
161
+ }
162
+ const toBlock = await contract.provider.getBlockNumber();
163
+ if (toBlock - fromBlock < fetchRange) {
164
+ return contract.queryFilter(membersFilter, fromBlock, toBlock);
165
+ }
166
+ const events = [];
167
+ const chunks = RLNBaseContract.splitToChunks(fromBlock, toBlock, fetchRange);
168
+ for (const portion of RLNBaseContract.takeN(chunks, fetchChunks)) {
169
+ const promises = portion.map(([left, right]) => RLNBaseContract.ignoreErrors(contract.queryFilter(membersFilter, left, right), []));
170
+ const fetchedEvents = await Promise.all(promises);
171
+ events.push(fetchedEvents.flatMap((v) => v));
172
+ }
173
+ return events.flatMap((v) => v);
174
+ }
175
+ processEvents(events) {
176
+ const toRemoveTable = new Map();
177
+ const toInsertTable = new Map();
178
+ events.forEach((evt) => {
179
+ if (!evt.args) {
180
+ return;
181
+ }
182
+ if (evt.event === "MembershipErased" ||
183
+ evt.event === "MembershipExpired") {
184
+ let index = evt.args.index;
185
+ if (!index) {
186
+ return;
187
+ }
188
+ if (typeof index === "number" || typeof index === "string") {
189
+ index = BigNumber.from(index);
190
+ }
191
+ const toRemoveVal = toRemoveTable.get(evt.blockNumber);
192
+ if (toRemoveVal != undefined) {
193
+ toRemoveVal.push(index.toNumber());
194
+ toRemoveTable.set(evt.blockNumber, toRemoveVal);
195
+ }
196
+ else {
197
+ toRemoveTable.set(evt.blockNumber, [index.toNumber()]);
198
+ }
199
+ }
200
+ else if (evt.event === "MembershipRegistered") {
201
+ let eventsPerBlock = toInsertTable.get(evt.blockNumber);
202
+ if (eventsPerBlock == undefined) {
203
+ eventsPerBlock = [];
204
+ }
205
+ eventsPerBlock.push(evt);
206
+ toInsertTable.set(evt.blockNumber, eventsPerBlock);
207
+ }
208
+ });
209
+ }
210
+ static splitToChunks(from, to, step) {
211
+ const chunks = [];
212
+ let left = from;
213
+ while (left < to) {
214
+ const right = left + step < to ? left + step : to;
215
+ chunks.push([left, right]);
216
+ left = right;
217
+ }
218
+ return chunks;
219
+ }
220
+ static *takeN(array, size) {
221
+ let start = 0;
222
+ while (start < array.length) {
223
+ const portion = array.slice(start, start + size);
224
+ yield portion;
225
+ start += size;
226
+ }
227
+ }
228
+ static async ignoreErrors(promise, defaultValue) {
229
+ try {
230
+ return await promise;
231
+ }
232
+ catch (err) {
233
+ if (err instanceof Error) {
234
+ log.info(`Ignoring an error during query: ${err.message}`);
235
+ }
236
+ else {
237
+ log.info(`Ignoring an unknown error during query`);
238
+ }
239
+ return defaultValue;
240
+ }
241
+ }
242
+ subscribeToMembers() {
243
+ this.contract.on(this.membersFilter, (_idCommitment, _membershipRateLimit, _index, event) => {
244
+ this.processEvents([event]);
245
+ });
246
+ this.contract.on(this.membershipErasedFilter, (_idCommitment, _membershipRateLimit, _index, event) => {
247
+ this.processEvents([event]);
248
+ });
249
+ this.contract.on(this.membersExpiredFilter, (_idCommitment, _membershipRateLimit, _index, event) => {
250
+ this.processEvents([event]);
251
+ });
252
+ }
253
+ async getMembershipInfo(idCommitmentBigInt) {
254
+ try {
255
+ const membershipData = await this.contract.memberships(idCommitmentBigInt);
256
+ const currentBlock = await this.contract.provider.getBlockNumber();
257
+ let state;
258
+ const gracePeriodEnd = membershipData.gracePeriodStartTimestamp.add(membershipData.gracePeriodDuration);
259
+ if (currentBlock < membershipData.gracePeriodStartTimestamp) {
260
+ state = MembershipState.Active;
261
+ }
262
+ else if (currentBlock < gracePeriodEnd) {
263
+ state = MembershipState.GracePeriod;
264
+ }
265
+ else {
266
+ state = MembershipState.Expired;
267
+ }
268
+ return {
269
+ index: membershipData.index,
270
+ idCommitment: membershipData.idCommitment,
271
+ rateLimit: membershipData.rateLimit.toNumber(),
272
+ startBlock: membershipData.gracePeriodStartTimestamp.toNumber(),
273
+ endBlock: gracePeriodEnd.toNumber(),
274
+ state,
275
+ depositAmount: membershipData.depositAmount,
276
+ activeDuration: membershipData.activeDuration,
277
+ gracePeriodDuration: membershipData.gracePeriodDuration,
278
+ holder: membershipData.holder,
279
+ token: membershipData.token
280
+ };
281
+ }
282
+ catch (error) {
283
+ return undefined;
284
+ }
285
+ }
286
+ async extendMembership(idCommitment) {
287
+ return this.contract.extendMemberships([idCommitment]);
288
+ }
289
+ async eraseMembership(idCommitment, eraseFromMembershipSet = true) {
290
+ return this.contract.eraseMemberships([idCommitment], eraseFromMembershipSet);
291
+ }
292
+ async registerMembership(idCommitment, rateLimit = DEFAULT_RATE_LIMIT) {
293
+ if (rateLimit < RATE_LIMIT_PARAMS.MIN_RATE ||
294
+ rateLimit > RATE_LIMIT_PARAMS.MAX_RATE) {
295
+ throw new Error(`Rate limit must be between ${RATE_LIMIT_PARAMS.MIN_RATE} and ${RATE_LIMIT_PARAMS.MAX_RATE}`);
296
+ }
297
+ return this.contract.register(idCommitment, rateLimit, []);
298
+ }
299
+ async withdraw(token) {
300
+ try {
301
+ const tx = await this.contract.withdraw(token);
302
+ await tx.wait();
303
+ }
304
+ catch (error) {
305
+ log.error(`Error in withdraw: ${error.message}`);
306
+ }
307
+ }
308
+ async registerWithIdentity(identity) {
309
+ try {
310
+ log.info(`Registering identity with rate limit: ${this.rateLimit} messages/epoch`);
311
+ // Check if the ID commitment is already registered
312
+ const existingIndex = await this.getMemberIndex(identity.IDCommitmentBigInt.toString());
313
+ if (existingIndex) {
314
+ throw new Error(`ID commitment is already registered with index ${existingIndex}`);
315
+ }
316
+ // Check if there's enough remaining rate limit
317
+ const remainingRateLimit = await this.getRemainingTotalRateLimit();
318
+ if (remainingRateLimit < this.rateLimit) {
319
+ throw new Error(`Not enough remaining rate limit. Requested: ${this.rateLimit}, Available: ${remainingRateLimit}`);
320
+ }
321
+ const estimatedGas = await this.contract.estimateGas.register(identity.IDCommitmentBigInt, this.rateLimit, []);
322
+ const gasLimit = estimatedGas.add(10000);
323
+ const txRegisterResponse = await this.contract.register(identity.IDCommitmentBigInt, this.rateLimit, [], { gasLimit });
324
+ const txRegisterReceipt = await txRegisterResponse.wait();
325
+ if (txRegisterReceipt.status === 0) {
326
+ throw new Error("Transaction failed on-chain");
327
+ }
328
+ const memberRegistered = txRegisterReceipt.events?.find((event) => event.event === "MembershipRegistered");
329
+ if (!memberRegistered || !memberRegistered.args) {
330
+ log.error("Failed to register membership: No MembershipRegistered event found");
331
+ return undefined;
332
+ }
333
+ const decodedData = {
334
+ idCommitment: memberRegistered.args.idCommitment,
335
+ membershipRateLimit: memberRegistered.args.membershipRateLimit,
336
+ index: memberRegistered.args.index
337
+ };
338
+ log.info(`Successfully registered membership with index ${decodedData.index} ` +
339
+ `and rate limit ${decodedData.membershipRateLimit}`);
340
+ const network = await this.contract.provider.getNetwork();
341
+ const address = this.contract.address;
342
+ const membershipId = Number(decodedData.index);
343
+ return {
344
+ identity,
345
+ membership: {
346
+ address,
347
+ treeIndex: membershipId,
348
+ chainId: network.chainId.toString(),
349
+ rateLimit: decodedData.membershipRateLimit.toNumber()
350
+ }
351
+ };
352
+ }
353
+ catch (error) {
354
+ if (error instanceof Error) {
355
+ const errorMessage = error.message;
356
+ log.error("registerWithIdentity - error message:", errorMessage);
357
+ log.error("registerWithIdentity - error stack:", error.stack);
358
+ // Try to extract more specific error information
359
+ if (errorMessage.includes("CannotExceedMaxTotalRateLimit")) {
360
+ throw new Error("Registration failed: Cannot exceed maximum total rate limit");
361
+ }
362
+ else if (errorMessage.includes("InvalidIdCommitment")) {
363
+ throw new Error("Registration failed: Invalid ID commitment");
364
+ }
365
+ else if (errorMessage.includes("InvalidMembershipRateLimit")) {
366
+ throw new Error("Registration failed: Invalid membership rate limit");
367
+ }
368
+ else if (errorMessage.includes("execution reverted")) {
369
+ throw new Error("Contract execution reverted. Check contract requirements.");
370
+ }
371
+ else {
372
+ throw new Error(`Error in registerWithIdentity: ${errorMessage}`);
373
+ }
374
+ }
375
+ else {
376
+ throw new Error("Unknown error in registerWithIdentity", {
377
+ cause: error
378
+ });
379
+ }
380
+ }
381
+ }
382
+ async registerWithPermitAndErase(identity, permit, idCommitmentsToErase) {
383
+ try {
384
+ log.info(`Registering identity with permit and rate limit: ${this.rateLimit} messages/epoch`);
385
+ const txRegisterResponse = await this.contract.registerWithPermit(permit.owner, permit.deadline, permit.v, permit.r, permit.s, identity.IDCommitmentBigInt, this.rateLimit, idCommitmentsToErase.map((id) => BigNumber.from(id)));
386
+ const txRegisterReceipt = await txRegisterResponse.wait();
387
+ const memberRegistered = txRegisterReceipt.events?.find((event) => event.event === "MembershipRegistered");
388
+ if (!memberRegistered || !memberRegistered.args) {
389
+ log.error("Failed to register membership with permit: No MembershipRegistered event found");
390
+ return undefined;
391
+ }
392
+ const decodedData = {
393
+ idCommitment: memberRegistered.args.idCommitment,
394
+ membershipRateLimit: memberRegistered.args.membershipRateLimit,
395
+ index: memberRegistered.args.index
396
+ };
397
+ log.info(`Successfully registered membership with permit. Index: ${decodedData.index}, ` +
398
+ `Rate limit: ${decodedData.membershipRateLimit}, Erased ${idCommitmentsToErase.length} commitments`);
399
+ const network = await this.contract.provider.getNetwork();
400
+ const address = this.contract.address;
401
+ const membershipId = Number(decodedData.index);
402
+ return {
403
+ identity,
404
+ membership: {
405
+ address,
406
+ treeIndex: membershipId,
407
+ chainId: network.chainId.toString(),
408
+ rateLimit: decodedData.membershipRateLimit.toNumber()
409
+ }
410
+ };
411
+ }
412
+ catch (error) {
413
+ log.error(`Error in registerWithPermitAndErase: ${error.message}`);
414
+ return undefined;
415
+ }
416
+ }
417
+ /**
418
+ * Validates that the rate limit is within the allowed range
419
+ * @throws Error if the rate limit is outside the allowed range
420
+ */
421
+ async validateRateLimit(rateLimit) {
422
+ const [minRate, maxRate] = await Promise.all([
423
+ this.contract.minMembershipRateLimit(),
424
+ this.contract.maxMembershipRateLimit()
425
+ ]);
426
+ const minRateNum = BigNumber.from(minRate).toNumber();
427
+ const maxRateNum = BigNumber.from(maxRate).toNumber();
428
+ if (rateLimit < minRateNum || rateLimit > maxRateNum) {
429
+ throw new Error(`Rate limit must be between ${minRateNum} and ${maxRateNum} messages per epoch`);
430
+ }
431
+ }
432
+ get membersFilter() {
433
+ if (!this._membersFilter) {
434
+ throw Error("Members filter was not initialized.");
435
+ }
436
+ return this._membersFilter;
437
+ }
438
+ get membershipErasedFilter() {
439
+ if (!this._membershipErasedFilter) {
440
+ throw Error("MembershipErased filter was not initialized.");
441
+ }
442
+ return this._membershipErasedFilter;
443
+ }
444
+ get membersExpiredFilter() {
445
+ if (!this._membersExpiredFilter) {
446
+ throw Error("MembersExpired filter was not initialized.");
447
+ }
448
+ return this._membersExpiredFilter;
449
+ }
450
+ async getMemberIndex(idCommitment) {
451
+ try {
452
+ const events = await this.contract.queryFilter(this.contract.filters.MembershipRegistered(idCommitment));
453
+ if (events.length === 0)
454
+ return undefined;
455
+ // Get the most recent registration event
456
+ const event = events[events.length - 1];
457
+ return event.args?.index;
458
+ }
459
+ catch (error) {
460
+ return undefined;
461
+ }
462
+ }
463
+ }
464
+
465
+ export { RLNBaseContract };