@did-btcr2/cli 0.22.0 → 0.23.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"genesis-spec.d.ts","sourceRoot":"","sources":["../../../src/genesis-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,mBAAmB,EAGpB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,GAAG,CAAC,EAAa,MAAM,CAAC;IACxB,SAAS,CAAC,EAAO,MAAM,CAAC;IACxB,aAAa,CAAC,EAAG,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAQ,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAY,MAAM,CAAC;IACvB,GAAG,CAAC,EAAY,MAAM,CAAC;IACvB,SAAS,CAAC,EAAM,MAAM,CAAC;IACvB,WAAW,CAAC,EAAI,MAAM,CAAC;IACvB,OAAO,CAAC,EAAQ,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAO,MAAM,CAAC;CACxB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAe,MAAM,CAAC;IACzB,IAAI,EAAc,MAAM,CAAC;IACzB,eAAe,EAAG,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB,EAAG,6BAA6B,EAAE,CAAC;IACtD,OAAO,CAAC,EAAc,iBAAiB,EAAE,CAAC;IAC1C,QAAQ,CAAC,EAAa,kBAAkB,EAAE,CAAC;CAC5C;AAED,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,UAAU,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAiChF;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,CAuBhI;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAMxE"}

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

@@ -0,0 +1,30 @@
+import type { GenesisSpecFile } from './genesis-spec.js';
+/** Asks one question and returns the answer line. */
+export type Ask = (question: string) => Promise<string>;
+/** One keystore key as the wizard lists it. */
+export interface WizardKey {
+    keyId: string;
+    fingerprint: string;
+    name?: string;
+    active: boolean;
+}
+/** What the wizard needs from the command: output, the key list, and key resolution. */
+export interface WizardContext {
+    /** Prints one line to the operator. */
+    say: (line: string) => void;
+    /** The keys of the keystore, for the list and the default. */
+    keys: WizardKey[];
+    /** Resolves a key reference to its id, or throws with a message. */
+    resolveKey: (ref: string) => string;
+}
+/**
+ * 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 declare function collectGenesisSpec(ask: Ask, ctx: WizardContext): Promise<GenesisSpecFile>;
+//# sourceMappingURL=genesis-wizard.d.ts.map

package/dist/types/src/genesis-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis-wizard.d.ts","sourceRoot":"","sources":["../../../src/genesis-wizard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,eAAe,EAAqD,MAAM,mBAAmB,CAAC;AAE/H,qDAAqD;AACrD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAExD,+CAA+C;AAC/C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAS,MAAM,CAAC;IACrB,WAAW,EAAG,MAAM,CAAC;IACrB,IAAI,CAAC,EAAS,MAAM,CAAC;IACrB,MAAM,EAAQ,OAAO,CAAC;CACvB;AAED,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,8DAA8D;IAC9D,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,oEAAoE;IACpE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAKD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAK/F"}

package/dist/types/src/hints.d.ts

@@ -15,6 +15,13 @@ import type { GlobalOptions, NetworkOption } from './types.js';
  * `#initialP2WPKH` service rather than a divergent re-derivation.
  */
 export declare function printCreateFundingHint(g: GlobalOptions, network: NetworkOption, did: string): void;
