@layerzerolabs/common-canton 0.2.105 → 0.2.107

package/dist/{MDLCDBAQ.js → HNZRSDTR.js}

@@ -17,6 +17,12 @@ function parseCantonUri(uri) {
   if (!walletUrl) {
     throw new Error('Canton provider URI missing required "wallet-url" query parameter');
   }
+  const sequencerUrl = url.searchParams.get("sequencer-url");
+  if (!sequencerUrl) {
+    throw new Error('Canton provider URI missing required "sequencer-url" query parameter');
+  }
+  const sequencerValidatorsParam = url.searchParams.get("sequencer-validators");
+  const sequencerQuorumParam = url.searchParams.get("sequencer-quorum");
   const tokenUrl = url.searchParams.get("token-url") ?? void 0;
   const clientId = url.searchParams.get("client-id") ?? void 0;
   const clientSecret = url.searchParams.get("client-secret") ?? void 0;
@@ -26,6 +32,9 @@ function parseCantonUri(uri) {
     "admin-api",
     "user-id",
     "wallet-url",
+    "sequencer-url",
+    "sequencer-validators",
+    "sequencer-quorum",
     "token-url",
     "client-id",
     "client-secret",
@@ -34,6 +43,31 @@ function parseCantonUri(uri) {
   ]) {
     url.searchParams.delete(key);
   }
+  let sequencerCommittee;
+  if (sequencerValidatorsParam !== null && sequencerQuorumParam !== null) {
+    const publicKeys = sequencerValidatorsParam.split(",").map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
+    if (publicKeys.length === 0) {
+      throw new Error("Canton provider URI sequencer-validators must contain at least one pubkey");
+    }
+    for (const publicKey of publicKeys) {
+      if (!publicKey.startsWith("0x")) {
+        throw new Error(`Canton provider URI sequencer-validators pubkey must start with 0x, got: ${publicKey.slice(0, 10)}...`);
+      }
+    }
+    const quorum = Number(sequencerQuorumParam);
+    if (!Number.isInteger(quorum) || quorum < 1) {
+      throw new Error(`Canton provider URI sequencer-quorum must be a positive integer, got: ${sequencerQuorumParam}`);
+    }
+    if (quorum > publicKeys.length) {
+      throw new Error(`Canton provider URI sequencer-quorum=${quorum} exceeds committee size ${publicKeys.length}`);
+    }
+    sequencerCommittee = {
+      publicKeys,
+      quorum
+    };
+  } else if (sequencerValidatorsParam !== null || sequencerQuorumParam !== null) {
+    throw new Error("Canton provider URI must set both sequencer-validators and sequencer-quorum together");
+  }
   const jsonApiUrl = url.toString().replace(/\/$/, "");
   const oauth2 = tokenUrl && clientId && clientSecret ? {
     tokenUrl,
@@ -47,6 +81,8 @@ function parseCantonUri(uri) {
     adminApiHost,
     userId,
     walletUrl,
+    sequencerUrl,
+    sequencerCommittee,
     oauth2
   };
 }
@@ -67,7 +103,9 @@ function createCantonProvider({ uri, isLocal }) {
     client,
     grpcClient,
     tokenProvider,
-    walletUrl: params.walletUrl
+    walletUrl: params.walletUrl,
+    sequencerUrl: params.sequencerUrl,
+    sequencerCommittee: params.sequencerCommittee
   };
 }
 __name(createCantonProvider, "createCantonProvider");
