@bcts/frost-hubert 1.0.0-alpha.22 → 1.0.0-beta.0

package/dist/receive-CAI-x4II.cjs

@@ -0,0 +1,213 @@
+const require_chunk = require("./chunk-CZWwpsFl.cjs");
+const require_dkg_index = require("./dkg/index.cjs");
+const require_registry_index = require("./registry/index.cjs");
+const require_common = require("./common-lKP5EzHy.cjs");
+const require_busy = require("./busy-EZU7EKr6.cjs");
+const require_storage = require("./storage-B-Gu68-O.cjs");
+let _bcts_components = require("@bcts/components");
+let _bcts_dcbor = require("@bcts/dcbor");
+let _bcts_envelope = require("@bcts/envelope");
+let _bcts_gstp = require("@bcts/gstp");
+let _bcts_xid = require("@bcts/xid");
+let node_fs = require("node:fs");
+node_fs = require_chunk.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path, 1);
+//#region src/cmd/dkg/participant/receive.ts
+/**
+* Copyright © 2023-2026 Blockchain Commons, LLC
+* Copyright © 2025-2026 Parity Technologies
+*
+*
+* DKG participant receive command.
+*
+* Port of cmd/dkg/participant/receive.rs from frost-hubert-rust.
+*
+* @module
+*/
+var receive_exports = /* @__PURE__ */ require_chunk.__exportAll({
+	decodeInviteDetails: () => decodeInviteDetails,
+	receive: () => receive,
+	resolveInviteEnvelope: () => resolveInviteEnvelope
+});
+/**
+* Resolve an invite envelope from either storage (ARID) or direct UR.
+*
+* Port of `resolve_invite_envelope()` from cmd/dkg/participant/receive.rs lines 122-152.
+*/
+async function resolveInviteEnvelope(selection, invite, timeout) {
+	if (selection !== void 0) {
+		try {
+			const arid = require_common.parseAridUr(invite);
+			const envelope = await require_busy.getWithIndicator(await require_storage.createStorageClient(selection), arid, "Invite", timeout, false);
+			if (envelope === null || envelope === void 0) throw new Error("Invite not found in Hubert storage");
+			return envelope;
+		} catch (e) {
+			if (e instanceof Error && e.message.includes("Invite not found in Hubert storage")) throw e;
+		}
+		if (timeout !== void 0) throw new Error("--timeout is only valid when retrieving invites from Hubert");
+		return require_common.parseEnvelopeUr(invite);
+	}
+	try {
+		require_common.parseAridUr(invite);
+		throw new Error("Hubert storage parameters are required to retrieve invites by ARID");
+	} catch (e) {
+		if (e instanceof Error && e.message.includes("Hubert storage parameters are required")) throw e;
+	}
+	return require_common.parseEnvelopeUr(invite);
+}
+/**
+* Decode and validate invite details from an envelope.
+*
+* Port of `decode_invite_details()` from cmd/dkg/participant/receive.rs lines 154-256.
+*/
+function decodeInviteDetails(invite, now, registry, recipient, expectedSender) {
+	const recipientPrivateKeys = recipient.inceptionPrivateKeys();
+	if (recipientPrivateKeys === void 0) throw new Error("Recipient XID document has no inception private keys");
+	const sealedRequest = _bcts_gstp.SealedRequest.tryFromEnvelope(invite, void 0, now, recipientPrivateKeys);
+	const senderDocument = sealedRequest.sender();
+	if (expectedSender !== void 0) {
+		if (senderDocument.xid().urString() !== expectedSender.xid().urString()) throw new Error("Invite sender does not match expected sender");
+	} else {
+		const senderXid = senderDocument.xid();
+		const knownOwner = registry.owner()?.xidDocument().xid().urString() === senderXid.urString();
+		const knownParticipant = registry.participant(senderXid) !== void 0;
+		if (!knownOwner && !knownParticipant) throw new Error(`Invite sender not found in registry: ${senderXid.urString()}`);
+	}
+	if (!sealedRequest.request().function().equals(_bcts_envelope.Function.fromString("dkgInvite"))) throw new Error("Unexpected invite function");
+	if (sealedRequest.extractObjectForParameter("validUntil") <= now) throw new Error("Invitation expired");
+	const minSigners = sealedRequest.extractObjectForParameter("minSigners");
+	sealedRequest.extractObjectForParameter("charter");
+	sealedRequest.extractObjectForParameter("group");
+	const participantObjects = sealedRequest.objectsForParameter("participant");
+	if (minSigners < 2) throw new Error("min_signers must be at least 2");
+	if (minSigners > participantObjects.length) throw new Error("min_signers exceeds participant count");
+	const participantDocs = [];
+	let responseArid;
+	const recipientXid = recipient.xid();
+	for (const participant of participantObjects) {
+		const xidDocumentEnvelope = participant.tryUnwrap();
+		const xidDocument = _bcts_xid.XIDDocument.fromEnvelope(xidDocumentEnvelope, void 0, _bcts_xid.XIDVerifySignature.Inception);
+		if (xidDocument.xid().urString() === recipientXid.urString()) responseArid = participant.objectForPredicate("response_arid").decryptToRecipient(recipientPrivateKeys).extractSubject((cbor) => _bcts_components.ARID.fromTaggedCbor(cbor));
+		participantDocs.push(xidDocument);
+	}
+	const invitation = require_dkg_index.DkgInvitation.fromInvite(invite, now, expectedSender, recipient);
+	if (responseArid === void 0) throw new Error("Invite does not include a response ARID for this recipient");
+	return {
+		invitation,
+		participants: participantDocs
+	};
+}
+/**
+* Resolve a sender XID document from the registry by UR or pet name.
+*
+* Port of `resolve_sender()` usage in receive.rs for expected sender.
+*/
+function resolveSenderXidDocument(registry, raw) {
+	try {
+		const xid = _bcts_components.XID.fromURString(raw.trim());
+		const record = registry.participant(xid);
+		if (record) return record.xidDocument();
+		const owner = registry.owner();
+		if (owner?.xid().urString() === xid.urString()) return owner.xidDocument();
+		throw new Error(`Sender with XID ${xid.urString()} not found in registry`);
+	} catch {
+		const result = registry.participantByPetName(raw.trim());
+		if (result) {
+			const [, record] = result;
+			return record.xidDocument();
+		}
+		const owner = registry.owner();
+		if (owner?.petName() === raw.trim()) return owner.xidDocument();
+		throw new Error(`Sender '${raw}' not found in registry`);
+	}
+}
+/**
+* Execute the DKG participant receive command.
+*
+* Fetches and validates a DKG invite from the coordinator.
+*
+* Port of `receive()` from cmd/dkg/participant/receive.rs.
+*/
+async function receive(_client, options, cwd) {
+	if (options.storageSelection === void 0 && options.timeoutSeconds !== void 0) throw new Error("--timeout requires Hubert storage parameters");
+	const registryPath = require_registry_index.resolveRegistryPath(options.registryPath, cwd);
+	const registry = require_registry_index.Registry.load(registryPath);
+	const owner = registry.owner();
+	if (!owner) throw new Error("Registry owner with private keys is required");
+	const expectedSender = options.sender ? resolveSenderXidDocument(registry, options.sender) : void 0;
+	const inviteEnvelope = await resolveInviteEnvelope(options.storageSelection, options.invite, options.timeoutSeconds);
+	const details = decodeInviteDetails(inviteEnvelope, _bcts_dcbor.CborDate.now().datetime(), registry, owner.xidDocument(), expectedSender);
+	const participantNames = require_common.participantNamesFromRegistry(registry, details.participants, owner.xid(), owner.petName());
+	const coordinatorName = require_common.resolveSenderName(registry, details.invitation.sender());
+	const stateDir = require_common.dkgStateDir(registryPath, details.invitation.groupId().hex());
+	node_fs.mkdirSync(stateDir, { recursive: true });
+	const validUntilStr = details.invitation.validUntil().toString();
+	const receiveState = {
+		group: details.invitation.groupId().urString(),
+		request_id: details.invitation.requestId().urString(),
+		response_arid: details.invitation.responseArid().urString(),
+		valid_until: validUntilStr,
+		min_signers: details.invitation.minSigners(),
+		charter: details.invitation.charter(),
+		sender: details.invitation.sender().xid().urString()
+	};
+	node_fs.writeFileSync(node_path.join(stateDir, "receive.json"), JSON.stringify(receiveState, null, 2));
+	let envelopeUr;
+	if (options.noEnvelope !== true) {
+		envelopeUr = inviteEnvelope.urString();
+		console.log(envelopeUr);
+	}
+	if (options.info === true) {
+		console.error(`Charter: ${details.invitation.charter()}`);
+		console.error(`Min signers: ${details.invitation.minSigners()}`);
+		if (coordinatorName !== void 0) console.error(`Coordinator: ${coordinatorName}`);
+		console.error(`Participants: ${participantNames.join(", ")}`);
+	}
+	if (options.verbose === true) {
+		console.log(`Group ID: ${details.invitation.groupId().urString()}`);
+		console.log(`Min signers: ${details.invitation.minSigners()}`);
+		console.log(`Charter: ${details.invitation.charter()}`);
+		console.log(`Valid until: ${String(details.invitation.validUntil())}`);
+		console.log(`Response ARID: ${details.invitation.responseArid().urString()}`);
+	}
+	const resultValidUntilStr = details.invitation.validUntil().toString();
+	return {
+		groupId: details.invitation.groupId().urString(),
+		requestId: details.invitation.requestId().urString(),
+		minSigners: details.invitation.minSigners(),
+		charter: details.invitation.charter(),
+		validUntil: resultValidUntilStr,
+		responseArid: details.invitation.responseArid().urString(),
+		envelopeUr,
+		coordinatorName,
+		participantNames
+	};
+}
+//#endregion
+Object.defineProperty(exports, "decodeInviteDetails", {
+	enumerable: true,
+	get: function() {
+		return decodeInviteDetails;
+	}
+});
+Object.defineProperty(exports, "receive", {
+	enumerable: true,
+	get: function() {
+		return receive;
+	}
+});
+Object.defineProperty(exports, "receive_exports", {
+	enumerable: true,
+	get: function() {
+		return receive_exports;
+	}
+});
+Object.defineProperty(exports, "resolveInviteEnvelope", {
+	enumerable: true,
+	get: function() {
+		return resolveInviteEnvelope;
+	}
+});
+
+//# sourceMappingURL=receive-CAI-x4II.cjs.map

