@sig-net/midnight 0.15.0 → 0.16.0

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

@@ -0,0 +1,262 @@
+import { type LogEvent } from "@midnight-ntwrk/compact-runtime";
+/**
+ * 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
+ * {@link SIGNET_EVENT_NAME_LENGTH} bytes, see {@link decodeSignetEventName}).
+ */
+export declare enum SignetEventName {
+    /** A client's cross-contract signature-request notification. */
+    SignBidirectionalEvent = "SignBidirectionalEvent",
+    /** The MPC's signature response to a request. */
+    SignatureRespondedEvent = "SignatureRespondedEvent",
+    /** The MPC's respond-bidirectional attestation of a foreign execution. */
+    RespondBidirectionalEvent = "RespondBidirectionalEvent"
+}
+/** Byte width of a signet event's name (Compact `pad(32, ...)`). */
+export declare const SIGNET_EVENT_NAME_LENGTH = 32;
+/** Byte width of every signet event's packed payload. */
+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.
+ */
+export interface SignetMiscEvent {
+    /** The event name, NUL padding stripped (compare to {@link SignetEventName}). */
+    name: string;
+    /** The packed payload, re-padded to {@link SIGNET_EVENT_PAYLOAD_LENGTH} bytes. */
+    payload: Uint8Array;
+}
+/**
+ * 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
+ * {@link signetEventSourceFromPublicDataProvider}.
+ */
+export interface SignetEventSource {
+    /**
+     * Fetch every signet event the contract has emitted so far, in emission
+     * order.
+     *
+     * @param contractAddress - The signet contract to read events of.
+     * @returns The decoded events, oldest first.
+     */
+    querySignetEvents(contractAddress: string): Promise<SignetMiscEvent[]>;
+}
+/**
+ * Strip the NUL padding off a fixed-width event name and decode it as ASCII:
+ * the inverse of the contract's `pad(32, "...")`.
+ *
+ * @param name - The padded name bytes.
+ * @returns The trimmed name string.
+ */
+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.
+ *
+ * @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
+ *   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.
+ */
+export interface SignetContractEventQuerySource {
+    /**
+     * Retrieve a contract's events; see
+     * `PublicDataProvider.queryContractEvents`.
+     *
+     * @param filter - The contract address and event-type narrowing.
+     * @returns The matching events, oldest first.
+     */
+    queryContractEvents(filter: {
+        contractAddress: string;
+        types?: "Misc"[];
+    }): Promise<{
+        eventType: string;
+        name?: string;
+        payload?: string;
+    }[]>;
+}
+/**
+ * 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
+ * {@link SIGNET_EVENT_PAYLOAD_LENGTH}.
+ *
+ * @param provider - The provider to query events through.
+ * @returns The adapted event source.
+ */
+export declare function signetEventSourceFromPublicDataProvider(provider: SignetContractEventQuerySource): SignetEventSource;
+/**
+ * A curve point in affine coordinates (Compact `AffinePoint`), SEC1
+ * big-endian, the same shape the sig-net EVM and Solana signer contracts
+ * expose.
+ */
+export interface AffinePoint {
+    /** The x coordinate, 32 big-endian bytes. */
+    x: Uint8Array;
+    /** The y coordinate, 32 big-endian bytes. */
+    y: Uint8Array;
+}
+/**
+ * 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`.
+ */
+export interface MpcSignature {
+    /** The signature's nonce point R. */
+    bigR: AffinePoint;
+    /** Signature scalar s, 32 big-endian bytes. */
+    s: Uint8Array;
+    /** Recovery id (parity of R.y): 0 or 1. */
+    recoveryId: bigint;
+}
+/**
+ * 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 SignetRespondPost});
+ * the id routes, and VERIFYING the signature against the transaction the
+ * request describes establishes authenticity (see
+ * {@link SignetRequestResponseReader.getVerifiedSignatureRespondedEvent}).
+ */
+export interface SignatureRespondedEvent {
+    /** The requested signature over the transaction the request describes. */
+    signature: MpcSignature;
+}
+/**
+ * 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 SignetRespondPost}), 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}.
+ */
+export interface RespondBidirectionalEvent {
+    /** ECDSA signature over the attestation digest. */
+    signature: MpcSignature;
+}
+/**
+ * A decoded respond-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. Verifying the
+ * record's signature against the request remains the authenticity check
+ * (see {@link SignetRequestResponseReader.getVerifiedSignatureRespondedEvent}
+ * and {@link SignetRequestResponseReader.getVerifiedRespondBidirectionalEvent}).
+ */
+export interface SignetRespondPost<TRecord> {
+    /** The request id the post declares it answers, 32 bytes. Routing data only. */
+    requestId: Uint8Array;
+    /** The posted record, verbatim. */
+    event: TRecord;
+}
+/**
+ * Decode a {@link SignetEventName.SignatureRespondedEvent} payload: the
+ * decode twin of the `respond` circuit's emit literal.
+ *
+ * @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.
+ */
+export declare function decodeSignatureRespondedEventPayload(payload: Uint8Array): SignetRespondPost<SignatureRespondedEvent>;
+/**
+ * Decode a {@link SignetEventName.RespondBidirectionalEvent} payload: the
+ * decode twin of the `respondBidirectional` circuit's emit literal.
+ *
+ * @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.
+ */
+export declare function decodeRespondBidirectionalEventPayload(payload: Uint8Array): SignetRespondPost<RespondBidirectionalEvent>;
+/**
+ * Raw twin of the Compact `SignBidirectionalEventNotification` struct as the
+ * `signBidirectional` circuit emits it: the version tag plus the still-packed
+ * 128-byte payload. Decode the payload with
+ * {@link decodeSignBidirectionalNotification}.
+ */
+export interface SignBidirectionalNotificationRecord {
+    /** Payload layout tag (Compact `Uint<8>`): 1 = the V1 layout. */
+    version: bigint;
+    /** The packed payload bytes, exactly as the registering circuit built them. */
+    payload: Uint8Array;
+}
+/**
+ * Decode a {@link SignetEventName.SignBidirectionalEvent} payload into the
+ * raw notification record: the decode twin of the `signBidirectional`
+ * circuit's emit literal (version (1) ++ notification payload (128)).
+ *
+ * @param payload - The event's payload.
+ * @returns The raw notification record.
+ * @throws Error when the payload is too short to hold the record.
+ */
+export declare function decodeSignBidirectionalEventNotificationPayload(payload: Uint8Array): 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
+ * event carries no request id: the MPC enumerates the request map the
+ * notification points at and reads every request from the named caller's own
+ * authenticated ledger (see signet-request-feed.ts). The fields themselves
+ * confer no authority.
+ */
+export interface SignBidirectionalNotification {
+    /** Payload layout tag: this decoder only produces version 1. */
+    version: number;
+    /**
+     * 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.
+     */
+    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.
+     */
+    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:
+ * 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.
+ *
+ * @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,
+ *   or its `requestsPathDepth` is zero or exceeds {@link MAX_LEDGER_PATH_DEPTH}.
+ */
+export declare function decodeSignBidirectionalNotification(record: SignBidirectionalNotificationRecord): SignBidirectionalNotification;
+//# sourceMappingURL=signet-contract-events.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,266 @@
+// MPC-/client-style decoders for the central SIGNET contract's emitted
+// events. Every signet contract circuit emits one `Misc` contract event
+// (MIP-0002 public log emission) whose 32-byte name tags the event kind and
+// whose 256-byte payload packs the record:
+//   SignBidirectionalEvent    - version (1) ++ notification payload (128) ++ zeros (127)
+//   SignatureRespondedEvent   - requestId (32) ++ bigR.x (32) ++ bigR.y (32) ++ s (32) ++ recoveryId (1) ++ zeros (127)
+//   RespondBidirectionalEvent - requestId (32) ++ bigR.x (32) ++ bigR.y (32) ++ s (32) ++ recoveryId (1) ++ zeros (127)
+// The decoders here are the byte-plumbing twins of the emit literals in
+// signet-contract.compact: field order and offsets must match byte-for-byte
+// (the signet-contract simulator tests pin the lockstep against real emits).
+// Every event is UNAUTHENTICATED: verification is the reader's job. The
+// request id in the two respond payloads 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";
+/**
+ * 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
+ * {@link SIGNET_EVENT_NAME_LENGTH} bytes, see {@link decodeSignetEventName}).
+ */
+export var SignetEventName;
+(function (SignetEventName) {
+    /** A client's cross-contract signature-request notification. */
+    SignetEventName["SignBidirectionalEvent"] = "SignBidirectionalEvent";
+    /** The MPC's signature response to a request. */
+    SignetEventName["SignatureRespondedEvent"] = "SignatureRespondedEvent";
+    /** The MPC's respond-bidirectional attestation of a foreign execution. */
+    SignetEventName["RespondBidirectionalEvent"] = "RespondBidirectionalEvent";
+})(SignetEventName || (SignetEventName = {}));
+/** Byte width of a signet event's name (Compact `pad(32, ...)`). */
+export const SIGNET_EVENT_NAME_LENGTH = 32;
+/** Byte width of every signet event's packed payload. */
+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);
+/**
+ * Strip the NUL padding off a fixed-width event name and decode it as ASCII:
+ * the inverse of the contract's `pad(32, "...")`.
+ *
+ * @param name - The padded name bytes.
+ * @returns The trimmed name string.
+ */
+export function decodeSignetEventName(name) {
+    let end = name.length;
+    while (end > 0 && name[end - 1] === 0) {
+        end -= 1;
+    }
+    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.
+ *
+ * @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
+ *   name ++ payload width.
+ */
+export function decodeSignetLogEvents(events, contractAddress) {
+    const out = [];
+    for (const event of events) {
+        if (event.eventType !== "misc")
+            continue;
+        if (contractAddress !== undefined && event.address !== contractAddress) {
+            continue;
+        }
+        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]);
+        out.push({
+            name: decodeSignetEventName(bytes.slice(0, SIGNET_EVENT_NAME_LENGTH)),
+            payload: bytes.slice(SIGNET_EVENT_NAME_LENGTH),
+        });
+    }
+    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
+ * {@link SIGNET_EVENT_PAYLOAD_LENGTH}.
+ *
+ * @param provider - The provider to query events through.
+ * @returns The adapted event source.
+ */
+export function signetEventSourceFromPublicDataProvider(provider) {
+    return {
+        async querySignetEvents(contractAddress) {
+            const events = await provider.queryContractEvents({
+                contractAddress,
+                types: ["Misc"],
+            });
+            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 padded = new Uint8Array(SIGNET_EVENT_PAYLOAD_LENGTH);
+                padded.set(payload.slice(0, SIGNET_EVENT_PAYLOAD_LENGTH), 0);
+                out.push({
+                    name: decodeSignetEventName(eventFieldBytes(event.name)),
+                    payload: padded,
+                });
+            }
+            return out;
+        },
+    };
+}
+/** Offsets of the leaves both respond payloads pack, in emit order. */
+const RESPOND_REQUEST_ID_OFFSET = 0;
+const SIGNATURE_BIG_R_X_OFFSET = 32;
+const SIGNATURE_BIG_R_Y_OFFSET = 64;
+const SIGNATURE_S_OFFSET = 96;
+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.
+ *
+ * @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.
+ */
+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`);
+    }
+    return {
+        requestId: payload.slice(RESPOND_REQUEST_ID_OFFSET, SIGNATURE_BIG_R_X_OFFSET),
+        signature: {
+            bigR: {
+                x: payload.slice(SIGNATURE_BIG_R_X_OFFSET, SIGNATURE_BIG_R_Y_OFFSET),
+                y: payload.slice(SIGNATURE_BIG_R_Y_OFFSET, SIGNATURE_S_OFFSET),
+            },
+            s: payload.slice(SIGNATURE_S_OFFSET, SIGNATURE_RECOVERY_ID_OFFSET),
+            recoveryId: BigInt(recoveryId),
+        },
+    };
+}
+/**
+ * Decode a {@link SignetEventName.SignatureRespondedEvent} payload: the
+ * decode twin of the `respond` circuit's emit literal.
+ *
+ * @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.
+ */
+export function decodeSignatureRespondedEventPayload(payload) {
+    const { requestId, signature } = decodeRespondPayload(payload);
+    return { requestId, event: { signature } };
+}
+/**
+ * Decode a {@link SignetEventName.RespondBidirectionalEvent} payload: the
+ * decode twin of the `respondBidirectional` circuit's emit literal.
+ *
+ * @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.
+ */
+export function decodeRespondBidirectionalEventPayload(payload) {
+    const { requestId, signature } = decodeRespondPayload(payload);
+    return { requestId, event: { signature } };
+}
+/** Offset of the notification's version tag in the event payload. */
+const NOTIFICATION_EVENT_VERSION_OFFSET = 0;
+/** Offset of the packed notification payload in the event payload. */
+const NOTIFICATION_EVENT_PAYLOAD_OFFSET = 1;
+/** Byte width of the packed notification payload (Compact `Bytes<128>`). */
+const NOTIFICATION_PAYLOAD_LENGTH = 128;
+/**
+ * Decode a {@link SignetEventName.SignBidirectionalEvent} payload into the
+ * raw notification record: the decode twin of the `signBidirectional`
+ * circuit's emit literal (version (1) ++ notification payload (128)).
+ *
+ * @param payload - The event's payload.
+ * @returns The raw notification 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`);
+    }
+    return {
+        version: BigInt(version),
+        payload: payload.slice(NOTIFICATION_EVENT_PAYLOAD_OFFSET, end),
+    };
+}
+/** Offset of the V1 `callerAddress` in the packed payload (`Bytes<32>` at the front). */
+const NOTIFICATION_CALLER_ADDRESS_OFFSET = 0;
+/** Offset of the V1 `requestsPathDepth` (after the 32 callerAddress bytes). */
+const NOTIFICATION_PATH_DEPTH_OFFSET = 32;
+/** Offset of the V1 `requestsPath` bytes (after the 1-byte depth). */
+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.
+ */
+const MAX_LEDGER_PATH_DEPTH = 4;
+/** The only payload interpretation {@link decodeSignBidirectionalNotification} understands today. */
+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:
+ * 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.
+ *
+ * @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,
+ *   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})`);
+    }
+    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})`);
+    }
+    // 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.
+    const requestsPath = Array.from(record.payload.slice(NOTIFICATION_PATH_OFFSET, NOTIFICATION_PATH_OFFSET + depth));
+    return {
+        version: Number(record.version),
+        callerAddress,
+        requestsPath,
+    };
+}
+//# sourceMappingURL=signet-contract-events.js.map

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

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

