@did-btcr2/cli 0.22.0 → 0.23.1

package/dist/esm/src/genesis-document-file.js

@@ -0,0 +1,26 @@
+import { readFile } from 'node:fs/promises';
+import { CLIError } from './error.js';
+/** The help text of `--genesis-document`. `resolve`, `update`, and `deactivate` share it. */
+export const GENESIS_DOCUMENT_HELP = 'Path to the JSON genesis document of an external identifier (x). '
+    + 'Fills sidecar.genesisDocument of the resolution options';
+/**
+ * Reads and parses a genesis document file. The content must be a JSON
+ * object. The shape of the document is checked by the api, not here.
+ * @param path The path of the JSON file.
+ * @returns The parsed object.
+ * @throws {CLIError} If the file is unreadable, not JSON, or not an object.
+ */
+export async function readGenesisDocumentFile(path) {
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(path, 'utf-8'));
+    }
+    catch {
+        throw new CLIError('Invalid genesis document path. Must be a valid path to a JSON file.', 'INVALID_ARGUMENT_ERROR', { genesisDocument: path });
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new CLIError('Invalid genesis document. The file must contain a JSON object.', 'INVALID_ARGUMENT_ERROR', { genesisDocument: path });
+    }
+    return parsed;
+}
+//# sourceMappingURL=genesis-document-file.js.map

package/dist/esm/src/genesis-document-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis-document-file.js","sourceRoot":"","sources":["../../../src/genesis-document-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,qBAAqB,GAChC,mEAAmE;MACjE,yDAAyD,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAY;IACxD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAChB,qEAAqE,EACrE,wBAAwB,EACxB,EAAE,eAAe,EAAE,IAAI,EAAE,CAC1B,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,QAAQ,CAChB,gEAAgE,EAChE,wBAAwB,EACxB,EAAE,eAAe,EAAE,IAAI,EAAE,CAC1B,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/src/genesis-spec.js

@@ -0,0 +1,93 @@
+import { hexToBytes } from '@noble/hashes/utils.js';
+import { CLIError } from './error.js';
+/**
+ * Checks the shape of a parsed genesis spec file. The values (relationship
+ * names, beacon types, addresses) are checked by the api when it builds the
+ * document; this function checks only what the api cannot see: that each
+ * verification method names exactly one key source, and that each beacon
+ * names at most one.
+ * @param value The parsed JSON value.
+ * @param source The file path, for the error data.
+ * @returns The spec.
+ * @throws {CLIError} If the shape is not valid.
+ */
+export function parseGenesisSpec(value, source) {
+    const fail = (message) => {
+        throw new CLIError(`Invalid genesis spec: ${message}`, 'INVALID_ARGUMENT_ERROR', { spec: source });
+    };
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        return fail('the file must contain a JSON object.');
+    }
+    const spec = value;
+    if (!Array.isArray(spec.verificationMethods) || spec.verificationMethods.length === 0) {
+        return fail('"verificationMethods" must be a non-empty array.');
+    }
+    spec.verificationMethods.forEach((vm, index) => {
+        if (vm === null || typeof vm !== 'object')
+            return fail(`verificationMethods[${index}] must be an object.`);
+        const hasKey = typeof vm.key === 'string' && vm.key.length > 0;
+        const hasPublicKey = typeof vm.publicKey === 'string' && vm.publicKey.length > 0;
+        if (hasKey === hasPublicKey) {
+            return fail(`verificationMethods[${index}] needs exactly one of "key" (a keystore reference) or "publicKey" (hex).`);
+        }
+    });
+    if (spec.beacons !== undefined) {
+        if (!Array.isArray(spec.beacons))
+            return fail('"beacons" must be an array.');
+        spec.beacons.forEach((beacon, index) => {
+            if (beacon === null || typeof beacon !== 'object')
+                return fail(`beacons[${index}] must be an object.`);
+            const sources = ['key', 'publicKey', 'address'].filter(name => beacon[name] !== undefined);
+            if (sources.length > 1) {
+                return fail(`beacons[${index}] names ${sources.join(' and ')}. Give only one of "key", "publicKey", or "address".`);
+            }
+        });
+    }
+    if (spec.services !== undefined && !Array.isArray(spec.services)) {
+        return fail('"services" must be an array.');
+    }
+    return spec;
+}
+/**
+ * Converts a genesis spec file to the api spec: resolves each keystore
+ * reference to its public key, parses each hex public key, and passes the
+ * other values through for the api to check.
+ * @param spec The spec file.
+ * @param network The network of the beacon addresses.
+ * @param resolvePublicKey Resolves a keystore reference to the public key.
+ * @returns The api spec.
+ * @throws {CLIError} If a hex public key is not hex.
+ */
+export function toApiSpec(spec, network, resolvePublicKey) {
+    const keyBytes = (entry, label) => entry.key !== undefined ? resolvePublicKey(entry.key) : parseHexPublicKey(entry.publicKey, label);
+    const verificationMethods = spec.verificationMethods.map((vm, index) => ({
+        publicKey: keyBytes(vm, `verificationMethods[${index}].publicKey`),
+        relationships: vm.relationships,
+        fragment: vm.fragment,
+    }));
+    const beacons = spec.beacons?.map((beacon, index) => ({
+        type: beacon.type,
+        publicKey: beacon.key !== undefined || beacon.publicKey !== undefined
+            ? keyBytes(beacon, `beacons[${index}].publicKey`)
+            : undefined,
+        addressType: beacon.addressType,
+        address: beacon.address,
+        fragment: beacon.fragment,
+    }));
+    return {
+        network,
+        verificationMethods,
+        beacons,
+        services: spec.services,
+    };
+}
+/** Parses a hex public key. The length and the curve check belong to the api. */
+export function parseHexPublicKey(hex, label) {
+    try {
+        return hexToBytes(hex.trim());
+    }
+    catch {
+        throw new CLIError(`Invalid ${label}: not valid hex.`, 'INVALID_ARGUMENT_ERROR', { publicKey: hex });
+    }
+}
+//# sourceMappingURL=genesis-spec.js.map