package/dist/receive-CAI-x4II.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive-CAI-x4II.cjs","names":["parseAridUr","getWithIndicator","createStorageClient","parseEnvelopeUr","SealedRequest","EnvelopeFunction","XIDDocument","XIDVerifySignature","ARID","DkgInvitation","XID","resolveRegistryPath","Registry","CborDate","participantNamesFromRegistry","resolveSenderName","dkgStateDir","path"],"sources":["../src/cmd/dkg/participant/receive.ts"],"sourcesContent":["/**\n * Copyright © 2023-2026 Blockchain Commons, LLC\n * Copyright © 2025-2026 Parity Technologies\n *\n *\n * DKG participant receive command.\n *\n * Port of cmd/dkg/participant/receive.rs from frost-hubert-rust.\n *\n * @module\n */\n\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\n\nimport { ARID, XID } from \"@bcts/components\";\nimport { CborDate } from \"@bcts/dcbor\";\nimport { type Envelope, Function as EnvelopeFunction } from \"@bcts/envelope\";\nimport { SealedRequest } from \"@bcts/gstp\";\nimport { XIDDocument, XIDVerifySignature } from \"@bcts/xid\";\n\nimport { DkgInvitation } from \"../../../dkg/index.js\";\nimport { Registry, resolveRegistryPath } from \"../../../registry/index.js\";\nimport { getWithIndicator } from \"../../busy.js\";\nimport { createStorageClient, type StorageClient, type StorageSelection } from \"../../storage.js\";\nimport {\n  dkgStateDir,\n  parseAridUr,\n  parseEnvelopeUr,\n  participantNamesFromRegistry,\n  resolveSenderName,\n} from \"../common.js\";\n\n/**\n * Options for the DKG receive command.\n */\nexport interface DkgReceiveOptions {\n  registryPath?: string;\n  timeoutSeconds?: number;\n  noEnvelope?: boolean;\n  info?: boolean;\n  sender?: string;\n  invite: string;\n  storageSelection?: StorageSelection;\n  verbose?: boolean;\n}\n\n/**\n * Result of the DKG receive command.\n */\nexport interface DkgReceiveResult {\n  groupId: string;\n  requestId: string;\n  minSigners: number;\n  charter: string;\n  validUntil: string;\n  responseArid: string;\n  envelopeUr?: string | undefined;\n  coordinatorName?: string | undefined;\n  participantNames?: string[] | undefined;\n}\n\n/**\n * Details extracted from a DKG invite.\n *\n * Port of `struct InviteDetails` from cmd/dkg/participant/receive.rs lines 117-120.\n */\nexport interface InviteDetails {\n  invitation: DkgInvitation;\n  participants: XIDDocument[];\n}\n\n/**\n * Resolve an invite envelope from either storage (ARID) or direct UR.\n *\n * Port of `resolve_invite_envelope()` from cmd/dkg/participant/receive.rs lines 122-152.\n */\nexport async function resolveInviteEnvelope(\n  selection: StorageSelection | undefined,\n  invite: string,\n  timeout?: number,\n): Promise<Envelope> {\n  if (selection !== undefined) {\n    // Try to parse as ARID\n    try {\n      const arid = parseAridUr(invite);\n      const client = await createStorageClient(selection);\n      const envelope = await getWithIndicator(client, arid, \"Invite\", timeout, false);\n      if (envelope === null || envelope === undefined) {\n        throw new Error(\"Invite not found in Hubert storage\");\n      }\n      return envelope;\n    } catch (e) {\n      // Not an ARID, fall through to envelope parsing\n      if (e instanceof Error && e.message.includes(\"Invite not found in Hubert storage\")) {\n        throw e;\n      }\n    }\n\n    if (timeout !== undefined) {\n      throw new Error(\"--timeout is only valid when retrieving invites from Hubert\");\n    }\n\n    return parseEnvelopeUr(invite);\n  }\n\n  // No storage selection\n  try {\n    parseAridUr(invite);\n    throw new Error(\"Hubert storage parameters are required to retrieve invites by ARID\");\n  } catch (e) {\n    // Not an ARID, parse as envelope\n    if (e instanceof Error && e.message.includes(\"Hubert storage parameters are required\")) {\n      throw e;\n    }\n  }\n\n  return parseEnvelopeUr(invite);\n}\n\n/**\n * Decode and validate invite details from an envelope.\n *\n * Port of `decode_invite_details()` from cmd/dkg/participant/receive.rs lines 154-256.\n */\nexport function decodeInviteDetails(\n  invite: Envelope,\n  now: Date,\n  registry: Registry,\n  recipient: XIDDocument,\n  expectedSender?: XIDDocument,\n): InviteDetails {\n  const recipientPrivateKeys = recipient.inceptionPrivateKeys();\n\n  if (recipientPrivateKeys === undefined) {\n    throw new Error(\"Recipient XID document has no inception private keys\");\n  }\n\n  const sealedRequest = SealedRequest.tryFromEnvelope(invite, undefined, now, recipientPrivateKeys);\n\n  const senderDocument = sealedRequest.sender();\n  if (expectedSender !== undefined) {\n    if (senderDocument.xid().urString() !== expectedSender.xid().urString()) {\n      throw new Error(\"Invite sender does not match expected sender\");\n    }\n  } else {\n    const senderXid = senderDocument.xid();\n    const owner = registry.owner();\n    const knownOwner = owner?.xidDocument().xid().urString() === senderXid.urString();\n    const knownParticipant = registry.participant(senderXid) !== undefined;\n\n    if (!knownOwner && !knownParticipant) {\n      throw new Error(`Invite sender not found in registry: ${senderXid.urString()}`);\n    }\n  }\n\n  if (!sealedRequest.request().function().equals(EnvelopeFunction.fromString(\"dkgInvite\"))) {\n    throw new Error(\"Unexpected invite function\");\n  }\n\n  const validUntil = sealedRequest.extractObjectForParameter<Date>(\"validUntil\");\n  if (validUntil <= now) {\n    throw new Error(\"Invitation expired\");\n  }\n\n  const minSigners = sealedRequest.extractObjectForParameter<number>(\"minSigners\");\n  sealedRequest.extractObjectForParameter<string>(\"charter\");\n  sealedRequest.extractObjectForParameter<ARID>(\"group\");\n  const participantObjects = sealedRequest.objectsForParameter(\"participant\");\n\n  if (minSigners < 2) {\n    throw new Error(\"min_signers must be at least 2\");\n  }\n\n  if (minSigners > participantObjects.length) {\n    throw new Error(\"min_signers exceeds participant count\");\n  }\n\n  const participantDocs: XIDDocument[] = [];\n  let responseArid: ARID | undefined;\n  const recipientXid = recipient.xid();\n\n  for (const participant of participantObjects) {\n    const xidDocumentEnvelope = participant.tryUnwrap();\n    const xidDocument = XIDDocument.fromEnvelope(\n      xidDocumentEnvelope,\n      undefined,\n      XIDVerifySignature.Inception,\n    );\n\n    if (xidDocument.xid().urString() === recipientXid.urString()) {\n      const encryptedResponseArid = participant.objectForPredicate(\"response_arid\");\n      const responseAridEnvelope = encryptedResponseArid.decryptToRecipient(recipientPrivateKeys);\n      responseArid = responseAridEnvelope.extractSubject((cbor) => ARID.fromTaggedCbor(cbor));\n    }\n\n    participantDocs.push(xidDocument);\n  }\n\n  const invitation = DkgInvitation.fromInvite(invite, now, expectedSender, recipient);\n\n  if (responseArid === undefined) {\n    throw new Error(\"Invite does not include a response ARID for this recipient\");\n  }\n\n  return { invitation, participants: participantDocs };\n}\n\n/**\n * Resolve a sender XID document from the registry by UR or pet name.\n *\n * Port of `resolve_sender()` usage in receive.rs for expected sender.\n */\nfunction resolveSenderXidDocument(registry: Registry, raw: string): XIDDocument {\n  // Try parsing as XID UR first\n  try {\n    const xid = XID.fromURString(raw.trim());\n    const record = registry.participant(xid);\n    if (record) {\n      return record.xidDocument();\n    }\n    const owner = registry.owner();\n    if (owner?.xid().urString() === xid.urString()) {\n      return owner.xidDocument();\n    }\n    throw new Error(`Sender with XID ${xid.urString()} not found in registry`);\n  } catch {\n    // Try looking up by pet name\n    const result = registry.participantByPetName(raw.trim());\n    if (result) {\n      const [, record] = result;\n      return record.xidDocument();\n    }\n    const owner = registry.owner();\n    if (owner?.petName() === raw.trim()) {\n      return owner.xidDocument();\n    }\n    throw new Error(`Sender '${raw}' not found in registry`);\n  }\n}\n\n/**\n * Execute the DKG participant receive command.\n *\n * Fetches and validates a DKG invite from the coordinator.\n *\n * Port of `receive()` from cmd/dkg/participant/receive.rs.\n */\nexport async function receive(\n  _client: StorageClient | undefined,\n  options: DkgReceiveOptions,\n  cwd: string,\n): Promise<DkgReceiveResult> {\n  if (options.storageSelection === undefined && options.timeoutSeconds !== undefined) {\n    throw new Error(\"--timeout requires Hubert storage parameters\");\n  }\n\n  const registryPath = resolveRegistryPath(options.registryPath, cwd);\n  const registry = Registry.load(registryPath);\n\n  const owner = registry.owner();\n  if (!owner) {\n    throw new Error(\"Registry owner with private keys is required\");\n  }\n\n  const expectedSender = options.sender\n    ? resolveSenderXidDocument(registry, options.sender)\n    : undefined;\n\n  const inviteEnvelope = await resolveInviteEnvelope(\n    options.storageSelection,\n    options.invite,\n    options.timeoutSeconds,\n  );\n\n  const now = CborDate.now().datetime();\n  const details = decodeInviteDetails(\n    inviteEnvelope,\n    now,\n    registry,\n    owner.xidDocument(),\n    expectedSender,\n  );\n\n  const participantNames = participantNamesFromRegistry(\n    registry,\n    details.participants,\n    owner.xid(),\n    owner.petName(),\n  );\n\n  const coordinatorName = resolveSenderName(registry, details.invitation.sender());\n\n  // Save receive state\n  const stateDir = dkgStateDir(registryPath, details.invitation.groupId().hex());\n  fs.mkdirSync(stateDir, { recursive: true });\n\n  const validUntilStr: string = (\n    details.invitation.validUntil() as { toString(): string }\n  ).toString();\n  const receiveState = {\n    group: details.invitation.groupId().urString(),\n    request_id: details.invitation.requestId().urString(),\n    response_arid: details.invitation.responseArid().urString(),\n    valid_until: validUntilStr,\n    min_signers: details.invitation.minSigners(),\n    charter: details.invitation.charter(),\n    sender: details.invitation.sender().xid().urString(),\n  };\n\n  fs.writeFileSync(path.join(stateDir, \"receive.json\"), JSON.stringify(receiveState, null, 2));\n\n  // Output based on options\n  let envelopeUr: string | undefined;\n  if (options.noEnvelope !== true) {\n    envelopeUr = inviteEnvelope.urString();\n    console.log(envelopeUr);\n  }\n\n  if (options.info === true) {\n    console.error(`Charter: ${details.invitation.charter()}`);\n    console.error(`Min signers: ${details.invitation.minSigners()}`);\n    if (coordinatorName !== undefined) {\n      console.error(`Coordinator: ${coordinatorName}`);\n    }\n    console.error(`Participants: ${participantNames.join(\", \")}`);\n  }\n\n  if (options.verbose === true) {\n    console.log(`Group ID: ${details.invitation.groupId().urString()}`);\n    console.log(`Min signers: ${details.invitation.minSigners()}`);\n    console.log(`Charter: ${details.invitation.charter()}`);\n    console.log(`Valid until: ${String(details.invitation.validUntil())}`);\n    console.log(`Response ARID: ${details.invitation.responseArid().urString()}`);\n  }\n\n  const resultValidUntilStr: string = (\n    details.invitation.validUntil() as { toString(): string }\n  ).toString();\n\n  return {\n    groupId: details.invitation.groupId().urString(),\n    requestId: details.invitation.requestId().urString(),\n    minSigners: details.invitation.minSigners(),\n    charter: details.invitation.charter(),\n    validUntil: resultValidUntilStr,\n    responseArid: details.invitation.responseArid().urString(),\n    envelopeUr,\n    coordinatorName,\n    participantNames,\n  };\n}\n"],"mappings":"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"}

