@waku/rln 0.0.2-3670e82.0 → 0.0.2-5c50ed7.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 (42) hide show
  1. package/bundle/_virtual/utils.js +2 -2
  2. package/bundle/_virtual/utils2.js +2 -2
  3. package/bundle/index.js +2 -0
  4. package/bundle/packages/rln/dist/contract/rln_contract.js +58 -59
  5. package/bundle/packages/rln/dist/contract/rln_light_contract.js +471 -0
  6. package/bundle/packages/rln/dist/rln.js +2 -4
  7. package/bundle/packages/rln/dist/rln_light.js +149 -0
  8. package/bundle/packages/rln/node_modules/@chainsafe/bls-keystore/node_modules/ethereum-cryptography/random.js +1 -1
  9. package/bundle/packages/rln/node_modules/@chainsafe/bls-keystore/node_modules/ethereum-cryptography/utils.js +2 -2
  10. package/bundle/packages/rln/node_modules/@noble/hashes/_sha2.js +1 -1
  11. package/bundle/packages/rln/node_modules/@noble/hashes/esm/_assert.js +43 -0
  12. package/bundle/packages/rln/node_modules/@noble/hashes/esm/_sha2.js +116 -0
  13. package/bundle/packages/rln/node_modules/@noble/hashes/esm/hmac.js +79 -0
  14. package/bundle/packages/rln/node_modules/@noble/hashes/esm/sha256.js +126 -0
  15. package/bundle/packages/rln/node_modules/@noble/hashes/esm/utils.js +43 -0
  16. package/bundle/packages/rln/node_modules/@noble/hashes/hmac.js +1 -1
  17. package/bundle/packages/rln/node_modules/@noble/hashes/pbkdf2.js +1 -1
  18. package/bundle/packages/rln/node_modules/@noble/hashes/scrypt.js +1 -1
  19. package/bundle/packages/rln/node_modules/@noble/hashes/sha256.js +1 -1
  20. package/bundle/packages/rln/node_modules/@noble/hashes/sha512.js +1 -1
  21. package/bundle/packages/rln/node_modules/@noble/hashes/utils.js +1 -1
  22. package/dist/.tsbuildinfo +1 -1
  23. package/dist/contract/rln_contract.d.ts +4 -4
  24. package/dist/contract/rln_contract.js +58 -59
  25. package/dist/contract/rln_contract.js.map +1 -1
  26. package/dist/contract/rln_light_contract.d.ts +124 -0
  27. package/dist/contract/rln_light_contract.js +454 -0
  28. package/dist/contract/rln_light_contract.js.map +1 -0
  29. package/dist/index.d.ts +4 -1
  30. package/dist/index.js +3 -1
  31. package/dist/index.js.map +1 -1
  32. package/dist/rln.js +2 -4
  33. package/dist/rln.js.map +1 -1
  34. package/dist/rln_light.d.ts +64 -0
  35. package/dist/rln_light.js +144 -0
  36. package/dist/rln_light.js.map +1 -0
  37. package/package.json +1 -1
  38. package/src/contract/rln_contract.ts +73 -107
  39. package/src/contract/rln_light_contract.ts +716 -0
  40. package/src/index.ts +15 -0
  41. package/src/rln.ts +2 -5
  42. package/src/rln_light.ts +235 -0
