@sig-net/midnight 0.14.0 → 0.16.0

package/dist/signet-request-response-reader.d.ts

@@ -1,6 +1,6 @@
 import type { PublicDataProvider } from "@midnight-ntwrk/midnight-js-types";
 import type { Transaction } from "ethers";
-import { type SignatureRespondedEvent, type RespondBidirectionalEvent } from "./signet-contract-state-reader.ts";
+import { type SignetEventSource, type SignatureRespondedEvent, type RespondBidirectionalEvent } from "./signet-contract-events.ts";
 import { type Secp256k1Point } from "./ecdsa-attestation.ts";
 import type { RawContractState } from "./signature-state-reading.ts";
 import { type SignBidirectionalEvent, type RequestIdHex } from "./signet-requests.ts";
@@ -27,21 +27,27 @@ export interface SignetRequestResponseReaderConfig {
     /** Address of the signet-compliant requester contract (e.g. the vault). */
     readonly requesterContractAddress: string;
     /**
-     * Ledger field position of the requester contract's request index: the
-     * same position the contract passes as `requestsIndexField` in its
-     * notifications. A contract is free to declare the index at any field, so
-     * the reader cannot assume one.
+     * Resolved ledger-tree path of the requester contract's request index: the
+     * same path the contract packs as `requestsPath` in its notifications
+     * (`[4]` for a flat contract's field 4, longer once chunking applies). A
+     * contract is free to declare the index at any field, so the reader cannot
+     * assume one.
      */
-    readonly requesterRequestsIndexField: number;
+    readonly requesterRequestsPath: readonly number[];
     /** Address of the central signet contract. */
     readonly signetContractAddress: string;
     /** Source of raw contract state, e.g. midnight-js's `indexerPublicDataProvider`. */
     readonly publicDataProvider: SignetPublicStateSource;
+    /**
+     * Source of the signet contract's emitted events. Adapt a full provider
+     * with `signetEventSourceFromPublicDataProvider`.
+     */
+    readonly eventSource: SignetEventSource;
 }