package/dist/receive-D2Nn68L7.mjs

@@ -0,0 +1,188 @@
+import { t as __exportAll } from "./chunk-CjcI7cDX.mjs";
+import { DkgInvitation } from "./dkg/index.mjs";
+import { Registry, resolveRegistryPath } from "./registry/index.mjs";
+import { a as dkgStateDir, c as parseAridUr, l as parseEnvelopeUr, m as resolveSenderName, u as participantNamesFromRegistry } from "./common-CvH6dFvQ.mjs";
+import { t as getWithIndicator } from "./busy-DkM2jAIZ.mjs";
+import { t as createStorageClient } from "./storage-Bkkliz0K.mjs";
+import { ARID, XID } from "@bcts/components";
+import { CborDate } from "@bcts/dcbor";
+import { Function } from "@bcts/envelope";
+import { SealedRequest } from "@bcts/gstp";
+import { XIDDocument, XIDVerifySignature } from "@bcts/xid";
+import * as fs from "node:fs";
+import * as path from "node:path";
+//#region src/cmd/dkg/participant/receive.ts
+/**
+* Copyright © 2023-2026 Blockchain Commons, LLC
+* Copyright © 2025-2026 Parity Technologies
+*
+*
+* DKG participant receive command.
+*
+* Port of cmd/dkg/participant/receive.rs from frost-hubert-rust.
+*
+* @module
+*/
+var receive_exports = /* @__PURE__ */ __exportAll({
+	decodeInviteDetails: () => decodeInviteDetails,
+	receive: () => receive,
+	resolveInviteEnvelope: () => resolveInviteEnvelope
+});
+/**
+* Resolve an invite envelope from either storage (ARID) or direct UR.
+*
+* Port of `resolve_invite_envelope()` from cmd/dkg/participant/receive.rs lines 122-152.
+*/
+async function resolveInviteEnvelope(selection, invite, timeout) {
+	if (selection !== void 0) {
+		try {
+			const arid = parseAridUr(invite);
+			const envelope = await getWithIndicator(await createStorageClient(selection), arid, "Invite", timeout, false);
+			if (envelope === null || envelope === void 0) throw new Error("Invite not found in Hubert storage");
+			return envelope;
+		} catch (e) {
+			if (e instanceof Error && e.message.includes("Invite not found in Hubert storage")) throw e;
+		}
+		if (timeout !== void 0) throw new Error("--timeout is only valid when retrieving invites from Hubert");
+		return parseEnvelopeUr(invite);
+	}
+	try {
+		parseAridUr(invite);
+		throw new Error("Hubert storage parameters are required to retrieve invites by ARID");
+	} catch (e) {
+		if (e instanceof Error && e.message.includes("Hubert storage parameters are required")) throw e;
+	}
+	return parseEnvelopeUr(invite);
+}
+/**
+* Decode and validate invite details from an envelope.
+*
+* Port of `decode_invite_details()` from cmd/dkg/participant/receive.rs lines 154-256.
+*/
+function decodeInviteDetails(invite, now, registry, recipient, expectedSender) {
+	const recipientPrivateKeys = recipient.inceptionPrivateKeys();
+	if (recipientPrivateKeys === void 0) throw new Error("Recipient XID document has no inception private keys");
+	const sealedRequest = SealedRequest.tryFromEnvelope(invite, void 0, now, recipientPrivateKeys);
+	const senderDocument = sealedRequest.sender();
+	if (expectedSender !== void 0) {
+		if (senderDocument.xid().urString() !== expectedSender.xid().urString()) throw new Error("Invite sender does not match expected sender");
+	} else {
+		const senderXid = senderDocument.xid();
+		const knownOwner = registry.owner()?.xidDocument().xid().urString() === senderXid.urString();
+		const knownParticipant = registry.participant(senderXid) !== void 0;
+		if (!knownOwner && !knownParticipant) throw new Error(`Invite sender not found in registry: ${senderXid.urString()}`);
+	}
+	if (!sealedRequest.request().function().equals(Function.fromString("dkgInvite"))) throw new Error("Unexpected invite function");
+	if (sealedRequest.extractObjectForParameter("validUntil") <= now) throw new Error("Invitation expired");
+	const minSigners = sealedRequest.extractObjectForParameter("minSigners");
+	sealedRequest.extractObjectForParameter("charter");
+	sealedRequest.extractObjectForParameter("group");
+	const participantObjects = sealedRequest.objectsForParameter("participant");
+	if (minSigners < 2) throw new Error("min_signers must be at least 2");
+	if (minSigners > participantObjects.length) throw new Error("min_signers exceeds participant count");
+	const participantDocs = [];
+	let responseArid;
+	const recipientXid = recipient.xid();
+	for (const participant of participantObjects) {
+		const xidDocumentEnvelope = participant.tryUnwrap();
+		const xidDocument = XIDDocument.fromEnvelope(xidDocumentEnvelope, void 0, XIDVerifySignature.Inception);
+		if (xidDocument.xid().urString() === recipientXid.urString()) responseArid = participant.objectForPredicate("response_arid").decryptToRecipient(recipientPrivateKeys).extractSubject((cbor) => ARID.fromTaggedCbor(cbor));
+		participantDocs.push(xidDocument);
+	}
+	const invitation = DkgInvitation.fromInvite(invite, now, expectedSender, recipient);
+	if (responseArid === void 0) throw new Error("Invite does not include a response ARID for this recipient");
+	return {
+		invitation,
+		participants: participantDocs
+	};
+}
+/**
+* Resolve a sender XID document from the registry by UR or pet name.
+*
+* Port of `resolve_sender()` usage in receive.rs for expected sender.
+*/
+function resolveSenderXidDocument(registry, raw) {
+	try {
+		const xid = XID.fromURString(raw.trim());
+		const record = registry.participant(xid);
+		if (record) return record.xidDocument();
+		const owner = registry.owner();
+		if (owner?.xid().urString() === xid.urString()) return owner.xidDocument();
+		throw new Error(`Sender with XID ${xid.urString()} not found in registry`);
+	} catch {
+		const result = registry.participantByPetName(raw.trim());
+		if (result) {
+			const [, record] = result;
+			return record.xidDocument();
+		}
+		const owner = registry.owner();
+		if (owner?.petName() === raw.trim()) return owner.xidDocument();
+		throw new Error(`Sender '${raw}' not found in registry`);
+	}
+}
+/**
+* Execute the DKG participant receive command.
+*
+* Fetches and validates a DKG invite from the coordinator.
+*
+* Port of `receive()` from cmd/dkg/participant/receive.rs.
+*/
+async function receive(_client, options, cwd) {
+	if (options.storageSelection === void 0 && options.timeoutSeconds !== void 0) throw new Error("--timeout requires Hubert storage parameters");
+	const registryPath = resolveRegistryPath(options.registryPath, cwd);
+	const registry = Registry.load(registryPath);
+	const owner = registry.owner();
+	if (!owner) throw new Error("Registry owner with private keys is required");
+	const expectedSender = options.sender ? resolveSenderXidDocument(registry, options.sender) : void 0;
+	const inviteEnvelope = await resolveInviteEnvelope(options.storageSelection, options.invite, options.timeoutSeconds);
+	const details = decodeInviteDetails(inviteEnvelope, CborDate.now().datetime(), registry, owner.xidDocument(), expectedSender);
+	const participantNames = participantNamesFromRegistry(registry, details.participants, owner.xid(), owner.petName());
+	const coordinatorName = resolveSenderName(registry, details.invitation.sender());
+	const stateDir = dkgStateDir(registryPath, details.invitation.groupId().hex());
+	fs.mkdirSync(stateDir, { recursive: true });
+	const validUntilStr = details.invitation.validUntil().toString();
+	const receiveState = {
+		group: details.invitation.groupId().urString(),
+		request_id: details.invitation.requestId().urString(),
+		response_arid: details.invitation.responseArid().urString(),
+		valid_until: validUntilStr,
+		min_signers: details.invitation.minSigners(),
+		charter: details.invitation.charter(),
+		sender: details.invitation.sender().xid().urString()
+	};
+	fs.writeFileSync(path.join(stateDir, "receive.json"), JSON.stringify(receiveState, null, 2));
+	let envelopeUr;
+	if (options.noEnvelope !== true) {
+		envelopeUr = inviteEnvelope.urString();
+		console.log(envelopeUr);
+	}
+	if (options.info === true) {
+		console.error(`Charter: ${details.invitation.charter()}`);
+		console.error(`Min signers: ${details.invitation.minSigners()}`);
+		if (coordinatorName !== void 0) console.error(`Coordinator: ${coordinatorName}`);
+		console.error(`Participants: ${participantNames.join(", ")}`);
+	}
+	if (options.verbose === true) {
+		console.log(`Group ID: ${details.invitation.groupId().urString()}`);
+		console.log(`Min signers: ${details.invitation.minSigners()}`);
+		console.log(`Charter: ${details.invitation.charter()}`);
+		console.log(`Valid until: ${String(details.invitation.validUntil())}`);
+		console.log(`Response ARID: ${details.invitation.responseArid().urString()}`);
+	}
+	const resultValidUntilStr = details.invitation.validUntil().toString();
+	return {
+		groupId: details.invitation.groupId().urString(),
+		requestId: details.invitation.requestId().urString(),
+		minSigners: details.invitation.minSigners(),
+		charter: details.invitation.charter(),
+		validUntil: resultValidUntilStr,
+		responseArid: details.invitation.responseArid().urString(),
+		envelopeUr,
+		coordinatorName,
+		participantNames
+	};
+}
+//#endregion
+export { resolveInviteEnvelope as i, receive as n, receive_exports as r, decodeInviteDetails as t };
+
+//# sourceMappingURL=receive-D2Nn68L7.mjs.map

