@sig-net/midnight 0.14.0 → 0.16.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 (57) hide show
  1. package/README.md +133 -48
  2. package/dist/constants.d.ts +55 -0
  3. package/dist/constants.d.ts.map +1 -1
  4. package/dist/constants.js +85 -5
  5. package/dist/constants.js.map +1 -1
  6. package/dist/ecdsa-attestation.d.ts +6 -5
  7. package/dist/ecdsa-attestation.d.ts.map +1 -1
  8. package/dist/ecdsa-attestation.js +5 -4
  9. package/dist/ecdsa-attestation.js.map +1 -1
  10. package/dist/index.d.ts +1 -2
  11. package/dist/index.d.ts.map +1 -1
  12. package/dist/index.js +3 -4
  13. package/dist/index.js.map +1 -1
  14. package/dist/managed/compiler/contract-info.json +12 -1
  15. package/dist/managed/compiler/contract-manifest.json +8 -8
  16. package/dist/managed/contract/index.d.ts +8 -6
  17. package/dist/managed/contract/index.js +76 -60
  18. package/dist/managed/contract/index.js.map +1 -1
  19. package/dist/signature-requests-state-reader.d.ts +29 -10
  20. package/dist/signature-requests-state-reader.d.ts.map +1 -1
  21. package/dist/signature-requests-state-reader.js +67 -21
  22. package/dist/signature-requests-state-reader.js.map +1 -1
  23. package/dist/signature-response-verification.d.ts +1 -1
  24. package/dist/signature-response-verification.d.ts.map +1 -1
  25. package/dist/signature-response-verification.js +3 -3
  26. package/dist/signature-response-verification.js.map +1 -1
  27. package/dist/signature-state-reading.d.ts +17 -25
  28. package/dist/signature-state-reading.d.ts.map +1 -1
  29. package/dist/signature-state-reading.js +39 -59
  30. package/dist/signature-state-reading.js.map +1 -1
  31. package/dist/signet-contract-events.d.ts +262 -0
  32. package/dist/signet-contract-events.d.ts.map +1 -0
  33. package/dist/signet-contract-events.js +266 -0
  34. package/dist/signet-contract-events.js.map +1 -0
  35. package/dist/signet-evtype2tx-requests.d.ts +4 -4
  36. package/dist/signet-evtype2tx-requests.d.ts.map +1 -1
  37. package/dist/signet-evtype2tx-requests.js +3 -3
  38. package/dist/signet-request-feed.d.ts +59 -34
  39. package/dist/signet-request-feed.d.ts.map +1 -1
  40. package/dist/signet-request-feed.js +95 -62
  41. package/dist/signet-request-feed.js.map +1 -1
  42. package/dist/signet-request-response-reader.d.ts +70 -62
  43. package/dist/signet-request-response-reader.d.ts.map +1 -1
  44. package/dist/signet-request-response-reader.js +88 -102
  45. package/dist/signet-request-response-reader.js.map +1 -1
  46. package/dist/signet-requests.js +2 -2
  47. package/dist/signet-requests.js.map +1 -1
  48. package/package.json +2 -2
  49. package/src/Signet.compact +90 -43
  50. package/dist/signet-contract-state-reader.d.ts +0 -241
  51. package/dist/signet-contract-state-reader.d.ts.map +0 -1
  52. package/dist/signet-contract-state-reader.js +0 -345
  53. package/dist/signet-contract-state-reader.js.map +0 -1
  54. package/dist/signet-request-resolver.d.ts +0 -60
  55. package/dist/signet-request-resolver.d.ts.map +0 -1
  56. package/dist/signet-request-resolver.js +0 -78
  57. package/dist/signet-request-resolver.js.map +0 -1
@@ -1,22 +1,42 @@
1
- import { type ResolvedSignetRequest } from "./signet-request-resolver.ts";
1
+ import { type SignetEventSource } from "./signet-contract-events.ts";
2
2
  import type { SignetPublicStateSource } from "./signet-request-response-reader.ts";
