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

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,30 +68,30 @@ 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
+     * Retrieve a contract's events: see
      * `PublicDataProvider.queryContractEvents`.
      *
      * @param filter - The contract address and event-type narrowing.
+     * @param filter.contractAddress - The contract whose events to read.
+     * @param filter.types - Event types to keep; omit for all of them.
      * @returns The matching events, oldest first.
      */
     queryContractEvents(filter: {
@@ -90,10 +105,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 +128,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 +142,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 +153,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 +165,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 +180,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 +189,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 +212,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 +227,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.
@@ -115,11 +117,11 @@ export function signetEventSourceFromPublicDataProvider(provider) {
                     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 +138,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 +167,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 +179,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 +201,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 +226,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 +234,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"}

package/dist/signet-evtype2tx-record-decoding.js

@@ -0,0 +1,97 @@
+// Raw-cell decoding of a stored evmType2 request record: measure the
+// capacity instantiation the requester contract was compiled with from the
+// cell's declared alignment widths, instantiate the record descriptor once
+// and decode once. The TS twin of the capacity measurement in the MPC's Rust
+// reader (chain-signatures/chain-midnight/src/reader.rs) and MUST stay in
+// lockstep with it. The chain-agnostic reading and the per-decomposition
+// dispatch live in signature-requests-state-reader.ts.
+import { declaredWidths, decodeExactly } from "./compact-descriptors.js";
+import { signBidirectionalEventDescriptor } from "./signet-evtype2tx-requests.js";
+// Atom layout of an evmType2 request record: the fixed atom count, the
+// fixed head before the calldata words, and the fixed tail (caip2Id + the
+// two schemas). A stored cell holds
+// EVM_TYPE2_FIXED_ATOMS + maxCalldataWords
+//   + maxAccessListEntries * (2 + maxStorageKeysPerEntry) atoms.
+const EVM_TYPE2_FIXED_ATOMS = 22;
+const EVM_TYPE2_HEAD_ATOMS = 18;
+const EVM_TYPE2_TAIL_ATOMS = 3;
+/**
+ * Recover the sizing parameters the requester's contract was compiled with
+ * (`#maxCalldataWords`, `#maxAccessListEntries`, `#maxStorageKeysPerEntry`)
+ * from the declared widths alone. The tail anchors from the end: calldata
+ * words, storage keys and `caip2Id` are all `Bytes<32>`, so no forward scan
+ * can find the boundaries.
+ *
+ * @param widths - The record's declared atom widths.
+ * @param what - Error-message subject.
+ * @returns The capacity instantiation.
+ * @throws {Error} If the widths are not an evmType2 record's.
+ */
+function evmType2Capacities(widths, what) {
+    if (widths.length < EVM_TYPE2_FIXED_ATOMS) {
+        throw new Error(`${what} has ${String(widths.length)} value atoms, fewer than the ` +
+            `${String(EVM_TYPE2_FIXED_ATOMS)} its fixed fields need`);
+    }
+    const tail = widths.length - EVM_TYPE2_TAIL_ATOMS;
+    let index = EVM_TYPE2_HEAD_ATOMS;
+    while (index < tail && widths[index] === 32) {
+        index += 1;
+    }
+    const maxCalldataWords = index - EVM_TYPE2_HEAD_ATOMS;
+    const boundary = index < tail ? widths[index] : undefined;
+    if (boundary !== 1) {
+        const found = boundary === undefined ? "the record's tail" : `Bytes<${String(boundary)}>`;
+        throw new Error(`expected the Bytes<1> access-list entry count after ${String(maxCalldataWords)} ` +
+            `calldata words, found ${found}`);
+    }
+    index += 1;
+    const region = widths.slice(index, tail);
+    const maxAccessListEntries = region.filter((width) => width === 20).length;
+    let maxStorageKeysPerEntry;
+    if (maxAccessListEntries === 0) {
+        if (region.length !== 0) {
+            throw new Error(`the access-list region holds ${String(region.length)} atoms but declares no ` +
+                `Bytes<20> entry address`);
+        }
+        maxStorageKeysPerEntry = 0;
+    }
+    else {
+        if (region.length % maxAccessListEntries !== 0) {
+            throw new Error(`the access-list region's ${String(region.length)} atoms do not divide evenly ` +
+                `across ${String(maxAccessListEntries)} entries`);
+        }
+        const perEntry = region.length / maxAccessListEntries;
+        if (perEntry < 2) {
+            throw new Error(`each access-list entry needs at least an address and a key count, ` +
+                `got ${String(perEntry)} atoms`);
+        }
+        maxStorageKeysPerEntry = perEntry - 2;
+    }
+    return { maxCalldataWords, maxAccessListEntries, maxStorageKeysPerEntry };
+}
+/**
+ * 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 function decodeEvmType2SignBidirectionalEvent(cell, what) {
+    const widths = declaredWidths(cell, what);
+    const capacities = evmType2Capacities(widths, what);
+    const lenOutputDeserialization = widths.at(-2);
+    const lenRespondSerialization = widths.at(-1);
+    if (lenOutputDeserialization === undefined || lenRespondSerialization === undefined) {
+        throw new Error(`${what} has ${String(widths.length)} value atoms: too few to hold the ` +
+            `trailing output-deserialization and respond-serialization schemas`);
+    }
+    return decodeExactly(signBidirectionalEventDescriptor(capacities.maxCalldataWords, capacities.maxAccessListEntries, capacities.maxStorageKeysPerEntry, lenOutputDeserialization, lenRespondSerialization), cell.value, what);
+}
+//# sourceMappingURL=signet-evtype2tx-record-decoding.js.map

package/dist/signet-evtype2tx-record-decoding.js.map

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