package/dist/receive-D2Nn68L7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive-D2Nn68L7.mjs","names":["EnvelopeFunction"],"sources":["../src/cmd/dkg/participant/receive.ts"],"sourcesContent":["/**\n * Copyright © 2023-2026 Blockchain Commons, LLC\n * Copyright © 2025-2026 Parity Technologies\n *\n *\n * DKG participant receive command.\n *\n * Port of cmd/dkg/participant/receive.rs from frost-hubert-rust.\n *\n * @module\n */\n\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\n\nimport { ARID, XID } from \"@bcts/components\";\nimport { CborDate } from \"@bcts/dcbor\";\nimport { type Envelope, Function as EnvelopeFunction } from \"@bcts/envelope\";\nimport { SealedRequest } from \"@bcts/gstp\";\nimport { XIDDocument, XIDVerifySignature } from \"@bcts/xid\";\n\nimport { DkgInvitation } from \"../../../dkg/index.js\";\nimport { Registry, resolveRegistryPath } from \"../../../registry/index.js\";\nimport { getWithIndicator } from \"../../busy.js\";\nimport { createStorageClient, type StorageClient, type StorageSelection } from \"../../storage.js\";\nimport {\n  dkgStateDir,\n  parseAridUr,\n  parseEnvelopeUr,\n  participantNamesFromRegistry,\n  resolveSenderName,\n} from \"../common.js\";\n\n/**\n * Options for the DKG receive command.\n */\nexport interface DkgReceiveOptions {\n  registryPath?: string;\n  timeoutSeconds?: number;\n  noEnvelope?: boolean;\n  info?: boolean;\n  sender?: string;\n  invite: string;\n  storageSelection?: StorageSelection;\n  verbose?: boolean;\n}\n\n/**\n * Result of the DKG receive command.\n */\nexport interface DkgReceiveResult {\n  groupId: string;\n  requestId: string;\n  minSigners: number;\n  charter: string;\n  validUntil: string;\n  responseArid: string;\n  envelopeUr?: string | undefined;\n  coordinatorName?: string | undefined;\n  participantNames?: string[] | undefined;\n}\n\n/**\n * Details extracted from a DKG invite.\n *\n * Port of `struct InviteDetails` from cmd/dkg/participant/receive.rs lines 117-120.\n */\nexport interface InviteDetails {\n  invitation: DkgInvitation;\n  participants: XIDDocument[];\n}\n\n/**\n * Resolve an invite envelope from either storage (ARID) or direct UR.\n *\n * Port of `resolve_invite_envelope()` from cmd/dkg/participant/receive.rs lines 122-152.\n */\nexport async function resolveInviteEnvelope(\n  selection: StorageSelection | undefined,\n  invite: string,\n  timeout?: number,\n): Promise<Envelope> {\n  if (selection !== undefined) {\n    // Try to parse as ARID\n    try {\n      const arid = parseAridUr(invite);\n      const client = await createStorageClient(selection);\n      const envelope = await getWithIndicator(client, arid, \"Invite\", timeout, false);\n      if (envelope === null || envelope === undefined) {\n        throw new Error(\"Invite not found in Hubert storage\");\n      }\n      return envelope;\n    } catch (e) {\n      // Not an ARID, fall through to envelope parsing\n      if (e instanceof Error && e.message.includes(\"Invite not found in Hubert storage\")) {\n        throw e;\n      }\n    }\n\n    if (timeout !== undefined) {\n      throw new Error(\"--timeout is only valid when retrieving invites from Hubert\");\n    }\n\n    return parseEnvelopeUr(invite);\n  }\n\n  // No storage selection\n  try {\n    parseAridUr(invite);\n    throw new Error(\"Hubert storage parameters are required to retrieve invites by ARID\");\n  } catch (e) {\n    // Not an ARID, parse as envelope\n    if (e instanceof Error && e.message.includes(\"Hubert storage parameters are required\")) {\n      throw e;\n    }\n  }\n\n  return parseEnvelopeUr(invite);\n}\n\n/**\n * Decode and validate invite details from an envelope.\n *\n * Port of `decode_invite_details()` from cmd/dkg/participant/receive.rs lines 154-256.\n */\nexport function decodeInviteDetails(\n  invite: Envelope,\n  now: Date,\n  registry: Registry,\n  recipient: XIDDocument,\n  expectedSender?: XIDDocument,\n): InviteDetails {\n  const recipientPrivateKeys = recipient.inceptionPrivateKeys();\n\n  if (recipientPrivateKeys === undefined) {\n    throw new Error(\"Recipient XID document has no inception private keys\");\n  }\n\n  const sealedRequest = SealedRequest.tryFromEnvelope(invite, undefined, now, recipientPrivateKeys);\n\n  const senderDocument = sealedRequest.sender();\n  if (expectedSender !== undefined) {\n    if (senderDocument.xid().urString() !== expectedSender.xid().urString()) {\n      throw new Error(\"Invite sender does not match expected sender\");\n    }\n  } else {\n    const senderXid = senderDocument.xid();\n    const owner = registry.owner();\n    const knownOwner = owner?.xidDocument().xid().urString() === senderXid.urString();\n    const knownParticipant = registry.participant(senderXid) !== undefined;\n\n    if (!knownOwner && !knownParticipant) {\n      throw new Error(`Invite sender not found in registry: ${senderXid.urString()}`);\n    }\n  }\n\n  if (!sealedRequest.request().function().equals(EnvelopeFunction.fromString(\"dkgInvite\"))) {\n    throw new Error(\"Unexpected invite function\");\n  }\n\n  const validUntil = sealedRequest.extractObjectForParameter<Date>(\"validUntil\");\n  if (validUntil <= now) {\n    throw new Error(\"Invitation expired\");\n  }\n\n  const minSigners = sealedRequest.extractObjectForParameter<number>(\"minSigners\");\n  sealedRequest.extractObjectForParameter<string>(\"charter\");\n  sealedRequest.extractObjectForParameter<ARID>(\"group\");\n  const participantObjects = sealedRequest.objectsForParameter(\"participant\");\n\n  if (minSigners < 2) {\n    throw new Error(\"min_signers must be at least 2\");\n  }\n\n  if (minSigners > participantObjects.length) {\n    throw new Error(\"min_signers exceeds participant count\");\n  }\n\n  const participantDocs: XIDDocument[] = [];\n  let responseArid: ARID | undefined;\n  const recipientXid = recipient.xid();\n\n  for (const participant of participantObjects) {\n    const xidDocumentEnvelope = participant.tryUnwrap();\n    const xidDocument = XIDDocument.fromEnvelope(\n      xidDocumentEnvelope,\n      undefined,\n      XIDVerifySignature.Inception,\n    );\n\n    if (xidDocument.xid().urString() === recipientXid.urString()) {\n      const encryptedResponseArid = participant.objectForPredicate(\"response_arid\");\n      const responseAridEnvelope = encryptedResponseArid.decryptToRecipient(recipientPrivateKeys);\n      responseArid = responseAridEnvelope.extractSubject((cbor) => ARID.fromTaggedCbor(cbor));\n    }\n\n    participantDocs.push(xidDocument);\n  }\n\n  const invitation = DkgInvitation.fromInvite(invite, now, expectedSender, recipient);\n\n  if (responseArid === undefined) {\n    throw new Error(\"Invite does not include a response ARID for this recipient\");\n  }\n\n  return { invitation, participants: participantDocs };\n}\n\n/**\n * Resolve a sender XID document from the registry by UR or pet name.\n *\n * Port of `resolve_sender()` usage in receive.rs for expected sender.\n */\nfunction resolveSenderXidDocument(registry: Registry, raw: string): XIDDocument {\n  // Try parsing as XID UR first\n  try {\n    const xid = XID.fromURString(raw.trim());\n    const record = registry.participant(xid);\n    if (record) {\n      return record.xidDocument();\n    }\n    const owner = registry.owner();\n    if (owner?.xid().urString() === xid.urString()) {\n      return owner.xidDocument();\n    }\n    throw new Error(`Sender with XID ${xid.urString()} not found in registry`);\n  } catch {\n    // Try looking up by pet name\n    const result = registry.participantByPetName(raw.trim());\n    if (result) {\n      const [, record] = result;\n      return record.xidDocument();\n    }\n    const owner = registry.owner();\n    if (owner?.petName() === raw.trim()) {\n      return owner.xidDocument();\n    }\n    throw new Error(`Sender '${raw}' not found in registry`);\n  }\n}\n\n/**\n * Execute the DKG participant receive command.\n *\n * Fetches and validates a DKG invite from the coordinator.\n *\n * Port of `receive()` from cmd/dkg/participant/receive.rs.\n */\nexport async function receive(\n  _client: StorageClient | undefined,\n  options: DkgReceiveOptions,\n  cwd: string,\n): Promise<DkgReceiveResult> {\n  if (options.storageSelection === undefined && options.timeoutSeconds !== undefined) {\n    throw new Error(\"--timeout requires Hubert storage parameters\");\n  }\n\n  const registryPath = resolveRegistryPath(options.registryPath, cwd);\n  const registry = Registry.load(registryPath);\n\n  const owner = registry.owner();\n  if (!owner) {\n    throw new Error(\"Registry owner with private keys is required\");\n  }\n\n  const expectedSender = options.sender\n    ? resolveSenderXidDocument(registry, options.sender)\n    : undefined;\n\n  const inviteEnvelope = await resolveInviteEnvelope(\n    options.storageSelection,\n    options.invite,\n    options.timeoutSeconds,\n  );\n\n  const now = CborDate.now().datetime();\n  const details = decodeInviteDetails(\n    inviteEnvelope,\n    now,\n    registry,\n    owner.xidDocument(),\n    expectedSender,\n  );\n\n  const participantNames = participantNamesFromRegistry(\n    registry,\n    details.participants,\n    owner.xid(),\n    owner.petName(),\n  );\n\n  const coordinatorName = resolveSenderName(registry, details.invitation.sender());\n\n  // Save receive state\n  const stateDir = dkgStateDir(registryPath, details.invitation.groupId().hex());\n  fs.mkdirSync(stateDir, { recursive: true });\n\n  const validUntilStr: string = (\n    details.invitation.validUntil() as { toString(): string }\n  ).toString();\n  const receiveState = {\n    group: details.invitation.groupId().urString(),\n    request_id: details.invitation.requestId().urString(),\n    response_arid: details.invitation.responseArid().urString(),\n    valid_until: validUntilStr,\n    min_signers: details.invitation.minSigners(),\n    charter: details.invitation.charter(),\n    sender: details.invitation.sender().xid().urString(),\n  };\n\n  fs.writeFileSync(path.join(stateDir, \"receive.json\"), JSON.stringify(receiveState, null, 2));\n\n  // Output based on options\n  let envelopeUr: string | undefined;\n  if (options.noEnvelope !== true) {\n    envelopeUr = inviteEnvelope.urString();\n    console.log(envelopeUr);\n  }\n\n  if (options.info === true) {\n    console.error(`Charter: ${details.invitation.charter()}`);\n    console.error(`Min signers: ${details.invitation.minSigners()}`);\n    if (coordinatorName !== undefined) {\n      console.error(`Coordinator: ${coordinatorName}`);\n    }\n    console.error(`Participants: ${participantNames.join(\", \")}`);\n  }\n\n  if (options.verbose === true) {\n    console.log(`Group ID: ${details.invitation.groupId().urString()}`);\n    console.log(`Min signers: ${details.invitation.minSigners()}`);\n    console.log(`Charter: ${details.invitation.charter()}`);\n    console.log(`Valid until: ${String(details.invitation.validUntil())}`);\n    console.log(`Response ARID: ${details.invitation.responseArid().urString()}`);\n  }\n\n  const resultValidUntilStr: string = (\n    details.invitation.validUntil() as { toString(): string }\n  ).toString();\n\n  return {\n    groupId: details.invitation.groupId().urString(),\n    requestId: details.invitation.requestId().urString(),\n    minSigners: details.invitation.minSigners(),\n    charter: details.invitation.charter(),\n    validUntil: resultValidUntilStr,\n    responseArid: details.invitation.responseArid().urString(),\n    envelopeUr,\n    coordinatorName,\n    participantNames,\n  };\n}\n"],"mappings":"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"}