3
- import { type RequestIdHex } from "./signet-requests.ts";
3
+ import { type RequestIdHex, type SignBidirectionalEvent } from "./signet-requests.ts";
4
4
  /** Default gap between poll cycles of {@link SignetRequestFeed.requests}. */
5
5
  export declare const DEFAULT_FEED_POLL_INTERVAL_MS = 3000;
6
+ /**
7
+ * A request discovered through a notification event and read from the named
8
+ * caller's own authenticated ledger.
9
+ */
10
+ export interface ResolvedSignetRequest {
11
+ /**
12
+ * The contract whose authenticated state the request was read from: the
13
+ * epsilon-derivation predecessor. Key derivation keys off THIS, never off a
14
+ * field taken from the notification on faith.
15
+ */
16
+ callerAddress: string;
17
+ /** The request id the record is stored under in `callerAddress`'s index. */
18
+ requestId: RequestIdHex;
19
+ /** The authenticated request record to sign. */
20
+ request: SignBidirectionalEvent;
21
+ }
6
22
  /** Everything a {@link SignetRequestFeed} needs. */
7
23
  export interface SignetRequestFeedConfig {
8
- /** Address of the central signet contract whose notification registry to poll. */
24
+ /** Address of the central signet contract whose notification events to poll. */
9
25
  readonly signetContractAddress: string;
10
26
  /**
11
- * Source of raw contract state for BOTH the signet contract's registry and
12
- * the requester ledgers the resolver authenticates against — a full
13
- * `indexerPublicDataProvider` is assignable.
27
+ * Source of raw contract state for the requester ledgers the feed
28
+ * enumerates. A full `indexerPublicDataProvider` is assignable.
14
29
  */
15
30
  readonly source: SignetPublicStateSource;
31
+ /**
32
+ * Source of the signet contract's emitted events (discovery). Adapt a full
33
+ * provider with `signetEventSourceFromPublicDataProvider`.
34
+ */
35
+ readonly eventSource: SignetEventSource;
16
36
  /**
17
37
  * Optional policy allow-list of requester contract addresses to serve
18
38
  * (matched case- and `0x`-prefix-insensitively). Omit to serve every
19
- * requester the resolver can authenticate. NOT a security control.
39
+ * requester a notification points at. NOT a security control.
20
40
  */
21
41
  readonly allowContracts?: Iterable<string>;
22
42
  /** Poll cadence for {@link SignetRequestFeed.requests}; default {@link DEFAULT_FEED_POLL_INTERVAL_MS}. */
@@ -32,51 +52,56 @@ export interface SignetRequestFeedConfig {
32
52
  */
33
53
  export declare function sleepUnlessAborted(ms: number, signal?: AbortSignal): Promise<void>;
34
54
  /**
35
- * The registry-polling request feed. Reads the signet contract's notification
36
- * registry (discovery) and hands each notification to a
37
- * {@link SignetRequestResolver} (authentication), yielding only notifications
38
- * that resolve to a real, member request. Dedupes by request id across its
39
- * lifetime, so a re-registered notification is not re-yielded; call
40
- * {@link forget} to re-arm a request whose downstream processing failed.
55
+ * The event-polling request feed. Reads the signet contract's emitted
56
+ * notifications (discovery) and enumerates each pointed-at caller's own
57
+ * request map (authentication by construction: the records come from the
58
+ * caller's ledger), yielding each member request once. Dedupes by request id
59
+ * across its lifetime, so a re-notified or still-pending request is not
60
+ * re-yielded. Call {@link forget} to re-arm a request whose downstream
61
+ * processing failed.
41
62
  */
42
63
  export declare class SignetRequestFeed {
43
64
  private readonly signetContractAddress;
44
65
  private readonly source;
45
- private readonly resolver;
66
+ private readonly eventSource;
46
67
  private readonly allowContracts?;
47
68
  private readonly pollIntervalMs;
48
69
  private readonly yielded;
49
70
  /**
50
- * @param config - The signet contract, state source, and optional policy
51
- * allow-list.
71
+ * @param config - The signet contract, state and event sources, and
72
+ * optional policy allow-list.
52
73
  */
53
74
  constructor(config: SignetRequestFeedConfig);
54
75
  /** Whether the policy allow-list admits `callerAddress` (always true when unset). */
55
76
  private allowed;
56
77
  /**
57
- * One-shot: every currently-registered notification that decodes, is
58
- * admitted by the allow-list, not already yielded, and resolves to an
59
- * authenticated member request. Registry enumeration has no meaningful
60
- * on-ledger order, so entries are processed in ascending request-id-hex
61
- * order — a stable, deterministic sequence. Forged / not-yet-indexed /
62
- * wrong-field notifications resolve to nothing and are dropped WITHOUT
63
- * being marked yielded, so a genuine request whose ledger write has not
64
- * indexed yet is retried next cycle; undecodable or unsupported-version
65
- * records are likewise skipped (and logged) without being marked.
78
+ * The unique `(callerAddress, requestsPath)` pointers of the currently
79
+ * emitted notification events, allow-list applied, in ascending
80
+ * caller-address order (event enumeration order is per-source, so a
81
+ * stable sort keeps the poll deterministic). Undecodable or
82
+ * unsupported-version events are skipped (and logged): they carry no
83
+ * request, so nothing is lost.
66
84
  *
67
- * Dedupe and resolution key off the request id of the registry entry's map
68
- * key (the V1 payload no longer carries one). The key is caller-supplied,
69
- * so it confers no authority — the resolver's membership check against the
70
- * named caller's own ledger is what authenticates it.
85
+ * @returns The deduplicated pointers to enumerate this cycle.
86
+ */
87
+ private notificationPointers;
88
+ /**
89
+ * One-shot: every request in a notified caller's request map that is
90
+ * admitted by the allow-list and not already yielded. Within one caller's
91
+ * map, requests are processed in ascending request-id-hex order: a
92
+ * stable, deterministic sequence. A pointer at a caller with no readable
93
+ * state, or at a field that is not a request map, yields nothing WITHOUT
94
+ * marking anything, so a genuine request whose ledger write has not
95
+ * indexed yet is retried next cycle.
71
96
  *
72
- * @returns The newly-authenticated requests this cycle.
73
- * @throws Error if the signet contract has no readable state at the
74
- * configured address (wrong address or not yet deployed/indexed).
97
+ * @returns The newly-discovered authenticated requests this cycle.
98
+ * @throws Error when the event source itself fails (e.g. the indexer is
99
+ * unreachable).
75
100
  */
76
101
  poll(): Promise<ResolvedSignetRequest[]>;
77
102
  /**
78
103
  * Re-arm `requestId` for redelivery on the next {@link poll} / {@link requests}
79
- * cycle — call when downstream processing of a yielded request failed, so it
104
+ * cycle: call when downstream processing of a yielded request failed, so it
80
105
  * is retried (mirrors the MPC's delete-on-failure of its processed set).
81
106
  *
82
107
  * @param requestId - The request id to allow through again.
@@ -85,7 +110,7 @@ export declare class SignetRequestFeed {
85
110
  /**
86
111
  * Live stream: poll + sleep, yielding each authenticated request exactly once
87
112
  * (subject to {@link forget}), until `opts.signal` aborts. The natural
88
- * sequential `for await` consumption serializes downstream processing — no
113
+ * sequential `for await` consumption serializes downstream processing: no
89
114
  * two requests are handed over concurrently.
90
115
  *
91
116
  * @param opts.signal - Abort to stop the stream.
@@ -1 +1 @@
1
- {"version":3,"file":"signet-request-feed.d.ts","sourceRoot":"","sources":["../src/signet-request-feed.ts"],"names":[],"mappings":"AAkBA,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzE,6EAA6E;AAC7E,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,0GAA0G;IAC1G,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAaf;AAOD;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAc;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAIxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD;;;OAGG;gBACS,MAAM,EAAE,uBAAuB;IAW3C,qFAAqF;IACrF,OAAO,CAAC,OAAO;IAOf;;;;;;;;;;;;;;;;;;;OAmBG;IACG,IAAI,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAqC9C;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAIrC;;;;;;;;OAQG;IACI,QAAQ,CAAC,IAAI,CAAC,EAAE;QACrB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,qBAAqB,CAAC,qBAAqB,CAAC;CAQjD"}
1
+ {"version":3,"file":"signet-request-feed.d.ts","sourceRoot":"","sources":["../src/signet-request-feed.ts"],"names":[],"mappings":"AAmBA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAE9B,6EAA6E;AAC7E,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,SAAS,EAAE,YAAY,CAAC;IACxB,gDAAgD;IAChD,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,0GAA0G;IAC1G,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAaf;AAOD;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAc;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAIxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD;;;OAGG;gBACS,MAAM,EAAE,uBAAuB;IAW3C,qFAAqF;IACrF,OAAO,CAAC,OAAO;IAOf;;;;;;;;;OASG;YACW,oBAAoB;IAyClC;;;;;;;;;;;;OAYG;IACG,IAAI,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IA+B9C;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAIrC;;;;;;;;OAQG;IACI,QAAQ,CAAC,IAAI,CAAC,EAAE;QACrB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,qBAAqB,CAAC,qBAAqB,CAAC;CAQjD"}
@@ -1,19 +1,24 @@
1
1
  // The MPC's single entry point for discovering signature requests: poll the
2
- // central signet contract's notification registry (ledger field 4), resolve
3
- // each notification to an AUTHENTICATED request read from the named caller's
4
- // own ledger, and yield only the ones that pass the membership check. The
5
- // registry is append-only with no on-ledger cursor, so the feed's in-memory
6
- // `yielded` set is the diff cursor: every poll enumerates the registry and
7
- // serves what it has not served before.
2
+ // central signet contract's emitted SignBidirectionalEvent notifications,
3
+ // follow each to the named caller contract, and enumerate the AUTHENTICATED
4
+ // requests in that caller's own request map. A notification is a doorbell,
5
+ // never an authority: it says only WHERE to look (caller address + the
6
+ // resolved ledger-tree path of its request map), and every request served
7
+ // comes from the named caller's own ledger. An attacker cannot write into a
8
+ // contract it does not control, so a forged notification can at most
9
+ // re-point at a legitimate caller's map, never inject a request.
10
+ //
11
+ // The event log has no on-ledger cursor the feed consumes, so the feed's
12
+ // in-memory `yielded` set is the diff cursor: every poll enumerates the
13
+ // pointed-at maps and serves what it has not served before.
8
14
  //
9
15
  // The requester allow-list is an OPTIONAL policy filter here (drop requests
10
16
  // from contracts you choose not to serve), never a security requirement and
11
- // never the discovery mechanism — attribution comes from the resolver's
12
- // authenticated read (see signet-request-resolver.ts and
13
- // knowledge-base/caller-attribution.md).
14
- import { decodeSignBidirectionalNotification, readSignBidirectionalNotificationIndexFromState, } from "./signet-contract-state-reader.js";
15
- import { SignetRequestResolver, } from "./signet-request-resolver.js";
16
- import { stripHexPrefix } from "./signet-requests.js";
17
+ // never the discovery mechanism: attribution comes from reading the
18
+ // caller's authenticated state.
19
+ import { decodeSignBidirectionalEventNotificationPayload, decodeSignBidirectionalNotification, SignetEventName, } from "./signet-contract-events.js";
20
+ import { readSignetRequestIndexAt } from "./signature-requests-state-reader.js";
21
+ import { stripHexPrefix, } from "./signet-requests.js";
17
22
  /** Default gap between poll cycles of {@link SignetRequestFeed.requests}. */
18
23
  export const DEFAULT_FEED_POLL_INTERVAL_MS = 3000;
19
24
  /**
@@ -44,30 +49,31 @@ function normalizeAddress(address) {
44
49
  return stripHexPrefix(address).toLowerCase();
45
50
  }
46
51
  /**
47
- * The registry-polling request feed. Reads the signet contract's notification
48
- * registry (discovery) and hands each notification to a
49
- * {@link SignetRequestResolver} (authentication), yielding only notifications
50
- * that resolve to a real, member request. Dedupes by request id across its
51
- * lifetime, so a re-registered notification is not re-yielded; call
52
- * {@link forget} to re-arm a request whose downstream processing failed.
52
+ * The event-polling request feed. Reads the signet contract's emitted
53
+ * notifications (discovery) and enumerates each pointed-at caller's own
54
+ * request map (authentication by construction: the records come from the
55
+ * caller's ledger), yielding each member request once. Dedupes by request id
56
+ * across its lifetime, so a re-notified or still-pending request is not
57
+ * re-yielded. Call {@link forget} to re-arm a request whose downstream
58
+ * processing failed.
53
59
  */
54
60
  export class SignetRequestFeed {
55
61
  signetContractAddress;
56
62
  source;
57
- resolver;
63
+ eventSource;
58
64
  allowContracts;
59
65
  pollIntervalMs;
60
- // Request ids already yielded. NOT the security boundary (the resolver is) —
61
- // just an at-most-once gate so one request is not processed twice.
66
+ // Request ids already yielded. NOT the security boundary (the caller-ledger
67
+ // read is), just an at-most-once gate so one request is not processed twice.
62
68
  yielded = new Set();
63
69
  /**
64
- * @param config - The signet contract, state source, and optional policy
65
- * allow-list.
70
+ * @param config - The signet contract, state and event sources, and
71
+ * optional policy allow-list.
66
72
  */
67
73
  constructor(config) {
68
74
  this.signetContractAddress = config.signetContractAddress;
69
75
  this.source = config.source;
70
- this.resolver = new SignetRequestResolver({ source: config.source });
76
+ this.eventSource = config.eventSource;
71
77
  this.allowContracts = config.allowContracts
72
78
  ? new Set(Array.from(config.allowContracts, normalizeAddress))
73
79
  : undefined;
@@ -80,58 +86,85 @@ export class SignetRequestFeed {
80
86
  this.allowContracts.has(normalizeAddress(callerAddress)));
81
87
  }
82
88
  /**
83
- * One-shot: every currently-registered notification that decodes, is
84
- * admitted by the allow-list, not already yielded, and resolves to an
85
- * authenticated member request. Registry enumeration has no meaningful
86
- * on-ledger order, so entries are processed in ascending request-id-hex
87
- * order — a stable, deterministic sequence. Forged / not-yet-indexed /
88
- * wrong-field notifications resolve to nothing and are dropped WITHOUT
89
- * being marked yielded, so a genuine request whose ledger write has not
90
- * indexed yet is retried next cycle; undecodable or unsupported-version
91
- * records are likewise skipped (and logged) without being marked.
92
- *
93
- * Dedupe and resolution key off the request id of the registry entry's map
94
- * key (the V1 payload no longer carries one). The key is caller-supplied,
95
- * so it confers no authority — the resolver's membership check against the
96
- * named caller's own ledger is what authenticates it.
89
+ * The unique `(callerAddress, requestsPath)` pointers of the currently
90
+ * emitted notification events, allow-list applied, in ascending
91
+ * caller-address order (event enumeration order is per-source, so a
92
+ * stable sort keeps the poll deterministic). Undecodable or
93
+ * unsupported-version events are skipped (and logged): they carry no
94
+ * request, so nothing is lost.
97
95
  *
98
- * @returns The newly-authenticated requests this cycle.
99
- * @throws Error if the signet contract has no readable state at the
100
- * configured address (wrong address or not yet deployed/indexed).
96
+ * @returns The deduplicated pointers to enumerate this cycle.
101
97
  */
102
- async poll() {
103
- const state = await this.source.queryContractState(this.signetContractAddress);
104
- if (!state?.data) {
105
- throw new Error(`No contract state at signet contract ${this.signetContractAddress} ` +
106
- `— wrong address, or not yet deployed/indexed`);
107
- }
108
- const registry = readSignBidirectionalNotificationIndexFromState(state.data);
109
- const out = [];
110
- for (const [requestId, record] of [...registry.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {
98
+ async notificationPointers() {
99
+ const events = await this.eventSource.querySignetEvents(this.signetContractAddress);
100
+ const pointers = new Map();
101
+ for (const event of events) {
102
+ if (event.name !== SignetEventName.SignBidirectionalEvent)
103
+ continue;
111
104
  let notification;
112
105
  try {
113
- notification = decodeSignBidirectionalNotification(record);
106
+ notification = decodeSignBidirectionalNotification(decodeSignBidirectionalEventNotificationPayload(event.payload));
114
107
  }
115
108
  catch (error) {
116
- console.warn(`SignetRequestFeed: skipping undecodable notification ` +
117
- `registered under ${requestId}: ${String(error)}`);
109
+ console.warn(`SignetRequestFeed: skipping undecodable notification event: ${String(error)}`);
118
110
  continue;
119
111
  }
120
- if (this.yielded.has(requestId))
121
- continue;
122
112
  if (!this.allowed(notification.callerAddress))
123
113
  continue;
124
- const resolved = await this.resolver.resolve(requestId, notification);
125
- if (resolved === undefined)
126
- continue;
127
- this.yielded.add(requestId);
128
- out.push(resolved);
114
+ pointers.set(`${notification.callerAddress}:${notification.requestsPath.join(",")}`, {
115
+ callerAddress: notification.callerAddress,
116
+ requestsPath: notification.requestsPath,
117
+ });
118
+ }
119
+ return [...pointers.values()].sort((a, b) => a.callerAddress < b.callerAddress
120
+ ? -1
121
+ : a.callerAddress > b.callerAddress
122
+ ? 1
123
+ : 0);
124
+ }
125
+ /**
126
+ * One-shot: every request in a notified caller's request map that is
127
+ * admitted by the allow-list and not already yielded. Within one caller's
128
+ * map, requests are processed in ascending request-id-hex order: a
129
+ * stable, deterministic sequence. A pointer at a caller with no readable
130
+ * state, or at a field that is not a request map, yields nothing WITHOUT
131
+ * marking anything, so a genuine request whose ledger write has not
132
+ * indexed yet is retried next cycle.
133
+ *
134
+ * @returns The newly-discovered authenticated requests this cycle.
135
+ * @throws Error when the event source itself fails (e.g. the indexer is
136
+ * unreachable).
137
+ */
138
+ async poll() {
139
+ const out = [];
140
+ for (const pointer of await this.notificationPointers()) {
141
+ let state;
142
+ try {
143
+ state = await this.source.queryContractState(pointer.callerAddress);
144
+ }
145
+ catch {
146
+ continue; // caller address not a contract / transient read error
147
+ }
148
+ if (!state?.data) {
149
+ continue; // no state at the named caller: nothing to serve yet
150
+ }
151
+ const index = readSignetRequestIndexAt(state.data, pointer.requestsPath);
152
+ for (const [requestId, request] of [...index.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {
153
+ if (this.yielded.has(requestId))
154
+ continue;
155
+ this.yielded.add(requestId);
156
+ out.push({
157
+ callerAddress: pointer.callerAddress,
158
+ requestId,
159
+ request,
160
+ });
161
+ }
129
162
  }
130
163
  return out;
131
164
  }
132
165
  /**
133
166
  * Re-arm `requestId` for redelivery on the next {@link poll} / {@link requests}
134
- * cycle — call when downstream processing of a yielded request failed, so it
167
+ * cycle: call when downstream processing of a yielded request failed, so it
135
168
  * is retried (mirrors the MPC's delete-on-failure of its processed set).
136
169
  *
137
170
  * @param requestId - The request id to allow through again.
@@ -142,7 +175,7 @@ export class SignetRequestFeed {
142
175
  /**
143
176
  * Live stream: poll + sleep, yielding each authenticated request exactly once
144
177
  * (subject to {@link forget}), until `opts.signal` aborts. The natural
145
- * sequential `for await` consumption serializes downstream processing — no
178
+ * sequential `for await` consumption serializes downstream processing: no
146
179
  * two requests are handed over concurrently.
147
180
  *
148
181
  * @param opts.signal - Abort to stop the stream.
@@ -1 +1 @@
1
- {"version":3,"file":"signet-request-feed.js","sourceRoot":"","sources":["../src/signet-request-feed.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"signet-request-feed.js","sourceRoot":"","sources":["../src/signet-request-feed.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,2EAA2E;AAC3E,uEAAuE;AACvE,0EAA0E;AAC1E,4EAA4E;AAC5E,qEAAqE;AACrE,iEAAiE;AACjE,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,4DAA4D;AAC5D,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,oEAAoE;AACpE,gCAAgC;AAEhC,OAAO,EACL,+CAA+C,EAC/C,mCAAmC,EACnC,eAAe,GAEhB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EACL,cAAc,GAGf,MAAM,sBAAsB,CAAC;AAE9B,6EAA6E;AAC7E,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC;AA2ClD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAU,EACV,MAAoB;IAEpB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,OAAO,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IACX,qBAAqB,CAAS;IAC9B,MAAM,CAA0B;IAChC,WAAW,CAAoB;IAC/B,cAAc,CAAe;IAC7B,cAAc,CAAS;IAExC,4EAA4E;IAC5E,6EAA6E;IAC5D,OAAO,GAAG,IAAI,GAAG,EAAgB,CAAC;IAEnD;;;OAGG;IACH,YAAY,MAA+B;QACzC,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAAC,qBAAqB,CAAC;QAC1D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc;YACzC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;YAC9D,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,CAAC,cAAc;YACjB,MAAM,CAAC,cAAc,IAAI,6BAA6B,CAAC;IAC3D,CAAC;IAED,qFAAqF;IAC7E,OAAO,CAAC,aAAqB;QACnC,OAAO,CACL,IAAI,CAAC,cAAc,KAAK,SAAS;YACjC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CACzD,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACK,KAAK,CAAC,oBAAoB;QAGhC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CACrD,IAAI,CAAC,qBAAqB,CAC3B,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAGrB,CAAC;QACJ,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,sBAAsB;gBAAE,SAAS;YACpE,IAAI,YAAY,CAAC;YACjB,IAAI,CAAC;gBACH,YAAY,GAAG,mCAAmC,CAChD,+CAA+C,CAAC,KAAK,CAAC,OAAO,CAAC,CAC/D,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CACV,+DAA+D,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/E,CAAC;gBACF,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC;gBAAE,SAAS;YACxD,QAAQ,CAAC,GAAG,CACV,GAAG,YAAY,CAAC,aAAa,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EACtE;gBACE,aAAa,EAAE,YAAY,CAAC,aAAa;gBACzC,YAAY,EAAE,YAAY,CAAC,YAAY;aACxC,CACF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC1C,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa;YAC/B,CAAC,CAAC,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa;gBACjC,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,CAAC,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,OAAO,IAAI,MAAM,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;YACxD,IAAI,KAAK,CAAC;YACV,IAAI,CAAC;gBACH,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,CAAC,uDAAuD;YACnE,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;gBACjB,SAAS,CAAC,qDAAqD;YACjE,CAAC;YACD,MAAM,KAAK,GAAG,wBAAwB,CACpC,KAAK,CAAC,IAAI,EACV,OAAO,CAAC,YAAY,CACrB,CAAC;YACF,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAC1D,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3C,EAAE,CAAC;gBACF,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;oBAAE,SAAS;gBAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC5B,GAAG,CAAC,IAAI,CAAC;oBACP,aAAa,EAAE,OAAO,CAAC,aAAa;oBACpC,SAAS;oBACT,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,SAAuB;QAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,QAAQ,CAAC,IAEf;QACC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,KAAK,MAAM,QAAQ,IAAI,KAAK;gBAAE,MAAM,QAAQ,CAAC;YAC7C,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO;gBAAE,MAAM;YACjC,MAAM,kBAAkB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF"}