@did-btcr2/cli 0.5.1 → 0.6.0

package/dist/esm/src/commands/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../src/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,UAAU,qBAAqB,CACnC,OAAiB,EACjB,GAAqB,EACrB,OAA6B;IAE7B,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,cAAc,CACb,8BAA8B,EAC9B,oCAAoC,EACpC,YAAY,CAAC,mBAAmB,CAAC,CAClC;SACA,cAAc,CACb,8BAA8B,EAC9B,+BAA+B,CAChC;SACA,cAAc,CACb,sBAAsB,EACtB,8CAA8C,EAC9C,YAAY,CAAC,WAAW,CAAC,CAC1B;SACA,cAAc,CACb,mCAAmC,EACnC,qCAAqC,CACtC;SACA,cAAc,CACb,wBAAwB,EACxB,4BAA4B,EAC5B,YAAY,CAAC,aAAa,CAAC,CAC5B;SACA,MAAM,CAAC,KAAK,EAAE,OAMd,EAAE,EAAE;QACH,MAAM,MAAM,GAAyB;YACnC,cAAc,EAAS,OAAO,CAAC,cAAwD;YACvF,OAAO,EAAgB,OAAO,CAAC,OAA0C;YACzE,eAAe,EAAQ,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;YACtD,oBAAoB,EAAG,OAAO,CAAC,oBAAoB;YACnD,QAAQ,EAAe,OAAO,CAAC,QAA4C;SAC5E,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,QAAiB,EAAE,IAAI,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,CAAC,KAAa,EAAW,EAAE;QAChC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,oBAAoB,QAAQ,gCAAgC,EAC5D,wBAAwB,EACxB,EAAE,QAAQ,EAAE,KAAK,EAAE,CACpB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../src/commands/update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,UAAU,qBAAqB,CACnC,OAAiB,EACjB,OAAoB,EACpB,OAA6B;IAE7B,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,cAAc,CACb,8BAA8B,EAC9B,oCAAoC,EACpC,YAAY,CAAC,mBAAmB,CAAC,CAClC;SACA,cAAc,CACb,8BAA8B,EAC9B,+BAA+B,CAChC;SACA,cAAc,CACb,sBAAsB,EACtB,8CAA8C,EAC9C,YAAY,CAAC,WAAW,CAAC,CAC1B;SACA,cAAc,CACb,mCAAmC,EACnC,qCAAqC,CACtC;SACA,cAAc,CACb,wBAAwB,EACxB,4BAA4B,EAC5B,YAAY,CAAC,aAAa,CAAC,CAC5B;SACA,MAAM,CAAC,KAAK,EAAE,OAMd,EAAE,EAAE;QACH,MAAM,MAAM,GAAyB;YACnC,cAAc,EAAS,OAAO,CAAC,cAAwD;YACvF,OAAO,EAAgB,OAAO,CAAC,OAA0C;YACzE,eAAe,EAAQ,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;YACtD,oBAAoB,EAAG,OAAO,CAAC,oBAAoB;YACnD,QAAQ,EAAe,OAAO,CAAC,QAA4C;SAC5E,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,QAAQ,CAChB,6CAA6C,EAC7C,wBAAwB,EACxB,OAAO,CACR,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,QAAiB,EAAE,IAAI,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,CAAC,KAAa,EAAW,EAAE;QAChC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,oBAAoB,QAAQ,gCAAgC,EAC5D,wBAAwB,EACxB,EAAE,QAAQ,EAAE,KAAK,EAAE,CACpB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/src/config.js