package/dist/receive-DA_KQEgk.mjs

@@ -0,0 +1,177 @@
+import { n as __require, t as __exportAll } from "./chunk-CjcI7cDX.mjs";
+import { n as compareXidBytes } from "./proposed-participant-cWM7iUrO.mjs";
+import { Registry, resolveRegistryPath } from "./registry/index.mjs";
+import { c as parseAridUr, l as parseEnvelopeUr, o as formatNameWithOwnerMarker } from "./common-CvH6dFvQ.mjs";
+import { t as getWithIndicator } from "./busy-DkM2jAIZ.mjs";
+import { n as signingStateDir } from "./common-DUWvtc08.mjs";
+import { CborDate } from "@bcts/dcbor";
+import * as fs from "node:fs";
+import * as path from "node:path";
+//#region src/cmd/sign/participant/receive.ts
+/**
+* Copyright © 2023-2026 Blockchain Commons, LLC
+* Copyright © 2025-2026 Parity Technologies
+*
+*
+* Sign participant receive command.
+*
+* Port of cmd/sign/participant/receive.rs from frost-hubert-rust.
+*
+* @module
+*/
+var receive_exports = /* @__PURE__ */ __exportAll({ receive: () => receive });
+/**
+* Resolve sender from XID UR or pet name in registry.
+*
+* Port of `resolve_sender()` from cmd/dkg/common.rs lines 76-94.
+*/
+function resolveSenderFromInput(registry, input) {
+	const trimmed = input.trim();
+	if (trimmed === "") throw new Error("Sender is required");
+	try {
+		const { XID: XIDClass } = __require("@bcts/components");
+		const xid = XIDClass.fromURString(trimmed);
+		const record = registry.participant(xid);
+		if (!record) throw new Error(`Sender with XID ${xid.urString()} not found`);
+		return record.xidDocument();
+	} catch {
+		const result = registry.participantByPetName(trimmed);
+		if (!result) throw new Error(`Sender with pet name '${trimmed}' not found`);
+		return result[1].xidDocument();
+	}
+}
+/**
+* Resolve sign invite from ARID or envelope UR.
+*
+* Port of `resolve_sign_request()` from cmd/sign/participant/receive.rs lines 250-284.
+*/
+async function resolveSignInviteEnvelope(client, selection, request, timeout) {
+	if (selection !== void 0 && client !== void 0) {
+		try {
+			const envelope = await getWithIndicator(client, parseAridUr(request), "Sign invite", timeout, false);
+			if (envelope === void 0 || envelope === null) throw new Error("signInvite request not found in Hubert storage");
+			return envelope;
+		} catch {}
+		if (timeout !== void 0) throw new Error("--timeout is only valid when retrieving requests from Hubert");
+		return parseEnvelopeUr(request);
+	}
+	try {
+		parseAridUr(request);
+		throw new Error("Hubert storage parameters are required to retrieve requests by ARID");
+	} catch (e) {
+		if (e instanceof Error && e.message.includes("Hubert storage parameters")) throw e;
+	}
+	return parseEnvelopeUr(request);
+}
+/**
+* Get display name for sender from registry.
+*
+* Port of `resolve_sender_name()` from cmd/dkg/common.rs lines 96-116.
+*/
+function resolveSenderName(registry, senderXid) {
+	const owner = registry.owner();
+	if (owner?.xid().urString() === senderXid.urString()) return formatNameWithOwnerMarker(owner.petName() ?? senderXid.urString(), true);
+	const record = registry.participant(senderXid);
+	if (record) return formatNameWithOwnerMarker(record.petName() ?? record.xid().urString(), false);
+}
+/**
+* Format participant names with owner marker.
+*
+* Port of `format_participant_names()` from cmd/sign/participant/receive.rs lines 286-309.
+*/
+function formatParticipantNames(registry, participants, owner) {
+	return participants.map((xid) => {
+		const isOwner = xid.urString() === owner.xid().urString();
+		let name;
+		if (isOwner) name = owner.petName() ?? xid.urString();
+		else name = registry.participant(xid)?.petName() ?? xid.urString();
+		return formatNameWithOwnerMarker(name, isOwner);
+	});
+}
+/**
+* Execute the sign participant receive command.
+*
+* Fetches and validates a sign invite from the coordinator.
+*
+* Port of `CommandArgs::exec()` from cmd/sign/participant/receive.rs lines 56-247.
+*/
+async function receive(client, selection, options, cwd) {
+	if (selection === void 0 && options.timeoutSeconds !== void 0) throw new Error("--timeout requires Hubert storage parameters");
+	const registryPath = resolveRegistryPath(options.registryPath, cwd);
+	const registry = Registry.load(registryPath);
+	const owner = registry.owner();
+	if (!owner) throw new Error("Registry owner with private keys is required");
+	let expectedSender;
+	if (options.sender !== void 0 && options.sender !== "") expectedSender = resolveSenderFromInput(registry, options.sender);
+	const envelope = await resolveSignInviteEnvelope(client, selection, options.request, options.timeoutSeconds);
+	const now = CborDate.now();
+	const recipientKeys = owner.xidDocument().inceptionPrivateKeys();
+	if (recipientKeys === null || recipientKeys === void 0) throw new Error("Owner XID document has no inception private keys");
+	const { SealedRequest: SealedRequestClass } = __require("@bcts/gstp");
+	const sealedRequest = SealedRequestClass.tryFromEnvelope(envelope, void 0, now, recipientKeys);
+	const senderXid = sealedRequest.sender().xid();
+	if (expectedSender !== void 0) {
+		if (senderXid.urString() !== expectedSender.xid().urString()) throw new Error(`Request sender does not match expected sender (got ${senderXid.urString()}, expected ${expectedSender.xid().urString()})`);
+	} else {
+		const knownOwner = owner.xid().urString() === senderXid.urString();
+		const knownParticipant = registry.participant(senderXid) !== void 0;
+		if (!knownOwner && !knownParticipant) throw new Error(`Request sender not found in registry: ${senderXid.urString()}`);
+	}
+	const { Function: FunctionClass } = __require("@bcts/envelope");
+	const requestFunction = sealedRequest.function();
+	const expectedFunction = FunctionClass.from("signInvite");
+	if (!(requestFunction.equals !== void 0 ? requestFunction.equals(expectedFunction) : String(requestFunction) === String(expectedFunction))) throw new Error(`Unexpected request function: ${String(requestFunction)}`);
+	if (sealedRequest.extractObjectForParameter("validUntil") <= now) throw new Error("signInvite request has expired");
+	const groupId = sealedRequest.extractObjectForParameter("group");
+	const sessionId = sealedRequest.extractObjectForParameter("session");
+	const minSigners = Number(sealedRequest.extractObjectForParameter("minSigners"));
+	const participantEntries = sealedRequest.objectsForParameter("participant");
+	const participants = [];
+	let responseArid;
+	for (const entry of participantEntries) {
+		const xid = entry.extractSubject();
+		if (xid.urString() === owner.xid().urString()) responseArid = entry.objectForPredicate("response_arid").decryptToRecipient(recipientKeys).extractSubject();
+		participants.push(xid);
+	}
+	if (participants.length === 0) throw new Error("signInvite request contains no participants");
+	if (minSigners < 2) throw new Error("minSigners must be at least 2");
+	if (minSigners > participants.length) throw new Error("minSigners exceeds participant count");
+	if (!participants.some((p) => p.urString() === owner.xid().urString())) throw new Error("signInvite request does not include this participant");
+	if (responseArid === void 0) throw new Error("signInvite request missing response ARID");
+	participants.sort((a, b) => compareXidBytes(a.toData(), b.toData()));
+	const targetEnvelope = sealedRequest.objectForParameter("target");
+	const coordinatorName = resolveSenderName(registry, senderXid) ?? senderXid.urString();
+	const participantNames = formatParticipantNames(registry, participants, owner);
+	console.log(`Group: ${groupId.urString()}`);
+	console.log(`Coordinator: ${coordinatorName}`);
+	console.log(`Min signers: ${minSigners}`);
+	console.log(`Participants: ${participantNames.join(", ")}`);
+	console.log("Target:");
+	console.log(targetEnvelope.format());
+	console.log(sessionId.urString());
+	const stateDir = signingStateDir(registryPath, groupId.hex(), sessionId.hex());
+	fs.mkdirSync(stateDir, { recursive: true });
+	const root = {
+		request_envelope: envelope.urString(),
+		group: groupId.urString(),
+		session: sessionId.urString(),
+		coordinator: senderXid.urString(),
+		min_signers: minSigners,
+		response_arid: responseArid.urString(),
+		participants: participants.map((xid) => xid.urString()),
+		target: targetEnvelope.urString()
+	};
+	fs.writeFileSync(path.join(stateDir, "sign_receive.json"), JSON.stringify(root, null, 2));
+	return {
+		sessionId: sessionId.urString(),
+		groupId: groupId.urString(),
+		targetUr: targetEnvelope.urString(),
+		coordinatorName,
+		minSigners,
+		participantNames
+	};
+}
+//#endregion
+export { receive_exports as n, receive as t };
+
+//# sourceMappingURL=receive-DA_KQEgk.mjs.map