@sig-net/midnight 0.19.0 → 0.21.0-rc.1

package/dist/signature-response-verification.js

@@ -1,32 +1,36 @@
 // Client-side verification of MPC signature responses. The signet contract
 // emits signature responses UNAUTHENTICATED (see the module header in
-// Signet.compact), so a poller must verify every posted response
-// before trusting it: rebuild the unsigned EVM transaction from the on-ledger
-// request record, assembled exactly as the MPC assembles it (sig-net/mpc
-// response server, managed/erc20-vault/signet/calldata-builder.ts), and
-// check that the posted signature record recovers to the requester's derived
-// EVM address over that transaction's signing hash.
+// Signet.compact), so a poller must verify every posted response before
+// trusting it.
 import { getAddress, recoverAddress } from "ethers";
-import { signBidirectionalEventToUnsignedEvmTransaction, signatureRespondedEventToSignature, } from "./signet-evtype2tx-requests.js";
+import { signatureRespondedEventToSignature } from "./ecdsa-attestation.js";
+import { signBidirectionalEventToUnsignedEvmTransaction } from "./signet-evtype2tx-requests.js";
+import { TxParamType } from "./signet-requests.js";
 /**
- * Recover the EVM address that produced a response signature, over the
- * signing hash of the transaction the request describes.
+ * Recover the address that produced a response signature, over the signing
+ * digest of the transaction the request describes: the response-side
+ * dispatch on the request's `txParamType`.
  *
  * @param request - The on-ledger request record the response answers.
  * @param response - The posted signature record answering it.
  * @returns The checksummed recovered signer address.
- * @throws Error if the response is not a decodable signature or the request
- *   record is malformed (see
+ * @throws {Error} If the request's `txParamType` names a decomposition this
+ *   library does not sign-verify, the response is not a decodable signature,
+ *   or the request record is malformed (see
  *   {@link signBidirectionalEventToUnsignedEvmTransaction}).
  */
 export function recoverSignatureResponseSigner(request, response) {
-    return recoverAddress(signBidirectionalEventToUnsignedEvmTransaction(request).unsignedHash, signatureRespondedEventToSignature(response));
+    switch (request.txParamType) {
+        case TxParamType.evmType2:
+            return recoverAddress(signBidirectionalEventToUnsignedEvmTransaction(request).unsignedHash, signatureRespondedEventToSignature(response));
+        default:
+            throw new Error(`unsupported txParamType ${String(request.txParamType)}`);
+    }
 }
 /**
  * Verify a posted response against its request: does the signature recover
- * to `expectedSigner`? Never throws: a response that is malformed or signed
- * by anyone else is simply not valid, which is the expected state of affairs
- * on an unauthenticated log.
+ * to `expectedSigner`? Never throws: a malformed or wrongly-signed response
+ * is simply not valid.
  *
  * @param request - The on-ledger request record the response answers.
  * @param response - The posted signature record answering it.
@@ -35,8 +39,7 @@ export function recoverSignatureResponseSigner(request, response) {
  */
 export function verifySignatureRespondedEvent(request, response, expectedSigner) {
     try {
-        return (recoverSignatureResponseSigner(request, response) ===
-            getAddress(expectedSigner));
+        return recoverSignatureResponseSigner(request, response) === getAddress(expectedSigner);
     }
     catch {
         return false;

package/dist/signature-response-verification.js.map

@@ -1 +1 @@
-{"version":3,"file":"signature-response-verification.js","sourceRoot":"","sources":["../src/signature-response-verification.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,sEAAsE;AACtE,iEAAiE;AACjE,8EAA8E;AAC9E,yEAAyE;AACzE,wEAAwE;AACxE,6EAA6E;AAC7E,oDAAoD;AAEpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEpD,OAAO,EACL,8CAA8C,EAC9C,kCAAkC,GACnC,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAA+B,EAC/B,QAAiC;IAEjC,OAAO,cAAc,CACnB,8CAA8C,CAAC,OAAO,CAAC,CAAC,YAAY,EACpE,kCAAkC,CAAC,QAAQ,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA+B,EAC/B,QAAiC,EACjC,cAAsB;IAEtB,IAAI,CAAC;QACH,OAAO,CACL,8BAA8B,CAAC,OAAO,EAAE,QAAQ,CAAC;YACjD,UAAU,CAAC,cAAc,CAAC,CAC3B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"signature-response-verification.js","sourceRoot":"","sources":["../src/signature-response-verification.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,sEAAsE;AACtE,wEAAwE;AACxE,eAAe;AAEf,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEpD,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,8CAA8C,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAA+B,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAA+B,EAC/B,QAAiC;IAEjC,QAAQ,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5B,KAAK,WAAW,CAAC,QAAQ;YACvB,OAAO,cAAc,CACnB,8CAA8C,CAAC,OAAO,CAAC,CAAC,YAAY,EACpE,kCAAkC,CAAC,QAAQ,CAAC,CAC7C,CAAC;QACJ;YACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA+B,EAC/B,QAAiC,EACjC,cAAsB;IAEtB,IAAI,CAAC;QACH,OAAO,8BAA8B,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,UAAU,CAAC,cAAc,CAAC,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/signet-contract-events.d.ts

@@ -18,9 +18,8 @@ export declare const SIGNET_EVENT_NAME_LENGTH = 32;
 export declare const SIGNET_EVENT_PAYLOAD_LENGTH = 256;
 /**
  * A signet contract event in decoded form: the NUL-trimmed name and the full
- * re-padded {@link SIGNET_EVENT_PAYLOAD_LENGTH}-byte payload. This is the
- * one shape every source (simulator log, indexer Misc event) normalizes to
- * before the per-event payload decoders run.
+ * re-padded {@link SIGNET_EVENT_PAYLOAD_LENGTH}-byte payload. The one shape
+ * every source normalises to before the per-event payload decoders run.
  */
 export interface SignetMiscEvent {
     /** The event name, NUL padding stripped (compare to {@link SignetEventName}). */
@@ -30,8 +29,8 @@ export interface SignetMiscEvent {
 }
 /**
  * Source of the signet contract's emitted events, the event-side sibling of
- * {@link SignetPublicStateSource}. Declared structurally so tests can satisfy
- * it with a plain stub; adapt a full midnight-js `PublicDataProvider` with
+ * `SignetPublicStateSource`. Structural, so tests can stub it. Adapt a
+ * full midnight-js `PublicDataProvider` with
  * {@link signetEventSourceFromPublicDataProvider}.
  */
 export interface SignetEventSource {
@@ -44,6 +43,22 @@ export interface SignetEventSource {
      */
     querySignetEvents(contractAddress: string): Promise<SignetMiscEvent[]>;
 }
+/**
+ * Whether a decoded event carries `name`.
+ *
+ * A decoded event's `name` comes from arbitrary on-chain bytes, so it is a
+ * plain string and NOT the enum. Comparing the two directly is what
+ * `no-unsafe-enum-comparison` exists to catch, and it is right to: the
+ * widening belongs here, once, rather than at every call site.
+ *
+ * @param event - The decoded signet event.
+ * @param event.name - Its decoded, NUL-stripped event name.
+ * @param name - The event name to match.
+ * @returns Whether the event's decoded name equals `name`.
+ */
+export declare function isSignetEventNamed(event: {
+    name: string;
+}, name: SignetEventName): boolean;
 /**
  * Strip the NUL padding off a fixed-width event name and decode it as ASCII:
  * the inverse of the contract's `pad(32, "...")`.
@@ -53,35 +68,44 @@ export interface SignetEventSource {
  */
 export declare function decodeSignetEventName(name: Uint8Array): string;
 /**
- * Decode the simulator's circuit-execution log into signet events: keep the
- * `misc` emissions (of `contractAddress` when given), re-pad each to the full
- * name ++ payload width, and split. Non-signet-shaped `misc` events (wrong
- * atom shape or width) throw: in the simulator the emitting contract is under
- * test, so a malformed event is a bug, not noise to skip.
+ * Decode the simulator's circuit-execution log into signet events. For
+ * simulator tests. The indexer-path counterpart is
+ * {@link signetEventSourceFromPublicDataProvider}.
  *
  * @param events - The `context.events` of a `CircuitResults`.
  * @param contractAddress - Optional filter: only events this contract emitted.
  * @returns The decoded events, in emission order.
- * @throws Error when a `misc` event is not a single bytes atom of the signet
+ * @throws {Error} When a `misc` event is not a single bytes atom of the signet
  *   name ++ payload width.
  */
 export declare function decodeSignetLogEvents(events: readonly LogEvent[], contractAddress?: string): SignetMiscEvent[];
 /**
  * The least of a midnight-js `PublicDataProvider` the event source adapter
  * needs: the `Misc` contract events of one address. Structural, so any full
- * provider (e.g. `indexerPublicDataProvider`) is assignable.
+ * provider is assignable.
  */
 export interface SignetContractEventQuerySource {
     /**
-     * Retrieve a contract's events; see
-     * `PublicDataProvider.queryContractEvents`.
+     * Retrieve one page of a contract's events: see
+     * `PublicDataProvider.queryContractEvents`. Callers MUST pass `page` and
+     * keep requesting until a short page: a provider caps an un-paged call at
+     * its default page size (midnight-js: 100), silently truncating a busy
+     * contract's history.
      *
      * @param filter - The contract address and event-type narrowing.
-     * @returns The matching events, oldest first.
+     * @param filter.contractAddress - The contract whose events to read.
+     * @param filter.types - Event types to keep; omit for all of them.
+     * @param page - The window to read: `limit` events starting at `offset`.
+     * @param page.limit - Maximum events to return.
+     * @param page.offset - Events to skip from the start of the history.
+     * @returns The matching events in the window, oldest first.
      */
     queryContractEvents(filter: {
         contractAddress: string;
         types?: "Misc"[];
+    }, page: {
+        limit: number;
+        offset: number;
     }): Promise<{
         eventType: string;
         name?: string;
@@ -90,10 +114,8 @@ export interface SignetContractEventQuerySource {
 }
 /**
  * Adapt a midnight-js `PublicDataProvider` (or anything exposing its
- * `queryContractEvents`) into a {@link SignetEventSource}: query the `Misc`
- * events and normalize each into a {@link SignetMiscEvent}. The indexer
- * serves `name` and `payload` as hex-encoded byte strings; the name is
- * NUL-trimmed and the payload re-padded to the full
+ * `queryContractEvents`) into a {@link SignetEventSource}. Each event's name
+ * is NUL-trimmed and its payload re-padded to the full
  * {@link SIGNET_EVENT_PAYLOAD_LENGTH}.
  *
  * @param provider - The provider to query events through.
@@ -115,10 +137,9 @@ export interface AffinePoint {
  * The MPC's canonical ECDSA signature as both respond events carry it
  * (Compact `Signature`, matching the MPC's own
  * `Signature { big_r, s, recovery_id }` and the EVM/Solana signer
- * contracts): `bigR` the full nonce point so consumers never decompress,
- * `s` big-endian, `recoveryId` the parity of R.y. Emitted UNVERIFIED like
- * everything else on the singleton. Convert with
- * `ecdsaSignatureToMpcSignature` / `mpcSignatureToEcdsaSignature`.
+ * contracts). Emitted UNVERIFIED. Decode to an ethers signature with
+ * `signatureRespondedEventToSignature`. Tests mint records with the
+ * `@sig-net/midnight/testing` entry point's `ecdsaSignatureToMpcSignature`.
  */
 export interface MpcSignature {
     /** The signature's nonce point R. */
@@ -130,12 +151,9 @@ export interface MpcSignature {
 }
 /**
  * The MPC's signature over the requested EVM transaction (Compact
- * `SignatureRespondedEvent`): decode to an ethers signature with
- * `signatureRespondedEventToSignature`. The emitting event carries the
- * record beside the request id it answers (see {@link SignetEventPost});
- * the id routes, and VERIFYING the signature against the transaction the
- * request describes establishes authenticity (see
- * {@link SignetRequestResponseReader.getVerifiedSignatureRespondedEvent}).
+ * `SignatureRespondedEvent`), carried beside the request id it answers (see
+ * {@link SignetEventPost}). Emitted UNVERIFIED: authenticity comes from
+ * `SignetRequestResponseReader.getVerifiedSignatureRespondedEvent`.
  */
 export interface SignatureRespondedEvent {
     /** The requested signature over the transaction the request describes. */
@@ -144,15 +162,10 @@ export interface SignatureRespondedEvent {
 /**
  * The MPC's respond-bidirectional attestation of a request's remote EVM
  * execution (Compact `RespondBidirectionalEvent`): the ECDSA signature over
- * the attestation digest `keccak256(requestId || serializedOutput)`. Both the
- * digest and the output travel off chain: readers fetch the output, recompute
- * the digest (`calculateSignetAttestationDigest`) and verify the signature
- * over it. Emitted UNVERIFIED by the signet contract, beside the request id
- * it answers (see {@link SignetEventPost}), so that signature check
- * against the expected MPC response key is the only thing separating a
- * genuine post from garbage: in-circuit via
- * `verifyRespondBidirectionalEvent`, off chain via
- * {@link verifyRespondBidirectionalSignature}.
+ * the attestation digest (`calculateSignetAttestationDigest`), carried
+ * beside the request id it answers (see {@link SignetEventPost}). Emitted
+ * UNVERIFIED: verify in-circuit via `verifyRespondBidirectionalEvent` or off
+ * chain via `verifyRespondBidirectionalSignature`.
  */
 export interface RespondBidirectionalEvent {
     /** ECDSA signature over the attestation digest. */
@@ -161,13 +174,8 @@ export interface RespondBidirectionalEvent {
 /**
  * A decoded signet event payload: the request id the emitting circuit
  * disclosed beside the posted record. The id is UNAUTHENTICATED routing
- * data: it scopes reads to one request and proves nothing. For the respond
- * events, verifying the record's signature against the request remains the
- * authenticity check (see
- * {@link SignetRequestResponseReader.getVerifiedSignatureRespondedEvent} and
- * {@link SignetRequestResponseReader.getVerifiedRespondBidirectionalEvent});
- * for the notification, reading the declared request back from the named
- * caller's own ledger does (see signet-request-feed.ts).
+ * data: it scopes reads to one request and proves nothing. Each record
+ * type's own doc names its authenticity check.
  */
 export interface SignetEventPost<TRecord> {
     /** The request id the post declares it concerns, 32 bytes. Routing data only. */
@@ -181,7 +189,7 @@ export interface SignetEventPost<TRecord> {
  *
  * @param payload - The event's payload.
  * @returns The decoded post: declared request id plus record.
- * @throws Error when the payload is too short to hold the packed leaves.
+ * @throws {Error} When the payload is too short to hold the packed leaves.
  */
 export declare function decodeSignatureRespondedEventPayload(payload: Uint8Array): SignetEventPost<SignatureRespondedEvent>;
 /**
@@ -190,7 +198,7 @@ export declare function decodeSignatureRespondedEventPayload(payload: Uint8Array
  *
  * @param payload - The event's payload.
  * @returns The decoded post: declared request id plus record.
- * @throws Error when the payload is too short to hold the packed leaves.
+ * @throws {Error} When the payload is too short to hold the packed leaves.
  */
 export declare function decodeRespondBidirectionalEventPayload(payload: Uint8Array): SignetEventPost<RespondBidirectionalEvent>;
 /**
@@ -213,17 +221,14 @@ export interface SignBidirectionalNotificationRecord {
  *
  * @param payload - The event's payload.
  * @returns The decoded post: declared request id plus raw notification record.
- * @throws Error when the payload is too short to hold the record.
+ * @throws {Error} When the payload is too short to hold the record.
  */
 export declare function decodeSignBidirectionalEventNotificationPayload(payload: Uint8Array): SignetEventPost<SignBidirectionalNotificationRecord>;
 /**
  * A decoded V1 notification: the flat pointer a client emitted to tell the
- * MPC a request was stored, and WHERE to read the authenticated copy. The
- * emitting event declares the stored request's id beside this record (see
- * {@link SignetEventPost}): the MPC looks that id up in the request map the
- * notification points at and reads the request from the named caller's own
- * authenticated ledger (see signet-request-feed.ts). The fields themselves
- * confer no authority.
+ * MPC a request was stored, and WHERE to read the authenticated copy
+ * (resolve with `lookupSignetRequestAt`). The fields themselves confer no
+ * authority.
  */
 export interface SignBidirectionalNotification {
     /** Payload layout tag: this decoder only produces version 1. */
@@ -231,36 +236,32 @@ export interface SignBidirectionalNotification {
     /**
      * Address of the contract whose request map holds the request, rendered
      * as lowercase hex, no `0x` prefix: directly usable as a
-     * `queryContractState` argument. The MPC reads requests from THIS
-     * contract's authenticated state. The field itself confers no authority.
+     * `queryContractState` argument.
      */
     callerAddress: string;
     /**
      * Resolved ledger-tree path of the `SignBidirectionalEventMap` in
      * {@link callerAddress}, as compactc records it in that contract's
      * `contract-info.json` (`"index"`): `[4]` for a flat contract's field 4,
-     * `[1, 14]` once chunking applies. The reader follows it node for node
-     * (see `signetFieldNodeByPath`) and never assumes a layout.
+     * `[1, 14]` once chunking applies. Followed node for node by
+     * `signetFieldNodeByPath`.
      */
     requestsPath: number[];
 }
 /**
  * Unpack a {@link SignBidirectionalNotificationRecord}'s payload by the
  * fixed V1 offsets: the decode twin of the compiled
- * `constructSignBidirectionalEventNotificationV1` circuit (byte plumbing
- * only: the pack↔decode lockstep is pinned by the unit test that round-trips
- * through the real circuit). V1 layout:
+ * `constructSignBidirectionalEventNotificationV1` circuit (the pack↔decode
+ * lockstep is pinned by a unit test round-tripping through the real
+ * circuit). V1 layout:
  * callerAddress (32) ++ requestsPathDepth (1) ++ requestsPath (4) ++ zero
  * padding (91), where only the first `requestsPathDepth` path bytes are
- * meaningful.
- *
- * Fails closed on an unrecognised `version`: a future payload layout adds a
- * branch here rather than silently misinterpreting bytes under the V1 offsets.
+ * meaningful. Fails closed on an unrecognised `version`.
  *
  * @param record - The raw notification record.
  * @returns The decoded notification, its `requestsPath` trimmed to the
  *   declared depth.
- * @throws Error if the record's `version` is not one this decoder understands,
+ * @throws {Error} If the record's `version` is not one this decoder understands,
  *   or its `requestsPathDepth` is zero or exceeds {@link MAX_LEDGER_PATH_DEPTH}.
  */
 export declare function decodeSignBidirectionalNotification(record: SignBidirectionalNotificationRecord): SignBidirectionalNotification;

package/dist/signet-contract-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signet-contract-events.d.ts","sourceRoot":"","sources":["../src/signet-contract-events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"signet-contract-events.d.ts","sourceRoot":"","sources":["../src/signet-contract-events.ts"],"names":[],"mappings":"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"}

package/dist/signet-contract-events.js

@@ -11,8 +11,9 @@
 // Every event is UNAUTHENTICATED: verification is the reader's job. The
 // request id every payload discloses is routing data only, so it scopes
 // reads to one request and proves nothing.
-import { CompactTypeBytes, } from "@midnight-ntwrk/compact-runtime";
-import { bytesToHex, hexToBytes, } from "./signet-requests.js";
+import { CompactTypeBytes } from "@midnight-ntwrk/compact-runtime";
+import { bytesToHex, hexToBytes } from "./byte-codecs.js";
+import { decodeExactly } from "./compact-descriptors.js";
 /**
  * The event names the signet contract emits, exactly as the contract's
  * `emit` literals spell them (the on-wire name is this string NUL-padded to
@@ -33,6 +34,22 @@ export const SIGNET_EVENT_NAME_LENGTH = 32;
 export const SIGNET_EVENT_PAYLOAD_LENGTH = 256;
 /** Descriptor re-padding a name ++ payload event atom to its full width. */
 const eventBytes = new CompactTypeBytes(SIGNET_EVENT_NAME_LENGTH + SIGNET_EVENT_PAYLOAD_LENGTH);
+/**
+ * Whether a decoded event carries `name`.
+ *
+ * A decoded event's `name` comes from arbitrary on-chain bytes, so it is a
+ * plain string and NOT the enum. Comparing the two directly is what
+ * `no-unsafe-enum-comparison` exists to catch, and it is right to: the
+ * widening belongs here, once, rather than at every call site.
+ *
+ * @param event - The decoded signet event.
+ * @param event.name - Its decoded, NUL-stripped event name.
+ * @param name - The event name to match.
+ * @returns Whether the event's decoded name equals `name`.
+ */
+export function isSignetEventNamed(event, name) {
+    return event.name === name;
+}
 /**
  * Strip the NUL padding off a fixed-width event name and decode it as ASCII:
  * the inverse of the contract's `pad(32, "...")`.
@@ -48,16 +65,14 @@ export function decodeSignetEventName(name) {
     return new TextDecoder().decode(name.slice(0, end));
 }
 /**
- * Decode the simulator's circuit-execution log into signet events: keep the
- * `misc` emissions (of `contractAddress` when given), re-pad each to the full
- * name ++ payload width, and split. Non-signet-shaped `misc` events (wrong
- * atom shape or width) throw: in the simulator the emitting contract is under
- * test, so a malformed event is a bug, not noise to skip.
+ * Decode the simulator's circuit-execution log into signet events. For
+ * simulator tests. The indexer-path counterpart is
+ * {@link signetEventSourceFromPublicDataProvider}.
  *
  * @param events - The `context.events` of a `CircuitResults`.
  * @param contractAddress - Optional filter: only events this contract emitted.
  * @returns The decoded events, in emission order.
- * @throws Error when a `misc` event is not a single bytes atom of the signet
+ * @throws {Error} When a `misc` event is not a single bytes atom of the signet
  *   name ++ payload width.
  */
 export function decodeSignetLogEvents(events, contractAddress) {
@@ -71,9 +86,8 @@ export function decodeSignetLogEvents(events, contractAddress) {
         if (event.data.tag !== "cell") {
             throw new Error(`misc event data is a '${event.data.tag}', expected a cell`);
         }
-        // fromValue consumes its input and re-pads the trailing zeros the state
-        // layer trims, so hand it a copy.
-        const bytes = eventBytes.fromValue([...event.data.content.value]);
+        // fromValue re-pads the trailing zeros the state layer trims.
+        const bytes = decodeExactly(eventBytes, event.data.content.value, "misc event data");
         out.push({
             name: decodeSignetEventName(bytes.slice(0, SIGNET_EVENT_NAME_LENGTH)),
             payload: bytes.slice(SIGNET_EVENT_NAME_LENGTH),
@@ -81,22 +95,10 @@ export function decodeSignetLogEvents(events, contractAddress) {
     }
     return out;
 }
-/**
- * Normalize one indexer-served hex field that may or may not carry a `0x`
- * prefix into bytes.
- *
- * @param hex - The hex string.
- * @returns The decoded bytes.
- */
-function eventFieldBytes(hex) {
-    return hexToBytes(hex.startsWith("0x") ? hex.slice(2) : hex);
-}
 /**
  * Adapt a midnight-js `PublicDataProvider` (or anything exposing its
- * `queryContractEvents`) into a {@link SignetEventSource}: query the `Misc`
- * events and normalize each into a {@link SignetMiscEvent}. The indexer
- * serves `name` and `payload` as hex-encoded byte strings; the name is
- * NUL-trimmed and the payload re-padded to the full
+ * `queryContractEvents`) into a {@link SignetEventSource}. Each event's name
+ * is NUL-trimmed and its payload re-padded to the full
  * {@link SIGNET_EVENT_PAYLOAD_LENGTH}.
  *
  * @param provider - The provider to query events through.
@@ -105,21 +107,28 @@ function eventFieldBytes(hex) {
 export function signetEventSourceFromPublicDataProvider(provider) {
     return {
         async querySignetEvents(contractAddress) {
-            const events = await provider.queryContractEvents({
-                contractAddress,
-                types: ["Misc"],
-            });
+            // Page until a short page: a single un-paged read caps at the
+            // provider's default page size and silently truncates a busy signet's
+            // history, starving every consumer of the events past the cap.
+            const events = [];
+            const pageLimit = 100;
+            for (let pageOffset = 0;; pageOffset += pageLimit) {
+                const page = await provider.queryContractEvents({ contractAddress, types: ["Misc"] }, { limit: pageLimit, offset: pageOffset });
+                events.push(...page);
+                if (page.length < pageLimit)
+                    break;
+            }
             const out = [];
             for (const event of events) {
                 if (event.eventType !== "Misc")
                     continue;
                 if (event.name === undefined || event.payload === undefined)
                     continue;
-                const payload = eventFieldBytes(event.payload);
+                const payload = hexToBytes(event.payload);
                 const padded = new Uint8Array(SIGNET_EVENT_PAYLOAD_LENGTH);
                 padded.set(payload.slice(0, SIGNET_EVENT_PAYLOAD_LENGTH), 0);
                 out.push({
-                    name: decodeSignetEventName(eventFieldBytes(event.name)),
+                    name: decodeSignetEventName(hexToBytes(event.name)),
                     payload: padded,
                 });
             }
@@ -136,17 +145,16 @@ const SIGNATURE_RECOVERY_ID_OFFSET = 128;
 /**
  * Unpack the leaves both respond payloads lead with:
  * requestId (32) ++ bigR.x (32) ++ bigR.y (32) ++ s (32) ++ recoveryId (1).
- * Bytes beyond the recovery id are padding today and are ignored, so a
- * future payload extension does not break existing readers.
+ * Bytes beyond the recovery id are padding and are ignored.
  *
  * @param payload - The full event payload.
  * @returns The declared request id and the decoded signature.
- * @throws Error when the payload is too short to hold the packed leaves.
+ * @throws {Error} When the payload is too short to hold the packed leaves.
  */
 function decodeRespondPayload(payload) {
     const recoveryId = payload[SIGNATURE_RECOVERY_ID_OFFSET];
     if (recoveryId === undefined) {
-        throw new Error(`signet event payload of ${payload.length} bytes is too short for a packed respond record`);
+        throw new Error(`signet event payload of ${String(payload.length)} bytes is too short for a packed respond record`);
     }
     return {
         requestId: payload.slice(RESPOND_REQUEST_ID_OFFSET, SIGNATURE_BIG_R_X_OFFSET),
@@ -166,7 +174,7 @@ function decodeRespondPayload(payload) {
  *
  * @param payload - The event's payload.
  * @returns The decoded post: declared request id plus record.
- * @throws Error when the payload is too short to hold the packed leaves.
+ * @throws {Error} When the payload is too short to hold the packed leaves.
  */
 export function decodeSignatureRespondedEventPayload(payload) {
     const { requestId, signature } = decodeRespondPayload(payload);
@@ -178,7 +186,7 @@ export function decodeSignatureRespondedEventPayload(payload) {
  *
  * @param payload - The event's payload.
  * @returns The decoded post: declared request id plus record.
- * @throws Error when the payload is too short to hold the packed leaves.
+ * @throws {Error} When the payload is too short to hold the packed leaves.
  */
 export function decodeRespondBidirectionalEventPayload(payload) {
     const { requestId, signature } = decodeRespondPayload(payload);
@@ -200,13 +208,13 @@ const NOTIFICATION_PAYLOAD_LENGTH = 128;
  *
  * @param payload - The event's payload.
  * @returns The decoded post: declared request id plus raw notification record.
- * @throws Error when the payload is too short to hold the record.
+ * @throws {Error} When the payload is too short to hold the record.
  */
 export function decodeSignBidirectionalEventNotificationPayload(payload) {
     const version = payload[NOTIFICATION_EVENT_VERSION_OFFSET];
     const end = NOTIFICATION_EVENT_PAYLOAD_OFFSET + NOTIFICATION_PAYLOAD_LENGTH;
     if (version === undefined || payload.length < end) {
-        throw new Error(`signet event payload of ${payload.length} bytes is too short for a packed notification`);
+        throw new Error(`signet event payload of ${String(payload.length)} bytes is too short for a packed notification`);
     }
     return {
         requestId: payload.slice(NOTIFICATION_EVENT_REQUEST_ID_OFFSET, NOTIFICATION_EVENT_PAYLOAD_OFFSET),
@@ -225,7 +233,7 @@ const NOTIFICATION_PATH_OFFSET = 33;
 /**
  * Maximum ledger-tree path depth the V1 payload carries, matching the
  * `Vector<4, Uint<8>>` the `constructSignBidirectionalEventNotificationV1`
- * circuit packs. Depth 1 addresses up to 15 fields, depth 4 up to 15^4.
+ * circuit packs.
  */
 const MAX_LEDGER_PATH_DEPTH = 4;
 /** The only payload interpretation {@link decodeSignBidirectionalNotification} understands today. */
@@ -233,32 +241,29 @@ const SUPPORTED_NOTIFICATION_VERSION = 1n;
 /**
  * Unpack a {@link SignBidirectionalNotificationRecord}'s payload by the
  * fixed V1 offsets: the decode twin of the compiled
- * `constructSignBidirectionalEventNotificationV1` circuit (byte plumbing
- * only: the pack↔decode lockstep is pinned by the unit test that round-trips
- * through the real circuit). V1 layout:
+ * `constructSignBidirectionalEventNotificationV1` circuit (the pack↔decode
+ * lockstep is pinned by a unit test round-tripping through the real
+ * circuit). V1 layout:
  * callerAddress (32) ++ requestsPathDepth (1) ++ requestsPath (4) ++ zero
  * padding (91), where only the first `requestsPathDepth` path bytes are
- * meaningful.
- *
- * Fails closed on an unrecognised `version`: a future payload layout adds a
- * branch here rather than silently misinterpreting bytes under the V1 offsets.
+ * meaningful. Fails closed on an unrecognised `version`.
  *
  * @param record - The raw notification record.
  * @returns The decoded notification, its `requestsPath` trimmed to the
  *   declared depth.
- * @throws Error if the record's `version` is not one this decoder understands,
+ * @throws {Error} If the record's `version` is not one this decoder understands,
  *   or its `requestsPathDepth` is zero or exceeds {@link MAX_LEDGER_PATH_DEPTH}.
  */
 export function decodeSignBidirectionalNotification(record) {
     if (record.version !== SUPPORTED_NOTIFICATION_VERSION) {
-        throw new Error(`SignBidirectionalEventNotification version ${record.version} is not supported ` +
-            `(this decoder understands version ${SUPPORTED_NOTIFICATION_VERSION})`);
+        throw new Error(`SignBidirectionalEventNotification version ${String(record.version)} is not supported ` +
+            `(this decoder understands version ${String(SUPPORTED_NOTIFICATION_VERSION)})`);
     }
     const callerAddress = bytesToHex(record.payload.slice(NOTIFICATION_CALLER_ADDRESS_OFFSET, NOTIFICATION_PATH_DEPTH_OFFSET));
     const depth = record.payload[NOTIFICATION_PATH_DEPTH_OFFSET];
     if (depth === undefined || depth < 1 || depth > MAX_LEDGER_PATH_DEPTH) {
-        throw new Error(`SignBidirectionalEventNotification requestsPathDepth ${depth} is out of range ` +
-            `(expected 1 to ${MAX_LEDGER_PATH_DEPTH})`);
+        throw new Error(`SignBidirectionalEventNotification requestsPathDepth ${String(depth)} is out of range ` +
+            `(expected 1 to ${String(MAX_LEDGER_PATH_DEPTH)})`);
     }
     // payload is a re-padded Bytes<128> and depth is bounded to MAX_LEDGER_PATH_DEPTH
     // above, so this slice always yields exactly `depth` bytes.

package/dist/signet-contract-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"signet-contract-events.js","sourceRoot":"","sources":["../src/signet-contract-events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"signet-contract-events.js","sourceRoot":"","sources":["../src/signet-contract-events.ts"],"names":[],"mappings":"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"}

package/dist/signet-evtype2tx-record-decoding.d.ts

@@ -0,0 +1,18 @@
+import type { AlignedValue } from "@midnight-ntwrk/compact-runtime";
+import type { SignBidirectionalEvent } from "./signet-requests.ts";
+/**
+ * Decode a stored evmType2 request record in one pass, refusing a cell whose
+ * declared widths are not a signet record's. Measures the capacity
+ * instantiation from the declared alignment widths (the schema widths from
+ * the last two atoms' DECLARED lengths), instantiates the descriptor once
+ * and decodes once. Does NOT verify the record against the id it is filed
+ * under, and does NOT check the `txParamType` tag: the dispatching caller
+ * does.
+ *
+ * @param cell - The record cell as stored (value atoms plus alignment).
+ * @param what - Error-message subject.
+ * @returns The decoded record.
+ * @throws {Error} If the cell is not a decodable evmType2 request record.
+ */
+export declare function decodeEvmType2SignBidirectionalEvent(cell: AlignedValue, what: string): SignBidirectionalEvent;
+//# sourceMappingURL=signet-evtype2tx-record-decoding.d.ts.map

package/dist/signet-evtype2tx-record-decoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signet-evtype2tx-record-decoding.d.ts","sourceRoot":"","sources":["../src/signet-evtype2tx-record-decoding.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAqFnE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,GACX,sBAAsB,CAsBxB"}