@@ -0,0 +1,142 @@
+import { createApi, Identifier } from '@did-btcr2/api';
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { CLIError } from './error.js';
+import { SUPPORTED_NETWORKS } from './types.js';
+/**
+ * Environment variable names consulted by {@link defaultApiFactory}.
+ *
+ * | Variable              | Equivalent flag    |
+ * |-----------------------|--------------------|
+ * | `BTCR2_BTC_REST`      | `--btc-rest`       |
+ * | `BTCR2_BTC_RPC_URL`   | `--btc-rpc-url`    |
+ * | `BTCR2_BTC_RPC_USER`  | `--btc-rpc-user`   |
+ * | `BTCR2_BTC_RPC_PASS`  | `--btc-rpc-pass`   |
+ * | `BTCR2_CAS_GATEWAY`   | `--cas-gateway`    |
+ */
+export const ENV_VARS = {
+    BTC_REST: 'BTCR2_BTC_REST',
+    BTC_RPC_URL: 'BTCR2_BTC_RPC_URL',
+    BTC_RPC_USER: 'BTCR2_BTC_RPC_USER',
+    BTC_RPC_PASS: 'BTCR2_BTC_RPC_PASS',
+    CAS_GATEWAY: 'BTCR2_CAS_GATEWAY',
+};
+/**
+ * Reads {@link ConnectionOverrides} from environment variables.
+ * Only defined (non-empty) values are included.
+ */
+export function readEnvOverrides() {
+    const env = (key) => process.env[key] || undefined;
+    return {
+        btcRest: env(ENV_VARS.BTC_REST),
+        btcRpcUrl: env(ENV_VARS.BTC_RPC_URL),
+        btcRpcUser: env(ENV_VARS.BTC_RPC_USER),
+        btcRpcPass: env(ENV_VARS.BTC_RPC_PASS),
+        casGateway: env(ENV_VARS.CAS_GATEWAY),
+    };
+}
+/**
+ * Default config file path following the XDG Base Directory Specification.
+ *
+ * Resolution order:
+ * 1. `$XDG_CONFIG_HOME/btcr2/config.json`
+ * 2. `%APPDATA%/btcr2/config.json` (Windows)
+ * 3. `~/.config/btcr2/config.json` (fallback)
+ */
+export function defaultConfigPath() {
+    const base = process.env.XDG_CONFIG_HOME
+        ?? process.env.APPDATA
+        ?? join(homedir(), '.config');
+    return join(base, 'btcr2', 'config.json');
+}
+/**
+ * Reads and parses a config file. Returns `undefined` if the file does
+ * not exist or cannot be parsed.
+ */
+export function readConfigFile(path) {
+    try {
+        const content = readFileSync(path, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Extracts {@link ConnectionOverrides} from a named profile in a
+ * {@link ConfigFile}. Returns an empty object if the profile does not exist.
+ */
+export function profileToOverrides(config, profileName) {
+    const profile = config.profiles?.[profileName];
+    if (!profile)
+        return {};
+    return {
+        btcRest: profile.btc?.rest,
+        btcRpcUrl: profile.btc?.rpcUrl,
+        btcRpcUser: profile.btc?.rpcUser,
+        btcRpcPass: profile.btc?.rpcPass,
+        casGateway: profile.cas?.gateway,
+    };
+}
+/**
+ * Default {@link ApiFactory} backed by network defaults from
+ * `@did-btcr2/bitcoin` (mempool.space for public networks, localhost for
+ * regtest).
+ *
+ * Override precedence (highest wins):
+ * CLI flags → env vars → config file profile → network defaults.
+ *
+ * When no `--profile` is given, the network name is used as the profile
+ * key (e.g. a regtest DID auto-selects the `"regtest"` profile).
+ */
+export function defaultApiFactory(network, overrides) {
+    if (!network)
+        return createApi();
+    // Layer 1: Config file profile (lowest precedence of the three override layers)
+    const configPath = overrides?.config ?? defaultConfigPath();
+    const profileName = overrides?.profile ?? network;
+    const file = readConfigFile(configPath);
+    const fileOverrides = file ? profileToOverrides(file, profileName) : {};
+    // Layer 2: Environment variables
+    const env = readEnvOverrides();
+    // Merge: CLI flags → env vars → config file → (network defaults handled by BitcoinConnection)
+    const merged = {
+        btcRest: overrides?.btcRest ?? env.btcRest ?? fileOverrides.btcRest,
+        btcRpcUrl: overrides?.btcRpcUrl ?? env.btcRpcUrl ?? fileOverrides.btcRpcUrl,
+        btcRpcUser: overrides?.btcRpcUser ?? env.btcRpcUser ?? fileOverrides.btcRpcUser,
+        btcRpcPass: overrides?.btcRpcPass ?? env.btcRpcPass ?? fileOverrides.btcRpcPass,
+        casGateway: overrides?.casGateway ?? env.casGateway ?? fileOverrides.casGateway,
+    };
+    const btc = { network };
+    if (merged.btcRest) {
+        btc.rest = { host: merged.btcRest };
+    }
+    if (merged.btcRpcUrl) {
+        btc.rpc = {
+            host: merged.btcRpcUrl,
+            username: merged.btcRpcUser,
+            password: merged.btcRpcPass,
+        };
+    }
+    const cas = merged.casGateway ? { gateway: merged.casGateway } : undefined;
+    return createApi({ btc, ...(cas && { cas }) });
+}
+/**
+ * Extracts and validates the Bitcoin network from a DID string.
+ *
+ * Decodes the DID via {@link Identifier.decode}, then checks that the
+ * embedded network is one of the supported values.
+ *
+ * @param did A `did:btcr2:...` identifier string.
+ * @returns The validated {@link NetworkOption}.
+ * @throws {CLIError} If the network is unsupported.
+ */
+export function deriveNetwork(did) {
+    const { network } = Identifier.decode(did);
+    if (!SUPPORTED_NETWORKS.includes(network)) {
+        throw new CLIError(`Unsupported network "${network}" in DID.`, 'INVALID_ARGUMENT_ERROR', { did, network });
+    }
+    return network;
+}
+//# sourceMappingURL=config.js.map

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

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

package/dist/esm/src/index.js

@@ -1,5 +1,6 @@
 export * from './cli.js';
 export * from './commands/index.js';
+export * from './config.js';
 export * from './error.js';
 export * from './output.js';
 export * from './types.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

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

@@ -1,16 +1,21 @@
 import { Command } from 'commander';
-import { DidBtcr2Api } from '@did-btcr2/api';
+import { type ApiFactory } from './config.js';
 /**
  * CLI tool for the did:btcr2 method.
  */
 export declare class DidBtcr2Cli {
     readonly program: Command;
-    private readonly api;
     /**
-     * Initializes the CLI with an optional pre-configured API instance.
-     * @param {DidBtcr2Api} api - Optional API instance. Defaults to an unconfigured instance.
+     * Initializes the CLI with an optional API factory.
+     *
+     * The factory is called lazily by each command with the appropriate
+     * network derived from the DID being operated on. Defaults to
+     * {@link defaultApiFactory} which uses public endpoints (mempool.space)
+     * for known networks and localhost Polar for regtest.
+     *
+     * @param factory - Optional API factory. Defaults to {@link defaultApiFactory}.
      */
-    constructor(api?: DidBtcr2Api);
+    constructor(factory?: ApiFactory);
     /**
      * Runs the CLI with the provided argv or process.argv.
      * @param {string[]} [argv] - Optional array of command-line arguments.

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

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,WAAW,EAAa,MAAM,gBAAgB,CAAC;AAWxD;;GAEG;AACH,qBAAa,WAAW;IACtB,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAElC;;;OAGG;gBACS,GAAG,GAAE,WAAyB;IAiB1C;;;;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":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAOpD,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAKjE;;GAEG;AACH,qBAAa,WAAW;IACtB,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;;;;;;;;OASG;gBACS,OAAO,GAAE,UAA8B;IAuBnD;;;;OAIG;IACU,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CASjD"}

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

@@ -1,5 +1,5 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
-import { Command } from 'commander';
-import { GlobalOptions } from '../types.js';
-export declare function registerCreateCommand(program: Command, api: DidBtcr2Api, globals: () => GlobalOptions): void;
+import type { Command } from 'commander';
+import type { ApiFactory } from '../config.js';
+import type { GlobalOptions } from '../types.js';
+export declare function registerCreateCommand(program: Command, factory: 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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAEL,aAAa,EAGd,MAAM,aAAa,CAAC;AAQrB,wBAAgB,qBAAqB,CACnC,OAAO,EAAG,OAAO,EACjB,GAAG,EAAO,WAAW,EACrB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAuBN"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,KAAK,EAEV,aAAa,EACC,MAAM,aAAa,CAAC;AAWpC,wBAAgB,qBAAqB,CACnC,OAAO,EAAG,OAAO,EACjB,OAAO,EAAG,UAAU,EACpB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAwBN"}

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

@@ -1,5 +1,5 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
-import { Command } from 'commander';
-import { GlobalOptions } from '../types.js';
-export declare function registerDeactivateCommand(program: Command, api: DidBtcr2Api, globals: () => GlobalOptions): void;
+import type { Command } from 'commander';
+import { type ApiFactory } from '../config.js';
+import type { GlobalOptions } from '../types.js';
+export declare function registerDeactivateCommand(program: Command, factory: ApiFactory, globals: () => GlobalOptions): void;
 //# sourceMappingURL=deactivate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deactivate.d.ts","sourceRoot":"","sources":["../../../../src/commands/deactivate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAwB,MAAM,aAAa,CAAC;AAKlE,wBAAgB,yBAAyB,CACvC,OAAO,EAAG,OAAO,EACjB,GAAG,EAAO,WAAW,EACrB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAwCN"}
+{"version":3,"file":"deactivate.d.ts","sourceRoot":"","sources":["../../../../src/commands/deactivate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,aAAa,CAAC;AAKvE,wBAAgB,yBAAyB,CACvC,OAAO,EAAG,OAAO,EACjB,OAAO,EAAG,UAAU,EACpB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAkDN"}

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

@@ -1,5 +1,5 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
-import { Command } from 'commander';
-import { GlobalOptions } from '../types.js';
-export declare function registerResolveCommand(program: Command, api: DidBtcr2Api, globals: () => GlobalOptions): void;
+import type { Command } from 'commander';
+import { type ApiFactory } from '../config.js';
+import type { GlobalOptions } from '../types.js';
+export declare function registerResolveCommand(program: Command, factory: ApiFactory, globals: () => GlobalOptions): 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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AAEnE,wBAAgB,sBAAsB,CACpC,OAAO,EAAG,OAAO,EACjB,GAAG,EAAO,WAAW,EACrB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAkBN"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../src/commands/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,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,CAoBN"}

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

@@ -1,5 +1,5 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
-import { Command } from 'commander';
-import { GlobalOptions } from '../types.js';
-export declare function registerUpdateCommand(program: Command, api: DidBtcr2Api, globals: () => GlobalOptions): void;
+import type { Command } from 'commander';
+import { type ApiFactory } from '../config.js';
+import type { GlobalOptions } from '../types.js';
+export declare function registerUpdateCommand(program: Command, factory: ApiFactory, globals: () => GlobalOptions): void;
 //# sourceMappingURL=update.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAwB,MAAM,aAAa,CAAC;AAElE,wBAAgB,qBAAqB,CACnC,OAAO,EAAG,OAAO,EACjB,GAAG,EAAO,WAAW,EACrB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CA6CN"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,aAAa,CAAC;AAEvE,wBAAgB,qBAAqB,CACnC,OAAO,EAAG,OAAO,EACjB,OAAO,EAAG,UAAU,EACpB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAuDN"}

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

@@ -0,0 +1,131 @@
+import { type DidBtcr2Api } from '@did-btcr2/api';
+import { type NetworkOption } from './types.js';
+/**
+ * Endpoint overrides provided via CLI flags, env vars, or config file.
+ * These override the per-network defaults from
+ * `DEFAULT_BITCOIN_NETWORK_CONFIG`.
+ *
+ * `config` and `profile` control config-file resolution and are only
+ * meaningful when passed through the full merge chain.
+ */
+export type ConnectionOverrides = {
+    btcRest?: string;
+    btcRpcUrl?: string;
+    btcRpcUser?: string;
+    btcRpcPass?: string;
+    casGateway?: string;
+    config?: string;
+    profile?: string;
+};
+/**
+ * On-disk config file schema.
+ *
+ * @example
+ * ```json
+ * {
+ *   "profiles": {
+ *     "regtest": {
+ *       "btc": {
+ *         "rest": "http://localhost:3000",
+ *         "rpcUrl": "http://localhost:18443",
+ *         "rpcUser": "polaruser",
+ *         "rpcPass": "polarpass"
+ *       }
+ *     },
+ *     "bitcoin": {
+ *       "btc": { "rest": "https://my-mempool/api" },
+ *       "cas": { "gateway": "https://ipfs.io" }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export type ConfigFile = {
+    profiles?: Record<string, {
+        btc?: {
+            rest?: string;
+            rpcUrl?: string;
+            rpcUser?: string;
+            rpcPass?: string;
+        };
+        cas?: {
+            gateway?: string;
+        };
+    }>;
+};
+/**
+ * Factory function that creates a configured {@link DidBtcr2Api} instance.
+ *
+ * When `network` is provided, the returned API is wired to that network's
+ * default Bitcoin endpoints (mempool.space for public networks, localhost
+ * Polar for regtest). Optional `overrides` let callers replace individual
+ * endpoints on top of the defaults. When `network` is omitted, no Bitcoin
+ * or CAS is configured — suitable for offline operations like `create`.
+ */
+export type ApiFactory = (network?: NetworkOption, overrides?: ConnectionOverrides) => DidBtcr2Api;
+/**
+ * Environment variable names consulted by {@link defaultApiFactory}.
+ *
+ * | Variable              | Equivalent flag    |
+ * |-----------------------|--------------------|
+ * | `BTCR2_BTC_REST`      | `--btc-rest`       |
+ * | `BTCR2_BTC_RPC_URL`   | `--btc-rpc-url`    |
+ * | `BTCR2_BTC_RPC_USER`  | `--btc-rpc-user`   |
+ * | `BTCR2_BTC_RPC_PASS`  | `--btc-rpc-pass`   |
+ * | `BTCR2_CAS_GATEWAY`   | `--cas-gateway`    |
+ */
+export declare const ENV_VARS: {
+    readonly BTC_REST: "BTCR2_BTC_REST";
+    readonly BTC_RPC_URL: "BTCR2_BTC_RPC_URL";
+    readonly BTC_RPC_USER: "BTCR2_BTC_RPC_USER";
+    readonly BTC_RPC_PASS: "BTCR2_BTC_RPC_PASS";
+    readonly CAS_GATEWAY: "BTCR2_CAS_GATEWAY";
+};
+/**
+ * Reads {@link ConnectionOverrides} from environment variables.
+ * Only defined (non-empty) values are included.
+ */
+export declare function readEnvOverrides(): ConnectionOverrides;
+/**
+ * Default config file path following the XDG Base Directory Specification.
+ *
+ * Resolution order:
+ * 1. `$XDG_CONFIG_HOME/btcr2/config.json`
+ * 2. `%APPDATA%/btcr2/config.json` (Windows)
+ * 3. `~/.config/btcr2/config.json` (fallback)
+ */
+export declare function defaultConfigPath(): string;
+/**
+ * Reads and parses a config file. Returns `undefined` if the file does
+ * not exist or cannot be parsed.
+ */
+export declare function readConfigFile(path: string): ConfigFile | undefined;
+/**
+ * Extracts {@link ConnectionOverrides} from a named profile in a
+ * {@link ConfigFile}. Returns an empty object if the profile does not exist.
+ */
+export declare function profileToOverrides(config: ConfigFile, profileName: string): ConnectionOverrides;
+/**
+ * Default {@link ApiFactory} backed by network defaults from
+ * `@did-btcr2/bitcoin` (mempool.space for public networks, localhost for
+ * regtest).
+ *
+ * Override precedence (highest wins):
+ * CLI flags → env vars → config file profile → network defaults.
+ *
+ * When no `--profile` is given, the network name is used as the profile
+ * key (e.g. a regtest DID auto-selects the `"regtest"` profile).
+ */
+export declare function defaultApiFactory(network?: NetworkOption, overrides?: ConnectionOverrides): DidBtcr2Api;
+/**
+ * Extracts and validates the Bitcoin network from a DID string.
+ *
+ * Decodes the DID via {@link Identifier.decode}, then checks that the
+ * embedded network is one of the supported values.
+ *
+ * @param did A `did:btcr2:...` identifier string.
+ * @returns The validated {@link NetworkOption}.
+ * @throws {CLIError} If the network is unsupported.
+ */
+export declare function deriveNetwork(did: string): NetworkOption;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKhG,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAK,MAAM,CAAC;IACpB,SAAS,CAAC,EAAG,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAM,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QACxB,GAAG,CAAC,EAAE;YACJ,IAAI,CAAC,EAAM,MAAM,CAAC;YAClB,MAAM,CAAC,EAAI,MAAM,CAAC;YAClB,OAAO,CAAC,EAAG,MAAM,CAAC;YAClB,OAAO,CAAC,EAAG,MAAM,CAAC;SACnB,CAAC;QACF,GAAG,CAAC,EAAE;YACJ,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC,CAAC;CACJ,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,mBAAmB,KAAK,WAAW,CAAC;AAEnG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,mBAAmB,CAStD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAOnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAQ,UAAU,EACxB,WAAW,EAAG,MAAM,GACnB,mBAAmB,CAUrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,mBAAmB,GAAG,WAAW,CAsCvG;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAUxD"}

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

@@ -1,5 +1,6 @@
 export * from './cli.js';
 export * from './commands/index.js';
+export * from './config.js';
 export * from './error.js';
 export * from './output.js';
 export * from './types.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

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

@@ -1,4 +1,4 @@
-import { CommandResult, GlobalOptions } from './types.js';
+import type { CommandResult, GlobalOptions } from './types.js';
 /**
  * Formats a CommandResult for console output.
  * In 'json' mode, the full result is serialized.

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

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAMlF"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAMlF"}

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

@@ -38,5 +38,12 @@ export interface GlobalOptions {
     output: OutputFormat;
     verbose: boolean;
     quiet: boolean;
+    config?: string;
+    profile?: string;
+    btcRest?: string;
+    btcRpcUrl?: string;
+    btcRpcUser?: string;
+    btcRpcPass?: string;
+    casGateway?: string;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,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,eAAO,MAAM,kBAAkB,EAAE,aAAa,EAE7C,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAM,GAAG,GAAG,GAAG,CAAC;IACpB,KAAK,EAAK,MAAM,CAAC;IACjB,OAAO,EAAG,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAG,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,iBAAiB,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAS,gBAAgB,CAAC;IACxC,OAAO,EAAgB,cAAc,EAAE,CAAC;IACxC,eAAe,EAAQ,MAAM,CAAC;IAC9B,oBAAoB,EAAG,MAAM,CAAC;IAC9B,QAAQ,EAAe,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAI,YAAY,CAAC;IACvB,OAAO,EAAG,OAAO,CAAC;IAClB,KAAK,EAAK,OAAO,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,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,eAAO,MAAM,kBAAkB,EAAE,aAAa,EAE7C,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAM,GAAG,GAAG,GAAG,CAAC;IACpB,KAAK,EAAK,MAAM,CAAC;IACjB,OAAO,EAAG,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAG,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,iBAAiB,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAS,gBAAgB,CAAC;IACxC,OAAO,EAAgB,cAAc,EAAE,CAAC;IACxC,eAAe,EAAQ,MAAM,CAAC;IAC9B,oBAAoB,EAAG,MAAM,CAAC;IAC9B,QAAQ,EAAe,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAO,YAAY,CAAC;IAC1B,OAAO,EAAM,OAAO,CAAC;IACrB,KAAK,EAAQ,OAAO,CAAC;IACrB,MAAM,CAAC,EAAM,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,MAAM,CAAC;IACpB,SAAS,CAAC,EAAG,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@did-btcr2/cli",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "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",
-  "module": "./dist/esm/index.js",
+  "module": "./dist/esm/src/index.js",
   "types": "./dist/types/index.d.ts",
   "bin": {
     "btcr2": "./dist/esm/bin/btcr2.js"
@@ -12,7 +12,7 @@
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
-      "import": "./dist/esm/index.js",
+      "import": "./dist/esm/src/index.js",
       "require": "./dist/cjs/index.js"
     }
   },
@@ -58,10 +58,10 @@
   "dependencies": {
     "@web5/dids": "^1.2.0",
     "commander": "^13.1.0",
-    "@did-btcr2/cryptosuite": "^6.0.5",
-    "@did-btcr2/common": "^8.0.1",
-    "@did-btcr2/method": "^0.25.3",
-    "@did-btcr2/api": "^0.3.1"
+    "@did-btcr2/api": "^0.5.0",
+    "@did-btcr2/method": "^0.26.0",
+    "@did-btcr2/common": "^9.0.0",
+    "@did-btcr2/cryptosuite": "^6.0.6"
   },
   "devDependencies": {
     "@eslint/js": "^9.21.0",
@@ -97,7 +97,7 @@
     "reinstall": "pnpm install --force",
     "build": "pnpm clean:build && pnpm build:esm && pnpm build:cjs",
     "build:esm": "rimraf dist/esm dist/types && pnpm tsc -p tsconfig.json && chmod +x dist/esm/bin/btcr2.js",
-    "build:cjs": "rimraf dist/cjs && tsc -p tsconfig.cjs.json && echo '{\"type\": \"commonjs\"}' > ./dist/cjs/package.json",
+    "build:cjs": "tsup && echo '{\"type\": \"commonjs\"}' > ./dist/cjs/package.json",
     "build:tests": "pnpm clean:tests && pnpm tsc -p tests/tsconfig.json",
     "build:all": "pnpm build && pnpm build:tests",
     "lint": "eslint . --max-warnings 0",

package/src/cli.ts

@@ -1,13 +1,13 @@
 import { Command, CommanderError } from 'commander';
-import { DidBtcr2Api, createApi } from '@did-btcr2/api';
 import {
   registerCreateCommand,
   registerDeactivateCommand,
   registerResolveCommand,
   registerUpdateCommand,
 } from './commands/index.js';
+import { defaultApiFactory, type ApiFactory } from './config.js';
 import { CLIError } from './error.js';
-import { GlobalOptions } from './types.js';
+import type { GlobalOptions } from './types.js';
 import { VERSION } from './version.js';
 
 /**
@@ -15,27 +15,38 @@ import { VERSION } from './version.js';
  */
 export class DidBtcr2Cli {
   public readonly program: Command;
-  private readonly api: DidBtcr2Api;
 
   /**
-   * Initializes the CLI with an optional pre-configured API instance.
-   * @param {DidBtcr2Api} api - Optional API instance. Defaults to an unconfigured instance.
+   * Initializes the CLI with an optional API factory.
+   *
+   * The factory is called lazily by each command with the appropriate
+   * network derived from the DID being operated on. Defaults to
+   * {@link defaultApiFactory} which uses public endpoints (mempool.space)
+   * for known networks and localhost Polar for regtest.
+   *
+   * @param factory - Optional API factory. Defaults to {@link defaultApiFactory}.
    */
-  constructor(api: DidBtcr2Api = createApi()) {
-    this.api = api;
+  constructor(factory: ApiFactory = defaultApiFactory) {
     this.program = new Command('btcr2')
       .version(`btcr2 ${VERSION}`, '-v, --version', 'Output the current version')
       .description('CLI tool for the did:btcr2 method')
       .option('-o, --output <format>', 'Output format <json|text>', 'text')
       .option('--verbose', 'Verbose output', false)
-      .option('--quiet', 'Suppress non-essential output', false);
+      .option('--quiet', 'Suppress non-essential output', false)
+      .option('-c, --config <path>', 'Path to config file (default: $XDG_CONFIG_HOME/btcr2/config.json)')
+      .option('--profile <name>', 'Config profile name (default: auto-detected from network)')
+      .option('--btc-rest <url>', 'Override Bitcoin REST endpoint (Esplora API)')
+      .option('--btc-rpc-url <url>', 'Override Bitcoin Core RPC endpoint')
+      .option('--btc-rpc-user <user>', 'Bitcoin Core RPC username')
+      .option('--btc-rpc-pass <pass>', 'Bitcoin Core RPC password')
+      .option('--cas-gateway <url>', 'IPFS HTTP gateway for CAS reads');
 
     const globals = (): GlobalOptions => this.program.opts() as GlobalOptions;
 
-    registerCreateCommand(this.program, this.api, globals);
-    registerResolveCommand(this.program, this.api, globals);
-    registerUpdateCommand(this.program, this.api, globals);
-    registerDeactivateCommand(this.program, this.api, globals);
+    registerCreateCommand(this.program, factory, globals);
+    registerResolveCommand(this.program, factory, globals);
+    registerUpdateCommand(this.program, factory, globals);
+    registerDeactivateCommand(this.program, factory, globals);
   }
 
   /**

package/src/commands/create.ts

@@ -1,11 +1,12 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
-import { Command } from 'commander';
+import type { Command } from 'commander';
+import type { ApiFactory } from '../config.js';
 import { CLIError } from '../error.js';
 import { formatResult } from '../output.js';
-import {
+import type {
   CreateCommandOptions,
   GlobalOptions,
-  NetworkOption,
+  NetworkOption} from '../types.js';
+import {
   SUPPORTED_NETWORKS,
 } from '../types.js';
 
@@ -17,7 +18,7 @@ const EXPECTED_BYTES: Record<'k' | 'x', { length: number; label: string }> = {
 
 export function registerCreateCommand(
   program : Command,
-  api     : DidBtcr2Api,
+  factory : ApiFactory,
   globals : () => GlobalOptions,
 ): void {
   program
@@ -36,6 +37,7 @@ export function registerCreateCommand(
     )
     .action(async (options: { type: string; network: string; bytes: string }) => {
       const parsed = validateCreateOptions(options);
+      const api = factory();
       const type = parsed.type === 'k' ? 'deterministic' : 'external';
       const genesisBytes = Buffer.from(parsed.bytes, 'hex');
       const data = api.createDid(type, genesisBytes, { network: parsed.network });