package/dist/signet-evtype2tx-requests.d.ts

@@ -1,6 +1,6 @@
 import { type CompactType } from "@midnight-ntwrk/compact-runtime";
 import { Signature, Transaction } from "ethers";
-import type { SignatureRespondedEvent } from "./signet-contract-state-reader.ts";
+import type { SignatureRespondedEvent } from "./signet-contract-events.ts";
 import { type Maybe, type RequestId, type SignBidirectionalEvent } from "./signet-requests.ts";
 /**
  * ABI calldata as a 4-byte selector + 32-byte word slots (Compact:
@@ -199,8 +199,8 @@ export declare function assembleCalldata(calldata: Maybe<EvmCalldata>): string;
  */
 export declare function signBidirectionalEventToUnsignedEvmTransaction(request: SignBidirectionalEvent): Transaction;
 /**
- * Decode a response signature record (as posted to the signet contract's
- * signature response log) into an ethers {@link Signature}. Goes through
+ * Decode a response signature record (as the signet contract emits it in a
+ * signature response event) into an ethers {@link Signature}. Goes through
  * {@link mpcSignatureToEcdsaSignature}, so this and in-circuit claims decode
  * a post identically:
  * ethers' `r` is the ECDSA scalar (`bigR.x` reduced mod the curve order),
@@ -234,7 +234,7 @@ export declare function signatureToSignatureRespondedEvent(signature: Pick<Signa
  * its MPC signature response: rebuild the exact unsigned transaction the MPC
  * signed (see {@link signBidirectionalEventToUnsignedEvmTransaction}) and
  * attach the signature. Does NOT check that the signature recovers to the
- * requester's derived address: the response log is unauthenticated, so
+ * requester's derived address: the response events are unauthenticated, so
  * verify first with `verifySignatureRespondedEvent`.
  *
  * @param request - The on-ledger request record.

package/dist/signet-evtype2tx-requests.d.ts.map

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

package/dist/signet-evtype2tx-requests.js

@@ -269,8 +269,8 @@ export function signBidirectionalEventToUnsignedEvmTransaction(request) {
     });
 }
 /**
- * Decode a response signature record (as posted to the signet contract's
- * signature response log) into an ethers {@link Signature}. Goes through
+ * Decode a response signature record (as the signet contract emits it in a
+ * signature response event) into an ethers {@link Signature}. Goes through
  * {@link mpcSignatureToEcdsaSignature}, so this and in-circuit claims decode
  * a post identically:
  * ethers' `r` is the ECDSA scalar (`bigR.x` reduced mod the curve order),
@@ -319,7 +319,7 @@ export function signatureToSignatureRespondedEvent(signature) {
  * its MPC signature response: rebuild the exact unsigned transaction the MPC
  * signed (see {@link signBidirectionalEventToUnsignedEvmTransaction}) and
  * attach the signature. Does NOT check that the signature recovers to the
- * requester's derived address: the response log is unauthenticated, so
+ * requester's derived address: the response events are unauthenticated, so
  * verify first with `verifySignatureRespondedEvent`.
  *
  * @param request - The on-ledger request record.