package/dist/esm/src/genesis-spec.js.map

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

package/dist/esm/src/genesis-wizard.js

@@ -0,0 +1,132 @@
+import { BEACON_ADDRESS_TYPES, BEACON_TYPES, DEFAULT_BEACON_ADDRESS_TYPE, VERIFICATION_RELATIONSHIPS } from '@did-btcr2/api';
+/** A 33-byte compressed public key as hex. */
+const PUBLIC_KEY_HEX = /^0[23][0-9a-fA-F]{64}$/;
+/**
+ * Collects a genesis spec through questions: the verification methods with
+ * their relationships, the beacons, and the other services. The answers are
+ * not checked against the network here; the api checks them when it builds
+ * the document, and the command reports the failure.
+ * @param ask Asks one question.
+ * @param ctx The output, the key list, and the key resolver.
+ * @returns The spec.
+ */
+export async function collectGenesisSpec(ask, ctx) {
+    const verificationMethods = await collectVerificationMethods(ask, ctx);
+    const beacons = await collectBeacons(ask, ctx, verificationMethods[0]);
+    const services = await collectServices(ask, ctx);
+    return { verificationMethods, beacons, ...(services.length > 0 && { services }) };
+}
+/** Asks for the verification methods. The first one defaults to the active key. */
+async function collectVerificationMethods(ask, ctx) {
+    if (ctx.keys.length === 0) {
+        ctx.say('The keystore has no keys. Enter each key as a 33-byte compressed public key in hex.');
+    }
+    else {
+        ctx.say('Keys in the keystore:');
+        for (const key of ctx.keys) {
+            ctx.say(`  ${key.fingerprint}${key.name ? `  ${key.name}` : ''}${key.active ? '  (active)' : ''}`);
+        }
+    }
+    const active = ctx.keys.find(key => key.active);
+    const methods = [];
+    for (let n = 1;; n++) {
+        const defaultRef = n === 1 && active ? (active.name ?? active.fingerprint) : undefined;
+        const source = await askKeySource(ask, ctx, `Verification method ${n}: key reference or public key hex`, defaultRef);
+        const relationships = await askRelationships(ask, ctx, n);
+        methods.push({ ...source, ...(relationships && { relationships }) });
+        if (!(await askYesNo(ask, 'Add another verification method?')))
+            break;
+    }
+    return methods;
+}
+/** Asks for the beacons. The first one defaults to a Singleton beacon on the first key. */
+async function collectBeacons(ask, ctx, firstMethod) {
+    const beacons = [];
+    for (let n = 1;; n++) {
+        const type = await askChoice(ask, ctx, `Beacon ${n} type`, BEACON_TYPES, 'SingletonBeacon');
+        const address = (await ask(`Beacon ${n} address (blank: derive the address from the key of method 1): `)).trim();
+        if (address.length === 0) {
+            const addressType = await askChoice(ask, ctx, `Beacon ${n} address type`, BEACON_ADDRESS_TYPES, DEFAULT_BEACON_ADDRESS_TYPE);
+            const keySource = firstMethod.key !== undefined ? { key: firstMethod.key } : { publicKey: firstMethod.publicKey };
+            beacons.push({ type, ...keySource, addressType });
+        }
+        else {
+            beacons.push({ type, address });
+        }
+        if (!(await askYesNo(ask, 'Add another beacon?')))
+            break;
+    }
+    return beacons;
+}
+/** Asks for the other services, if any. */
+async function collectServices(ask, ctx) {
+    const services = [];
+    while (await askYesNo(ask, 'Add a service?')) {
+        const n = services.length + 1;
+        const fragment = (await ask(`Service ${n} id fragment (blank: service-<position>): `)).trim();
+        const type = await askRequired(ask, ctx, `Service ${n} type`);
+        const serviceEndpoint = await askRequired(ask, ctx, `Service ${n} endpoint`);
+        services.push({ ...(fragment.length > 0 && { id: `#${fragment.replace(/^#/, '')}` }), type, serviceEndpoint });
+    }
+    return services;
+}
+/** Asks for a key reference or a public key hex, until the answer resolves. */
+async function askKeySource(ask, ctx, question, defaultRef) {
+    for (;;) {
+        const raw = (await ask(`${question}${defaultRef ? ` [${defaultRef}]` : ''}: `)).trim();
+        const answer = raw.length > 0 ? raw : defaultRef;
+        if (answer === undefined) {
+            ctx.say('A key is required.');
+            continue;
+        }
+        if (PUBLIC_KEY_HEX.test(answer))
+            return { publicKey: answer.toLowerCase() };
+        try {
+            ctx.resolveKey(answer);
+            return { key: answer };
+        }
+        catch (error) {
+            ctx.say(error.message);
+        }
+    }
+}
+/** Asks for the relationships of a method. Blank means all four (the api default). */
+async function askRelationships(ask, ctx, n) {
+    const names = VERIFICATION_RELATIONSHIPS.join(', ');
+    for (;;) {
+        const raw = (await ask(`Relationships of method ${n} (comma-separated: ${names}) [all]: `)).trim();
+        if (raw.length === 0)
+            return undefined;
+        const chosen = raw.split(',').map(s => s.trim()).filter(s => s.length > 0);
+        const unknown = chosen.filter(name => !VERIFICATION_RELATIONSHIPS.includes(name));
+        if (unknown.length === 0)
+            return chosen;
+        ctx.say(`Unknown relationship: ${unknown.join(', ')}. Expected one of ${names}.`);
+    }
+}
+/** Asks for one value of a list, with a default. */
+async function askChoice(ask, ctx, question, choices, defaultValue) {
+    for (;;) {
+        const raw = (await ask(`${question} (${choices.join(', ')}) [${defaultValue}]: `)).trim();
+        if (raw.length === 0)
+            return defaultValue;
+        if (choices.includes(raw))
+            return raw;
+        ctx.say(`Unknown value "${raw}". Expected one of ${choices.join(', ')}.`);
+    }
+}
+/** Asks for a non-empty value. */
+async function askRequired(ask, ctx, question) {
+    for (;;) {
+        const raw = (await ask(`${question}: `)).trim();
+        if (raw.length > 0)
+            return raw;
+        ctx.say('A value is required.');
+    }
+}
+/** Asks a yes/no question. Blank means no. */
+async function askYesNo(ask, question) {
+    const raw = (await ask(`${question} [y/N]: `)).trim();
+    return /^y(es)?$/i.test(raw);
+}
+//# sourceMappingURL=genesis-wizard.js.map

