@did-btcr2/cli 0.5.3 → 0.6.0

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

@@ -1,16 +1,21 @@
 import { Command } from 'commander';
-import type { 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,KAAK,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAYjD;;GAEG;AACH,qBAAa,WAAW;IACtB,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAElC;;;OAGG;gBACS,GAAG,GAAE,WAA0D;IAiB3E;;;;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 type { Command } from 'commander';
+import type { ApiFactory } from '../config.js';
 import type { GlobalOptions } from '../types.js';
-export declare function registerCreateCommand(program: Command, api: DidBtcr2Api, globals: () => GlobalOptions): void;
+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,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAEV,aAAa,EACC,MAAM,aAAa,CAAC;AAWpC,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 type { Command } from 'commander';
+import { type ApiFactory } from '../config.js';
 import type { GlobalOptions } from '../types.js';
-export declare function registerDeactivateCommand(program: Command, api: DidBtcr2Api, globals: () => GlobalOptions): void;
+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,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,aAAa,CAAC;AAKvE,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 type { Command } from 'commander';
+import { type ApiFactory } from '../config.js';
 import type { GlobalOptions } from '../types.js';
-export declare function registerResolveCommand(program: Command, api: DidBtcr2Api, globals: () => GlobalOptions): void;
+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,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AAExE,wBAAgB,sBAAsB,CACpC,OAAO,EAAG,OAAO,EACjB,GAAG,EAAO,WAAW,EACrB,OAAO,EAAG,MAAM,aAAa,GAC5B,IAAI,CAoBN"}
+{"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 type { Command } from 'commander';
+import { type ApiFactory } from '../config.js';
 import type { GlobalOptions } from '../types.js';
-export declare function registerUpdateCommand(program: Command, api: DidBtcr2Api, globals: () => GlobalOptions): void;
+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,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,aAAa,CAAC;AAEvE,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/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,6 +1,6 @@
 {
   "name": "@did-btcr2/cli",
-  "version": "0.5.3",
+  "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",
@@ -58,10 +58,10 @@
   "dependencies": {
     "@web5/dids": "^1.2.0",
     "commander": "^13.1.0",
-    "@did-btcr2/api": "^0.4.0",
+    "@did-btcr2/api": "^0.5.0",
+    "@did-btcr2/method": "^0.26.0",
     "@did-btcr2/common": "^9.0.0",
-    "@did-btcr2/cryptosuite": "^6.0.6",
-    "@did-btcr2/method": "^0.26.0"
+    "@did-btcr2/cryptosuite": "^6.0.6"
   },
   "devDependencies": {
     "@eslint/js": "^9.21.0",

package/src/cli.ts

@@ -1,12 +1,11 @@
 import { Command, CommanderError } from 'commander';
-import type { DidBtcr2Api} from '@did-btcr2/api';
-import { 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 type { GlobalOptions } from './types.js';
 import { VERSION } from './version.js';
@@ -16,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({ btc: { network: 'mutinynet' } })) {
-    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,5 +1,5 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
 import type { Command } from 'commander';
+import type { ApiFactory } from '../config.js';
 import { CLIError } from '../error.js';
 import { formatResult } from '../output.js';
 import type {
@@ -18,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
@@ -37,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 });

package/src/commands/deactivate.ts

@@ -1,5 +1,5 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
 import type { Command } from 'commander';
+import { deriveNetwork, type ApiFactory } from '../config.js';
 import { CLIError } from '../error.js';
 import { formatResult } from '../output.js';
 import type { GlobalOptions, UpdateCommandOptions } from '../types.js';
@@ -9,7 +9,7 @@ const DEACTIVATION_PATCH = [{ op: 'add' as const, path: '/deactivated', value: t
 
 export function registerDeactivateCommand(
   program : Command,
-  api     : DidBtcr2Api,
+  factory : ApiFactory,
   globals : () => GlobalOptions,
 ): void {
   program
@@ -47,6 +47,16 @@ export function registerDeactivateCommand(
         verificationMethodId : options.verificationMethodId,
         beaconId             : options.beaconId as UpdateCommandOptions['beaconId'],
       };
+      const did = parsed.sourceDocument?.id;
+      if (!did) {
+        throw new CLIError(
+          'Source document must contain an "id" field.',
+          'INVALID_ARGUMENT_ERROR',
+          options
+        );
+      }
+      const network = deriveNetwork(did);
+      const api = factory(network, globals());
       const data = await api.btcr2.update(parsed);
       const result = { action: 'deactivate' as const, data };
       console.log(formatResult(result, globals()));

package/src/commands/resolve.ts

@@ -1,14 +1,14 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
 import { Identifier } from '@did-btcr2/api';
 import type { Command } from 'commander';
 import { readFile } from 'node:fs/promises';
+import { deriveNetwork, type ApiFactory } from '../config.js';
 import { CLIError } from '../error.js';
 import { formatResult } from '../output.js';
 import type { GlobalOptions, ResolveCommandOptions } from '../types.js';
 
 export function registerResolveCommand(
   program : Command,
-  api     : DidBtcr2Api,
+  factory : ApiFactory,
   globals : () => GlobalOptions,
 ): void {
   program
@@ -23,9 +23,9 @@ export function registerResolveCommand(
       resolutionOptions?: string;
       resolutionOptionsPath?: string;
     }) => {
-      console.log('resolve command options prevalidation', options);
       const parsed = await validateResolveOptions(options);
-      console.log('resolve command options postvalidation', options);
+      const network = deriveNetwork(parsed.identifier);
+      const api = factory(network, globals());
       const data = await api.resolveDid(parsed.identifier, parsed.options);
       const result = { action: 'resolve' as const, data };
       console.log(formatResult(result, globals()));

package/src/commands/update.ts

@@ -1,12 +1,12 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
 import type { Command } from 'commander';
+import { deriveNetwork, type ApiFactory } from '../config.js';
 import { CLIError } from '../error.js';
 import { formatResult } from '../output.js';
 import type { GlobalOptions, UpdateCommandOptions } from '../types.js';
 
 export function registerUpdateCommand(
   program : Command,
-  api     : DidBtcr2Api,
+  factory : ApiFactory,
   globals : () => GlobalOptions,
 ): void {
   program
@@ -49,6 +49,16 @@ export function registerUpdateCommand(
         verificationMethodId : options.verificationMethodId,
         beaconId             : options.beaconId as UpdateCommandOptions['beaconId'],
       };
+      const did = parsed.sourceDocument?.id;
+      if (!did) {
+        throw new CLIError(
+          'Source document must contain an "id" field.',
+          'INVALID_ARGUMENT_ERROR',
+          options
+        );
+      }
+      const network = deriveNetwork(did);
+      const api = factory(network, globals());
       const data = await api.btcr2.update(parsed);
       const result = { action: 'update' as const, data };
       console.log(formatResult(result, globals()));