+/**
+ * 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 declare function printBeaconFundingHint(g: GlobalOptions, network: NetworkOption, beaconAddress: string): void;
 /**
  * Prints a watch link after an `update`/`deactivate` broadcast: the
  * block-explorer URL for the signal txid. A no-op on a network without an

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

@@ -1 +1 @@
-{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../../src/hints.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAmBlG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI3F"}
+{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../../src/hints.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAUlG;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAY5G;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI3F"}

package/dist/types/src/network-option.d.ts

@@ -0,0 +1,15 @@
+import type { ConnectionOverrides } from './config.js';
+import type { GlobalOptions, NetworkOption } from './types.js';
+/** The help text of `-n, --network` on the offline creation commands. */
+export declare const NETWORK_OPTION_HELP: string;
+/** Builds the keystore- and config-resolution overrides from the global flags. */
+export declare function overridesFromGlobals(g: GlobalOptions): ConnectionOverrides;
+/** Validates an explicit `--network`, or resolves the default from configuration. */
+export declare function resolveNetworkOption(explicit: string | undefined, overrides: ConnectionOverrides): NetworkOption;
+/**
+ * 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 declare function warnProfileNetworkMismatch(g: GlobalOptions, network: NetworkOption, overrides: ConnectionOverrides): void;
+//# sourceMappingURL=network-option.d.ts.map

package/dist/types/src/network-option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-option.d.ts","sourceRoot":"","sources":["../../../src/network-option.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG/D,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,QAEsB,CAAC;AAEvD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,mBAAmB,CAQ1E;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,mBAAmB,GAAG,aAAa,CAUhH;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI,CASzH"}

package/dist/types/src/resolution-options.d.ts

@@ -4,13 +4,17 @@ export type ResolutionOptionFlags = {
     resolutionOptions?: string;
     resolutionOptionsPath?: string;
     minConf?: number;
+    genesisDocument?: string;
 };
+/** Whether any resolution flag is set. */
+export declare function hasResolutionFlags(flags: ResolutionOptionFlags): boolean;
 /** The help text of `--min-conf`. `resolve`, `update`, and `deactivate` share it. */
 export declare const MIN_CONF_HELP: string;
 /**
  * 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 declare function readResolutionOptions(flags: ResolutionOptionFlags): Promise<ResolutionOptions | undefined>;
 /**

package/dist/types/src/resolution-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolution-options.d.ts","sourceRoot":"","sources":["../../../src/resolution-options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,iEAAiE;AACjE,MAAM,MAAM,qBAAqB,GAAG;IAClC,iBAAiB,CAAC,EAAO,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAG,MAAM,CAAC;IAChC,OAAO,CAAC,EAAiB,MAAM,CAAC;CACjC,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,aAAa,QAEoF,CAAC;AAE/G;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CA6BhH;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD"}
+{"version":3,"file":"resolution-options.d.ts","sourceRoot":"","sources":["../../../src/resolution-options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAK3D,iEAAiE;AACjE,MAAM,MAAM,qBAAqB,GAAG;IAClC,iBAAiB,CAAC,EAAO,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAG,MAAM,CAAC;IAChC,OAAO,CAAC,EAAiB,MAAM,CAAC;IAChC,eAAe,CAAC,EAAS,MAAM,CAAC;CACjC,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAKxE;AAED,qFAAqF;AACrF,eAAO,MAAM,aAAa,QAEoF,CAAC;AAE/G;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAqChH;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD"}

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

@@ -1,4 +1,4 @@
-import type { BroadcastOptions, DidUpdateResult, IdentifierReport, PublishToCasMode, Signer } from '@did-btcr2/api';
+import type { BeaconInfo, BroadcastOptions, DidUpdateResult, IdentifierReport, PublishToCasMode, Signer } from '@did-btcr2/api';
 import type { Btcr2DidDocument, ResolutionOptions } from '@did-btcr2/method';
 import type { DidResolutionResult } from '@web5/dids';
 import type { DoctorReport, EffectiveConfig } from './config.js';
@@ -56,11 +56,25 @@ export interface IdentifierDecodeData {
     genesisBytes: string;
     initialDocument?: Btcr2DidDocument;
 }
+/**
+ * The data that `genesis build` prints: the external identifier, its
+ * network, its genesis bytes as hex, the path of the written genesis
+ * document, and the beacons of the initial DID document with their
+ * addresses to fund.
+ */
+export interface GenesisBuildData {
+    did: string;
+    network: NetworkOption;
+    genesisBytes: string;
+    path: string;
+    beacons: BeaconInfo[];
+}
 export type CommandResult = {
     action: 'create';
     data: string;
     keyId?: string;
     publicKey?: string;
+    genesisBytes?: string;
 } | {
     action: 'resolve';
     data: DidResolutionResult;
@@ -76,6 +90,9 @@ export type CommandResult = {
 } | {
     action: 'identifier-validate';
     data: IdentifierReport;
+} | {
+    action: 'genesis-build';
+    data: GenesisBuildData;
 } | {
     action: 'key-generate';
     data: {

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAChI,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AACrG,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,KAAK,GAAG,QAAQ,CAAC;AAErE,eAAO,MAAM,kBAAkB,EAAE,aAAa,EAE7C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAG,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,iBAAiB,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAqB,MAAM,CAAC;IAC/B,MAAM,EAAkB,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAS,gBAAgB,CAAC;IACzC,eAAe,CAAC,EAAQ,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAe,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAM,iBAAiB,CAAC;IAC1C,YAAY,EAAY,gBAAgB,CAAC;IACzC,gBAAgB,CAAC,EAAO,gBAAgB,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAgB,MAAM,CAAC;IAC1B,MAAM,EAAa,MAAM,CAAC;IAC1B,GAAG,EAAgB,MAAM,CAAC;IAC1B,OAAO,EAAY,MAAM,CAAC;IAC1B,OAAO,EAAY,MAAM,CAAC;IAC1B,YAAY,EAAO,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAG,gBAAgB,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAY,MAAM,CAAC;IACtB,OAAO,EAAQ,aAAa,CAAC;IAC7B,YAAY,EAAG,MAAM,CAAC;IACtB,IAAI,EAAW,MAAM,CAAC;IACtB,OAAO,EAAQ,UAAU,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC3D;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACzD;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACvF;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,GAC3G;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,GACjG;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACzG;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC/F;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,CAAA;CAAE,GAChE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,IAAI,CAAA;KAAE,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,uBAAuB,CAAA;KAAE,CAAA;CAAE,GAC5J;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE;QAC5B,IAAI,EAAS,MAAM,CAAC;QACpB,MAAM,EAAO,MAAM,CAAC;QACpB,QAAQ,EAAK,MAAM,CAAC;QACpB,OAAO,EAAM,aAAa,CAAC;QAC3B,OAAO,EAAM,MAAM,EAAE,CAAC;QACtB,UAAU,EAAG,uBAAuB,CAAC;QACrC,QAAQ,EAAK,OAAO,CAAC;QACrB,OAAO,CAAC,EAAK;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;QACvD,MAAM,CAAC,EAAM,YAAY,CAAC;KAC3B,CAAA;CAAE,GACH;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,CAAA;CAAE,GAC3E;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACrD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACnF;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,WAAW,GAAG,KAAK,CAAA;KAAE,CAAA;CAAE,GACpF;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,uBAAuB,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAA;CAAE,GACtL;IAAE,MAAM,EAAE,4BAA4B,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjF;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAChG;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACrE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAgB,YAAY,CAAC;IACnC,OAAO,EAAe,OAAO,CAAC;IAC9B,KAAK,EAAiB,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAiB,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAe,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAc,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAc,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAY,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAW,MAAM,CAAC;IAI7B,UAAU,CAAC,EAAW,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAY,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAW,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAW,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAQ,MAAM,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAS,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAS,MAAM,EAAE,CAAC;IAC/B,kBAAkB,CAAC,EAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAa,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAO,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAW,MAAM,CAAC;CAC9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@did-btcr2/cli",
-  "version": "0.22.0",
+  "version": "0.23.1",
   "type": "module",
   "description": "CLI for interacting with did-btcr2-js, the JavaScript/TypeScript reference implementation of the did:btcr2 method. Exposes various parts of multiple packages in the did-btcr2-js monorepo.",
   "main": "./dist/cjs/index.js",
@@ -62,7 +62,7 @@
     "@web5/dids": "^1.2.0",
     "commander": "^13.1.0",
     "@did-btcr2/key-manager": "^0.7.0",
-    "@did-btcr2/api": "^0.22.0",
+    "@did-btcr2/api": "^0.23.0",
     "@did-btcr2/common": "^9.4.0",
     "@did-btcr2/keypair": "^0.13.1",
     "@did-btcr2/method": "^0.60.0"

package/src/cli.ts

@@ -5,6 +5,7 @@ import {
   registerConfigCommand,
   registerCreateCommand,
   registerDeactivateCommand,
+  registerGenesisCommand,
   registerIdentifierCommand,
   registerInitCommand,
   registerKeyCommand,
@@ -91,6 +92,7 @@ export class DidBtcr2Cli {
     registerUpdateCommand(this.program, keystoreFactory, globals);
     registerDeactivateCommand(this.program, keystoreFactory, globals);
     registerIdentifierCommand(this.program, factory, globals);
+    registerGenesisCommand(this.program, factory, keystoreFactory, globals);
     registerKeyCommand(this.program, keystoreFactory, globals);
     registerKeystoreCommand(this.program, globals);
     registerConfigCommand(this.program, globals);

package/src/commands/completion.ts

@@ -2,7 +2,11 @@ import type { Command } from 'commander';
 import { CLIError } from '../error.js';
 import type { GlobalOptions } from '../types.js';
 
-const COMMANDS = 'create resolve read update deactivate delete identifier key config profile completion';
+/**
+ * The name of the built-in help command of commander. Commander creates that
+ * command at parse time, so `program.commands` does not list it.
+ */
+const HELP_COMMAND = 'help';
 
 /** Registers the `completion` command, which prints a shell completion script to stdout. */
 export function registerCompletionCommand(program: Command, _globals: () => GlobalOptions): void {
@@ -10,29 +14,39 @@ export function registerCompletionCommand(program: Command, _globals: () => Glob
     .command('completion [shell]')
     .description('Print a shell completion script (bash, zsh, or fish) to stdout.')
     .action((shell = 'bash') => {
-      console.log(completionScript(shell));
+      console.log(completionScript(shell, completionWords(program)));
     });
 }
 
-/** Returns a completion script for the given shell. */
-function completionScript(shell: string): string {
+/**
+ * Returns the completion word list: the name and the aliases of each registered
+ * top-level command, in registration order, then the built-in help command.
+ */
+function completionWords(program: Command): string[] {
+  const words = program.commands.flatMap((command) => [command.name(), ...command.aliases()]);
+  return [...words, HELP_COMMAND];
+}
+
+/** Returns a completion script for the given shell and word list. */
+function completionScript(shell: string, words: string[]): string {
+  const list = words.join(' ');
   switch (shell) {
     case 'bash':
       return [
         '# btcr2 bash completion. Install with: eval "$(btcr2 completion bash)"',
-        '_btcr2() { COMPREPLY=( $(compgen -W "' + COMMANDS + '" -- "${COMP_WORDS[COMP_CWORD]}") ); }',
+        '_btcr2() { COMPREPLY=( $(compgen -W "' + list + '" -- "${COMP_WORDS[COMP_CWORD]}") ); }',
         'complete -F _btcr2 btcr2',
       ].join('\n');
     case 'zsh':
       return [
         '# btcr2 zsh completion. Install with: eval "$(btcr2 completion zsh)"',
-        '_btcr2() { compadd ' + COMMANDS + ' }',
+        '_btcr2() { compadd ' + list + ' }',
         'compdef _btcr2 btcr2',
       ].join('\n');
     case 'fish':
       return [
         '# btcr2 fish completion. Save to ~/.config/fish/completions/btcr2.fish',
-        'complete -c btcr2 -f -a "' + COMMANDS + '"',
+        'complete -c btcr2 -f -a "' + list + '"',
       ].join('\n');
     default:
       throw new CLIError(`Unsupported shell "${shell}". Use bash, zsh, or fish.`, 'INVALID_ARGUMENT_ERROR', { shell });

package/src/commands/create.ts

@@ -1,13 +1,14 @@
 import { bytesToHex, hexToBytes } from '@noble/hashes/utils.js';
 import type { Command } from 'commander';
-import type { ApiFactory, ConnectionOverrides } from '../config.js';
-import { assertKeystoreAllowedForNetwork, profileNetworkMismatch, resolveDefaultNetwork } from '../config.js';
+import type { ApiFactory } from '../config.js';
+import { assertKeystoreAllowedForNetwork } from '../config.js';
 import { CLIError } from '../error.js';
-import { printCreateFundingHint } from '../hints.js';
+import { readGenesisDocumentFile } from '../genesis-document-file.js';
+import { printBeaconFundingHint, printCreateFundingHint } from '../hints.js';
 import { resolveKeyRef } from '../keystore/resolve-key-ref.js';
+import { NETWORK_OPTION_HELP, overridesFromGlobals, resolveNetworkOption, warnProfileNetworkMismatch } from '../network-option.js';
 import { formatResult } from '../output.js';
-import type { CommandResult, GlobalOptions, NetworkOption } from '../types.js';
-import { SUPPORTED_NETWORKS } from '../types.js';
+import type { CommandResult, GlobalOptions } from '../types.js';
 
 /** Expected byte length per identifier type: compressed secp256k1 = 33, SHA-256 hash = 32. */
 const EXPECTED_BYTES: Record<'k' | 'x', { length: number; label: string }> = {
@@ -27,11 +28,12 @@ const EXPECTED_BYTES: Record<'k' | 'x', { length: number; label: string }> = {
  *   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 function registerCreateCommand(
   program         : Command,
@@ -43,38 +45,28 @@ export function registerCreateCommand(
     .command('create')
     .description('Create an identifier and initial DID document')
     .option('-t, --type <type>', 'Identifier type <k|x>', 'k')
-    .option(
-      '-n, --network <network>',
-      'Identifier bitcoin network <bitcoin|testnet3|testnet4|signet|mutinynet|regtest> '
-      + '(default: config defaults.network, else regtest)'
-    )
+    .option('-n, --network <network>', NETWORK_OPTION_HELP)
     .option(
       '-b, --bytes <bytes>',
       'Genesis bytes as a hex string. '
       + 'For type=k, a 33-byte secp256k1 public key (omit to generate a key). '
       + 'For type=x, the 32-byte SHA-256 hash of a genesis document.'
     )
-    .action(async (options: { type: string; network?: string; bytes?: string }) => {
+    .option(
+      '--document <path>',
+      'For type=x, the path of the JSON genesis document to hash (see "btcr2 genesis build"). '
+      + 'Exclusive with --bytes.'
+    )
+    .action(async (options: { type: string; network?: string; bytes?: string; document?: string }) => {
       const g = globals();
       if (options.type !== 'k' && options.type !== 'x') {
         throw new CLIError('Invalid type. Must be "k" or "x".', 'INVALID_ARGUMENT_ERROR', options);
       }
 
       const overrides = overridesFromGlobals(g);
-      const network = resolveNetwork(options.network, overrides);
+      const network = resolveNetworkOption(options.network, overrides);
       const signingKey = g.signingKey;
-
-      // Warn (never block) when the network being encoded disagrees with the
-      // active profile's declared network, so a `production` profile holding
-      // mainnet endpoints cannot silently mint a regtest DID.
-      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'
-        );
-      }
+      warnProfileNetworkMismatch(g, network, overrides);
 
       /** Prints the result, plus a stderr provenance line in text mode. */
       const print = (result: CommandResult, note?: string): void => {
@@ -82,7 +74,7 @@ export function registerCreateCommand(
         if (note && g.output !== 'json') process.stderr.write(`${note}\n`);
       };
 
-      // External: raw-bytes only.
+      // External: the genesis document file, or its hash as raw bytes.
       if (options.type === 'x') {
         if (signingKey) {
           throw new CLIError(
@@ -90,10 +82,22 @@ export function registerCreateCommand(
             'INVALID_ARGUMENT_ERROR',
           );
         }
+        if (options.bytes !== undefined && options.document !== undefined) {
+          throw new CLIError('Provide at most one of --bytes or --document.', 'INVALID_ARGUMENT_ERROR');
+        }
+        if (options.document !== undefined) {
+          const genesisDocument = await readGenesisDocumentFile(options.document);
+          const api = factory();
+          const { did, genesisBytes, didDocument } = api.btcr2.createExternalFromDocument(genesisDocument, { network });
+          print({ action: 'create', data: did, genesisBytes: bytesToHex(genesisBytes) });
+          const beacons = api.btcr2.getBeacons(didDocument);
+          if (beacons.length > 0) printBeaconFundingHint(g, network, beacons[0].address);
+          return;
+        }
         if (options.bytes === undefined) {
           throw new CLIError(
-            'External identifiers (-t x) require --bytes <hex>, the 32-byte genesis document hash. '
-            + 'Key generation is only available for -t k.',
+            'External identifiers (-t x) require --document <path>, the genesis document, '
+            + 'or --bytes <hex>, its 32-byte hash. Key generation is only available for -t k.',
             'INVALID_ARGUMENT_ERROR',
           );
         }
@@ -103,6 +107,10 @@ export function registerCreateCommand(
         return;
       }
 
+      if (options.document !== undefined) {
+        throw new CLIError('--document applies only to external identifiers (-t x).', 'INVALID_ARGUMENT_ERROR');
+      }
+
       // Deterministic (KEY): three mutually-exclusive modes.
       if (options.bytes !== undefined && signingKey) {
         throw new CLIError(
@@ -148,30 +156,6 @@ export function registerCreateCommand(
     });
 }
 
-/** Builds the keystore- and config-resolution overrides from the global flags. */
-function overridesFromGlobals(g: GlobalOptions): ConnectionOverrides {
-  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. */
-function resolveNetwork(explicit: string | undefined, overrides: ConnectionOverrides): NetworkOption {
-  if (!explicit) return resolveDefaultNetwork(overrides);
-  if (!SUPPORTED_NETWORKS.includes(explicit as NetworkOption)) {
-    throw new CLIError(
-      'Invalid network. Must be one of "bitcoin", "testnet3", "testnet4", "signet", "mutinynet", or "regtest".',
-      'INVALID_ARGUMENT_ERROR',
-      { network: explicit },
-    );
-  }
-  return explicit as NetworkOption;
-}
-
 /** Parses and length-checks hex genesis bytes for the given identifier type. */
 function parseGenesisBytes(hex: string, type: 'k' | 'x'): Uint8Array {
   const expected = EXPECTED_BYTES[type];

package/src/commands/genesis.ts

@@ -0,0 +1,149 @@
+import type { DidBtcr2Api } from '@did-btcr2/api';
+import type { KeyManager } from '@did-btcr2/key-manager';
+import { bytesToHex } from '@noble/hashes/utils.js';
+import type { Command } from 'commander';
+import { existsSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve as resolvePath } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import type { ApiFactory } from '../config.js';
+import { CLIError } from '../error.js';
+import { parseGenesisSpec, toApiSpec, type GenesisSpecFile } from '../genesis-spec.js';
+import { collectGenesisSpec, type WizardKey } from '../genesis-wizard.js';
+import { printBeaconFundingHint } from '../hints.js';
+import { resolveKeyRef } from '../keystore/resolve-key-ref.js';
+import { NETWORK_OPTION_HELP, overridesFromGlobals, resolveNetworkOption, warnProfileNetworkMismatch } from '../network-option.js';
+import { formatResult } from '../output.js';
+import type { CommandResult, GlobalOptions } from '../types.js';
+
+/** The default path of the genesis document that `genesis build` writes. */
+export 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 function registerGenesisCommand(
+  program         : Command,
+  factory         : ApiFactory,
+  keystoreFactory : ApiFactory,
+  globals         : () => GlobalOptions,
+): void {
+  const genesis = program
+    .command('genesis')
+    .description('Build the genesis document of an external identifier (offline).');
+  const print = (result: CommandResult): void => console.log(formatResult(result, globals()));
+
+  genesis
+    .command('build')
+    .description('Build a genesis document, write it to a file, and print the external identifier.')
+    .option('-n, --network <network>', NETWORK_OPTION_HELP)
+    .option('--spec <path>', 'Path to a JSON spec file with the keys, beacons, and services. Runs without prompts.')
+    .option('--out <path>', 'Path of the genesis document to write.', DEFAULT_GENESIS_PATH)
+    .option('--force', 'Overwrite an existing --out file.', false)
+    .action(async (options: { network?: string; spec?: string; out: string; force: boolean }) => {
+      const g = globals();
+      const overrides = overridesFromGlobals(g);
+      const network = resolveNetworkOption(options.network, overrides);
+      warnProfileNetworkMismatch(g, network, overrides);
+
+      // Refuse to overwrite before any question is asked.
+      const outPath = resolvePath(options.out);
+      if (!options.force && existsSync(outPath)) {
+        throw new CLIError(
+          `The file ${outPath} exists. Pass --force to overwrite it, or --out <path> for another file.`,
+          'INVALID_ARGUMENT_ERROR',
+          { out: outPath },
+        );
+      }
+
+      // The keystore opens only when a key reference or the wizard needs it.
+      let keystoreApi: DidBtcr2Api | undefined;
+      const kms = (): KeyManager => (keystoreApi ??= keystoreFactory(undefined, overrides)).kms.kms;
+      const resolvePublicKey = (ref: string): Uint8Array => kms().getPublicKey(resolveKeyRef(kms(), ref));
+
+      const spec = options.spec !== undefined
+        ? await readSpecFile(options.spec)
+        : await runWizard(kms);
+
+      const api = factory();
+      const document = api.btcr2.buildGenesisDocument(toApiSpec(spec, network, resolvePublicKey));
+      // Hash exactly the bytes that the file carries: the parsed form of the
+      // pretty-printed JSON, not the document instance.
+      const json = `${JSON.stringify(document, null, 2)}\n`;
+      const { did, genesisBytes, didDocument } = api.btcr2.createExternalFromDocument(JSON.parse(json), { network });
+      await writeFile(outPath, json, { encoding: 'utf-8', flag: options.force ? 'w' : 'wx' });
+      const beacons = api.btcr2.getBeacons(didDocument);
+
+      print({
+        action : 'genesis-build',
+        data   : { did, network, genesisBytes: bytesToHex(genesisBytes), path: outPath, beacons },
+      });
+      if (!g.quiet && g.output !== 'json') {
+        process.stderr.write(
+          `Wrote the genesis document to ${outPath}. Keep it: the identifier resolves only with it. `
+          + 'Pass --genesis-document <path> to resolve, update, and deactivate, or publish it to a CAS.\n',
+        );
+        if (beacons.length > 0) printBeaconFundingHint(g, network, beacons[0].address);
+      }
+    });
+}
+
+/** Reads and checks the spec file. */
+async function readSpecFile(path: string): Promise<GenesisSpecFile> {
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(await readFile(path, 'utf-8'));
+  } catch {
+    throw new CLIError(
+      'Invalid genesis spec path. Must be a valid path to a JSON file.',
+      'INVALID_ARGUMENT_ERROR',
+      { spec: path },
+    );
+  }
+  return parseGenesisSpec(parsed, path);
+}
+
+/** Runs the wizard on the terminal. Refuses without one. */
+async function runWizard(kms: () => KeyManager): Promise<GenesisSpecFile> {
+  if (!process.stdin.isTTY) {
+    throw new CLIError(
+      'No terminal is attached. Pass --spec <path> to build the genesis document without prompts.',
+      'INVALID_ARGUMENT_ERROR',
+    );
+  }
+  const store = kms();
+  const rl = createInterface({ input: process.stdin, output: process.stderr });
+  try {
+    return await collectGenesisSpec((question) => rl.question(question), {
+      say        : (line) => process.stderr.write(`${line}\n`),
+      keys       : listKeys(store),
+      resolveKey : (ref) => resolveKeyRef(store, ref),
+    });
+  } finally {
+    rl.close();
+  }
+}
+
+/** The keys of the keystore in the shape that `key list` prints. */
+function listKeys(kms: KeyManager): WizardKey[] {
+  const active = kms.activeKeyId;
+  return kms.listKeys().map(id => {
+    const entry = kms.getEntry(id);
+    return {
+      keyId       : id,
+      fingerprint : id.split(':').pop() ?? id,
+      ...(entry.tags?.name && { name: entry.tags.name }),
+      active      : id === active,
+    };
+  });
+}

package/src/commands/identifier.ts

@@ -2,9 +2,9 @@ import type { IdentifierReport } from '@did-btcr2/api';
 import { Identifier } from '@did-btcr2/api';
 import { bytesToHex, hexToBytes } from '@noble/hashes/utils.js';
 import type { Command } from 'commander';
-import { readFile } from 'node:fs/promises';
 import type { ApiFactory } from '../config.js';
 import { CLIError } from '../error.js';
+import { readGenesisDocumentFile } from '../genesis-document-file.js';
 import { formatResult } from '../output.js';
 import type { CommandResult, GlobalOptions, IdentifierDecodeData } from '../types.js';
 
@@ -69,7 +69,7 @@ export function registerIdentifierCommand(
         }
         const genesisDocument = options.genesisDocument === undefined
           ? undefined
-          : await readGenesisDocument(options.genesisDocument);
+          : await readGenesisDocumentFile(options.genesisDocument);
         data.initialDocument = api.btcr2.getInitialDocument(did, genesisDocument);
       }
       print({ action: 'identifier-decode', data });
@@ -100,7 +100,7 @@ export function registerIdentifierCommand(
             { did },
           );
         }
-        genesisDocument = await readGenesisDocument(options.genesisDocument);
+        genesisDocument = await readGenesisDocumentFile(options.genesisDocument);
       }
       const report: IdentifierReport = factory().did.validate(did, { genesisBytes, genesisDocument });
       print({ action: 'identifier-validate', data: report });
@@ -132,25 +132,3 @@ function parseHexBytes(value: string): Uint8Array {
     throw new CLIError('Invalid bytes: not valid hex.', 'INVALID_ARGUMENT_ERROR', { bytes: value });
   }
 }
-
-/** Reads and parses the genesis document file. The content must be a JSON object. */
-async function readGenesisDocument(path: string): Promise<object> {
-  let parsed: unknown;
-  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;
-}

package/src/commands/index.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';