package/dist/esm/src/genesis-wizard.js.map

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

package/dist/esm/src/hints.js

@@ -18,9 +18,6 @@ import { BeaconUtils } from '@did-btcr2/method';
 export function printCreateFundingHint(g, network, did) {
     if (g.quiet || g.output === 'json')
         return;
-    const faucet = faucetUrl(network);
-    if (!faucet)
-        return;
     let beaconAddress;
     try {
         const { serviceEndpoint } = BeaconUtils.createBeaconService(did, 'p2wpkh', 'SingletonBeacon');
@@ -29,6 +26,20 @@ export function printCreateFundingHint(g, network, did) {
     catch {
         return;
     }
+    printBeaconFundingHint(g, network, beaconAddress);
+}
+/**
+ * Prints a funding hint for a beacon address on a network with a public
+ * faucet: the address next to the faucet and explorer links. A no-op on a
+ * network without a faucet (regtest/mainnet). `create -t x --document` and
+ * `genesis build` use it for the first beacon of the genesis document.
+ */
+export function printBeaconFundingHint(g, network, beaconAddress) {
+    if (g.quiet || g.output === 'json')
+        return;
+    const faucet = faucetUrl(network);
+    if (!faucet)
+        return;
     const explorer = explorerAddressUrl(network, beaconAddress);
     const lines = [
         'Fund the initial beacon to anchor updates:',

package/dist/esm/src/hints.js.map

@@ -1 +1 @@
-{"version":3,"file":"hints.js","sourceRoot":"","sources":["../../../src/hints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,CAAgB,EAAE,OAAsB,EAAE,GAAW;IAC1F,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO;IAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,EAAE,eAAe,EAAE,GAAG,WAAW,CAAC,mBAAmB,CAAC,GAAG,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC9F,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG;QACZ,4CAA4C;QAC5C,eAAe,aAAa,EAAE;QAC9B,eAAe,MAAM,EAAE;KACxB,CAAC;IACF,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,CAAgB,EAAE,OAAsB,EAAE,IAAY;IACnF,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO;IAC3C,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,GAAG;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"hints.js","sourceRoot":"","sources":["../../../src/hints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,CAAgB,EAAE,OAAsB,EAAE,GAAW;IAC1F,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO;IAC3C,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,EAAE,eAAe,EAAE,GAAG,WAAW,CAAC,mBAAmB,CAAC,GAAG,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC9F,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,sBAAsB,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,CAAgB,EAAE,OAAsB,EAAE,aAAqB;IACpG,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO;IAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG;QACZ,4CAA4C;QAC5C,eAAe,aAAa,EAAE;QAC9B,eAAe,MAAM,EAAE;KACxB,CAAC;IACF,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,CAAgB,EAAE,OAAsB,EAAE,IAAY;IACnF,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO;IAC3C,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,GAAG;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/esm/src/network-option.js

@@ -0,0 +1,39 @@
+import { profileNetworkMismatch, resolveDefaultNetwork } from './config.js';
+import { CLIError } from './error.js';
+import { SUPPORTED_NETWORKS } from './types.js';
+/** The help text of `-n, --network` on the offline creation commands. */
+export const NETWORK_OPTION_HELP = 'Identifier bitcoin network <bitcoin|testnet3|testnet4|signet|mutinynet|regtest> '
+    + '(default: config defaults.network, else regtest)';
+/** Builds the keystore- and config-resolution overrides from the global flags. */
+export function overridesFromGlobals(g) {
+    return {
+        home: g.home,
+        config: g.config,
+        profile: g.profile,
+        keystore: g.keystore,
+        passphraseFile: g.passphraseFile,
+    };
+}
+/** Validates an explicit `--network`, or resolves the default from configuration. */
+export function resolveNetworkOption(explicit, overrides) {
+    if (!explicit)
+        return resolveDefaultNetwork(overrides);
+    if (!SUPPORTED_NETWORKS.includes(explicit)) {
+        throw new CLIError('Invalid network. Must be one of "bitcoin", "testnet3", "testnet4", "signet", "mutinynet", or "regtest".', 'INVALID_ARGUMENT_ERROR', { network: explicit });
+    }
+    return explicit;
+}
+/**
+ * Warns on stderr, and never blocks, when the network of a new identifier
+ * disagrees with the network that the active profile declares. A `production`
+ * profile that holds mainnet endpoints must not mint a regtest DID in silence.
+ */
+export function warnProfileNetworkMismatch(g, network, overrides) {
+    const mismatch = profileNetworkMismatch(network, overrides);
+    if (mismatch && !g.quiet) {
+        process.stderr.write(`Warning: creating a "${network}" identifier while the active profile `
+            + `"${mismatch.profile}" declares network "${mismatch.declared}". The `
+            + 'identifier\'s network and the profile\'s endpoints may not match.\n');
+    }
+}
+//# sourceMappingURL=network-option.js.map

package/dist/esm/src/network-option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-option.js","sourceRoot":"","sources":["../../../src/network-option.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAC9B,kFAAkF;MAChF,kDAAkD,CAAC;AAEvD,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAAC,CAAgB;IACnD,OAAO;QACL,IAAI,EAAa,CAAC,CAAC,IAAI;QACvB,MAAM,EAAW,CAAC,CAAC,MAAM;QACzB,OAAO,EAAU,CAAC,CAAC,OAAO;QAC1B,QAAQ,EAAS,CAAC,CAAC,QAAQ;QAC3B,cAAc,EAAG,CAAC,CAAC,cAAc;KAClC,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,oBAAoB,CAAC,QAA4B,EAAE,SAA8B;IAC/F,IAAI,CAAC,QAAQ;QAAE,OAAO,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAyB,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,QAAQ,CAChB,yGAAyG,EACzG,wBAAwB,EACxB,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtB,CAAC;IACJ,CAAC;IACD,OAAO,QAAyB,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,CAAgB,EAAE,OAAsB,EAAE,SAA8B;IACjH,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wBAAwB,OAAO,wCAAwC;cACrE,IAAI,QAAQ,CAAC,OAAO,uBAAuB,QAAQ,CAAC,QAAQ,SAAS;cACrE,qEAAqE,CACxE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/esm/src/resolution-options.js

@@ -1,13 +1,22 @@
 import { DEFAULT_MIN_CONF } from '@did-btcr2/api';
 import { readFile } from 'node:fs/promises';
 import { CLIError } from './error.js';
+import { readGenesisDocumentFile } from './genesis-document-file.js';
+/** Whether any resolution flag is set. */
+export function hasResolutionFlags(flags) {
+    return flags.resolutionOptions !== undefined
+        || flags.resolutionOptionsPath !== undefined
+        || flags.minConf !== undefined
+        || flags.genesisDocument !== undefined;
+}
 /** The help text of `--min-conf`. `resolve`, `update`, and `deactivate` share it. */
 export const MIN_CONF_HELP = 'Minimum block confirmations a beacon signal needs before resolution applies it '
     + `(positive integer, default: ${DEFAULT_MIN_CONF}). Overrides a minConf inside the JSON resolution options`;
 /**
  * Builds the resolution options from the flags. The inline JSON wins over
- * the file. The `--min-conf` flag wins over a `minConf` inside the JSON.
- * Returns `undefined` if no flag is set.
+ * the file. The `--min-conf` flag wins over a `minConf` inside the JSON. The
+ * `--genesis-document` file wins over a `sidecar.genesisDocument` inside the
+ * JSON. Returns `undefined` if no flag is set.
  */
 export async function readResolutionOptions(flags) {
     let resolutionOptions;
@@ -32,6 +41,14 @@ export async function readResolutionOptions(flags) {
     if (flags.minConf !== undefined) {
         resolutionOptions = { ...(resolutionOptions ?? {}), minConf: flags.minConf };
     }
+    // The file wins over a sidecar.genesisDocument inside the JSON options.
+    if (flags.genesisDocument !== undefined) {
+        const genesisDocument = await readGenesisDocumentFile(flags.genesisDocument);
+        resolutionOptions = {
+            ...(resolutionOptions ?? {}),
+            sidecar: { ...(resolutionOptions?.sidecar ?? {}), genesisDocument },
+        };
+    }
     return resolutionOptions;
 }
 /**

package/dist/esm/src/resolution-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolution-options.js","sourceRoot":"","sources":["../../../src/resolution-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAStC,qFAAqF;AACrF,MAAM,CAAC,MAAM,aAAa,GACxB,iFAAiF;MAC/E,+BAA+B,gBAAgB,2DAA2D,CAAC;AAE/G;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAA4B;IACtE,IAAI,iBAAgD,CAAC;IACrD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,0DAA0D,EAC1D,wBAAwB,EACxB,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAC/C,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;YACrE,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,uEAAuE,EACvE,wBAAwB,EACxB,EAAE,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,EAAE,CACvD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,wDAAwD;IACxD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,iBAAiB,GAAG,EAAE,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC/E,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CAChB,oDAAoD,EACpD,wBAAwB,EACxB,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"resolution-options.js","sourceRoot":"","sources":["../../../src/resolution-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAUrE,0CAA0C;AAC1C,MAAM,UAAU,kBAAkB,CAAC,KAA4B;IAC7D,OAAO,KAAK,CAAC,iBAAiB,KAAK,SAAS;WACvC,KAAK,CAAC,qBAAqB,KAAK,SAAS;WACzC,KAAK,CAAC,OAAO,KAAK,SAAS;WAC3B,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC;AAC3C,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,aAAa,GACxB,iFAAiF;MAC/E,+BAA+B,gBAAgB,2DAA2D,CAAC;AAE/G;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAA4B;IACtE,IAAI,iBAAgD,CAAC;IACrD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,0DAA0D,EAC1D,wBAAwB,EACxB,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAC/C,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;YACrE,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,uEAAuE,EACvE,wBAAwB,EACxB,EAAE,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,EAAE,CACvD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,wDAAwD;IACxD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,iBAAiB,GAAG,EAAE,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC/E,CAAC;IACD,wEAAwE;IACxE,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,eAAe,GAAG,MAAM,uBAAuB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC7E,iBAAiB,GAAG;YAClB,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;YAC5B,OAAO,EAAG,EAAE,GAAG,CAAC,iBAAiB,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE;SACrE,CAAC;IACJ,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CAChB,oDAAoD,EACpD,wBAAwB,EACxB,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/types/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAepD,OAAO,EAA8D,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAI1G;;GAEG;AACH,qBAAa,WAAW;IACtB,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;;;;;;;;;;;;OAaG;gBAED,OAAO,GAAE,UAA8B,EACvC,eAAe,GAAE,UAA+B;IA0DlD;;;;OAIG;IACU,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CASjD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAgBpD,OAAO,EAA8D,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAI1G;;GAEG;AACH,qBAAa,WAAW;IACtB,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;;;;;;;;;;;;OAaG;gBAED,OAAO,GAAE,UAA8B,EACvC,eAAe,GAAE,UAA+B;IA2DlD;;;;OAIG;IACU,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CASjD"}

package/dist/types/src/commands/completion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../../src/commands/completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,GAAG,IAAI,CAO/F"}
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../../src/commands/completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQjD,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,GAAG,IAAI,CAO/F"}

package/dist/types/src/commands/create.d.ts

@@ -13,11 +13,12 @@ import type { GlobalOptions } from '../types.js';
  *   genesis bytes. Reading a public key never decrypts, so this never prompts.
  * - raw (`--bytes <hex>`): a 33-byte public key as hex. Offline, keystore-free.
  *
- * An external (`-t x`) identifier is raw-bytes-only: a 32-byte genesis-document
- * hash via `--bytes`. Generation and `--signing-key` apply only to `-t k`.
+ * An external (`-t x`) identifier has two input modes: the genesis document
+ * file (`--document <path>`), which the api hashes, or the 32-byte hash as
+ * hex (`--bytes`). Generation and `--signing-key` apply only to `-t k`.
  *
- * The keystore-free `factory` serves the raw-bytes path; the keystore-aware
- * `keystoreFactory` serves the generate and existing-key paths.
+ * The keystore-free `factory` serves the raw-bytes and document paths; the
+ * keystore-aware `keystoreFactory` serves the generate and existing-key paths.
  */
 export declare function registerCreateCommand(program: Command, factory: ApiFactory, keystoreFactory: ApiFactory, globals: () => GlobalOptions): void;
 //# sourceMappingURL=create.d.ts.map

package/dist/types/src/commands/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/commands/create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAuB,MAAM,cAAc,CAAC;AAMpE,OAAO,KAAK,EAAiB,aAAa,EAAiB,MAAM,aAAa,CAAC;AAS/E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAW,OAAO,EACzB,OAAO,EAAW,UAAU,EAC5B,eAAe,EAAG,UAAU,EAC5B,OAAO,EAAW,MAAM,aAAa,GACpC,IAAI,CA4GN"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/commands/create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ/C,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,aAAa,CAAC;AAQhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAW,OAAO,EACzB,OAAO,EAAW,UAAU,EAC5B,eAAe,EAAG,UAAU,EAC5B,OAAO,EAAW,MAAM,aAAa,GACpC,IAAI,CAkHN"}

package/dist/types/src/commands/genesis.d.ts

@@ -0,0 +1,20 @@
+import type { Command } from 'commander';
+import type { ApiFactory } from '../config.js';
+import type { GlobalOptions } from '../types.js';
+/** The default path of the genesis document that `genesis build` writes. */
+export declare const DEFAULT_GENESIS_PATH = "genesis.json";
+/**
+ * Registers the `genesis` command group. `genesis build` builds the genesis
+ * document of an external (`x`) identifier, writes it to a file, and prints
+ * the identifier. On a terminal the command asks for the keys, the beacons,
+ * and the services. With `--spec <path>` it reads them from a JSON file and
+ * asks nothing. The command is offline: it derives the beacon addresses from
+ * the keys and opens no Bitcoin connection.
+ *
+ * The keystore-free `factory` builds the document; the keystore-aware
+ * `keystoreFactory` resolves key references and lists the keys for the
+ * wizard. Reading a public key never decrypts, so the command never prompts
+ * for the passphrase.
+ */
+export declare function registerGenesisCommand(program: Command, factory: ApiFactory, keystoreFactory: ApiFactory, globals: () => GlobalOptions): void;
+//# sourceMappingURL=genesis.d.ts.map

package/dist/types/src/commands/genesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis.d.ts","sourceRoot":"","sources":["../../../../src/commands/genesis.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ/C,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAW,OAAO,EACzB,OAAO,EAAW,UAAU,EAC5B,eAAe,EAAG,UAAU,EAC5B,OAAO,EAAW,MAAM,aAAa,GACpC,IAAI,CA2DN"}

package/dist/types/src/commands/identifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../../../src/commands/identifier.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,KAAK,EAAiB,aAAa,EAAwB,MAAM,aAAa,CAAC;AAEtF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAG,OAAO,EACjB,OAAO,EAAG,UAAU,EACpB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAuFN"}
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../../../src/commands/identifier.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/C,OAAO,KAAK,EAAiB,aAAa,EAAwB,MAAM,aAAa,CAAC;AAEtF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAG,OAAO,EACjB,OAAO,EAAG,UAAU,EACpB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAuFN"}

package/dist/types/src/commands/index.d.ts

@@ -5,6 +5,7 @@ export { registerResolveCommand } from './resolve.js';
 export { registerUpdateCommand } from './update.js';
 export { registerDeactivateCommand } from './deactivate.js';
 export { registerIdentifierCommand } from './identifier.js';
+export { registerGenesisCommand } from './genesis.js';
 export { registerKeyCommand } from './key.js';
 export { registerKeystoreCommand } from './keystore.js';
 export { registerConfigCommand } from './config.js';

package/dist/types/src/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/src/commands/resolve.d.ts

@@ -1,5 +1,12 @@
 import type { Command } from 'commander';
 import { type ApiFactory } from '../config.js';
+import { type ResolutionOptionFlags } from '../resolution-options.js';
 import type { GlobalOptions } from '../types.js';
 export declare function registerResolveCommand(program: Command, factory: ApiFactory, globals: () => GlobalOptions): void;
+/**
+ * Refuses `--genesis-document` for a KEY identifier before the file is read.
+ * A KEY identifier has no genesis document; the resolver would ignore the
+ * file in silence. `resolve`, `update`, and `deactivate` share the check.
+ */
+export declare function assertGenesisDocumentApplies(flags: ResolutionOptionFlags, hrp: string): void;
 //# sourceMappingURL=resolve.d.ts.map

package/dist/types/src/commands/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../src/commands/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AAExE,wBAAgB,sBAAsB,CACpC,OAAO,EAAG,OAAO,EACjB,OAAO,EAAG,UAAU,EACpB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAiBN"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../src/commands/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAI9D,OAAO,EAAsD,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC1H,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AAExE,wBAAgB,sBAAsB,CACpC,OAAO,EAAG,OAAO,EACjB,OAAO,EAAG,UAAU,EACpB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAkBN;AAYD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ5F"}

package/dist/types/src/commands/write.d.ts

@@ -32,7 +32,8 @@ export declare function registerWriteOptions(command: Command): Command;
  * 3. The resolution flags come only without the source pair. The api ignores
  *    `resolutionOptions` when the pair is supplied (ADR 098). A silent ignore
  *    of `--min-conf` would mislead.
- * 4. A mainnet write is refused with an unencrypted dev keystore (ADR 080).
+ * 4. `--genesis-document` comes only with an external (x) identifier.
+ * 5. A mainnet write is refused with an unencrypted dev keystore (ADR 080).
  */
 export declare function prepareWrite(options: WriteFlags, factory: ApiFactory, g: GlobalOptions): Promise<{
     network: NetworkOption;

package/dist/types/src/commands/write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../../src/commands/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAsD,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC1H,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEtF,6DAA6D;AAC7D,MAAM,MAAM,UAAU,GAAG,qBAAqB,GAAG;IAC/C,UAAU,EAAc,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAS,OAAO,CAAC;IAChC,eAAe,CAAC,EAAQ,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAe,MAAM,CAAC;IAC/B,YAAY,EAAY,gBAAgB,CAAC;IACzC,OAAO,CAAC,EAAgB,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAU,MAAM,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAiD9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAG,UAAU,EACpB,OAAO,EAAG,UAAU,EACpB,CAAC,EAAS,aAAa,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC,CAmDrF;AA6BD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAYzE"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../../src/commands/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAKtB,OAAO,EAA0E,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC9I,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGtF,6DAA6D;AAC7D,MAAM,MAAM,UAAU,GAAG,qBAAqB,GAAG;IAC/C,UAAU,EAAc,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAS,OAAO,CAAC;IAChC,eAAe,CAAC,EAAQ,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAe,MAAM,CAAC;IAC/B,YAAY,EAAY,gBAAgB,CAAC;IACzC,OAAO,CAAC,EAAgB,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAU,MAAM,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAkD9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAG,UAAU,EACpB,OAAO,EAAG,UAAU,EACpB,CAAC,EAAS,aAAa,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC,CAiDrF;AA6BD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAYzE"}

package/dist/types/src/genesis-document-file.d.ts

@@ -0,0 +1,11 @@
+/** The help text of `--genesis-document`. `resolve`, `update`, and `deactivate` share it. */
+export declare const GENESIS_DOCUMENT_HELP: string;
+/**
+ * Reads and parses a genesis document file. The content must be a JSON
+ * object. The shape of the document is checked by the api, not here.
+ * @param path The path of the JSON file.
+ * @returns The parsed object.
+ * @throws {CLIError} If the file is unreadable, not JSON, or not an object.
+ */
+export declare function readGenesisDocumentFile(path: string): Promise<object>;
+//# sourceMappingURL=genesis-document-file.d.ts.map

package/dist/types/src/genesis-document-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis-document-file.d.ts","sourceRoot":"","sources":["../../../src/genesis-document-file.ts"],"names":[],"mappings":"AAGA,6FAA6F;AAC7F,eAAO,MAAM,qBAAqB,QAE2B,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB3E"}

package/dist/types/src/genesis-spec.d.ts

@@ -0,0 +1,70 @@
+import type { GenesisDocumentSpec } from '@did-btcr2/api';
+import type { NetworkOption } from './types.js';
+/**
+ * One verification method of a genesis spec file. `key` is a keystore
+ * reference (URN, name, or fingerprint prefix); `publicKey` is a 33-byte
+ * compressed public key as hex. Exactly one of the two.
+ */
+export interface GenesisSpecVerificationMethod {
+    key?: string;
+    publicKey?: string;
+    relationships?: string[];
+    fragment?: string;
+}
+/**
+ * One beacon of a genesis spec file. `key` or `publicKey` derives the beacon
+ * address from a key; `address` uses a Bitcoin address as given. At most one
+ * of the three; the api requires one.
+ */
+export interface GenesisSpecBeacon {
+    type: string;
+    key?: string;
+    publicKey?: string;
+    addressType?: string;
+    address?: string;
+    fragment?: string;
+}
+/** One other service of a genesis spec file. */
+export interface GenesisSpecService {
+    id?: string;
+    type: string;
+    serviceEndpoint: unknown;
+}
+/**
+ * The genesis spec file that `btcr2 genesis build --spec <path>` reads, and
+ * that the wizard collects. The network comes from `-n` or the configuration,
+ * not from the file.
+ */
+export interface GenesisSpecFile {
+    verificationMethods: GenesisSpecVerificationMethod[];
+    beacons?: GenesisSpecBeacon[];
+    services?: GenesisSpecService[];
+}
+/** Resolves a keystore key reference to the 33-byte public key. */
+export type ResolvePublicKey = (ref: string) => Uint8Array;
+/**
+ * Checks the shape of a parsed genesis spec file. The values (relationship
+ * names, beacon types, addresses) are checked by the api when it builds the
+ * document; this function checks only what the api cannot see: that each
+ * verification method names exactly one key source, and that each beacon
+ * names at most one.
+ * @param value The parsed JSON value.
+ * @param source The file path, for the error data.
+ * @returns The spec.
+ * @throws {CLIError} If the shape is not valid.
+ */
+export declare function parseGenesisSpec(value: unknown, source: string): GenesisSpecFile;
+/**
+ * Converts a genesis spec file to the api spec: resolves each keystore
+ * reference to its public key, parses each hex public key, and passes the
+ * other values through for the api to check.
+ * @param spec The spec file.
+ * @param network The network of the beacon addresses.
+ * @param resolvePublicKey Resolves a keystore reference to the public key.
+ * @returns The api spec.
+ * @throws {CLIError} If a hex public key is not hex.
+ */
+export declare function toApiSpec(spec: GenesisSpecFile, network: NetworkOption, resolvePublicKey: ResolvePublicKey): GenesisDocumentSpec;
+/** Parses a hex public key. The length and the curve check belong to the api. */
+export declare function parseHexPublicKey(hex: string, label: string): Uint8Array;
+//# sourceMappingURL=genesis-spec.d.ts.map