-/** The verdict on one posted response, in `count` order. */
+/** The verdict on one emitted response, in emission order. */
 export interface SignatureResponseVerdict {
-    /** 0-based position of the post in the request's response log. */
-    count: bigint;
+    /** 0-based position of the post among the request's signature-response events. */
+    index: bigint;
     /** The posted signature record, verbatim. */
     response: SignatureRespondedEvent;
     /** Recovered signer address, absent when the signature did not decode. */
@@ -52,13 +58,13 @@ export interface SignatureResponseVerdict {
 /** Result of {@link SignetRequestResponseReader['getVerifiedSignatureRespondedEvent']}. */
 export interface VerifiedSignatureResponseResult {
     /**
-     * The first valid response (lowest count), or `undefined` when no valid
+     * The first valid response (lowest index), or `undefined` when no valid
      * response has been posted yet: poll again.
      */
     verified?: SignatureRespondedEvent;
     /**
-     * One verdict per post, count order. Pure data: the reader never logs, so
-     * callers decide how to surface rejected posts.
+     * One verdict per post, emission order. Pure data: the reader never logs,
+     * so callers decide how to surface rejected posts.
      */
     verdicts: SignatureResponseVerdict[];
 }
@@ -66,65 +72,71 @@ export interface VerifiedSignatureResponseResult {
  * Reader over one requester contract / signet contract pair.
  * Construct once per pair and reuse: fetched request records are cached (they
  * are immutable, the ledger key is their hash), so repeated verification
- * calls cost one responses-contract query each.
+ * calls cost one event query each.
  */
 export declare class SignetRequestResponseReader {
     private readonly config;
     private readonly requestCache;
     /**
-     * @param config - The contract pair and state source to read through.
+     * @param config - The contract pair, state source and event source to read
+     *   through.
      */
     constructor(config: SignetRequestResponseReaderConfig);
-    /**
-     * Query one contract's raw state, throwing a uniform error when absent.
-     *
-     * @param contractAddress - The contract to query.
-     * @param role - Human name of the contract for the error message.
-     * @returns The raw ledger state tree.
-     * @throws Error when the address holds no contract state.
-     */
-    private queryRawState;
     /**
      * Fetch the request record for `requestId` from the requester contract's
-     * request index (at the configured `requesterRequestsIndexField`). Cached
+     * request index (at the configured `requesterRequestsPath`). Cached
      * after the first fetch.
      *
      * @param requestId - The request id to look up.
      * @returns The stored request record.
      * @throws Error when the requester contract has no state or holds no
-     *   request under `requestId` at the configured index field.
+     *   request under `requestId` at the configured index path.
      */
     getSignatureRequest(requestId: RequestIdHex): Promise<SignBidirectionalEvent>;
     /**
-     * Fetch every response posted for `requestId`, in post (count) order.
-     * UNVERIFIED: any of them may be garbage (see
-     * {@link getVerifiedSignatureRespondedEvent}).
+     * Fetch every event of `name` the signet contract has emitted, decode each
+     * with `decode`, and keep the posts whose declared request id is
+     * `requestId`, in emission order. The declared id is routing data only:
+     * the verified getters run the actual authenticity checks.
+     *
+     * @param name - The signet event name to keep.
+     * @param decode - The payload decoder for that event kind.
+     * @param requestId - The request id the kept posts must declare.
+     * @returns The kept posts' records, oldest first.
+     */
+    private getRespondPostsNamed;
+    /**
+     * Fetch every signature response posted under `requestId`, in emission
+     * order. UNVERIFIED: the declared id is routing data on an unauthenticated
+     * event log, so any post may still be garbage (see
+     * {@link getVerifiedSignatureRespondedEvent}, where verification
+     * establishes authenticity).
      *
-     * @param requestId - The request id whose posts to enumerate.
-     * @returns The posted payloads, index = count, empty when none yet.
-     * @throws Error when the responses contract has no state, or its counter
-     *   disagrees with the log (inconsistent ledger).
+     * @param requestId - The request id the posts must declare.
+     * @returns The request's posted records, oldest first, empty when none yet.
      */
-    getSignatureResponses(requestId: RequestIdHex): Promise<SignatureRespondedEvent[]>;
+    getSignatureRespondedEvents(requestId: RequestIdHex): Promise<SignatureRespondedEvent[]>;
     /**
-     * Fetch and verify the responses posted for `requestId`: each post's
-     * signature must recover to `expectedSigner`
-     * (compared case-insensitively) over the signing hash of the transaction
-     * the request record describes. The first valid post wins, and every post
-     * gets a verdict so callers can report the noise.
+     * Fetch the signature responses posted under `requestId` and verify each
+     * against the request: a post's signature must recover to
+     * `expectedSigner` (compared case-insensitively) over the signing hash of
+     * the transaction the request record describes. The first valid post wins,
+     * and every candidate gets a verdict so callers can report the noise. The
+     * declared id only routes: this verification is what separates the genuine
+     * response from garbage posted under the same id.
      *
      * @param requestId - The request id to fetch a verified response for.
      * @param expectedSigner - The EVM address (0x hex, any case) the genuine
      *   response must be signed by: the requester's MPC-derived address.
      * @returns The first valid response (if any) plus per-post verdicts.
-     * @throws Error when either contract has no state, the request is not on
-     *   the requester's ledger, or the responses ledger is inconsistent.
+     * @throws Error when the requester contract has no state or the request is
+     *   not on its ledger.
      */
     getVerifiedSignatureRespondedEvent(requestId: RequestIdHex, expectedSigner: string): Promise<VerifiedSignatureResponseResult>;
     /**
      * Rebuild the unsigned EIP-1559 transaction for `requestId`: the exact
      * transaction the MPC signs, assembled from the request record's decomposed
-     * fields. No responses-contract query: this needs only the request record
+     * fields. No event query: this needs only the request record
      * (fetched via {@link getSignatureRequest}, cached).
      *
      * @param requestId - The request id whose transaction to rebuild.
@@ -138,7 +150,7 @@ export declare class SignetRequestResponseReader {
      * Assemble the broadcast-ready signed EIP-1559 transaction for `requestId`:
      * rebuild the request's transaction and attach the first VERIFIED response
      * signed by `expectedSigner` (see {@link getVerifiedSignatureRespondedEvent}:
-     * the response log is unauthenticated, so an `expectedSigner` is required
+     * the event log is unauthenticated, so an `expectedSigner` is required
      * and unverified posts are never attached).
      *
      * @param requestId - The request id to produce a signed transaction for.
@@ -147,47 +159,43 @@ export declare class SignetRequestResponseReader {
      * @returns The signed ethers transaction (`serialized` is the payload for
      *   `eth_sendRawTransaction`), or `undefined` when no valid response has
      *   been posted yet: poll again.
-     * @throws Error when either contract has no state, the request is not on the
-     *   requester's ledger, or the responses ledger is inconsistent.
+     * @throws Error when the requester contract has no state or the request is
+     *   not on its ledger.
      */
     getSignedEvmTransaction(requestId: RequestIdHex, expectedSigner: string): Promise<Transaction | undefined>;
     /**
-     * Fetch every respond-bidirectional response posted for `requestId`, in
-     * post (count) order. UNVERIFIED: the signet contract stores posts without
-     * checking them, so any entry may be garbage. Each post carries a signature
-     * and nothing else, so verifying it against the MPC response key you expect
-     * is the only way to pick the genuine one: in-circuit at claim time, or off
-     * chain with {@link verifyRespondBidirectionalSignature} over the output you
-     * fetched. An empty array simply means none posted yet: poll again.
+     * Fetch every respond-bidirectional response posted under `requestId`, in
+     * emission order. UNVERIFIED: the declared id is routing data on an
+     * unauthenticated event log, so verifying a post against the MPC response
+     * key you expect is still the only way to pick the genuine one: in-circuit
+     * at claim time, or off chain with
+     * {@link verifyRespondBidirectionalSignature} over the output you fetched.
+     * An empty array simply means none posted yet: poll again.
      *
-     * @param requestId - The request id whose responses to enumerate.
-     * @returns The posted records, index = count, empty when none yet.
-     * @throws Error when the signet contract has no state, or its counter
-     *   disagrees with the log (inconsistent ledger).
+     * @param requestId - The request id the posts must declare.
+     * @returns The request's posted records, oldest first, empty when none yet.
      */
     getRespondBidirectionalEvents(requestId: RequestIdHex): Promise<RespondBidirectionalEvent[]>;
     /**
-     * Fetch the respond-bidirectional posts for `requestId` and return the
-     * first (lowest count) one whose signature verifies over
+     * Fetch the respond-bidirectional posts declared under `requestId` and
+     * return the first (oldest) one whose signature verifies over
      * `serializedOutput` against `mpcResponseKey`: the off-chain twin of the
      * check the client contract runs in-circuit, and the only way to pick a
-     * genuine post out of an unauthenticated log now that posts carry nothing
-     * but a signature.
+     * genuine post out of an unauthenticated event log.
      *
      * The output must be the exact unpadded bytes the attestation commits to
      * (the packed respond payload, recomputed from the execution output the
      * client fetched), so a post that verifies here is the post that proves at
      * claim time.
      *
-     * @param requestId - The request id to fetch a verified attestation for.
+     * @param requestId - The request id the posts must declare and the
+     *   attestation must commit to.
      * @param serializedOutput - The serialised execution output the attestation
      *   must commit to, exact unpadded bytes.
      * @param mpcResponseKey - The MPC response key the requesting contract
      *   pinned at deploy (see `deriveMidnightResponseKey`).
      * @returns The first verifying post, or `undefined` when none has been
      *   posted yet (poll again) or none attests this output.
-     * @throws Error when the signet contract has no state, or its counter
-     *   disagrees with the log (inconsistent ledger).
      */
     getVerifiedRespondBidirectionalEvent(requestId: RequestIdHex, serializedOutput: Uint8Array, mpcResponseKey: Secp256k1Point): Promise<RespondBidirectionalEvent | undefined>;
 }

package/dist/signet-request-response-reader.d.ts.map

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

package/dist/signet-request-response-reader.js

@@ -1,138 +1,140 @@
 // One-stop client-side reader for the signet request/response flow: fetch a
-// request record from the requester contract's ledger, enumerate the posts in
-// the signet contract's signature response log, and verify each candidate
-// against the request.
-// This is the helper the Signet.compact "Response Ledger Layout" comment
-// promises: the log is UNAUTHENTICATED, so a client must verify every post
-// and take the first valid one. This class packages that flow so every
-// consumer (CLI poller, integration tests, a future UI) shares one
-// implementation. Single-shot by design: each call queries state once, and
-// the caller owns any poll loop.
+// request record from the requester contract's ledger, read the request's
+// responses out of the contract events the signet contract emits, and verify
+// each candidate against the request.
+// A response is a Misc contract event that carries the request id it answers
+// beside a signature. The id is UNAUTHENTICATED routing data: it scopes a
+// read to one request's posts, and VERIFICATION establishes authenticity. A
+// signature response answers a request exactly when it recovers to that
+// request's derived signer over the request's transaction, and a
+// respond-bidirectional post answers exactly when it verifies over
+// (requestId, output) against the request's MPC response key. This class
+// packages that flow so every consumer (CLI poller, integration tests, a
+// future UI) shares one implementation. Single-shot by design: each call
+// queries once, and the caller owns any poll loop.
 import { lookupSignetRequestAt } from "./signature-requests-state-reader.js";
-import { readSignetContractLedgerFromState, signetMapEntryKey, } from "./signet-contract-state-reader.js";
+import { decodeRespondBidirectionalEventPayload, decodeSignatureRespondedEventPayload, SignetEventName, } from "./signet-contract-events.js";
 import { recoverSignatureResponseSigner } from "./signature-response-verification.js";
 import { verifyRespondBidirectionalSignature, } from "./ecdsa-attestation.js";
 import { signBidirectionalEventToSignedEvmTransaction, signBidirectionalEventToUnsignedEvmTransaction, } from "./signet-evtype2tx-requests.js";
-import { requestIdBytes, } from "./signet-requests.js";
+import { requestIdBytes, requestIdHex, } from "./signet-requests.js";
 /**
  * Reader over one requester contract / signet contract pair.
  * Construct once per pair and reuse: fetched request records are cached (they
  * are immutable, the ledger key is their hash), so repeated verification
- * calls cost one responses-contract query each.
+ * calls cost one event query each.
  */
 export class SignetRequestResponseReader {
     config;
     // Request records never change once stored, so cache them across calls.
     requestCache = new Map();
     /**
-     * @param config - The contract pair and state source to read through.
+     * @param config - The contract pair, state source and event source to read
+     *   through.
      */
     constructor(config) {
         this.config = config;
     }
-    /**
-     * Query one contract's raw state, throwing a uniform error when absent.
-     *
-     * @param contractAddress - The contract to query.
-     * @param role - Human name of the contract for the error message.
-     * @returns The raw ledger state tree.
-     * @throws Error when the address holds no contract state.
-     */
-    async queryRawState(contractAddress, role) {
-        const state = await this.config.publicDataProvider.queryContractState(contractAddress);
-        if (!state?.data) {
-            throw new Error(`no state data found for ${role} contract '${contractAddress}' (is it deployed?)`);
-        }
-        return state.data;
-    }
     /**
      * Fetch the request record for `requestId` from the requester contract's
-     * request index (at the configured `requesterRequestsIndexField`). Cached
+     * request index (at the configured `requesterRequestsPath`). Cached
      * after the first fetch.
      *
      * @param requestId - The request id to look up.
      * @returns The stored request record.
      * @throws Error when the requester contract has no state or holds no
-     *   request under `requestId` at the configured index field.
+     *   request under `requestId` at the configured index path.
      */
     async getSignatureRequest(requestId) {
         const cached = this.requestCache.get(requestId);
         if (cached !== undefined) {
             return cached;
         }
-        const raw = await this.queryRawState(this.config.requesterContractAddress, "requester");
-        const request = lookupSignetRequestAt(raw, this.config.requesterRequestsIndexField, requestId);
+        const state = await this.config.publicDataProvider.queryContractState(this.config.requesterContractAddress);
+        if (!state?.data) {
+            throw new Error(`no state data found for requester contract '${this.config.requesterContractAddress}' (is it deployed?)`);
+        }
+        const request = lookupSignetRequestAt(state.data, this.config.requesterRequestsPath, requestId);
         if (request === undefined) {
             throw new Error(`request ${requestId} is not on the requester contract's ledger ` +
-                `(request index at field ${this.config.requesterRequestsIndexField}): was it submitted?`);
+                `(request index at path ${JSON.stringify(this.config.requesterRequestsPath)}): was it submitted?`);
         }
         this.requestCache.set(requestId, request);
         return request;
     }
     /**
-     * Fetch every response posted for `requestId`, in post (count) order.
-     * UNVERIFIED: any of them may be garbage (see
-     * {@link getVerifiedSignatureRespondedEvent}).
+     * Fetch every event of `name` the signet contract has emitted, decode each
+     * with `decode`, and keep the posts whose declared request id is
+     * `requestId`, in emission order. The declared id is routing data only:
+     * the verified getters run the actual authenticity checks.
      *
-     * @param requestId - The request id whose posts to enumerate.
-     * @returns The posted payloads, index = count, empty when none yet.
-     * @throws Error when the responses contract has no state, or its counter
-     *   disagrees with the log (inconsistent ledger).
+     * @param name - The signet event name to keep.
+     * @param decode - The payload decoder for that event kind.
+     * @param requestId - The request id the kept posts must declare.
+     * @returns The kept posts' records, oldest first.
      */
-    async getSignatureResponses(requestId) {
-        const raw = await this.queryRawState(this.config.signetContractAddress, "signet contract");
-        const { respondCounterMap, respondMap } = readSignetContractLedgerFromState(raw);
-        const totalPosts = respondCounterMap.get(requestId) ?? 0n;
-        const responses = [];
-        for (let count = 0n; count < totalPosts; count++) {
-            const response = respondMap.get(signetMapEntryKey(requestId, count));
-            if (response === undefined) {
-                throw new Error(`response log has no entry ${count} for request ${requestId} ` +
-                    `despite its counter reading ${totalPosts}: ledger state is inconsistent`);
-            }
-            responses.push(response);
-        }
-        return responses;
+    async getRespondPostsNamed(name, decode, requestId) {
+        const events = await this.config.eventSource.querySignetEvents(this.config.signetContractAddress);
+        return events
+            .filter((event) => event.name === name)
+            .map((event) => decode(event.payload))
+            .filter((post) => requestIdHex(post.requestId) === requestId)
+            .map((post) => post.event);
+    }
+    /**
+     * Fetch every signature response posted under `requestId`, in emission
+     * order. UNVERIFIED: the declared id is routing data on an unauthenticated
+     * event log, so any post may still be garbage (see
+     * {@link getVerifiedSignatureRespondedEvent}, where verification
+     * establishes authenticity).
+     *
+     * @param requestId - The request id the posts must declare.
+     * @returns The request's posted records, oldest first, empty when none yet.
+     */
+    async getSignatureRespondedEvents(requestId) {
+        return this.getRespondPostsNamed(SignetEventName.SignatureRespondedEvent, decodeSignatureRespondedEventPayload, requestId);
     }
     /**
-     * Fetch and verify the responses posted for `requestId`: each post's
-     * signature must recover to `expectedSigner`
-     * (compared case-insensitively) over the signing hash of the transaction
-     * the request record describes. The first valid post wins, and every post
-     * gets a verdict so callers can report the noise.
+     * Fetch the signature responses posted under `requestId` and verify each
+     * against the request: a post's signature must recover to
+     * `expectedSigner` (compared case-insensitively) over the signing hash of
+     * the transaction the request record describes. The first valid post wins,
+     * and every candidate gets a verdict so callers can report the noise. The
+     * declared id only routes: this verification is what separates the genuine
+     * response from garbage posted under the same id.
      *
      * @param requestId - The request id to fetch a verified response for.
      * @param expectedSigner - The EVM address (0x hex, any case) the genuine
      *   response must be signed by: the requester's MPC-derived address.
      * @returns The first valid response (if any) plus per-post verdicts.
-     * @throws Error when either contract has no state, the request is not on
-     *   the requester's ledger, or the responses ledger is inconsistent.
+     * @throws Error when the requester contract has no state or the request is
+     *   not on its ledger.
      */
     async getVerifiedSignatureRespondedEvent(requestId, expectedSigner) {
         const request = await this.getSignatureRequest(requestId);
-        const responses = await this.getSignatureResponses(requestId);
-        const verdicts = responses.map((response, index) => {
-            const count = BigInt(index);
+        const responses = await this.getSignatureRespondedEvents(requestId);
+        const verdicts = responses.map((response, position) => {
+            const index = BigInt(position);
             let signer;
             try {
                 signer = recoverSignatureResponseSigner(request, response);
             }
             catch (error) {
                 return {
-                    count,
+                    index,
                     response,
                     rejectedReason: `not a decodable signature (${String(error)})`,
                 };
             }
             if (signer.toLowerCase() !== expectedSigner.toLowerCase()) {
                 return {
-                    count,
+                    index,
                     response,
                     signer,
                     rejectedReason: `signed by ${signer}, expected ${expectedSigner}`,
                 };
             }
-            return { count, response, signer };
+            return { index, response, signer };
         });
         return {
             verified: verdicts.find((v) => v.rejectedReason === undefined)?.response,
@@ -142,7 +144,7 @@ export class SignetRequestResponseReader {
     /**
      * Rebuild the unsigned EIP-1559 transaction for `requestId`: the exact
      * transaction the MPC signs, assembled from the request record's decomposed
-     * fields. No responses-contract query: this needs only the request record
+     * fields. No event query: this needs only the request record
      * (fetched via {@link getSignatureRequest}, cached).
      *
      * @param requestId - The request id whose transaction to rebuild.
@@ -158,7 +160,7 @@ export class SignetRequestResponseReader {
      * Assemble the broadcast-ready signed EIP-1559 transaction for `requestId`:
      * rebuild the request's transaction and attach the first VERIFIED response
      * signed by `expectedSigner` (see {@link getVerifiedSignatureRespondedEvent}:
-     * the response log is unauthenticated, so an `expectedSigner` is required
+     * the event log is unauthenticated, so an `expectedSigner` is required
      * and unverified posts are never attached).
      *
      * @param requestId - The request id to produce a signed transaction for.
@@ -167,8 +169,8 @@ export class SignetRequestResponseReader {
      * @returns The signed ethers transaction (`serialized` is the payload for
      *   `eth_sendRawTransaction`), or `undefined` when no valid response has
      *   been posted yet: poll again.
-     * @throws Error when either contract has no state, the request is not on the
-     *   requester's ledger, or the responses ledger is inconsistent.
+     * @throws Error when the requester contract has no state or the request is
+     *   not on its ledger.
      */
     async getSignedEvmTransaction(requestId, expectedSigner) {
         const { verified } = await this.getVerifiedSignatureRespondedEvent(requestId, expectedSigner);
@@ -181,56 +183,40 @@ export class SignetRequestResponseReader {
         return signBidirectionalEventToSignedEvmTransaction(request, verified);
     }
     /**
-     * Fetch every respond-bidirectional response posted for `requestId`, in
-     * post (count) order. UNVERIFIED: the signet contract stores posts without
-     * checking them, so any entry may be garbage. Each post carries a signature
-     * and nothing else, so verifying it against the MPC response key you expect
-     * is the only way to pick the genuine one: in-circuit at claim time, or off
-     * chain with {@link verifyRespondBidirectionalSignature} over the output you
-     * fetched. An empty array simply means none posted yet: poll again.
+     * Fetch every respond-bidirectional response posted under `requestId`, in
+     * emission order. UNVERIFIED: the declared id is routing data on an
+     * unauthenticated event log, so verifying a post against the MPC response
+     * key you expect is still the only way to pick the genuine one: in-circuit
+     * at claim time, or off chain with
+     * {@link verifyRespondBidirectionalSignature} over the output you fetched.
+     * An empty array simply means none posted yet: poll again.
      *
-     * @param requestId - The request id whose responses to enumerate.
-     * @returns The posted records, index = count, empty when none yet.
-     * @throws Error when the signet contract has no state, or its counter
-     *   disagrees with the log (inconsistent ledger).
+     * @param requestId - The request id the posts must declare.
+     * @returns The request's posted records, oldest first, empty when none yet.
      */
     async getRespondBidirectionalEvents(requestId) {
-        const raw = await this.queryRawState(this.config.signetContractAddress, "signet contract");
-        const { respondBidirectionalCounterMap, respondBidirectionalMap } = readSignetContractLedgerFromState(raw);
-        const totalPosts = respondBidirectionalCounterMap.get(requestId) ?? 0n;
-        const responses = [];
-        for (let count = 0n; count < totalPosts; count++) {
-            const response = respondBidirectionalMap.get(signetMapEntryKey(requestId, count));
-            if (response === undefined) {
-                throw new Error(`respond-bidirectional log has no entry ${count} for request ${requestId} ` +
-                    `despite its counter reading ${totalPosts}: ledger state is inconsistent`);
-            }
-            responses.push(response);
-        }
-        return responses;
+        return this.getRespondPostsNamed(SignetEventName.RespondBidirectionalEvent, decodeRespondBidirectionalEventPayload, requestId);
     }
     /**
-     * Fetch the respond-bidirectional posts for `requestId` and return the
-     * first (lowest count) one whose signature verifies over
+     * Fetch the respond-bidirectional posts declared under `requestId` and
+     * return the first (oldest) one whose signature verifies over
      * `serializedOutput` against `mpcResponseKey`: the off-chain twin of the
      * check the client contract runs in-circuit, and the only way to pick a
-     * genuine post out of an unauthenticated log now that posts carry nothing
-     * but a signature.
+     * genuine post out of an unauthenticated event log.
      *
      * The output must be the exact unpadded bytes the attestation commits to
      * (the packed respond payload, recomputed from the execution output the
      * client fetched), so a post that verifies here is the post that proves at
      * claim time.
      *
-     * @param requestId - The request id to fetch a verified attestation for.
+     * @param requestId - The request id the posts must declare and the
+     *   attestation must commit to.
      * @param serializedOutput - The serialised execution output the attestation
      *   must commit to, exact unpadded bytes.
      * @param mpcResponseKey - The MPC response key the requesting contract
      *   pinned at deploy (see `deriveMidnightResponseKey`).
      * @returns The first verifying post, or `undefined` when none has been
      *   posted yet (poll again) or none attests this output.
-     * @throws Error when the signet contract has no state, or its counter
-     *   disagrees with the log (inconsistent ledger).
      */
     async getVerifiedRespondBidirectionalEvent(requestId, serializedOutput, mpcResponseKey) {
         const events = await this.getRespondBidirectionalEvents(requestId);

package/dist/signet-request-response-reader.js.map

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

package/dist/signet-requests.js

@@ -16,8 +16,8 @@
 // the assertion, so any structural drift between the generated managed types
 // and these twins fails that package's `yarn build` / `yarn test`.
 //
-// Read more: https://docs.sig.network/ (signet protocol) and the module
-// header in Signet.compact (key derivation, event flow).
+// Read more: the module header in Signet.compact (key derivation, event
+// flow) and this package's README ("Sign bidirectional flow").
 import { CompactTypeBoolean, CompactTypeBytes, CompactTypeEnum, CompactTypeUnsignedInteger, } from "@midnight-ntwrk/compact-runtime";
 /**
  * Which transaction-param decomposition a request carries (Compact: