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

package/dist/invite-5277FQVT.cjs

@@ -0,0 +1,274 @@
+const require_chunk = require("./chunk-CZWwpsFl.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_common$1 = require("./common-lThIvJmZ.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 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/sign/coordinator/invite.ts
+/**
+* Copyright © 2023-2026 Blockchain Commons, LLC
+* Copyright © 2025-2026 Parity Technologies
+*
+*
+* Sign coordinator invite command.
+*
+* Port of cmd/sign/coordinator/invite.rs from frost-hubert-rust.
+*
+* @module
+*/
+var invite_exports = /* @__PURE__ */ require_chunk.__exportAll({
+	buildSessionStateJson: () => buildSessionStateJson,
+	buildSignInviteRequest: () => buildSignInviteRequest,
+	createSessionArids: () => createSessionArids,
+	gatherRecipientDocuments: () => gatherRecipientDocuments,
+	invite: () => invite,
+	loadEnvelopeFromPath: () => loadEnvelopeFromPath,
+	persistSessionState: () => persistSessionState,
+	validateCoordinator: () => validateCoordinator
+});
+/**
+* Create new session ARIDs for all participants.
+*
+* Port of `SessionArids::new()` from cmd/sign/coordinator/invite.rs lines 158-173.
+*/
+function createSessionArids(participants) {
+	const commitArids = /* @__PURE__ */ new Map();
+	const shareArids = /* @__PURE__ */ new Map();
+	for (const participant of participants) {
+		const xidKey = participant.xid().urString();
+		commitArids.set(xidKey, _bcts_components.ARID.new());
+		shareArids.set(xidKey, _bcts_components.ARID.new());
+	}
+	return {
+		sessionId: _bcts_components.ARID.new(),
+		startArid: _bcts_components.ARID.new(),
+		commitArids,
+		shareArids
+	};
+}
+/**
+* Validate that the owner is the coordinator of the group.
+*
+* Port of `validate_coordinator()` from cmd/sign/coordinator/invite.rs lines 179-192.
+*/
+function validateCoordinator(groupRecord, owner) {
+	if (groupRecord.coordinator().xid().urString() !== owner.xid().urString()) throw new Error(`Only the coordinator can start signing. Coordinator: ${groupRecord.coordinator().xid().urString()}, Owner: ${owner.xid().urString()}`);
+}
+/**
+* Gather XIDDocuments for all participants from the registry.
+*
+* Port of `gather_recipient_documents()` from cmd/sign/coordinator/invite.rs lines 198-222.
+*/
+function gatherRecipientDocuments(participants, owner, registry) {
+	const recipientDocs = [];
+	for (const participant of participants) {
+		const xid = participant.xid();
+		if (xid.urString() === owner.xid().urString()) recipientDocs.push(owner.xidDocument());
+		else {
+			const record = registry.participant(xid);
+			if (record === void 0) throw new Error(`Participant ${xid.urString()} not found in registry`);
+			recipientDocs.push(record.xidDocument());
+		}
+	}
+	return recipientDocs;
+}
+/**
+* Build the sign invite request.
+*
+* Port of `build_sign_invite_request()` from cmd/sign/coordinator/invite.rs lines 239-284.
+*/
+function buildSignInviteRequest(ctx) {
+	let request = _bcts_gstp.SealedRequest.new("signInvite", ctx.arids.sessionId, ctx.owner.xidDocument()).withParameter("group", ctx.groupId).withParameter("session", ctx.arids.sessionId).withParameter("target", ctx.targetEnvelope).withParameter("minSigners", ctx.groupRecord.minSigners()).withDate(/* @__PURE__ */ new Date()).withParameter("validUntil", _bcts_dcbor.CborDate.fromDatetime(ctx.validUntil));
+	for (const participant of ctx.participants) {
+		const xid = participant.xid();
+		const xidKey = xid.urString();
+		let participantDoc;
+		if (xidKey === ctx.owner.xid().urString()) participantDoc = ctx.owner.xidDocument();
+		else {
+			const record = ctx.registry.participant(xid);
+			if (record === void 0) throw new Error("Participant not found in registry");
+			participantDoc = record.xidDocument();
+		}
+		const encryptionKey = participantDoc.encryptionKey();
+		if (encryptionKey === void 0) throw new Error("Participant XID document has no encryption key");
+		const responseArid = ctx.arids.commitArids.get(xidKey);
+		if (responseArid === void 0) throw new Error("commit ARID not found for participant");
+		const encryptedResponseArid = responseArid.toEnvelope().encryptToRecipient(encryptionKey);
+		const participantEntry = _bcts_envelope.Envelope.new(xid).addAssertion("response_arid", encryptedResponseArid);
+		request = request.withParameter("participant", participantEntry);
+	}
+	return request;
+}
+/**
+* Build the session state JSON for persistence.
+*
+* Port of `build_session_state_json()` from cmd/sign/coordinator/invite.rs lines 290-346.
+*/
+function buildSessionStateJson(arids, groupId, groupRecord, participants, targetEnvelope) {
+	const participantsMap = {};
+	for (const participant of participants) {
+		const xidKey = participant.xid().urString();
+		const commitArid = arids.commitArids.get(xidKey);
+		const shareArid = arids.shareArids.get(xidKey);
+		if (commitArid === void 0 || shareArid === void 0) throw new Error("ARID not found for participant");
+		participantsMap[xidKey] = {
+			commit_arid: commitArid.urString(),
+			share_arid: shareArid.urString()
+		};
+	}
+	return {
+		session_id: arids.sessionId.urString(),
+		start_arid: arids.startArid.urString(),
+		group: groupId.urString(),
+		min_signers: groupRecord.minSigners(),
+		participants: participantsMap,
+		target: targetEnvelope.urString()
+	};
+}
+/**
+* Persist the session state to disk.
+*
+* Port of `persist_session_state()` from cmd/sign/coordinator/invite.rs lines 348-356.
+*/
+function persistSessionState(signingDir, stateJson) {
+	node_fs.mkdirSync(signingDir, { recursive: true });
+	const startStatePath = node_path.join(signingDir, "start.json");
+	node_fs.writeFileSync(startStatePath, JSON.stringify(stateJson, null, 2));
+}
+/**
+* Load an envelope from a file path.
+*
+* Port of `load_envelope_from_path()` from cmd/sign/coordinator/invite.rs lines 385-392.
+*/
+function loadEnvelopeFromPath(filePath) {
+	if (!node_fs.existsSync(filePath)) throw new Error(`Failed to read target envelope from ${filePath}`);
+	const trimmed = node_fs.readFileSync(filePath, "utf-8").trim();
+	try {
+		return _bcts_envelope.Envelope.fromURString(trimmed);
+	} catch (e) {
+		throw new Error(`Failed to load target envelope from ${filePath}: ${String(e)}`, { cause: e });
+	}
+}
+/**
+* Execute the sign coordinator invite command.
+*
+* Invites participants to sign a target envelope.
+*
+* Port of `CommandArgs::exec()` from cmd/sign/coordinator/invite.rs lines 44-144.
+*/
+async function invite(client, options, cwd) {
+	if (client !== void 0 && options.preview === true) throw new Error("--preview cannot be used with Hubert storage options");
+	const registryPath = require_registry_index.resolveRegistryPath(options.registryPath, cwd);
+	const registry = require_registry_index.Registry.load(registryPath);
+	const owner = registry.owner();
+	if (owner === void 0) throw new Error("Registry owner is required");
+	const groupId = require_common.parseAridUr(options.groupId);
+	const groupRecord = registry.group(groupId);
+	if (groupRecord === void 0) throw new Error(`Group ${options.groupId} not found in registry`);
+	validateCoordinator(groupRecord, owner);
+	const targetEnvelope = loadEnvelopeFromPath(node_path.resolve(cwd, options.targetFile));
+	const participants = groupRecord.participants();
+	const recipientDocs = gatherRecipientDocuments(participants, owner, registry);
+	const signerKeys = owner.xidDocument().inceptionPrivateKeys();
+	if (signerKeys === void 0) throw new Error("Coordinator XID document has no signing keys");
+	const sessionArids = createSessionArids(participants);
+	const validDays = options.validDays ?? 1 / 24;
+	const validUntil = new Date(Date.now() + validDays * 24 * 60 * 60 * 1e3);
+	const request = buildSignInviteRequest({
+		arids: sessionArids,
+		groupId,
+		targetEnvelope,
+		groupRecord,
+		owner,
+		registry,
+		participants,
+		validUntil
+	});
+	const stateJson = buildSessionStateJson(sessionArids, groupId, groupRecord, participants, targetEnvelope);
+	const recipientRefs = recipientDocs;
+	const sealedEnvelope = request.toEnvelopeForRecipients(validUntil, signerKeys, recipientRefs);
+	if (options.preview === true) {
+		const unsealed = request.toEnvelope(void 0, signerKeys, void 0);
+		console.log(unsealed.urString());
+		return {
+			sessionId: sessionArids.sessionId.urString(),
+			startArid: sessionArids.startArid.urString()
+		};
+	}
+	persistSessionState(require_common$1.signingStateDir(registryPath, groupId.hex(), sessionArids.sessionId.hex()), stateJson);
+	if (client === void 0) throw new Error("Hubert storage is required for sign start");
+	await require_busy.putWithIndicator(client, sessionArids.startArid, sealedEnvelope, "Signing invite", options.verbose ?? false);
+	if (options.verbose === true) {
+		console.log(`Session ID: ${sessionArids.sessionId.urString()}`);
+		console.log(`Start ARID: ${sessionArids.startArid.urString()}`);
+	}
+	console.log(sessionArids.startArid.urString());
+	return {
+		sessionId: sessionArids.sessionId.urString(),
+		startArid: sessionArids.startArid.urString()
+	};
+}
+//#endregion
+Object.defineProperty(exports, "buildSessionStateJson", {
+	enumerable: true,
+	get: function() {
+		return buildSessionStateJson;
+	}
+});
+Object.defineProperty(exports, "buildSignInviteRequest", {
+	enumerable: true,
+	get: function() {
+		return buildSignInviteRequest;
+	}
+});
+Object.defineProperty(exports, "createSessionArids", {
+	enumerable: true,
+	get: function() {
+		return createSessionArids;
+	}
+});
+Object.defineProperty(exports, "gatherRecipientDocuments", {
+	enumerable: true,
+	get: function() {
+		return gatherRecipientDocuments;
+	}
+});
+Object.defineProperty(exports, "invite", {
+	enumerable: true,
+	get: function() {
+		return invite;
+	}
+});
+Object.defineProperty(exports, "invite_exports", {
+	enumerable: true,
+	get: function() {
+		return invite_exports;
+	}
+});
+Object.defineProperty(exports, "loadEnvelopeFromPath", {
+	enumerable: true,
+	get: function() {
+		return loadEnvelopeFromPath;
+	}
+});
+Object.defineProperty(exports, "persistSessionState", {
+	enumerable: true,
+	get: function() {
+		return persistSessionState;
+	}
+});
+Object.defineProperty(exports, "validateCoordinator", {
+	enumerable: true,
+	get: function() {
+		return validateCoordinator;
+	}
+});
+
+//# sourceMappingURL=invite-5277FQVT.cjs.map

package/dist/invite-5277FQVT.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invite-5277FQVT.cjs","names":["ARID","SealedRequest","CborDate","Envelope","path","fs","resolveRegistryPath","Registry","parseAridUr","signingStateDir","putWithIndicator"],"sources":["../src/cmd/sign/coordinator/invite.ts"],"sourcesContent":["/**\n * Copyright © 2023-2026 Blockchain Commons, LLC\n * Copyright © 2025-2026 Parity Technologies\n *\n *\n * Sign coordinator invite command.\n *\n * Port of cmd/sign/coordinator/invite.rs from frost-hubert-rust.\n *\n * @module\n */\n\n/* eslint-disable @typescript-eslint/no-unsafe-assignment */\n/* eslint-disable @typescript-eslint/no-unsafe-call */\n/* eslint-disable @typescript-eslint/no-unsafe-member-access */\n/* eslint-disable @typescript-eslint/no-unsafe-argument */\n\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\n\nimport { ARID } from \"@bcts/components\";\nimport { CborDate } from \"@bcts/dcbor\";\nimport { Envelope } from \"@bcts/envelope\";\nimport { SealedRequest } from \"@bcts/gstp\";\nimport { type XIDDocument } from \"@bcts/xid\";\n\nimport {\n  Registry,\n  resolveRegistryPath,\n  type GroupRecord,\n  type GroupParticipant,\n  type OwnerRecord,\n} from \"../../../registry/index.js\";\nimport { putWithIndicator } from \"../../busy.js\";\nimport { type StorageClient } from \"../../storage.js\";\nimport { parseAridUr } from \"../../dkg/common.js\";\nimport { signingStateDir } from \"../common.js\";\n\n// -----------------------------------------------------------------------------\n// Session ARID management\n// -----------------------------------------------------------------------------\n\n/**\n * Session ARIDs for tracking the signing session.\n *\n * Port of `struct SessionArids` from cmd/sign/coordinator/invite.rs lines 151-156.\n */\nexport interface SessionArids {\n  sessionId: ARID;\n  startArid: ARID;\n  commitArids: Map<string, ARID>; // Map<XID.urString(), ARID>\n  shareArids: Map<string, ARID>; // Map<XID.urString(), ARID>\n}\n\n/**\n * Create new session ARIDs for all participants.\n *\n * Port of `SessionArids::new()` from cmd/sign/coordinator/invite.rs lines 158-173.\n */\nexport function createSessionArids(participants: GroupParticipant[]): SessionArids {\n  const commitArids = new Map<string, ARID>();\n  const shareArids = new Map<string, ARID>();\n\n  for (const participant of participants) {\n    const xidKey = participant.xid().urString();\n    commitArids.set(xidKey, ARID.new());\n    shareArids.set(xidKey, ARID.new());\n  }\n\n  return {\n    sessionId: ARID.new(),\n    startArid: ARID.new(),\n    commitArids,\n    shareArids,\n  };\n}\n\n// -----------------------------------------------------------------------------\n// Validation\n// -----------------------------------------------------------------------------\n\n/**\n * Validate that the owner is the coordinator of the group.\n *\n * Port of `validate_coordinator()` from cmd/sign/coordinator/invite.rs lines 179-192.\n */\nexport function validateCoordinator(groupRecord: GroupRecord, owner: OwnerRecord): void {\n  if (groupRecord.coordinator().xid().urString() !== owner.xid().urString()) {\n    throw new Error(\n      `Only the coordinator can start signing. Coordinator: ${groupRecord.coordinator().xid().urString()}, Owner: ${owner.xid().urString()}`,\n    );\n  }\n}\n\n// -----------------------------------------------------------------------------\n// Participant document gathering\n// -----------------------------------------------------------------------------\n\n/**\n * Gather XIDDocuments for all participants from the registry.\n *\n * Port of `gather_recipient_documents()` from cmd/sign/coordinator/invite.rs lines 198-222.\n */\nexport function gatherRecipientDocuments(\n  participants: GroupParticipant[],\n  owner: OwnerRecord,\n  registry: Registry,\n): XIDDocument[] {\n  const recipientDocs: XIDDocument[] = [];\n\n  for (const participant of participants) {\n    const xid = participant.xid();\n    if (xid.urString() === owner.xid().urString()) {\n      recipientDocs.push(owner.xidDocument());\n    } else {\n      const record = registry.participant(xid);\n      if (record === undefined) {\n        throw new Error(`Participant ${xid.urString()} not found in registry`);\n      }\n      recipientDocs.push(record.xidDocument());\n    }\n  }\n\n  return recipientDocs;\n}\n\n// -----------------------------------------------------------------------------\n// Request building\n// -----------------------------------------------------------------------------\n\n/**\n * Context for building the sign invite request.\n *\n * Port of `struct SignInviteContext` from cmd/sign/coordinator/invite.rs lines 228-237.\n */\nexport interface SignInviteContext {\n  arids: SessionArids;\n  groupId: ARID;\n  targetEnvelope: Envelope;\n  groupRecord: GroupRecord;\n  owner: OwnerRecord;\n  registry: Registry;\n  participants: GroupParticipant[];\n  validUntil: Date;\n}\n\n/**\n * Build the sign invite request.\n *\n * Port of `build_sign_invite_request()` from cmd/sign/coordinator/invite.rs lines 239-284.\n */\nexport function buildSignInviteRequest(ctx: SignInviteContext): SealedRequest {\n  let request = SealedRequest.new(\"signInvite\", ctx.arids.sessionId, ctx.owner.xidDocument())\n    .withParameter(\"group\", ctx.groupId)\n    .withParameter(\"session\", ctx.arids.sessionId)\n    .withParameter(\"target\", ctx.targetEnvelope)\n    .withParameter(\"minSigners\", ctx.groupRecord.minSigners())\n    .withDate(new Date())\n    .withParameter(\"validUntil\", CborDate.fromDatetime(ctx.validUntil));\n\n  for (const participant of ctx.participants) {\n    const xid = participant.xid();\n    const xidKey = xid.urString();\n\n    // Get participant document\n    let participantDoc: XIDDocument;\n    if (xidKey === ctx.owner.xid().urString()) {\n      participantDoc = ctx.owner.xidDocument();\n    } else {\n      const record = ctx.registry.participant(xid);\n      if (record === undefined) {\n        throw new Error(\"Participant not found in registry\");\n      }\n      participantDoc = record.xidDocument();\n    }\n\n    // Get encryption key\n    const encryptionKey = participantDoc.encryptionKey();\n    if (encryptionKey === undefined) {\n      throw new Error(\"Participant XID document has no encryption key\");\n    }\n\n    // Get commit ARID for this participant\n    const responseArid = ctx.arids.commitArids.get(xidKey);\n    if (responseArid === undefined) {\n      throw new Error(\"commit ARID not found for participant\");\n    }\n\n    // Encrypt response ARID to participant\n    // @ts-expect-error TS2339 - API mismatch: toEnvelope/encryptToRecipient methods\n    const encryptedResponseArid = responseArid.toEnvelope().encryptToRecipient(encryptionKey);\n\n    // Build participant entry envelope\n    const participantEntry = Envelope.new(xid).addAssertion(\"response_arid\", encryptedResponseArid);\n\n    request = request.withParameter(\"participant\", participantEntry);\n  }\n\n  return request;\n}\n\n// -----------------------------------------------------------------------------\n// State persistence\n// -----------------------------------------------------------------------------\n\n/**\n * Build the session state JSON for persistence.\n *\n * Port of `build_session_state_json()` from cmd/sign/coordinator/invite.rs lines 290-346.\n */\nexport function buildSessionStateJson(\n  arids: SessionArids,\n  groupId: ARID,\n  groupRecord: GroupRecord,\n  participants: GroupParticipant[],\n  targetEnvelope: Envelope,\n): Record<string, unknown> {\n  const participantsMap: Record<string, unknown> = {};\n\n  for (const participant of participants) {\n    const xid = participant.xid();\n    const xidKey = xid.urString();\n\n    const commitArid = arids.commitArids.get(xidKey);\n    const shareArid = arids.shareArids.get(xidKey);\n\n    if (commitArid === undefined || shareArid === undefined) {\n      throw new Error(\"ARID not found for participant\");\n    }\n\n    participantsMap[xidKey] = {\n      commit_arid: commitArid.urString(),\n      share_arid: shareArid.urString(),\n    };\n  }\n\n  return {\n    session_id: arids.sessionId.urString(),\n    start_arid: arids.startArid.urString(),\n    group: groupId.urString(),\n    min_signers: groupRecord.minSigners(),\n    participants: participantsMap,\n    target: targetEnvelope.urString(),\n  };\n}\n\n/**\n * Persist the session state to disk.\n *\n * Port of `persist_session_state()` from cmd/sign/coordinator/invite.rs lines 348-356.\n */\nexport function persistSessionState(signingDir: string, stateJson: Record<string, unknown>): void {\n  fs.mkdirSync(signingDir, { recursive: true });\n  const startStatePath = path.join(signingDir, \"start.json\");\n  fs.writeFileSync(startStatePath, JSON.stringify(stateJson, null, 2));\n}\n\n// -----------------------------------------------------------------------------\n// File loading\n// -----------------------------------------------------------------------------\n\n/**\n * Load an envelope from a file path.\n *\n * Port of `load_envelope_from_path()` from cmd/sign/coordinator/invite.rs lines 385-392.\n */\nexport function loadEnvelopeFromPath(filePath: string): Envelope {\n  if (!fs.existsSync(filePath)) {\n    throw new Error(`Failed to read target envelope from ${filePath}`);\n  }\n\n  const data = fs.readFileSync(filePath, \"utf-8\");\n  const trimmed = data.trim();\n\n  try {\n    return Envelope.fromURString(trimmed);\n  } catch (e) {\n    throw new Error(`Failed to load target envelope from ${filePath}: ${String(e)}`, { cause: e });\n  }\n}\n\n// -----------------------------------------------------------------------------\n// Options and Result types\n// -----------------------------------------------------------------------------\n\n/**\n * Options for the sign invite command.\n */\nexport interface SignInviteOptions {\n  registryPath?: string;\n  groupId: string;\n  targetFile: string;\n  validDays?: number;\n  verbose?: boolean;\n  preview?: boolean;\n}\n\n/**\n * Result of the sign invite command.\n */\nexport interface SignInviteResult {\n  sessionId: string;\n  startArid: string;\n}\n\n// -----------------------------------------------------------------------------\n// Main invite function\n// -----------------------------------------------------------------------------\n\n/**\n * Execute the sign coordinator invite command.\n *\n * Invites participants to sign a target envelope.\n *\n * Port of `CommandArgs::exec()` from cmd/sign/coordinator/invite.rs lines 44-144.\n */\nexport async function invite(\n  client: StorageClient | undefined,\n  options: SignInviteOptions,\n  cwd: string,\n): Promise<SignInviteResult> {\n  // Validate preview mode\n  if (client !== undefined && options.preview === true) {\n    throw new Error(\"--preview cannot be used with Hubert storage options\");\n  }\n\n  const registryPath = resolveRegistryPath(options.registryPath, cwd);\n  const registry = Registry.load(registryPath);\n\n  const owner = registry.owner();\n  if (owner === undefined) {\n    throw new Error(\"Registry owner is required\");\n  }\n\n  const groupId = parseAridUr(options.groupId);\n  const groupRecord = registry.group(groupId);\n\n  if (groupRecord === undefined) {\n    throw new Error(`Group ${options.groupId} not found in registry`);\n  }\n\n  // Validate sender is coordinator\n  validateCoordinator(groupRecord, owner);\n\n  // Load target envelope\n  const targetPath = path.resolve(cwd, options.targetFile);\n  const targetEnvelope = loadEnvelopeFromPath(targetPath);\n\n  // Get participants\n  const participants = groupRecord.participants();\n\n  // Gather recipient documents\n  const recipientDocs = gatherRecipientDocuments(participants, owner, registry);\n\n  // Get signer keys\n  const signerKeys = owner.xidDocument().inceptionPrivateKeys();\n  if (signerKeys === undefined) {\n    throw new Error(\"Coordinator XID document has no signing keys\");\n  }\n\n  // Generate session ARIDs\n  const sessionArids = createSessionArids(participants);\n\n  // Calculate valid until date (default 1 hour)\n  const validDays = options.validDays ?? 1 / 24; // 1 hour default\n  const validUntil = new Date(Date.now() + validDays * 24 * 60 * 60 * 1000);\n\n  // Build request context\n  const ctx: SignInviteContext = {\n    arids: sessionArids,\n    groupId,\n    targetEnvelope,\n    groupRecord,\n    owner,\n    registry,\n    participants,\n    validUntil,\n  };\n\n  // Build request\n  const request = buildSignInviteRequest(ctx);\n\n  // Build state for persistence\n  const stateJson = buildSessionStateJson(\n    sessionArids,\n    groupId,\n    groupRecord,\n    participants,\n    targetEnvelope,\n  );\n\n  // Build envelope for recipients\n  const recipientRefs = recipientDocs;\n  const sealedEnvelope = request.toEnvelopeForRecipients(validUntil, signerKeys, recipientRefs);\n\n  // Handle preview mode\n  if (options.preview === true) {\n    const unsealed = request.toEnvelope(undefined, signerKeys, undefined);\n    console.log(unsealed.urString());\n    return {\n      sessionId: sessionArids.sessionId.urString(),\n      startArid: sessionArids.startArid.urString(),\n    };\n  }\n\n  // Persist state\n  const signingDir = signingStateDir(registryPath, groupId.hex(), sessionArids.sessionId.hex());\n  persistSessionState(signingDir, stateJson);\n\n  // Post to Hubert storage\n  if (client === undefined) {\n    throw new Error(\"Hubert storage is required for sign start\");\n  }\n\n  await putWithIndicator(\n    client,\n    sessionArids.startArid,\n    sealedEnvelope,\n    \"Signing invite\",\n    options.verbose ?? false,\n  );\n\n  if (options.verbose === true) {\n    console.log(`Session ID: ${sessionArids.sessionId.urString()}`);\n    console.log(`Start ARID: ${sessionArids.startArid.urString()}`);\n  }\n\n  // Output the start ARID\n  console.log(sessionArids.startArid.urString());\n\n  return {\n    sessionId: sessionArids.sessionId.urString(),\n    startArid: sessionArids.startArid.urString(),\n  };\n}\n"],"mappings":"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"}

package/dist/invite-DUTcfTgX.cjs

@@ -0,0 +1,109 @@
+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");
+let _bcts_components = require("@bcts/components");
+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/coordinator/invite.ts
+/**
+* Copyright © 2023-2026 Blockchain Commons, LLC
+* Copyright © 2025-2026 Parity Technologies
+*
+*
+* DKG coordinator invite command.
+*
+* Port of cmd/dkg/coordinator/invite.rs from frost-hubert-rust.
+*
+* @module
+*/
+var invite_exports = /* @__PURE__ */ require_chunk.__exportAll({ invite: () => invite });
+/**
+* Build the DKG invite with validation.
+*
+* Port of `build_invite()` from cmd/dkg/coordinator/invite.rs lines 128-181.
+*/
+function buildInvite(registry, minSignersArg, charter, participantNames, validDays) {
+	const resolved = require_common.resolveParticipants(registry, participantNames);
+	const participantDocs = resolved.map(([, record]) => record.xidDocumentUr());
+	const participantXids = resolved.map(([xid]) => xid);
+	const collectFromArids = participantDocs.map(() => _bcts_components.ARID.new());
+	const pendingRequests = new require_registry_index.PendingRequests();
+	for (let i = 0; i < participantXids.length; i++) pendingRequests.addCollectOnly(participantXids[i], collectFromArids[i]);
+	const participantCount = participantDocs.length;
+	if (participantCount < 2) throw new Error("At least two participants are required for a DKG invite");
+	const minSigners = minSignersArg ?? participantCount;
+	if (minSigners < 2) throw new Error("--min-signers must be at least 2");
+	if (minSigners > participantCount) throw new Error("--min-signers cannot exceed participant count");
+	const sender = require_common.resolveOwnerXidDocument(registry);
+	const now = /* @__PURE__ */ new Date();
+	const validUntil = new Date(Date.now() + validDays * 24 * 60 * 60 * 1e3);
+	return {
+		invite: require_dkg_index.DkgInvite.create(_bcts_components.ARID.new(), sender, _bcts_components.ARID.new(), now, validUntil, minSigners, charter, participantDocs, collectFromArids),
+		participantXids,
+		pendingRequests
+	};
+}
+/**
+* Execute the DKG invite command.
+*
+* Port of `invite()` from cmd/dkg/coordinator/invite.rs.
+*/
+async function invite(client, options, cwd) {
+	const registryPath = require_registry_index.resolveRegistryPath(options.registryPath, cwd);
+	const registry = require_registry_index.Registry.load(registryPath);
+	const { invite: dkgInvite, participantXids, pendingRequests } = buildInvite(registry, options.minSigners, options.charter, options.participantNames, options.validDays);
+	const groupId = dkgInvite.groupId();
+	const requestId = dkgInvite.requestId();
+	const envelope = dkgInvite.toEnvelope();
+	const startArid = _bcts_components.ARID.new();
+	await require_busy.putWithIndicator(client, startArid, envelope, "Sending DKG invite", options.verbose ?? false);
+	const owner = registry.owner();
+	if (!owner) throw new Error("Registry owner is required to issue invites");
+	const coordinator = new require_registry_index.GroupParticipant(owner.xid());
+	const groupParticipants = participantXids.map((xid) => new require_registry_index.GroupParticipant(xid));
+	const groupRecord = new require_registry_index.GroupRecord(options.charter, dkgInvite.minSigners(), coordinator, groupParticipants);
+	groupRecord.setPendingRequests(pendingRequests);
+	registry.recordGroup(groupId, groupRecord);
+	registry.save(registryPath);
+	const stateDir = require_common.dkgStateDir(registryPath, groupId.hex());
+	node_fs.mkdirSync(stateDir, { recursive: true });
+	const inviteState = {
+		group: groupId.urString(),
+		request_id: requestId.urString(),
+		start_arid: startArid.urString(),
+		valid_until: dkgInvite.validUntil().toISOString(),
+		participants: dkgInvite.participants().map((p) => ({
+			xid: p.xid().urString(),
+			response_arid: p.responseArid().urString()
+		}))
+	};
+	node_fs.writeFileSync(node_path.join(stateDir, "invite.json"), JSON.stringify(inviteState, null, 2));
+	if (options.verbose === true) {
+		console.log(`Group ID: ${groupId.urString()}`);
+		console.log(`Start ARID: ${startArid.urString()}`);
+	}
+	return {
+		groupId,
+		requestId,
+		envelopeUr: envelope.urString()
+	};
+}
+//#endregion
+Object.defineProperty(exports, "invite", {
+	enumerable: true,
+	get: function() {
+		return invite;
+	}
+});
+Object.defineProperty(exports, "invite_exports", {
+	enumerable: true,
+	get: function() {
+		return invite_exports;
+	}
+});
+
+//# sourceMappingURL=invite-DUTcfTgX.cjs.map