@@ -87,5 +125,5 @@ function createTokenProvider(params, isLocal) {
 __name(createTokenProvider, "createTokenProvider");
 
 export { createCantonProvider, parseCantonUri };
-//# sourceMappingURL=MDLCDBAQ.js.map
-//# sourceMappingURL=MDLCDBAQ.js.map
+//# sourceMappingURL=HNZRSDTR.js.map
+//# sourceMappingURL=HNZRSDTR.js.map

package/dist/HNZRSDTR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.ts"],"names":["parseCantonUri","uri","url","URL","adminApiHost","searchParams","get","Error","userId","walletUrl","sequencerUrl","sequencerValidatorsParam","sequencerQuorumParam","tokenUrl","undefined","clientId","clientSecret","scope","audience","key","delete","sequencerCommittee","publicKeys","split","map","s","trim","toLowerCase","filter","length","publicKey","startsWith","slice","quorum","Number","isInteger","jsonApiUrl","toString","replace","oauth2","createCantonProvider","isLocal","params","tokenProvider","createTokenProvider","configuration","Configuration","basePath","accessToken","getToken","client","CantonClient","grpcClient","CantonGrpcClient","host","LocalTokenProvider","actAs","admin","ClientCredentialsTokenProvider"],"mappings":"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","file":"HNZRSDTR.js","sourcesContent":["import {\n    ClientCredentialsTokenProvider,\n    type ClientCredentialsTokenProviderConfig,\n} from './auth/client-credentials-token-provider';\nimport { LocalTokenProvider } from './auth/local-token-provider';\nimport type { TokenProvider } from './auth/token-provider';\nimport { CantonClient } from './client/canton-client';\nimport { CantonGrpcClient } from './client/grpc';\nimport type { ICantonClient } from './client/interface';\nimport { Configuration } from './open-api/runtime';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Provider Type\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Composite provider for Canton — bundles both transport layers and shared auth.\n *\n * - {@link client} — JSON Ledger API (commands, queries, updates)\n * - {@link grpcClient} — gRPC Admin API (topology transactions, namespace queries)\n * - {@link tokenProvider} — Shared Bearer-token source used by both transports\n */\nexport type CantonProvider = {\n    client: ICantonClient;\n    grpcClient: CantonGrpcClient;\n    tokenProvider: TokenProvider;\n    /** Validator wallet URL for scan-proxy CIP-56 endpoints. Required. */\n    walletUrl: string;\n    /** LayerZero sequencer base URL (e.g. \"http://localhost:8080\"); vApp JSON-RPC at `/vapp`. Required. */\n    sequencerUrl: string;\n    /** Sequencer validator pubkeys plus quorum for verifying signed read responses. */\n    sequencerCommittee?: SequencerCommittee;\n};\n\n/**\n * Client-side committee config for secp256k1 sequencer read verification.\n * Pubkeys must be hex-encoded with `0x` prefix in the same format returned by\n * `recoverSecp256k1PublicKey`.\n */\nexport type SequencerCommittee = {\n    publicKeys: `0x${string}`[];\n    quorum: number;\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// URI Parsing\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport type CantonUriParams = {\n    /** Base URL of the JSON Ledger API (e.g. \"http://localhost:5975\") */\n    jsonApiUrl: string;\n    /** Host:port of the gRPC Admin API (e.g. \"localhost:5076\") */\n    adminApiHost: string;\n    /** Ledger API user ID (default: \"participant_admin\") */\n    userId: string;\n    /** Validator wallet URL for scan-proxy CIP-56 endpoints (e.g. \"http://localhost:7201\"). Required. */\n    walletUrl: string;\n    /** LayerZero sequencer base URL (e.g. \"http://localhost:8080\"); vApp JSON-RPC at `/vapp`. Required. */\n    sequencerUrl: string;\n    /** Sequencer committee config parsed from the provider URI. */\n    sequencerCommittee?: SequencerCommittee;\n    /** OAuth2 client credentials config — present only for non-local environments */\n    oauth2?: ClientCredentialsTokenProviderConfig;\n};\n\n/**\n * Parse a Canton provider URI into its constituent parts.\n *\n * URI format:\n *   `<json-api-base>?admin-api=<host:port>&user-id=<id>[&token-url=...&client-id=...&client-secret=...&scope=...&audience=...]`\n *\n * The base URL (everything before the query string) is the JSON Ledger API endpoint.\n * Canton-specific params are extracted and removed; any remaining query params are\n * preserved on the JSON API URL.\n */\nexport function parseCantonUri(uri: string): CantonUriParams {\n    const url = new URL(uri);\n\n    const adminApiHost = url.searchParams.get('admin-api');\n    if (!adminApiHost) {\n        throw new Error('Canton provider URI missing required \"admin-api\" query parameter');\n    }\n\n    const userId = url.searchParams.get('user-id') ?? 'participant_admin';\n    const walletUrl = url.searchParams.get('wallet-url');\n    if (!walletUrl) {\n        throw new Error('Canton provider URI missing required \"wallet-url\" query parameter');\n    }\n    const sequencerUrl = url.searchParams.get('sequencer-url');\n    if (!sequencerUrl) {\n        throw new Error('Canton provider URI missing required \"sequencer-url\" query parameter');\n    }\n    const sequencerValidatorsParam = url.searchParams.get('sequencer-validators');\n    const sequencerQuorumParam = url.searchParams.get('sequencer-quorum');\n    const tokenUrl = url.searchParams.get('token-url') ?? undefined;\n    const clientId = url.searchParams.get('client-id') ?? undefined;\n    const clientSecret = url.searchParams.get('client-secret') ?? undefined;\n    const scope = url.searchParams.get('scope') ?? undefined;\n    const audience = url.searchParams.get('audience') ?? undefined;\n\n    // Remove Canton params to get clean JSON API URL\n    for (const key of [\n        'admin-api',\n        'user-id',\n        'wallet-url',\n        'sequencer-url',\n        'sequencer-validators',\n        'sequencer-quorum',\n        'token-url',\n        'client-id',\n        'client-secret',\n        'scope',\n        'audience',\n    ]) {\n        url.searchParams.delete(key);\n    }\n\n    let sequencerCommittee: SequencerCommittee | undefined;\n    if (sequencerValidatorsParam !== null && sequencerQuorumParam !== null) {\n        const publicKeys = sequencerValidatorsParam\n            .split(',')\n            .map((s) => s.trim().toLowerCase())\n            .filter((s) => s.length > 0);\n        if (publicKeys.length === 0) {\n            throw new Error(\n                'Canton provider URI sequencer-validators must contain at least one pubkey',\n            );\n        }\n        for (const publicKey of publicKeys) {\n            if (!publicKey.startsWith('0x')) {\n                throw new Error(\n                    `Canton provider URI sequencer-validators pubkey must start with 0x, got: ${publicKey.slice(0, 10)}...`,\n                );\n            }\n        }\n\n        const quorum = Number(sequencerQuorumParam);\n        if (!Number.isInteger(quorum) || quorum < 1) {\n            throw new Error(\n                `Canton provider URI sequencer-quorum must be a positive integer, got: ${sequencerQuorumParam}`,\n            );\n        }\n        if (quorum > publicKeys.length) {\n            throw new Error(\n                `Canton provider URI sequencer-quorum=${quorum} exceeds committee size ${publicKeys.length}`,\n            );\n        }\n        sequencerCommittee = {\n            publicKeys: publicKeys as `0x${string}`[],\n            quorum,\n        };\n    } else if (sequencerValidatorsParam !== null || sequencerQuorumParam !== null) {\n        throw new Error(\n            'Canton provider URI must set both sequencer-validators and sequencer-quorum together',\n        );\n    }\n\n    const jsonApiUrl = url.toString().replace(/\\/$/, '');\n\n    const oauth2 =\n        tokenUrl && clientId && clientSecret\n            ? { tokenUrl, clientId, clientSecret, scope, audience }\n            : undefined;\n\n    return {\n        jsonApiUrl,\n        adminApiHost,\n        userId,\n        walletUrl,\n        sequencerUrl,\n        sequencerCommittee,\n        oauth2,\n    };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Provider Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport type CreateCantonProviderOptions = {\n    /** Raw provider URI (from provider config) */\n    uri: string;\n    /** When true, uses LocalTokenProvider (self-signed JWTs) instead of OAuth2 */\n    isLocal: boolean;\n};\n\n/**\n * Create a {@link CantonProvider} from a provider URI.\n *\n * - **isLocal=true**: Uses {@link LocalTokenProvider} with admin-level access (self-signed JWTs).\n * - **isLocal=false**: Uses {@link ClientCredentialsTokenProvider} with OAuth2 client\n *   credentials extracted from the URI query parameters.\n */\nexport function createCantonProvider({\n    uri,\n    isLocal,\n}: CreateCantonProviderOptions): CantonProvider {\n    const params = parseCantonUri(uri);\n\n    const tokenProvider = createTokenProvider(params, isLocal);\n\n    // ── JSON Ledger API Client ──────────────────────────────────────────\n    const configuration = new Configuration({\n        basePath: params.jsonApiUrl,\n        accessToken: () => tokenProvider.getToken(),\n    });\n    const client = new CantonClient(configuration, params.userId);\n\n    // ── gRPC Admin API Client ───────────────────────────────────────────\n    const grpcClient = new CantonGrpcClient({\n        host: params.adminApiHost,\n        tokenProvider,\n    });\n\n    return {\n        client,\n        grpcClient,\n        tokenProvider,\n        walletUrl: params.walletUrl,\n        sequencerUrl: params.sequencerUrl,\n        sequencerCommittee: params.sequencerCommittee,\n    };\n}\n\nfunction createTokenProvider(params: CantonUriParams, isLocal: boolean): TokenProvider {\n    if (isLocal) {\n        return new LocalTokenProvider({\n            userId: params.userId,\n            actAs: [],\n            admin: true,\n        });\n    }\n\n    // TODO(canton): add other prod auth methods (direct JWT passthrough, etc.).\n    if (!params.oauth2) {\n        throw new Error(\n            'Canton provider requires OAuth2 credentials (token-url, client-id, client-secret) in the provider URI',\n        );\n    }\n\n    return new ClientCredentialsTokenProvider(params.oauth2);\n}\n"]}

package/dist/NO5PBPQH.js

@@ -0,0 +1,97 @@
+import { cantonTransactionSchema } from './3YCNHEVD.js';
+import { __name } from './VUOMXK5T.js';
+import { buildTransactionWithResultSchema } from '@layerzerolabs/common-chain-model';
+import { NonRetryableError } from '@layerzerolabs/common-error-utils';
+
+var cantonTxWithResultSchema = buildTransactionWithResultSchema(cantonTransactionSchema);
+var REQUEST_ARCHIVAL_POLL_INTERVAL_MS = 2e3;
+var REQUEST_ARCHIVAL_MAX_ATTEMPTS = 60;
+var IREQUEST_ACCEPT_CHOICE = "IRequest_Accept";
+var IREQUEST_REJECT_CHOICE = "IRequest_Reject";
+var REQUEST_TEMPLATE_QUALIFIED_NAME = "Request:Request";
+var fetchCreatedEvents = /* @__PURE__ */ __name(async (client, updateId, parties) => {
+  const cantonTx = await client.fetchTransactionByUpdateId(updateId, parties);
+  return cantonTx.events?.filter((event) => "CreatedEvent" in event).map((event) => event.CreatedEvent) ?? [];
+}, "fetchCreatedEvents");
+var findMatchingCreatedEvent = /* @__PURE__ */ __name((createdEvents, expectedTemplateId, expectedSignatories) => {
+  const expectedSet = new Set(expectedSignatories);
+  return createdEvents.find((event) => {
+    if (event.templateId !== expectedTemplateId) return false;
+    const signatories = event.signatories ?? [];
+    return signatories.length > 0 && signatories.every((s) => expectedSet.has(s));
+  });
+}, "findMatchingCreatedEvent");
+var findMatchingCreatedEventFromTx = /* @__PURE__ */ __name(async (client, tx) => {
+  if (!tx) return null;
+  const parsed = cantonTxWithResultSchema.safeParse(tx);
+  if (!parsed.success) return null;
+  if (parsed.data.result.type !== "success") return null;
+  const { commands, actAs } = parsed.data.populatedTransaction;
+  const updateId = parsed.data.result.minedTxHash;
+  if (!updateId || !actAs.length) return null;
+  const createCommand = commands[0];
+  if (!createCommand || !("createCommand" in createCommand)) return null;
+  const createdEvents = await fetchCreatedEvents(client, updateId, actAs);
+  return findMatchingCreatedEvent(createdEvents, createCommand.createCommand.templateId, actAs) ?? null;
+}, "findMatchingCreatedEventFromTx");
+var cantonDeploymentSucceeded = /* @__PURE__ */ __name(async (client, txWithResult) => {
+  return await findMatchingCreatedEventFromTx(client, txWithResult) != null;
+}, "cantonDeploymentSucceeded");
+var cantonRegisterSucceeded = /* @__PURE__ */ __name(async (client, txWithResult) => {
+  const parsed = cantonTxWithResultSchema.safeParse(txWithResult);
+  if (!parsed.success || parsed.data.result.type !== "success") return false;
+  const updateId = parsed.data.result.minedTxHash;
+  if (!updateId) return false;
+  const { actAs } = parsed.data.populatedTransaction;
+  const parties = actAs.length ? actAs : await client.listUserParties();
+  if (!parties.length) return false;
+  const createdEvents = await fetchCreatedEvents(client, updateId, parties);
+  const requestEvent = createdEvents.find((event) => event.templateId?.includes(REQUEST_TEMPLATE_QUALIFIED_NAME));
+  if (!requestEvent) return false;
+  try {
+    await waitForRequestArchival(client, requestEvent.contractId, parties);
+    return true;
+  } catch {
+    return false;
+  }
+}, "cantonRegisterSucceeded");
+var waitForRequestArchival = /* @__PURE__ */ __name(async (client, requestContractId, parties) => {
+  for (let attempt = 1; attempt <= REQUEST_ARCHIVAL_MAX_ATTEMPTS; attempt++) {
+    const { archived } = await client.fetchEventsByContractId(requestContractId, parties);
+    if (archived) {
+      const transaction = await client.fetchTransactionByOffset(archived.offset, parties);
+      let interfaceChoice;
+      let interfaceArg;
+      let consumingChoice;
+      for (const event of transaction.events ?? []) {
+        if (!("ExercisedEvent" in event)) continue;
+        const ex = event.ExercisedEvent;
+        if (ex.contractId !== requestContractId) continue;
+        if (ex.choice === IREQUEST_ACCEPT_CHOICE || ex.choice === IREQUEST_REJECT_CHOICE) {
+          interfaceChoice = ex.choice;
+          interfaceArg = ex.choiceArgument;
+        }
+        if (ex.consuming) {
+          consumingChoice = ex.choice;
+        }
+      }
+      if (interfaceChoice === IREQUEST_ACCEPT_CHOICE) {
+        return interfaceArg;
+      }
+      if (interfaceChoice === IREQUEST_REJECT_CHOICE) {
+        const rejectContext = typeof interfaceArg === "object" && interfaceArg !== null && "rejectContext" in interfaceArg ? interfaceArg.rejectContext : void 0;
+        const reason = rejectContext ? JSON.stringify(rejectContext).slice(0, 500) : "unknown";
+        throw new NonRetryableError(`Request rejected \u2014 rejectContext: ${reason}`);
+      }
+      throw new NonRetryableError(`Request ${requestContractId} archived via unexpected choice ${consumingChoice ?? "<none>"}`);
+    }
+    if (attempt < REQUEST_ARCHIVAL_MAX_ATTEMPTS) {
+      await new Promise((resolve) => setTimeout(resolve, REQUEST_ARCHIVAL_POLL_INTERVAL_MS));
+    }
+  }
+  throw new NonRetryableError(`Request archival timeout (${REQUEST_ARCHIVAL_MAX_ATTEMPTS} attempts) for ${requestContractId}`);
+}, "waitForRequestArchival");
+
+export { cantonDeploymentSucceeded, cantonRegisterSucceeded, fetchCreatedEvents, findMatchingCreatedEvent, findMatchingCreatedEventFromTx, waitForRequestArchival };
+//# sourceMappingURL=NO5PBPQH.js.map
+//# sourceMappingURL=NO5PBPQH.js.map

package/dist/NO5PBPQH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/events.ts"],"names":["cantonTxWithResultSchema","buildTransactionWithResultSchema","cantonTransactionSchema","REQUEST_ARCHIVAL_POLL_INTERVAL_MS","REQUEST_ARCHIVAL_MAX_ATTEMPTS","IREQUEST_ACCEPT_CHOICE","IREQUEST_REJECT_CHOICE","REQUEST_TEMPLATE_QUALIFIED_NAME","fetchCreatedEvents","client","updateId","parties","cantonTx","fetchTransactionByUpdateId","events","filter","event","map","CreatedEvent","findMatchingCreatedEvent","createdEvents","expectedTemplateId","expectedSignatories","expectedSet","Set","find","templateId","signatories","length","every","s","has","findMatchingCreatedEventFromTx","tx","parsed","safeParse","success","data","result","type","commands","actAs","populatedTransaction","minedTxHash","createCommand","cantonDeploymentSucceeded","txWithResult","cantonRegisterSucceeded","listUserParties","requestEvent","includes","waitForRequestArchival","contractId","requestContractId","attempt","archived","fetchEventsByContractId","transaction","fetchTransactionByOffset","offset","interfaceChoice","interfaceArg","consumingChoice","ex","ExercisedEvent","choice","choiceArgument","consuming","rejectContext","undefined","reason","JSON","stringify","slice","NonRetryableError","Promise","resolve","setTimeout"],"mappings":"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","file":"NO5PBPQH.js","sourcesContent":["import { buildTransactionWithResultSchema } from '@layerzerolabs/common-chain-model';\nimport { NonRetryableError } from '@layerzerolabs/common-error-utils';\n\nimport type { ICantonClient } from './client';\nimport type { CreatedEvent } from './open-api/models';\nimport { cantonTransactionSchema } from './transaction';\n\nconst cantonTxWithResultSchema = buildTransactionWithResultSchema(cantonTransactionSchema);\n\n// TODO(canton): confirm these poll values are enough to wait for archival across environments.\nconst REQUEST_ARCHIVAL_POLL_INTERVAL_MS = 2000;\nconst REQUEST_ARCHIVAL_MAX_ATTEMPTS = 60;\n\n// IRequest interface choices that consume the Request contract via `archive reqCid` in their impls.\nconst IREQUEST_ACCEPT_CHOICE = 'IRequest_Accept';\nconst IREQUEST_REJECT_CHOICE = 'IRequest_Reject';\n\nconst REQUEST_TEMPLATE_QUALIFIED_NAME = 'Request:Request';\n\n/**\n * Fetches a transaction by updateId and returns all CreatedEvents.\n */\nexport const fetchCreatedEvents = async (\n    client: ICantonClient,\n    updateId: string,\n    parties: string[],\n): Promise<CreatedEvent[]> => {\n    const cantonTx = await client.fetchTransactionByUpdateId(updateId, parties);\n    return (\n        cantonTx.events\n            ?.filter((event): event is { CreatedEvent: CreatedEvent } => 'CreatedEvent' in event)\n            .map((event) => event.CreatedEvent) ?? []\n    );\n};\n\n/**\n * Finds a CreatedEvent matching the expected templateId whose signatories\n * are a subset of the provided actAs parties.\n */\nexport const findMatchingCreatedEvent = (\n    createdEvents: CreatedEvent[],\n    expectedTemplateId: string,\n    expectedSignatories: string[],\n): CreatedEvent | undefined => {\n    const expectedSet = new Set(expectedSignatories);\n    return createdEvents.find((event) => {\n        if (event.templateId !== expectedTemplateId) return false;\n        const signatories = event.signatories ?? [];\n        return signatories.length > 0 && signatories.every((s) => expectedSet.has(s));\n    });\n};\n\n/**\n * Parses a Canton transaction-with-result, fetches the created events from the ledger,\n * and returns the first CreatedEvent matching the submitted command's templateId and actAs\n * signatories. Returns null if the transaction is falsy, not successful, or has no match.\n */\nexport const findMatchingCreatedEventFromTx = async (\n    client: ICantonClient,\n    tx: unknown,\n): Promise<CreatedEvent | null> => {\n    if (!tx) return null;\n\n    const parsed = cantonTxWithResultSchema.safeParse(tx);\n    if (!parsed.success) return null;\n    if (parsed.data.result.type !== 'success') return null;\n\n    const { commands, actAs } = parsed.data.populatedTransaction;\n    const updateId = parsed.data.result.minedTxHash;\n\n    if (!updateId || !actAs.length) return null;\n\n    const createCommand = commands[0];\n    if (!createCommand || !('createCommand' in createCommand)) return null;\n\n    const createdEvents = await fetchCreatedEvents(client, updateId, actAs);\n    return (\n        findMatchingCreatedEvent(createdEvents, createCommand.createCommand.templateId, actAs) ??\n        null\n    );\n};\n\n/**\n * Checks that a Canton deploy transaction resulted in a CreatedEvent\n * matching the submitted command's templateId and actAs signatories.\n */\nexport const cantonDeploymentSucceeded = async (\n    client: ICantonClient,\n    txWithResult: unknown,\n): Promise<boolean> => {\n    return (await findMatchingCreatedEventFromTx(client, txWithResult)) != null;\n};\n\n/**\n * Success check for register-style deploys (an exercise on Uln302 that creates a\n * Request, which the validator then accepts or rejects in a later transaction).\n *\n * Positively confirms acceptance: locate the Request created by this submission,\n * then delegate to waitForRequestArchival, which waits for the Request to be\n * archived and verifies the IRequest_Accept choice ran (throwing on reject,\n * unexpected archival, or timeout). This is a positive accept check rather than\n * inferring success from the absence of a rejection event.\n */\nexport const cantonRegisterSucceeded = async (\n    client: ICantonClient,\n    txWithResult: unknown,\n): Promise<boolean> => {\n    const parsed = cantonTxWithResultSchema.safeParse(txWithResult);\n    if (!parsed.success || parsed.data.result.type !== 'success') return false;\n\n    const updateId = parsed.data.result.minedTxHash;\n    if (!updateId) return false;\n\n    // Deferred-sender register payloads build with empty actAs (the sender is\n    // resolved at sign time), so fall back to the parties this user can read as.\n    const { actAs } = parsed.data.populatedTransaction;\n    const parties = actAs.length ? actAs : await client.listUserParties();\n    if (!parties.length) return false;\n\n    const createdEvents = await fetchCreatedEvents(client, updateId, parties);\n    const requestEvent = createdEvents.find((event) =>\n        event.templateId?.includes(REQUEST_TEMPLATE_QUALIFIED_NAME),\n    );\n    if (!requestEvent) return false;\n\n    try {\n        await waitForRequestArchival(client, requestEvent.contractId, parties);\n        return true;\n    } catch {\n        return false;\n    }\n};\n\n/**\n * Wait for a Request contract to be archived AND determine accept vs reject\n * by inspecting which IRequest choice ran on it.\n *\n * IRequest_Accept and IRequest_Reject are nonconsuming choices that both end\n * with `archive reqCid` in their implementations. We can't tell accept from\n * reject from the archive alone — must look at the ExercisedEvent in the\n * archive transaction tree.\n *\n * On accept, returns the IRequest_Accept choice argument (the accept call\n * context, including `acceptContext`) so callers can extract the validator's\n * internal address from it.\n *\n * Throws NonRetryableError on rejection, on archival via a non-Accept/Reject\n * path (unexpected), or on timeout.\n */\nexport const waitForRequestArchival = async (\n    client: ICantonClient,\n    requestContractId: string,\n    parties: string[],\n): Promise<unknown> => {\n    for (let attempt = 1; attempt <= REQUEST_ARCHIVAL_MAX_ATTEMPTS; attempt++) {\n        const { archived } = await client.fetchEventsByContractId(requestContractId, parties);\n        if (archived) {\n            const transaction = await client.fetchTransactionByOffset(archived.offset, parties);\n            // IRequest_Accept and IRequest_Reject are *nonconsuming* interface\n            // choices on IRequest. Their template impls (Request.daml's\n            // request_AcceptImpl / request_RejectImpl) end with `archive reqCid`,\n            // which Canton records as a consuming exercise of the implicit\n            // `Archive` choice. So in the transaction tree we see TWO exercises\n            // on the Request contract:\n            //   - a non-consuming `IRequest_Accept` (or `IRequest_Reject`)\n            //   - a consuming `Archive` (the actual archival)\n            // Scan for any IRequest_Accept/Reject exercise on it in the\n            // tree to determine the outcome, regardless of which one consumed.\n            let interfaceChoice: string | undefined;\n            let interfaceArg: unknown;\n            let consumingChoice: string | undefined;\n            for (const event of transaction.events ?? []) {\n                if (!('ExercisedEvent' in event)) continue;\n                const ex = event.ExercisedEvent;\n                if (ex.contractId !== requestContractId) continue;\n                if (ex.choice === IREQUEST_ACCEPT_CHOICE || ex.choice === IREQUEST_REJECT_CHOICE) {\n                    interfaceChoice = ex.choice;\n                    interfaceArg = ex.choiceArgument;\n                }\n                if (ex.consuming) {\n                    consumingChoice = ex.choice;\n                }\n            }\n            if (interfaceChoice === IREQUEST_ACCEPT_CHOICE) {\n                return interfaceArg;\n            }\n            if (interfaceChoice === IREQUEST_REJECT_CHOICE) {\n                const rejectContext =\n                    typeof interfaceArg === 'object' &&\n                    interfaceArg !== null &&\n                    'rejectContext' in interfaceArg\n                        ? interfaceArg.rejectContext\n                        : undefined;\n                const reason = rejectContext\n                    ? JSON.stringify(rejectContext).slice(0, 500)\n                    : 'unknown';\n                throw new NonRetryableError(`Request rejected — rejectContext: ${reason}`);\n            }\n            // No IRequest_Accept/Reject ran on this Request — it was archived\n            // via some other path (default `Archive`, or another consuming\n            // choice). That's unexpected for register-style flows — treat as\n            // failure so we don't silently call this a success.\n            throw new NonRetryableError(\n                `Request ${requestContractId} archived via unexpected choice ${consumingChoice ?? '<none>'}`,\n            );\n        }\n        // Skip the sleep on the final attempt — there's no next iteration to\n        // wait for, so it would only delay the timeout error pointlessly.\n        if (attempt < REQUEST_ARCHIVAL_MAX_ATTEMPTS) {\n            await new Promise((resolve) => setTimeout(resolve, REQUEST_ARCHIVAL_POLL_INTERVAL_MS));\n        }\n    }\n    throw new NonRetryableError(\n        `Request archival timeout (${REQUEST_ARCHIVAL_MAX_ATTEMPTS} attempts) for ${requestContractId}`,\n    );\n};\n"]}

package/dist/events.d.ts

@@ -20,4 +20,32 @@ export declare const findMatchingCreatedEventFromTx: (client: ICantonClient, tx:
  * matching the submitted command's templateId and actAs signatories.
  */
 export declare const cantonDeploymentSucceeded: (client: ICantonClient, txWithResult: unknown) => Promise<boolean>;
+/**
+ * Success check for register-style deploys (an exercise on Uln302 that creates a
+ * Request, which the validator then accepts or rejects in a later transaction).
+ *
+ * Positively confirms acceptance: locate the Request created by this submission,
+ * then delegate to waitForRequestArchival, which waits for the Request to be
+ * archived and verifies the IRequest_Accept choice ran (throwing on reject,
+ * unexpected archival, or timeout). This is a positive accept check rather than
+ * inferring success from the absence of a rejection event.
+ */
+export declare const cantonRegisterSucceeded: (client: ICantonClient, txWithResult: unknown) => Promise<boolean>;
+/**
+ * Wait for a Request contract to be archived AND determine accept vs reject
+ * by inspecting which IRequest choice ran on it.
+ *
+ * IRequest_Accept and IRequest_Reject are nonconsuming choices that both end
+ * with `archive reqCid` in their implementations. We can't tell accept from
+ * reject from the archive alone — must look at the ExercisedEvent in the
+ * archive transaction tree.
+ *
+ * On accept, returns the IRequest_Accept choice argument (the accept call
+ * context, including `acceptContext`) so callers can extract the validator's
+ * internal address from it.
+ *
+ * Throws NonRetryableError on rejection, on archival via a non-Accept/Reject
+ * path (unexpected), or on timeout.
+ */
+export declare const waitForRequestArchival: (client: ICantonClient, requestContractId: string, parties: string[]) => Promise<unknown>;
 //# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC3B,QAAQ,aAAa,EACrB,UAAU,MAAM,EAChB,SAAS,MAAM,EAAE,KAClB,OAAO,CAAC,YAAY,EAAE,CAOxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACjC,eAAe,YAAY,EAAE,EAC7B,oBAAoB,MAAM,EAC1B,qBAAqB,MAAM,EAAE,KAC9B,YAAY,GAAG,SAOjB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GACvC,QAAQ,aAAa,EACrB,IAAI,OAAO,KACZ,OAAO,CAAC,YAAY,GAAG,IAAI,CAoB7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAClC,QAAQ,aAAa,EACrB,cAAc,OAAO,KACtB,OAAO,CAAC,OAAO,CAEjB,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAetD;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC3B,QAAQ,aAAa,EACrB,UAAU,MAAM,EAChB,SAAS,MAAM,EAAE,KAClB,OAAO,CAAC,YAAY,EAAE,CAOxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACjC,eAAe,YAAY,EAAE,EAC7B,oBAAoB,MAAM,EAC1B,qBAAqB,MAAM,EAAE,KAC9B,YAAY,GAAG,SAOjB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GACvC,QAAQ,aAAa,EACrB,IAAI,OAAO,KACZ,OAAO,CAAC,YAAY,GAAG,IAAI,CAoB7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAClC,QAAQ,aAAa,EACrB,cAAc,OAAO,KACtB,OAAO,CAAC,OAAO,CAEjB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAChC,QAAQ,aAAa,EACrB,cAAc,OAAO,KACtB,OAAO,CAAC,OAAO,CAyBjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,GAC/B,QAAQ,aAAa,EACrB,mBAAmB,MAAM,EACzB,SAAS,MAAM,EAAE,KAClB,OAAO,CAAC,OAAO,CA8DjB,CAAC"}

package/dist/events.js

@@ -1,4 +1,4 @@
-export { cantonDeploymentSucceeded, fetchCreatedEvents, findMatchingCreatedEvent, findMatchingCreatedEventFromTx } from './623CCK2L.js';
+export { cantonDeploymentSucceeded, cantonRegisterSucceeded, fetchCreatedEvents, findMatchingCreatedEvent, findMatchingCreatedEventFromTx, waitForRequestArchival } from './NO5PBPQH.js';
 import './3YCNHEVD.js';
 import './VUOMXK5T.js';
 //# sourceMappingURL=events.js.map

package/dist/index.js

@@ -5,8 +5,8 @@ import './RSV7WS7X.js';
 import './DYPWWRBK.js';
 import './IIWYAFUO.js';
 export { computeCantonFingerprint, extractTransactions } from './QHEXOE3Y.js';
-export { cantonDeploymentSucceeded, fetchCreatedEvents, findMatchingCreatedEvent, findMatchingCreatedEventFromTx } from './623CCK2L.js';
-export { createCantonProvider, parseCantonUri } from './MDLCDBAQ.js';
+export { cantonDeploymentSucceeded, cantonRegisterSucceeded, fetchCreatedEvents, findMatchingCreatedEvent, findMatchingCreatedEventFromTx, waitForRequestArchival } from './NO5PBPQH.js';
+export { createCantonProvider, parseCantonUri } from './HNZRSDTR.js';
 export { LocalTokenProvider } from './SCEF7TLZ.js';
 export { CantonClient } from './JV2DWUBW.js';
 import './EIXIZULE.js';

package/dist/provider.d.ts

@@ -13,9 +13,21 @@ export type CantonProvider = {
     client: ICantonClient;
     grpcClient: CantonGrpcClient;
     tokenProvider: TokenProvider;
-    /** Validator wallet URL for scan-proxy CIP-56 endpoints. Required — amulet fee
-     *  payment needs it on every Canton transaction; enforced in {@link parseCantonUri}. */
+    /** Validator wallet URL for scan-proxy CIP-56 endpoints. Required. */
     walletUrl: string;
+    /** LayerZero sequencer base URL (e.g. "http://localhost:8080"); vApp JSON-RPC at `/vapp`. Required. */
+    sequencerUrl: string;
+    /** Sequencer validator pubkeys plus quorum for verifying signed read responses. */
+    sequencerCommittee?: SequencerCommittee;
+};
+/**
+ * Client-side committee config for secp256k1 sequencer read verification.
+ * Pubkeys must be hex-encoded with `0x` prefix in the same format returned by
+ * `recoverSecp256k1PublicKey`.
+ */
+export type SequencerCommittee = {
+    publicKeys: `0x${string}`[];
+    quorum: number;
 };
 export type CantonUriParams = {
     /** Base URL of the JSON Ledger API (e.g. "http://localhost:5975") */
@@ -24,8 +36,12 @@ export type CantonUriParams = {
     adminApiHost: string;
     /** Ledger API user ID (default: "participant_admin") */
     userId: string;
-    /** Validator wallet URL for scan-proxy CIP-56 endpoints (e.g. "http://localhost:7201") */
+    /** Validator wallet URL for scan-proxy CIP-56 endpoints (e.g. "http://localhost:7201"). Required. */
     walletUrl: string;
+    /** LayerZero sequencer base URL (e.g. "http://localhost:8080"); vApp JSON-RPC at `/vapp`. Required. */
+    sequencerUrl: string;
+    /** Sequencer committee config parsed from the provider URI. */
+    sequencerCommittee?: SequencerCommittee;
     /** OAuth2 client credentials config — present only for non-local environments */
     oauth2?: ClientCredentialsTokenProviderConfig;
 };

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,oCAAoC,EAC5C,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B;4FACwF;IACxF,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAMF,MAAM,MAAM,eAAe,GAAG;IAC1B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,MAAM,CAAC,EAAE,oCAAoC,CAAC;CACjD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA8C3D;AAMD,MAAM,MAAM,2BAA2B,GAAG;IACtC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EACjC,GAAG,EACH,OAAO,GACV,EAAE,2BAA2B,GAAG,cAAc,CAwB9C"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,oCAAoC,EAC5C,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,uGAAuG;IACvG,YAAY,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CAC3C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAMF,MAAM,MAAM,eAAe,GAAG;IAC1B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,SAAS,EAAE,MAAM,CAAC;IAClB,uGAAuG;IACvG,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,iFAAiF;IACjF,MAAM,CAAC,EAAE,oCAAoC,CAAC;CACjD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAkG3D;AAMD,MAAM,MAAM,2BAA2B,GAAG;IACtC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EACjC,GAAG,EACH,OAAO,GACV,EAAE,2BAA2B,GAAG,cAAc,CA0B9C"}

package/dist/provider.js

@@ -1,4 +1,4 @@
-export { createCantonProvider, parseCantonUri } from './MDLCDBAQ.js';
+export { createCantonProvider, parseCantonUri } from './HNZRSDTR.js';
 import './SCEF7TLZ.js';
 import './JV2DWUBW.js';
 import './EIXIZULE.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/common-canton",
-  "version": "0.2.105",
+  "version": "0.2.107",
   "private": false,
   "description": "Canton VM client and utilities",
   "license": "MIT",
@@ -21,8 +21,9 @@
     "@protobuf-ts/grpc-transport": "^2.9.4",
     "es-toolkit": "^1.39.10",
     "zod": "4.3.5",
-    "@layerzerolabs/typescript-utils": "0.2.105",
-    "@layerzerolabs/common-chain-model": "0.2.105"
+    "@layerzerolabs/common-error-utils": "0.2.107",
+    "@layerzerolabs/typescript-utils": "0.2.107",
+    "@layerzerolabs/common-chain-model": "0.2.107"
   },
   "devDependencies": {
     "@types/node": "^22.18.6",
@@ -31,12 +32,12 @@
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
     "vitest": "^3.2.3",
-    "@layerzerolabs/typescript-configuration": "0.2.105",
-    "@layerzerolabs/tsup-configuration": "0.2.105",
-    "@layerzerolabs/eslint-configuration": "^0.2.105",
-    "@layerzerolabs/ver-signer-adapter": "0.2.105",
-    "@layerzerolabs/vitest-configuration": "0.2.105",
-    "@layerzerolabs/vm-tooling-canton": "0.2.105"
+    "@layerzerolabs/eslint-configuration": "^0.2.107",
+    "@layerzerolabs/tsup-configuration": "0.2.107",
+    "@layerzerolabs/typescript-configuration": "0.2.107",
+    "@layerzerolabs/ver-signer-adapter": "0.2.107",
+    "@layerzerolabs/vitest-configuration": "0.2.107",
+    "@layerzerolabs/vm-tooling-canton": "0.2.107"
   },
   "publishConfig": {
     "access": "restricted",

package/src/events.ts

@@ -1,4 +1,5 @@
 import { buildTransactionWithResultSchema } from '@layerzerolabs/common-chain-model';
+import { NonRetryableError } from '@layerzerolabs/common-error-utils';
 
 import type { ICantonClient } from './client';
 import type { CreatedEvent } from './open-api/models';
@@ -6,6 +7,16 @@ import { cantonTransactionSchema } from './transaction';
 
 const cantonTxWithResultSchema = buildTransactionWithResultSchema(cantonTransactionSchema);
 
+// TODO(canton): confirm these poll values are enough to wait for archival across environments.
+const REQUEST_ARCHIVAL_POLL_INTERVAL_MS = 2000;
+const REQUEST_ARCHIVAL_MAX_ATTEMPTS = 60;
+
+// IRequest interface choices that consume the Request contract via `archive reqCid` in their impls.
+const IREQUEST_ACCEPT_CHOICE = 'IRequest_Accept';
+const IREQUEST_REJECT_CHOICE = 'IRequest_Reject';
+
+const REQUEST_TEMPLATE_QUALIFIED_NAME = 'Request:Request';
+
 /**
  * Fetches a transaction by updateId and returns all CreatedEvents.
  */
@@ -79,3 +90,127 @@ export const cantonDeploymentSucceeded = async (
 ): Promise<boolean> => {
     return (await findMatchingCreatedEventFromTx(client, txWithResult)) != null;
 };
+
+/**
+ * Success check for register-style deploys (an exercise on Uln302 that creates a
+ * Request, which the validator then accepts or rejects in a later transaction).
+ *
+ * Positively confirms acceptance: locate the Request created by this submission,
+ * then delegate to waitForRequestArchival, which waits for the Request to be
+ * archived and verifies the IRequest_Accept choice ran (throwing on reject,
+ * unexpected archival, or timeout). This is a positive accept check rather than
+ * inferring success from the absence of a rejection event.
+ */
+export const cantonRegisterSucceeded = async (
+    client: ICantonClient,
+    txWithResult: unknown,
+): Promise<boolean> => {
+    const parsed = cantonTxWithResultSchema.safeParse(txWithResult);
+    if (!parsed.success || parsed.data.result.type !== 'success') return false;
+
+    const updateId = parsed.data.result.minedTxHash;
+    if (!updateId) return false;
+
+    // Deferred-sender register payloads build with empty actAs (the sender is
+    // resolved at sign time), so fall back to the parties this user can read as.
+    const { actAs } = parsed.data.populatedTransaction;
+    const parties = actAs.length ? actAs : await client.listUserParties();
+    if (!parties.length) return false;
+
+    const createdEvents = await fetchCreatedEvents(client, updateId, parties);
+    const requestEvent = createdEvents.find((event) =>
+        event.templateId?.includes(REQUEST_TEMPLATE_QUALIFIED_NAME),
+    );
+    if (!requestEvent) return false;
+
+    try {
+        await waitForRequestArchival(client, requestEvent.contractId, parties);
+        return true;
+    } catch {
+        return false;
+    }
+};
+
+/**
+ * Wait for a Request contract to be archived AND determine accept vs reject
+ * by inspecting which IRequest choice ran on it.
+ *
+ * IRequest_Accept and IRequest_Reject are nonconsuming choices that both end
+ * with `archive reqCid` in their implementations. We can't tell accept from
+ * reject from the archive alone — must look at the ExercisedEvent in the
+ * archive transaction tree.
+ *
+ * On accept, returns the IRequest_Accept choice argument (the accept call
+ * context, including `acceptContext`) so callers can extract the validator's
+ * internal address from it.
+ *
+ * Throws NonRetryableError on rejection, on archival via a non-Accept/Reject
+ * path (unexpected), or on timeout.
+ */
+export const waitForRequestArchival = async (
+    client: ICantonClient,
+    requestContractId: string,
+    parties: string[],
+): Promise<unknown> => {
+    for (let attempt = 1; attempt <= REQUEST_ARCHIVAL_MAX_ATTEMPTS; attempt++) {
+        const { archived } = await client.fetchEventsByContractId(requestContractId, parties);
+        if (archived) {
+            const transaction = await client.fetchTransactionByOffset(archived.offset, parties);
+            // IRequest_Accept and IRequest_Reject are *nonconsuming* interface
+            // choices on IRequest. Their template impls (Request.daml's
+            // request_AcceptImpl / request_RejectImpl) end with `archive reqCid`,
+            // which Canton records as a consuming exercise of the implicit
+            // `Archive` choice. So in the transaction tree we see TWO exercises
+            // on the Request contract:
+            //   - a non-consuming `IRequest_Accept` (or `IRequest_Reject`)
+            //   - a consuming `Archive` (the actual archival)
+            // Scan for any IRequest_Accept/Reject exercise on it in the
+            // tree to determine the outcome, regardless of which one consumed.
+            let interfaceChoice: string | undefined;
+            let interfaceArg: unknown;
+            let consumingChoice: string | undefined;
+            for (const event of transaction.events ?? []) {
+                if (!('ExercisedEvent' in event)) continue;
+                const ex = event.ExercisedEvent;
+                if (ex.contractId !== requestContractId) continue;
+                if (ex.choice === IREQUEST_ACCEPT_CHOICE || ex.choice === IREQUEST_REJECT_CHOICE) {
+                    interfaceChoice = ex.choice;
+                    interfaceArg = ex.choiceArgument;
+                }
+                if (ex.consuming) {
+                    consumingChoice = ex.choice;
+                }
+            }
+            if (interfaceChoice === IREQUEST_ACCEPT_CHOICE) {
+                return interfaceArg;
+            }
+            if (interfaceChoice === IREQUEST_REJECT_CHOICE) {
+                const rejectContext =
+                    typeof interfaceArg === 'object' &&
+                    interfaceArg !== null &&
+                    'rejectContext' in interfaceArg
+                        ? interfaceArg.rejectContext
+                        : undefined;
+                const reason = rejectContext
+                    ? JSON.stringify(rejectContext).slice(0, 500)
+                    : 'unknown';
+                throw new NonRetryableError(`Request rejected — rejectContext: ${reason}`);
+            }
+            // No IRequest_Accept/Reject ran on this Request — it was archived
+            // via some other path (default `Archive`, or another consuming
+            // choice). That's unexpected for register-style flows — treat as
+            // failure so we don't silently call this a success.
+            throw new NonRetryableError(
+                `Request ${requestContractId} archived via unexpected choice ${consumingChoice ?? '<none>'}`,
+            );
+        }
+        // Skip the sleep on the final attempt — there's no next iteration to
+        // wait for, so it would only delay the timeout error pointlessly.
+        if (attempt < REQUEST_ARCHIVAL_MAX_ATTEMPTS) {
+            await new Promise((resolve) => setTimeout(resolve, REQUEST_ARCHIVAL_POLL_INTERVAL_MS));
+        }
+    }
+    throw new NonRetryableError(
+        `Request archival timeout (${REQUEST_ARCHIVAL_MAX_ATTEMPTS} attempts) for ${requestContractId}`,
+    );
+};