@@ -0,0 +1,471 @@
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 { RATE_LIMIT_PARAMS, DEFAULT_RATE_LIMIT } from './constants.js';
18
+ import { Contract } from '../../../../node_modules/@ethersproject/contracts/lib.esm/index.js';
19
+ import { BigNumber } from '../../../../node_modules/@ethersproject/bignumber/lib.esm/bignumber.js';
20
+
21
+ const log = new Logger("waku:rln:contract");
22
+ var MembershipState;
23
+ (function (MembershipState) {
24
+ MembershipState["Active"] = "Active";
25
+ MembershipState["GracePeriod"] = "GracePeriod";
26
+ MembershipState["Expired"] = "Expired";
27
+ MembershipState["ErasedAwaitsWithdrawal"] = "ErasedAwaitsWithdrawal";
28
+ })(MembershipState || (MembershipState = {}));
29
+ class RLNLightContract {
30
+ contract;
31
+ deployBlock;
32
+ rateLimit;
33
+ _members = new Map();
34
+ _membersFilter;
35
+ _membershipErasedFilter;
36
+ _membersExpiredFilter;
37
+ /**
38
+ * Asynchronous initializer for RLNContract.
39
+ * Allows injecting a mocked contract for testing purposes.
40
+ */
41
+ static async init(options) {
42
+ const rlnContract = new RLNLightContract(options);
43
+ await rlnContract.fetchMembers();
44
+ rlnContract.subscribeToMembers();
45
+ return rlnContract;
46
+ }
47
+ constructor(options) {
48
+ const { address, signer, rateLimit = DEFAULT_RATE_LIMIT, contract } = options;
49
+ if (rateLimit < RATE_LIMIT_PARAMS.MIN_RATE ||
50
+ rateLimit > RATE_LIMIT_PARAMS.MAX_RATE) {
51
+ throw new Error(`Rate limit must be between ${RATE_LIMIT_PARAMS.MIN_RATE} and ${RATE_LIMIT_PARAMS.MAX_RATE} messages per epoch`);
52
+ }
53
+ this.rateLimit = rateLimit;
54
+ // Use the injected contract if provided; otherwise, instantiate a new one.
55
+ this.contract = contract || new Contract(address, RLN_ABI, signer);
56
+ // Initialize event filters
57
+ this._membersFilter = this.contract.filters.MembershipRegistered();
58
+ this._membershipErasedFilter = this.contract.filters.MembershipErased();
59
+ this._membersExpiredFilter = this.contract.filters.MembershipExpired();
60
+ }
61
+ /**
62
+ * Gets the current rate limit for this contract instance
63
+ */
64
+ getRateLimit() {
65
+ return this.rateLimit;
66
+ }
67
+ /**
68
+ * Gets the contract address
69
+ */
70
+ get address() {
71
+ return this.contract.address;
72
+ }
73
+ /**
74
+ * Gets the contract provider
75
+ */
76
+ get provider() {
77
+ return this.contract.provider;
78
+ }
79
+ /**
80
+ * Gets the minimum allowed rate limit from the contract
81
+ * @returns Promise<number> The minimum rate limit in messages per epoch
82
+ */
83
+ async getMinRateLimit() {
84
+ const minRate = await this.contract.minMembershipRateLimit();
85
+ return minRate.toNumber();
86
+ }
87
+ /**
88
+ * Gets the maximum allowed rate limit from the contract
89
+ * @returns Promise<number> The maximum rate limit in messages per epoch
90
+ */
91
+ async getMaxRateLimit() {
92
+ const maxRate = await this.contract.maxMembershipRateLimit();
93
+ return maxRate.toNumber();
94
+ }
95
+ /**
96
+ * Gets the maximum total rate limit across all memberships
97
+ * @returns Promise<number> The maximum total rate limit in messages per epoch
98
+ */
99
+ async getMaxTotalRateLimit() {
100
+ const maxTotalRate = await this.contract.maxTotalRateLimit();
101
+ return maxTotalRate.toNumber();
102
+ }
103
+ /**
104
+ * Gets the current total rate limit usage across all memberships
105
+ * @returns Promise<number> The current total rate limit usage in messages per epoch
106
+ */
107
+ async getCurrentTotalRateLimit() {
108
+ const currentTotal = await this.contract.currentTotalRateLimit();
109
+ return currentTotal.toNumber();
110
+ }
111
+ /**
112
+ * Gets the remaining available total rate limit that can be allocated
113
+ * @returns Promise<number> The remaining rate limit that can be allocated
114
+ */
115
+ async getRemainingTotalRateLimit() {
116
+ const [maxTotal, currentTotal] = await Promise.all([
117
+ this.contract.maxTotalRateLimit(),
118
+ this.contract.currentTotalRateLimit()
119
+ ]);
120
+ return Number(maxTotal) - Number(currentTotal);
121
+ }
122
+ /**
123
+ * Updates the rate limit for future registrations
124
+ * @param newRateLimit The new rate limit to use
125
+ */
126
+ async setRateLimit(newRateLimit) {
127
+ this.rateLimit = newRateLimit;
128
+ }
129
+ get members() {
130
+ const sortedMembers = Array.from(this._members.values()).sort((left, right) => left.index.toNumber() - right.index.toNumber());
131
+ return sortedMembers;
132
+ }
133
+ get membersFilter() {
134
+ if (!this._membersFilter) {
135
+ throw Error("Members filter was not initialized.");
136
+ }
137
+ return this._membersFilter;
138
+ }
139
+ get membershipErasedFilter() {
140
+ if (!this._membershipErasedFilter) {
141
+ throw Error("MembershipErased filter was not initialized.");
142
+ }
143
+ return this._membershipErasedFilter;
144
+ }
145
+ get membersExpiredFilter() {
146
+ if (!this._membersExpiredFilter) {
147
+ throw Error("MembersExpired filter was not initialized.");
148
+ }
149
+ return this._membersExpiredFilter;
150
+ }
151
+ async fetchMembers(options = {}) {
152
+ const registeredMemberEvents = await queryFilter(this.contract, {
153
+ fromBlock: this.deployBlock,
154
+ ...options,
155
+ membersFilter: this.membersFilter
156
+ });
157
+ const removedMemberEvents = await queryFilter(this.contract, {
158
+ fromBlock: this.deployBlock,
159
+ ...options,
160
+ membersFilter: this.membershipErasedFilter
161
+ });
162
+ const expiredMemberEvents = await queryFilter(this.contract, {
163
+ fromBlock: this.deployBlock,
164
+ ...options,
165
+ membersFilter: this.membersExpiredFilter
166
+ });
167
+ const events = [
168
+ ...registeredMemberEvents,
169
+ ...removedMemberEvents,
170
+ ...expiredMemberEvents
171
+ ];
172
+ this.processEvents(events);
173
+ }
174
+ processEvents(events) {
175
+ const toRemoveTable = new Map();
176
+ const toInsertTable = new Map();
177
+ events.forEach((evt) => {
178
+ if (!evt.args) {
179
+ return;
180
+ }
181
+ if (evt.event === "MembershipErased" ||
182
+ evt.event === "MembershipExpired") {
183
+ let index = evt.args.index;
184
+ if (!index) {
185
+ return;
186
+ }
187
+ if (typeof index === "number" || typeof index === "string") {
188
+ index = BigNumber.from(index);
189
+ }
190
+ const toRemoveVal = toRemoveTable.get(evt.blockNumber);
191
+ if (toRemoveVal != undefined) {
192
+ toRemoveVal.push(index.toNumber());
193
+ toRemoveTable.set(evt.blockNumber, toRemoveVal);
194
+ }
195
+ else {
196
+ toRemoveTable.set(evt.blockNumber, [index.toNumber()]);
197
+ }
198
+ }
199
+ else if (evt.event === "MembershipRegistered") {
200
+ let eventsPerBlock = toInsertTable.get(evt.blockNumber);
201
+ if (eventsPerBlock == undefined) {
202
+ eventsPerBlock = [];
203
+ }
204
+ eventsPerBlock.push(evt);
205
+ toInsertTable.set(evt.blockNumber, eventsPerBlock);
206
+ }
207
+ });
208
+ }
209
+ subscribeToMembers() {
210
+ this.contract.on(this.membersFilter, (_idCommitment, _membershipRateLimit, _index, event) => {
211
+ this.processEvents([event]);
212
+ });
213
+ this.contract.on(this.membershipErasedFilter, (_idCommitment, _membershipRateLimit, _index, event) => {
214
+ this.processEvents([event]);
215
+ });
216
+ this.contract.on(this.membersExpiredFilter, (_idCommitment, _membershipRateLimit, _index, event) => {
217
+ this.processEvents([event]);
218
+ });
219
+ }
220
+ async registerWithIdentity(identity) {
221
+ try {
222
+ log.info(`Registering identity with rate limit: ${this.rateLimit} messages/epoch`);
223
+ // Check if the ID commitment is already registered
224
+ const existingIndex = await this.getMemberIndex(identity.IDCommitmentBigInt.toString());
225
+ if (existingIndex) {
226
+ throw new Error(`ID commitment is already registered with index ${existingIndex}`);
227
+ }
228
+ // Check if there's enough remaining rate limit
229
+ const remainingRateLimit = await this.getRemainingTotalRateLimit();
230
+ if (remainingRateLimit < this.rateLimit) {
231
+ throw new Error(`Not enough remaining rate limit. Requested: ${this.rateLimit}, Available: ${remainingRateLimit}`);
232
+ }
233
+ const estimatedGas = await this.contract.estimateGas.register(identity.IDCommitmentBigInt, this.rateLimit, []);
234
+ const gasLimit = estimatedGas.add(10000);
235
+ const txRegisterResponse = await this.contract.register(identity.IDCommitmentBigInt, this.rateLimit, [], { gasLimit });
236
+ const txRegisterReceipt = await txRegisterResponse.wait();
237
+ if (txRegisterReceipt.status === 0) {
238
+ throw new Error("Transaction failed on-chain");
239
+ }
240
+ const memberRegistered = txRegisterReceipt.events?.find((event) => event.event === "MembershipRegistered");
241
+ if (!memberRegistered || !memberRegistered.args) {
242
+ log.error("Failed to register membership: No MembershipRegistered event found");
243
+ return undefined;
244
+ }
245
+ const decodedData = {
246
+ idCommitment: memberRegistered.args.idCommitment,
247
+ membershipRateLimit: memberRegistered.args.membershipRateLimit,
248
+ index: memberRegistered.args.index
249
+ };
250
+ log.info(`Successfully registered membership with index ${decodedData.index} ` +
251
+ `and rate limit ${decodedData.membershipRateLimit}`);
252
+ const network = await this.contract.provider.getNetwork();
253
+ const address = this.contract.address;
254
+ const membershipId = Number(decodedData.index);
255
+ return {
256
+ identity,
257
+ membership: {
258
+ address,
259
+ treeIndex: membershipId,
260
+ chainId: network.chainId
261
+ }
262
+ };
263
+ }
264
+ catch (error) {
265
+ if (error instanceof Error) {
266
+ const errorMessage = error.message;
267
+ log.error("registerWithIdentity - error message:", errorMessage);
268
+ log.error("registerWithIdentity - error stack:", error.stack);
269
+ // Try to extract more specific error information
270
+ if (errorMessage.includes("CannotExceedMaxTotalRateLimit")) {
271
+ throw new Error("Registration failed: Cannot exceed maximum total rate limit");
272
+ }
273
+ else if (errorMessage.includes("InvalidIdCommitment")) {
274
+ throw new Error("Registration failed: Invalid ID commitment");
275
+ }
276
+ else if (errorMessage.includes("InvalidMembershipRateLimit")) {
277
+ throw new Error("Registration failed: Invalid membership rate limit");
278
+ }
279
+ else if (errorMessage.includes("execution reverted")) {
280
+ throw new Error("Contract execution reverted. Check contract requirements.");
281
+ }
282
+ else {
283
+ throw new Error(`Error in registerWithIdentity: ${errorMessage}`);
284
+ }
285
+ }
286
+ else {
287
+ throw new Error("Unknown error in registerWithIdentity", {
288
+ cause: error
289
+ });
290
+ }
291
+ }
292
+ }
293
+ /**
294
+ * Helper method to get remaining messages in current epoch
295
+ * @param membershipId The ID of the membership to check
296
+ * @returns number of remaining messages allowed in current epoch
297
+ */
298
+ async getRemainingMessages(membershipId) {
299
+ try {
300
+ const [startTime, , rateLimit] = await this.contract.getMembershipInfo(membershipId);
301
+ // Calculate current epoch
302
+ const currentTime = Math.floor(Date.now() / 1000);
303
+ const epochsPassed = Math.floor((currentTime - startTime) / RATE_LIMIT_PARAMS.EPOCH_LENGTH);
304
+ const currentEpochStart = startTime + epochsPassed * RATE_LIMIT_PARAMS.EPOCH_LENGTH;
305
+ // Get message count in current epoch using contract's function
306
+ const messageCount = await this.contract.getMessageCount(membershipId, currentEpochStart);
307
+ return Math.max(0, rateLimit.sub(messageCount).toNumber());
308
+ }
309
+ catch (error) {
310
+ log.error(`Error getting remaining messages: ${error.message}`);
311
+ return 0; // Fail safe: assume no messages remaining on error
312
+ }
313
+ }
314
+ async registerWithPermitAndErase(identity, permit, idCommitmentsToErase) {
315
+ try {
316
+ log.info(`Registering identity with permit and rate limit: ${this.rateLimit} messages/epoch`);
317
+ 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)));
318
+ const txRegisterReceipt = await txRegisterResponse.wait();
319
+ const memberRegistered = txRegisterReceipt.events?.find((event) => event.event === "MembershipRegistered");
320
+ if (!memberRegistered || !memberRegistered.args) {
321
+ log.error("Failed to register membership with permit: No MembershipRegistered event found");
322
+ return undefined;
323
+ }
324
+ const decodedData = {
325
+ idCommitment: memberRegistered.args.idCommitment,
326
+ membershipRateLimit: memberRegistered.args.membershipRateLimit,
327
+ index: memberRegistered.args.index
328
+ };
329
+ log.info(`Successfully registered membership with permit. Index: ${decodedData.index}, ` +
330
+ `Rate limit: ${decodedData.membershipRateLimit}, Erased ${idCommitmentsToErase.length} commitments`);
331
+ const network = await this.contract.provider.getNetwork();
332
+ const address = this.contract.address;
333
+ const membershipId = Number(decodedData.index);
334
+ return {
335
+ identity,
336
+ membership: {
337
+ address,
338
+ treeIndex: membershipId,
339
+ chainId: network.chainId
340
+ }
341
+ };
342
+ }
343
+ catch (error) {
344
+ log.error(`Error in registerWithPermitAndErase: ${error.message}`);
345
+ return undefined;
346
+ }
347
+ }
348
+ async withdraw(token, holder) {
349
+ try {
350
+ const tx = await this.contract.withdraw(token, { from: holder });
351
+ await tx.wait();
352
+ }
353
+ catch (error) {
354
+ log.error(`Error in withdraw: ${error.message}`);
355
+ }
356
+ }
357
+ async getMembershipInfo(idCommitment) {
358
+ try {
359
+ const [startBlock, endBlock, rateLimit] = await this.contract.getMembershipInfo(idCommitment);
360
+ const currentBlock = await this.contract.provider.getBlockNumber();
361
+ let state;
362
+ if (currentBlock < startBlock) {
363
+ state = MembershipState.Active;
364
+ }
365
+ else if (currentBlock < endBlock) {
366
+ state = MembershipState.GracePeriod;
367
+ }
368
+ else {
369
+ state = MembershipState.Expired;
370
+ }
371
+ const index = await this.getMemberIndex(idCommitment);
372
+ if (!index)
373
+ return undefined;
374
+ return {
375
+ index,
376
+ idCommitment,
377
+ rateLimit: rateLimit.toNumber(),
378
+ startBlock: startBlock.toNumber(),
379
+ endBlock: endBlock.toNumber(),
380
+ state
381
+ };
382
+ }
383
+ catch (error) {
384
+ return undefined;
385
+ }
386
+ }
387
+ async extendMembership(idCommitment) {
388
+ return this.contract.extendMemberships([idCommitment]);
389
+ }
390
+ async eraseMembership(idCommitment, eraseFromMembershipSet = true) {
391
+ return this.contract.eraseMemberships([idCommitment], eraseFromMembershipSet);
392
+ }
393
+ async registerMembership(idCommitment, rateLimit = DEFAULT_RATE_LIMIT) {
394
+ if (rateLimit < RATE_LIMIT_PARAMS.MIN_RATE ||
395
+ rateLimit > RATE_LIMIT_PARAMS.MAX_RATE) {
396
+ throw new Error(`Rate limit must be between ${RATE_LIMIT_PARAMS.MIN_RATE} and ${RATE_LIMIT_PARAMS.MAX_RATE}`);
397
+ }
398
+ return this.contract.register(idCommitment, rateLimit, []);
399
+ }
400
+ async getMemberIndex(idCommitment) {
401
+ try {
402
+ const events = await this.contract.queryFilter(this.contract.filters.MembershipRegistered(idCommitment));
403
+ if (events.length === 0)
404
+ return undefined;
405
+ // Get the most recent registration event
406
+ const event = events[events.length - 1];
407
+ return event.args?.index;
408
+ }
409
+ catch (error) {
410
+ return undefined;
411
+ }
412
+ }
413
+ }
414
+ // These values should be tested on other networks
415
+ const FETCH_CHUNK = 5;
416
+ const BLOCK_RANGE = 3000;
417
+ async function queryFilter(contract, options) {
418
+ const { fromBlock, membersFilter, fetchRange = BLOCK_RANGE, fetchChunks = FETCH_CHUNK } = options;
419
+ if (fromBlock === undefined) {
420
+ return contract.queryFilter(membersFilter);
421
+ }
422
+ if (!contract.provider) {
423
+ throw Error("No provider found on the contract.");
424
+ }
425
+ const toBlock = await contract.provider.getBlockNumber();
426
+ if (toBlock - fromBlock < fetchRange) {
427
+ return contract.queryFilter(membersFilter, fromBlock, toBlock);
428
+ }
429
+ const events = [];
430
+ const chunks = splitToChunks(fromBlock, toBlock, fetchRange);
431
+ for (const portion of takeN(chunks, fetchChunks)) {
432
+ const promises = portion.map(([left, right]) => ignoreErrors(contract.queryFilter(membersFilter, left, right), []));
433
+ const fetchedEvents = await Promise.all(promises);
434
+ events.push(fetchedEvents.flatMap((v) => v));
435
+ }
436
+ return events.flatMap((v) => v);
437
+ }
438
+ function splitToChunks(from, to, step) {
439
+ const chunks = [];
440
+ let left = from;
441
+ while (left < to) {
442
+ const right = left + step < to ? left + step : to;
443
+ chunks.push([left, right]);
444
+ left = right;
445
+ }
446
+ return chunks;
447
+ }
448
+ function* takeN(array, size) {
449
+ let start = 0;
450
+ while (start < array.length) {
451
+ const portion = array.slice(start, start + size);
452
+ yield portion;
453
+ start += size;
454
+ }
455
+ }
456
+ async function ignoreErrors(promise, defaultValue) {
457
+ try {
458
+ return await promise;
459
+ }
460
+ catch (err) {
461
+ if (err instanceof Error) {
462
+ log.info(`Ignoring an error during query: ${err.message}`);
463
+ }
464
+ else {
465
+ log.info(`Ignoring an unknown error during query`);
466
+ }
467
+ return defaultValue;
468
+ }
469
+ }
470
+
471
+ export { MembershipState, RLNLightContract };
@@ -106,7 +106,7 @@ class RLNInstance {
106
106
  this.starting = true;
107
107
  try {
108
108
  const { credentials, keystore } = await RLNInstance.decryptCredentialsIfNeeded(options.credentials);
109
- const { signer, address } = await this.determineStartOptions(options, credentials);
109
+ const { signer, address, rateLimit } = await this.determineStartOptions(options, credentials);
110
110
  if (keystore) {
111
111
  this.keystore = keystore;
112
112
  }
@@ -115,7 +115,7 @@ class RLNInstance {
115
115
  this._contract = await RLNContract.init(this, {
116
116
  address: address,
117
117
  signer: signer,
118
- rateLimit: options.rateLimit ?? this.zerokit.getRateLimit
118
+ rateLimit: rateLimit ?? this.zerokit.getRateLimit
119
119
  });
120
120
  this.started = true;
121
121
  }
@@ -166,8 +166,6 @@ class RLNInstance {
166
166
  if ("signature" in options) {
167
167
  identity = this.zerokit.generateSeededIdentityCredential(options.signature);
168
168
  }
169
- // eslint-disable-next-line no-console
170
- console.log("registering membership", identity);
171
169
  if (!identity) {
172
170
  throw Error("Missing signature or identity to register membership.");
173
171
  }
@@ -0,0 +1,149 @@
1
+ import { hmac } from '../node_modules/@noble/hashes/esm/hmac.js';
2
+ import { sha256 } from '../node_modules/@noble/hashes/esm/sha256.js';
3
+ import '../../interfaces/dist/protocols.js';
4
+ import '../../interfaces/dist/connection_manager.js';
5
+ import '../../interfaces/dist/health_indicator.js';
6
+ import '../../../node_modules/multiformats/dist/src/bases/base10.js';
7
+ import '../../../node_modules/multiformats/dist/src/bases/base16.js';
8
+ import '../../../node_modules/multiformats/dist/src/bases/base2.js';
9
+ import '../../../node_modules/multiformats/dist/src/bases/base256emoji.js';
10
+ import '../../../node_modules/multiformats/dist/src/bases/base32.js';
11
+ import '../../../node_modules/multiformats/dist/src/bases/base36.js';
12
+ import '../../../node_modules/multiformats/dist/src/bases/base58.js';
13
+ import '../../../node_modules/multiformats/dist/src/bases/base64.js';
14
+ import '../../../node_modules/multiformats/dist/src/bases/base8.js';
15
+ import '../../../node_modules/multiformats/dist/src/bases/identity.js';
16
+ import '../../../node_modules/multiformats/dist/src/codecs/json.js';
17
+ import { Logger } from '../../utils/dist/logger/index.js';
18
+ import { SEPOLIA_CONTRACT } from './contract/constants.js';
19
+ import { RLNLightContract } from './contract/rln_light_contract.js';
20
+ import { IdentityCredential } from './identity.js';
21
+ import { Keystore } from './keystore/keystore.js';
22
+ import { extractMetaMaskSigner } from './utils/metamask.js';
23
+ import { buildBigIntFromUint8Array } from './utils/bytes.js';
24
+ import './utils/epoch.js';
25
+
26
+ new Logger("waku:rln");
27
+ class RLNLightInstance {
28
+ started = false;
29
+ starting = false;
30
+ _contract;
31
+ _signer;
32
+ keystore = Keystore.create();
33
+ _credentials;
34
+ constructor() { }
35
+ get contract() {
36
+ return this._contract;
37
+ }
38
+ get signer() {
39
+ return this._signer;
40
+ }
41
+ async start(options = {}) {
42
+ if (this.started || this.starting) {
43
+ return;
44
+ }
45
+ this.starting = true;
46
+ try {
47
+ const { credentials, keystore } = await RLNLightInstance.decryptCredentialsIfNeeded(options.credentials);
48
+ const { signer, address, rateLimit } = await this.determineStartOptions(options, credentials);
49
+ if (keystore) {
50
+ this.keystore = keystore;
51
+ }
52
+ this._credentials = credentials;
53
+ this._signer = signer;
54
+ this._contract = await RLNLightContract.init({
55
+ address: address,
56
+ signer: signer,
57
+ rateLimit: rateLimit
58
+ });
59
+ this.started = true;
60
+ }
61
+ finally {
62
+ this.starting = false;
63
+ }
64
+ }
65
+ get credentials() {
66
+ return this._credentials;
67
+ }
68
+ async determineStartOptions(options, credentials) {
69
+ let chainId = credentials?.membership.chainId;
70
+ const address = credentials?.membership.address ||
71
+ options.address ||
72
+ SEPOLIA_CONTRACT.address;
73
+ if (address === SEPOLIA_CONTRACT.address) {
74
+ chainId = SEPOLIA_CONTRACT.chainId;
75
+ }
76
+ const signer = options.signer || (await extractMetaMaskSigner());
77
+ const currentChainId = await signer.getChainId();
78
+ if (chainId && chainId !== currentChainId) {
79
+ throw Error(`Failed to start RLN contract, chain ID of contract is different from current one: contract-${chainId}, current network-${currentChainId}`);
80
+ }
81
+ return {
82
+ signer,
83
+ address
84
+ };
85
+ }
86
+ static async decryptCredentialsIfNeeded(credentials) {
87
+ if (!credentials) {
88
+ return {};
89
+ }
90
+ if ("identity" in credentials) {
91
+ return { credentials };
92
+ }
93
+ const keystore = Keystore.fromString(credentials.keystore);
94
+ if (!keystore) {
95
+ return {};
96
+ }
97
+ const decryptedCredentials = await keystore.readCredential(credentials.id, credentials.password);
98
+ return {
99
+ keystore,
100
+ credentials: decryptedCredentials
101
+ };
102
+ }
103
+ /**
104
+ * Generates an identity credential from a seed string
105
+ * This is a pure implementation that doesn't rely on Zerokit
106
+ * @param seed A string seed to generate the identity from
107
+ * @returns IdentityCredential
108
+ */
109
+ generateSeededIdentityCredential(seed) {
110
+ // Convert the seed to bytes
111
+ const encoder = new TextEncoder();
112
+ const seedBytes = encoder.encode(seed);
113
+ // Generate deterministic values using HMAC-SHA256
114
+ // We use different context strings for each component to ensure they're different
115
+ const idTrapdoor = hmac(sha256, seedBytes, encoder.encode("IDTrapdoor"));
116
+ const idNullifier = hmac(sha256, seedBytes, encoder.encode("IDNullifier"));
117
+ // Generate IDSecretHash as a hash of IDTrapdoor and IDNullifier
118
+ const combinedBytes = new Uint8Array([...idTrapdoor, ...idNullifier]);
119
+ const idSecretHash = sha256(combinedBytes);
120
+ // Generate IDCommitment as a hash of IDSecretHash
121
+ const idCommitment = sha256(idSecretHash);
122
+ // Convert IDCommitment to BigInt
123
+ const idCommitmentBigInt = buildBigIntFromUint8Array(idCommitment);
124
+ return new IdentityCredential(idTrapdoor, idNullifier, idSecretHash, idCommitment, idCommitmentBigInt);
125
+ }
126
+ async registerMembership(options) {
127
+ if (!this.contract) {
128
+ throw Error("RLN Contract is not initialized.");
129
+ }
130
+ let identity = "identity" in options && options.identity;
131
+ if ("signature" in options) {
132
+ identity = this.generateSeededIdentityCredential(options.signature);
133
+ }
134
+ if (!identity) {
135
+ throw Error("Missing signature or identity to register membership.");
136
+ }
137
+ return this.contract.registerWithIdentity(identity);
138
+ }
139
+ /**
140
+ * Changes credentials in use by relying on provided Keystore earlier in rln.start
141
+ * @param id: string, hash of credentials to select from Keystore
142
+ * @param password: string or bytes to use to decrypt credentials from Keystore
143
+ */
144
+ async useCredentials(id, password) {
145
+ this._credentials = await this.keystore?.readCredential(id, password);
146
+ }
147
+ }
148
+
149
+ export { RLNLightInstance };
@@ -1,6 +1,6 @@
1
1
  import { __exports as random } from '../../../../../../../_virtual/random.js';
2
2
  import '../../../../@noble/hashes/utils.js';
3
- import { __exports as utils } from '../../../../../../../_virtual/utils2.js';
3
+ import { __exports as utils } from '../../../../../../../_virtual/utils.js';
4
4
 
5
5
  Object.defineProperty(random, "__esModule", { value: true });
6
6
  random.getRandomBytes = random.getRandomBytesSync = undefined;
@@ -1,10 +1,10 @@
1
1
  import { commonjsGlobal } from '../../../../../../../_virtual/_commonjsHelpers.js';
2
2
  import { commonjsRequire } from '../../../../../../../_virtual/_commonjs-dynamic-modules.js';
3
- import { __module as utils } from '../../../../../../../_virtual/utils.js';
3
+ import { __module as utils } from '../../../../../../../_virtual/utils2.js';
4
4
  import '../../../../@noble/hashes/_assert.js';
5
5
  import '../../../../@noble/hashes/utils.js';
6
6
  import { __exports as _assert } from '../../../../../../../_virtual/_assert.js';
7
- import { __exports as utils$1 } from '../../../../../../../_virtual/utils2.js';
7
+ import { __exports as utils$1 } from '../../../../../../../_virtual/utils.js';
8
8
 
9
9
  utils.exports;
10
10
 
@@ -2,7 +2,7 @@ import { __exports as _sha2 } from '../../../../../_virtual/_sha2.js';
2
2
  import './_assert.js';
3
3
  import './utils.js';
4
4
  import { __exports as _assert } from '../../../../../_virtual/_assert.js';
5
- import { __exports as utils } from '../../../../../_virtual/utils2.js';
5
+ import { __exports as utils } from '../../../../../_virtual/utils.js';
6
6
 
7
7
  Object.defineProperty(_sha2, "__esModule", { value: true });
8
8
  _sha2.SHA2 = undefined;