package/dist/invite-DUTcfTgX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invite-DUTcfTgX.cjs","names":["resolveParticipants","ARID","PendingRequests","resolveOwnerXidDocument","DkgInvite","resolveRegistryPath","Registry","putWithIndicator","GroupParticipant","GroupRecord","dkgStateDir","path"],"sources":["../src/cmd/dkg/coordinator/invite.ts"],"sourcesContent":["/**\n * Copyright © 2023-2026 Blockchain Commons, LLC\n * Copyright © 2025-2026 Parity Technologies\n *\n *\n * DKG coordinator invite command.\n *\n * Port of cmd/dkg/coordinator/invite.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, type XID } from \"@bcts/components\";\n\nimport { DkgInvite } from \"../../../dkg/index.js\";\nimport {\n  GroupParticipant,\n  GroupRecord,\n  PendingRequests,\n  Registry,\n  resolveRegistryPath,\n} from \"../../../registry/index.js\";\nimport { putWithIndicator } from \"../../busy.js\";\nimport { type StorageClient } from \"../../storage.js\";\nimport { dkgStateDir, resolveOwnerXidDocument, resolveParticipants } from \"../common.js\";\n\n/**\n * Options for the DKG invite command.\n */\nexport interface DkgInviteOptions {\n  registryPath?: string;\n  minSigners?: number;\n  charter: string;\n  validDays: number;\n  participantNames: string[];\n  verbose?: boolean;\n}\n\n/**\n * Result of the DKG invite command.\n */\nexport interface DkgInviteResult {\n  groupId: ARID;\n  requestId: ARID;\n  envelopeUr: string;\n}\n\n/**\n * Internal data structure for building an invite.\n *\n * Port of `InviteData` struct from cmd/dkg/coordinator/invite.rs lines 122-126.\n */\ninterface InviteData {\n  invite: DkgInvite;\n  participantXids: XID[];\n  pendingRequests: PendingRequests;\n}\n\n/**\n * Build the DKG invite with validation.\n *\n * Port of `build_invite()` from cmd/dkg/coordinator/invite.rs lines 128-181.\n */\nfunction buildInvite(\n  registry: Registry,\n  minSignersArg: number | undefined,\n  charter: string,\n  participantNames: string[],\n  validDays: number,\n): InviteData {\n  // Resolve participants using the common utility\n  const resolved = resolveParticipants(registry, participantNames);\n  const participantDocs: string[] = resolved.map(([, record]) => record.xidDocumentUr());\n  const participantXids: XID[] = resolved.map(([xid]) => xid);\n\n  // These are the ARIDs where participants will post their invite responses\n  const collectFromArids: ARID[] = participantDocs.map(() => ARID.new());\n\n  // Build pending_requests: coordinator will collect invite responses from these ARIDs\n  const pendingRequests = new PendingRequests();\n  for (let i = 0; i < participantXids.length; i++) {\n    pendingRequests.addCollectOnly(participantXids[i], collectFromArids[i]);\n  }\n\n  // Validate participant count\n  const participantCount = participantDocs.length;\n  if (participantCount < 2) {\n    throw new Error(\"At least two participants are required for a DKG invite\");\n  }\n\n  // Validate and default minSigners\n  const minSigners = minSignersArg ?? participantCount;\n  if (minSigners < 2) {\n    throw new Error(\"--min-signers must be at least 2\");\n  }\n  if (minSigners > participantCount) {\n    throw new Error(\"--min-signers cannot exceed participant count\");\n  }\n\n  // Get sender (registry owner)\n  // The coordinator's invite always identifies the registry owner as\n  // the sender. (Rust reads `registry.owner()` directly here too —\n  // see `cmd/dkg/coordinator/invite.rs:74-77`.)\n  const sender = resolveOwnerXidDocument(registry);\n\n  // Calculate dates\n  const now = new Date();\n  const validUntil = new Date(Date.now() + validDays * 24 * 60 * 60 * 1000);\n\n  // Create the invite\n  const invite = DkgInvite.create(\n    ARID.new(), // requestId\n    sender,\n    ARID.new(), // groupId\n    now,\n    validUntil,\n    minSigners,\n    charter,\n    participantDocs,\n    collectFromArids,\n  );\n\n  return { invite, participantXids, pendingRequests };\n}\n\n/**\n * Execute the DKG invite command.\n *\n * Port of `invite()` from cmd/dkg/coordinator/invite.rs.\n */\nexport async function invite(\n  client: StorageClient,\n  options: DkgInviteOptions,\n  cwd: string,\n): Promise<DkgInviteResult> {\n  const registryPath = resolveRegistryPath(options.registryPath, cwd);\n  const registry = Registry.load(registryPath);\n\n  // Build the invite with validation\n  const inviteData = buildInvite(\n    registry,\n    options.minSigners,\n    options.charter,\n    options.participantNames,\n    options.validDays,\n  );\n\n  const { invite: dkgInvite, participantXids, pendingRequests } = inviteData;\n  const groupId = dkgInvite.groupId();\n  const requestId = dkgInvite.requestId();\n\n  // Create sealed envelope\n  const envelope = dkgInvite.toEnvelope();\n\n  // Send to storage\n  const startArid = ARID.new();\n  await putWithIndicator(\n    client,\n    startArid,\n    envelope,\n    \"Sending DKG invite\",\n    options.verbose ?? false,\n  );\n\n  // Save group record to registry\n  const owner = registry.owner();\n  if (!owner) {\n    throw new Error(\"Registry owner is required to issue invites\");\n  }\n\n  const coordinator = new GroupParticipant(owner.xid());\n  const groupParticipants = participantXids.map((xid) => new GroupParticipant(xid));\n\n  const groupRecord = new GroupRecord(\n    options.charter,\n    dkgInvite.minSigners(),\n    coordinator,\n    groupParticipants,\n  );\n\n  // Track pending requests\n  groupRecord.setPendingRequests(pendingRequests);\n\n  // Use recordGroup() for proper merge behavior\n  registry.recordGroup(groupId, groupRecord);\n  registry.save(registryPath);\n\n  // Save invite state\n  const stateDir = dkgStateDir(registryPath, groupId.hex());\n  fs.mkdirSync(stateDir, { recursive: true });\n\n  const inviteState: {\n    group: string;\n    request_id: string;\n    start_arid: string;\n    valid_until: string;\n    participants: { xid: string; response_arid: string }[];\n  } = {\n    group: groupId.urString(),\n    request_id: requestId.urString(),\n    start_arid: startArid.urString(),\n    valid_until: dkgInvite.validUntil().toISOString(),\n    participants: dkgInvite.participants().map((p) => ({\n      xid: p.xid().urString(),\n      response_arid: p.responseArid().urString(),\n    })),\n  };\n\n  fs.writeFileSync(path.join(stateDir, \"invite.json\"), JSON.stringify(inviteState, null, 2));\n\n  if (options.verbose === true) {\n    console.log(`Group ID: ${groupId.urString()}`);\n    console.log(`Start ARID: ${startArid.urString()}`);\n  }\n\n  return {\n    groupId,\n    requestId,\n    envelopeUr: envelope.urString(),\n  };\n}\n"],"mappings":"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"}

package/dist/invite-IU4n0dq2.mjs

@@ -0,0 +1,96 @@
+import { t as __exportAll } from "./chunk-CjcI7cDX.mjs";
+import { DkgInvite } from "./dkg/index.mjs";
+import { GroupParticipant, GroupRecord, PendingRequests, Registry, resolveRegistryPath } from "./registry/index.mjs";
+import { a as dkgStateDir, d as resolveOwnerXidDocument, f as resolveParticipants } from "./common-CvH6dFvQ.mjs";
+import { n as putWithIndicator } from "./busy-DkM2jAIZ.mjs";
+import { ARID } from "@bcts/components";
+import * as fs from "node:fs";
+import * as path from "node:path";
+//#region src/cmd/dkg/coordinator/invite.ts
+/**
+* Copyright © 2023-2026 Blockchain Commons, LLC
+* Copyright © 2025-2026 Parity Technologies
+*
+*
+* DKG coordinator invite command.
+*
+* Port of cmd/dkg/coordinator/invite.rs from frost-hubert-rust.
+*
+* @module
+*/
+var invite_exports = /* @__PURE__ */ __exportAll({ invite: () => invite });
+/**
+* Build the DKG invite with validation.
+*
+* Port of `build_invite()` from cmd/dkg/coordinator/invite.rs lines 128-181.
+*/
+function buildInvite(registry, minSignersArg, charter, participantNames, validDays) {
+	const resolved = resolveParticipants(registry, participantNames);
+	const participantDocs = resolved.map(([, record]) => record.xidDocumentUr());
+	const participantXids = resolved.map(([xid]) => xid);
+	const collectFromArids = participantDocs.map(() => ARID.new());
+	const pendingRequests = new PendingRequests();
+	for (let i = 0; i < participantXids.length; i++) pendingRequests.addCollectOnly(participantXids[i], collectFromArids[i]);
+	const participantCount = participantDocs.length;
+	if (participantCount < 2) throw new Error("At least two participants are required for a DKG invite");
+	const minSigners = minSignersArg ?? participantCount;
+	if (minSigners < 2) throw new Error("--min-signers must be at least 2");
+	if (minSigners > participantCount) throw new Error("--min-signers cannot exceed participant count");
+	const sender = resolveOwnerXidDocument(registry);
+	const now = /* @__PURE__ */ new Date();
+	const validUntil = new Date(Date.now() + validDays * 24 * 60 * 60 * 1e3);
+	return {
+		invite: DkgInvite.create(ARID.new(), sender, ARID.new(), now, validUntil, minSigners, charter, participantDocs, collectFromArids),
+		participantXids,
+		pendingRequests
+	};
+}
+/**
+* Execute the DKG invite command.
+*
+* Port of `invite()` from cmd/dkg/coordinator/invite.rs.
+*/
+async function invite(client, options, cwd) {
+	const registryPath = resolveRegistryPath(options.registryPath, cwd);
+	const registry = Registry.load(registryPath);
+	const { invite: dkgInvite, participantXids, pendingRequests } = buildInvite(registry, options.minSigners, options.charter, options.participantNames, options.validDays);
+	const groupId = dkgInvite.groupId();
+	const requestId = dkgInvite.requestId();
+	const envelope = dkgInvite.toEnvelope();
+	const startArid = ARID.new();
+	await putWithIndicator(client, startArid, envelope, "Sending DKG invite", options.verbose ?? false);
+	const owner = registry.owner();
+	if (!owner) throw new Error("Registry owner is required to issue invites");
+	const coordinator = new GroupParticipant(owner.xid());
+	const groupParticipants = participantXids.map((xid) => new GroupParticipant(xid));
+	const groupRecord = new GroupRecord(options.charter, dkgInvite.minSigners(), coordinator, groupParticipants);
+	groupRecord.setPendingRequests(pendingRequests);
+	registry.recordGroup(groupId, groupRecord);
+	registry.save(registryPath);
+	const stateDir = dkgStateDir(registryPath, groupId.hex());
+	fs.mkdirSync(stateDir, { recursive: true });
+	const inviteState = {
+		group: groupId.urString(),
+		request_id: requestId.urString(),
+		start_arid: startArid.urString(),
+		valid_until: dkgInvite.validUntil().toISOString(),
+		participants: dkgInvite.participants().map((p) => ({
+			xid: p.xid().urString(),
+			response_arid: p.responseArid().urString()
+		}))
+	};
+	fs.writeFileSync(path.join(stateDir, "invite.json"), JSON.stringify(inviteState, null, 2));
+	if (options.verbose === true) {
+		console.log(`Group ID: ${groupId.urString()}`);
+		console.log(`Start ARID: ${startArid.urString()}`);
+	}
+	return {
+		groupId,
+		requestId,
+		envelopeUr: envelope.urString()
+	};
+}
+//#endregion
+export { invite_exports as n, invite as t };
+
+//# sourceMappingURL=invite-IU4n0dq2.mjs.map

package/dist/invite-IU4n0dq2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invite-IU4n0dq2.mjs","names":[],"sources":["../src/cmd/dkg/coordinator/invite.ts"],"sourcesContent":["/**\n * Copyright © 2023-2026 Blockchain Commons, LLC\n * Copyright © 2025-2026 Parity Technologies\n *\n *\n * DKG coordinator invite command.\n *\n * Port of cmd/dkg/coordinator/invite.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, type XID } from \"@bcts/components\";\n\nimport { DkgInvite } from \"../../../dkg/index.js\";\nimport {\n  GroupParticipant,\n  GroupRecord,\n  PendingRequests,\n  Registry,\n  resolveRegistryPath,\n} from \"../../../registry/index.js\";\nimport { putWithIndicator } from \"../../busy.js\";\nimport { type StorageClient } from \"../../storage.js\";\nimport { dkgStateDir, resolveOwnerXidDocument, resolveParticipants } from \"../common.js\";\n\n/**\n * Options for the DKG invite command.\n */\nexport interface DkgInviteOptions {\n  registryPath?: string;\n  minSigners?: number;\n  charter: string;\n  validDays: number;\n  participantNames: string[];\n  verbose?: boolean;\n}\n\n/**\n * Result of the DKG invite command.\n */\nexport interface DkgInviteResult {\n  groupId: ARID;\n  requestId: ARID;\n  envelopeUr: string;\n}\n\n/**\n * Internal data structure for building an invite.\n *\n * Port of `InviteData` struct from cmd/dkg/coordinator/invite.rs lines 122-126.\n */\ninterface InviteData {\n  invite: DkgInvite;\n  participantXids: XID[];\n  pendingRequests: PendingRequests;\n}\n\n/**\n * Build the DKG invite with validation.\n *\n * Port of `build_invite()` from cmd/dkg/coordinator/invite.rs lines 128-181.\n */\nfunction buildInvite(\n  registry: Registry,\n  minSignersArg: number | undefined,\n  charter: string,\n  participantNames: string[],\n  validDays: number,\n): InviteData {\n  // Resolve participants using the common utility\n  const resolved = resolveParticipants(registry, participantNames);\n  const participantDocs: string[] = resolved.map(([, record]) => record.xidDocumentUr());\n  const participantXids: XID[] = resolved.map(([xid]) => xid);\n\n  // These are the ARIDs where participants will post their invite responses\n  const collectFromArids: ARID[] = participantDocs.map(() => ARID.new());\n\n  // Build pending_requests: coordinator will collect invite responses from these ARIDs\n  const pendingRequests = new PendingRequests();\n  for (let i = 0; i < participantXids.length; i++) {\n    pendingRequests.addCollectOnly(participantXids[i], collectFromArids[i]);\n  }\n\n  // Validate participant count\n  const participantCount = participantDocs.length;\n  if (participantCount < 2) {\n    throw new Error(\"At least two participants are required for a DKG invite\");\n  }\n\n  // Validate and default minSigners\n  const minSigners = minSignersArg ?? participantCount;\n  if (minSigners < 2) {\n    throw new Error(\"--min-signers must be at least 2\");\n  }\n  if (minSigners > participantCount) {\n    throw new Error(\"--min-signers cannot exceed participant count\");\n  }\n\n  // Get sender (registry owner)\n  // The coordinator's invite always identifies the registry owner as\n  // the sender. (Rust reads `registry.owner()` directly here too —\n  // see `cmd/dkg/coordinator/invite.rs:74-77`.)\n  const sender = resolveOwnerXidDocument(registry);\n\n  // Calculate dates\n  const now = new Date();\n  const validUntil = new Date(Date.now() + validDays * 24 * 60 * 60 * 1000);\n\n  // Create the invite\n  const invite = DkgInvite.create(\n    ARID.new(), // requestId\n    sender,\n    ARID.new(), // groupId\n    now,\n    validUntil,\n    minSigners,\n    charter,\n    participantDocs,\n    collectFromArids,\n  );\n\n  return { invite, participantXids, pendingRequests };\n}\n\n/**\n * Execute the DKG invite command.\n *\n * Port of `invite()` from cmd/dkg/coordinator/invite.rs.\n */\nexport async function invite(\n  client: StorageClient,\n  options: DkgInviteOptions,\n  cwd: string,\n): Promise<DkgInviteResult> {\n  const registryPath = resolveRegistryPath(options.registryPath, cwd);\n  const registry = Registry.load(registryPath);\n\n  // Build the invite with validation\n  const inviteData = buildInvite(\n    registry,\n    options.minSigners,\n    options.charter,\n    options.participantNames,\n    options.validDays,\n  );\n\n  const { invite: dkgInvite, participantXids, pendingRequests } = inviteData;\n  const groupId = dkgInvite.groupId();\n  const requestId = dkgInvite.requestId();\n\n  // Create sealed envelope\n  const envelope = dkgInvite.toEnvelope();\n\n  // Send to storage\n  const startArid = ARID.new();\n  await putWithIndicator(\n    client,\n    startArid,\n    envelope,\n    \"Sending DKG invite\",\n    options.verbose ?? false,\n  );\n\n  // Save group record to registry\n  const owner = registry.owner();\n  if (!owner) {\n    throw new Error(\"Registry owner is required to issue invites\");\n  }\n\n  const coordinator = new GroupParticipant(owner.xid());\n  const groupParticipants = participantXids.map((xid) => new GroupParticipant(xid));\n\n  const groupRecord = new GroupRecord(\n    options.charter,\n    dkgInvite.minSigners(),\n    coordinator,\n    groupParticipants,\n  );\n\n  // Track pending requests\n  groupRecord.setPendingRequests(pendingRequests);\n\n  // Use recordGroup() for proper merge behavior\n  registry.recordGroup(groupId, groupRecord);\n  registry.save(registryPath);\n\n  // Save invite state\n  const stateDir = dkgStateDir(registryPath, groupId.hex());\n  fs.mkdirSync(stateDir, { recursive: true });\n\n  const inviteState: {\n    group: string;\n    request_id: string;\n    start_arid: string;\n    valid_until: string;\n    participants: { xid: string; response_arid: string }[];\n  } = {\n    group: groupId.urString(),\n    request_id: requestId.urString(),\n    start_arid: startArid.urString(),\n    valid_until: dkgInvite.validUntil().toISOString(),\n    participants: dkgInvite.participants().map((p) => ({\n      xid: p.xid().urString(),\n      response_arid: p.responseArid().urString(),\n    })),\n  };\n\n  fs.writeFileSync(path.join(stateDir, \"invite.json\"), JSON.stringify(inviteState, null, 2));\n\n  if (options.verbose === true) {\n    console.log(`Group ID: ${groupId.urString()}`);\n    console.log(`Start ARID: ${startArid.urString()}`);\n  }\n\n  return {\n    groupId,\n    requestId,\n    envelopeUr: envelope.urString(),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,SAAS,YACP,UACA,eACA,SACA,kBACA,WACY;CAEZ,MAAM,WAAW,oBAAoB,UAAU,iBAAiB;CAChE,MAAM,kBAA4B,SAAS,KAAK,GAAG,YAAY,OAAO,eAAe,CAAC;CACtF,MAAM,kBAAyB,SAAS,KAAK,CAAC,SAAS,IAAI;CAG3D,MAAM,mBAA2B,gBAAgB,UAAU,KAAK,KAAK,CAAC;CAGtE,MAAM,kBAAkB,IAAI,iBAAiB;AAC7C,MAAK,IAAI,IAAI,GAAG,IAAI,gBAAgB,QAAQ,IAC1C,iBAAgB,eAAe,gBAAgB,IAAI,iBAAiB,GAAG;CAIzE,MAAM,mBAAmB,gBAAgB;AACzC,KAAI,mBAAmB,EACrB,OAAM,IAAI,MAAM,0DAA0D;CAI5E,MAAM,aAAa,iBAAiB;AACpC,KAAI,aAAa,EACf,OAAM,IAAI,MAAM,mCAAmC;AAErD,KAAI,aAAa,iBACf,OAAM,IAAI,MAAM,gDAAgD;CAOlE,MAAM,SAAS,wBAAwB,SAAS;CAGhD,MAAM,sBAAM,IAAI,MAAM;CACtB,MAAM,aAAa,IAAI,KAAK,KAAK,KAAK,GAAG,YAAY,KAAK,KAAK,KAAK,IAAK;AAezE,QAAO;EAAE,QAZM,UAAU,OACvB,KAAK,KAAK,EACV,QACA,KAAK,KAAK,EACV,KACA,YACA,YACA,SACA,iBACA,iBAGa;EAAE;EAAiB;EAAiB;;;;;;;AAQrD,eAAsB,OACpB,QACA,SACA,KAC0B;CAC1B,MAAM,eAAe,oBAAoB,QAAQ,cAAc,IAAI;CACnE,MAAM,WAAW,SAAS,KAAK,aAAa;CAW5C,MAAM,EAAE,QAAQ,WAAW,iBAAiB,oBARzB,YACjB,UACA,QAAQ,YACR,QAAQ,SACR,QAAQ,kBACR,QAAQ,UAGgE;CAC1E,MAAM,UAAU,UAAU,SAAS;CACnC,MAAM,YAAY,UAAU,WAAW;CAGvC,MAAM,WAAW,UAAU,YAAY;CAGvC,MAAM,YAAY,KAAK,KAAK;AAC5B,OAAM,iBACJ,QACA,WACA,UACA,sBACA,QAAQ,WAAW,MACpB;CAGD,MAAM,QAAQ,SAAS,OAAO;AAC9B,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,8CAA8C;CAGhE,MAAM,cAAc,IAAI,iBAAiB,MAAM,KAAK,CAAC;CACrD,MAAM,oBAAoB,gBAAgB,KAAK,QAAQ,IAAI,iBAAiB,IAAI,CAAC;CAEjF,MAAM,cAAc,IAAI,YACtB,QAAQ,SACR,UAAU,YAAY,EACtB,aACA,kBACD;AAGD,aAAY,mBAAmB,gBAAgB;AAG/C,UAAS,YAAY,SAAS,YAAY;AAC1C,UAAS,KAAK,aAAa;CAG3B,MAAM,WAAW,YAAY,cAAc,QAAQ,KAAK,CAAC;AACzD,IAAG,UAAU,UAAU,EAAE,WAAW,MAAM,CAAC;CAE3C,MAAM,cAMF;EACF,OAAO,QAAQ,UAAU;EACzB,YAAY,UAAU,UAAU;EAChC,YAAY,UAAU,UAAU;EAChC,aAAa,UAAU,YAAY,CAAC,aAAa;EACjD,cAAc,UAAU,cAAc,CAAC,KAAK,OAAO;GACjD,KAAK,EAAE,KAAK,CAAC,UAAU;GACvB,eAAe,EAAE,cAAc,CAAC,UAAU;GAC3C,EAAE;EACJ;AAED,IAAG,cAAc,KAAK,KAAK,UAAU,cAAc,EAAE,KAAK,UAAU,aAAa,MAAM,EAAE,CAAC;AAE1F,KAAI,QAAQ,YAAY,MAAM;AAC5B,UAAQ,IAAI,aAAa,QAAQ,UAAU,GAAG;AAC9C,UAAQ,IAAI,eAAe,UAAU,UAAU,GAAG;;AAGpD,QAAO;EACL;EACA;EACA,YAAY,SAAS,UAAU;EAChC"}